Linuxへのエージェントのインストール

ワンライナー・スクリプトは以下のパラメーターを受け付ける：

Instana エージェントパッケージをダウンロードするには、以下の手順に従ってください：

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

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

2. エージェント展開カタログページで、[Linux- Packages (DEB、RPM)] タイルをクリックします。

3. エージェントの設定を選択します。

   • パッケージングセクションで、デプロイするエージェントタイプ（Dynamicまたは'Static）を選択します。 静的エージェントと動的エージェントの違いについては、ホストエージェントの種類を参照してください。

   • Runtimeセクションで、Azul Zulu 11またはEclipse OpenJ911ランタイムを選択します。

   • Modeセクションで、使用するパッケージモード（RPMまたは'DEM）を選択します。

4. Platform architectureセクションで、ホストエージェントをインストールするLinuxマシンのアーキテクチャを選択します。

5. ダウンロードアイコンをクリックして、ウェブブラウザからホストエージェントパッケージ（DEBまたはRPM）をダウンロードします。

これでエージェントパッケージがダウンロードされた。 Go 次のセクションに進み、エージェントパッケージをインストールしてください。

エージェントパッケージをインストールするようにパッケージマネージャに指示するか、エージェントパッケージを手動でインストールしてください。

パッケージマネージャを使用してエージェントパッケージをインストールするには、ご使用のLinuxディストリビューションに基づき、以下のいずれかの方法を使用します：

openSUSE/SLES (zypp パッケージマネージャー)

openSUSEと SUSE Linux Enterprise Server Serverの場合、パスは'/etc/zypp/yum.repos.d/Instana-Agent.repoですが、内容はRPMベースのディストリビューションと同じにすることができます。

これでエージェントパッケージがインストールされた。 パッケージマネージャーのソースをリフレッシュしたら、次のセクションに進んでください。

1. ホストエージェントのエンドポイントとエージェントキー を設定します。

   エンドポイント、ポート、およびエージェントキーの値を確認するには、 Instana UIのホーム画面に移動し、 「エージェントの展開」 をクリックします。 エージェント展開カタログページで、 「 Linux - 自動インストール（ワンライナー）」 のタイルをクリックします。 その後、展開スクリプトでエンドポイント、ポート、およびエージェントのキー値を確認できます。

   次のスクリプト例を参照：

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo -E ./setup_agent.sh -a aGeNTKEY0vaLuO0Eu1ABc -d n3asffgkg -t dynamic -e ingress-green-saas.instana.io:443

2. ホストエージェントをインストールする前に、環境変数を設定してください。

   export INSTANA_AGENT_KEY=$agentkey
   export INSTANA_AGENT_ENDPOINT=$endpoint
   export INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port

   注： エージェントの設定における環境変数 INSTANA_AGENT_HOSTINSTANA_AGENT_PORT および の使用は非推奨となっています。 これらの環境変数は、 Instana のトレーサーがエージェントに接続するように設定するために予約されています。 これらがグローバルに設定されている場合、 Instana のトレーサーはエージェントに接続できません。 Instana の今後のバージョンでは、エージェントの設定にこれらの環境変数を使用する機能は廃止される予定です。

   環境変数を設定するためのオプションのまとめ：

   • Gitのコンフィギュレーション管理：環境変数をファイルに置くのは良いアプローチです。 詳細については、 Git ベースの構成管理を参照してください。

   • Systemd： ドロップインは、サービスの環境固有の設定を上書きする最も簡単な方法です。

   • SysVinit:ファイルを/etc/sysconfigRed Hat派生) または/etc/defaultDebian派生) に置く。

   環境変数のオプションに関する詳細については、 「環境変数の設定と上書き」 を参照してください。

これでエージェントインストールの準備作業は完了です。 Go 「 エージェントのインストール」 セクションに進んでください。

パッケージ・マネージャのソースを更新し、以下のコマンドのいずれかを実行して、選択したアーキテクチャにエージェントをインストールする：

• Debian 派生ディストリビューション

  • 静的エージェントをインストールするには、以下のコマンドを実行する：

    apt-get install instana-agent-static

  • ダイナミック・エージェントをインストールするには、以下のコマンドを実行する：

    apt-get install instana-agent-dynamic

• Red Hat派生製品

  • 静的エージェントをインストールするには、以下のコマンドを実行する：

    yum install instana-agent-static

  • ダイナミック・エージェントをインストールするには、以下のコマンドを実行する：

    yum install instana-agent-dynamic

• Eclipse OpenJ9 11 バンドル・パッケージ

  instana-agent-static-j9または'instana-agent-dynamic-j9パッケージ名でホストエージェントをインストールする。

これでホストエージェントがインストールされた。 インストール後にできることについては、「次にすること」のセクションをご覧ください。

ホストエージェントをインストールする前に、以下の前提条件が満たされていることを確認してください：

• エージェントが Java 開発キット（JDK）を利用できるようにするには、以下のいずれかの方法を使用する必要があります：

  • JDKを'<instana-agent-install-dir>/jvmに配置するかリンクする（'<instana-agent-install-dir>/jvm/bin/java存在するように）。

  • カスタマイズ可能な方法は、環境変数JAVA_HOMEをエクスポートして、そのJDKを指すようにすることである（この環境変数は'instana-agent-install-dir>/bin/setenvに設定することもできる）。

  以下の JDK がエージェントの実行にサポートされています：

  • IBM OpenJ9 JDK 11（推奨）
  • アズール・ズール JDK 11
  • OpenJDKJDK 11
  • OracleJDK 11
  • アマゾン・コレットJDK 11
  • IBM J911

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

• ファイルシステムが変更されたときにエージェントが使用するリソースを減らすには、Linuxディストリビューションにinotify-toolsパッケージをインストールする必要があります。

• エージェントを実行するために使用されるユーザが、エージェントディレクトリとそのすべてのサブディレクトリに書き込めることを確認する。 エージェントは、自動検出に従って必要なセンサーをダウンロードし、'dataサブディレクトリにログファイルを作成する。

• 使用可能なディスク容量が100MB程度あることを確認してください。

• エージェントは以下のホストからアップデートとセンサーをダウンロードする。 以下のホストとポートにアクセスできることを確認する：

  • DNS 名前 ： artifact-public.instana.io
  • 宛先ポート：'tcp/80と'tcp/443

• 現在、「 Instana 」サービスは2つの異なるリージョンで提供されています。 個々のインスタンスは、ほとんどのエージェントとユーザーに地理的に最も近い場所に配置されます。 エージェントはダウンロード時にあらかじめ設定されていますが、一部のインストール方法では、 Instana のバックエンド設定が必要となります。 インスタンスが配置されているリージョンについては、製品内の「エージェント管理」セクションを参照するか、 IBM の担当技術者にお問い合わせください。

• セルフホスト型（オンプレミス）の Instana をご利用の場合は、 Instana のバックエンドインストール時に定義されたエンドポイントを使用してください。 また、 Instana のUIでは、エージェントがレポートを送信するエンドポイントを確認することもできます。 Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 「 Instana 」の「エージェント」タブで、 「エージェントのインストール」 を選択し、デプロイメントコードまたは「 YAML 」の設定にチェックを入れます。

• Instana （ SaaS, ）をご利用の場合は、「ホストエージェントのエンドポイント」 に記載されているエンドポイントをご利用ください。

ホストエージェントは、以下のいずれかの方法でダウンロードできます：

• Instana のUIからエージェントをダウンロードするには、以下の手順に従ってください：

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

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

  2. エージェント展開カタログページで、[Linux- Archive (tar.gz)]タイルをクリックします。

  3. パッケージングセクションで、デプロイするエージェントタイプ（Dynamicまたは'Static）を選択します。 静的エージェントと動的エージェントの違いについては、ホストエージェントの種類を参照してください。

  4. ドロップダウンリストで、プラットフォームアーキテクチャ（オペレーティングシステム）を選択します。

     アーカイブファイルには、 Instana のアカウント設定が自動的に事前設定されているため、解凍してエージェントを起動するだけで利用を開始できます。

  5. ダウンロードアイコンをクリックして、ウェブブラウザからホストエージェントパッケージファイルtar.gz）をダウンロードし、ファイルを解凍します。

• 以下のコマンドを実行して、エージェントをwgetでダウンロードする：

  wget --save-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'email={{instana_username}}&password={{instana_password}}' https://{{instana_tenant_unit}}-{{instana_tenant}}.instana.io/auth/signIn

  wget --content-disposition --load-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'type=linux64' https://instana.io/ump/{{instana_tenant}}/{{instana_tenant_unit}}/agent/download -O {{opt_folder}}/{{name_of_agent_archive.tar.gz}}

これでホストエージェントがダウンロードされた。 Go 次のセクションに進んで、エージェントを起動してください。

解凍したエージェント・パッケージ・ファイルをシステム全体でアクセス可能な場所に置き、rootユーザーとしてエージェントを実行する。

エージェントを始動するには、次のコマンドを実行します。

INSTANA_AGENT_FOLDER/bin/start

これでホスト・エージェントがインストールされ、起動した。 インストール後にできることについては、次にすることを参照してください。