値の型と指標の種類

指標モデルの説明では、指標の型と呼ばれるセクションにおいて、指標の型を記述する属性に関する一般的な説明をします。このセクションでは、それらの属性のうちの 2 つについてより詳しく説明します。

  • 値の型
  • 指標の種類

値の型

値の型は、測定のデータ型です。各時系列は、そのデータポイントの値の型（ValueType 型）を記録します。

  • ブール値や数値データなど、一度に 1 つの値で構成される測定の場合、値の型によってデータの格納方法がわかります。

    • BOOL: ブール型
    • INT64: 64 ビット整数型
    • DOUBLE: 倍精度浮動小数点数型
    • STRING: 文字列型

  • 分布の測定の場合、値は単一の値ではなく、値のグループです。分布測定の値の型は DISTRIBUTION です。

    分布には、値のグループをまとめた統計情報が含まれます。 分布の値には、値のグループに対して計算された平均、カウント、最大値などの統計が含まれます。分布には、一連の範囲にわたって値がどのように分散されるかを表すヒストグラムを含めることもできます。

    通常、レイテンシ指標はデータを分布として取得します。ディストリビューションの詳細については、Distribution リファレンス ページをご覧ください。これらの指標のグラフについては、分布指標のグラフをご覧ください。

指標の種類

各時系列には、そのデータポイントの指標の種類（MetricKind 型）が含まれます。指標データの種類によって、値の相互関係がわかります。Cloud Monitoring の指標は次の 3 種類のいずれかになります。

  • ゲージ指標。これは特定の時刻を測定するための値です。たとえば、CPU 使用率を測定する指標はゲージ指標で、測定時にポイントごとに CPU 使用率が記録されます。ゲージ指標のもう 1 つの例は、現在の温度です。

  • デルタ指標。これは最後に記録されてからの変更を測定します。たとえば、リクエスト数を測定する指標はデルタ指標です。各値には、最後のデータポイントが記録されてから受信したリクエストの数が記録されます。

  • 累積指標。値は時間とともに増加します。たとえば、「送信済みバイト数」の指標は累積指標です。各値は、その時点でサービスによって送信された合計バイト数を記録します。

サポートされている組み合わせ

指標の種類と値の型のすべての組み合わせが適切でない場合もあります。たとえば、ブール値のデータのデルタ指標は表示されません。組み合わせが適切なものもあります。

次の表に、サポートされている指標の種類と値の型を示します。

値の型 GAUGE DELTA CUMULATIVE2
BOOL ○ × ×
INT64　 ○ ○1 ○
DOUBLE ○ ○1 ○
STRING ○1 × ×
DISTRIBUTION ○ ○1 ○

1 この組み合わせはカスタム指標では使用できません。
2 累積指標は Monitoring でグラフやアラートに直接使用することはできませんが、これらの方法で使用できる非累積指標に集約できます。詳しくは、種類、型、変換をご覧ください。

さらに、独自の指標を作成する場合は、値の型と指標の種類の有効な組み合わせのみを使用する必要があります。