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

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

Instana エージェントパッケージをダウンロードするには、次の手順を完了してください：

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

   Instana の新しい試用インスタンスを開始する場合、エージェントカタログが表示され、インストールするホストエージェントを選択するようプロンプトが表示されます。

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

3. エージェント設定を選択してください。

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

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

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

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

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

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

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

パッケージマネージャーを使用してエージェントパッケージをインストールするには、お使いの Linux ディストリビューションに応じて、以下のいずれかの方法を使用してください：

• Debian 派生ディストリビューション (apt パッケージ・マネージャー)

  1. Instana エージェントパッケージ用のリソースを含むパッケージ apt マネージャーを準備するため、以下のファイルを作成します:

     # /etc/apt/sources.list.d/instana-agent.list
     deb [arch=amd64] https://packages.instana.io/agent generic main
      

     # /etc/apt/auth.conf.d/instana-packages.conf
     machine packages.instana.io
     login _
     password <your_agent_key>
      

     注： あるいは、認証を URL にハードコードすることも /etc/apt/sources.list.d/instana-agent.list可能です。 ただし、この方法では軽微なセキュリティリスクが生じ、 Instanaapt パッケージのインストールや更新時に警告が表示されます。

  2. 以下のコマンドを実行して、 aptInstana のGPGキーをパッケージマネージャーに追加します:

     wget -qO - https://packages.instana.io/Instana.gpg | sudo apt-key add -
      

• RPMベースのディストリビューション（yum パッケージマネージャー）

  1. 以下のコードスニペットを yum のソースにコピーしてください (/etc/yum.repos.d/Instana-Agent.repo):

     [instana-agent]
     name=Instana
     baseurl=https://_:<your_agent_key>@packages.instana.io/agent/generic/x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=1
     gpgkey=https://packages.instana.io/Instana.gpg
     priority=5
     sslverify=1
      

     <your_agent_key> をあなたのエージェントキー に置き換えてください。

  2. GPGパッケージ検証を有効にしたい場合、一部のディストリビューションでは、事前にパッケージマネージャーのキーリングに鍵をインポートする必要があります。

     キーをインポートするには、次のコマンドを実行してください:

     rpm --import https://packages.instana.io/Instana.gpg
      

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

  openSUSE および SUSE Linux Enterprise 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 ./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: ファイルを ( Red Hat の派生ファイル) または /etc/default/etc/sysconfig ( Debian の派生ファイル) のいずれかに配置してください。

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

エージェントのインストール準備作業が完了しました。 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 するように）。

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

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

  • IBM OpenJ9 JDK 11（推奨）
  • アズール・ズール JDK 11
  • OpenJDK JDK 11
  • Oracle ホットスポット JDK 11
  • Amazon Corretto JDK 11
  • IBM J9 11

  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 - アーカイブ」( 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
 

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

非rootユーザーとして実行される Instana エージェントは、以下の機能をサポートします: