バージョン 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 サーバーまたは VM インスタンスとの 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 を使用して VM インスタンスに接続します。

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

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

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

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

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

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

Linux

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

  1. SSH を使用してホストマシンに接続します。
  2. 次のコマンドを実行します。 
    yum info google-cloud-sap-agent

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

  1. SSH を使用してホストマシンに接続します。
  2. 次のコマンドを実行します。 
    zypper info google-cloud-sap-agent

Windows

  1. RDP を使用して、ホストマシンに接続します。
  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. Bare Metal Solution サーバーのホスト VM インスタンスとの 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 を使用して VM インスタンスに接続します。

  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.2（最新）に更新する方法について説明します。

最新ではないバージョンのエージェントに更新する必要がある場合は、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.2（最新）に更新するには、オペレーティング システムを選択してから、次の操作を行ってください。

最新ではないバージョンのエージェントをインストールする必要がある場合は、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. エージェントを再起動して、この変更を有効にします。