単一の VM に Cloud Logging エージェントをインストールする

Logging エージェントは、VM インスタンスや選択したサードパーティ ソフトウェア パッケージから Cloud Logging にログをストリーミングします。すべての VM インスタンスで Logging エージェントを実行することをおすすめします。

Compute Engine と Amazon Elastic Compute Cloud(EC2)の VM イメージには Logging エージェントが含まれていないため、これらのインスタンスにインストールするには以下の手順を実施する必要があります。エージェントは Linux と Windows の両方で稼働します。

Google Kubernetes Engine または App Engine 上で VM を実行している場合は、エージェントはすでに VM イメージに含まれているため、このページをスキップできます。

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

始める前に

エージェントをインストールするには、次のものが必要です。

単一の VM にエージェントをインストールする

エージェントをインストールするには、次の手順を使用します。

最新バージョンのエージェントをインストールする

エージェントの最新バージョンをインストールする手順は次のとおりです。

Linux

  1. SSH または同様のツールを使用して、VM インスタンスへのターミナル接続を開き、sudo アクセス権があることを確認します。

  2. たとえば、ホーム ディレクトリなど、書き込みアクセス権があるディレクトリに移動します。

  3. 下記を実行します。

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh --also-install
    

Windows

  1. RDP または同様のツールを使用してインスタンスに接続し、Windows にログインします。

  2. PowerShell アイコンを右クリックし、[管理者として実行] を選択して、管理者権限で PowerShell ターミナルを開きます。

  3. 次の PowerShell コマンドを実行します。

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-15.exe", "${env:UserProfile}\StackdriverLogging-v1-15.exe")
    & "${env:UserProfile}\StackdriverLogging-v1-15.exe"
    

特定のバージョンのエージェントをインストールする

特定のバージョンのエージェントをインストールするには、次の手順を行います。

Linux

  1. SSH または同様のツールを使用して、VM インスタンスへのターミナル接続を開き、sudo アクセス権があることを確認します。

  2. たとえば、ホーム ディレクトリなど、書き込みアクセス権があるディレクトリに移動します。

  3. エージェントのインストール スクリプトをダウンロードします。

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    

    add-logging-agent-repo.sh スクリプトを実行するときに、次のフラグを設定することもできます。

    • --verbose: スクリプトの実行中に詳細ログを有効にします。
    • --also-install: エージェント パッケージ リポジトリを追加した後にエージェントをインストールします。
    • --version: スクリプトをインストールするエージェントのバージョンを設定します。
    • --uninstall: エージェントをアンインストールします。
    • --remove-repo: エージェントをインストールまたはアンインストールした後に、対応するエージェント パッケージ リポジトリを削除します。
    • --dry-run: スクリプト実行のドライランのみがトリガーされ、実行するはずのコマンドを出力します。
    • --uninstall-standalone-logging-agent: スタンドアロンの Logging エージェント(StackdriverLogging)をアンインストールします。
    • --uninstall-standalone-monitoring-agent: スタンドアロンの Monitoring エージェント(StackdriverMonitoring)をアンインストールします。

    詳細と使用例については、スクリプトのコメントをご覧ください。

  4. エージェントのパッケージ リポジトリを追加して、エージェントをインストールします。

    1. インストール可能なエージェントのバージョンを選択する方法については、すべてのエージェント バージョンを一覧表示するをご覧ください。

    2. 本番環境では、下位互換性のない変更を含む可能性のあるメジャー バージョンをインストールしないように、メジャー バージョンに固定することをおすすめします。メジャー バージョンに固定するには、次のコマンドを実行します。

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      たとえば、エージェントの 1.x.x に固定するには、次のコマンドを実行します。

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=1.*.*
      
    3. 特定のバージョンのエージェントをインストールするには、次のコマンドを実行します。

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      
  5. エージェント サービスの再起動

    上記のキャッチオール パッケージによってインストールされた構成を有効にするために、再起動が必要です。

    sudo service google-fluentd restart
    

正常に実行されたら、インストール スクリプトを削除します。

  • エージェントが期待どおりに動作していることを確認するには、次のコマンドを実行します。

    sudo service google-fluentd status
    

    エージェントのステータスは OK である必要があります。

  • ログを調べて、エラーがないことを確認することもできます。

    tail /var/log/google-fluentd/google-fluentd.log
    

インストールに問題がある場合は、トラブルシューティング ページをご覧ください。

Windows

  1. RDP または同様のツールを使用してインスタンスに接続し、Windows にログインします。

  2. PowerShell アイコンを右クリックし、[管理者として実行] を選択して、管理者権限で PowerShell ターミナルを開きます。

    1. 次の PowerShell コマンドを実行します。

      (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-15.exe", "${env:UserProfile}\StackdriverLogging-v1-15.exe")
      & "${env:UserProfile}\StackdriverLogging-v1-15.exe"
      

    または、次の URL にアクセスして、エージェントのインストーラをダウンロードして実行することもできます。

    https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-15.exe

    エージェントをサイレント モードでインストールするには、次のようにインストーラの起動時に /S オプションを追加します。

    & "${env:UserProfile}\StackdriverLogging-v1-15.exe" /S
    

    「サイレント」モードでは、/D オプションを使用してインストール ディレクトリを指定します。次に例を示します。

    & "${env:UserProfile}\StackdriverLogging-v1-15.exe" /S /D="C:\Stackdriver\Logging\"
    

    正常に完了したら、インストーラを削除できます。

    インストールに問題がある場合は、トラブルシューティング ページをご覧ください。

Compute Engine VM へのエージェントのインストール

事前に構成された Monitoring の VM インスタンス ダッシュボードから、単一の VM に Logging エージェントをインストールできます。

このダッシュボードにアクセスする方法は次のとおりです。

  1. Cloud Console で、Google Cloud プロジェクトを選択します。
    Cloud Console に移動
  2. ナビゲーション パネルで [Monitoring] を選択します。
  3. [モニタリング] のナビゲーション ペインで、[ダッシュボード] を選択します。
  4. ダッシュボードの表で [VM インスタンス] エントリを見つけて、名前をクリックします。

次のスクリーンショットに示すように、[VM インスタンス] ダッシュボードの [Inventory] タブにすべての VM がリストされ、エージェントのステータス列が含まれます。

Monitoring の [VM インスタンス] ダッシュボードにエージェントのステータスが表示されている。

エージェントが Compute Engine インスタンスで検出されない場合は、[Install agent] リンクをクリックすると、ダッシュボードにインストール ワークフローが表示されます。

オプションのタスク

このセクションでは、一般的なメンテナンス タスクを行う方法について説明します。

構造化ロギングを有効にする

Linux VM でインストール スクリプトを実行するとき、--also-install フラグがあると、デフォルトで google-fluentd-catch-all パッケージがインストールされます。構造化ロギングに切り替えるには、次の手順を行います。

  1. ローカルでの変更を /etc/google-fluentd/config.d/ にバックアップします。

  2. Linux ディストリビューションに応じて、次のいずれかのコマンドを実行します。

    • YUM:

      sudo yum uninstall -y google-fluentd-catch-all-config
      sudo yum install -y google-fluentd-catch-all-config-structured
      sudo service google-fluentd restart
      
    • APT:

      sudo apt-get remove -y google-fluentd-catch-all-config
      sudo apt-get install -y google-fluentd-catch-all-config-structured
      sudo service google-fluentd restart
      

構造化ロギングの詳細については、構造化ロギングのガイドをご覧ください。

エージェントの構成

エージェントは、特定の既知のログの場所をモニタリングするように事前構成されています。Linux では、これらの場所はパッケージ google-fluentd-catch-all-config で記述され、このパッケージはインストール スクリプトによって自動的に取得されます。Windows では、エージェントはデフォルトで Windows イベントログをモニタリングします。

エージェント構成を調整するには、エージェントの構成をご覧ください。

HTTP プロキシを構成する

HTTP プロキシを使用して Logging API と Monitoring API にリクエストをプロキシする場合は、次の操作を行います。

Linux

  1. 次の構成ファイルを編集します(まだファイルが存在しない場合は作成します)。

     /etc/default/google-fluentd
    
  2. ファイルに以下を追加します。

     export http_proxy="http://proxy-ip:proxy-port"
     export https_proxy="http://proxy-ip:proxy-port"
     export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.
    
  3. VM インスタンスで次のコマンドを実行して、Logging エージェントを再起動します。

     sudo service google-fluentd restart
    

Windows

  1. HTTP プロキシを使用する場合は、管理者コマンド プロンプトから次のコマンドを実行します。これにより、環境変数の http_proxyhttps_proxy が設定され、エージェントがアウトバウンド HTTPS を使用して Logging にデータを送信できるようにします。

    setx http_proxy http://proxy-ip:proxy-port /m
    setx https_proxy http://proxy-ip:proxy-port /m
    setx no_proxy 169.254.169.254 /m
    

エージェント バージョンの決定

システムで Logging エージェントのバージョンを確認するには、VM インスタンスで次のコマンドを実行します。

Amazon Linux AMI / CentOS / RHEL

Amazon Linux、Red Hat、または CentOS Linux で次のコマンドを実行します。

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-fluentd ∖
     google-fluentd-catch-all-config ∖
     google-fluentd-catch-all-config-structured

Debian / Ubuntu

Debian または Ubuntu で次のコマンドを実行します。

dpkg-query --show --showformat \
    '${Package} ${Version} ${Architecture} ${Status}\n' \
     google-fluentd ∖
     google-fluentd-catch-all-config ∖
     google-fluentd-catch-all-config-structured

SLES / SUSE

SUSE で次のコマンドを実行します。

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-fluentd ∖
     google-fluentd-catch-all-config ∖
     google-fluentd-catch-all-config-structured

Windows

  1. RDP または同様のツールを使用してインスタンスに接続し、Windows にログインします。

  2. [PowerShell] アイコンを右クリックし、[管理者として実行] を選択して、管理者権限で PowerShell ターミナルを開きます。

  3. 次の PowerShell コマンドを実行します。

     reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version
    

エージェントを再起動する

構成ファイルの変更を取得するには、Logging エージェントを再起動する必要があります。エージェントを再起動するには、次の手順を使用します。

Linux

インスタンスで次のコマンドを実行します。

 sudo service google-fluentd restart

Logging エージェントを再起動した後で、テスト メッセージを送信することをおすすめします。

Windows

  1. RDP または同様のツールを使用してインスタンスに接続し、Windows にログインします。

  2. PowerShell アイコンを右クリックし、[管理者として実行] を選択して、管理者権限で PowerShell ターミナルを開きます。

  3. 次の PowerShell コマンドを実行します。

Restart-Service -Name StackdriverLogging

エージェントをアップグレードする

Logging エージェントを最新リリースにアップグレードするには、次の手順を使用します。

Linux

エージェントを最新バージョンにアップグレードするには、次のコマンドを実行します。

sudo bash add-google-cloud-ops-agent-repo.sh --also-install

エージェントを特定のメジャー バージョンの最新のポイント リリースにアップグレードするには、次のコマンドを実行します。

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

最新のエージェント リリースにアップグレードするには、このページのWindows へのインストールの記載に従い、最新のエージェントをインストールします。インストーラで、以前のバージョンのエージェントをアンインストールするように求められます。

すべてのエージェント バージョンを一覧表示する

エージェントで利用可能なバージョンを一覧表示するには、次のコマンドを実行します。

Amazon Linux AMI / CentOS / RHEL

エージェントで使用可能なバージョンを一覧表示します。

sudo yum list --showduplicates google-fluentd

Debian / Ubuntu

エージェントで使用可能なバージョンを一覧表示します。

sudo apt-cache madison google-fluentd

SLES / SUSE

エージェントで使用可能なバージョンを一覧表示します。

sudo zypper search -s google-fluentd

Windows

以前のバージョンのエージェントの Windows へのインストールはサポートされていません。

エージェントをアンインストールする

Logging エージェントとその構成ファイルを削除するには、次の手順を使用します。

Linux

次のコマンドを実行します。

sudo bash add-logging-agent-repo.sh --uninstall

Windows

Windows コントロール パネルで、[プログラムのアンインストール] を選択します。アンインストールできるプログラムのリストに Logging エージェントが表示されます。

AWS EC2 VM インスタンスの Google Cloud プロジェクトに関する情報

ドキュメントが VM インスタンスに関連付けられた Google Cloud プロジェクトを参照している際には、EC2 VM インスタンスの場合、これは AWS アカウントにリンクされている AWS コネクタ プロジェクトを意味します。

AWS アカウントを Google Cloud に接続する場合は、AWS コネクタ プロジェクトを作成します。このプロセスについては、AWS アカウントの指標の表示をご覧ください。

AWS アカウントの AWS コネクタ プロジェクトにアクセスするには、次のいずれかを行います。

  • Google Cloud Console のプロジェクト セレクタを使用して、AWS コネクタ プロジェクトの命名規則と一致するプロジェクトを特定し、AWS アカウントに特定のプロジェクトを選択します。

  • 指標スコープが AWS アカウント指標が含む Google Cloud プロジェクトを特定し、Google Cloud Console のプロジェクト セレクタでそのプロジェクトを選択します。この Google Cloud プロジェクトでは、[モニタリング] ページに移動し、[設定] ページを選択します。[設定] ページに、AWS コネクタ プロジェクトが一覧表示されます。Google Cloud Console プロジェクト セレクタを使用すると、AWS コネクタ プロジェクトにアクセスできます。

リモート パッケージ アクセスを使用しない VM

Logging エージェントのインストールには、エージェント パッケージと(Linux では)その依存関係の両方用に、リモートのパッケージ リポジトリへのアクセスが必要です。

VPC-SC またはプライベート ネットワークを使用している場合は、ネットワーク構成により上流リポジトリからエージェントの依存関係をインストールする機能に影響することがあります。エージェント パッケージ自体には、限定公開の Google アクセスを使用してアクセスできます。

VM ホストのセキュリティ ポリシーでリモートのパッケージ リポジトリへのアクセスを拒否している場合は、事前にインストールされたエージェントを使用してカスタム VM イメージを作成し、そのイメージ内でパッケージ管理を無効にすることをおすすめします。

次のステップ