コントローラの監査履歴は、コントローラの構成の設定とユーザアクティビティのレコードです。ControllerAuditHistory API メソッドは、指定した時間範囲の監査ログを返します。出力形式は JSON または CSV です。この情報は、audit.log ファイルに記載されている内容と同じです。「プラットフォームログファイル」および「プラットフォーム別のログファイル情報」を参照してください。

形式

GET /controller/ ControllerAuditHistory?startTime=<start-time>&endTime=<end-time>&include=<field>:<value>&exclude=<field>:<value>

入力パラメータ

Parameter Name

Parameter Type

Value

必須

start-time

[Query（クエリ）]

yyyy-MM-dd'T'HH:mm:ss.SSSZ 形式の開始時刻

あり

end-time

[Query（クエリ）]

yyyy-MM-dd'T'HH:mm:ss.SSSZ 形式の終了時刻

あり

time-zone-id[Query（クエリ）]Time zoneなし
include[Query（クエリ）]コントローラの監査履歴の制限付き情報なし
exclude[Query（クエリ）]コントローラの監査履歴の制限付き情報なし
  • 出力のサイズを制御するには、start-time から end-time までの範囲が 24 時間を超えないようにします。24 時間よりも長くなる場合は、連続する時間パラメータで複数のクエリを使用します。
  • 同じタイプの複数のフィルタが許可されます。 
    • バックエンド API は、含まれるフィルタを、リレーションシップ OR と同じ <field> で処理します。
    • リレーションシップ AND とは異なる <field> でフィルタ処理します。include フィルタと exclude フィルタが直接連携することはありません。
  • 各フィルタはパラメータにする必要があります（例： 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"}]