Apache ActiveMQ

Apache ActiveMQ モニタータイプには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

Splunk Distribution of OpenTelemetry Collectorは、Smart AgentレシーバーとApache ActiveMQモニタータイプを使用して、ActiveMQから以下の情報を追跡します：

ブローカー（ブローカーごとの合計）
キュー（キューの状態）
トピック（トピックの状況）

このインテグレーションはKubernetesとLinuxでのみ利用可能です。

このインテグレーションは、ActiveMQ 5.8.0以降で動作します。

メリット

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

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

インストール

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

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
- Kubernetes にインストールする
- Linux にインストールする
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定

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

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
- 「Collector でSmart Agent モニターを使用する」を参照してください。
- Smart Agent レシーバーの設定方法を参照してください。
- 一般的な構成オプションのリストについては、「モニターの共通設定」を参照してください。
- Collector の詳細については、「はじめに：Collector を理解して使用する」を参照してください。

例

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

receivers:
  smartagent/activemq:
    type: collectd/activemq
    ...  # Additional config

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

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

設定オプション

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


オプション	必須	タイプ	説明
`host`	〇	`string`	接続先のホスト。JMX はリモートアクセス用に設定されていてエージェントからアクセスできる必要があります。
`port`	はい	`integer`	アプリケーションの（RMI ポートではない）JMX 接続ポート。このは、アプリケーションの実行時にJVMに設定されるべき `com.sun.management.jmxremote.port` Javaプロパティに対応しています。
`name`	いいえ	`string`
`serviceName`	いいえ	`string`	これにより、Splunk Observability Cloud UI でサービスタイプを識別して、その組み込みコンテンツを取得できます。カスタム JMX インテグレーションの場合は、目的に応じて設定できます。
`serviceURL`	いいえ	`string`	JMX 接続文字列。これは Go テンプレートとしてレンダリングされ、この設定の他の値にアクセスできます。注: 通常の状況では、この文字列を直接設定することは推奨されません。上記のようにホストとポートを設定することが推奨されます。（デフォルト：`service:jmx:rmi:///jndi/rmi://{{.Host}}:{{.Port}}/jmxrmi`）
`instancePrefix`	いいえ	`string`	生成されたプラグイン・インスタンスにプレフィックスをつけます。第 2 の `instancePrefix` が参照されるMBeanブロックで指定された場合、Connectionブロックで指定された接頭辞がプラグイン・インスタンスの先頭に現れ、MBeanブロックで指定された接頭辞がそれに追加されます。
`username`	いいえ	`string`	サーバーを認証するユーザー名
`password`	いいえ	`string`	サーバーを認証するためのユーザーパスワード
`customDimensions`	いいえ	`map of strings`	接続収集時にカスタムディメンションのキーと値のペアを取り込みします。
`mBeansToCollect`	いいえ	`list of strings`	実際に収集するために `mBeanDefinitions` で定義されているMBeansのリスト。指定しない場合、定義されたすべての MBeans が収集されます。
`mBeansToOmit`	いいえ	`list of strings`	省略する MBean のリスト。これは、次の場合に役立ちます。 MBeansのみをデフォルトのリストから省く必要がある場合に有用です。
`mBeanDefinitions`	いいえ	`map of objects (see below)`	JMX MBean の値をメトリクスにマッピングする方法を指定します。hosts.txt ファイルを特定のサービスモニタ（Cassandra、Kafka、ActiveMQ など）を使用している場合、マッピングのセットがあらかじめロードされた状態で提供され、このオプションで追加したマッピングはそれらのマッピングにマージされます。詳細については、CollectD のドキュメントの「https://www.collectd.org/documentation/manpages/collectd-java.html」を参照してください。

ネストされた mBeanDefinitions コンフィギュレーション・オブジェクトには以下のフィールドがあります：


オプション	必須	タイプ	説明
`objectName`	いいえ	`string`	MBeanServerからMBeansを取得するために使われるパターンを基本的にはキーと値のペアである、いわゆる "プロパティ"から設定する MBeanServer。複数の MBean が返される場合、`instanceFrom` オプションを使用して識別子を一意にする必要があります。
`instancePrefix`	いいえ	`string`	生成されたプラグイン・インスタンスにプレフィックスをつけます。
`instanceFrom`	いいえ	`list of strings`	JMX が MBeans を識別するために使用するオブジェクト名には、基本的にキーと値のペアである、いわゆる「プロパティ」が含まれます。指定されたオブジェクト名が一意でなく、複数の MBean が返される場合、通常はそれらのプロパティの値が異なっています。このオプションを使用して、適切なプロパティ値からプラグインインスタンスを構築できます。このオプションは省略可能であり、複数のプロパティ値からプラグインインスタンスを生成するために繰り返すことができます。
`values`	いいえ	`list of objects (see below)`	`value` ブロックは、MBean の1つ以上の属性をエージェント内の値リストにマッピングします。各 MBean ブロック内に少なくとも 1 つの `value` ブロックが存在する必要があります。
`dimensions`	いいえ	`list of strings`

ネストされた values コンフィギュレーション・オブジェクトには以下のフィールドがあります：


オプション	必須	タイプ	説明
`type`	いいえ	`string`	次の値を扱うためにエージェント内で使用されるデータセットを設定します MBean属性の値を処理します。
`table`	いいえ	`bool`	返された属性が複合型の場合、これを `true` に設定します。総数。`true` に設定すると、複合型内のキーが型インスタンスに追加されます。（デフォルト：`false`）
`instancePrefix`	いいえ	`string`	MBeanブロックの直下にある同名のオプションと同様に機能しますが、代わりに型インスタンスを設定します。
`instanceFrom`	いいえ	`list of strings`	MBeanブロックの直下にある同名のオプションと同様に機能しますが、代わりに型インスタンスを設定します。
`attribute`	いいえ	`string`	値を読み込む属性名を設定します。クラスをドットを使用してキー名を属性名に連結することにより、複合タイプのキーにアクセスできます。次に例を示します。`attrib0.key42` `table` が `true`に設定されている場合、パスは複合タイプを指している必要があります。それ以外の場合は、数値タイプを指している必要があります。
`attributes`	いいえ	`list of strings`	上記の `attribute` 設定の複数形。これは 1つの MBean から複数のメトリクスを導出するために使用されます。

メトリクス

このインテグレーションでは、以下のメトリクスを使用できます：

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/collectd/activemq/metadata.yaml

備考

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

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______