--- title: "#52 OneAgentのコマンドラインインターフェースご紹介" description: "DynatraceのエージェントであるOneAgentのコマンドラインインターフェース「oneagentctl」をご紹介します。 おすすめの活用方法などについても紹介しています！" --- [DynatraceTips ](https://www.iim.co.jp/dynatips) # [#52 OneAgentのコマンドラインインターフェースご紹介](https://www.iim.co.jp/dynatips/052) 作成者: [城水（IIMサポートチーム）](https://www.iim.co.jp/dynatips/author/城水iimサポートチーム)｜Mar 31, 2024 10:00:00 PM     皆さまこんにちは、IIMサポートチームです。     このブログではDynatraceのTips等、 気軽に読めて皆さまのお役に立てるようなコンテンツを配信してます。   ＊文中、*斜体*になっている単語はDynatrace画面上/ドキュメント内で使用される用語となります 　例）*Service*、*Host *など ＊青色の色掛部分は操作対象のボタンを表しています   今回は *OneAgent*のコマンドラインインターフェースご紹介 がテーマです。   ちなみにコマンドラインインターフェース（以下CLI）とは、コンピュータ・ソフトウェアが利用者に対して情報を提示したり操作を受け付けたりする方法のひとつで、文字列によってやりとりを行う方法のことを言います。   Dynatraceのエージェントである *OneAgent* にもCLIがありますので、ご紹介できればと思います。   ## *OneAgent*のコマンドラインインターフェース *oneagentctl* *oneagentctl *が、*OneAgent*のコマンドラインインターフェースです。* * これを使うことで、*OneAgent*の再起動や、各種設定値の確認・変更ができます。   ### *oneagentctl *の配置先 以下に配置されています。 | OS | デフォルトパス | インストールパスをカスタマイズしている場合 | | --- | --- | --- | | Linux | /opt/dynatrace/oneagent/agent/tools | /agent/tools | | Windows | %PROGRAMFILES%\\dynatrace\\oneagent\\agent\\tools | \\agent\\tools |     #### インストールパスが不明な場合 *OneAgent *プロセスいずれかの*Process group instance *詳細画面に遷移します。 [Properties and tags] を展開し、EXE pathを確認していただくと、インストールパスを確認できます。   ※*Process group instance*については以下記事をご参照くださいませ。 [#31 Process groupについて](https://www.iim.co.jp/dynatips/031)         ### *oneagentctl  *でできること 詳細はDynatraceのドキュメントをご参照いただければと思いますが、主にできることは以下です。 ※Linux環境を例として、以下のコマンドは記載していますが、*oneagentctl*のパス以外は同一です。   Dynatraceのドキュメント：[OneAgent configuration via command-line interface](https://docs.dynatrace.com/docs/shortlink/oneagentctl)     | 確認内容 | 確認コマンド ※太字部分はLinux・Windows共通のコマンド | 変更コマンド ※太字部分はLinux・Windows共通のコマンド | | --- | --- | --- | | *OneAgent*バージョンの確認 | /agent/tools/oneagentctl --version | コマンドによる変更はできない。 | | 接続先*Environment*の確認・変更 | /agent/tools/oneagentctl --get-tenant | /agent/tools/oneagentctl --set-tenant= --set-tenant-token= --set-server= --set-proxy=: --restart-service   ※以下参照 | | Proxy値の確認・変更 | /agent/tools/oneagentctl --get-proxy | /agent/tools/oneagentctl --set-proxy=: --restart-service | | ログアクセス設定の確認・変更 | /agent/tools/oneagentctl --get-app-log-content-access | /agent/tools/oneagentctl  --set-app-log-content-access= --restart-service | | モニタリングモードの確認・変更 | /agent/tools/oneagentctl --get-monitoring-mode | /agent/tools/oneagentctl --set-monitoring-mode= --restart-service ※変更後、監視対象のミドルウェア再起動が必要です | | *Host Group*設定の確認・変更 | /agent/tools/oneagentctl --get-host-group | /agent/tools/oneagentctl --set-host-group=  --restart-service |   ※接続先の*Environment *を変更する場合 変更コマンドのパラメータ値は、変更先の*Environment*でAPIを実行して取得できます。 APIを実行するためには、事前に*token*の発行が必要です。   *oneagantctl*による接続先*Environment*を変更する流れは、以下のとおりです。   1. 変更先の*Environment*で*token*を発行する token発行時に必要なscopeは、以下ドキュメントの「Authentication」を参照します。 [Deployment API - View connectivity information for OneAgent - Dynatrace Docs](https://docs.dynatrace.com/docs/dynatrace-api/environment-api/deployment/oneagent/get-connectivity-info#access-tokens) 2. 変更先の*Environment*でAPIを実行する 1.で発行した*token*を使用し、以下ドキュメントのAPIを実行します。 [Deployment API - View connectivity information for OneAgent - Dynatrace Docs](https://docs.dynatrace.com/docs/dynatrace-api/environment-api/deployment/oneagent/get-connectivity-info#access-tokens)   3. APIの実行結果を*oneagentctl* のパラメータにセットし、実行する --set-tenant= --set-tenant-token= --set-server= ※複数の接続先がある場合（; を含む場合）、"" で値を囲う --set-proxy=: ※Proxy利用時にセット   APIの実行手順や、*token*の発行手順については本記事では割愛いたしますので、ご不明点がございましたら担当営業・担当SEまでお問合せいただければと思います。     　オプション「--restart-service」を付与して実行しない限り、*OneAgent* の再起動は行われません。   　*oneagentctl *を使って設定の変更を行う場合、オプション「--restart-service」を付与して実行しないと、設定変更が適用されず、以下のエラーメッセージが出力されます。 `Configuration changes were not applied, OneAgent service must be stopped first. You may use --restart-service to automate the process`     ## *oneagentctl* の使い方 *OneAgent* のバージョン確認を行う想定で使い方を説明します。 以下のように、実行すると簡単に*OneAgent* に関する情報を確認できます。   1. *OneAgent *を導入しているサーバーにログインします。 ※実行には、管理者権限/root権限が必要です   2. 次のコマンドを実行します。 Linux：/opt/dynatrace/oneagent/agent/tools/oneagentctl --version Windows："%PROGRAMFILES%\dynatrace\oneagent\agent\tools\oneagentctl" --version       ## おすすめの活用方法 *oneagentctl* の活用方法として、*OneAgent* の導入直後の設定値確認に使っていただくことをおすすめいたします！ 問題なく導入が完了すれば、特に設定値確認は不要と思いがちですが、「*OneAgent*バージョンがいくつだったか」「どんな設定になっているか」など、意外とあとから確認することが出てくることがあります。 （もちろんDynatraceの画面上から確認もできますが、あとから情報をひとつひとつ確認することはなかなか大変です…。）   特に、使い始めたばかりのときには、どの情報を管理しておくべきかの認識が曖昧になってしまうこともあるかと思いますので、ある程度導入直後に情報を集めておくと、後々役立つと考えています。   更に、導入作業時にエラーが発生してしまったときの切り分けに活用することもできます。   「*oneagentctl  *でできること」に記載している内容がよく確認するものかと思いますが、ぜひDynatraceのドキュメントも参照していただき、どんなことができるかを一度確認してみていただけますと幸いです。       関連リンク：   [Easily migrate your OneAgent from one tenant or server to another - Dynatrace Blogs](https://www.dynatrace.com/news/blog/easily-migrate-your-oneagent-from-one-tenant-or-server-to-another/) [Infrastructure and Discovery monitoring modes | Dynatrace Docs](https://docs.dynatrace.com/docs/platform-modules/infrastructure-monitoring/hosts/monitoring-modes) [Process deep monitoring | Dynatrace Docs](https://docs.dynatrace.com/docs/platform-modules/infrastructure-monitoring/process-groups/configuration/pg-monitoring) [OneAgent configuration via command-line interface | Dynatrace Docs](https://docs.dynatrace.com/docs/setup-and-configuration/dynatrace-oneagent/oneagent-configuration-via-command-line-interface)   [#18 OneAgentインストール手順～Linux編～](https://www.iim.co.jp/dynatips/018) [#19 OneAgentインストール手順～Windows編～](https://www.iim.co.jp/dynatips/019) [#21 Host Groupの設定手順](https://www.iim.co.jp/dynatips/021)   #52 OneAgentのコマンドラインインターフェース については、以上となります。  お読みいただきありがとうございました！    ※記事執筆時 Dynatrace SaaS Version：1.286 ※2025/10/22 接続先Environmentの変更に関して 　パラメータの変更があったため「変更コマンド」と「※接続先のEnvironment を変更する場合」を修正             [完全な記事を表示](https://www.iim.co.jp/dynatips/052) ```json { "@context" : "http://schema.org", "@type" : "BlogPosting", "author" : { "@type" : "Person", "name" : "城水（IIMサポートチーム）" }, "dateModified" : "2025-10-22T08:09:30.791Z", "datePublished" : "2024-03-31T22:00:00Z", "headline" : "#52 OneAgentのコマンドラインインターフェースご紹介", "image" : { "@type" : "ImageObject", "height" : 1080, "url" : "https://19823358.fs1.hubspotusercontent-na1.net/hubfs/19823358/IIM/%E3%83%96%E3%83%AD%E3%82%B0/Dynatrace%20tips/%E3%82%AD%E3%83%BC%E3%83%93%E3%82%B8%E3%83%A5%E3%82%A2%E3%83%AB/Dynatrace%20Tips%20%E3%82%AD%E3%83%BC%E3%83%93%E3%82%B8%E3%83%A5%E3%82%A2%E3%83%AB_52.png", "width" : 1920 }, "mainEntityOfPage" : "https://www.iim.co.jp/dynatips/052", "publisher" : { "@type" : "Organization", "logo" : { "@type" : "ImageObject", "height" : 60, "url" : "/hs/hsstatic/content_shared_assets/static-1.4092/img/default-amp-logo.png", "width" : 60 }, "name" : "DynatraceTips" } } ```