このドキュメントでは、Cloud Logging の概要について説明します。Cloud Logging は、ストレージ、検索、分析、モニタリングをサポートするリアルタイムのログ管理システムです。Cloud Logging は、 Google Cloud リソースからログデータを自動的に収集します。アプリケーション、オンプレミス リソース、他のクラウド プロバイダのリソースから Cloud Logging にログデータを送信できます。特定の種類のイベントがログデータで報告されたときに Cloud Monitoring から通知されるように、アラート ポリシーを構成することもできます。規制上の理由やセキュリティ上の理由から、ログデータの保存場所を指定できます。
アプリケーションとサードパーティ ソフトウェアからログデータを収集する
作成したアプリケーションからログデータを収集するには、クライアント ライブラリを使用してアプリケーションを計測します。ただし、アプリケーションを常に計測する必要はありません。たとえば、一部の構成では、Ops エージェントを使用して、stdout または stderr に書き込まれたログデータを Google Cloud プロジェクトに送信できます。
また、Ops エージェントをインストールして、そのアプリケーションから Google Cloud プロジェクトにログデータを書き込むように構成することで、nginx などのサードパーティ アプリケーションからログデータを収集することもできます。
要件に最適な方法の判断に役立つ情報については、Logging エージェントとクライアント ライブラリのどちらを使用するかをご覧ください。
ログデータをクエリ、表示、分析する
ログデータを表示して分析するには、 Google Cloud コンソールの [ログ エクスプローラ] ページまたは [ログ分析] ページを使用します。
ログ エクスプローラ: このインターフェースでは、個々のログエントリを表示し、関連するログエントリを検索して確認できます。また、ログエントリがエラーグループの一部である場合や、トレースデータが利用可能な場合、ログエントリにアノテーションが付けられます。サービスとアプリケーションのトラブルシューティングを行う場合は、このインターフェースを使用することをおすすめします。
ログ分析: このインターフェースでは、SQL を使用してログデータをクエリし、そのデータの傾向とパターンを特定できます。たとえば、特定の URL に対して発行された HTTP リクエストの平均レイテンシを時間の経過とともに計算し、レイテンシに変動があるかどうかをモニタリングできます。
詳細については、ログデータのクエリと表示をご覧ください。
ログデータを可視化してモニタリングする
ログデータに特定の種類のイベントが発生したときに通知するように Cloud Logging を構成できます。これらの通知は、ログエントリに特定のパターンがある場合、またはログデータに傾向が検出された場合に送信できます。 Google Cloud サービスのエラー率は、事前構成済みの Cloud Logging ダッシュボードを確認できます。
特定のメッセージがログエントリの一部である場合（重大なセキュリティ関連のイベントが発生した場合など）に通知を受け取るには、ログベースのアラート ポリシーを作成します。これらのポリシーは、次のような重要であるもののまれなイベントに役立ちます。
- 監査ログエントリにイベントが表示される。たとえば、ユーザーがサービス アカウントのセキュリティ キーにアクセスした場合です。
- ログエントリにデプロイ メッセージがある。
ログデータに傾向が発生したときに通知を受け取るには、ログベースの指標を作成し、アラート ポリシーで指標をモニタリングします。ログベースの指標により、いずれかの条件に一致するログエントリの数をカウントすることや、レスポンス時間などの情報を抽出してヒストグラムに整理することができます。ログベースの指標は、次のいずれかを行う場合に適しています。
- ログデータ内のメッセージの発生回数（エラーのステータスを記録するログエントリの数など）をモニタリングします。
- ログデータのレイテンシ値といったデータの傾向を監視し、許容できない値に変化した場合に通知を受け取る。
- ログデータから抽出した数値データをグラフにして表示する。
詳細については、ログデータをモニタリングするをご覧ください。
ログの保存と保持
ログデータの保存場所を構成する必要はありません。デフォルトでは、 Google Cloud プロジェクト、請求先アカウント、フォルダ、組織のリソースは、リソースで生成されたログデータを自動的に保存します。たとえば、 Google Cloud プロジェクトに Compute Engine インスタンスが含まれている場合、Compute Engine によって生成されたログデータは自動的に保存されます。
どのログデータを保存するか、どれを破棄するか、どこにログデータを保存するかなど、ログストレージに関するさまざまな側面を構成できます。詳細については、ログエントリを保存するをご覧ください。
ログエントリは一定期間保存された後に削除されます。詳細については、ログの保持期間をご覧ください。
ログ ルーティング
ログエントリは次の宛先にルーティングできます。
Google Cloud プロジェクト
ログバケット
- BigQuery データセット
- Cloud Storage バケット
- Pub/Sub トピック: Splunk や Datadog などのサードパーティ製品との統合が可能になります。
ログデータがルーティングされる場合、宛先はログデータの送信元とは異なるリソースに配置できます。たとえば、あるプロジェクトから別のプロジェクトに保存されているログバケットにログデータをルーティングできます。
詳細については、ログエントリをルーティングするをご覧ください。
ログデータのカテゴリ
ログのカテゴリは、利用可能なロギング情報の説明をサポートすることを目的としています。あるカテゴリは、別のカテゴリの一部を含む場合があります。
「プラットフォーム」ログエントリは Google Cloud サービスによって書き込まれます。これらのログは、問題のデバッグとトラブルシューティングに役立ち、使用中の Google Cloud サービスについて理解を深める助けにもなります。
「コンポーネント」ログエントリは、システムで実行される Google Cloud提供のソフトウェア コンポーネントによって生成されます。たとえば、GKE には、ユーザーが独自の仮想マシンやデータセンターで実行できるソフトウェア コンポーネントがあります。これらのログエントリは、ユーザー サポートによく使用されます。
「セキュリティ」ログエントリは、「誰が、どこで、いつ、何をしたのか」という問いに答えるのに役立ちます。
- Cloud Audit Logs は、Google Cloud リソース内での管理アクティビティとアクセスに関する情報を提供します。監査ログを有効にすると、セキュリティ、監査、コンプライアンス エンティティが Google Cloud のデータとシステムをモニタリングして、脆弱性や外部データの不正使用の可能性を確認できます。サポートされているサービスの一覧については、監査ログを使用するGoogle Cloud サービスをご覧ください。
- アクセスの透明性ログには、 Google Cloudのスタッフがお客様の Google Cloud コンテンツにアクセスした際に行った操作が記録されます。アクセスの透明性ログは、組織の法的要件と規制上の要件を遵守しているかどうかを追跡するのに役立ちます。サポートされているサービスの一覧については、アクセスの透明性ログ付きのGoogle Cloud サービスをご覧ください。
- 「ユーザー作成」ログエントリは、カスタム アプリケーションやサービスによって書き込まれたログです。通常、このデータは、Ops エージェント、Cloud Logging API、または Cloud Logging クライアント ライブラリを使用して Cloud Logging に書き込まれます。
- 「マルチクラウド」ログエントリと「ハイブリッド クラウド」ログエントリは、Microsoft Azure などの他のクラウド プロバイダのログデータと、オンプレミス インフラストラクチャのログを指します。
アクセス制御
Identity and Access Management（IAM）の権限とロールは、ログバケットへのアクセスを制御します。プリンシパルに事前定義ロールを付与することも、カスタムロールを作成することもできます。必要な権限の詳細については、アクセス制御をご覧ください。
料金
Cloud Logging の料金については、Google Cloud Observability の料金をご覧ください。