IBM WAS

Supported OS Linux Windows Mac OS

インテグレーションバージョン5.1.0

概要

このチェックは、Datadog Agent を通じて IBM Websphere Application Server (WAS) を監視します。このチェックは IBM WAS バージョン >= 8.5.5 をサポートします。

セットアップ

ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。

IBM WAS Datadog インテグレーションは、有効になっている PMI カウンターを WebSphere Application Server 環境から収集します。セットアップでは PerfServlet を有効にする必要があります。PerfServlet は、Datadog が WAS からパフォーマンスデータを取得する方法を提供します。

このチェックはデフォルトで、JDBC、JVM、スレッドプール、および Servlet Session Manager のメトリクスを収集します。オプションで追加のメトリクスを指定して、“custom_queries” セクションに収集することができます。例については、サンプルチェック構成を参照してください。

インストール

IBM WAS チェックは Datadog Agent パッケージに含まれています。

PerfServlet の有効化

サーブレットの .ear ファイル (PerfServletApp.ear) は、<WAS_HOME>/installableApps ディレクトリにあります。ここで、<WAS_HOME> は WebSphere Application Server のインストールパスです。

パフォーマンスサーブレットは、他のサーブレットとまったく同様にデプロイされます。ドメイン内の単一のアプリケーションサーバーインスタンスに、サーブレットをデプロイします。

注: バージョン 6.1 から PerfServlet を動作させるには、アプリケーションセキュリティを有効にする必要があります。

モニターされている統計セットの変更

デフォルトでは、アプリケーションサーバーは “基本” 監視用に構成されています。JVM、JDBC 接続、およびサーブレット接続を可視化するには、モニターされているアプリケーションサーバーの統計セットを “基本” から “すべて” に変更します。

この設定は、Websphere 管理コンソールの Application servers > <YOUR_APP_SERVER> > Performance Monitoring Infrastructure (PMI) にあります。

この変更を行ったら、“適用” をクリックしてコンフィギュレーションを保存し、アプリケーションサーバーを再起動します。この変更を行ってからしばらくすると、追加した JDBC、JVM、およびサーブレットのメトリクスが Datadog に表示されます。

構成

    ホスト

    ホストで実行中の Agent に対してこのチェックを構成するには

    メトリクスの収集

    1. IBM WAS のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの ibm_was.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル ibm_was.d/conf.yaml を参照してください。

    2. Agent を再起動します。

    ログ収集

    Agent バージョン 6.0 以降で利用可能

    1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

      logs_enabled: true

    2. 次に、下部にある logs 行のコメントを解除して、ibm_was.d/conf.yaml を編集します。ログの path を WAS ログファイルの正しいパスで更新してください。

      logs:
  - type: file
    path: /opt/IBM/WebSphere/AppServer/profiles/InfoSphere/logs/server1/*.log
    source: ibm_was
    service: websphere

    3. Agent を再起動します。

    コンテナ化

    コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。

    メトリクスの収集
    パラメーター値
    <INTEGRATION_NAME>ibm_was
    <INIT_CONFIG>空白または {}
    <INSTANCE_CONFIG>{"servlet_url": "http://%%host%%:%%port%%/wasPerfTool/servlet/perfservlet"}
    ログ収集

    Agent バージョン 6.0 以降で利用可能

    Datadog Agent で、ログの収集はデフォルトで無効になっています。有効にする方法については、Kubernetes ログ収集を参照してください。

    パラメーター値
    <LOG_CONFIG>{"source": "ibm_was", "service": "<SERVICE_NAME>"}

    検証

    Agent の status サブコマンドを実行し、Checks セクションの ibm_was を探します。

    収集データ

    メトリクス

    イベント

    IBM WAS には、イベントは含まれません。

    サービスチェック

    トラブルシューティング

    ご不明な点は、Datadog のサポートチームまでお問合せください。

    PREVIEWING: may/embedded-workflows