バージョン 2: Google Cloud の SAP 用エージェントの運用ガイド

このガイドでは、Compute Engine VM インスタンスと Bare Metal Solution サーバーで Google Cloudの SAP 用エージェント バージョン 2 を実行するにあたり、運用上留意する点と手順について説明します。

エージェントのライフサイクルを理解する

Google Cloudの SAP 用エージェントの運用管理を行うには、エージェントの機能を把握しておくことが有効です。一般的な仕組みは次のとおりです。

  • SAP システムをホストする各 Compute Engine VM インスタンスまたは Bare Metal Solution サーバーに、 Google Cloudの SAP 用エージェントをインストールする必要があります。エージェントは Linux サービスまたは Windows サービスとして実行されます。
  • Compute Engine VM インスタンスで、エージェントは Monitoring と Compute Engine API のモニタリング データを結合します。
  • Bare Metal Solution サーバーで SAP Host Agent の指標のみを収集する場合、エージェントは Google Cloud APIs にアクセスしません。
  • SAP Host Agent は、HTTP を介して Google Cloudの SAP 用エージェントをポーリングし、キャッシュ データの有無を確認します。SAP Host Agent の指標を集約して報告し、SAP NetWeaver データベースに保存します。
  • SAP のトランザクション ST06 または saposcol コマンドライン インターフェースに、SAP Host Agent の指標が集計されて表示されます。
  • Google Cloudの SAP 用エージェントから SAP Host Agent の指標を表示するには、ターミナル ウィンドウでコマンドを実行します。

エージェントが実行されていることを確認する

エージェントをインストールした後、またはエージェントを再起動した後に、エージェントが期待どおりに動作していることを確認します。

エージェントが実行されているかどうかを確認するには、次の操作を行います。

Linux

  1. Bare Metal Solution サーバーまたは Compute Engine インスタンスとの SSH 接続を確立します。

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

    systemctl status google-cloud-sap-agent

    エージェントが正常に機能している場合、出力には active (running) が含まれます。次に例を示します。

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

  1. RDP を使用して Compute Engine インスタンスに接続します。

  2. 管理者として PowerShell から次のコマンドを実行します。

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
     エージェントが実行されている場合、ステータスは Running になります。

Google Cloudの SAP 用エージェントが実行されていない場合は、エージェントを再起動します。

エージェントのバージョンを確認する

Google Cloudの SAP 用エージェントをインストールまたは再起動した後で、エージェントのバージョンを確認できます。

エージェントのバージョンを確認する手順は次のとおりです。

Linux

RHEL の場合、次の操作を行います。

  1. SSH を使用して、ホスト Compute Engine インスタンスまたは Bare Metal Solution サーバーに接続します。
  2. 次のコマンドを実行します。
    yum info google-cloud-sap-agent

SLES の場合、次の操作を行います。

  1. SSH を使用して、ホスト Compute Engine インスタンスまたは Bare Metal Solution サーバーに接続します。
  2. 次のコマンドを実行します。
    zypper info google-cloud-sap-agent

Windows

  1. RDP を使用して、ホスト Compute Engine インスタンスまたは Bare Metal Solution サーバーに接続します。
  2. 管理者として PowerShell から次のコマンドを実行します。
    googet installed google-cloud-sap-agent

SAP Host Agent が指標を受信していることを確認する

Google Cloudの SAP 用エージェントによってインフラストラクチャの指標が収集され、SAP Host Agent に正しく送信されていることを確認するには、次の操作を行います。

  1. SAP システムで、トランザクションとして「ST06」を入力します。

  2. 概要ウィンドウで可用性と以下のフィールドの内容を確認し、SAP と Google モニタリング インフラストラクチャのエンドツーエンドの設定が正しいか調べます。

    • クラウド プロバイダ: Google Cloud Platform
    • Enhanced Monitoring Access: TRUE
    • Enhanced Monitoring Details: ACTIVE

SAP Host Agent の指標を表示する

Google Cloudの SAP 用エージェントの構成をインストールまたは更新した後、収集対象の SAP Host Agent の指標を表示できます。

Google Cloudの SAP 用エージェントによって収集された SAP Host Agent の指標を表示する手順は次のとおりです。

Linux

  1. ホスト Compute Engine インスタンスや Bare Metal Solution サーバーと SSH 接続を確立します。

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

    curl http://localhost:18181

    指標が利用可能な場合は、システムに関する情報を含む XML 出力が表示されます。次に例を示します。

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

  1. RDP を使用して Compute Engine インスタンスに接続します。

  2. 管理者として PowerShell から次のコマンドを実行します。

    (Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

    指標が利用可能な場合、システムに関する情報を含む XML 出力が表示されます。例:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

その他の指標を表示する

Process Monitoring 指標、Workload Manager 評価指標、または SAP HANA モニタリング指標を収集するように Google Cloudの SAP 用エージェントの構成を更新した後、エージェントが想定どおりに指標を収集していることを確認するため、これらを表示する必要があります。

Google Cloudの SAP 用エージェントによって収集された指標と情報は、次の手順で Cloud Monitoring で表示できます。

  1. Google Cloud コンソールで Monitoring の [Metrics Explorer] ページに移動します。

    Metrics Explorer に移動

  2. [CONFIGURATION] タブを選択します。

  3. [指標を選択] メニューを開きます。

  4. [リソース] メニューで、[VM instance] を選択します。

  5. [指標カテゴリ] メニューで、[sap] を選択します。

  6. [指標] メニューで、metric: workload.googleapis.com/sap/service/active またはグラフ化する新しい指標を選択します。

  7. [適用] をクリックします。

時系列指標の値を含むグラフが表示されます。

エージェントを再起動する

Google Cloudの SAP 用エージェントが停止するか、構成を更新した場合は、エージェントを再起動します。

ご使用のオペレーティング システムに応じて、次の操作を行います。

Linux

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

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

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. ホスト VM インスタンスと RDP 接続を確立します。

  2. 管理者として PowerShell から次のコマンドを実行します。

    Restart-Service -Name 'google-cloud-sap-agent' -Force

他の Google Cloud エージェントから Google Cloudの SAP 用エージェントにアップグレードする

Google Cloudの SAP 用エージェントをインストールすると、SAP NetWeaver 用モニタリング エージェントと SAP HANA 用モニタリング エージェントの古いバージョンが自動的に検出されます。これらを無効にしてから、インストール中にホストマシンから削除します。

これらの Google Cloud エージェントが検出されると、インストール中に構成ファイルも Google Cloudの SAP 用エージェントに移行されます。バックアップと参照のため、SAP HANA 用モニタリング エージェントの構成が次のファイルにコピーされます。

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

Google Cloudの SAP 用エージェントをインストールして構成する手順については、 Google Cloudの SAP 用エージェントのインストールと構成のガイドを選択するをご覧ください。

SSL 対応インスタンスのアップグレード

SAP HANA インスタンスとの通信に SSL 証明書を使用するように SAP HANA 用モニタリング エージェントを構成している場合は、 Google Cloudの SAP 用エージェントをインストールするときに、SSL 構成を除くすべての SAP HANA モニタリング構成が Google Cloudの SAP 用エージェントに移行されます。このような場合に、 Google Cloudの SAP 用エージェントを使用して SAP HANA インスタンスをモニタリングするには、次の手順を完了する必要があります。

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

  2. Google Cloudの SAP 用エージェントの構成ファイルを開きます。

    /etc/google-cloud-sap-agent/configuration.json

  3. hana_monitoring_configuration セクションで、enabled パラメータを true に設定します。

  4. hana_monitoring_configuration.hana_instances セクションで、セキュア通信に TLS / SSL プロトコルを使用する SAP HANA インスタンスごとに次の操作を行います。

    1. enable_ssl パラメータを指定して、値を true に設定します。

    2. host_name_in_certificate パラメータを指定し、値として TLS / SSL 証明書で指定されている SAP HANA ホスト名を設定します。

    3. tls_root_ca_file パラメータを指定し、値として TLS / SSL 証明書が保存されているパスを設定します。

  5. 構成ファイルを保存します。

  6. エージェントを再起動して、新しい設定を有効にします。

    sudo systemctl restart google-cloud-sap-agent

  7. エージェントが SAP HANA モニタリング指標を収集していることを確認します。手順については、その他の指標を表示するをご覧ください。

  8. SAP HANA 用モニタリング エージェントをアンインストールします。

このアップグレード後に SAP HANA インスタンスとの接続で問題が発生した場合は、Logging でエージェントのログを表示し、トラブルシューティング ガイドを使用して問題を解決できます。

Google Cloudの SAP 用エージェントを更新する

このセクションでは、Google Cloudの SAP 用エージェントの新しいバージョンが提供されているかどうかを確認する手順と、 Google Cloudの SAP 用エージェントをバージョン 3.8（最新）に更新する方法について説明します。

最新ではないバージョンのエージェントに更新する必要がある場合は、Cloud カスタマーケアにお問い合わせください。

更新を確認する

ご使用のオペレーティング システムに応じて、次の操作を行います。

RHEL

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

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

    sudo yum check-update google-cloud-sap-agent

SLES

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

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

    sudo zypper list-updates -r google-cloud-sap-agent

Windows

  1. ホスト VM インスタンスと RDP 接続を確立します。

  2. 管理者として PowerShell から次のコマンドを実行します。

    googet latest google-cloud-sap-agent

更新をインストールする

Google Cloudの SAP 用エージェントのインスタンスをバージョン 3.8（最新）に更新するには、オペレーティング システムを選択してから、次の操作を行います。

最新ではないバージョンのエージェントをインストールする必要がある場合は、Cloud カスタマーケアにお問い合わせください。

RHEL

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

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

    sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

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

    sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

  1. ホスト VM インスタンスと RDP 接続を確立します。

  2. 管理者として PowerShell から次のコマンドを実行します。

    googet install google-cloud-sap-agent

SAP HANA 用モニタリング エージェントを使用するようにロールバックする

SAP HANA 用モニタリング エージェントを使用するようにロールバックし、 Google Cloudの SAP 用エージェントの SAP HANA モニタリング機能の使用を停止する場合は、次の操作を行います。

RHEL

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

  2. 重複した指標が収集されないようにするには、Google Cloudの SAP 用エージェントによる SAP HANA モニタリング指標の収集を無効にします。

    1. Google Cloudの SAP 用エージェントの構成ファイルを開きます。

      /etc/google-cloud-sap-agent/configuration.json

    2. hana_monitoring_configuration セクションで、enabled パラメータを false に設定します。

    3. 構成ファイルを保存します。

    4. エージェントを再起動して、新しい設定を有効にします。

      sudo systemctl restart google-cloud-sap-agent

  3. 次のファイルから SAP HANA 用モニタリング エージェントの構成をコピーします。

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. SAP HANA 用モニタリング エージェント バージョン 2 をインストールします。インストール手順については、SAP HANA 用モニタリング エージェント V2.0 のインストールおよび操作ガイドをご覧ください。

  5. 次の手順で、前の手順でコピーした SAP HANA 用のモニタリング エージェントの構成を貼り付けます。

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. SAP HANA 用モニタリング エージェントを再起動します。

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

  2. 重複した指標が収集されないようにするには、Google Cloudの SAP 用エージェントによる SAP HANA モニタリング指標の収集を無効にします。

    1. Google Cloudの SAP 用エージェントの構成ファイルを開きます。

      /etc/google-cloud-sap-agent/configuration.json

    2. hana_monitoring_configuration セクションで、enabled パラメータを false に設定します。

    3. 構成ファイルを保存します。

    4. エージェントを再起動して、新しい設定を有効にします。

      sudo systemctl restart google-cloud-sap-agent

  3. 次のファイルから SAP HANA 用モニタリング エージェントの構成をコピーします。

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. SAP HANA 用モニタリング エージェント バージョン 2 をインストールします。インストール手順については、SAP HANA 用モニタリング エージェント V2.0 のインストールおよび操作ガイドをご覧ください。

  5. 次の手順で、前の手順でコピーした SAP HANA 用のモニタリング エージェントの構成を貼り付けます。

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. SAP HANA 用モニタリング エージェントを再起動します。

    sudo systemctl start google-saphanamonitoring-agent

Cloud Logging でエージェントのログを表示する

デフォルトでは、 Google Cloudの SAP 用エージェントのログは、VM インスタンスと Bare Metal Solution サーバーから Cloud Logging にリダイレクトされます。

Logging でエージェントのログを表示する手順は次のとおりです。

  1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

    [ログ エクスプローラ] に移動

  2. [クエリ] ペインに移動します。

  3. [リソース] プルダウン メニューから [グローバル] を選択し、[適用] をクリックします。

  4. クエリエディタで、「google-cloud-sap-agent」と入力します。

  5. [クエリを実行] をクリックします。

すべての VM インスタンスや Bare Metal Solution サーバーで実行されているエージェント インスタンスによって生成されたログが表示されます。特定のマシンのログをフィルタするには、インターフェースで使用可能なフィルタを使用します。

エージェント ログのこのデフォルトのリダイレクトは無効にできます。方法は次のとおりです。

  1. Bare Metal Solution サーバーのホスト VM インスタンスとの SSH 接続を確立します。

  2. 次の構成ファイルを開きます。

    /etc/google-cloud-sap-agent/configuration.json

  3. log_to_cloud パラメータの値を false に更新します。

  4. 構成ファイルを保存します。

  5. エージェントを再起動して、この変更を有効にします。