エージェントバージョンのアップグレード

systemIDsこれで hostname、、および最新バージョンが用意できたので、API を使用してアップグレードをトリガーします。maintenanceIDリクエストが受け入れられると、を受け取ります。アップグレードは非同期で行われ、maintenanceID を使用してアップグレードの進行状況を追跡できます。

警告: 構成の指定はオプションです。何も追加しない場合、エージェントインストーラで現在実行されている構成が使用されます。Java Agent Legacy から Java Agent JKD8+ にアップグレードできますが、Java Agent JDK8+ から Java Agent Legacy にアップグレードすることはできません。

形式:

POST /maintenance/upgrade/systems

要求の例：

Linuxの場合：

{
"systemDetails": [
{
"systemId": "28f7a681-6010-4150-8940-ebee25841215",
"hostname": "hostname1"
},
{
"systemId": "28f7a681-6010-4150-8940-ebee25841216",
"hostname": "hostname2"
}
],
"versions": [
{
"type": "JDK8_PLUS",
"version": "22.4.0.33722"
},
{
"type": "MACHINE",
"version": "22.4.0.3344"
}
],
"configurations": {
"enableOtel": true,
"otelProperties": {
"tracesExporter": "otlp,logging",
"metricsExporter": "otlp,logging",
"otlpEndpoint": "http://localhost:4317"
},
"enableSim": true
}
}

Windowsの場合：

{
"systemDetails": [
{
"systemId": "c44f978d-8db6-452f-9387-9b852d8df03a",
"hostname": "windows_host"
}
],
"versions": [
{
"type": "MACHINE_WINDOWS",
"version": "22.4.0.3344"
}
],
"configurations": {
"enableSim": true,
"dotnetCompaibility": true
}
}

入力パラメータ：


パラメータ名	Parameter Type	説明	必須
`systemDetails.systemId`	本体	エージェントインストーラシステムの。	あり
`systemDetails.hostname`		エージェントインストーラシステムの
`versions.type`		モニタリングエージェントのタイプ
`versions.verison`		アップグレードするモニタリングエージェントの
`configurations.enableOtel`		Java Agent JDK8+ の OpenTelementry を有効にするための構成。	いいえ
`configurations.otelProperties`		OpenTelemetry エクスポータの構成。	はい（ `enableOtel` が `true`の場合のみ）
`configurations.otelProperties.tracesExporter`		OpenTelemetry トレースエクスポータの構成。サポートされる値`otlplogging`
`configurations.otelProperties.metricsExporter`		OpenTelemetry メトリックエクスポータの構成。サポートされる値`otlplogging`
`configurations.otelProperties.otlpEndpoint`		OpenTelemetry OTLP Collector エンドポイントの構成。
`configurations.enableSim`		マシンエージェントでサーバーの可視性を有効にするための構成。	いいえ
`configurations.dotnetCompatibility`		マシンエージェントで .NET 互換モードを有効にするための構成。	いいえ

応答例：

Linuxの場合：

{
"maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"operation": "UPGRADE",
"status": "PENDING",
"startedAt": "2022-05-06T17:46:04.743Z",
"updatedAt": "2022-05-06T17:46:04.743Z",
"applicationName": null,
"maintAgentVersions": [
{
"type": "JDK8_PLUS",
"version": "22.4.0.33722"
},
{
"type": "MACHINE",
"version": "22.4.0.3344"
}
],
"affectedSystemIds": [
"28f7a681-6010-4150-8940-ebee25841215",
"28f7a681-6010-4150-8940-ebee25841216"
],
"username": "demo_user",
"configurations": {
"enableOtel": true,
"otelProperties": {
"tracesExporter": "otlp,logging",
"metricsExporter": "otlp,logging",
"otlpEndpoint": "http://localhost:4317"
},
"enableSim": true,
"dotnetCompatibility": null
}
}

Windowsの場合：

{
"maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fd",
"operation": "UPGRADE",
"status": "PENDING",
"startedAt": "2022-05-11T17:46:04.743Z",
"updatedAt": "2022-05-11T17:46:04.743Z",
"applicationName": null,
"maintAgentVersions": [
{
"type": "MACHINE_WINDOWS",
"version": "22.4.0.3344"
}
],
"affectedSystemIds": [
"c44f978d-8db6-452f-9387-9b852d8df03a"
],
"username": "demo_user",
"configurations": {
"enableSim": true,
"dotnetCompatibility": true
}
}