As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Crie um painel com o AWS CLI
Esta seção descreve como usar o create-dashboard comando para criar um painel personalizado ou o painel Destaques.
Ao usar o AWS CLI, lembre-se de que seus comandos são Região da AWS executados no configurado para seu perfil. Se você deseja executar os comandos em uma região diferente, altere a região padrão para o seu perfil ou use o parâmetro --region com o comando.
CloudTrail executa consultas para preencher os widgets do painel durante uma atualização manual ou programada. CloudTrail devem receber permissões para executar a StartQuery operação em cada armazenamento de dados de eventos associado a um widget do painel. Para fornecer permissões, execute o put-resource-policy comando para anexar uma política baseada em recursos a cada armazenamento de dados de eventos ou edite a política 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.
Para definir um cronograma de atualização, é CloudTrail necessário conceder permissões para executar a StartDashboardRefresh operação de atualização do painel em seu nome. Para fornecer permissões, execute a put-resource-policy operação para anexar uma política baseada em recursos ao painel ou edite a política do painel no CloudTrail console. Para visualizar um exemplo de política, consulte Exemplo de política baseada em recursos para um painel.
Exemplos:
Crie um painel personalizado com o AWS CLI
O procedimento a seguir mostra como criar um painel personalizado, anexar as políticas baseadas em recursos necessárias aos armazenamentos de dados de eventos e ao painel e atualizar o painel para definir e ativar um cronograma de atualização.
-
Execute o
create-dashboardpara 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
ViewPropertiesQueryStatement, e.QueryParameters-
ViewProperties— Especifica as propriedades do tipo de visualização. Para obter mais informações, consulte Exibir propriedades dos widgets. -
QueryStatement— A consulta CloudTrail é executada quando o painel é atualizado. Você pode consultar vários armazenamentos de dados de eventos, desde que os armazenamentos de dados de eventos existam em sua conta. -
QueryParameters— Os seguintesQueryParametersvalores são compatíveis com painéis personalizados:$Period$$StartTime$, e.$EndTime$Para usar,QueryParameterscoloque a?noQueryStatementlocal em que você deseja substituir o parâmetro. CloudTrail preencherá os parâmetros quando a consulta for executada.
O exemplo a seguir cria um painel com quatro widgets, um de cada tipo de visualização.
nota
Neste exemplo,
?está entre aspas simples porque é usado comeventTime. Dependendo do sistema operacional em que você está executando, talvez seja necessário colocar aspas simples entre aspas de escape. Para obter mais informações, consulte Usando aspas e literais com cadeias de caracteres no. AWS CLIaws 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 recursos necessária para cada armazenamento de dados de eventos incluído no de um widget.
QueryStatementNomeie o arquivopolicy.jsoncom o seguinte exemplo de declaração de política:123456789012Substitua pelo ID da sua conta,arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboardpelo 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
put-resource-policycomando 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.O exemplo a seguir anexa uma política baseada em recursos a um armazenamento de dados de eventos.
aws cloudtrail put-resource-policy \ --resource-arneds-arn\ --resource-policy file://policy.json -
Execute o
put-resource-policycomando para anexar uma política baseada em recursos ao painel. Para visualizar um exemplo de política, consulte Exemplo de política baseada em recursos para um painel.O exemplo a seguir anexa uma política baseada em recursos a um painel.
account-idSubstitua pelo ID da sua conta edashboard-arnpelo ARN do painel.aws cloudtrail put-resource-policy \ --resource-arndashboard-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
update-dashboardcomando para definir e ativar uma agenda de atualização configurando o--refresh-scheduleparâmetro.O
--refresh-scheduleconsiste nos seguintes parâmetros opcionais:-
Frequency— OUniteValuepara o cronograma.Para painéis personalizados, a unidade pode ser
HOURSouDAYS.Para painéis personalizados, os valores a seguir são válidos quando a unidade é
HOURS:1,,6,1224Para painéis personalizados, o único valor válido quando a unidade é
DAYSé1. -
Status— Especifica se a agenda de atualização está ativada. Defina o valorENABLEDpara ativar a agenda de atualização ouDISABLEDpara desativar a agenda de atualização. -
TimeOfDay— A hora do dia em UTC para executar a programação; por hora, consulte apenas os minutos; o padrão é 00:00.
O exemplo a seguir define uma agenda de atualização a cada seis horas e ativa a programação.
aws cloudtrail update-dashboard --dashboard-id AccountActivityDashboard \ --refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}' -
Ative o painel de destaques com o AWS CLI
O procedimento a seguir mostra como criar o painel Destaques, anexar as políticas baseadas em recursos necessárias aos seus armazenamentos de dados de eventos e ao painel e atualizar o painel para definir e ativar o cronograma de atualização.
-
Execute o
create-dashboardcomando para criar o painel de Destaques. Para criar esse painel, é--namenecessário que sejaAWSCloudTrail-Highlights.aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights -
Para cada armazenamento de dados de eventos em sua conta, execute o
put-resource-policycomando para anexar uma política baseada em recursos ao armazenamento de dados 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.O exemplo a seguir anexa uma política baseada em recursos a um armazenamento de dados de eventos.
account-idSubstitua pelo ID da sua conta,eds-arnpelo ARN do armazenamento de dados do evento edashboard-arnpelo ARN do painel.aws cloudtrail put-resource-policy \ --resource-arneds-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
put-resource-policycomando para anexar uma política baseada em recursos ao painel. Para visualizar um exemplo de política, consulte Exemplo de política baseada em recursos para um painel.O exemplo a seguir anexa uma política baseada em recursos a um painel.
account-idSubstitua pelo ID da sua conta edashboard-arnpelo ARN do painel.aws cloudtrail put-resource-policy \ --resource-arndashboard-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
update-dashboardcomando para definir e ativar uma agenda de atualização configurando o--refresh-scheduleparâmetro. Para o painel de Destaques, o único válidoUNITéHOURSe o único válidoValueé6.aws cloudtrail update-dashboard --dashboard-id AWSCloudTrail-Highlights \ --refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}'