コントローラ監査履歴 API
コントローラの監査履歴は、コントローラの構成の設定とユーザアクティビティのレコードです。ControllerAuditHistory API メソッドは、指定した時間範囲の監査ログを返します。出力形式は、JSON または CSV です。この情報は、audit.log ファイルに記載されている内容と同じです。
「Software as a Service（SaaS）デプロイメント監査ログ」を参照してください。
形式
GET /controller/ ControllerAuditHistory?startTime=<start-time>&endTime=<end-time>&include=<field>:<value>&exclude=<field>:<value>
入力パラメータ
| パラメータ名 | Parameter Type | 値 | 必須 |
|---|---|---|---|
|
start-time |
クエリ |
|
あり |
|
end-time |
クエリ |
y |
あり |
time-zone-id |
[Query（クエリ）] | Time zone | いいえ |
include |
[Query（クエリ）] | コントローラの監査履歴の制限付き情報 | いいえ |
exclude |
[Query（クエリ）] | コントローラの監査履歴の制限付き情報 | いいえ |
- 出力のサイズを制御するには、
start-timeからend-timeまでの範囲が 24 時間を超えないようにします。24 時間よりも長くなる場合は、連続する時間パラメータで複数のクエリを使用します。 - 同じタイプの複数のフィルタが許可されます。
- バックエンド API は、含まれるフィルタを、リレーションシップ
ORと同じ <field> で処理します。 - リレーションシップ
ANDとは異なる <field> でフィルタ処理します。includeフィルタとexcludeフィルタが直接連携することはありません。
- バックエンド API は、含まれるフィルタを、リレーションシップ
- 各フィルタは、
include=filterName1:filterValue1&include=filterName2:filterValue2などのパラメータにする必要があります。以下の例を参照してください。
http://localhost:8080/controller/ControllerAuditHistory?startTime=yyyy-MM-dd&HH:mm:ss.SSSZ&endTime=yyyy-MM-dd&HH:mm:ss.SSSZ?include=filterName1:filterValue1&include=filterName1:filterValue1&exclude=filterName1:filterValue1&exclude=filterName1:filterValue1
curl --user user1@customer1:welcome "http://demo.appdynamics.com:8090/controller/ControllerAuditHistory?startTime=2015-12-19T10:50:03.607-0700&endTime=2015-12-19T17:50:03.607-0700&timeZoneId=America%2FSan%20Francisco&include=userName:user1&include=action:LOGIN&exclude=accountName:system&exclude=action:OBJECT_UPDATE"
[{"timeStamp":1450569821811,"auditDateTime":"2015-12-20T00:03:41.811+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN"},{"timeStamp":1450570234518,"auditDateTime":"2015-12-20T00:10:34.518+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN"},{"timeStamp":1450570273841,"auditDateTime":"2015-12-20T00:11:13.841+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"OBJECT_CREATED","objectType":"AGENT_CONFIGURATION"},
...
{"timeStamp":1450570675345,"auditDateTime":"2015-12-20T00:17:55.345+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"OBJECT_DELETED","objectType":"BUSINESS_TRANSACTION"},{"timeStamp":1450570719240,"auditDateTime":"2015-12-20T00:18:39.240+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"APP_CONFIGURATION","objectType":"APPLICATION","objectName":"ACME Book Store Application"},{"timeStamp":1450571834835,"auditDateTime":"2015-12-20T00:37:14.835+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action
curl --user user1@customer1:welcome "http://127.0.0.1:8080/controller/ControllerAuditHistory?startTime=2019-05-28T08:00:03.607-0700&endTime=2019-05-28T11:32:03.607-0700&timeZoneId=America%2FSan%20Francisco&include=applicationName:ACME"
[{"timeStamp":1559066415823,"auditDateTime":"2019-05-28T18:00:15.823+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN","objectId":0,"applicationName":"ACME"}]
正のタイムゾーンオフセット
+0100、+0530 などの正のタイムゾーンオフセットを指定してコントローラ監査履歴 APIを使用し、監査ログを取得すると、エラーが発生します。
たとえば、UTC+1/CET タイムゾーンにいて、 API を使用して午前 11 時から午後 12 時までの監査ログを取得する場合、 API URL にタイムゾーンを +0100 と入力するとエラーが発生します。
CODE
https://customer1.saas.appdynamics.com/controller/ControllerAuditHistory?startTime=2025-03-25T11:00:00.000+0100&endTime=2025-03-25T12:00:00.000+0100この問題は、 URL のエンコーディングおよび復号化のプロセス中にプラス記号（+）がスペースに変換されるために発生します
回避策：
API の URL で正のタイムゾーンオフセットを使用するには、プラス（+）記号を文字 %2B に置き換える必要があります。変更後の API URL は次のとおりです。
CODE
https://customer1.saas.appdynamics.com/controller/ControllerAuditHistory?startTime=2025-03-25T11:00:00.000%2B0100&endTime=2025-03-25T12:00:00.000%2B0100