Docs » Splunk Observability Cloud でサポートされているインテグレーション » データベースのアプリケーション・レシーバーを設定する » Cassandra

Cassandra 🔗

The Splunk Distribution of OpenTelemetry Collector uses the Smart Agent receiver with the Cassandra monitor type to monitor Cassandra.

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

メリット 🔗

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

インストール 🔗

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

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

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

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

設定 🔗

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

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

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

🔗

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

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

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

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

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

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

オプション

必須

タイプ

説明

host

はい

string

この文字列を使用して、接続先のホストを指定します。

port

はい

integer

この番号を使用して、アプリケーションのJMX接続ポート(RMI

ポートではない)を指定します。この値は、アプリケーションを実行するときにJVMに設定する必要がある com.sun.management.jmxremote.port Javaプロパティに対応しています。

name

いいえ

string

serviceName

いいえ

string

この値は、Splunk

Splunk Observability Cloud UI, which lets you retrieve built-in content for the service. For custom JMX integrations, you can set it to any value.

serviceURL

いいえ

string

この値を使用して、JMX 接続文字列を定義します。システムは

この文字列をGoテンプレートとして解釈するので、設定オプションに対応する置換可能な変数を使って値を指定することができます。注意:この文字列を直接設定するのは避けてください。代わりに hostport オプションを設定します。(デフォルト: service:jmx:rmi:///jndi/rmi://{{.Host}}:{{.Port}}/jmxrmi )

instancePrefix

いいえ

string

システムはこの値を、生成されたプラグインインスタンス名のプレフィックスとして追加

します。参照されるMBeanブロックで2つ目の instancePrefix を指定すると、Connectionブロックで指定された接頭辞がプラグインインスタンスの先頭に表示され、MBeanブロックで指定された接頭辞がそれに追加されます。

username

いいえ

string

この値を使用して、認証のためにサーバーに送信したいユーザー名を指定

します。

password

いいえ

string

この値を使用して、ユーザー名のパスワードを指定します。

customDimensions

いいえ

map of strings

このオブジェクトは、接続レベルで追加するカスタムディメンションを指定

します。

mBeansToCollect

いいえ

list of strings

この配列は、mBeanDefinitions で定義された収集したいMBeansのリストを指定します。

配列を指定しない場合、モニターは定義されたすべてのMBeansを収集します。

mBeansToOmit

いいえ

list of strings

この配列は、mBeanDefinitions で定義された収集したいMBeansのリストを指定します。

省略する mBeanDefinitions で定義されたMBeansのリスト。このリストは、デフォルトのリストから数MBeansだけを省略したい場合に使用します。

mBeanDefinitions

いいえ

map of objects (詳細は以下の表を参照)

このオブジェクトは、JMX MBean 値をメトリクスにマッピングする方法を指定します。

Cassandraにはマッピングのセットが事前にロードされています。このオプションで追加したマッピングは、事前にロードされたものとマージされます。詳細については、Collectdドキュメント を参照してください。

mBeanDefinitions 設定オプションには以下のフィールドがあります:

オプション

必須

タイプ

説明

objectName

いいえ

string

この名前は、MBeanServerからMBeanを取得するためにモニターが使用するパターンを設定

します。サーバーが複数のMBeanを返す場合、instanceFrom オプションを使用してMBean識別子を一意にします。

instancePrefix

いいえ

string

この値は生成されたプラグインインスタンスのプレフィックスとなります。

instanceFrom

いいえ

list of strings

この配列は、MBeansを識別するためにJMXが使用するオブジェクト名のリストを指定

します。これには、キーと値のペアであるプロパティを含みします。与えられたオブジェクト名が一意でなく、サーバーが複数のMBeansを返す場合、これらのプロパティの値は通常異なります。instanceFrom オプションを使用して、適切なプロパティ値からプラグイン・インスタンスを構築します。このオプションには複数の値を設定できるので、複数のプロパティ値からプラグイン・インスタンスを生成できます。

values

いいえ

list of objects (詳細は以下の表を参照)

この配列は、

values オプションでブロックに対応するオブジェクトのリストを指定します。各ブロックはMBeanの属性を collectd の値リストにマッピングします。各MBeanに対して少なくとも1つの value オブジェクトを指定する必要があります。

dimensions

いいえ

list of strings

values 設定オプションには以下のフィールドがあります:

オプション

必須

タイプ

説明

type

いいえ

string

この値を使用して、collectd 内で使用するデータセットを設定して

MBean属性の値を処理します

table

いいえ

bool

このフラグを true に設定します(返された属性が

複合型である場合)。これを true に設定すると、サーバーは複合型内のキーを型インスタンスに追加します。(デフォルト: false )

instancePrefix

いいえ

string

instancePrefix の説明を

mBeanDefinitions の定義で参照してください。.このオプションも似ていますが、代わりに型インスタンスを設定します。

instanceFrom

いいえ

list of strings

instancePrefix の説明を

mBeanDefinitions の定義で参照してください。.このオプションも似ていますが、代わりに型インスタンスを設定します。

attribute

いいえ

string

この値を使用して、

値を読み取る属性名を設定します。ドットを使って属性名にキー名を連結すると、複合型のキーにアクセスできます。例えば、attrib0.key42attrib0 オブジェクトの key42 属性を指定します。table オプションを true に設定した場合、パスは複合型を指す必要があり、そうでない場合は数値型を指す必要があります。

attributes

いいえ

list of strings

単一の 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年09月18日.