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 サーバーを実行している場合、エージェントはデフォルトでは、これらのサービスから指標を収集します。

始める前に

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

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 install -y stackdriver-agent
          
    2. 必要に応じて、エージェントのすべてのバージョンをリストして、インストールするバージョンを選択できます。使用可能なバージョンを表示するには、次のコマンドを実行します。

      sudo yum list -y stackdriver-agent
          
    3. 本番環境では、互換性のない変更を含むメジャーバージョンを pull するのを避けるため、メジャーバージョンに固定することもできます。メジャーバージョンに固定するには、次のコマンドを実行します。

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

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

      sudo yum install -y stackdriver-agent-N.*
          
    4. 次のコマンドを実行して、特定のバージョンのエージェントをインストールすることもできます。

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

    sudo service stackdriver-agent start
        

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

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-get install stackdriver-agent
          
    2. 必要に応じて、エージェントのすべてのバージョンをリストして、インストールするバージョンを選択できます。使用可能なバージョンを表示するには、次のコマンドを実行します。

      sudo apt-cache madison stackdriver-agent
          
    3. 本番環境では、互換性のない変更を含むメジャーバージョンを pull するのを避けるため、メジャーバージョンに固定することもできます。メジャーバージョンに固定するには、次のコマンドを実行します。

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

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

      sudo apt-get install 'stackdriver-agent=N.*'
          
    4. 次のコマンドを実行して、特定のバージョンのエージェントをインストールすることもできます。

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

    sudo service stackdriver-agent start
        

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

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 install stackdriver-agent
          
    2. 必要に応じて、エージェントのすべてのバージョンをリストして、インストールするバージョンを選択できます。使用可能なバージョンを表示するには、次のコマンドを実行します。

      sudo zypper search -s stackdriver-agent
          
    3. 本番環境では、互換性のない変更を含むメジャーバージョンを pull するのを避けるため、メジャーバージョンに固定することもできます。メジャーバージョンに固定するには、次のコマンドを実行します。

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

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

      sudo zypper install 'stackdriver-agent<N+1.0.0'
          
    4. 次のコマンドを実行して、特定のバージョンのエージェントをインストールすることもできます。

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

    sudo service stackdriver-agent start
        

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

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 の VM インスタンスで次のコマンドを実行します。

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 エージェントが表示されます。

トラブルシューティング

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