を使用してダッシュボードを作成する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 に置き換えます。

ダッシュボードのリソースベースのポリシーの詳細については、「例: CloudTrail がクエリを実行してダッシュボードを更新できるようにする」を参照してください。

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

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

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

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

次の例では、ダッシュボードにリソースベースのポリシーをアタッチします。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 コンソールでイベントデータストアのリソースベースのポリシーをアップデートすることもできます。ポリシーの例については「例: CloudTrail がクエリを実行してダッシュボードを更新できるようにする」を参照してください。

次の例では、リソースベースのポリシーをイベントデータストアにアタッチします。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 コマンドを実行して、リソースベースのポリシーをダッシュボードにアタッチします。ポリシーの例については「ダッシュボードのリソースベースのポリシーの例」を参照してください。

次の例では、ダッシュボードにリソースベースのポリシーをアタッチします。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"}'