ホストエージェントの管理 Linux

ホストエージェントをインストールすると、システム起動時に自動的に起動するようになります。 エージェントのインストール時に環境変数 INSTANA_AGENT_AUTOSTART=false を設定することで、この動作をオフにすることができる。

• ホスト・エージェントを起動するには、以下のコマンドを実行する：

  /opt/instana/agent/bin/start
   

• オペレーティング・システムがinitシステムとして systemd を使用している場合は、以下のコマンドを実行する：

  systemctl start instana-agent.service
   

• オペレーティング・システムがinitシステムとして SysVinit を使用している場合は、以下のコマンドを実行する：

  service instana-agent start
   

エージェントを停止するには、以下のコマンドを実行する：

 /opt/instana/agent/bin/stop
 

• オペレーティング・システムがinitシステムとして systemd を使用している場合は、以下のコマンドを実行する：

  systemctl stop instana-agent.service
   

• オペレーティング・システムがinitシステムとして SysVinit を使用している場合は、以下のコマンドを実行する：

  service instana-agent stop
   

お使いのオペレーティングシステムのパッケージマネージャを使用して、マシンのエージェントパッケージをアップグレードすることができます。 システムのパッケージとパッチを更新・管理するには、以下のコマンドを実行する：

yum update // apt-get upgrade
 

instana-agent-static または instana-agent-dynamic パッケージがアップグレードされます。

オペレーティング・システムがinitシステムとして SysVinit を使用している場合、ホスト・エージェントは、 /etc/default/ ディレクトリ（ Debian および派生物）または /etc/sysconfig/ ディレクトリ（ Red Hat および派生物）にある対応するシェル・スクリプトをソースとします。

サービス名が変更されない場合 SysVinit スクリプトは /etc/default/instana-agent ファイルまたは /etc/sysconfig/instana-agent ファイルをソースとします。

例えば、 Debian では、 /etc/default/instana-agent （このファイルが読み取り可能であることが判明した場合）を使用することで、インスタナの変数と PATH を更新することができる：

INSTANA_AGENT_KEY=$agentkey
INSTANA_AGENT_ENDPOINT=$endpoint
INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port
PATH=/usr/local/bin:${PATH}
 

エンドポイント、ポート、およびエージェントのキー値を見つけるには、Instana UI のホーム ページに移動し、[ エージェントの展開 ] をクリックします。 エージェント展開カタログページで、 Linux - 自動インストール(ワンライナー) というタイルをクリックします。 その後、展開スクリプトでエンドポイント、ポート、およびエージェントのキー値を確認できます。

お使いのオペレーティング・システムがinitシステムとして Systemd を使用している場合、以下の利用可能なオプションを使用して環境変数を設定したり上書きしたりすることができます。 ドロップインユニットの方法は、サービスユニットファイルを変更する必要がないため、推奨される方法です。 また、これらの変更はアップデート中に削除されるかもしれない。 ドロップイン・ユニット方式を採用することで、アップデート後も設定した変更や環境変数が保持される。

• ドロップイン・ユニット
• EnvironmentFile ディレクティブ
• グローバル環境設定

system.d-ベースのシステムでは、 systemd-tmpfiles デーモンが /tmp/.instana ディレクトリのホストエージェントが必要とするファイルを削除することがあり、トラブルシューティングが困難な更新の失敗が発生する。

バージョン 181 以降、DEB および RPM エージェントパッケージは、必要なファイルを削除せず、Instana ホストエージェントの機能に影響を与えないように動作を調整する以下の設定スクリプトを /usr/lib/tmpfiles.d に自動的にインストールします。

# Instana files in /tmp cannot be deleted when the agent is running,
# or it may lead to issues on agent update
R! /tmp/.java_pid*
R! /tmp/.instana/*
 

この設定により、 tmpdfiles.d 、ホストの再起動後にのみInstanaエージェントが必要とするファイルを削除できるようになります。 新しく実行される Instana ホストエージェントは、起動時にファイルを再作成します。

Red Hat Enterprise Linux およびバージョン6と7の CentOS,、パッケージが指定できるポリシーに関係なく、10日ごとに /tmp ディレクトリ全体を削除するデフォルトの tmpdfiles.d ポリシーが含まれています。 これは、Instanaのようなパッケージが、システムやパッケージ自体の動作を制御するカスタムポリシーを定義できることを意味する。

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

# See tmpfiles.d(5) for details
# Clear tmp directories separately, to make them easier to override
v /tmp 1777 root root 10d
v /var/tmp 1777 root root 30d

...
 

デフォルトの tmpfiles.d ポリシーを編集する以外、既知の回避策はありません。 問題の tmpfiles.d ポリシーは /usr/lib/tmpfiles.d/tmp.conf にあります。

Ubuntu を含む多くの Debian 派生物には、Instana のようなパッケージが指定できるポリシーに関係なく、 /tmp ディレクトリ全体を削除するデフォルトの tmpdfiles.d ポリシーが含まれている。 インストール時に、DEBおよびRPMパッケージは、一時ファイル tmpfiles.d の動作を確認するためのテストを実行し、コマンド systemd-tmpfiles --remove を実行します。

Instana エージェント パッケージで指定されている必要な動作をオーバーライドするポリシーを持つシステムで、次の警告が表示される場合があります：

WARNING: The tmpfiles.d policies of this system may cause the Instana agent to malfunction by deleting the /tmp/.instana directory; refer https://www.instana.com/docs/setup_and_manage/host_agent/on/linux#tmpfiles.d for more information.
 

この問題は、デフォルトの tmpfiles.d ポリシーを編集することで対処できる。 問題の tmpfiles.d ポリシーは /usr/lib/tmpfiles.d/tmp.conf にあります。

Red Hat Enterprise Linux 6 と CentOS 6 には、 /tmp/.instana にある不要なファイルを削除することで知られるツール tmpwatch が含まれている。 しかし、これらのディストリビューションでtmpwatchを使用すると、時折ホスト・エージェントで更新の問題が発生することがある。 詳しくは、 一時ファイルの削除を参照してください。

# Deal with tmpwatch, found in RHEL 6 and CentOS 6.
# It is a cronjob, installed in /etc/cron.d/daily, with pretty much hardcoded
# configurations to wipe data the Instana agent needs.
readonly TMPWATCH_CRONJOB='/etc/cron.d/daily/tmpwatch'
if [ -f "${TMPWATCH_CRONJOB}" ]; then
  # Let's check if we already touched the file and, if not, add our excludes
  if ! grep "${TMPWATCH_CRONJOB}" Instana 2&>1 > /dev/null; then
    echo "tmpwatch discovered in '${TMPWATCH_CRONJOB}': adding the exclude flags for Instana"
    # Edit in place with `sed`
    sed -i '/^flags=/a flags="${flags} -x /tmp/instana -x /tmp/.javapid* # Added by Instana"' "${TMPWATCH_CRONJOB}"
  fi
fi