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構成に以下を追加します：

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

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

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 送受信したバイト数。 bytesLongCounterCallback
tomcat.threads スレッド数。 threads LongValueCallback
tomcat.max_time要求を処理する最大時間。 millisecondslongValueCallback
tomcat.request_count 合計要求数。 要求 LongCounterCallback

備考

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

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

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

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

トラブルシューティング

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

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______