Logging エージェントについて

このガイドでは、仮想マシン(VM)インスタンスで実行され、fluentd に基づくアプリケーションである Cloud Logging エージェントの基本情報を提供します。

ロギング エージェントの仕組み

Logging エージェントは、デフォルトの構成では、一般的なサードパーティ アプリケーションやシステム ソフトウェアからのログを、Logging にストリーミングします。デフォルトログのリストをご覧ください。追加のログをストリーミングするようにエージェントを構成できます。エージェントの構成とオペレーションの詳細は、Logging エージェントの構成をご覧ください。

すべての VM インスタンスで Logging エージェントを実行することをおすすめします。エージェントは Linux と Windows の両方で稼働します。Logging エージェントをインストールするには、エージェントのインストールをご覧ください。

標準的な Cloud Logging エージェントに比べて、スループットが高く、また、リソース効率の向上が必要な特殊なロギング ワークロードを実行している場合は、Ops エージェントの使用を検討してください。

サポートされているオペレーティング システム

Logging エージェントは、次のオペレーティング システムの、互換性のある仮想マシン(VM)インスタンス上で実行できます。

  • CentOS 6、7、8
  • Debian 9 "Stretch"、10 "Buster"
  • Red Hat Enterprise Linux 6、7、8
  • Ubuntu LTS 16.04(Xenial Xerus)、LTS 18.04(Bionic Beaver)、19.10(Eoan Ermine)、LTS 20.04(Focal Fossa)
  • Ubuntu Minimal LTS 16.04(Xenial Xerus)、LTS 18.04(Bionic Beaver)、19.10(Eoan Ermine)、LTS 20.04(Focal Fossa)
  • SUSE Linux Enterprise Server 12 SP3、12 SP2 for SAP、12 SP3 for SAP、15、15 for SAP、15 SP1 for SAP
  • Windows Server 2008 R2、2012 R2、2016、2019
  • Windows Server Core 2008 R2、2012 R2、2016、2019
  • Windows Server Core バージョン 1809、1903、1909
  • Amazon Linux AMI(Amazon Linux 2.0 AMI を除く)

サポートされる環境

Logging エージェントは次の環境に対応しています。

これらの VM インスタンスでは、Logging エージェントを実行するには少なくとも 250 MiB の常駐(RSS)メモリが必要になりますが、1 GiB が推奨されます。たとえば、サイズが 1 KB のログエントリが毎秒 100 件の割合で発生する場合、デフォルト構成の Logging エージェントは、1 コアあたり 5% の CPU と 150 MiB のメモリを消費します。

次の VM インスタンスは、独自のソフトウェアを使用して Logging をサポートしているため、Logging エージェントを手動でインストールすることはサポートされていません。

  • App Engine スタンダード環境のインスタンス。App Engine には、Logging の組み込みサポートが含まれています。詳細については、アプリケーション ログの書き込みをご覧ください。

  • App Engine フレキシブル環境のインスタンス。App Engine フレキシブル環境で実行されるアプリはログを書き込むことができます。このログは、App Engine スタンダード環境には含まれていません。詳細については、アプリケーション ログの書き込みをご覧ください。

  • Google Kubernetes Engine ノード インスタンス。新規または既存のコンテナ クラスタ用に、統合されたモニタリングおよびロギング ソリューションである GKE 用 Cloud Operations を有効にできます。

  • VMware の Anthos クラスタで実行されるインスタンスの場合、エージェントはシステムログを収集しますが、アプリケーション ログは収集しません。

  • Cloud Run コンテナ インスタンス。Cloud Run には、Logging の組み込みサポートが含まれています。詳しくは、ログの記録と表示をご覧ください。

  • Cloud Functions の HTTP とバックグラウンド関数。Cloud Functions には、Logging の組み込みサポートが含まれています。詳しくは、ログの作成、表示、処理をご覧ください。

オンプレミスとハイブリッド クラウドのサポート

Google Cloud は Blue Medora と連携し、オンプレミスとハイブリッド クラウド プラットフォームに対する、一貫性があり、予測可能なロギング サービスを提供します。Blue Medora を使用すると、独自のデータを収集し、分析のために Logging に送信できます。Blue Medrid の Bindplane は、Cloud Logging と統合して、インフラストラクチャからデータを取得します。また、これは、追加コストなしでプロジェクトに組み込まれます。

Blue Medora の詳細については、Blue Medora についてをご覧ください。

エージェントのアクセス要件

エージェントを実行するには、次の DNS 名にアクセスする必要があります。

  • OAuth2 トークン サーバー: oauth2.googleapis.com

    より古いバージョンのエージェントでは www.googleapis.com へのアクセスが必要になる場合があります(完全 URL: https://www.googleapis.com/oauth2/v3/token)。

    古いバージョンのエージェントを使用している場合は、最新バージョンにエージェントをアップグレードすることをおすすめします。

  • Logging API: logging.googleapis.com

エージェントをインストールするには、次の DNS 名にアクセスする必要があります。

  • (Linux)Google Cloud Package Repository: packages.cloud.google.com

  • (Windows)Google ダウンロード サーバー: dl.google.com

Logging エージェントのソースコード

ソースコードを理解したい場合や他の特別なニーズがある場合を除き、このセクションの情報は必要ありません。Logging エージェントをインストールするスクリプトの説明は、インストールの手順をご覧ください。

Logging エージェント google-fluentd は、fluentd ログデータ コレクタに変更を加えたものです。google-fluentd は、次の 2 つのパッケージで配布されています。ソースコードは関連する GitHub リポジトリから入手できます。

  • google-fluentd という名前の GitHub リポジトリには、コア fluentd プログラム、カスタム パッケージング スクリプト、Stackdriver Logging API 用の出力プラグインが含まれています。
    • 出力プラグインは、Ruby の gem としてパッケージ化され、google-fluentd パッケージに収録されています。また、fluent-plugin-google-cloud で Ruby gem ホスティング サービスから別途入手することもできます。
    • Windows インストーラに関連するコンテンツは windows-installer フォルダにあります。
  • google-fluentd-catch-all-config という名前の GitHub リポジトリ。このリポジトリには、さまざまなサードパーティ ソフトウェア パッケージからログを取り込むための Logging エージェントの構成ファイルが含まれています。

Logging エージェントのリリースノート

  • google-fluentd Linux パッケージのリリースノートは google-fluentd/releases にあります。リリースタグは [Major].[Minor].[Patch] セマンティック バージョニング形式に準拠しています。

  • Windows インストーラのリリースノートも google-fluentd/releases にあります。 ただし、リリースタグの先頭には Windows が付きます。

  • スタンドアロンの gem fluent-plugin-google-cloud のリリースノートは fluent-plugin-google-cloud/releases にあります。リリースタグは [Major].[Minor].[Patch] セマンティック バージョニング形式に準拠しています。

非推奨ポリシー

Logging エージェントには、Google Cloud のオペレーション スイートのエージェントの非推奨ポリシーが適用されます。

次のステップ