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

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

Instana エージェントパッケージをダウンロードするには、次の手順を実行します：

1. Instana UI のホームページで、 データソースの設定をクリックします。 Instana エージェント] タブで、[ エージェントのインストール ] を選択します。

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

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

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

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

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

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

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

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

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

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

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

• Debian derivatives (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>
      

     注： あるいは、 /etc/apt/sources.list.d/instana-agent.list の URL に認証をハードコードすることもできる。 しかし、この方法は軽度のセキュリティリスクを引き起こし、 apt 、Instana パッケージをインストールまたは更新するたびに警告が表示される。

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

     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_HOST と INSTANA_AGENT_PORT の使用は、非推奨である。 これらの環境変数は、Instana トレーサがエージェントに接続するように設定するために予約されています。 グローバルに設定されている場合、Instana トレーサはエージェントに接続できません。 これらの環境変数を使用してエージェントを設定するサポートは、Instana の将来のバージョンでは削除されます。

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

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

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

   • SysVinit: ファイルを /etc/sysconfig ( Red Hat 派生) または /etc/default ( Debian 派生) のいずれかに置く。

   環境変数のオプションの詳細については、 環境変数の設定とオーバーライドを参照してください。

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

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

• 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
  • アマゾン・コレットJDK 11
  • IBM J9 11

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

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

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

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

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

  • DNS名 ： artifact-public.instana.io
  • デスティネーション・ポート ： tcp/80 tcp/443

• 現在、インスタナ・サービスは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}}
   

これでホストエージェントがダウンロードされた。 次のセクションに進み、エージェントを開始する。

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

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

INSTANA_AGENT_FOLDER/bin/start
 

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

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