を使用してダッシュボードを作成する AWS CLI

を実行してダッシュボードcreate-dashboardを作成します。

カスタムダッシュボードを作成すると、最大 10 個のウィジェットを持つ配列を渡すことができます。ウィジェットは、クエリの結果をグラフィカルに表示します。各ウィジェットは、ViewProperties、QueryStatement、および で構成されますQueryParameters。

次の例では、各ビュータイプの 1 つである 4 つのウィジェットを持つダッシュボードを作成します。

aws cloudtrail create-dashboard --name AccountActivityDashboard \
--widgets '[
    {
      "ViewProperties": {
        "Height": "2",
        "Width": "4",
        "Title": "TopErrors",
        "View": "Table"
      },
      "QueryStatement": "SELECT errorCode, COUNT(*) AS eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' AND (errorCode is not null) GROUP BY errorCode ORDER BY eventCount DESC LIMIT 100",
      "QueryParameters": ["$StartTime$", "$EndTime$"]
    },
    {
      "ViewProperties": {
        "Height": "2",
        "Width": "4",
        "Title": "MostActiveRegions",
        "View": "PieChart",
        "LabelColumn": "awsRegion",
        "ValueColumn": "eventCount",
        "FilterColumn": "awsRegion"
      },
      "QueryStatement": "SELECT awsRegion, COUNT(*) AS eventCount FROM eds where eventTime > '?' and eventTime < '?' GROUP BY awsRegion ORDER BY eventCount LIMIT 100",
      "QueryParameters": ["$StartTime$", "$EndTime$"]
    },
    {
      "ViewProperties": {
        "Height": "2",
        "Width": "4",
        "Title": "AccountActivity",
        "View": "LineChart",
        "YAxisColumn": "eventCount",
        "XAxisColumn": "eventDate",
        "FilterColumn": "readOnly"
      },
      "QueryStatement": "SELECT DATE_TRUNC('?', eventTime) AS eventDate, IF(readOnly, 'read', 'write') AS readOnly, COUNT(*) as eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' GROUP BY DATE_TRUNC('?', eventTime), readOnly ORDER BY DATE_TRUNC('?', eventTime), readOnly",
      "QueryParameters": ["$Period$", "$StartTime$", "$EndTime$", "$Period$", "$Period$"]
    },
    {
      "ViewProperties": {
        "Height": "2",
        "Width": "4",
        "Title": "TopServices",
        "View": "BarChart",
        "LabelColumn": "service",
        "ValueColumn": "eventCount",
        "FilterColumn": "service",
        "Orientation": "Horizontal"
      },
      "QueryStatement": "SELECT REPLACE(eventSource, '.amazonaws.com') AS service, COUNT(*) AS eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' GROUP BY eventSource ORDER BY eventCount DESC LIMIT 100",
      "QueryParameters": ["$StartTime$", "$EndTime$"]
    }
  ]'

ウィジェットの に含まれる各イベントデータストアに必要なリソースポリシーを含む個別のファイルを作成しますQueryStatement。次のポリシーステートメントの例を使用して、ファイル policy.json に名前を付けます。

123456789012 をアカウント ID、arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard をダッシュボードの ARN に置き換えます。

ダッシュボードのリソースベースのポリシーの詳細については、「」を参照してくださいExample: Allow CloudTrail to run queries to refresh a dashboard。

put-resource-policy コマンドを実行して、ポリシーをアタッチします。CloudTrail コンソールでイベントデータストアのリソースベースのポリシーを更新することもできます。

次の例では、リソースベースのポリシーをイベントデータストアにアタッチします。

aws cloudtrail put-resource-policy \
--resource-arn eds-arn \
--resource-policy file://policy.json

put-resource-policy コマンドを実行して、リソースベースのポリシーをダッシュボードにアタッチします。ポリシーの例についてはResource-based policy example for a dashboardを参照してください。

次の例では、リソースベースのポリシーをダッシュボードにアタッチします。account-id を自分のアカウント ID に置き換え、 dashboard-arn をダッシュボードの ARN に置き換えます。

aws cloudtrail put-resource-policy \
--resource-arn dashboard-arn \
--resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "DashboardPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartDashboardRefresh", "Condition": { "StringEquals": { "AWS:SourceArn": "dashboard-arn", "AWS:SourceAccount": "account-id"}}}]}'

update-dashboard コマンドを実行して、 --refresh-scheduleパラメータを設定して更新スケジュールを設定および有効にします。

--refresh-schedule は、以下のオプションパラメータで構成されます。

次の の例では、6 時間ごとに更新スケジュールを設定し、スケジュールを有効にします。

aws cloudtrail update-dashboard --dashboard-id AccountActivityDashboard \
--refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}'

create-dashboard コマンドを実行して Highlights ダッシュボードを作成します。このダッシュボードを作成するには、 が --nameである必要がありますAWSCloudTrail-Highlights。

aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights

アカウント内のイベントデータストアごとに、 put-resource-policy コマンドを実行して、リソースベースのポリシーをイベントデータストアにアタッチします。CloudTrail コンソールでイベントデータストアのリソースベースのポリシーを更新することもできます。ポリシーの例についてはExample: Allow CloudTrail to run queries to refresh a dashboardを参照してください。

次の例では、リソースベースのポリシーをイベントデータストアにアタッチします。account-id をアカウント ID に、eds-arn をイベントデータストアの ARN に、dashboard-arn をダッシュボードの ARN に置き換えます。

aws cloudtrail put-resource-policy \
--resource-arn eds-arn \
--resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "EDSPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartQuery", "Condition": { "StringEquals": { "AWS:SourceArn": "dashboard-arn", "AWS:SourceAccount": "account-id"}}} ]}'

put-resource-policy コマンドを実行して、リソースベースのポリシーをダッシュボードにアタッチします。ポリシーの例についてはResource-based policy example for a dashboardを参照してください。

次の例では、リソースベースのポリシーをダッシュボードにアタッチします。account-id をアカウント ID に置き換え、 dashboard-arn をダッシュボードの ARN に置き換えます。

aws cloudtrail put-resource-policy \
--resource-arn dashboard-arn \
--resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "DashboardPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartDashboardRefresh", "Condition": { "StringEquals": { "AWS:SourceArn": "dashboard-arn", "AWS:SourceAccount": "account-id"}}}]}'

update-dashboard コマンドを実行して、 --refresh-scheduleパラメータを設定して更新スケジュールを設定および有効にします。Highlights ダッシュボードでは、唯一の有効な UNITは HOURSで、唯一の有効な Valueは です6。

aws cloudtrail update-dashboard --dashboard-id AWSCloudTrail-Highlights \
--refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}'