Crea una dashboard con AWS CLI

Esegui il comando per creare un pannello create-dashboard di controllo.

Quando crei una dashboard personalizzata, puoi inserire un array con un massimo di 10 widget. Un widget fornisce una rappresentazione grafica dei risultati di una query. Ogni widget è composto da ViewPropertiesQueryStatement, eQueryParameters.

L'esempio seguente crea una dashboard con quattro widget, uno per ogni tipo di visualizzazione.

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

Crea un file separato con la politica delle risorse necessaria per ogni archivio di dati di eventi incluso in un widget. QueryStatement Assegna un nome al filepolicy.json, con la seguente dichiarazione politica di esempio:

Sostituiscilo 123456789012 con l'ID del tuo account, arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard con l'ARN della dashboard.

Per ulteriori informazioni sulle politiche basate sulle risorse per le dashboard, consulta. Esempio: consenti CloudTrail di eseguire query per aggiornare un pannello di controllo

Esegui il put-resource-policy comando per allegare la policy. Puoi anche aggiornare la politica basata sulle risorse di un Event Data Store sulla console. CloudTrail

L'esempio seguente allega una policy basata sulle risorse a un data store di eventi.

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

Esegui il put-resource-policy comando per allegare una policy basata sulle risorse alla dashboard. Per un esempio di policy, consulta Esempio di policy basata sulle risorse per una dashboard.

L'esempio seguente allega una policy basata sulle risorse a un pannello di controllo. Sostituiscilo account-id con l'ID del tuo account e dashboard-arn con l'ARN della dashboard.

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

Esegui il update-dashboard comando per impostare e abilitare una pianificazione di aggiornamento configurando il parametro. --refresh-schedule

--refresh-scheduleÈ costituito dai seguenti parametri opzionali:

L'esempio seguente imposta una pianificazione di aggiornamento ogni sei ore e abilita la pianificazione.

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

Esegui il create-dashboard comando per creare la dashboard Highlights. Per creare questa dashboard, --name deve essereAWSCloudTrail-Highlights.

aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights

Per ogni archivio dati di eventi nel tuo account, esegui il put-resource-policy comando per allegare una politica basata sulle risorse all'archivio dati degli eventi. Puoi anche aggiornare la politica basata sulle risorse di un Event Data Store sulla console. CloudTrail Per un esempio di policy, consulta Esempio: consenti CloudTrail di eseguire query per aggiornare un pannello di controllo.

L'esempio seguente allega una policy basata sulle risorse a un data store di eventi. Sostituisci account-id con l'ID del tuo account, eds-arn con l'ARN dell'archivio dati degli eventi e dashboard-arn con l'ARN della dashboard.

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

Esegui il put-resource-policy comando per allegare una politica basata sulle risorse alla dashboard. Per un esempio di policy, consulta Esempio di policy basata sulle risorse per una dashboard.

L'esempio seguente allega una policy basata sulle risorse a un pannello di controllo. Sostituiscilo account-id con l'ID del tuo account e dashboard-arn con l'ARN della dashboard.

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

Esegui il update-dashboard comando per impostare e abilitare una pianificazione di aggiornamento configurando il parametro. --refresh-schedule Per la dashboard Highlights, l'unico valido UNIT è HOURS e l'unico valido Value è. 6

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