Docs » Splunk Observability Cloud でサポートされているインテグレーション » メッセージング用のアプリケーション・レシーバーを設定する » Apache Kafka

Apache Kafka 🔗

Splunk Distribution of OpenTelemetry Collector は、Smart Agent レシーバー と Apache Kafka モニタータイプを使用して Kafka インスタンスを監視します。

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

このインテグレーションはKafka v0.8.2.x以上をサポートしています。

Kafka v1.x.x以上では、デフォルトのメトリクスに加えて、以下を監視します：

  • kafka.server:type=ZooKeeperClientMetrics,name=ZooKeeperRequestLatencyMs を使用して、ブローカーが Zookeeper へのリクエストが完了するまでの待ち時間を追跡します。

  • 基盤となるホストのディスク使用率とネットワークメトリクス。Zookeeper は Kafka クラスターに不可欠な要素であるため、Zookeeper モニターを使用して監視することができます。

メリット 🔗

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

インストール 🔗

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

  1. Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

  2. 設定のセクションで説明するように、モニターを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

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

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

### 例

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

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

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

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

OpenTelemetry CollectorのSplunkディストリビューションが既存の環境をどのように統合し、補完できるかを示す具体的な使用例については、構成例を参照してください。

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

次の表に、このモニターの設定オプションを示します：

オプション

必須

タイプ

説明

host

はい

string
接続先のホスト。JMX がリモートアクセス用に設定され

エージェントからアクセスできる必要があります。

port

はい

integer
アプリケーションの（RMIポートではない）JMX接続ポート。これ

は、アプリケーションの実行時にJVMに設定されるべき com.sun.management.jmxremote.port Javaプロパティに対応しています。

name

いいえ

string

serviceName

いいえ

string
これは、Splunk

Splunk Observability Cloud UI so that you can get built-in content for it. For custom JMX integrations, it can be set to whatever you like.

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
省略するMBeansのリスト。これは少数の

MBeansのみをデフォルトのリストから省く必要がある場合に有用です。

mBeanDefinitions

いいえ

map of objects (see below)
JMX MBean の値をメトリクスにマッピングする方法を指定します。

Cassandra、Kafka、ActiveMQなどの特定のサービスモニターには、マッピングのセットがあらかじめロードされおり、このオプションで追加したマッピングは、それらのマッピングにマージされます。詳細については、Collectd ドキュメント を参照してください。

clusterName

はい

string

ブローカーが属するクラスター名

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

オプション

必須

タイプ

説明

objectName

いいえ

string
MBeanServerからMBeansを取得するために使用されるパターンを設定します。

複数のMBeanが返される場合、instanceFrom オプションを使用して識別子を一意にする必要があります。

instancePrefix

いいえ

string

生成されたプラグイン・インスタンスに基本的にはキーと値のペアである、いわゆる 「プロパティ」というプレフィックスを付けます

instanceFrom

いいえ

list of strings
JMX が MBeans を識別するために使用するオブジェクト名には、

。与えられたオブジェクト名が一意でなく、複数のMBeansが返される場合、これらのプロパティの値は通常異なります。このオプションを使用すると、適切なプロパティ値からプラグイン・インスタンスを構築できます。このオプションは任意であり、複数のプロパティ値からプラグイン・インスタンスを生成するために繰り返すことができます。

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ブロックの直下にある同名のオプションと同様に機能

MBeanブロック、代わりに型インスタンスを設定します

instanceFrom

いいえ

list of strings
MBeanブロックの直下にある同名のオプションと同様に機能

MBeanブロック、代わりに型インスタンスを設定します

attribute

いいえ

string
値を読み込む属性名を設定します。

は、ドットを使ってキー名と属性名を連結することで、複合型のキーにアクセスできます。例えば、」attrib0.key42 「です。table が true に設定されている場合、path は複合型を指さなければならず、そうでない場合は数値型を指さなければなりません。

attributes

いいえ

list of strings
上記の attribute 設定の複数形。

1つの MBean から複数のメトリクスを導出するために使用されます。

メトリクス 🔗

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

備考 🔗

  • To learn more about the available in Splunk Observability Cloud see メトリクスタイプ

  • In host-based subscription plans, default metrics are those metrics included in host-based subscriptions in Splunk Observability Cloud, such as host, container, or bundled metrics. Custom metrics are not provided by default and might be subject to charges. See メトリクスカテゴリ for more information.

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、その他のメトリクスの追加 で extraMetrics の設定方法を参照してください。

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

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

Splunk Observability Cloudをご利用のお客様

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

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。

This page was last updated on 2024年05月29日.