Crie um painel com o AWS CLI

Execute o comando create-dashboard para criar um painel.

Ao criar um painel personalizado, você pode transmitir uma matriz com até 10 widgets. Um widget fornece uma representação gráfica dos resultados de uma consulta. Cada widget consiste em ViewProperties, QueryStatement e QueryParameters.

O exemplo a seguir cria um painel com quatro widgets, um de cada tipo de visão.

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

Crie um arquivo separado com a política de recurso necessária para cada datastore de eventos incluído na QueryStatement de um widget. Nomeie o arquivo policy.json com o seguinte exemplo de declaração de política:

123456789012Substitua pelo ID da sua conta, arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard pelo ARN do painel.

Para obter mais informações sobre políticas baseadas em recursos para painéis, consulte Exemplo: permitir CloudTrail a execução de consultas para atualizar um painel.

Execute o comando put-resource-policy para anexar a política. Você também pode atualizar a política baseada em recursos do armazenamento de dados de eventos no CloudTrail console.

Os exemplo a seguir anexa a política baseada em recurso a um datastore de eventos.

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

Execute o comando put-resource-policy para anexar uma política baseada em recurso ao painel. Para visualizar um exemplo de política, consulte Exemplo de política baseada em recurso para um painel.

O exemplo a seguir anexa uma política baseada em recurso a um painel. account-idSubstitua pelo ID da sua conta e dashboard-arn pelo ARN do painel.

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

Execute o comando update-dashboard para definir e habilitar uma agenda de atualização configurando o parâmetro --refresh-schedule.

A --refresh-schedule consiste nos seguintes parâmetros opcionais:

O exemplo a seguir define uma agenda de atualização para execução a cada seis horas e habilita a agenda.

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

Executar o comando create-dashboard para criar o painel Destaques. Para criar esse painel, o --name deve ser AWSCloudTrail-Highlights.

aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights

Para cada datastore de eventos em sua conta, execute o comando put-resource-policy para anexar uma política baseada em recurso ao datastore de eventos. Você também pode atualizar a política baseada em recursos do armazenamento de dados de eventos no CloudTrail console. Para visualizar um exemplo de política, consulte Exemplo: permitir CloudTrail a execução de consultas para atualizar um painel.

Os exemplo a seguir anexa a política baseada em recurso a um datastore de eventos. account-idSubstitua pelo ID da sua conta, eds-arn pelo ARN do armazenamento de dados do evento e dashboard-arn pelo ARN do painel.

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

Execute o comando put-resource-policy para anexar uma política baseada em recurso ao painel. Para visualizar um exemplo de política, consulte Exemplo de política baseada em recurso para um painel.

O exemplo a seguir anexa uma política baseada em recurso a um painel. account-idSubstitua pelo ID da sua conta e dashboard-arn pelo ARN do painel.

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

Execute o comando update-dashboard para definir e habilitar uma agenda de atualização configurando o parâmetro --refresh-schedule. Para o painel Destaques, a única UNIT válida é HOURS e o único Value válido é 6.

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