すべてのプロダクト
Search

このプロダクト

    Application Real-Time Monitoring Service:GetTraceAppConfig

    ドキュメントセンター

    Application Real-Time Monitoring Service:GetTraceAppConfig

    最終更新日:Apr 10, 2026

    Application Monitoring によって監視されているアプリケーションのすべてのカスタム設定 (トレースサンプリング設定やエージェントスイッチなど) を照会します。この操作は、Application Monitoring によって監視されているアプリケーションにのみ適用されます。OpenTelemetry 向けマネージドサービスによって監視されているアプリケーションには適用されません。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Pid

    string

    必須

    アプリケーションのプロセス ID (PID) です。

    以下のいずれかの方法で PID を取得できます：

    • API： ListTraceApps 操作を呼び出します

    • コンソール： Application Real-Time Monitoring Service (ARMS) コンソールにログインします。左側のナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーションリスト] を選択します。アプリケーションリストページで、ご利用のアプリケーションの名前をクリックします。アドレスバーの URL には、アプリケーションの PID が含まれています。PID は `pid=xxx` の形式で示されます。PID は通常、`xxx%40xxx` のようにパーセントエンコーディングされています。この値を変更して、パーセントエンコーディングを削除する必要があります。たとえば、URL の PID が `xxx%4074xxx` の場合、`%40` をアットマーク (@) に置き換えて `xxx@74xxx` を取得する必要があります。

    説明

    • コンソールで PID を取得するには、ご利用のアプリケーションが OpenTelemetry 向けマネージドサービスではなく、アプリケーションモニタリングによって監視されている必要があります。

    • GetTraceAppConfig 操作は、アプリケーションモニタリングによって監視されているアプリケーションのカスタム設定のみを照会できます。

    a2n80plglh@745eddxxx

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ

    RequestId

    string

    リクエスト ID です。

    78901766-3806-4E96-8E47-CFEF59E4****

    Data

    string

    アプリケーションのカスタム設定です。JSON 文字列形式です。詳細については、レスポンスパラメーターの追加説明をご参照ください。

    {"profiler":{"enable":true}}
    Message

    string

    返されたメッセージです。

    查询应用配置成功
    Code

    integer

    HTTP ステータスコードです。

    有効な値：

    • 2xx：リクエストは成功しました。

    • 3xx：リクエストはリダイレクトされました。

    • 4xx：リクエストエラーが発生しました。

    • 5xx：サーバーエラーが発生しました。

    列挙値:

    • 2xx :
    • 3xx :
    • 4xx :
    • 5xx :

    200
    Success

    boolean

    リクエストが成功したかどうかを示します。

    有効な値：

    • true

    • false

    列挙値:

    • true :
    • false :

    true

    以下の表は、各カスタム設定に対応する JSONPath パラメーターを示しています。注意：一部のカスタム設定は、変更されるタイミングが異なるため、レスポンスで返されない場合があります。この場合、デフォルト値が有効になります。

    サンプリング設定

    設定JSONPathタイプ説明デフォルト値
    サンプリングポリシーprofiler.sampling.useSamplingStrategyV2boolean有効な値：
    - true：適応型サンプリング
    - false：固定レートサンプリング

    		false
    サンプリングレートprofiler.sampling.ratedouble0%～100%
    この設定は固定レートサンプリングで有効になります。
    		10
    フルコレクション用の API エンドポイントprofiler.sampling.v2config.spanNames4FullSampleStrStringトレースデータが収集される API エンドポイントです。複数の値をコンマ (,) で区切ります。""
    フルコレクション用の API エンドポイントプレフィックスprofiler.sampling.v2config.spanNamePrefixes4FullSampleStrStringトレースデータが収集される API エンドポイントのプレフィックスです。""
    フルコレクション用の API エンドポイントサフィックスprofiler.sampling.v2config.spanNameSuffixes4FullSampleStrStringトレースデータが収集される API エンドポイントのサフィックスです。""

    エージェントスイッチ設定

    設定JSONPathタイプ説明デフォルト値
    アプリケーションモニタリングスイッチprofiler.enableboolean有効な値：
    - true：アプリケーションモニタリングを有効にします
    - false：アプリケーションモニタリングを無効にします

    		true
    Dubbo プラグインスイッチprofiler.dubbo.enableboolean有効な値：
    - true：Dubbo プラグインを有効にします
    - false：Dubbo プラグインを無効にします

    		true
    MongoDB プラグインスイッチprofiler.mongodb.enableboolean有効な値：
    - true：MongoDB プラグインを有効にします
    - false：MongoDB プラグインを無効にします

    		true
    HSF プラグインスイッチprofiler.hsf.enableboolean有効な値：
    - true：HSF プラグインを有効にします
    - false：HSF プラグインを無効にします

    		true
    HttpClient 3 プラグインスイッチprofiler.httpclient3.enableboolean有効な値：
    - true：HttpClient 3 プラグインを有効にします
    - false：HttpClient 3 プラグインを無効にします

    		true
    HttpClient 4 プラグインスイッチprofiler.httpclient4.enableboolean有効な値：
    - true：HttpClient 4 プラグインを有効にします
    - false：HttpClient 4 プラグインを無効にします

    		true
    JDK HTTP プラグインスイッチprofiler.jdkhttp.enableboolean有効な値：
    - true：JDK HTTP プラグインを有効にします
    - false：JDK HTTP プラグインを無効にします

    		true
    Jetty プラグインスイッチprofiler.jetty.enableboolean有効な値：
    - true：Jetty プラグインを有効にします
    - false：Jetty プラグインを無効にします

    		true
    MyBatis プラグインスイッチprofiler.mybatis.enableboolean有効な値：
    - true：MyBatis プラグインを有効にします
    - false：MyBatis プラグインを無効にします

    		true
    MySQL プラグインスイッチprofiler.mysql.enableboolean有効な値：
    - true：MySQL プラグインを有効にします
    - false：MySQL プラグインを無効にします

    		true
    OkHttp プラグインスイッチprofiler.okhttp.enableboolean有効な値：
    - true：OkHttp プラグインを有効にします
    - false：OkHttp プラグインを無効にします

    		true
    Oracle プラグインスイッチprofiler.oracle.enableboolean有効な値：
    - true：Oracle プラグインを有効にします
    - false：Oracle プラグインを無効にします

    		true
    PostgreSQL プラグインスイッチprofiler.postgresql.enableboolean有効な値：
    - true：PostgreSQL プラグインを有効にします
    - false：PostgreSQL プラグインを無効にします

    		true
    Redis プラグインスイッチprofiler.redis.enableboolean有効な値：
    - true：Redis プラグインを有効にします
    - false：Redis プラグインを無効にします

    		true
    Spring プラグインスイッチprofiler.spring.enableboolean有効な値：
    - true：Spring プラグインを有効にします
    - false：Spring プラグインを無効にします

    		true
    Spring Boot プラグインスイッチprofiler.springboot.enableboolean有効な値：
    - true：Spring Boot プラグインを有効にします
    - false：Spring Boot プラグインを無効にします

    		true
    Tomcat プラグインスイッチprofiler.tomcat.enableboolean有効な値：
    - true：Tomcat プラグインを有効にします
    - false：Tomcat プラグインを無効にします

    		true
    Lettuce プラグインスイッチprofiler.lettuce.enableboolean有効な値：
    - true：Lettuce プラグインを有効にします
    - false：Lettuce プラグインを無効にします

    		true
    gRPC プラグインスイッチprofiler.grpc.enableboolean有効な値：
    - true：gRPC プラグインを有効にします
    - false：gRPC プラグインを無効にします

    		true
    Thrift プラグインスイッチprofiler.thrift.enableboolean有効な値：
    - true：Thrift プラグインを有効にします
    - false：Thrift プラグインを無効にします

    		true
    Hystrix プラグインスイッチprofiler.hystrix.enableboolean有効な値：
    - true：Hystrix プラグインを有効にします
    - false：Hystrix プラグインを無効にします

    		true
    RxJava プラグインスイッチprofiler.rxjava.enableboolean有効な値：
    - true：RxJava プラグインを有効にします
    - false：RxJava プラグインを無効にします

    		true
    Memcached プラグインスイッチprofiler.memcached.enableboolean有効な値：
    - true：Memcached プラグインを有効にします
    - false：Memcached プラグインを無効にします

    		true
    Druid プラグインスイッチprofiler.jdbc.druid.enableboolean有効な値：
    - true：Druid プラグインを有効にします
    - false：Druid プラグインを無効にします

    		true
    WebLogic プラグインスイッチprofiler.weblogic.enableboolean有効な値：
    - true：WebLogic プラグインを有効にします
    - false：WebLogic プラグインを無効にします

    		true
    ElasticJob プラグインスイッチprofiler.elasticjob.enableboolean有効な値：
    - true：ElasticJob プラグインを有効にします
    - false：ElasticJob プラグインを無効にします

    		true
    Elasticsearch プラグインスイッチprofiler.elasticsearch.enableboolean有効な値：
    - true：Elasticsearch プラグインを有効にします
    - false：Elasticsearch プラグインを無効にします

    		true
    HikariCP プラグインスイッチprofiler.jdbc.hikaricp.enableboolean有効な値：
    - true：HikariCP プラグインを有効にします
    - false：HikariCP プラグインを無効にします

    		true
    InfluxDB プラグインスイッチprofiler.influxdb.enableboolean有効な値：
    - true：InfluxDB プラグインを有効にします
    - false：InfluxDB プラグインを無効にします

    		true
    Kafka プラグインスイッチprofiler.kafka.enableboolean有効な値：
    - true：Kafka プラグインを有効にします
    - false：Kafka プラグインを無効にします

    		true
    Netty プラグインスイッチprofiler.netty.enableboolean有効な値：
    - true：Netty プラグインを有効にします
    - false：Netty プラグインを無効にします

    		true
    Play プラグインスイッチprofiler.play.enableboolean有効な値：
    - true：Play プラグインを有効にします
    - false：Play プラグインを無効にします

    		true
    Reactor プラグインスイッチprofiler.reactor.enableboolean有効な値：
    - true：Reactor プラグインを有効にします
    - false：Reactor プラグインを無効にします

    		true
    Redisson プラグインスイッチprofiler.redis.redisson.enableboolean有効な値：
    - true：Redisson プラグインを有効にします
    - false：Redisson プラグインを無効にします

    		true
    RabbitMQ プラグインスイッチprofiler.rabbitmq.client.enableboolean有効な値：
    - true：RabbitMQ プラグインを有効にします
    - false：RabbitMQ プラグインを無効にします

    		true
    SchedulerX プラグインスイッチprofiler.schedulerx.enableboolean有効な値：
    - true：SchedulerX プラグインを有効にします
    - false：SchedulerX プラグインを無効にします

    		true
    Undertow プラグインスイッチprofiler.undertow.enableboolean有効な値：
    - true：Undertow プラグインを有効にします
    - false：Undertow プラグインを無効にします

    		true
    Vert.x プラグインスイッチprofiler.vertx.enableboolean有効な値：
    - true：Vert.x プラグインを有効にします
    - false：Vert.x プラグインを無効にします

    		true
    XXL-JOB プラグインスイッチprofiler.xxljob.enableboolean有効な値：
    - true：XXL-JOB プラグインを有効にします
    - false：XXL-JOB プラグインを無効にします

    		true
    ONS Client プラグインスイッチprofiler.onsclient.enableboolean有効な値：
    - true：ONS Client プラグインを有効にします
    - false：ONS Client プラグインを無効にします

    		true
    Quartz プラグインスイッチprofiler.quartz.enableboolean有効な値：
    - true：Quartz プラグインを有効にします
    - false：Quartz プラグインを無効にします

    		true
    Servlet プラグインスイッチprofiler.servlet.enableboolean有効な値：
    - true：Servlet プラグインを有効にします
    - false：Servlet プラグインを無効にします

    		true
    Liberty プラグインスイッチprofiler.liberty.enableboolean有効な値：
    - true：Liberty プラグインを有効にします
    - false：Liberty プラグインを無効にします

    		true
    Akka プラグインスイッチprofiler.akka.enableboolean有効な値：
    - true：Akka プラグインを有効にします
    - false：Akka プラグインを無効にします

    		true
    Cassandra プラグインスイッチprofiler.cassandra.enableboolean有効な値：
    - true：Cassandra プラグインを有効にします
    - false：Cassandra プラグインを無効にします

    		true
    OpenTelemetry プラグインスイッチprofiler.opentelemetry.enableboolean有効な値：
    - true：OpenTelemetry プラグインを有効にします
    - false：OpenTelemetry プラグインを無効にします

    		true
    Google HTTP Client プラグインスイッチprofiler.googlehttpclient.enableboolean有効な値：
    - true：Google HTTP Client プラグインを有効にします
    - false：Google HTTP Client プラグインを無効にします

    		true
    Ning プラグインスイッチprofiler.ning.asynchttpclient.enableboolean有効な値：
    - true：Ning プラグインを有効にします
    - false：Ning プラグインを無効にします

    		true

    スレッドプロファイリング設定

    設定JSONPathタイプ説明デフォルト値
    スレッドプロファイリングスイッチprofiler.tprof.enableJvmThreadStatisticboolean有効な値：
    - true：スレッドプロファイリングを有効にします
    - false：スレッドプロファイリングを無効にします

    		true
    ローカルメソッドスタックを定期的に保存するためのスイッチprofiler.tprof.enableThreadStackRecorderboolean有効な値：
    - true：ローカルメソッドスタックの定期的なストレージを有効にします
    - false：ローカルメソッドスタックの定期的なストレージを無効にします

    		false
    時間のかかる呼び出しのしきい値profiler.tprof. threadProfilerSlowInteractionRtint単位：ms。持続時間がしきい値を超えると、ローカルメソッドスタックが自動的に保存されます。2000

    アプリケーションログの関連付け設定

    設定JSONPathタイプ説明デフォルト値
    ログソースprofiler.logSourceString有効な値：
    - sls：Simple Log Service
    		sls
    ビジネスログとトレース ID を自動的に関連付けるためのスイッチprofiler.logging.enableboolean有効な値：
    - true：ビジネスログとトレース ID の関連付けを有効にします
    - false：ビジネスログとトレース ID の関連付けを無効にします

    		true
    ログにトレース ID を自動的に入力するためのスイッチprofiler.logging.injectTraceId2Log.enableboolean有効な値：
    - true：ログへのスパン ID の自動入力を有効にします
    - false：ログへのスパン ID の自動入力を無効にします
    この設定は、ARMS エージェント V4.1.6 以降で有効になります。


    		true
    ログにスパン ID を自動的に入力するためのスイッチprofiler.logging.injectSpanId2Log.enableboolean有効な値：
    - true：ログへのスパン ID の自動入力を有効にします
    - false：ログへのスパン ID の自動入力を無効にします
    この設定は、ARMS エージェント V4.1.6 以降で有効になります。


    		true
    Simple Log Service の関連付け - リージョンprofiler.SLS.regionIdString関連付けられたログソースが存在するリージョンです。""
    Simple Log Service の関連付け - プロジェクトprofiler.SLS.projectString関連付けられたログソースが属するプロジェクトです。""
    Simple Log Service の関連付け - Logstoreprofiler.SLS.logStoreString関連付けられたログソースが属する Logstore です。""
    Simple Log Service の関連付け - インデックスprofiler.SLS.indexString関連付けられたログソースのインデックスです。""

    URL 収束設定

    設定JSONPathタイプ説明デフォルト値
    収束 URLprofiler.convergence.enableboolean有効な値：
    - true：URL 収束機能を有効にします
    - false：URL 収束機能を無効にします

    		true
    収束しきい値profiler.convergence.minServerSizelongしきい値に達すると URL が収束します。1000
    収束ルールprofiler.convergence.patternString各ルールは正規表現です。
    例：/service/(.*?)/demo。
    複数のルールをコンマ (,) で区切ります。

    		""

    Arthas 設定

    設定JSONPathタイプ説明デフォルト値
    Arthas スイッチprofiler.arthas.enableboolean有効な値：
    - true：Arthas 診断機能を有効にします
    - false：Arthas 診断機能を無効にします

    		false
    リアルタイムで有効な IP アドレスprofiler.arthas.enableIpsstringArthas 診断機能が有効になっている IP アドレスです。複数の IP アドレスをコンマ (,) で区切ります。
    空の文字列は、すべての IP アドレスに対して Arthas 診断機能が有効であることを示します。
    		""

    継続的プロファイリング設定

    設定JSONPathタイプ説明デフォルト値
    スイッチprofiler.cp.enableboolean有効な値：
    - true：継続的プロファイリング機能を有効にします
    - false：継続的プロファイリング機能を無効にします
    * スイッチをオンにすると、次の表に示すように 2 つの構成モードが利用可能になります。


    		false
    CPU ホットスポットprofiler.cp.cpuEnableboolean有効な値：
    - true：CPU ホットスポット機能を有効にします
    - false：CPU ホットスポット機能を無効にします

    		false
    メモリホットスポットprofiler.cp.allocEnableboolean有効な値：
    - true：メモリホットスポット機能を有効にします
    - false：メモリホットスポット機能を無効にします

    		false
    コードホットスポットprofiler.cp.wallClockEnableboolean有効な値：
    - true：コードホットスポット機能を有効にします
    - false：コードホットスポット機能を無効にします

    		false
    モードキーフィールド値
    IP アドレスホワイトリストcp.allowIPsIP アドレスホワイトリスト継続的プロファイリングが有効になっているインスタンスの IP アドレスです。複数の値をコンマ (,) で区切ります。
    例：192.168.0.1,192.168.0.2
    cp.allowNetworkCIDR ブロック空の文字列を指定します。そうしないと、この機能は正常に動作しません。
    CIDR ブロックcp.allowIPsIP アドレスホワイトリスト空の文字列を指定します。そうしないと、この機能は正常に動作しません。
    cp.allowNetworkCIDR ブロック継続的プロファイリングが有効になっているインスタンスの CIDR ブロックです。
    例：192.168.2.0/24/24

    データマスキング設定

    設定JSONPathタイプ説明デフォルト値
    データマスキングスイッチprofiler.sanitizer.enableboolean有効な値：
    - true：データマスキング機能を有効にします
    - false：データマスキング機能を無効にします

    		true
    データマスキングルールprofiler.sanitizer.keysString指定された用語を含む機密キーの大文字と小文字を区別しないマッチング。複数の IP アドレスをコンマ (,) で区切ります。true

    操作呼び出し設定

    設定JSONPathタイプ説明デフォルト値
    低速リクエストしきい値profiler.thresholds.interfacelong単位：ms。応答時間がこのしきい値を超えると、リクエストは低速としてマークされます。500
    例外ホワイトリストprofiler.exception.whitelistString例外名の正規表現を指定します。一致する例外は統計チャートから除外されます。複数のルールをコンマ (,) で区切ります。""
    親クラスの継承による例外フィルタリングprofiler.exception.filterByParentClassboolean有効な値：
    - true：機能を有効にします
    - false：機能を無効にします
    機能を有効にすると、例外フィルタリングで親例外を構成できます。
    この設定は、ARMS エージェント V4.1.6 以降で有効になります。



    		true
    HTTP ステータスコードホワイトリストprofiler.error.skipString無視する HTTP ステータスコードです。複数の値をコンマ (,) で区切ります。""
    無効な API 呼び出しのフィルタリングprofiler.defined.excludeurlString無視される API 呼び出しです。各ルールは正規表現です。複数の値をコンマ (,) で区切ります。/**/*.jpg,/**/*.png,/**/*.js,
    /**/*.jpeg,/**/*.pdf,/**/*.xlsx,
    /**/*.txt,/**/*.docs,/**/*.gif,
    /**/*.csv


    データベース呼び出し設定

    設定JSONPathタイプ説明デフォルト値
    低速 SQL クエリしきい値profiler.thresholds.sqllong単位：ms。SQL クエリの持続時間がしきい値を超えると、クエリは低速としてマークされます。500
    SQL キャプチャの最大保持長profiler.callsql.maxLengthlongSQL ステートメントの値がしきい値を超えると、SQL ステートメントは切り捨てられます。1024
    SQL ステートメントにバインド変数を表示するためのスイッチprofiler.jdbc.tracesqlbindvalueboolean有効な値：
    - true：機能を有効にします
    - false：機能を無効にします
    このスイッチをオンにすると、PrepareStatement パラメーターにバインドされた変数値がキャプチャされ、ページに表示されます。MySQL のみがサポートされています。


    		false
    SQL ステートメントに定数を表示するためのスイッチprofiler.jdbc. tracesqlrawboolean有効な値：
    - true：機能を有効にします
    - false：機能を無効にします
    機能を有効にすると、生の SQL ステートメントがキャプチャされます。


    		false

    トレースプロトコル設定

    注意：コンテキスト伝播プロトコルの設定は、ARMS エージェント V4.1.x 以降でのみ有効です。

    設定JSONPathタイプ説明デフォルト値
    コンテキスト伝播プロトコルprofiler.trace.protocol.nameString有効な値：
    - Unset：未設定
    - W3C：OpenTelemetry W3C
    - SkyWalking
    - Zipkin：Zipkin B3
    - Jaeger
    - EagleEye





    		Unset
    コンテキスト伝播モードprofiler.trace.protocol. strategyString有効な値：
    - PriorityUse
    - ForceUse

    		PriorityUse

    詳細設定

    設定JSONPathタイプ説明デフォルト値
    エージェントが 1 秒あたりに収集するトレースの最大数profiler.thresholds.limitint高トラフィック時にトレース収集がビジネス運用に影響を与えないようにするための保護措置です。100
    メソッドスタックの保持制限profiler.callstack.maxLengthintメソッドスタックの長さがしきい値を超えると、収集中にメソッドスタックが切り捨てられます。
    この設定は、ARMS エージェント V4.0.0 以降では非推奨です。
    		128
    同じタイプの例外のスタックの深さprofiler.exception.stacktraceintシステムが同じタイプの例外を識別するためのスタックの深さです。2
    リクエストパラメーターの最大表示長profiler.param.maxLengthintリクエストパラメーターの最大表示長です。512
    カスタム RabbitMQ コンシューマーprofiler.rabbitmq.client.consumer.classesStringRabbitMQ コンシューマーの完全修飾クラス名です。複数のコンシューマーをコンマ (,) で区切ります。
    この設定は、ARMS エージェント V4.0.0 以降では非推奨です。
    		""
    カスタム Kafka 消費メソッドprofiler.kafka.consumer.entryPointStringKafka コンシューマーの消費メソッドです。
    この設定は、ARMS エージェント V4.0.0 以降では非推奨です。
    		""
    Kafka がメッセージを送信するときにコンテキストを自動的に伝播するためのスイッチprofiler.kafka.enableInjectKafkaHeadersbooleanKafka メッセージにトレースヘッダーを自動的に挿入して、送信トレースと消費トレースを関連付けるかどうかを指定します。
    この設定は、ARMS エージェント V4.0.0 以降では非推奨です。
    		false
    非同期伝播のパッケージ名profiler.thread.match.packageString指定されたパッケージの下で Runnable、Callable、Supplier が作成されると、トレースコンテキストが自動的にキャプチャされ、新しいスレッドに伝播されます。複数のパッケージ名をコンマ (,) で区切ります。
    この設定は、ARMS エージェント V4.0.0 以降では非推奨です。
    		""
    HTTP レスポンスへのトレース ID の包含profiler.responseInject.enableboolean有効な値：
    - true：機能を有効にします
    - false：機能を無効にします

    		false

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "78901766-3806-4E96-8E47-CFEF59E4****\n",
  "Data": "{\"profiler\":{\"enable\":true}}",
  "Message": "查询应用配置成功",
  "Code": 200,
  "Success": true
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ParameterPidMissing You must specify pid.
    500 InternalError Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries.
    404 AppNotExist The application does not exist.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。