Cree un panel con AWS CLI

Ejecutar create-dashboard para crear un panel

Al crear un panel personalizado, puede incluir una matriz con hasta 10 widgets. Un widget ofrece una representación gráfica de los resultados de una consulta. Cada widget consta de ViewProperties, QueryStatement y QueryParameters.

En el siguiente ejemplo se crea un panel con cuatro widgets, uno de cada tipo de vista.

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

Cree un archivo independiente con la política de recursos necesaria para cada almacén de datos de eventos que se incluya en la QueryStatement del widget. Asigne un nombre al archivo policy.json con el siguiente ejemplo de declaración de política:

123456789012Sustitúyelo por el ID de su cuenta, arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard por el ARN del panel de control.

Para obtener más información sobre las políticas basadas en recursos para los paneles, consulte Ejemplo: CloudTrail permitir la ejecución de consultas para actualizar un panel.

Ejecute el comando put-resource-policy para asociar la política. También puedes actualizar la política basada en los recursos de un almacén de datos de eventos en la consola. CloudTrail

En el siguiente ejemplo se asocia la política basada en recursos a un almacén de datos de eventos.

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

Ejecute el comando put-resource-policy para asociar una política basada en recursos al panel. Para ver una política de ejemplo, consulte Ejemplo de política basada en recursos para un panel.

En el siguiente ejemplo se asocia una política basada en recursos a un panel. account-idSustitúyala por tu ID de cuenta y dashboard-arn por el ARN del panel de control.

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

Ejecute el comando update-dashboard para establecer y habilitar un programa de actualización configurando el parámetro --refresh-schedule.

El --refresh-schedule consta de los siguientes parámetros opcionales:

En el siguiente ejemplo, se establece un programa de actualización para cada seis horas y se habilita el programa.

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

Ejecute el comando create-dashboard para crear el panel de aspectos destacados. A fin de crear este panel, --name debe ser AWSCloudTrail-Highlights.

aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights

Para cada almacén de datos de eventos de su cuenta, ejecute el comando put-resource-policy a fin de asociar una política basada en recursos al almacén de datos de eventos. También puedes actualizar la política basada en los recursos de un almacén de datos de eventos en la CloudTrail consola. Para ver una política de ejemplo, consulte Ejemplo: CloudTrail permitir la ejecución de consultas para actualizar un panel.

En el siguiente ejemplo se asocia la política basada en recursos a un almacén de datos de eventos. account-idSustitúyalo por tu ID eds-arn de cuenta, por el ARN del almacén de datos del evento y por el dashboard-arn ARN del panel de control.

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

Ejecute el comando put-resource-policy para asociar una política basada en recursos al panel. Para ver una política de ejemplo, consulte Ejemplo de política basada en recursos para un panel.

En el siguiente ejemplo se asocia una política basada en recursos a un panel. account-idSustitúyala por tu ID de cuenta y dashboard-arn por el ARN del panel de control.

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

Ejecute el comando update-dashboard para establecer y habilitar un programa de actualización configurando el parámetro --refresh-schedule. Para el panel de aspectos destacados, la única UNIT válida es HOURS y lo único Value válido es 6.

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