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

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

Space

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

例如,通过Java SDK指定监控OSS服务的示例代码如下:
DescribeMetricListRequest request = new DescribeMetricListRequest();
request.setNamespace("acs_oss_dashboard");

StartTime和EndTime

StartTime和EndTime用于指定查询监控数据的时间范围。云监控的时间参数取值范围采用左开右闭的形式(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。不指定Dimensions时,表示查询用户层级数据。层级说明请参见Metric

例如,通过Java SDK查询Bucket数据的示例代码如下:
//填写待查询数据的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 重定向请求占比 %
    Bucket层级 Availability 可用性 %
    RequestValidRate 有效请求率 %
    TotalRequestCount 总请求数 次数
    ValidRequestCount 有效请求数 次数
    InternetSend 公网流出流量 字节
    InternetRecv 公网流入流量 字节
    IntranetSend 内网流出流量 字节
    IntranetRecv 内网流入流量 字节
    InternetSendBandwidth 公网流出带宽 bps
    InternetRecvBandwidth 公网流入带宽 bps
    IntranetSendBandwidth 内网流出带宽 bps
    IntranetRecvBandwidth 内网流入带宽 bps
    CdnSend CDN流出流量 字节
    CdnRecv CDN流入流量 字节
    SyncSend 跨区域复制流出流量 字节
    SyncRecv 跨区域复制流入流量 字节
    ServerErrorCount 服务端错误请求总数 次数
    ServerErrorRate 服务端错误请求占比 %
    NetworkErrorCount 网络错误请求总数 次数
    NetworkErrorRate 网络错误请求占比 %
    AuthorizationErrorCount 客户端授权错误请求总数 次数
    AuthorizationErrorRate 客户端授权错误请求占比 %
    ResourceNotFoundErrorCount 客户端资源不存在错误请求总数 次数
    ResourceNotFoundErrorRate 客户端资源不存在错误请求占比 %
    ClientTimeoutErrorCount 客户端超时错误请求总数 次数
    ClientTimeoutErrorRate 客户端超时错误请求占比 %
    ClientOtherErrorCount 客户端其他错误请求总数 次数
    ClientOtherErrorRate 客户端其他错误请求占比 %
    SuccessCount 成功请求总数 次数
    SuccessRate 成功请求占比 %
    RedirectCount 重定向请求总数 次数
    RedirectRate 重定向请求占比 %
    GetObjectE2eLatency GetObject请求平均E2E延时 毫秒
    GetObjectServerLatency GetObject请求平均服务器延时 毫秒
    MaxGetObjectE2eLatency GetObject请求最大E2E延时 毫秒
    MaxGetObjectServerLatency GetObject请求最大服务器延时 毫秒
    HeadObjectE2eLatency HeadObject请求平均E2E延时 毫秒
    HeadObjectServerLatency HeadObject请求平均服务器延时 毫秒
    MaxHeadObjectE2eLatency HeadObject请求最大E2E延时 毫秒
    MaxHeadObjectServerLatency HeadObject请求最大服务器延时 毫秒
    PutObjectE2eLatency PutObject请求平均E2E延时 毫秒
    PutObjectServerLatency PutObject请求平均服务器延时 毫秒
    MaxPutObjectE2eLatency PutObject请求最大E2E延时 毫秒
    MaxPutObjectServerLatency PutObject请求最大服务器延时 毫秒
    PostObjectE2eLatency PostObject请求平均E2E延时 毫秒
    PostObjectServerLatency PostObject请求平均服务器延时 毫秒
    MaxPostObjectE2eLatency PostObject请求最大E2E延时 毫秒
    MaxPostObjectServerLatency PostObject请求最大服务器延时 毫秒
    AppendObjectE2eLatency AppendObject请求平均E2E延时 毫秒
    AppendObjectServerLatency AppendObject请求平均服务器延时 毫秒
    MaxAppendObjectE2eLatency AppendObject请求最大E2E延时 毫秒
    MaxAppendObjectServerLatency AppendObject请求最大服务器延时 毫秒
    UploadPartE2eLatency UploadPart请求平均E2E延时 毫秒
    UploadPartServerLatency UploadPart请求平均服务器延时 毫秒
    MaxUploadPartE2eLatency UploadPart请求最大E2E延时 毫秒
    MaxUploadPartServerLatency UploadPart请求最大服务器延时 毫秒
    UploadPartCopyE2eLatency UploadPartCopy请求平均E2E延时 毫秒
    UploadPartCopyServerLatency UploadPartCopy请求平均服务器延时 毫秒
    MaxUploadPartCopyE2eLatency UploadPartCopy请求最大E2E延时 毫秒
    MaxUploadPartCopyServerLatency UploadPartCopy请求最大服务器延时 毫秒
    GetObjectCount GetObject成功请求数 次数
    HeadObjectCount HeadObject成功请求数 次数
    PutObjectCount PutObject成功请求数 次数
    PostObjectCount PostObject成功请求数 次数
    AppendObjectCount AppendObject成功请求数 次数
    UploadPartCount UploadPart成功请求数 次数
    UploadPartCopyCount UploadPartCopy成功请求数 次数
    DeleteObjectCount DeleteObject成功请求数 次数
    DeleteObjectsCount DeleteObjects成功请求数 次数
  • 计量类指标

    查询以下Metric时如果指定了Dimensions,则表示查询的是Bucket层级的数据。如果未指定Dimensions,则表示查询的是用户层级的数据。

    Metric 对应指标项名称 单位
    MeteringStorageUtilization 存储大小 字节
    MeteringGetRequest Get类请求数 次数
    MeteringPutRequest Put类请求数 次数
    MeteringInternetTX 公网流出计量流量 字节
    MeteringCdnTX CDN流出计量流量 字节
    MeteringSyncRX 跨区域复制流入计量流量 字节