Apache Tomcat（非推奨）

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

注意: このインテグレーションは、非推奨です。Splunk Distribution of the OpenTelemetry Collector を使用していて、Tomcat をモニターする場合は、代わりに JMX レシーバーを使用することをお勧めします。
Splunk Distribution of OpenTelemetry Collector は、Collectd Tomcat モニタータイプの Smart Agent レシーバーを使用して Tomcat をモニターします。Tomcat をリモートでモニターするには、JMX Remote をアクティブにする必要があります。詳細については、「GenericJMX」を参照してください。

このインテグレーションは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/tomcat:
    type: collectd/tomcat
    ...  # Additional config

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

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

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

次の表は、このインテグレーションの設定オプションを示したものです：

オプション

必須

タイプ

説明

host

〇

string

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

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

port

はい

integer

 JMX 接続ポート。これは、アプリケーションのリモート

メソッド呼び出し（RMI）ポートとは異なります。これは、アプリケーションの実行時に JVM に設定される com.sun.management.jmxremote.port Java プロパティに対応します。

name

いいえ

string

serviceName

いいえ

string

 これは、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の

リスト。指定しない場合、定義されたすべての MBean が収集されます。

mBeansToOmit

いいえ

list of strings

 省略する MBean のリスト。これは、わずかな数の

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

mBeanDefinitions

いいえ

map of objects (下記参照）

 JMX MBean の値をメトリクスにマッピングする方法を指定します。hosts.txt ファイルを

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

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

オプション

必須

タイプ

説明

objectName

いいえ

string

 MBeanServerからMBeansを取得するために使われるパターンを設定

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

instancePrefix

いいえ

string

生成されたプラグイン・インスタンスにプレフィックスをつけます。

instanceFrom

いいえ

list of strings

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

基本的にキーと値のペアである、いわゆる「プロパティ」が含まれます。指定されたオブジェクト名が一意でなく、複数の MBean が返される場合、通常はそれらのプロパティの値が異なっています。このオプションを使用して、適切なプロパティ値からプラグインインスタンスを構築します。これはオプションであり、複数のプロパティ値からプラグインインスタンスを生成するために繰り返すことができます。

values

いいえ

list of objects (下記参照）

 value ブロックは、MBean の1つ以上の属性を

collectd の値リストにマッピングします。各 MBean ブロック内に少なくとも 1 つの value ブロックが存在する必要があります。

dimensions

いいえ

list of strings

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

オプション

必須

タイプ

説明

type

いいえ

string

 値を扱うために collectd 内で使用されるデータセットを設定します。

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 設定の複数形。Used

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

メトリクス

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

Name 説明 ユニット（Units） インストルメントタイプ
tomcat.sessions アクティブなセッションの数。 セッション DoubleValueCallback
tomcat.errors 発生したエラーの数。 errors LongCounterCallback
tomcat.processing_time 合計処理時間。 milliseconds LongCounterCallback
tomcat.traffic 送受信したバイト数。 bytes LongCounterCallback
tomcat.threads スレッド数。 threads LongValueCallback
tomcat.max_time 要求を処理する最大時間。 milliseconds longValueCallback
tomcat.request_count 合計要求数。 要求 LongCounterCallback

備考

  • 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.