Virtualization

仮想化・ハイパーバイザー

XenServer (Citrix Hypervisor)

📚 公式ドキュメント: XenServer (Citrix Hypervisor)

com.instana.plugin.xenserver:
  enabled: true
  url: 'https://xenserver.example.com'  # http または https
  user: 'root'
  password: 'xen_password'
  poll_rate: 30  # 秒単位

取得方法: - URL: XenServer管理インターフェースのURL - 認証情報: XenServer管理者アカウント

PowerHMC

📚 公式ドキュメント: PowerHMC

com.instana.plugin.powerhmc:
  remote:
    - host: 'hmc-server.example.com'
      port: '12443'  # デフォルトポート
      user: 'hscroot'
      password: 'hmc_password'
      poll_rate: 60  # 秒単位
      availabilityZone: 'Power Systems HMC'

PowerVC

📚 公式ドキュメント: PowerVC

com.instana.plugin.powervc:
  remote:
    - host: 'powervc.example.com'
      port: '5000'  # Keystoneポート
      user: 'admin'
      password: 'powervc_password'
      poll_rate: 60
      availabilityZone: 'PowerVC Cluster'

IBM OpenStack

📚 公式ドキュメント: IBM OpenStack

com.instana.plugin.ibmopenstack:
  enabled: true
  remote:
    - host: 'openstack.example.com'
      port: '5000'
      user: 'admin'
      password: 'openstack_password'
      poll_rate: 60

RabbitMQ

📚 公式ドキュメント: RabbitMQ

com.instana.plugin.rabbitmq:
  user: 'guest'
  password: 'guest'
  queuesRegex: '.*'
  monitorQueues:
    - queue: 'orders'
      vhost: '/'
  poll_rate: 5

設定項目の説明: - user: RabbitMQ管理APIユーザー名（デフォルト: guest） - password: 管理APIパスワード - queuesRegex: 監視対象キューの正規表現パターン（デフォルト: '.*' = 全て） - monitorQueues: 個別に監視するキューのリスト - queue: キュー名 - vhost: 仮想ホスト名（デフォルト: /） - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 5秒）

監視ユーザーの作成:

# RabbitMQで実行
rabbitmqctl add_user monitoring_user monitoring_password
rabbitmqctl set_user_tags monitoring_user monitoring
rabbitmqctl set_permissions -p / monitoring_user ".*" ".*" ".*"

Management Plugin有効化:

1 2	`# Management Pluginを有効化（必須） rabbitmq-plugins enable rabbitmq_management`

複数仮想ホストの監視:

com.instana.plugin.rabbitmq:
  user: 'monitoring_user'
  password: 'monitoring_password'
  queuesRegex: '.*'
  monitorQueues:
    - queue: 'orders'
      vhost: '/production'
    - queue: 'payments'
      vhost: '/production'
    - queue: 'test-queue'
      vhost: '/staging'
  poll_rate: 5

特定キューのみ監視:

com.instana.plugin.rabbitmq:
  user: 'monitoring_user'
  password: 'monitoring_password'
  queuesRegex: '^(orders|payments|notifications)$'  # 特定キューのみ
  poll_rate: 5

SSL/TLS接続:

com.instana.plugin.rabbitmq:
  user: 'monitoring_user'
  password: 'monitoring_password'
  url: 'https://rabbitmq.example.com:15671'  # HTTPS Management API
  queuesRegex: '.*'
  ssl:
    verify: true
    ca_cert: '/path/to/ca.crt'
  poll_rate: 5

取得方法: - user/password: RabbitMQ管理画面（http://localhost:15672）から作成、またはrabbitmqctlコマンドで作成 - vhost: RabbitMQ管理画面の「Virtual Hosts」タブで確認 - Management API URL: デフォルトはhttp://localhost:15672/api

IBM MQ

📚 公式ドキュメント: IBM MQ

com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QM1:
      host: 'mq-server.example.com'
      port: '1414'
      channel: 'SYSTEM.DEF.SVRCONN'
      username: 'mquser'
      password: 'mqpassword'
      queuesIncludeRegex: '.*'
      queuesExcludeRegex: '^SYSTEM\..*'

設定項目の説明: - enabled: IBM MQセンサーの有効化（デフォルト: true） - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 60秒） - queueManagers: キューマネージャーの設定（複数設定可能） - キー（QM1など）: キューマネージャー名 - host: MQサーバーのホスト名またはIPアドレス - port: MQリスナーポート（デフォルト: 1414） - channel: サーバー接続チャネル名 - username: MQ接続ユーザー名 - password: MQ接続パスワード - queuesIncludeRegex: 監視対象キューの正規表現（デフォルト: '.*'） - queuesExcludeRegex: 除外するキューの正規表現

監視ユーザーの作成:

# MQサーバーで実行（runmqsc コマンド）
runmqsc QM1

# ユーザーの作成と権限付与
DEFINE CHANNEL(INSTANA.SVRCONN) CHLTYPE(SVRCONN) TRPTYPE(TCP)
SET CHLAUTH(INSTANA.SVRCONN) TYPE(BLOCKUSER) USERLIST('nobody')
SET CHLAUTH(INSTANA.SVRCONN) TYPE(ADDRESSMAP) ADDRESS('*') USERSRC(CHANNEL) CHCKCLNT(REQUIRED)

# 監視ユーザーに権限を付与
SET AUTHREC OBJTYPE(QMGR) PRINCIPAL('mquser') AUTHADD(CONNECT,INQ,DSP)
SET AUTHREC PROFILE('SYSTEM.**') OBJTYPE(QUEUE) PRINCIPAL('mquser') AUTHADD(DSP,INQ,BROWSE)
SET AUTHREC PROFILE('**') OBJTYPE(QUEUE) PRINCIPAL('mquser') AUTHADD(DSP,INQ,BROWSE)

複数キューマネージャーの監視:

com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QM_PROD:
      host: 'mq-prod.example.com'
      port: '1414'
      channel: 'INSTANA.SVRCONN'
      username: 'monitoring'
      password: 'prod_password'
      queuesIncludeRegex: '^(APP|ORDER|PAYMENT)\..*'
      queuesExcludeRegex: '^SYSTEM\..*'
    QM_TEST:
      host: 'mq-test.example.com'
      port: '1414'
      channel: 'INSTANA.SVRCONN'
      username: 'monitoring'
      password: 'test_password'
      queuesIncludeRegex: '.*'

SSL/TLS接続:

com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QM1:
      host: 'mq-server.example.com'
      port: '1414'
      channel: 'INSTANA.SSL.SVRCONN'
      username: 'mquser'
      password: 'mqpassword'
      sslCipherSuite: 'TLS_RSA_WITH_AES_256_CBC_SHA256'
      sslKeyStore: '/path/to/keystore.jks'
      sslKeyStorePassword: 'keystore_password'
      queuesIncludeRegex: '.*'

取得方法: - キューマネージャー名: dspmq コマンドで確認 - channel: DISPLAY CHANNEL(*) コマンドで確認、またはSYSTEM.DEF.SVRCONNを使用 - port: MQリスナー設定で確認（デフォルト: 1414） - username/password: MQ管理者から取得、または新規作成

ActiveMQ

📚 公式ドキュメント: ActiveMQ

com.instana.plugin.activemq:
  poll_rate: 1
  monitorQueues:
    - 'orders'
    - 'DLQ'
  monitorTopics:
    - 'notifications'

設定項目の説明: - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 1秒） - monitorQueues: 監視対象キューのリスト - monitorTopics: 監視対象トピックのリスト

JMX接続設定:

com.instana.plugin.activemq:
  poll_rate: 1
  jmx:
    host: 'localhost'
    port: 1099
    username: 'admin'
    password: 'admin'
  monitorQueues:
    - 'orders'
    - 'payments'
    - 'DLQ'
  monitorTopics:
    - 'notifications'
    - 'events'

正規表現でキュー/トピックを指定:

com.instana.plugin.activemq:
  poll_rate: 1
  queuesRegex: '^(orders|payments)\..*'  # ordersまたはpaymentsで始まるキュー
  topicsRegex: '^events\..*'  # eventsで始まるトピック

取得方法: - JMXポート: ActiveMQ設定ファイル（activemq.xml）で確認（デフォルト: 1099） - キュー/トピック名: ActiveMQ Web Console（http://localhost:8161/admin）で確認

Apache RocketMQ

📚 公式ドキュメント: Apache RocketMQ

com.instana.plugin.rocketmq:
  enabled: true
  poll_rate: 60
  nameServerClusters:
    - namesrvAddr: '192.168.1.100:9876'
      availabilityZone: 'RocketMQ Production'
      enableACL: true
      accessKey: 'rocketmq_access_key'
      secretKey: 'rocketmq_secret_key'

設定項目の説明: - enabled: RocketMQセンサーの有効化（デフォルト: true） - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 60秒） - nameServerClusters: NameServerクラスターの設定リスト - namesrvAddr: NameServerのアドレス（host:port形式） - availabilityZone: 可用性ゾーン名（識別用） - enableACL: ACL（アクセス制御リスト）の有効化 - accessKey: ACL認証用アクセスキー - secretKey: ACL認証用シークレットキー

ACL無効の場合:

com.instana.plugin.rocketmq:
  enabled: true
  poll_rate: 60
  nameServerClusters:
    - namesrvAddr: '192.168.1.100:9876'
      availabilityZone: 'RocketMQ Production'
      enableACL: false

複数NameServerクラスターの監視:

com.instana.plugin.rocketmq:
  enabled: true
  poll_rate: 60
  nameServerClusters:
    - namesrvAddr: '192.168.1.100:9876;192.168.1.101:9876'
      availabilityZone: 'RocketMQ Production Cluster'
      enableACL: true
      accessKey: 'prod_access_key'
      secretKey: 'prod_secret_key'
    - namesrvAddr: '192.168.2.100:9876'
      availabilityZone: 'RocketMQ Staging'
      enableACL: false

ACL設定の作成:

# RocketMQサーバーで実行
# plain_acl.yml ファイルを編集
accounts:
  - accessKey: rocketmq_access_key
    secretKey: rocketmq_secret_key
    whiteRemoteAddress:
    admin: false
    defaultTopicPerm: PUB|SUB
    defaultGroupPerm: PUB|SUB
    topicPerms:
      - topicA=PUB|SUB
      - topicB=PUB|SUB
    groupPerms:
      - groupA=PUB|SUB

取得方法: - namesrvAddr: RocketMQ管理者から取得、またはbroker.confで確認 - accessKey/secretKey: plain_acl.ymlファイルで確認、または新規作成 - ポート番号: デフォルトNameServerポートは9876

Apache Tomcat

📚 公式ドキュメント: Apache Tomcat

1 2	`com.instana.plugin.tomcat: poll_rate: 1`

設定項目の説明: - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 1秒）

JMX接続設定:

com.instana.plugin.tomcat:
  poll_rate: 1
  jmx:
    host: 'localhost'
    port: 9090
    username: 'tomcat_jmx_user'
    password: 'jmx_password'

Tomcat JMX設定:

# catalina.sh または setenv.sh に追加
CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote"
CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.port=9090"
CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.ssl=false"
CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.authenticate=false"

# 認証を有効にする場合
CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.authenticate=true"
CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.password.file=/path/to/jmxremote.password"
CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.access.file=/path/to/jmxremote.access"

複数Tomcatインスタンスの監視:

com.instana.plugin.tomcat:
  instances:
    - name: 'tomcat-app1'
      jmx:
        port: 9090
      poll_rate: 1
    - name: 'tomcat-app2'
      jmx:
        port: 9091
      poll_rate: 1

取得方法: - JMXポート: catalina.shまたはsetenv.shで設定した値 - 自動検出が有効な場合、設定不要（Instana Agentが自動的に検出）

Splunk Observability (SignalFx)

📚 公式ドキュメント: Splunk Observability (SignalFx)

com.instana.plugin.splunk:
  enabled: true
  endpoint: 'https://api.us1.signalfx.com'
  api_token: '[Splunk-API-Token]'
  poll_rate: 30  # 秒単位

取得方法: - endpoint: Splunkリージョンに応じたAPI URL - api_token: Splunk Observability設定から生成

SolarWinds

📚 公式ドキュメント: SolarWinds

com.instana.plugin.solarwinds:
  enabled: true
  endpoint: 'https://solarwinds.example.com:17774'
  username: 'admin'
  password: 'solarwinds_password'
  poll_rate: 30

Nagios

📚 公式ドキュメント: Nagios

com.instana.plugin.nagios:
  enabled: true
  endpoint: 'https://nagios.example.com/nagios'
  key: '[Nagios-API-Key]'
  poll_rate: 60  # 秒単位

Nagios統合（テクニカルプレビュー）: - レガシー監視システム統合 - サービスステータス - ホストチェック結果

Zabbix

📚 公式ドキュメント: Zabbix

com.instana.plugin.zabbix:
  enabled: true
  endpoint: 'http://zabbix.example.com/zabbix/api_jsonrpc.php'
  token: '[Zabbix-API-Token]'
  poll_rate: 30  # 秒単位

取得方法: - endpoint: Zabbix API エンドポイント - token: Zabbix管理画面から生成（User settings → API tokens）

Microsoft SCOM

📚 公式ドキュメント: Microsoft SCOM

com.instana.plugin.scom:
  enabled: true
  pollRate: 30  # 秒単位
  endpoint: 'http://scom-server.example.com/OperationsManager'
  username: 'domain\\admin'
  password: 'scom_password'
  kerberos_realm: 'EXAMPLE.COM'  # Kerberosレルム名
  kdc: 'kdc.example.com'  # Kerberos KDCホスト名

設定のポイント: - username: ドメイン\ユーザー形式 - Kerberos設定が必要な場合あり

Turbonomic

📚 公式ドキュメント: Turbonomic

com.instana.plugin.turbonomic:
  enabled: true
  host: 'turbonomic.example.com'
  target: 'Instana-Target-Name'  # Turbonomic内のターゲット名
  auth:
    username: 'admin'
    password: 'turbo_password'

取得方法: - target: Turbonomic管理画面で設定したInstanaターゲット名 - 認証情報: Turbonomic管理者権限が必要

Argo CD

📚 公式ドキュメント: Argo CD

com.instana.plugin.argocd:
  enabled: true
  poll_rate: 10  # 秒単位（デフォルト5秒）
  url: 'https://argocd.example.com'
  username: 'admin'
  password: 'argocd_password'
  clusters:
    - 'production-cluster'
    - 'staging-cluster'

JBoss/WildFly

📚 公式ドキュメント: JBoss/WildFly

com.instana.plugin.jbossas:
  monitor-ejb-deployments: true
  monitor-web-deployments-regex: 'webapp.*'
  poll_rate: 1

設定項目の説明: - monitor-ejb-deployments: EJBデプロイメントの監視を有効化（デフォルト: true） - monitor-web-deployments-regex: 監視対象Webアプリケーションの正規表現パターン - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 1秒）

詳細設定:

com.instana.plugin.jbossas:
  monitor-ejb-deployments: true
  monitor-web-deployments-regex: '^(myapp|webapp).*'  # 特定アプリのみ
  jmx:
    host: 'localhost'
    port: 9990
    username: 'admin'
    password: 'admin'
  poll_rate: 1

取得方法: - JMXポート: standalone.xmlまたはdomain.xmlで確認（デフォルト: 9990） - 認証情報: add-user.shスクリプトで作成

IBM WebSphere Application Server

📚 公式ドキュメント: IBM WebSphere Application Server

1
2
3

com.instana.plugin.websphere:
  enable_pmi: true
  poll_rate: 5

設定項目の説明: - enable_pmi: PMI（Performance Monitoring Infrastructure）の有効化（デフォルト: true） - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 5秒）

詳細設定:

com.instana.plugin.websphere:
  enable_pmi: true
  poll_rate: 5
  soap:
    host: 'localhost'
    port: 8880
    username: 'wasadmin'
    password: 'waspassword'
  cells:
    - 'Cell01'

PMI設定の確認: - WebSphere管理コンソール → Monitoring and Tuning → Performance Monitoring Infrastructure (PMI) - PMIレベルを「Basic」以上に設定

取得方法: - SOAPポート: WebSphere管理コンソールで確認（デフォルト: 8880） - 認証情報: WebSphere管理者アカウント

IBM WebSphere Liberty

📚 公式ドキュメント: IBM WebSphere Liberty

1 2	`com.instana.plugin.websphereliberty: poll_rate: 1`

設定項目の説明: - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 1秒）

Liberty監視の前提条件:

<!-- server.xml に以下のfeatureを追加 -->
<featureManager>
    <feature>monitor-1.0</feature>
    <feature>mpMetrics-2.3</feature>
</featureManager>

<!-- HTTPエンドポイントの設定 -->
<httpEndpoint id="defaultHttpEndpoint"
              host="*"
              httpPort="9080"
              httpsPort="9443" />

詳細設定:

com.instana.plugin.websphereliberty:
  poll_rate: 1
  rest:
    host: 'localhost'
    port: 9443
    username: 'admin'
    password: 'liberty_password'
    ssl: true

取得方法: - ポート: server.xmlのhttpEndpoint設定で確認 - 認証情報: Liberty管理者アカウント

Apache HTTP Server

📚 公式ドキュメント: Apache HTTP Server

com.instana.plugin.httpd:
  user: 'admin'
  password: 'httpd_password'
  tracing:
    enabled: true
    autoRestart: false

設定項目の説明: - user: server-statusページへのBasic認証ユーザー名 - password: Basic認証パスワード - tracing: トレーシング設定 - enabled: トレーシングの有効化 - autoRestart: 設定変更時の自動再起動（デフォルト: false）

Apache設定の前提条件:

# httpd.conf または status.conf
LoadModule status_module modules/mod_status.so

<Location "/server-status">
    SetHandler server-status
    Require ip 127.0.0.1
    # Basic認証を使用する場合
    AuthType Basic
    AuthName "Server Status"
    AuthUserFile /etc/apache2/.htpasswd
    Require valid-user
</Location>

# 拡張ステータスを有効化
ExtendedStatus On

認証なしの場合:

com.instana.plugin.httpd:
  tracing:
    enabled: true
    autoRestart: false

取得方法: - user/password: .htpasswdファイルで管理、htpasswdコマンドで作成 - server-status URL: デフォルトはhttp://localhost/server-status

Nginx

📚 公式ドキュメント: Nginx

1 2	`com.instana.plugin.nginx: poll_rate: 30`

設定項目の説明: - poll_rate: メトリクス収集間隔（秒単位、デフォルト: 30秒）

Nginx設定の前提条件:

# nginx.conf
http {
    server {
        listen 80;

        # stub_statusモジュールを有効化
        location /nginx_status {
            stub_status on;
            access_log off;
            allow 127.0.0.1;
            deny all;
        }
    }
}

詳細設定:

com.instana.plugin.nginx:
  poll_rate: 30
  status_url: 'http://localhost/nginx_status'
  # 複数Nginxインスタンス
  instances:
    - name: 'nginx-frontend'
      status_url: 'http://localhost:8080/nginx_status'
      poll_rate: 10
    - name: 'nginx-backend'
      status_url: 'http://localhost:8081/nginx_status'
      poll_rate: 30

Nginx Plus（商用版）の場合:

com.instana.plugin.nginx:
  poll_rate: 30
  plus: true
  api_url: 'http://localhost:8080/api'

取得方法: - status_url: nginx.confのlocation設定で確認 - stub_statusモジュールが有効か確認: nginx -V 2>&1 | grep -o with-http_stub_status_module

IBM ACE

📚 公式ドキュメント: IBM ACE

com.instana.plugin.ace:
  enabled: true
  poll_rate: 60
  messageFlow:
    limit: 20
    sortByMetric: 'MaximumElapsedTime'
  NodesOrServers:
    BK1:
      restApiPort: '4414'
      aceUsername: 'viewer'
      acePassword: 'viewerPassword'
      mqport: '11883'

IBM MQ Managed File Transfer

📚 公式ドキュメント: IBM MQ Managed File Transfer

com.instana.plugin.ibmmqmft:
  enabled: true
  poll_rate: 10
  instances:
    QM1-hostname:
      transfer_expired_interval: 10
      coordinationQueueManager:
        name: 'QM1'
        host: 'mq-server.example.com'
        port: 1414