Mac OS でのホスト・エージェントのインストール

エージェント用に Java Development Kit (JDK) を使用できる必要があります。 以下のようにして、サポートされる JDK のリストを確認できます。 以下の 2 つのオプションがあります。

1. 最も簡単な方法は、その JDK を <instana-agent-install-dir>/jvm に配置またはリンクすることです ( <instana-agent-install-dir>/jvm/bin/java が存在するようにします)。

2. カスタマイズ可能な方法は、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
• Amazon Corretto JDK 11
• IBM J9 11

JVM はシステム上のどのユーザーでも実行可能であることが重要です。 選択した Java ディストリビューションの最新の使用可能なパッチ・リリースを使用することをお勧めします。 このエージェントには、 TLSv1.3 をサポートするJDKが必要です（現在のすべてのJDK 11ビルドで利用可能です）。 ご使用の OS ディストリビューションによっては、エクスポート制御が原因で、OS ディストリビューターによって提供されるパッケージに強い暗号化サポートが含まれない場合があることに注意してください。 このようなパッケージを使用すると、「 java.lang.RuntimeException: : DH鍵ペアを生成できませんでした」といったエラーが発生する可能性があります。

ホスト・エージェントをインストールして実行するには、以下の手順を実行します。

1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。

   注：Instana の新しい試用インスタンスを起動する場合、エージェントカタログが表示され、インストールするホストエージェントを選択するよう求められます。

2. タイル macOS - macOS (64bit -Intel & Apple silicon) をクリックします。

3. 動的エージェントまたは静的エージェントをインストールするには、パッケージ化オプションを選択します。

4. エージェント・アーカイブ・ファイルをダウンロードするには、ダウンロード・リンクをクリックします。

   注： エージェントのアーカイブファイルには、エージェントキーとホストエージェントのエンドポイントがあらかじめ設定されています。そのため、解凍してエージェントを実行するだけで済みます。

5. エージェント・アーカイブを解凍します。

   アーカイブには 100 文字より長いパスが含まれているため、アーカイブを解凍するには GNU-tar を使用する必要があります。 GNU-tar を使用しない場合、エージェントは起動に失敗し、 「SEVERE: フレームワークを起動できませんでした」 というエラーが返されます。

1. 「端末 (Terminal)」を開き、エージェントを解凍したパスにディレクトリーを変更します。 通常は ~/Downloads/instana-agentです。

   cd ~/Downloads/instana-agent
    

2. JAVA_HOME 環境変数が prerequisites セクションに従って設定されていることを確認してください。 次に、以下のコマンドを実行して、バックグラウンドでエージェントを開始します。

   bin/start
    

3. 端末で以下のコマンドを実行して、エージェントが稼働中であるかどうかを確認します。

   bin/status
    

4. Apple 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 ）のサポートチームまで、具体的な状況をご連絡ください。お客様をサポートするとともに、ドキュメントを適切に更新させていただきます。

すべてのホスト・エージェントに共通のトラブルシューティング情報については、「 ホスト・エージェントの管理/トラブルシューティング」を参照してください。