個々の VM に Cloud Monitoring エージェントをインストールする

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

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

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

始める前に

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

コマンドラインからエージェントをインストールする

コマンドラインを使用してエージェントをインストールする手順は次のとおりです。

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

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

Linux

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

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

  3. 次のコマンドを使用して、エージェントのインストール スクリプトをダウンロードして実行します。

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

    インストール後、エージェントは自動的に起動します。

Windows

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

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

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

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

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

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

Linux

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

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

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

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

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

    • --verbose: スクリプトの実行中に詳細ログを有効にします。
    • --also-install: エージェント パッケージ リポジトリを追加した後にエージェントをインストールします。
    • --version: スクリプトをインストールするエージェントのバージョンを設定します。 バージョン情報については、すべてのエージェント バージョンを一覧表示するをご覧ください。
    • --uninstall: エージェントをアンインストールします。
    • --remove-repo: エージェントをインストールまたはアンインストールした後に、対応するエージェント パッケージ リポジトリを削除します。
    • --dry-run: スクリプト実行のドライランのみがトリガーされ、実行するはずのコマンドを出力します。

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

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

    1. 使用可能なエージェント バージョンを一覧表示するには、すべてのエージェント バージョンを一覧表示するをご覧ください。

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

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

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

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

      sudo bash add-monitoring-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      
  5. エージェント サービスを開始する

    sudo service stackdriver-agent start
    

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

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

    sudo service stackdriver-agent status
    

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

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

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

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

Windows

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

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

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

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

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

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

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

    & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
    

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

    & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Monitoring\"
    

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

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

Google Cloud コンソールでのエージェント情報の表示

エージェントのステータス情報は、事前構成された Monitoring の [VM インスタンス] ダッシュボードで確認できます。このダッシュボードにアクセスする方法は次のとおりです。

Google Cloud コンソールで、[VM インスタンス ダッシュボード] ページに移動します。

[VM インスタンス ダッシュボード] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

次のスクリーンショットのように、ダッシュボードの [INVENTORY] タブのリストビューには、すべての VM が一覧表示され、[エージェント] 列にステータスが表示されています。

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

[エージェント] 列には、次の値が報告されます。

  • 未検出: エージェントがインストールされていないか、実行されていません。エージェントがインストールされているかどうかわからない場合は、インストールされているバージョンをクエリできます。エージェントがすでにインストールされている場合は、エージェントを再起動できます。

  • Ops エージェント: Ops エージェントを実行しています。エントリの横に緑色のチェックマークが表示されない場合は、VM の検出されたオペレーティング システムに基づいて、エージェントのアップグレードが可能です。

    テーブルの Ops エージェント インジケーターにカーソルを合わせると、Ops エージェントのバージョンに関する情報が表示されます。古いバージョンを実行している場合は、エージェントをアップグレードするための推奨事項も表示されます。

  • 保留中: Ops エージェントがインストールまたはアップグレードされています。

  • 以前のエージェント: 以前の Monitoring または Logging エージェントを実行しています。Ops エージェントへの移行については、以前のエージェントから Ops エージェントへの移行をご覧ください。

  • 該当なし: この VM は、エージェントの実行に対応していないプラットフォームです。

  • 不明: VM は実行されていないため、エージェントのステータスは不明です。

Ops エージェントは、次の手順でインストールできます。

  • エージェントをインストールする VM インスタンスを選択します。
  • [インスタンス] テーブルで [Ops エージェントのインストール / 更新] オプションをクリックします。

特定の VM の [VM の詳細] ページから、Ops エージェントをインストールまたは更新することもできます。

可能な場合、エージェントは Ops エージェントの OS ポリシーを使用してインストールされます。詳細については、Ops エージェントの OS ポリシーの対象となる VM を管理するをご覧ください。Ops エージェントの OS ポリシーは、すべてのオペレーティング システムのすべてのバージョンでサポートされているわけではありません。この場合、[Ops エージェントのインストール / 更新] をクリックすると、Cloud Shell で実行する一連のコマンドが提供されます。

Ops エージェントはデフォルトで指標とログの両方を収集します。このデフォルト動作は、Ops エージェントを構成することで変更できます。

オプションのタスク

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

Monitoring エージェントを構成する

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

HTTP プロキシを構成する

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

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

     sudo service stackdriver-agent restart
    

Windows

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

    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

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

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

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

Restart-Service -Name StackdriverMonitoring

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

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

Linux

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

sudo bash add-monitoring-agent-repo.sh --also-install

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

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

Windows

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

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

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

Amazon Linux AMI / CentOS / RHEL

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

sudo yum list --showduplicates stackdriver-agent

Debian / Ubuntu

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

sudo apt-cache madison stackdriver-agent

SLES / SUSE

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

sudo zypper search -s stackdriver-agent

WINDOWS

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

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

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

エージェントをアンインストールした後、この変更が Google Cloud コンソールに反映されるまでに 1 時間ほどかかることがあります。

Linux

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

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

必要に応じて、エージェントのアンインストールに加えてリポジトリも削除する場合は、上述のコマンドに --remove-repo を追加します。

Windows

Windows コントロール パネルで、[プログラムのアンインストール] を選択します。アンインストール可能なプログラムの一覧に Monitoring エージェントが表示されます。Monitoring エージェントをインストールしたディレクトリから uninstall.exe を実行することもできます。

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

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

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

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

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

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

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

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

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

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