Download PDF
Download page コントローラ監査ログ.
コントローラ監査ログ
この監査機能は、audit.log
ファイルを作成します。コントローラ内のユーザーアクティビティと構成変更をモニターするために使用されるファイルです。この情報は、次のアクションによって取得されます。
コントローラ監査レポートのスケジュール設定
スケジュールされたレポートを表示および構成するには、アカウントレベルの権限が必要です。このレポートを使用して、ユーザ情報、コントローラ構成、およびアプリケーションプロパティに加えられた変更を表示します。
[Dashboards & Reports ] > [ Reports ] > [ Add Report] の順にクリックします。
[Report Title] と [Report Subtitle] を入力します。
[Report Subtitle] を使用して、レポートに CONFIDENTIAL のラベルを付けることができます。
オプションで、レポートファイルの最初にタイトルページを含める場合は、Show Title Page を選択します。
[Report Type] > [Controller Audit ] を選択して、[Reports Data] タブのフィールドを定義します。
時間範囲を設定します。必要に応じて、カスタムの時間範囲を作成および管理できます。
注:カスタムの時間範囲オプションはすべての Report Types に対して使用できます。
レポートファイル形式として PDF、JSON、または CSV を選択します。
または、[Show Diff] チェックボックスをオフにして、レポートファイルから Object Changes 列を削除します。
ドロップダウンリストから、含めるまたは除外するデータを選択します。
次のオプションを使用して、必要に応じて繰り返します。
属性値を入力します。
+ Add をクリックします。
新しいレポートを作成したり、既存のレポートを複製したり、現在のレポートを変更したり、定義済みの受信者リストに対して電子メール配信スケジュールを設定したりすることができます。また、[Send Report Now] の右クリックオプションを選択して、監査の詳細をすぐに確認することもできます。
コントローラ監査では、次の属性がレポートされます。
|
|
|
|
|
|
|
|
|
コントローラ監査ログレポートの取得
コントローラ監査ログレポートは、構成ページに追加されたアドレスに基づいて電子メールで送信されます。このレポートでは、次の情報がキャプチャされます。
ユーザログインと情報の変更
コントローラ構成の変更
アプリケーションプロパティやオブジェクトの変更(上記テーブルにリストされているポリシー、正常性ルール、エンティティなど)
環境プロパティの変更
Splunk AppDynamics は、PDF、JSON、および CSV の出力形式をサポートしています。
API を介したコントローラ監査履歴の取得
ControllerAuditHistory API メソッドを使用してコントローラ監査履歴を取得できます。このメソッドは、指定された時間範囲について、JSON または CSV ファイル内の構成およびユーザアクティビティのレコードを返します。この情報は、ファイルに記載されている内容と同じです。
形式
GET /controller/ ControllerAuditHistory?startTime=<start-time>&endTime=<end-time>&include=<field>:<value>&exclude=<field>:<value>
For example:
http://localhost:8080/controller/ControllerAuditHistory?startTime=yyyy-MM-dd&&endTime=yyyy-MM-dd&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&Francisco&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"}]
入力パラメータ
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 の処理には、同じ <field> を含むリレーションシップが "OR" のフィルタや、異なる <field> を含むリレーションシップが "AND" のフィルタなどがあります。
include フィルタと exclude フィルタが直接連携することはありません。
各フィルタはパラメータにする必要があります(例:
include=filterName1:filterValue1&include=filterName2:filterValue2
)。次の例を参照してください。
コントローラ監査ログのデフォルト構成設定
次の表に、コントローラ用のデフォルト設定を示します。これらの設定を編集するには、カスタマーサポートにお問い合わせください。
Name | 説明 | 値 |
---|---|---|
audit.enabled | 監査ロギングを有効または無効にします |
|
audit.log.changes.persisted | 監査ログの状態変更データの永続化を有効または無効にします |
|
audit.log.file.count | サイズ制限を超えた場合のローテーションするログファイルの数。 |
|
audit.log.file.enabled | 監査情報をファイルに記録できるようにします。 |
|
audit.log.file.location | 監査ログファイルの場所 <空の値は | |
audit.log.file.size | 監査ロギングの最大ログファイルサイズ(バイト単位)。 |
|
audit.log.retention.period | 監査ログの保持期間(時間単位)(30 日間)。 |
|
Splunk AppDynamics では、コントローラ監査ログが 30 日間のみ保持されることに注意してください。それよりも長く保持する場合は、アカウントマネージャに問い合わせるか、スケジュール設定されたレポートを定期的にダウンロードしてください。
監査の対象
次のエントリが監査されます。
|
|
監査レポートは、必要に応じて上記のエンティティのアプリケーション名をサポートするようになりました。
サポートされている監査アクション
次に、監査でサポートされているアクションのリストを示します。
上記の表のすべての監査エントリで、これらのアクションのすべてがサポートされているわけではないことに注意してください。
|
|