Erstellen Sie ein Dashboard mit AWS CLI

Führen Sie den auscreate-dashboard, um ein Dashboard zu erstellen.

Wenn Sie ein benutzerdefiniertes Dashboard erstellen, können Sie ein Array mit bis zu 10 Widgets übergeben. Ein Widget bietet eine grafische Darstellung der Ergebnisse einer Abfrage. Jedes Widget besteht aus ViewPropertiesQueryStatement, undQueryParameters.

Im folgenden Beispiel wird ein Dashboard mit vier Widgets erstellt, eines für jeden Ansichtstyp.

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$"]
    }
  ]'

Erstellen Sie eine separate Datei mit der Ressourcenrichtlinie, die für jeden Ereignisdatenspeicher erforderlich ist, der in einem Widget enthalten ist. QueryStatement Benennen Sie die Datei policy.json mit dem folgenden Beispiel für eine Richtlinienanweisung:

123456789012Ersetzen Sie es durch Ihre Konto-ID, arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard durch den ARN des Dashboards.

Weitere Informationen zu ressourcenbasierten Richtlinien für Dashboards finden Sie unter. Beispiel: Erlauben Sie CloudTrail die Ausführung von Abfragen zur Aktualisierung eines Dashboards

Führen Sie den put-resource-policy Befehl aus, um die Richtlinie anzuhängen. Sie können die ressourcenbasierte Richtlinie eines Ereignisdatenspeichers auch auf der CloudTrail Konsole aktualisieren.

Im folgenden Beispiel wird eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher angehängt.

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

Führen Sie den put-resource-policy Befehl aus, um eine ressourcenbasierte Richtlinie an das Dashboard anzuhängen. Eine Beispielrichtlinie finden Sie unter Beispiel für eine ressourcenbasierte Richtlinie für ein Dashboard.

Im folgenden Beispiel wird eine ressourcenbasierte Richtlinie an ein Dashboard angehängt. account-idErsetzen Sie es durch Ihre Konto-ID und dashboard-arn durch den ARN des Dashboards.

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"}}}]}'

Führen Sie den update-dashboard Befehl aus, um einen Aktualisierungszeitplan festzulegen und zu aktivieren, indem Sie den --refresh-schedule Parameter konfigurieren.

Der --refresh-schedule besteht aus den folgenden optionalen Parametern:

Im folgenden Beispiel wird ein Aktualisierungszeitplan für alle sechs Stunden festgelegt und der Zeitplan aktiviert.

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

Führen Sie den create-dashboard Befehl aus, um das Highlights-Dashboard zu erstellen. Um dieses Dashboard zu erstellen, --name muss das seinAWSCloudTrail-Highlights.

aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights

Führen Sie für jeden Ereignisdatenspeicher in Ihrem Konto den put-resource-policy Befehl aus, um eine ressourcenbasierte Richtlinie an den Ereignisdatenspeicher anzuhängen. Sie können die ressourcenbasierte Richtlinie eines Ereignisdatenspeichers auch auf der Konsole aktualisieren. CloudTrail Eine Beispielrichtlinie finden Sie unter Beispiel: Erlauben Sie CloudTrail die Ausführung von Abfragen zur Aktualisierung eines Dashboards.

Im folgenden Beispiel wird eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher angehängt. account-idErsetzen Sie es durch Ihre Konto-ID, eds-arn durch den ARN des Event-Datenspeichers und dashboard-arn durch den ARN des Dashboards.

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"}}} ]}'

Führen Sie den put-resource-policy Befehl aus, um eine ressourcenbasierte Richtlinie an das Dashboard anzuhängen. Eine Beispielrichtlinie finden Sie unter Beispiel für eine ressourcenbasierte Richtlinie für ein Dashboard.

Im folgenden Beispiel wird eine ressourcenbasierte Richtlinie an ein Dashboard angehängt. account-idErsetzen Sie es durch Ihre Konto-ID und dashboard-arn durch den ARN des Dashboards.

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"}}}]}'

Führen Sie den update-dashboard Befehl aus, um einen Aktualisierungszeitplan festzulegen und zu aktivieren, indem Sie den --refresh-schedule Parameter konfigurieren. Für das Highlights-Dashboard UNIT ist das einzig gültige HOURS und das einzig gültige Value ist6.

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