SignalFx Smart Agentのインストールと設定 🔗
注釈
SignalFx Smart Agentのサポートが終了しました。エージェントはテレメトリをキャプチャして Splunk Observability Cloud にエクスポートできますが、Splunk はサポート、機能アップデート、セキュリティ、バグ修正を提供しなくなりました。このようなリクエストは SLA に拘束されません。
SignalFx Smart Agentは、コンテナ環境と非コンテナ環境の両方から、ホストのパフォーマンス、アプリケーション、およびサービスレベルのメトリクスを収集します。このページでは、Smart Agentリソースの完全なリストを提供します。ブラウザの検索機能を使用して、お探しのものをすばやく見つけることができます。
SignalFx Smart Agentでよく使用されるコマンドの一覧は、SignalFx Smart Agent のコマンドリファレンス を参照してください。
コンポーネント 🔗
エージェントには3つの主要コンポーネントがあります:
ホスト上で実行されているアプリケーションとサービスを検出するオブザーバー。サポートされるオブザーバとその構成の一覧については、オブザーバ構成 を参照してください。
ホストおよびアプリケーションからメトリクス、イベント、およびディメンションのプロパティを収集するモニター。サポートされるモニターとその構成のリストについては、モニター構成 を参照してください。
モニターが収集したメトリクス、イベント、ディメンションの更新を Splunk Observability Cloud に送信するライター。ライターは、設定されたモニターが発するメトリクスを収集し、定期的に Splunk Observability Cloud に送信します。構成スキーマで ライター設定 を構成できます。
ユースケース 🔗
Smart Agent は、Mongo、Redis、DockerなどのPythonベースのプラグインを含むモニターを使用してメトリクスを収集します。データソースインテグレーションのリストについては、Splunk Observability Cloud でサポートされているインテグレーション を参照してください。
Smart Agent を使用して、Amazon Web Services、Microsoft Azure、Google Cloud Platform、Kubernetes環境などのクラウドサービスと統合します。クラウドサービスプロバイダーに接続する を参照してください。次に、Splunk Observability Cloud にログインして、Splunk Observability Cloudのダッシュボード と Splunk Observability Cloudのチャート で受信メトリクスを表示します。
ナビゲーターを使用してネットワークとノードの健全性を確認します。関連コンテンツ など、Splunk Observability Cloud の一部の機能は Smart Agent では動作しません。詳しくは Splunk Infrastructure Monitoring でナビゲーターを使用する を参照してください。
Smart Agent は、トレースデータの受信と送信もサポートしています。トレースのダウンロード を参照してください。
公開されているポートを確認する 🔗
Smart Agentをインストールする前に、公開されているポートを確認し、お使いの環境で競合がないことを確認してください。ポートはSmart Agentの設定で変更できます。
ポート 8095 は、内部ステータス・サーバーがリッスンするデフォルトのポートです。
internalStatusPort
オプションを使用してポート 8095 を設定します。ポート9080は、サーバーがリッスンするデフォルトのポートです。ポート9080を設定するには、
listenAddress
オプションを使用します。listenAddress
オプションは、trace-forwarder
モニタ用に設定可能なオプションです。
Smart Agent のインストール 🔗
Smart Agent のインストールにはいくつかのオプションがあります。状況や好みに合ったオプションを選択してください。以下の各リンクには、前提条件、設定手順、インストール手順、インストールの確認手順が含まれています。
Smart Agent アプリケーションを単一のホストマシンにインストールするには、クイックインストール を参照してください。
インストールプロセスを自動化するには、Chef、Puppet、Salt、Ansible などのデプロイメント/構成管理ツールの デプロイメント を参照してください。
.zipファイルのスタンドアロンパッケージを使用してSmart AgentをWindowsホストにインストールするには、.zipファイルを使用したWindowsへのインストール を参照してください。
圧縮tarファイルを使用してSmart Agent をLinuxホストにインストールするには、tar.gzファイルを使用したLinuxへのインストール を参照してください。
設定スクリプトを使用してSmart Agent を AWS ECS インスタンスにデプロイするには、install to AWS ECS を参照してください。
DebianまたはRPMパッケージを使用してSmart Agent をインストールするには、*nixパッケージを使用したインストール を参照してください。
Smart Agent の APT-RPM パッケージを`splunk.jfrog.io` リポジトリに切り替えるには、DEB/RPM repo migration を参照してください。
Helmパッケージ・マネージャーを使用してSmart AgentをKubernetes環境にインストールするには、Helmを使用したインストール を参照してください。
kubectlを使用してSmart Agent をKubernetes環境にインストールするには、install using kubectl を参照してください。
Smart Agent は、SELinuxが有効になっているLinuxシステムとは互換性がありません。SELinuxを無効にする方法については、お使いのディストリビューションのマニュアルを参照してください。
注釈
Smart Agent をアンインストールするには、Smart Agent のアンインストール を参照してください。
Smart Agent の設定 🔗
agent.yamlファイルを編集することで、Smart Agent を設定できます。デフォルトでは、設定はLinuxでは /etc/signalfx/agent.yaml
、Windowsでは \ProgramData\SignalFxAgent\agent.yaml
にインストールされ、検索されます。-config
コマンドラインフラグを使用して、デフォルトの場所を上書きできます。
コンフィギュレーションスキーマ には、agent.yaml ファイルでインテグレーションの動作を制御するために使用できるオプションが含まれています。Example.yaml は、自動生成された YAML 設定ファイルの例を提供し、該当する場合はデフォルト値が含まれています。リモート設定 ファイルシステム上の他のファイルや、etcd などのキーバリューストアなど、リモートソースからSmart Agent を設定する方法について説明します。
Smart Agent を使用したログの取得 🔗
デフォルトのログレベルは、info
で、ログをスパムにすることなくSmart Agent イベントを記録します。info
レベルのログのほとんどは、起動時に作成され、サービス検出の変更をキャプチャし、ルーチン操作に関するメッセージを記録します。debug
ログレベルでは、冗長なログ出力が作成されるため、トラブルシューティング時にのみ使用する必要があります。
logging: {level: info}
YAML設定オプションを使ってログレベルを変更することができます。その他の有効なログレベルには warn
と error
があります。
Smart Agent は、構造化されていないテキスト(デフォルト)またはJSON形式でログを送信します。logging: {format: json}
YAML 設定オプションを使用して、JSON ログを送信するように Smart Agent を設定できます。
Linux 🔗
Smart Agent は、stdout/stderr
へのロギングをサポートしています。通常、提供されるinitスクリプトによって、/var/log/signalfx-agent.log
のファイルか、新しいディストロのsystemdジャーナルにリダイレクトされます。
Windows 🔗
Windowsでは、Smart Agentをシェルで直接実行すると、コンソールにログが記録されます。Smart AgentがWindowsサービスとして設定されている場合、ログイベントはWindowsイベントログに記録されます。ログを読むには、スタート を選択します。次に、管理ツール、イベントビューア の順に選択します。
Smart Agent でプロキシサポートを有効にする 🔗
HTTPまたはHTTPSプロキシを使用するには、コンテナ構成で環境変数 HTTP_PROXY
または HTTPS_PROXY
、いずれかのプロトコルをプロキシするように設定します。SignalFxのインジェスト・サーバーとAPIサーバーは、どちらもHTTPSを使用します。環境変数 NO_PROXY
が存在する場合、Smart Agent は自動的にローカルサービスを環境変数に追加し、プロキシを使用しないようにします。
Smart Agentがホストのローカルサービスとして実行されている場合、サービスの起動時にプロキシ対応を有効にするためにSmart Agentサービスに環境変数を渡す方法については、ホストのドキュメントを参照してください。例えば、ホストのサービスがsystemdによって管理されている場合、/etc/systemd/signalfx-agent.service.d/myproxy.confファイルを作成し、このファイルに以下を追加します:
[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080/"
Environment="HTTPS_PROXY=https://proxy.example.com:8081/"
ファイルを更新したら、systemctl daemon-reload
と systemctl restart signalfx-agent.service
を実行して、プロキシ対応のサービスを再起動します。
Sys-Vベースのinit.dシステム:DebianとRHEL 🔗
以下の内容で/etc/デフォルト/signalfx-agent.yamlファイルを作成します:
HTTP_PROXY="http://proxy.example.com:8080/"
HTTPS_PROXY="https://proxy.example.com:8081/"
Smart Agent の診断 🔗
Smart Agent は、internalStatusHost
および internalStatusPort
オプションで設定されたアドレスの HTTP サーバーで診断情報を提供します。signalfx-agent
コマンドステータスを使用して、サーバーを読み取り、その内容を抽出します。その内容を使用して、Smart Agent の問題を特定し、解決します。signalfx-agent
コマンドは、さらに診断情報を取得する方法についても説明しています。
Smart Agent を使用したサービスディスカバリー 🔗
Smart Agentには、包括的なサービス検出機能があります。この機能により、Smart Agent は環境内の各サービスを識別し、バンドル内から適切なインテグレーションプラグインを自動的に設定できます。これは、新しいサービスが数分以内に自動的に検出、インストール、および設定されるため、高稼働率で動的なサービスが作成される大規模なエフェメラルコンテナ環境では特に有用です。しかし、この機能はコンテナ化されていない環境にも拡張されています。詳細と設定オプションについては、Service Discovery を参照してください。
Smart Agent を使用したデータのフィルターリング 🔗
特定のデータポイントやプロパティをフィルターリングして、Smart Agent から出ないようにします。フィルターリングは、UIでフィルターリングすることなく、チャートの乱雑さを減らすのに便利です。
可能であれば、省略したいデータポイントやプロパティがモニターによって生成されないようにすることが推奨されます。そうすることで、Smart Agent のCPUとメモリの使用量を減らすことができるからです。
Smart Agent 4.7.0+の詳細と設定オプションについては、フィルターリング を参照してください。Smart Agent 5.0+で廃止された旧式のフィルターリングについては、レガシーフィルターリング を参照してください。
Smart Agent のアンインストール 🔗
システムからSmart Agentを削除するには、各インストール方法の手順に従ってください。
Linux (パッケージ・マネージャー) 🔗
Ubuntuを含むDebianベースのディストリビューションでは、以下のコマンドを実行します:
sudo dpkg --remove signalfx-agent
Red Hat、CentOS、その他のRPMベースのインストールでは、以下のコマンドを実行します:
sudo rpm -e signalfx-agent
注釈
設定ファイルは /etc/signalfx
に残る可能性があります。
Linux (tarファイル) 🔗
Smart Agent をアンインストールするには、signalfx-agent
プロセスを停止し、signalfx-agent ディレクトリを削除します。
Windows (インストーラー) 🔗
コントロールパネルの「 プログラムと機能」 からSmart Agentをアンインストールします。
注釈
設定ファイルは \ProgramData\SignalFxAgent
に残る可能性があります。
Windows (ZIPファイル) 🔗
以下のPowerShellコマンドを実行して、signalfx-agent
サービスを停止し、アンインストールします:
SignalFxAgent\bin\signalfx-agent.exe -service "stop"
SignalFxAgent\bin\signalfx-agent.exe -service "uninstall"
次に、SignalFxAgentフォルダを削除します。
kubectlを使用してデプロイ済み 🔗
すべてのSmart Agentリソースを削除するには、YAML設定ファイルを含むディレクトリで以下のコマンドを実行します:
cat *.yaml | kubectl delete -f -
詳細については、Kubectl リファレンス・ドキュメントを参照してください。
Helmを使用してデプロイ 🔗
Smart Agent のHelmリリースをアンインストールするには、以下の手順に従ってください:
https://helm.sh/docs/helm/helm_list/ の Helm リストからリリース名を取得します。
Helm アンインストールガイドの手順に従ってください。
SignalFx Helm リポジトリを削除するには、https://helm.sh/docs/helm/helm_repo_remove/ の Helm Repo Remove を参照してください。
AWS ECSでのデプロイ 🔗
signalfx-agent
タスク定義の登録を解除するには、AWS の公式ドキュメント https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deregister-task-definition.html を参照してください。
signalfx-agent
サービスを削除するには、https://docs.aws.amazon.com/AmazonECS/latest/developerguide/delete-service.html のサービスの削除を参照してください。
よくある質問 🔗
Smart Agent のトラブルシューティングについては、よくある質問 を参照してください。