ログベースの指標の概要

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このページでは、ログベースの指標の概要を説明します。

ログベースの指標は、ログエントリの内容から指標データを抽出します。たとえば、指標は特定のメッセージを含むログエントリの数を記録したり、ログエントリに報告されたレイテンシ情報を抽出したりできます。Cloud Monitoring のグラフとアラート ポリシーでは、ログベースの指標を使用できます。

ログベースの指標には、次の 2 種類があります。

  • システム定義のログベースの指標。Cloud Logging によって提供され、すべての Google Cloud プロジェクトで使用できます。

    システム定義のログベースの指標は、Logging に取り込まれたログからのみ計算されます。ログが Logging による取り込みから明示的に除外されている場合、それらの指標にこれらのログは含まれません。

  • ユーザー定義のログベースの指標。Google Cloud プロジェクトで関心のあるものを追跡するために作成されます。たとえば、特定のフィルタに一致するログエントリの数をカウントするログベースの指標を作成できます。

    • ユーザー定義のログベースの指標は、Cloud プロジェクトに適用されている包含フィルタまたは除外フィルタにかかわらず、Cloud プロジェクトの Logging API によって受信されたすべてのログから計算されます。

    • プレビュー: Cloud プロジェクトの特定のログバケットに対して、ユーザー定義のログベースの指標を作成することもできます。バケットレベルのログベースの指標は、バケットが発信された場所に関係なく、すべてのログから計算されます。詳細については、ログバケットのログベースの指標をご覧ください。

ログベースの指標は、単一の Google Cloud プロジェクト内でのみ適用されます。Cloud 請求先アカウントや組織など、他の Google Cloud リソースのログベースの指標を作成することはできません。

始める前に

ログベースの指標を使用するには、課金を有効にした Cloud プロジェクトが必要です。

  1. Google Cloud Console でプロジェクト セレクタ ページに移動します。

    プロジェクト セレクタに移動

  2. Google Cloud プロジェクトの作成を開始するには、[プロジェクトを作成] をクリックします。

  3. プロジェクトに名前を付けます。生成されたプロジェクト ID をメモしておきます。

  4. 必要に応じて他のフィールドを編集します。

  5. プロジェクトを作成するには、[作成] をクリックします。

Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

Cloud プロジェクトにログベースの指標を使用するための適切な権限が付与されていることを確認するには、IAM ログベースの指標を使用したアクセス制御をご覧ください。

指標スコープの可視化

ログベースの指標は Cloud Monitoring によって取り込まれ、Cloud プロジェクトに対する指標データの可視性は指標スコープによって決まります。指標スコープは、指標スコープをホストするプロジェクトによってモニタリングされているプロジェクトのリストです。ホスティング プロジェクトはスコープ プロジェクトと呼ばれます。

デフォルトでは、各プロジェクトは自身のみを含む指標スコープをホストしているため、プロジェクトはそれ自体のスコープ対象プロジェクトです。したがって、ログベースの指標を含む指標は Cloud プロジェクトにのみ表示されます。

スコープ対象プロジェクト用のマルチプロジェクト指標スコープを作成することもできます。マルチプロジェクト指標スコープを使用すると、スコープ対象プロジェクトは指標スコープ内のすべてのプロジェクトの指標を表示できます。マルチプロジェクト指標スコープ内の個々のプロジェクトに表示される内容は、各プロジェクトによってホストされる指標スコープによって決まります。2 つのプロジェクトがマルチプロジェクトの指標スコープに含まれているからといって、各プロジェクトが他のプロジェクトの指標データまたは構成データにアクセスできるわけではありません。

単一のプロジェクトが複数の指標スコープに表示されることもあります。このようなプロジェクトの指標は、各指標スコープのスコープ対象プロジェクトに表示されます。

ログベースの指標を含む指標は、特定のプロジェクト内で定義されます。このプロジェクトが複数の指標スコープに含まれている場合、指標は、定義されている指標以外のプロジェクトに表示されます。

マルチ プロジェクト指標のスコープを含む指標のスコープとスコープ対象プロジェクトの詳細については、以下をご覧ください。

ログベースの指標を表示する

Google Cloud Console の [ログベースの指標] ページを使用して、Cloud プロジェクトのプロジェクト レベルのログベースの指標を表示します。同じページで、ユーザー定義のログベースの指標を作成、変更します。

Google Cloud プロジェクトのログベースの指標のリストを表示する手順は、次のとおりです。

  1. Google Cloud Console の [ログベースの指標] ページに移動します。

    [ログベースの指標] に移動

  2. 既存の Cloud プロジェクトを選択します。Cloud プロジェクトのログベースの指標のリストが表示されます。

ログベースの指標のインターフェースは、システム指標ユーザー定義指標の 2 つの指標タイプのペインに分かれて表示されます。

各ペインには、指標の概要を示した表が表示されます。指標の各行には、メニュー があり、次のオプションを利用できます。

  • [Metrics Explorer で表示する] を選択すると、Cloud Monitoring の Metrics Explorer が開き、システムログ ベースの指標のデータが表示されます。

    Metrics Explorer を使用して、アラート ポリシーのターゲット指標を指定できます。[ターゲット] 領域の横にあるグラフでは、ターゲット指標によってキャプチャされたデータに関する視覚的フィードバックが提供されます。

  • [指標に基づいてアラートを作成する] を選択すると、ログベースの指標に基づいてアラート ポリシーを作成できます。

    このオプションを選択すると、Cloud Monitoring Console が開き、アラート ポリシーの作成、編集、管理ができます。ログベースの指標のアラート ポリシーを作成する際の詳細については、アラート ポリシーの作成をご覧ください。

ユーザー定義の指標ペイン

ログベースの指標のインターフェースにある [ユーザー定義指標] ペインには、Cloud プロジェクトのユーザー定義指標を管理ための機能が用意されています。

  • ユーザー定義指標の表には、[名前]、[説明]、[タイプ]、[フィルタ] 列があります。これらは指標の作成時に指定します。

  • [ユーザー定義の指標をフィルタ] ペインでは、テキスト検索、または指標の [名前]、[説明]、[フィルタ] で指標の一覧をフィルタリングできます。

  • ユーザー定義指標の表には、[先月の使用量] および [月初からの使用量(MTD)] の列があります。この使用状況データは、どの指標に最も多くのデータが取り込まれるかを判断する場合や請求額を見積もる場合に役立ちます。

いずれかの列名をクリックすると、昇順または降順でデータを並べ替えることができます。

ユーザー定義指標ペインの各指標のメニュー には、指標を管理するための追加機能が含まれます。

ユーザー定義ログベースの指標ペインのオーバーフロー メニューのオプション。

  • 指標の詳細を表示: 定義されていれば、指標の名前タイプ説明フィルタ単位ラベルを表示します。
  • 指標を編集: 指標の特定のフィールドを編集できます。
  • 指標の無効化: 指標の計算を停止できます。無効にした指標は、同じメニューから再度有効にできます。
  • 指標を削除: 指標を削除します。
  • 指標のログの表示: Logs Explorer に移動し、クエリビルダーで指標のフィルタを入力してクエリを実行します。

ログベースの指標の種類の概要

ログベースの指標は、ログからデータを抽出して次のタイプの指標を作成できます。

  • カウンタ: これらの指標は、指定されたフィルタに一致するログエントリの数をカウントします。カウンタは、ログに値や文字列が出現する回数を追跡するのに役立ちます。
  • 分布: これらの指標は値もカウントしますが、カウントを値の範囲(ヒストグラム バケット)に収集します。分布は、レイテンシなどの値を追跡するのに役立ちます。
  • ブール値: これらの指標は、ログエントリが指定されたフィルタに一致するかどうかを取得します。

ユーザー定義のログベースの指標では、カウンタ指標タイプか分布指標タイプを指定できます。システム定義のログベースの指標のほとんどはカウンタですが、ブール型のものもあります。以降のセクションで、カウンタと分布の特性について詳しく説明します。

ユーザー定義のログベースの指標のデータは、指標の作成後に受信したログエントリからのみ収集されます。指標には、すでに Logging 内のログエントリからさかのぼってデータが入力されることはありません。

システム ログベースの指標は、含まれるログからのみ計算されます。ユーザー定義のログベースの指標は、含まれるログと除外されたログの両方から計算されます。

Logging は、一致するログエントリを受信するたびに、ログベースの指標の情報を蓄積します。ログには、新しいデータポイントを 1 分あたり 1 データポイントの速さで指標の時系列に書き込まれ、Cloud Monitoring がそのデータを利用できるようにします。

ログベースの指標の時系列の各データポイントは、前のデータポイント以降に受信した追加情報(差分)のみを表します。

以下のセクションでは、カウンタタイプと分布タイプの指標の特性について説明します。

カウンタ指標

カウンタ指標は、特定のフィルタに一致するログエントリの数をカウントします。たとえば、次の操作が可能です。

  • 特定のエラー メッセージを含むログエントリをカウントします。
  • 各ユーザーがオペレーションを呼び出す回数をカウントするには、このパターンに一致するログメッセージを検索します。

    ... user USERNAME called OPERATION ...

    USERNAMEOPERATION を抽出し、それらを 2 つのラベルの値として使用すると、後で「sallyupdate オペレーションを呼び出した回数」を問い合わせることができます。"read オペレーションを呼び出したユーザーの数}}"george がオペレーションを呼び出す回数}} など。

詳細については、カウンタ指標の構成をご覧ください。

分布指標

分布指標は、フィルタに一致するログエントリからの数値データを累積します。この指標には、時系列の Distribution オブジェクトが含まれ、各オブジェクトには次のものが含まれます。

  • 分布内の値の数のカウント
  • 値の平均
  • 偏差平方和: Sumi=1..n(xi–mean)2
  • 各バケット内の値のカウントを持つヒストグラム バケットのセット。デフォルトのバケット レイアウトを使用することも、独自のバケット レイアウトを選択することもできます。

分布指標の一般的な用途は、レイテンシを追跡することです。各ログエントリを受信すると、ログエントリからレイテンシ値が抽出されて、分布に追加されます。定期的に、蓄積された分布が Cloud Monitoring に書き込まれます。

時系列内の形式や可視化の形式など、分布指標の詳細については、分布指標のグラフ化をご覧ください。

ログベースの分布指標の作成については、分布指標の構成をご覧ください。

ラベル

ログベースの指標にはラベルを設定できます。これにより、指標について複数の時系列を収集できます。ラベルの値は、一致するログエントリのフィールドから抽出されます。Logging は、ラベル値の組み合わせごとに別々の時系列を記録します。

システム ログベースの指標には、定義済みのラベルがあります。ユーザー定義の指標のラベルは自分で定義できます。詳細については、ログベースの指標ラベルをご覧ください。

ユーザー定義のログベースの指標

ユーザー定義のログベースの指標は、Google Cloud プロジェクトのユーザーによって作成されます。これらの指標は特定のフィルタに一致するログエントリの数をカウントするか、一致するログエントリ内の特定の値を追跡します。

プロジェクト レベルのユーザー定義指標の作成と管理方法については、カウンタ指標の構成分布指標の構成をご覧ください。

Cloud プロジェクトの特定のログバケットを操作するログベースの指標の作成方法については、ログバケットのログベースの指標をご覧ください。

料金

ユーザー定義のログベースの指標は Cloud Monitoring のカスタム指標のクラスで、課金対象です。料金については、Cloud Logging の料金: ログベースの指標をご覧ください。

割り当て

ユーザー定義のログベースの指標に関連する割り当てと上限については、割り当てと上限をご覧ください。

システム ログベースの指標

Logging には、カウンタを含む一連の指標が用意されています。カウンタ指標は、特定の期間内に発生したロギング イベントの数を記録します。指標には、ログ名と重大度ごとに数を記録するラベルがあります。

これらの指標のリストについては、Google Cloud の指標: ロギングをご覧ください。

Cloud Monitoring

Cloud Monitoring では、システム ログベースの指標とユーザー定義のログベースの指標の両方を使用して、グラフとアラート ポリシーを作成できます。詳細については、グラフとアラートを構成するをご覧ください。

Cloud Monitoring では、ログベースの指標の命名パターンは以下が使用されます。

  • システム: logging.googleapis.com/SYSTEM_METRIC_NAME
  • User-defined: logging.googleapis.com/user/USER_METRIC_NAME

ユーザー定義のログベースの指標には、文字列 user が含まれます。

トラブルシューティング

ログベースの指標を使用するときに問題が発生した場合は、ログベースの指標のトラブルシューティングをご覧ください。