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

Cloud Monitoring エージェントは、VM インスタンスからシステム指標とアプリケーション指標を収集し、それらの情報を Monitoring に送信します。サードパーティ アプリケーションをモニタリングするように Monitoring エージェントを構成することもできます。

このガイドでは、Compute Engine と Amazon Elastic Compute Cloud(EC2)の仮想マシンに Monitoring 用の Cloud Monitoring エージェントをインストールする方法について説明します。Monitoring エージェントの使用は必須ではありませんが、使用することをおすすめします。Monitoring は、Monitoring エージェントがなくても、CPU 使用率、一部のディスク トラフィック指標、ネットワーク トラフィック、稼働時間情報など、いくつかの指標に仮想マシンのハイパーバイザからアクセスできます。

Microsoft Windows を実行しているインスタンスでは、エージェントは CPU 使用率とメモリ、ページファイル、ボリュームの使用状況を記録します。IIS や SQL サーバーを実行している場合、エージェントはデフォルトでは、これらのサービスから指標を収集します。

始める前に

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

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

    • Monitoring エージェントを実行するには、最低 250 MiB の常駐(RSS)メモリが推奨されます。

    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 Link で始まる名前

  • aws- で始まる ID

    この ID は、VM インスタンスに関連付けられた Google Cloud プロジェクトです。

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

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

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

Linux と Windows へのインストール

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

Amazon Linux AMI / CentOS / RHEL

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

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

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

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

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

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

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

      sudo yum install -y stackdriver-agent-[MAJOR_VERSION].*
      

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

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

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

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

          sudo yum install -y stackdriver-agent
        
  6. エージェント サービスを開始する

    sudo service stackdriver-agent start
    

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

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

    sudo service stackdriver-agent status
    

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

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

    grep collectd /var/log/{syslog,messages} | tail
    

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

Debian / Ubuntu

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

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

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

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

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

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

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

      sudo apt-get install -y 'stackdriver-agent=[MAJOR_VERSION].*'
      

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

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

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

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

          sudo apt-get install stackdriver-agent
        
  6. エージェント サービスを開始する

    sudo service stackdriver-agent start
    

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

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

    sudo service stackdriver-agent status
    

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

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

    grep collectd /var/log/{syslog,messages} | tail
    

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

SLES / SUSE

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

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

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

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

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

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

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

      sudo zypper install -y 'stackdriver-agent<[MAJOR_VERSION].0.0'
      

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

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

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

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

          sudo zypper install stackdriver-agent
        
  6. エージェント サービスを開始する

    sudo service stackdriver-agent start
    

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

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

    sudo service stackdriver-agent status
    

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

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

    grep collectd /var/log/{syslog,messages} | tail
    

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

Windows

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

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

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

    cd $env:UserProfile;
    (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", ".\StackdriverMonitoring-GCM-46.exe")
    .\StackdriverMonitoring-GCM-46.exe
    

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

    https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

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

    .\StackdriverMonitoring-GCM-46.exe /S
    

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

    .\StackdriverMonitoring-GCM-46.exe /S /D="C:\Google Cloud's operations suite\Monitoring\"
    

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

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

オプションのタスク

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

HTTP プロキシを構成する

HTTP プロキシを使用する場合は、次の手順を行います。

Linux

  1. 次の構成ファイルを編集します。

    • エージェント バージョン 6.0.0 以降の場合は、次のように編集します。

      /etc/default/stackdriver-agent
      
    • 6.0.0 より前のエージェント バージョンの場合は、OS に応じて適切なファイルを編集します。

      Debian と Ubuntu の場合:

      /etc/default/stackdriver-agent
      

      CentOS と SLES の場合:

      /etc/default/stackdriver-collectd
      
  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 インスタンスで次のコマンドを実行して、Monitoring エージェントを再起動します。

     sudo service stackdriver-agent restart
    

Windows

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

    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
    

エージェントのバージョンの確認

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

AMAZON LINUX AMI / CENTOS / RHEL

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

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     stackdriver-agent

Debian / Ubuntu

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

dpkg-query --show --showformat \
    '${Package} ${Version} ${Architecture} ${Status}\n' \
     stackdriver-agent

SLES / SUSE

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

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     stackdriver-agent

Windows

現在のところ、Windows で実行されている Monitoring エージェントのバージョンを確認する方法はありません。

エージェントの再起動

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

Linux

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

 sudo service stackdriver-agent restart

Windows

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

Restart-Service -Name StackdriverMonitoring

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

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

Amazon Linux AMI / CentOS / RHEL

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

sudo yum update stackdriver-agent

DEBIAN / UBUNTU

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

sudo apt-get update
sudo apt-get install stackdriver-agent

SLES / SUSE

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

sudo zypper update stackdriver-agent

Windows

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

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

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum remove stackdriver-agent

Debian / Ubuntu

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

sudo apt-get purge stackdriver-agent

SLES / SUSE

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

sudo zypper remove stackdriver-agent

Windows

Windows コントロール パネルで、[プログラムのアンインストール] を選択します。アンインストール可能なプログラムの一覧に Monitoring エージェントが表示されます。