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

一行スクリプトのパラメータ

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

エージェントパッケージのダウンロード

セルフホストバックエンドを使用している場合、エージェントパッケージをダウンロードするには、バックエンドのバージョンが275でなければなりません。

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）をダウンロードします。

インターネットに接続されていないオフライン（エアギャップ）環境では、 Artifactory から DEB または RPM 用のエージェントパッケージを直接ダウンロードできます。 最新のパッケージをダウンロードしてください。

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

エージェントパッケージのインストール

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

パッケージマネージャを使用してエージェントパッケージをインストールするには、ご使用の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>
     

     あるいは、 /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_ky>をeあなたのエージェント・キーに置き換えてください。

  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- 自動インストール(One-liner)]タイルをクリックします。 その後、展開スクリプトでエンドポイント、ポート、およびエージェントのキー値を確認できます。

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

   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_HOST=$endpoint
   export INSTANA_AGENT_PORT=$endpoint_port
   

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

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

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

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

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

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

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

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

• 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
  • 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ユーザーとしてエージェントを実行する。

他のユーザーでホストエージェントを実行した場合、ホストエージェントの機能は制限されます。 というのも、パフォーマンスメトリクスの中には、ルートだけがサポートしているものがあるからだ。 Docker コンテナの監視は、 Docker ホスト・マシンの root のみが行える。 さらに、Java仮想マシン（JVM）をアタッチして監視できるのは、ルート・ユーザーまたはスタートアップ・ユーザーのみである。 ホスト・エージェントをrootとして実行できない場合は、エージェント・ユーザーが有効なシェルで sudoersにリストされていることを確認してください。

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

INSTANA_AGENT_FOLDER/bin/start

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

サポートされている機能

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