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パッケージがアップグレードされます。

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

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

たとえば、 Debian では、 Instana の変数を更新し、(このファイルが読み取り PATH 可能である場合) を使用して /etc/default/instana-agent ：

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

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

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

• ドロップイン・ユニット
• 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/*
 

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

Red Hat Enterprise LinuxとCentOS,のバージョン 6 と 7 には、パッケージが指定できるポリシーに関係なく、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 Linux6とCentOS6には、'/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