Cassandra

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

Splunk Distribution of OpenTelemetry Collectorは、Smart AgentレシーバーをCassandraモニタータイプで使用して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構成に以下を追加します：

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

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

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

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

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

オプション

必須

タイプ

説明

host

〇

string

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

port

はい

integer

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

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

name

いいえ

string

serviceName

いいえ

string

 この値は、Splunk

Observability Cloud UI にサービスタイプとして表示され、サービスの組み込みコンテンツを取得できます。カスタム JMX インテグレーションの場合は、任意の値に設定できます。

serviceURL

いいえ

string

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

はこの文字列を Go テンプレートとして解釈するので、設定オプションに対応する置換可能な変数を使って値を指定することができます。注：この文字列を直接設定しないでください。代わりに、host および port オプションを設定してください。（デフォルト：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のリストを指定します。

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

mBeansToOmit

いいえ

list of strings

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

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

mBeanDefinitions

いいえ

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

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

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

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

オプション

必須

タイプ

説明

objectName

いいえ

string

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

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

instancePrefix

いいえ

string

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

instanceFrom

いいえ

list of strings

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

MBean を識別します（キーと値のペアであるプロパティを含む）。指定されたオブジェクト名が一意でなく、サーバーが複数の MBean を返す場合、通常はこれらのプロパティの値が異なります。instanceFrom オプションを使用して、適切なプロパティ値からプラグインインスタンスをビルドします。設定ではこのオプションに複数の値を指定できるため、複数のプロパティ値からプラグインインスタンスを生成できます。

values

いいえ

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

 この配列は、

values オプションのブロックに対応したオブジェクトのリストを指定します。各ブロックは、collectd の値リストに MBean の属性をマッピングします。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.key42 は、attrib0 オブジェクトの key42 属性を指定します。table オプションを true に設定する場合、パスは複合タイプを指している必要があります。それ以外の場合は、数値タイプを指す必要があります。

attributes

いいえ

list of strings

単一の MBean から複数のメトリクスを導出するには、このオプションを使用します。

メトリクス

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

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

備考

  • Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。

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

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

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

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.