Instana エージェントの要件
Instana エージェントのインストールと使用を開始する前に、エージェントの要件を満たしていることを必ず確認してください。
Instana エージェントの種類ごとに要件が異なります。
- サーバーレスエージェントの要件については、 「サーバーレスエージェント」 を参照してください。
- Webおよびモバイルエージェントの要件については、 「Webおよびモバイルエージェント」 を参照してください。
- ホストエージェントの要件については、 「ホストエージェント」 を参照してください。
サーバーレス・エージェント
以下のリストからエージェントを選択して、その要件を確認してください:
Webおよびモバイルエージェント
以下のリストからエージェントを選択して、その要件を確認してください:
モバイル・エージェント:
ホスト・エージェント
各ホストエージェントに関するサポート情報および固有の要件については、それぞれのインストールに関するトピックに記載されています。 要件を確認するには、 「エージェントのインストール」セクションにある該当するプラットフォームのアイコンをクリックして、エージェントのインストールに関するトピックを開いてください。
これらの要件に加え、一部のホストエージェントが正常に機能するように、ネットワークとリソースの設定も行う必要があります。 詳細については、 「ネットワーク要件」、「 アウトバウンドネットワークアクセス要件」、および「 リソース要件」 を参照してください。
ネットワーク要件
ホストエージェントの一部のコンポーネントは、ホストエージェントのプロセス外で実行され、ローカルネットワークを介してホストエージェントに接続します。 エージェントとセンサーが正常に通信できるようにするには、次の表に記載されているポートを開く必要があります。
| センサー | ポート範囲 | 構成可能 |
|---|---|---|
| エージェント 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.ioInstana のオンライン・セルフホスト環境で動的ホストエージェントを使用する場合は、表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およびメモリの制限」 を参照してください。