ログベースの指標の概要

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

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

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

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

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

ご利用にあたって

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

Cloud Monitoring を初めて使用する場合は、このページの Cloud Monitoring セクションをご覧ください。

ログベースの指標の表示

Google Cloud Console の [ログベースの指標] ページで、ログベースの指標を作成できます。このページには、Cloud プロジェクトのすべてのログベースの指標が一覧表示されます。

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

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

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

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

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

各ペインには、指標のテーブルサマリが表示されます。各指標の行には、メニュー があり、次のオプションを利用できます。

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

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

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

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

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

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

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

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

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

いずれかの列名をクリックすると、昇順または降順でデータを並べ替えることができます。表の一番下では、表示する行数を選択することもできます。

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

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

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

ログベースの指標タイプの概要

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

ログベースの指標のデータは、指標が作成された後に受信したログエントリから取得されます。指標には、Logging にすでにあるログエントリのデータが遡及的に取り込まれることはありません。

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

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

ユーザー定義のログベースの指標では、カウンタタイプか分布指標タイプを指定できます。システム定義のログベースの指標のほとんどはカウンタですが、一部がブール型です。

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

カウンタ指標

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

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

    ... user [USERNAME] called  [OPERATION] ...
    

    [USERNAME] と [OPERATION] を抽出して 2 つのラベルの値として使用すると、「sallyUPDATE オペレーションを実行した回数」、「READ オペレーションを実行したユーザーの数」、「george がオペレーションを実行した回数」などを確認できます。

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

分布指標

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

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

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

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

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

ラベル

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

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

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

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

Cloud Console を使用してユーザー定義の指標を作成して管理する方法については、カウンタ指標の作成分布指標の作成をご覧ください。

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

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

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

Cloud Monitoring

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

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

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

ユーザー定義の指標には文字列 user が含まれています。

構成

プロジェクトの Cloud Monitoring ワークスペースを構成するには、次の手順を実施します。
  1. Cloud Console で、Google Cloud プロジェクトを選択します。
    Cloud Console に移動
  2. ナビゲーション パネルで [Monitoring] を選択します。

    Cloud Monitoring を初めて使用する場合は、Google Cloud Console の [Monitoring] への最初のアクセス時に、ワークスペースが自動的に作成され、プロジェクトがそのワークスペースに関連付けられます。それ以外の場合に、プロジェクトがワークスペースに関連付けられていないときは、ダイアログが表示され、新しいワークスペースを作成するか、このプロジェクトを既存のワークスペースに追加できるようになります。ワークスペースを作成することをおすすめします。選択したら、[追加] をクリックします。

アクセス制御

Cloud プロジェクトのログベースの指標を表示するには、適切なロールと権限があることを確認してください。

Identity and Access Management のロールと権限は、Google Cloud データへのアクセスを制御します。次に、Cloud プロジェクト メンバーがログベースの指標にアクセスするために必要な一般的なロールと権限の概要を示します。

  • ロギング / ログ構成書き込みroles/logging.configWriter)は、ログベースの指標をリスト表示、作成、取得、更新、削除できます。

  • ロギング / ログのビューアroles/logging.viewer)は、既存の指標を表示できます。また、カスタム役割への logging.logMetrics.getlogging.logMetrics.list 権限を付与できます。

  • モニタリング ビューアroles/monitoring.viewer)を使用すると、ログベースの指標に含まれる timeseries を読み取ることができます。また、カスタム役割への monitoring.timeSeries.list 権限を付与できます。

  • ロギング管理者roles/logging.admin)、プロジェクト編集者roles/editor)、およびプロジェクト オーナーroles/owner)は、ログベースの指標を作成する権限(logging.logMetrics.create)を含む広範なレベルのロールを持っています。

権限とロールの詳細については、アクセス制御ガイドをご覧ください。

料金

ユーザー定義のログベースの指標は、Cloud Monitoring カスタム指標のクラスであり、課金対象です。

料金の詳細については、Cloud Logging の料金: ログベースの指標をご覧ください。

トラブルシューティング

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