SAP HANA 🔗

Splunk Distribution of OpenTelemetry Collectorは、Smart Agent レシーバーと hana モニタータイプを使用して、SAP Hanaデータベースからメトリクスを取得します。

このインテグレーションはKubernetes、Linux、Windowsで利用できます。

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索するを参照してください。

前提条件 🔗

モニタリングユーザーは関連するモニタリングビューへの SELECT アクセスを必要とします。SAP HANA モニタータイプを設定する前に、次の SQL スクリプトを実行して監視ロールを作成し、監視ユーザーに適用します：

--Create the user
CREATE RESTRICTED USER otel_monitoring_user PASSWORD <password>;

--Enable user login
ALTER USER otel_monitoring_user ENABLE CLIENT CONNECT;

--Create the monitoring role
CREATE ROLE OTEL_MONITORING;

--Grant permissions to the relevant views
GRANT CATALOG READ TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BACKUP_CATALOG TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BLOCKED_TRANSACTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CONNECTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_ALL_COLUMNS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DATABASE TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DISKS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_HOST_RESOURCE_UTILIZATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_LICENSES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_RS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_COMPONENT_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_REPLICATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_THREADS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_VOLUME_IO_TOTAL_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_WORKLOAD TO OTEL_MONITORING;
GRANT SELECT ON _SYS_STATISTICS.STATISTICS_CURRENT_ALERTS TO OTEL_MONITORING;

--Add the OTEL_MONITOR role to the monitoring user
GRANT OTEL_MONITORING TO otel_monitoring_user;

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/hana:
    type: hana
    ... # Additional config

その他の設定オプションを参照してください：

receivers:
  smartagent/hana:
    type: hana
    host: myhost.hana.us.hanacloud.ondemand.com
    port: <sap_hana_port>
    username: <username>
    password: <password>

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/hana]

コンフィギュレーション設定 🔗

次の表に、このインテグレーションの設定オプションを示します：

オプション	必須	タイプ	説明
`tlsServerName`	いいえ	`string`	`ServerName` を使用してホスト名を検証します。このオプションのデフォルトは `Host` です (指定されていない場合)。
`insecureSkipVerify`	いいえ	`bool`	クライアントがサーバーの証明書を検証するかどうかを制御します。チェーンとホスト名を指定します。デフォルト値は `false` です。
`rootCAFiles`	いいえ	`list of strings`	ルート証明書へのパス（オプション）

メトリクス 🔗

これらは、このインテグレーションで利用可能なメトリクスとディメンションです：

Name	Category	Description	Type
`sap.hana.connection.count`	Default	Number of connections	gauge
`sap.hana.connection.message.received.count`	Default	Total count of messages received	gauge
`sap.hana.connection.message.received.size`	Default	Total size of messages received	gauge
`sap.hana.connection.message.sent.count`	Default	Total count of messages sent	gauge
`sap.hana.connection.message.sent.size`	Default	Total size of messages sent	gauge
`sap.hana.connection.record.affected`	Default	The sum of the record count affected by DML/DDL statements	gauge
`sap.hana.connection.record.fetched`	Default	Number of records fetched by select statements	gauge
`sap.hana.disk.total_size`	Default	Total device size returned by the operating system in bytes	gauge
`sap.hana.disk.used_size`	Default	Size of used disk space in bytes	gauge
`sap.hana.host.cpu.idle`	Default	CPU idle time in milliseconds	counter
`sap.hana.host.cpu.system`	Default	CPU time spent in kernel mode	counter
`sap.hana.host.cpu.user`	Default	CPU time spent in user mode in milliseconds	counter
`sap.hana.host.cpu.wio`	Default	CPU time spent in wait IO (Linux only, Windows always 0) in milliseconds	counter
`sap.hana.host.file.open`	Default	Number of open files	gauge
`sap.hana.host.memory.allocation_limit`	Default	Allocation limit for all processes in bytes	gauge
`sap.hana.host.memory.code`	Default	Code size, including shared libraries of instance processes in bytes	gauge
`sap.hana.host.memory.physical.free`	Default	Free physical memory on the host in bytes	gauge
`sap.hana.host.memory.physical.used`	Default	Used physical memory on the host in bytes	gauge
`sap.hana.host.memory.shared`	Default	Shared memory size of instance processes in bytes	gauge
`sap.hana.host.memory.swap.free`	Default	Free swap memory on the host in bytes	gauge
`sap.hana.host.memory.swap.used`	Default	Used swap memory on the host in bytes	gauge
`sap.hana.host.memory.total_allocated`	Default	Size of the memory pool for all instance processes in bytes	gauge
`sap.hana.host.memory.total_used`	Default	Amount of memory from the memory pool that is currently being used by SAP HANA processes in bytes	gauge
`sap.hana.io.append.count`	Default	Number of appends	counter
`sap.hana.io.read.async.count`	Default	Number of triggered asynchronous reads	counter
`sap.hana.io.read.count`	Default	Number of synchronous reads	counter
`sap.hana.io.read.failed`	Default	Number of failed reads	counter
`sap.hana.io.read.size`	Default	Size of read data in bytes	counter
`sap.hana.io.read.time`	Default	Total read time in microseconds	counter
`sap.hana.io.total.time`	Default	Total write time in microseconds	counter
`sap.hana.io.write.async.count`	Default	Number of triggered asynchronous writes	counter
`sap.hana.io.write.count`	Default	Number of synchronous writes	counter
`sap.hana.io.write.failed`	Default	Number of failed writes	counter
`sap.hana.io.write.size`	Default	Size of written data in bytes	counter
`sap.hana.io.write.time`	Default	Total write time in microseconds	counter
`sap.hana.service.component.memory.used`	Default	Amount of memory from the memory pool currently in use by component	gauge
`sap.hana.service.cpu.utilization`	Default	CPU utilization in percent	gauge
`sap.hana.service.file.open`	Default	Number of open files	gauge
`sap.hana.service.memory.allocation_limit`	Default	Maximum configured memory pool size in bytes	gauge
`sap.hana.service.memory.allocation_limit_effective`	Default	Effective maximum memory pool size in bytes, considering the pool sizes of other processes	gauge
`sap.hana.service.memory.code`	Default	Code size, including shared libraries in bytes	gauge
`sap.hana.service.memory.heap.allocated`	Default	Heap part of the memory pool in bytes	gauge
`sap.hana.service.memory.heap.used`	Default	Amount of pool heap memory in use in bytes	gauge
`sap.hana.service.memory.logical`	Default	Virtual memory size in bytes	gauge
`sap.hana.service.memory.physical`	Default	Physical memory size in bytes	gauge
`sap.hana.service.memory.shared.allocated`	Default	Shared memory part of the memory pool in bytes	gauge
`sap.hana.service.memory.shared.used`	Default	Amount of shared memory pool in use in bytes	gauge
`sap.hana.service.memory.stack`	Default	Stack size	gauge
`sap.hana.service.memory.total_used`	Default	Amount of memory in use from the memory pool	gauge
`sap.hana.statement.active.count`	Default	Number of active statements	gauge
`sap.hana.statement.active.execution.memory.max`	Default	Max memory size used during execution	gauge
`sap.hana.statement.active.execution.memory.mean`	Default	Average memory size used during execution	gauge
`sap.hana.statement.active.execution.memory.sum`	Custom	Sum of memory size used during execution	gauge
`sap.hana.statement.active.execution.sum`	Custom	Sum of statement execution time	gauge
`sap.hana.statement.active.execution.time.max`	Default	Maximum time of statement execution	gauge
`sap.hana.statement.active.execution.time.mean`	Default	Average time of statement execution	gauge
`sap.hana.statement.expensive.count`	Default	Number of occurances of the statement	counter
`sap.hana.statement.expensive.cpu_time`	Default	CPU time consumed to compute the statement in microseconds	counter
`sap.hana.statement.expensive.duration`	Default	Time elapsed during execution of the statement in microseconds	counter
`sap.hana.statement.expensive.errors`	Default	Number of errors	counter
`sap.hana.statement.expensive.lock_wait_duration`	Default	Accumulated lock wait duration	counter
`sap.hana.statement.expensive.records`	Default	Number of records	counter
`sap.hana.table.record.count`	Default	Number of records in the table	gauge
`sap.hana.table.size`	Default	Allocated memory size for fixed-size and variable-size part	gauge

dimensions

Name	Description
app_user	Application user name
component_name	Logical component
connection_status	Connection status (RUNNING, IDLE, QUEUING)
db_user	User name
hana_host	SAP Hana host name
operation	Type of operation (prepare, execute, fetch, or close)
schema_name	Schema name
service_name	Service name
statement_hash	Unique identifier for an SQL string.
table_name	Table name
table_type	Type of the table (ROW, COLUMN, COLLECTION)
type	Type of contained files
usage_type	Resource type like LOG, DATA, TRACE, LOG_BACKUP and DATA_BACKUP

備考 🔗

Splunk Observability Cloudで利用可能なメトリクスタイプの詳細は、メトリクスタイプを参照してください。
ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloudのホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されず、料金が発生する場合があります。詳細については、メトリクスカテゴリを参照してください。
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加で extraMetrics の設定方法を参照してください。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月11日に最終更新されました。

Related Topics