Instana エージェントの要件

Instana エージェントのインストールと使用を開始する前に、エージェントの要件を満たしていることを必ず確認してください。

Instana エージェントの種類ごとに要件が異なります。

注:Kubernetes または Red Hat OpenShift クラスタ内のリモートサービス( IBM Z HMC、 Amazon Web Services ( AWS )、 Google Cloud Platform ( GCP )、 Oracle、 Microsoft® Azure など)を監視する場合、クラスタの各ノードに Instana エージェントをインストールしないでください。 専用ホストマシンに Instana エージェントをインストールします。

ホスト・エージェント

各ホストエージェントに関するサポート情報および固有の要件については、それぞれのインストールに関するトピックに記載されています。 要件を確認するには、 「エージェントのインストール」セクションにある該当するプラットフォームのアイコンをクリックして、エージェントのインストールに関するトピックを開いてください。

これらの要件に加え、一部のホストエージェントが正常に機能するように、ネットワークとリソースの設定も行う必要があります。 詳細については、 「ネットワーク要件」、「 アウトバウンドネットワークアクセス要件」、および「 リソース要件」 を参照してください。

ネットワーク要件

ホストエージェントの一部のコンポーネントは、ホストエージェントのプロセス外で実行され、ローカルネットワークを介してホストエージェントに接続します。 エージェントとセンサーが正常に通信できるようにするには、次の表に記載されているポートを開く必要があります。

センサー ポート範囲 構成可能
エージェント API 42699
JVM トレース機能( Java®、 Kotlin、 Scala、 Clojure )および JVM [^1]上で動作する技術向けのセンサー 42699
Crystal センサー 42699 環境変数
Envoy、 NGINX、およびその他のプロキシのトレース 42699 環境変数
Go センサー 42699 環境変数
.NET センサー 42699
Node.js センサー 42699 環境変数
PHP センサー 16816 PHP 設定
Python センサー 42699 環境変数
Ruby センサー 42699 環境変数
OpenTelemetry OTLP/gRPC 4317/4318

Kubernetes 環境では、外部センサーがエージェントと通信できるように、ネットワークポリシーでエージェントポッドとサービスポッド間の接続を許可する必要があります。

[^1] Spring Boot, Dropwizard, Cassandra, Elasticsearch, Neo4j, Hazelcast, ActiveMQ, Kafka, Finagle, Tomcat, Jetty, JBoss, WebLogic, WebSphere, Glassfish, Hadoop, HBase, Solr, Spark, Jira, Liferay, Mule, Ping Directory, Jenkins.

アウトバウンド・ネットワーク・アクセス要件

エージェントをインストールおよび展開する前に、動的なエージェント更新のための外部ネットワークへのアクセスが許可されるよう、ファイアウォールとプロキシの設定が適切であることを確認してください。

  • Instana SaaS 環境で動的ホストエージェントを使用する場合は、次の表に示すようにアウトバウンドポートを設定してください

    ポート プロトコル 認証 リポジトリまたは URL
    443 HTTPS はい https://artifact-public.instana.io
  • Instana のオンライン・セルフホスト環境で動的ホストエージェントを使用する場合は、表3に示すようにアウトバウンドポートを設定してください。

  • オフライン(エアギャップ)の Instana 環境で動的ホストエージェントを使用する場合は、表3に示すようにプロキシサーバーの送信ポートを設定してください。

    ポート プロトコル 認証 リポジトリまたは URL 必須 コメント
    443 TCP はい https://artifact-public.instana.io - Standard Edition - カスタム版 - クラシック版 kubectl プラグインのリポジトリ、Classic Edition用のパッケージファイル、 Instana のバックエンドイメージ、新しいセンサー、既存センサーの更新、およびダイナミックエージェント向けのエージェント更新。

あるいは、オフライン(エアギャップ)の Instana 環境では、 Instana エージェントリポジトリのミラーを設定することで、エージェントの動的な更新を構成できます。 詳細については、 「動的エージェントの Maven リポジトリ」 を参照してください。

リソース要件

Instana エージェントに標準で提供されるリソースは、あらゆる監視シナリオに対応できる十分なものです。 モニター対象アプリケーションの数がリソース使用量に影響することはほとんどありません。 Instana のエージェントリソースは、エージェントの自己監視機能によってパフォーマンスの問題が検出された場合にのみ、 Instana のサポートチームと確認を行った上で調整してください。

Instana エージェントのデフォルトのメモリ要件は512 MBであり、ホストシステムにエージェントをインストールする場合、CPU使用量に制限はありません。 Kubernetes および Red Hat OpenShift のインストール環境において、CPU の要求値と制限値、ならびにメモリの要求値と制限値は、次のように定義されています:

resources:
  requests:
    memory: "768Mi"
    cpu: 0.5
  limits:
    memory: "768Mi"
    cpu: 1.5

ホストエージェントのCPU使用率やメモリ使用量の制限、およびそれらの拡張に関する詳細については、 「ホストエージェントのCPUおよびメモリの制限」 を参照してください。