Download PDF
Download page エージェントのアップグレードとロールバック.
エージェントのアップグレードとロールバック
このページでは、エージェントをアップグレードおよびロールバックする方法について説明します。エージェントをアップグレードおよびロールバックするには、バージョン 21.10.0 以降のエージェントインストーラ API を使用します。
エージェントをアップグレードおよびロールバックするには、systemID
を確認し、アップグレードするエージェントのタイプを確認し、使用可能なエージェントのバージョンを確認します。systemID
は、エージェント インストーラ システムを識別する識別子です。現在、この機能は API を介してのみ使用でき、UI を介しては使用できません。アップグレードおよびロールバックのプロセス中は、次の構成が保持されます。
Java エージェントの設定(Linux):
path: <zero agent path>/java/javaagent/ver***/conf/*.xml
マシンエージェント構成:
path: <zero agent path>/zeroagent/agents/machineagent/conf/logging/log4j.xml
path: <zero agent path>/zeroagent/agents/machineagent/conf/controller-info.xml
path: <zero agent path>/zeroagent/agents/machineagent/monitors
システム情報の確認
エージェントインストーラでインストールされているすべてのシステムを確認します。この API は、1 つのアカウント下に存在するすべての systemIDs
と hostnames
を提供できます。この API は、エージェントインストーラをロールバックするために使用される以前のバージョンのモニタリングエージェントも提供します。
形式:
GET
/maintenance/systemInfos
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/systemInfos' --header 'Authorization: Bearer {AuthToken}'
応答の例:
{
"total": 1,
"items": [
{
"systemId": "1cbcfd90-95ab-4366-b614-1bfab44a9305",
"hostname": "jboss_host",
"applicationName": "HelloWorld",
"rootInstall": true,
"curVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"prevVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
]
}
]
}
エージェントバージョンの確認
以下の API を使用して、アップグレードする最新バージョンを取得します。
形式:
GET /install/agentVersions?latest=true
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/install/agentVersions?latest=true' --header 'Authorization: Bearer {AuthToken}'
応答の例:
{
"total": 1,
"items": [
{
"os": "linux",
"agents": [
{
"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": "infra",
"descriptions": [
{
"version": "21.5.0.1826",
"md5Checksum": "6df412722d125dc058d35d8cd39a39df",
"s3Path": "download-file/infra-agent/21.5.0.1826/appdynamics-infra-agent-linux-64-21.5.0.1826.zip",
"supportsIbl": false
}
]
},
{
"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
}
]
}
]
}
]
}
エージェントバージョンのアップグレード
- これで、
systemIDs
、hostname
、および最新バージョンが用意できたので、以下の API を使用してアップグレードをトリガーします。 リクエストが受け入れられ、
maintenanceID
で応答が返されます。アップグレードは非同期で行われ、アップグレードの進行状況を追跡するにはmaintenanceID
を使用します。形式:
POST /maintenance/upgrade/systems
リクエストの例:
curl --location --request POST 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/upgrade/systems' \ --header 'Authorization: Bearer {AuthToken}' \ --header 'Content-Type: application/json' \ --data-raw { "systemDetails": [ { "systemId": "28f7a681-6010-4150-8940-ebee25841215", "hostname": "hostname1" }, { "systemId": "28f7a681-6010-4150-8940-ebee25841216", "hostname": "hostname2" } ], "versions": [ { "type": "JAVA", "version": "21.7.0.32930" } ] }
CODE入力パラメータ:
Parameter Name
Parameter Type
Value
必須
systemDetails.systemId
本体
エージェント インストーラ システムの
ID
はい
systemDetails.hostname
本体
エージェント インストーラ システムの
Hostname
はい
versions.type
本体
モニタリングエージェントの
Type
はい
versions.verison
本体
アップグレードするモニタリングエージェントの
Versions
はい
応答の例:
{ "maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc", "operation": "UPGRADE", "status": "PENDING", "startedAt": "2021-10-25T18:18:14.166Z", "updatedAt": "2021-10-25T18:18:14.166Z", "maintAgentVersions": [ { "type": "JAVA", "version": "20.3.0.1183" } ], "affectedSystemIds": [ "d601aacc-97a4-479e-b2b3-db095fef34fc" ] }
JSON
アップグレードのロールバック
- アップグレードをロールバックするには、
systemIDs
、hostname
、および以前のバージョンを使用して以下の API をトリガーします。 リクエストが受け入れられ、
maintenanceID
で応答が返されます。ロールバックは非同期で行われ、ロールバックの進行状況を追跡するにはmaintenanceID
を使用します。形式:
POST /maintenance/rollback/systems
リクエストの例:
curl --location --request POST 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/rollback/systems' \ --header 'Authorization: Bearer {AuthToken}' \ --header 'Content-Type: application/' \ --data-raw { "systemDetails": [ { "systemId": "28f7a681-6010-4150-8940-ebee25841215", "hostname": "hostname1" }, { "systemId": "28f7a681-6010-4150-8940-ebee25841216", "hostname": "hostname2" } ], "versions": [ { "type": "JAVA", "version": "21.7.0.32930" } ] }
CODE入力パラメータ:
Parameter Name
Parameter Type
Value
必須
systemDetails.systemId
本体
エージェント インストーラ システムの
ID
はい
systemDetails.hostname
本体
エージェント インストーラ システムの
Hostname
はい
versions.type
本体
モニタリングエージェントの
Type
はい
versions.verison
本体
ロールバックするモニタリングエージェントの以前の
versions
はい
応答の例:
{ "maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc", "operation": "ROLLBACK", "status": "PENDING", "startedAt": "2021-10-25T18:19:28.607Z", "updatedAt": "2021-10-25T18:19:28.607Z", "maintAgentVersions": [ { "type": "JAVA", "version": "20.3.0.1183" } ], "affectedSystemIds": [ "d601aacc-97a4-479e-b2b3-db095fef34fc" ] }
JSON
すべてのメンテナンスリクエスト履歴の取得
この API を使用して、アップグレードとロールバックのリクエスト履歴全体を取得します。この履歴は、個々のシステムのステータスではなく、全体的な maintenance
ステータスを提供します。
形式:
GET /maintenance/history
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/history' --header 'Authorization: Bearer {AuthToken}'
応答の例:
{
"total": 1,
"items": [
{
"maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"operation": "UPGRADE",
"status": "PENDING",
"startedAt": "2021-10-25T18:20:55.196Z",
"updatedAt": "2021-10-25T18:20:55.196Z",
"maintAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"affectedSystemIds": [
"d601aacc-97a4-479e-b2b3-db095fef34fc"
],
"failedSystemMaintenanceIds": [
"d601aacc-97a4-479e-b2b3-db095fef34fc"
]
}
]
}
特定のメンテナンス リクエスト レコードの取得
この API を使用して、maintenanceID
を使用して特定のアップグレードおよびロールバックの maintenance
レコードを取得します。このレコードは、個々のシステムのステータスではなく、全体的なメンテナンスステータスを提供します。
形式:
GET /maintenance/history/{maintenanceId}
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/history/{maintenanceId}' --header 'Authorization: Bearer {AuthToken}'
入力パラメータ:
Parameter Name | Parameter Type | Value | 必須 |
---|---|---|---|
| パス | ロールバックおよびアップグレードのリクエストからの | はい |
応答の例:
{
"maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"operation": "UPGRADE",
"status": "PENDING",
"startedAt": "2021-10-25T18:24:20.640Z",
"updatedAt": "2021-10-25T18:24:20.640Z",
"maintAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"affectedSystemIds": [
"d601aacc-97a4-479e-b2b3-db095fef34fc"
],
"failedSystemMaintenanceIds": [
"d601aacc-97a4-479e-b2b3-db095fef34fc"
]
}
すべてのシステム メンテナンス レコードの取得
この API を使用して、maintenanceId
を使用して特定のメンテナンスリクエストのすべてのシステム メンテナンス ステータスを取得します。
形式:
GET /maintenance/history/{maintenanceId}/systemMaintenances
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/history/{maintenanceId}/systemMaintenances' --header 'Authorization: Bearer {AuthToken}'
入力パラメータ:
Parameter Name | Parameter Type | Value | 必須 |
---|---|---|---|
| パス | ロールバックおよびアップグレードのリクエストからの | はい |
応答の例:
{
"total": 1,
"items": [
{
"systemMaintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"systemId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"hostName": "HostName",
"startedAt": "2021-10-25T18:25:14.754Z",
"updatedAt": "2021-10-25T18:25:14.754Z",
"logsAvailable": false,
"status": "success",
"prevAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"maintAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"curAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"implicitMaintenance": false
}
]
}
特定のシステム メンテナンス レコードの取得
この API を使用して、systemMaintenanceId
を使用して特定のシステム メンテナンス レコードを取得します。
形式:
GET /maintenance/systemMaintenances/{systemMaintenanceId}
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/systemMaintenances/{systemMaintenanceId}' --header 'Authorization: Bearer {AuthToken}'
入力パラメータ:
Parameter Name | Parameter Type | Value | 必須 |
---|---|---|---|
| パス | システム メンテナンス アクティビティの | はい |
応答の例:
{
"systemMaintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"systemId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"hostName": "HostName",
"startedAt": "2021-10-25T18:30:52.377Z",
"updatedAt": "2021-10-25T18:30:52.377Z",
"logsAvailable": false,
"status": "success",
"prevAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"maintAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"curAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"implicitMaintenance": false
}
システムメンテナンス失敗ログの取得
この API を使用して、systemMaintenanceId
を使用して特定のシステム メンテナンス アクティビティの失敗ログを取得します。返されるログは最大 4,096 文字です。文字数がこの制限を超えると、ログが削減されます。
形式:
GET /maintenance/systemMaintenances/{systemMaintenanceId}/log
リクエストの例:
curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/systemMaintenances/{systemMaintenanceId}/log' --header 'Authorization: Bearer {AuthToken}'
入力パラメータ:
Parameter Name | Parameter Type | Value | 必須 |
---|---|---|---|
| パス | システム メンテナンス アクティビティの | はい |