概要

Oracle WebLogic は、オンプレミスおよびクラウドの両方で、エンタープライズ Java アプリケーションを開発、実行、導入するためのプラットフォームです。Web サーバー機能、メッセージングなどのビジネスコンポーネント、データベースなどのバックエンドエンタープライズシステムへのアクセスなどのアプリケーションサービスを一元管理します。

Datadog による Oracle WebLogic のモニタリングでは、以下のことが可能です。

• Java 仮想マシン (JVM) のヒープサイズの増大を意識する
• サーバーの応答時間を追跡する
• Web アプリケーションのセッションの詳細を監視する
• スレッドプールとメッセージングサービスを追跡する
• データベース接続プールの使用量を追跡する

セットアップ

インストール

WebLogic チェックは Datadog Agent パッケージに含まれています。 サーバーに追加でインストールする必要はありません。

1. このチェックは JMX ベースで、JVM によりエキスポートされた プラットフォーム MBean サーバーからメトリクスを収集するため、WebLogic サーバーで JMX リモートモニタリングが有効になっている必要があります。インストール手順については、リモートモニタリングおよび管理を参照してください。

2. システムプロパティ -Djavax.management.builder.initial=weblogic.management.jmx.mbeanserver.WLSMBeanServerBuilder を設定し、これらのメトリクスをプラットフォーム MBean サーバーで有効にします。これは、WebLogic サーバー管理コンソールとサーバー起動スクリプトの両方で有効にする必要があります。注: これは複数回行うことが可能であり、また複数回行うべきです。

   管理コンソールで有効化

   Domain => Configuration => General => Advanced => Platform MBean Server Enabled
   

   サーバー起動スクリプトで有効化

   -Djavax.management.builder.initial=weblogic.management.jmx.mbeanserver.WLSMBeanServerBuilder
   

   詳細については、WebLogic のドキュメントを参照してください。

3. WebLogic サーバー管理コンソールで PlatformMBeanServerUsed 属性の値が true に設定されていることを確認します。WebLogic サーバーのバージョン 10.3.3.0 以上で、デフォルト値は true です。この設定は、WebLogic サーバー管理コンソールにあります。または、WebLogic Scripting Tool (WSLT) を使用して構成できます。

   管理コンソールで有効化

   Domain (<WEBLOGIC_SERVER>) => Configuration => General => (Advanced) => Platform MBeanServer Enabled
   

   WLST で有効化

   編集セッションを開始します。ドメインの JMX ディレクトリに移動し、false に設定されている場合は cmo.setPlatformMBeanServerUsed(true) を使用して有効にします。

   例:

   # > java weblogic.WLST
   (wlst) > connect('weblogic','weblogic')
   (wlst) > edit()
   (wlst) > startEdit()
   (wlst) > cd('JMX/<DOMAIN_NAME>')
   (wlst) > set('EditMBeanServerEnabled','true')
   (wlst) > activate()
   (wlst) > exit()
   

   変更をアクティブにして、WebLogic サーバーを再起動します。

構成

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

   このチェックは、1 インスタンスあたり 350 メトリクスの制限があります。返されたメトリクスの数は、Datadog Agent の status コマンドを実行したときに表示されます。 構成を編集することで、関心があるメトリクスを指定できます。

   収集するメトリクスをカスタマイズする方法については、JMX チェックのドキュメントで詳細な手順を参照してください。 制限以上のメトリクスを監視する必要がある場合は、Datadog のサポートチームまでお問い合わせください。

2. Agent を再起動します

検証

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

収集データ

メトリクス

ログ収集

1. WebLogic ロギングサービスは、Java ロギング API に基づく実装をデフォルトで使用します。別のフォーマットを使用する場合は、インテグレーションパイプラインのクローンを作成し編集します。

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

   logs_enabled: true
   

3. weblogic.d/conf.yaml ファイルのコメントを解除して、ログコンフィギュレーションブロックを編集します。環境に基づいて、パスおよびサービスのパラメーターの値を変更してください。使用可能なすべてのコンフィギュレーションオプションの詳細については、weblogic.d/conf.yaml のサンプルを参照してください。

    - type: file
      path: <DOMAIN_DIR>/servers/<ADMIN_SERVER_NAME>/logs/<ADMIN_SERVER_NAME>.log
      source: weblogic
      service: admin-server
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: (\####)?<\w{3} (0?[1-9]|[12][0-9]|3[01]), \d{4}
    - type: file
      path: <DOMAIN_DIR>/servers/<ADMIN_SERVER_NAME>/logs/<DOMAIN_NAME>.log
      source: weblogic
      service: domain
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: (\####)?<\w{3} (0?[1-9]|[12][0-9]|3[01]), \d{4}
    - type: file
      path: <DOMAIN_DIR>/servers/<SERVER_NAME>/logs/<SERVER_NAME>.log
      source: weblogic
      service: managed-server
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: (\####)?<\w{3} (0?[1-9]|[12][0-9]|3[01]), \d{4}
    - type: file
      path: <DOMAIN_DIR>/servers/*/logs/access.log 
      source: weblogic
      service: http-access
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: .*\[\d{2}\/(\w{3}|\w{4})\/\d{4}:\d{2}:\d{2}:\d{2} (\+|-)\d{4}\]
   

4. Agent を再起動します

コンテナ化

コンテナ環境の場合は、JMX を使用したオートディスカバリーのガイドを参照してください。

イベント

WebLogic インテグレーションには、イベントは含まれません。

サービスチェック

weblogic.can_connect
Returns OK if the Agent is able to connect to and collect metrics from the monitored WebLogic instance, WARNING if no metrics are collected, and OK otherwise.
Statuses: ok, critical, warning

トラブルシューティング

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