概要

このチェックは、Datadog Agent を通じて SAP HANA 2.0, SPS 2 を監視します。

セットアップ

インストール

SAP HANA チェックは、Datadog Agent のパッケージに含まれています。このインテグレーションを使用するには、hdbcli ライブラリを手動でインストールする必要があります。

Unix: の場合:

sudo -Hu dd-agent /opt/datadog-agent/embedded/bin/pip install hdbcli==2.21.28

Windows の場合:

"C:\Program Files\Datadog\Datadog Agent\embedded<PYTHON_MAJOR_VERSION>\python.exe" -m pip install hdbcli==2.21.28

HANA の準備

特定のビューを照会するには、選択した HANA 監視ユーザーに特定の特権を付与する必要があります。詳細については、権限の付与を参照してください。

HANA テナント、シングルテナント、システムデータベースのポート番号を設定する方法については、SAP への接続のドキュメントを参照してください。

ユーザーの作成

1. システムデータベースに接続し、次のコマンドを実行してユーザーを作成します。

   CREATE RESTRICTED USER <USER> PASSWORD <PASSWORD>;
   

2. 次のコマンドを実行して、ユーザーがシステムに接続できるようにします。

   ALTER USER <USER> ENABLE CLIENT CONNECT;
   

3. （任意）サービスの中断を回避するために、パスワードの有効期間を長くすることができます。

   ALTER USER <USER> DISABLE PASSWORD LIFETIME;
   

権限の付与

1. 次のコマンドを実行して監視ロールを作成します（これらの例では DD_MONITOR と呼びます）。

   CREATE ROLE DD_MONITOR;
   

2. 次のコマンドを実行して、すべてのシステムビューへの読み取り専用アクセスを許可します。

   GRANT CATALOG READ TO DD_MONITOR;
   

3. 次に、次のコマンドを実行して、各システムビューで選択権限を付与します。

   GRANT SELECT ON SYS.M_DATABASE TO DD_MONITOR;
   GRANT SELECT ON SYS.M_DATABASES TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_BACKUP_PROGRESS TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_CONNECTIONS TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_DISK_USAGE TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_LICENSES TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_RS_MEMORY TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_SERVICE_COMPONENT_MEMORY TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_SERVICE_MEMORY TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_SERVICE_STATISTICS TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_VOLUME_IO_TOTAL_STATISTICS TO DD_MONITOR;
   

4. 最後に、次のコマンドを実行して、目的のユーザーに監視ロールを割り当てます。

   GRANT DD_MONITOR TO <USER>;
   

構成

1. sap_hana のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの sap_hana.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル sap_hana.d/conf.yaml を参照してください。

2. Agent を再起動します。

ログ収集

1. Datadog Agent で、ログの収集はデフォルトで無効になっています。datadog.yaml で有効にします。

   logs_enabled: true
   

2. このコンフィギュレーションブロックを sap_hana.d/conf.yaml ファイルに追加して、SAP HANA ログの収集を開始します。このとき、お使いの環境に応じて構成するために service の値が調整されます。

   logs:
     - type: integration
       source: sap_hana
       service: sap_hana
   

   使用可能なすべての構成オプションの詳細については、サンプル sap_hana.d/conf.yaml を参照してください。

3. Agent を再起動します。

検証

Agent の status サブコマンドを実行し、Checks セクションの sap_hana を探します。

収集データ

メトリクス

イベント

SAP HANA には、イベントは含まれません。

サービスチェック

sap_hana.can_connect
Returns CRITICAL if the Agent is unable to connect to the monitored SAP HANA system, or OK otherwise.
Statuses: ok, critical

sap_hana.status
Returns OK if the monitored SAP HANA database is up, or CRITICAL otherwise.
Statuses: ok, critical

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。