このページでは、ログベースの指標の概要を説明します。
ログベースの指標は、ログエントリの内容から指標データを取得します。たとえば、ログベースの指標を使用して、特定のメッセージを含むログエントリの数をカウントできます。または、ログエントリに記録されたレイテンシ情報を抽出することもできます。Cloud Monitoring のグラフおよびアラート ポリシーで、ログベースの指標を使用できます。
ログベースの指標のソース
Cloud Logging で定義された指標を使用して一般的な使用状況情報を収集し、独自のログベースの指標を定義して、アプリケーションまたはビジネスに固有の情報を取得できます。
ログベースの指標は、単一の Google Cloud プロジェクト内でのみ適用されます。Cloud 請求先アカウントや組織など、他の Google Cloud リソースのログベース指標を作成することはできません。
システム定義の指標
Logging には、プロジェクトに取り込まれたログエントリの数や、エクスポートしたバイト数など、使用量の値に関する一連の指標があります。システム定義の指標の一覧については、Google Cloud 指標: ロギングをご覧ください。
ユーザー定義の指標
ユーザー定義のログベースの指標を作成して、プロジェクトにとって重要な他の指標を追跡できます。たとえば、特定のフィルタに一致するログエントリの数をカウントするログベースの指標を作成できます。
ユーザー定義のログベースの指標は、Cloud プロジェクトに適用されている包含フィルタまたは除外フィルタにかかわらず、Cloud プロジェクトの Logging API によって受信されたすべてのログから計算されます。
プレビュー: Cloud プロジェクトの特定のログバケットに対してユーザー定義のログベースの指標を作成することもできます。バケットレベルのログベースの指標は、ログの発信元に関係なく、バケットのすべてのログから計算されます。詳細については、ログバケットのログベースの指標をご覧ください。
ログベースの指標のデータ型
ログベースの指標は、ログからデータを抽出して次のタイプの指標を作成できます。
- カウンタ: これらの指標は、指定した期間に特定のフィルタに一致するログエントリの数をカウントします。ログに値や文字列が出現する回数を追跡する場合は、カウンタを使用します。
- 分布: これらの指標では値もカウントされますが、カウントは値の範囲（ヒストグラム バケット）に収集されます。レイテンシなどの値を抽出する場合は、分布を使用します。
- ブール値: 指定したフィルタに一致するログエントリであるかどうかを取得します。
ユーザー定義のログベースの指標では、カウンタ指標タイプか分布指標タイプを指定できます。システム定義のログベースの指標のほとんどはカウンタですが、一部がブール型です。カウンタと分布の特性については、以降のセクションで詳しく説明します。
ユーザー定義のログベースの指標のデータは、指標が作成された後に受信したログエントリからのみ提供されます。指標には、Logging にすでにあるログエントリのデータが過去にさかのぼって設定されることはありません。
システムログ ベースの指標は、含まれるログのみから計算されます。ユーザー定義ログベースの指標は、含まれるログと除外されたログの両方から計算されます。
Logging は、一致するログエントリを受信するたびに、ログベースの指標の情報を蓄積します。ログには、新しいデータポイントを 1 分あたり 1 データポイントの速さで指標の時系列に書き込まれ、Cloud Monitoring がそのデータを利用できるようにします。
ログベースの指標の時系列の各データポイントは、前のデータポイント以降に受信した追加情報（差分）のみを表します。
以下のセクションでは、カウンタタイプと分布タイプの指標の特性について説明します。
カウンタ指標
カウンタ指標は、特定のフィルタに一致するログエントリの数をカウントします。たとえば、次の操作が可能です。
- 特定のエラー メッセージを含むログエントリをカウントします。
各ユーザーがオペレーションを呼び出す回数をカウントするには、このパターンに一致するログメッセージを検索します。
... user USERNAME called OPERATION ...USERNAME と OPERATION を抽出してラベルの値として使用すると、「
sallyがupdateオペレーションを実行した回数」、「readオペレーションを実行したユーザーの数」、「georgeがオペレーションを実行した回数」などを確認できます。
詳細については、カウンタ指標を構成するをご覧ください。
分布指標
分布指標は、フィルタに一致するログエントリからの数値データを累積します。この指標には、時系列の Distribution オブジェクトが含まれ、各オブジェクトには次のものが含まれます。
- 分布内の値の数のカウント
- 値の平均
- 偏差平方和: Sumi=1..n(xi–mean)2
- 各バケット内の値のカウントを持つヒストグラム バケットのセット。デフォルトのバケット レイアウトを使用することも、独自のバケット レイアウトを選択することもできます。
分布指標の一般的な用途は、レイテンシを追跡することです。各ログエントリを受信すると、ログエントリからレイテンシ値が抽出されて、分布に追加されます。定期的に、蓄積された分布が Cloud Monitoring に書き込まれます。
時系列内の形式や可視化の形式など、分布指標の詳細については、分布指標のグラフ化をご覧ください。
ログベースの分布指標の作成については、分布指標の構成をご覧ください。
ラベル
ログベースの指標にはラベルを付けることができます。これにより、指標に対して複数の時系列を収集できます。ラベルの値は、一致するログエントリのフィールドから抽出されます。Logging では、ラベル値の組み合わせごとに時系列を記録します。
システム ログベースの指標には、定義済みのラベルがあります。ユーザー定義の指標のラベルは自分で定義できます。詳細については、ログベースの指標ラベルをご覧ください。
Cloud Monitoring のグラフとアラート
Cloud Monitoring では、システム ログベースの指標とユーザー定義のログベースの指標の両方を使用して、グラフとアラート ポリシーを作成できます。詳細については、グラフとアラートを構成するをご覧ください。
Cloud Monitoring では、ログベースの指標の命名パターンは以下が使用されます。
- システム:
logging.googleapis.com/SYSTEM_METRIC_NAME - User-defined:
logging.googleapis.com/user/USER_METRIC_NAME
ユーザー定義のログベースの指標には、文字列 user が含まれます。
Monitoring の指標スコープの可視性
ログベースの指標は Cloud Monitoring によって取り込まれ、Cloud プロジェクトへの指標データの可視性は指標スコープによって決まります。指標スコープは、指標スコープをホストするプロジェクトによってモニタリングされるプロジェクトのリストです。ホスティング プロジェクトはスコープ プロジェクトと呼ばれます。
デフォルトでは、各プロジェクトは自身のみを含む指標スコープをホストします。つまり、プロジェクトはそれ自体のスコープ プロジェクトです。したがって、ログベースの指標を含む指標が、Cloud プロジェクトにのみ表示されます。
スコープ プロジェクトのマルチプロジェクト指標スコープを作成することもできます。マルチ プロジェクト指標のスコープを使用すると、スコープ プロジェクトは、指標スコープ内のすべてのプロジェクトの指標を表示できます。マルチプロジェクト指標のスコープで個々のプロジェクトに表示されるものは、それらの各プロジェクトでホストされている指標スコープによって決まります。2 つのプロジェクトがマルチプロジェクト指標のスコープ内にあるからといって、各プロジェクトが他のプロジェクトの指標や構成データにアクセスできるわけではありません。
1 つのプロジェクトを複数の指標スコープに含めることもできます。このようなプロジェクトの指標は、各指標スコープのスコープ プロジェクトに表示されます。
ログベースの指標を含む指標が、特定のプロジェクト内で定義されます。そのプロジェクトが複数の指標スコープに表示される場合、指標は定義されているプロジェクト以外のプロジェクトに表示されます。
マルチ プロジェクト指標のスコープを含む指標のスコープとスコープ対象プロジェクトの詳細については、以下をご覧ください。
料金
ユーザー定義のログベースの指標はすべて、Cloud Monitoring のカスタム指標のクラスであり、課金対象です。料金情報については、Cloud Logging の料金: ログベースの指標をご覧ください。
割り当て
ユーザー定義のログベースの指標に関連する割り当てと上限については、割り当てと上限をご覧ください。
トラブルシューティング
ログベースの指標を使用する際に問題が発生した場合は、ログベースの指標のトラブルシューティングをご覧ください。