Mac OS でのホスト・エージェントのインストール
Instana エージェントは、通常の Java プロセスをベースにしています。 サポートされるすべてのオペレーティング・システムの各パッケージは、付属するいくつかのネイティブ・ライブラリーが異なるのみです。
前提条件
エージェント用に Java Development Kit (JDK) を使用できる必要があります。 以下のようにして、サポートされる JDK のリストを確認できます。 以下の 2 つのオプションがあります。
最も簡単な方法は、その JDK を
<instana-agent-install-dir>/jvmに配置またはリンクすることです (<instana-agent-install-dir>/jvm/bin/javaが存在するようにします)。カスタマイズ可能な方法は、JAVA_HOME という環境変数をエクスポートして、その JDK を指すようにすることです (この環境変数は、
instana-agent-install-dir>/bin/setenvを使用して設定することもできます)。
現時点では、以下の JVM がエージェントの実行用にサポートされています。
- IBM OpenJ9 JDK 11 ( x64 で推奨)
- Azul Zulu JDK 11（ Apple silicon ）。
- OpenJDK 11
- AdoptOpenJDK
- Oracle ホットスポット JDK 11
- アマゾン・コレットJDK 11
- J9IBM 11
JVM はシステム上のどのユーザーでも実行可能であることが重要です。 選択した Java ディストリビューションの最新の使用可能なパッチ・リリースを使用することをお勧めします。 エージェントは、 TLSv1.3 （現在のすべてのJDK 11ビルドで利用可能）をサポートするJDKを必要とする。 ご使用の OS ディストリビューションによっては、エクスポート制御が原因で、OS ディストリビューターによって提供されるパッケージに強い暗号化サポートが含まれない場合があることに注意してください。 このようなパッケージを使用すると、 java.lang.RuntimeException: Could not generate DH key pair のようなエラーが発生するかもしれません。
エージェントのダウンロード
ホストエージェントをインストールして実行するには、以下の手順を実行します：
Instana UI のホームページで、 データソースの設定をクリックします。 Instana エージェント] タブで、[ エージェントのインストール ] を選択します。
注: Instana の新しいトライアルインスタンスを開始している場合、エージェントカタログが表示され、インストールするホストエージェントを選択するプロンプトが表示されます。タイルをクリック macOS - macOS ( 64bit - インテル & Apple silicon )
動的または静的エージェントをインストールするパッケージングオプションを選択します。
ダウンロードリンクをクリックして、エージェントアーカイブファイルをダウンロードしてください。
注意: エージェントアーカイブファイルは、エージェントキーとホストエージェントエンドポイントで事前に設定されています。エージェント・アーカイブを解凍します。
アーカイブには100文字以上のパスが含まれているため、アーカイブを展開するにはGNU-tarを使用する必要があります。 GNU-tar を使用しない場合、エージェントは起動に失敗し、 「SEVERE: Could not launch framework 」というエラーを返します。
エージェントの実行
ターミナルを開き、ディレクトリをエージェントを解凍したパスに変更します。 通常は
~/Downloads/instana-agent。cd ~/Downloads/instana-agent前提条件のセクションに従って、
JAVA_HOME環境変数が設定されていることを確認してください。 次に、以下のコマンドを実行して、エージェントをバックグラウンドで起動する：bin/startターミナルで以下のコマンドを実行して、エージェントが稼働しているかどうかを確認する：
bin/statusApple silicon ベースのマシンでの Instana エージェントの初回起動時に、エージェントの実行に必要な
libsigar-universal64-macosx.dylibという名前の署名されていないライブラリについて、 macOS からの警告が表示される場合があります。
このアーキテクチャ固有のライブラリの使用を許可するには、 システム環境設定 → セキュリティとプライバシー → 一般から承認する必要があります。
次に、ターミナルで以下のコマンドを実行してエージェントを再起動し、今度のポップアップウィンドウでもう一度ライブラリを承認します：
bin/stop & bin/start
ホストエージェントの状態の確認
ホストエージェントをインストールした後、Instana UI またはホスト上でホストエージェントのステータスを確認できます。 詳細については、 ホストエージェントのステータスの確認を参照してください。
制限
Instana は、開発およびテスト目的で、 MacOS とのベストエフォート互換性を提供します。 Instana エージェントは、
rootアカウントではなく、通常のユーザーアカウントで実行する必要があります。 さらに、Instana は、同じユーザーによって実行されるプロセスのみを監視します。 Docker コンテナーでのエージェントの実行はサポートされていません。 最後に、 Docker Machine、 Docker for Mac、および通常の Linux Docker の内部が大きく異なるため、 Docker コンテナの監視は不可能である。Apple silicon ベースのマシンでは、アーキテクチャ固有のライブラリはまだ署名されていない。 このトピックの実行手順のステップ4に従い、
libsigar-universal64-macosx.dylibライブラリを承認する。 詳細については、 Apple の公式ドキュメントを参照してください。
エージェント展開のトラブルシューティング
エージェントのインストールが最初に成功しなかった場合、ログメッセージとトラブルシューティングのヒントを確認することができます。 このトラブルシューティング セクションで疑問が解決しない場合は、 IBM Instana サポート チームに連絡して、経験に関する情報を提供してください。サポートを受けて、ドキュメントを適宜更新することができます。
すべてのホストエージェントに共通するトラブルシューティング情報については、 ホストエージェントの管理 / トラブルシューティングを参照してください。