使用 Amazon CLI 创建控制面板

运行 create-dashboard 来创建控制面板。

创建自定义控制面板时，您可以传入一个最多包含 10 个小组件的数组。小组件以图形方式呈现查询的结果。每个小组件都包含 ViewProperties、QueryStatement 和 QueryParameters。

以下示例创建了一个包含四个小组件（每种视图类型一个）的控制面板。

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 由以下可选参数组成：

以下示例设置了每六个小时刷新计划并启用该计划。

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

运行 create-dashboard 命令来创建“要点”控制面板。要创建此控制面板，--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 参数来设置和启用刷新计划。对于“要点”控制面板，唯一有效的 UNIT 是 HOURS，唯一有效的 Value 是 6。

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