Créez un tableau de bord avec AWS CLI

Exécutez le create-dashboard pour créer un tableau de bord.

Lorsque vous créez un tableau de bord personnalisé, vous pouvez transmettre un tableau contenant jusqu'à 10 widgets. Un widget fournit une représentation graphique des résultats d'une requête. Chaque widget est composé de ViewPropertiesQueryStatement, etQueryParameters.

L'exemple suivant crée un tableau de bord avec quatre widgets, un pour chaque type de vue.

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

Créez un fichier distinct contenant la politique de ressources requise pour chaque magasin de données d'événements inclus dans celui d'un widgetQueryStatement. Nommez le fichierpolicy.json, avec l'exemple de déclaration de politique suivant :

123456789012Remplacez-le par votre identifiant de compte, arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard par l'ARN du tableau de bord.

Pour plus d'informations sur les politiques basées sur les ressources pour les tableaux de bord, consultez. Exemple : CloudTrail Autoriser l'exécution de requêtes pour actualiser un tableau de bord

Exécutez la put-resource-policy commande pour associer la politique. Vous pouvez également mettre à jour la politique basée sur les ressources d'un magasin de données d'événements sur la CloudTrail console.

L'exemple suivant associe une politique basée sur les ressources à un magasin de données d'événements.

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

Exécutez la put-resource-policy commande pour associer une politique basée sur les ressources au tableau de bord. Pour un exemple de politique, consultez Exemple de politique basée sur les ressources pour un tableau de bord.

L'exemple suivant associe une politique basée sur les ressources à un tableau de bord. account-idRemplacez-le par votre identifiant de compte et dashboard-arn par l'ARN du tableau de bord.

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

Exécutez la update-dashboard commande pour définir et activer un programme d'actualisation en configurant le --refresh-schedule paramètre.

--refresh-scheduleIl comprend les paramètres facultatifs suivants :

L'exemple suivant définit un programme d'actualisation toutes les six heures et active le calendrier.

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

Exécutez la create-dashboard commande pour créer le tableau de bord Highlights. Pour créer ce tableau de bord, --name il fautAWSCloudTrail-Highlights.

aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights

Pour chaque magasin de données d'événements de votre compte, exécutez la put-resource-policy commande pour associer une politique basée sur les ressources au magasin de données d'événements. Vous pouvez également mettre à jour la politique basée sur les ressources d'un magasin de données d'événements sur la CloudTrail console. Pour un exemple de politique, consultez Exemple : CloudTrail Autoriser l'exécution de requêtes pour actualiser un tableau de bord.

L'exemple suivant associe une politique basée sur les ressources à un magasin de données d'événements. Remplacez-le account-id par votre identifiant de compte, eds-arn par l'ARN du magasin de données d'événements et dashboard-arn par l'ARN du tableau de bord.

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

Exécutez la put-resource-policy commande pour associer une politique basée sur les ressources au tableau de bord. Pour un exemple de politique, consultez Exemple de politique basée sur les ressources pour un tableau de bord.

L'exemple suivant associe une politique basée sur les ressources à un tableau de bord. account-idRemplacez-le par votre identifiant de compte et dashboard-arn par l'ARN du tableau de bord.

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

Exécutez la update-dashboard commande pour définir et activer un programme d'actualisation en configurant le --refresh-schedule paramètre. Pour le tableau de bord Highlights, le seul valide UNIT est HOURS et le seul valide Value est6.

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