指標モデルの説明では、指標タイプと呼ばれるセクションにおいて、指標タイプを記述する属性に関する一般的な説明をします。このセクションでは、それらの属性のうちの 2 つについてより詳しく説明します。
- 値の型
- 指標の種類
値の型
値の型は、測定のデータ型です。各時系列は、そのデータポイントの値の型（ValueType 型）を記録します。
ブール値や数値データなど、一度に 1 つの値で構成される測定の場合、値の型によってデータの格納方法がわかります。
BOOLブール値INT6464 ビット整数DOUBLE倍精度浮動小数点数型STRING文字列
分布を測定する場合、値は単一の値ではなく、値のグループです。分布測定の値の型は
DISTRIBUTIONです。分布には、値のグループを要約した統計が含まれています。分布の値には、値のグループに対して計算された平均値、カウント、最大値などの統計が含まれます。分布には、値が範囲のセット全体でどのように分布しているかを表すヒストグラムを含めることもできます。
レイテンシ指標は通常、データを分布としてキャプチャします。分布の詳細については、Distribution リファレンス ページをご覧ください。これらのグラフの作成については、分布指標をご覧ください。
指標の種類
各時系列には、そのデータポイントの指標の種類（MetricKind 型）が含まれます。指標データの種類によって、値の相互関係がわかります。Cloud Monitoring の指標は次の 3 種類のいずれかになります。
ゲージ指標。これは特定の時刻を測定するための値です。たとえば、CPU 使用率はゲージ指標で測定され、測定時にはポイントごとに CPU 使用率が記録されます。ゲージ指標のもう一つの例は、現在の温度です。
デルタ指標。これは一定期間に発生した変化を測定します。読み取りの場合、時間間隔は半開です。開始時間は除外されますが、終了時間は含まれます（
(startTime, endTime]）。たとえば、リクエスト数はデルタ指標で測定されます。各値には、開始時間から終了時間までに受信されたリクエストの数が記録されます。累積指標。この場合、値は時間とともに増加します。たとえば、「送信済みバイト数」の指標は累積指標です。記録される各値は、その時点でサービスによって送信された合計バイト数を表します。
サポートされている組み合わせ
指標の種類と値の型は、組み合わせによっては意味をなさない場合もあります。たとえば、ブール値のデータを持つデルタ指標は存在しません。特定の組み合わせが有効なものとなります。
次の表に、サポートされている指標の種類と値の型を示します。
| 値の型 | GAUGE | DELTA | CUMULATIVE4 |
|---|---|---|---|
| BOOL | ○ | × | × |
| INT64 | ○ | ○1 | ○ |
| DOUBLE | ○ | ○1 | ○ |
| STRING | ○1 | × | × |
| DISTRIBUTION | ○2 | ○1, 3 | ○ |
1 この組み合わせはカスタム指標 custom.googleapis.com では許容されていません。
2 この組み合わせは、ログベースの指標では許容されていません。詳細については、分布タイプのログベースの指標を構成するをご覧ください。
3 値のタイプが DISTRIBUTION であるログベースの指標 logging.googleapis.com/user で許容される唯一の組み合わせです。詳細については、Logging API LogMetric リファレンスの metricDescriptor フィールドをご覧ください。
4 累積指標は、Monitoring のグラフやアラートに直接使用することはできませんが、これらの方法で使用できる非累積指標に集約できます。詳しくは、種類、タイプ、変換をご覧ください。
さらに、独自の指標を作成する場合は、値の型と指標の種類の有効な組み合わせのみを使用する必要があります。
文字列値のカスタム指標をエミュレートする
カスタム指標の文字列値はサポートされていませんが、次の方法で文字列値の指標の機能を複製できます。
- 文字列値にマッピングされる列挙型として INT64 値を使用して、GAUGE（ゲージ）指標を作成します。その指標をクエリするときに、列挙型を文字列値に外部的に変換します。
- BOOL 値と、モニタリングする文字列のいずれかを値に持つラベルを使用して、GAUGE 指標を作成します。このブール値を使用して、値がアクティブな値であるかどうかを示します。
たとえば、OK、OFFLINE、PENDING のオプションを持つ「status」という文字列値の指標を作成するとします。status_value というラベルの GAUGE 指標を作成できます。各更新は、status_value（OK、OFFLINE、PENDING）ごとに 1 つずつ、3 つの時系列を書き込みます。「true」の場合は 1、「false」 の場合は 0 になります。