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

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

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

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

始める前に

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

  • Google Cloud プロジェクト、または Amazon Web Services(AWS)アカウントでサポートされている VM インスタンス

    • Logging エージェントをインストールする場合は、最低 250 MiB のメモリが必要ですが、1 GiB をおすすめします。

    VM がサポートされているオペレーティング システムを実行していることも確認します。

  • VM インスタンスを含む AWS アカウントをモニタリングするワークスペース。価格情報については、Google Cloud のオペレーション スイートの料金設定をご覧ください。

  • Cloud Logging または Cloud Monitoring との通信を承認する VM インスタンス上の認証情報。通常、Compute Engine VM インスタンスにはデフォルトで適切な認証情報があります。次のいずれかのシナリオが該当する場合は、適切な認証情報がない可能性があるため、エージェントの認証手順を完了する必要があります。

    • AWS EC2 VM インスタンスを実行している場合は、エージェントをインストールする前に VM に認証情報をインストールする必要があります。

    • 非常に古い、またはデフォルトの認証情報なしで作成された Compute Engine インスタンスを実行している場合。

    適切な認証情報があるかどうかを確認するには、Compute Engine 認証の検証の手順を実施します。

AWS EC2 VM インスタンス用の Google Cloud プロジェクト

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

AWS アカウントをワークスペースに接続すると、AWS コネクタ プロジェクトが作成されます。AWS コネクタ プロジェクトを識別するには、ワークスペースの [設定] タブに移動します。コネクタ プロジェクトが [AWS Accounts] という見出しの下に表示されます。[プロジェクト ID] 列には、ワークスペースに関連付けられている Google Cloud プロジェクトが表示されます。

AWS コネクタ プロジェクトの詳細については、ワークスペースのページをご覧ください。

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

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

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

Linux または Microsoft Windows を実行している VM インスタンスにエージェントをインストールするには、次の手順を使用します。

Amazon Linux AMI / CentOS / RHEL

  1. SSH または同様のツールを使用して、VM インスタンスへのターミナル接続を開きます。

  2. sudo にアクセスできることを確認します。

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

  4. 次のエージェントのパッケージ リポジトリを追加します。

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  5. 次のエージェントをインストールします。

    1. インストール可能なバージョンを選択するために、次に使用可能なエージェントのバージョンを一覧表示します。

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

      sudo yum install -y google-fluentd-major-versio.*
      

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

      sudo yum install -y google-fluentd-1.*
      
    3. メジャー バージョンに固定しない場合は、次のいずれかのインストール オプションを選択できます。

      1. 特定のバージョンのエージェントをインストールするには、次のコマンドを実行します。

          sudo yum install -y google-fluentd-version-number
        
      2. エージェントの最新バージョンをインストールするには、次のコマンドを実行します。

          sudo yum install -y google-fluentd
        
  6. 構成ファイルをインストールします。

    1. 非構造化ロギングの場合は、次のコマンドを実行します。

      sudo yum install -y google-fluentd-catch-all-config
      
    2. 構造化ロギングの場合は、次のコマンドを実行します。

      sudo yum install -y google-fluentd-catch-all-config-structured
      

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

  7. エージェント サービスを開始する

    sudo service google-fluentd start
    

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

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

    sudo service google-fluentd status
    

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

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

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

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

Debian / Ubuntu

  1. SSH または同様のツールを使用して、VM インスタンスへのターミナル接続を開きます。

  2. sudo にアクセスできることを確認します。

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

  4. 次のエージェントのパッケージ リポジトリを追加します。

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    sudo apt-get update
    
  5. 次のエージェントをインストールします。

    1. インストール可能なバージョンを選択するために、次に使用可能なエージェントのバージョンを一覧表示します。

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

      sudo apt-get install -y 'google-fluentd=major-version.*'
      

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

      sudo apt-get install -y 'google-fluentd=1.*'
      
    3. メジャー バージョンに固定しない場合は、次のいずれかのインストール オプションを選択できます。

      1. 特定のバージョンのエージェントをインストールするには、次のコマンドを実行します。

          sudo apt-get install -y google-fluentd=version-number
        
      2. エージェントの最新バージョンをインストールするには、次のコマンドを実行します。

          sudo apt-get install google-fluentd
        
  6. 構成ファイルをインストールします。

    1. 非構造化ロギングの場合は、次のコマンドを実行します。

      sudo apt-get install -y google-fluentd-catch-all-config
      
    2. 構造化ロギングの場合は、次のコマンドを実行します。

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

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

  7. エージェント サービスを開始する

    sudo service google-fluentd start
    

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

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

    sudo service google-fluentd status
    

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

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

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

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

SLES / SUSE

  1. SSH または同様のツールを使用して、VM インスタンスへのターミナル接続を開きます。

  2. sudo にアクセスできることを確認します。

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

  4. 次のエージェントのパッケージ リポジトリを追加します。

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  5. 次のエージェントをインストールします。

    1. インストール可能なバージョンを選択するために、次に使用可能なエージェントのバージョンを一覧表示します。

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

      sudo zypper install -y 'google-fluentd<major-version.0.0'
      

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

      sudo zypper install -y 'google-fluentd<1+1.0.0'
      
    3. メジャー バージョンに固定しない場合は、次のいずれかのインストール オプションを選択できます。

      1. 特定のバージョンのエージェントをインストールするには、次のコマンドを実行します。

          sudo zypper install -y google-fluentd=version-number
        
      2. エージェントの最新バージョンをインストールするには、次のコマンドを実行します。

          sudo zypper install google-fluentd
        
  6. 構成ファイルをインストールします。

    1. 非構造化ロギングの場合は、次のコマンドを実行します。

      sudo zypper install -y google-fluentd-catch-all-config
      
    2. 構造化ロギングの場合は、次のコマンドを実行します。

      sudo zypper install -y google-fluentd-catch-all-config-structured
      

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

  7. エージェント サービスを開始する

    sudo service google-fluentd start
    

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

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

    sudo service google-fluentd status
    

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

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

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

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

Windows

Windows を実行している VM インスタンスにエージェントをインストールするには、次の手順を実施します。

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

  2. PowerShell ターミナルを開き、次の PowerShell コマンドを実行します。管理者権限は必要ありません。

    cd $env:UserProfile;
    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-12.exe", ".\StackdriverLogging-v1-12.exe")
    .\StackdriverLogging-v1-12.exe
    

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

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

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

    .\StackdriverLogging-v1-12.exe /S
    

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

    .\StackdriverLogging-v1-12.exe /S /D="C:\Google Cloud's operations suite\Logging\"
    

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

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

オプションのタスク

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

エージェントの構成

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

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

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

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

エージェントの再起動

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

Linux

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

 sudo service google-fluentd restart

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

Windows

管理者権限が必要: エージェントを再起動するには、PowerShell ターミナルで次のコマンドを実行します。

Restart-Service -Name StackdriverLogging

エージェントのアップグレード

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

Amazon Linux AMI / CentOS / RHEL

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

sudo yum upgrade google-fluentd

上記のコマンドではエージェントの構成ファイルは変更されません。最新のデフォルト構成およびキャッチオール構成ファイルを取得するには、インスタンスで次のコマンドを実行します。

sudo yum upgrade google-fluentd google-fluentd-catch-all-config

Debian / Ubuntu

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

sudo apt-get update
sudo apt-get install --only-upgrade google-fluentd

上記のコマンドではエージェントの構成ファイルは変更されません。最新のデフォルト構成およびキャッチオール構成ファイルを取得するには、インスタンスで次のコマンドを実行します。

sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

SLES / SUSE

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

sudo zypper update google-fluentd

上記のコマンドではエージェントの構成ファイルは変更されません。最新のデフォルト構成およびキャッチオール構成ファイルを取得するには、インスタンスで次のコマンドを実行します。

sudo zypper update google-fluentd google-fluentd-catch-all-config

Windows

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

エージェントのアンインストール

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

Amazon Linux AMI / CentOS / RHEL

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

sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

Debian / Ubuntu

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

sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

SLES / SUSE

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

sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

Windows

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