PDF
Download PDF
Download page エージェントインストーラ API を使用したエージェントの展開.
エージェントインストーラ API を使用したエージェントの展開
このページでは、エージェントインストーラ API を使用してエージェントを展開する方法について説明します。詳細については、Agent Installer Platform Service APIを参照してください。
Linux は Java およびマシンエージェントをサポートし、Windows はマシンエージェントのみをサポートします。
エージェントバージョンの確認
次の API を使用して、使用可能なエージェントの最新バージョンを取得します。
形式:
GET /install/agentVersions?latest={true|false}&osType={linux|windows}
CODE
Request Example:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/agentVersions?latest=false&osType=linux --header 'Authorization: Bearer {AuthToken}'
CODE
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/agentVersions?latest=false&osType=windows --header 'Authorization: Bearer {AuthToken}'
CODE
応答の例:
{
"total":1,
"items":[
{
"os":"linux",
"agents":[
{
"agentType":"jdk8_plus",
"descriptions":[
{
"version":"22.4.0.33722",
"md5Checksum":"a742e075d31d89d934ec1a571ded3004",
"s3Path":"download-file/java-jdk8/22.4.0.33722/AppServerAgent-1.8-22.4.0.33722.zip",
"supportsIbl":false
}
]
},
{
"agentType":"sun_java",
"descriptions":[
{
"version":"21.8.0.32958",
"md5Checksum":"ca5472b4c6691d65f35399bc61a4c180",
"s3Path":"download-file/sun-jvm/21.8.0.32958/AppServerAgent-21.8.0.32958.zip",
"supportsIbl":false
}
]
},
{
"agentType":"ibm_java",
"descriptions":[
{
"version":"21.8.0.32958",
"md5Checksum":"eb35b7dfb1166c7a20586e30d231f337",
"s3Path":"download-file/ibm-jvm/21.8.0.32958/AppServerAgent-ibm-21.8.0.32958.zip",
"supportsIbl":false
}
]
},
{
"agentType":"machine",
"descriptions":[
{
"version":"21.7.0.3160",
"md5Checksum":"24cd76b6144c56c78063112f154b53bd",
"s3Path":"download-file/machine-bundle/21.7.0.3160/machineagent-bundle-64bit-linux-21.7.0.3160.zip",
"supportsIbl":true
}
]
},
{
"agentType":"zero",
"descriptions":[
{
"version":"21.9.0.569",
"md5Checksum":"720597f2dc67ecf0b5f02b45b51d46ee",
"s3Path":"download-file/zero-agent/21.9.0.569/appdynamics-zero-agent-21.9.0.569.zip",
"supportsIbl":false
}
]
}
]
}
]
}
CODE
{
"total": 1,
"items": [
{
"os": "windows",
"agents": [
{
"agentType": "machine_windows",
"descriptions": [
{
"version": "22.4.0.3344",
"md5Checksum": "f69885445288710284837d6e04e78754",
"s3Path": "download-file/machine-bundle/22.4.0.3344/machineagent-bundle-64bit-windows-22.4.0.3344.zip",
"supportsIbl": true
}
]
},
{
"agentType": "zero_windows",
"descriptions": [
{
"version": "22.5.0.2139",
"md5Checksum": "e03ba2c83b646ebf53e0c2685ab2fce7",
"s3Path": "download-file/zero-agent-windows/22.5.0.2139/appdynamics-zero-agent-windows-64-22.5.0.2139.zip",
"supportsIbl": false
}
]
}
]
}
]
}
CODE
ダウンロードコマンドの取得
上記の API で取得したバージョンを使用して、次の API からダウンロードコマンドを取得します。
形式:
GET /install/downloadCommand?jdk8PlusVersion={jdk8PlusVersion}&javaVersion={javaVersion}&machineVersion={machineVersion}&zeroVersion={zeroVersion}&multiline={true|false}&osType={windows|linux}
CODE
リクエストの例:
Java Agent Legacy:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/downloadCommand?javaVersion=latest&machineVersion=21.10.0.3188&zeroVersion=latest&multiline=true&osType=linux' --header 'Authorization: Bearer {AuthToken}'
Java JDK8+:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/downloadCommand?jdk8PlusVersion=22.4.0.33722&machineVersion=latest&zeroVersion=latest&multiline=true&osType=linux' --header 'Authorization: Bearer {AuthToken}'
CODE
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/downloadCommand?machineVersion=21.10.0.3188&zeroVersion=latest&multiline=true&osType=windows' --header 'Authorization: Bearer {AuthToken}'
CODE
応答の例:
Java Agent Legacy:
[
"cd $(mktemp -d -t appd-zero-XXXXXXX)",
"&& curl https://download-files.saas.appdynamics.com/download-file/zero-agent-bootstrap/22.2.0.1462/appdynamics-zero-agent-bootstrap-22.2.0.1462.sh -o zero-agent.sh",
"&& chmod +x zero-agent.sh",
"&& ./zero-agent.sh download sun-java -u https://download-files.saas.appdynamics.com -v 22.1.0.33445 -c ced8b1d5d8739753df9de6a5465a1431",
"&& ./zero-agent.sh download ibm-java -u https://download-files.saas.appdynamics.com -v 22.1.0.33445 -c 70a2017fbc722844b7dc61efd516a962",
"&& ./zero-agent.sh download machine -u https://download-files.saas.appdynamics.com -v 21.10.0.3188 -c 186b1fc26f8a2626269cd54cadf45e1e",
"&& ./zero-agent.sh download zero -u https://download-files.saas.appdynamics.com -v 22.2.0.1462 -c 318aa43165c8279bbffacd1c4120d1cd"
]
Java JDK8+:
[
"cd $(mktemp -d -t appd-zero-XXXXXXX)",
"&& curl https://download-files.saas.appd-test.com/download-file/zero-agent-bootstrap/22.5.0.2139/appdynamics-zero-agent-bootstrap-22.5.0.2139.sh -o zero-agent.sh",
"&& chmod +x zero-agent.sh",
"&& ./zero-agent.sh download java -u https://download-files.saas.appd-test.com -v 22.4.0.33722 -c a742e075d31d89d934ec1a571ded3004",
"&& ./zero-agent.sh download machine -u https://download-files.saas.appd-test.com -v 22.4.0.3344 -c 1192a1bfaf8100b7e4ef22769b9ced32",
"&& ./zero-agent.sh download zero -u https://download-files.saas.appd-test.com -v 22.5.0.2139 -c 2b99ade1c22374c21578296412827128"
]
CODE
[
"$ProgressPreference = 'SilentlyContinue';",
"$tmpfolder = Join-Path ([System.IO.Path]::GetTempPath()) appd-zero-$([System.IO.Path]::GetRandomFileName());",
"New-Item -ItemType Directory -Force -Path $tmpfolder | out-null;",
"Set-Location -Path $tmpfolder;",
"Invoke-WebRequest https://download-files.saas.appdynamics.com/download-file/zero-agent-bootstrap/22.2.0.1462/appdynamics-zero-agent-bootstrap-22.2.0.1462.ps1 -OutFile zero-agent.ps1;",
"Set-ExecutionPolicy ByPass -Force -Scope CurrentUser;",
".\\zero-agent.ps1 download machine -u https://download-files.saas.appdynamics.com -v 21.10.0.3188 -c bd3d78a412b66f7d0a08cd6f856abb89;",
".\\zero-agent.ps1 download zero -u https://download-files.saas.appdynamics.com -v 22.2.0.1462 -c b9a6f11027f485468ba8224bf60586c6;"
]
CODE
インストールコマンドの取得
アプリケーション名に一重引用符(')を含めることはできません。エージェントインストーラを使用して Java JDK8+ をインストールすると、OpenTelemetry リソース属性 service.namespace
および service.name
が AppDynamics アプリケーション名と階層名にマップされます。
コマンドを実行すると、新しい一時ディレクトリに移動します。次の API からコマンドを取得し、同じディレクトリから実行します。
形式:
GET /install/installCommand?sudo={true|false}&application={appName}&accessKey={accessKey}&serviceUrl={serviceUrl}&osType={windows|linux}&otelEnabled={true|false}&tracesExporter={tracesExporter}&metricsExporter={metricsExporter}&otlpEndpoint={collectorEndpoint}&simEnabled={true|false}&dotnetCompatibility={true|false}
CODE
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/installCommand?sudo=true&application=helloWorld&accessKey=fb19d1d6-6858-5fea-b6ed-302480e5c580&serviceUrl=https://demo.saas.appdynamics.com&osType=linux&otelEnabled=true&tracesExporter=otlp,logging&metricsExporter=otlp,logging&otlpEndpoint=https://demo.saas.appdynamics.com/otlp-collector&simEnabled=true' --header 'Authorization: Bearer {AuthToken}'
CODE
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/installCommand?application=helloWorld&accessKey=fb19d1d6-6858-5fea-b6ed-302480e5c580&serviceUrl=https://demo.saas.appdynamics.com&osType=windows&simEnabled=true&dotnetCompatibility=true' --header 'Authorization: Bearer {AuthToken}'
CODE
応答の例:
[
"sudo ./zero-agent.sh install --application 'helloWorld' --account 'demo' --access-key 'fb19d1d6-6858-5fea-b6ed-302480e5c580' --service-url 'https://demo.saas.appdynamics.com' --enable-sim 'true' --enable-otel 'true' --traces-exporter 'otlp,logging' --metrics-exporter 'otlp,logging' --otlp-endpoint 'https://demo.saas.appdynamics.com/otlp-collector'"
]
CODE
[
".\\zero-agent.ps1 install --application 'helloWorld' --account 'demo' --access-key 'fb19d1d6-6858-5fea-b6ed-302480e5c580' --service-url 'https://demo.saas.appdynamics.com' --enable-sim 'true' --dotnet-compatibility 'true'"
]
CODE