単一の 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 イメージに含まれているため、このページをスキップできます。

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

始める前に

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

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

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

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

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

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

エージェントを再起動するには、次の手順を使用します。

Amazon Linux AMI / CentOS / RHEL

  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
    
  4. 次のエージェントをインストールします。

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

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

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

      たとえば、エージェントの 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
        
  5. 構成ファイルをインストールします。

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

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

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

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

  6. エージェント サービスの再起動

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

    sudo service google-fluentd restart
    

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

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

    sudo service google-fluentd status
    

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

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

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

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

Debian / Ubuntu

  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 && \
    sudo apt-get update
    
  4. 次のエージェントをインストールします。

    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 -y google-fluentd
        
  5. 構成ファイルをインストールします。

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

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

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

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

  6. エージェント サービスの再起動

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

    sudo service google-fluentd restart
    

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

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

    sudo service google-fluentd status
    

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

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

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

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

SLES / SUSE

  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
    
  4. 次のエージェントをインストールします。

    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<2.0.0'
      
    3. メジャー バージョンに固定しない場合は、次のいずれかのインストール オプションを選択できます。

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

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

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

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

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

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

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

  6. エージェント サービスの再起動

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

    sudo service google-fluentd restart
    

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

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

    sudo service google-fluentd status
    

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

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

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

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

Windows

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

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

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

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

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

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

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

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

    .\StackdriverLogging-v1-14.exe /S
    

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

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

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

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

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

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

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

  1. Cloud Console で、Google Cloud プロジェクトを選択します。
    Cloud Console に移動
  2. ナビゲーション パネルで [Monitoring] を選択します。

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

  3. [モニタリング] のナビゲーション ペインで、[ダッシュボード] を選択します。
  4. ダッシュボードの表で [VM インスタンス] エントリを見つけて、名前をクリックします。

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

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

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

オプションのタスク

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

エージェントの構成

エージェントは、特定の既知のログの場所をモニタリングするように事前構成されています。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

  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 エージェントを最新リリースにアップグレードするには、次の手順を使用します。

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 -y --only-upgrade google-fluentd

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

sudo apt-get install -y --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install -y --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 エージェントが表示されます。

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

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

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

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

次のステップ