OSS监控服务为您提供系统基本运行状态、性能以及计量等方面的监控数据指标,帮助您跟踪请求、分析使用情况、统计业务趋势,及时发现以及诊断系统的相关问题。本文介绍使用云监控服务提供的API或SDK查询OSS监控数据使用的参数。

说明 云监控服务SDK示例,请参见Java SDK使用手册

Space

Space用于指定监控的云服务。OSS监控服务使用的Namespace为acs_oss_dashboard

Java SDK代码示例如下:
DescribeMetricListRequest request = new DescribeMetricListRequest();
request.setNamespace("acs_oss_dashboard");

StartTime和EndTime

StartTimeEndTime用于指定查询监控数据的时间范围。云监控的时间参数取值范围采用左开右闭的形式(StartTime, EndTime],即可以查询StartTime到EndTime之间的数据(包含EndTime的数据)。StartTime和EndTime的时间间隔不能大于31天,且无法查询31天以前的数据。

Java SDK代码示例如下:
//设置监控数据的结束时间。
request.setEndTime("2019-05-13 11:06:27");
//设置监控数据的开始时间。
request.setStartTime("2019-05-13 10:20:27");

Dimensions

Dimensions用于指定查询的Bucket。不指定时,表示查询用户层级数据。层级说明请参见Metric

查询Bucket数据时Java SDK代码示例如下:
//填写待查询数据的Bucket名称。
request.setDimensions("{\"BucketName\":\"<yourBucketName>\"}");

Period

Period用于指定指标项的查询周期。OSS监控的计量类指标查询周期为3600s,其他所有指标的查询周期均为60s。各指标项的说明,请参见Metric

监控某个非计量类指标时,Java SDK代码示例如下:
request.setPeriod("60");

Metric

Metric用于指定查询的指标项,Java SDK代码示例如下:
//设置Metric名称。
request.setMetric("<MetricName>");
  • 非计量类指标对应的Metric名称和层级如下表所示:
    Metric 对应指标项名称 单位 层级
    UserAvailability 可用性 % 用户层级
    UserRequestValidRate 有效请求率 % 用户层级
    UserTotalRequestCount 总请求数 次数 用户层级
    UserValidRequestCount 有效请求数 次数 用户层级
    UserInternetSend 公网流出流量 字节 用户层级
    UserInternetRecv 公网流入流量 字节 用户层级
    UserIntranetSend 内网流出流量 字节 用户层级
    UserIntranetRecv 内网流入流量 字节 用户层级
    UserCdnSend CDN流出流量 字节 用户层级
    UserCdnRecv CDN流入流量 字节 用户层级
    UserSyncSend 跨区域复制流出流量 字节 用户层级
    UserSyncRecv 跨区域复制流入流量 字节 用户层级
    UserServerErrorCount 服务端错误请求总数 次数 用户层级
    UserServerErrorRate 服务端错误请求占比 % 用户层级
    UserNetworkErrorCount 网络错误请求总数 次数 用户层级
    UserNetworkErrorRate 网络错误请求占比 % 用户层级
    UserAuthorizationErrorCount 客户端授权错误请求总数 次数 用户层级
    UserAuthorizationErrorRate 客户端授权错误请求占比 % 用户层级
    UserResourceNotFoundErrorCount 客户端资源不存在错误请求总数 次数 用户层级
    UserResourceNotFoundErrorRate 客户端资源不存在错误请求占比 % 用户层级
    UserClientTimeoutErrorCount 客户端超时错误请求总数 次数 用户层级
    UserClientOtherErrorRate 客户端超时错误请求占比 % 用户层级
    UserClientOtherErrorCount 客户端其他错误请求总数 次数 用户层级
    UserClientOtherErrorRate 客户端其他错误请求占比 % 用户层级
    UserSuccessCount 成功请求总数 次数 用户层级
    UserSuccessRate 成功请求占比 % 用户层级
    UserRedirectCount 重定向请求总数 次数 用户层级
    UserRedirectRate 重定向请求占比 % 用户层级
    Availability 可用性 % Bucket层级
    RequestValidRate 有效请求率 % Bucket层级
    TotalRequestCount 总请求数 次数 Bucket层级
    ValidRequestCount 有效请求数 次数 Bucket层级
    InternetSend 公网流出流量 字节 Bucket层级
    InternetRecv 公网流入流量 字节 Bucket层级
    IntranetSend 内网流出流量 字节 Bucket层级
    IntranetRecv 内网流入流量 字节 Bucket层级
    CdnSend CDN流出流量 字节 Bucket层级
    CdnRecv CDN流入流量 字节 Bucket层级
    SyncSend 跨区域复制流出流量 字节 Bucket层级
    SyncRecv 跨区域复制流入流量 字节 Bucket层级
    ServerErrorCount 服务端错误请求总数 次数 Bucket层级
    ServerErrorRate 服务端错误请求占比 % Bucket层级
    NetworkErrorCount 网络错误请求总数 次数 Bucket层级
    NetworkErrorRate 网络错误请求占比 % Bucket层级
    AuthorizationErrorCount 客户端授权错误请求总数 次数 Bucket层级
    AuthorizationErrorRate 客户端授权错误请求占比 % Bucket层级
    ResourceNotFoundErrorCount 客户端资源不存在错误请求总数 次数 Bucket层级
    ResourceNotFoundErrorRate 客户端资源不存在错误请求占比 % Bucket层级
    ClientTimeoutErrorCount 客户端超时错误请求总数 次数 Bucket层级
    ClientTimeoutErrorRate 客户端超时错误请求占比 % Bucket层级
    ClientOtherErrorCount 客户端其他错误请求总数 次数 Bucket层级
    ClientOtherErrorRate 客户端其他错误请求占比 % Bucket层级
    SuccessCount 成功请求总数 次数 Bucket层级
    SuccessRate 成功请求占比 % Bucket层级
    RedirectCount 重定向请求总数 次数 Bucket层级
    RedirectRate 重定向请求占比 % Bucket层级
    GetObjectE2eLatency GetObject请求平均E2E延时 毫秒 Bucket层级
    GetObjectServerLatency GetObject请求平均服务器延时 毫秒 Bucket层级
    MaxGetObjectE2eLatency GetObject请求最大E2E延时 毫秒 Bucket层级
    MaxGetObjectServerLatency GetObject请求最大服务器延时 毫秒 Bucket层级
    HeadObjectE2eLatency HeadObject请求平均E2E延时 毫秒 Bucket层级
    HeadObjectServerLatency HeadObject请求平均服务器延时 毫秒 Bucket层级
    MaxHeadObjectE2eLatency HeadObject请求最大E2E延时 毫秒 Bucket层级
    MaxHeadObjectServerLatency HeadObject请求最大服务器延时 毫秒 Bucket层级
    PutObjectE2eLatency PutObject请求平均E2E延时 毫秒 Bucket层级
    PutObjectServerLatency PutObject请求平均服务器延时 毫秒 Bucket层级
    MaxPutObjectE2eLatency PutObject请求最大E2E延时 毫秒 Bucket层级
    MaxPutObjectServerLatency PutObject请求最大服务器延时 毫秒 Bucket层级
    PostObjectE2eLatency PostObject请求平均E2E延时 毫秒 Bucket层级
    PostObjectServerLatency PostObject请求平均服务器延时 毫秒 Bucket层级
    MaxPostObjectE2eLatency PostObject请求最大E2E延时 毫秒 Bucket层级
    MaxPostObjectServerLatency PostObject请求最大服务器延时 毫秒 Bucket层级
    AppendObjectE2eLatency AppendObject请求平均E2E延时 毫秒 Bucket层级
    AppendObjectServerLatency AppendObject请求平均服务器延时 毫秒 Bucket层级
    MaxAppendObjectE2eLatency AppendObject请求最大E2E延时 毫秒 Bucket层级
    MaxAppendObjectServerLatency AppendObject请求最大服务器延时 毫秒 Bucket层级
    UploadPartE2eLatency UploadPart请求平均E2E延时 毫秒 Bucket层级
    UploadPartServerLatency UploadPart请求平均服务器延时 毫秒 Bucket层级
    MaxUploadPartE2eLatency UploadPart请求最大E2E延时 毫秒 Bucket层级
    MaxUploadPartServerLatency UploadPart请求最大服务器延时 毫秒 Bucket层级
    UploadPartCopyE2eLatency UploadPartCopy请求平均E2E延时 毫秒 Bucket层级
    UploadPartCopyServerLatency UploadPartCopy请求平均服务器延时 毫秒 Bucket层级
    MaxUploadPartCopyE2eLatency UploadPartCopy请求最大E2E延时 毫秒 Bucket层级
    MaxUploadPartCopyServerLatency UploadPartCopy请求最大服务器延时 毫秒 Bucket层级
    GetObjectCount GetObject成功请求数 次数 Bucket层级
    HeadObjectCount HeadObject成功请求数 次数 Bucket层级
    PutObjectCount PutObject成功请求数 次数 Bucket层级
    PostObjectCount PostObject成功请求数 次数 Bucket层级
    AppendObjectCount AppendObject成功请求数 次数 Bucket层级
    UploadPartCount UploadPart成功请求数 次数 Bucket层级
    UploadPartCopyCount UploadPartCopy成功请求数 次数 Bucket层级
    DeleteObjectCount DeleteObject成功请求数 次数 Bucket层级
    DeleteObjectsCount DeleteObjects成功请求数 次数 Bucket层级
  • 计量类指标对应的Metric名称和层级如下表所示:
    Metric 对应指标项名称 单位 层级
    MeteringStorageUtilization 存储大小 字节 设置Dimensions时,为Bucket层级;若不设置Dimensions,则为用户层级。
    MeteringGetRequest Get类请求数 次数
    MeteringPutRequest Put类请求数 次数
    MeteringInternetTX 公网流出计量流量 字节
    MeteringCdnTX CDN流出计量流量 字节
    MeteringSyncRX 跨区域复制流入计量流量 字节