Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Crea una dashboard con AWS CLI
<a name="lake-dashboard-cli-create"></a>

Questa sezione descrive come utilizzare il `create-dashboard` comando per creare una dashboard personalizzata o la dashboard Highlights.

Quando usi il AWS CLI, ricorda che i comandi vengono eseguiti nella Regione AWS configurazione per il tuo profilo. Per eseguire i comandi in un'altra regione, modificare la regione predefinita per il profilo oppure utilizzare il parametro `--region` con il comando.

 CloudTrail esegue query per popolare i widget della dashboard durante un aggiornamento manuale o pianificato. CloudTrail è necessario disporre delle autorizzazioni per eseguire l'`StartQuery`operazione su ogni archivio dati di eventi associato a un widget del dashboard. Per fornire le autorizzazioni, esegui il `put-resource-policy` comando per allegare una policy basata sulle risorse a ciascun event data store oppure modifica la policy dell'Event Data Store sulla console. CloudTrail Per un esempio di policy, consulta [Esempio: consenti CloudTrail di eseguire query per aggiornare un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard). 

 Per impostare una pianificazione di aggiornamento, è CloudTrail necessario disporre delle autorizzazioni necessarie per eseguire l'`StartDashboardRefresh`operazione di aggiornamento della dashboard per conto dell'utente. Per fornire le autorizzazioni, esegui l'`put-resource-policy`operazione per allegare una politica basata sulle risorse alla dashboard o modifica la politica della dashboard sulla console. CloudTrail Per un esempio di policy, consulta [Esempio di policy basata sulle risorse per un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards). 

**Topics**
+ [Crea una dashboard personalizzata con AWS CLI](#lake-dashboard-cli-create-custom)
+ [Abilita il pannello di controllo Highlights con il AWS CLI](#lake-dashboard-cli-create-highlights)
+ [Visualizza le proprietà dei widget](lake-widget-properties.md)

## Crea una dashboard personalizzata con AWS CLI
<a name="lake-dashboard-cli-create-custom"></a>

La procedura seguente mostra come creare un dashboard personalizzato, allegare le politiche basate sulle risorse richieste agli archivi di dati degli eventi e al dashboard e aggiornare il dashboard per impostare e abilitare una pianificazione di aggiornamento.

1. 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 `ViewProperties``QueryStatement`, e`QueryParameters`.
   + `ViewProperties`: specifica le proprietà per il tipo di visualizzazione. Per ulteriori informazioni, consulta [Visualizza le proprietà dei widget](lake-widget-properties.md).
   + `QueryStatement`— La query CloudTrail viene eseguita quando il dashboard viene aggiornato. È possibile eseguire query su più archivi dati di eventi purché gli archivi dati degli eventi esistano nel proprio account.
   + `QueryParameters`— I seguenti `QueryParameters` valori sono supportati per i dashboard personalizzati:`$Period$`,`$StartTime$`, e`$EndTime$`. Per utilizzare, `QueryParameters` posiziona `?` a nel `QueryStatement` punto in cui desideri sostituire il parametro. CloudTrail inserirà i parametri quando viene eseguita la query.

   L'esempio seguente crea una dashboard con quattro widget, uno per ogni tipo di visualizzazione.
**Nota**  
In questo esempio, `?` è racchiuso tra virgolette singole perché viene utilizzato con`eventTime`. A seconda del sistema operativo in uso, potrebbe essere necessario racchiudere le virgolette singole tra virgolette di escape. Per ulteriori informazioni, vedere [Utilizzo di virgolette e letterali con stringhe](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-quoting-strings.html) in. AWS CLI

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

1. 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 file*policy.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](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard)

1. 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
   ```

1. 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 un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

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

1. 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:
   + `Frequency`— La `Unit` e `Value` per la pianificazione.

     Per i dashboard personalizzati, l'unità può essere `HOURS` o`DAYS`.

      Per i dashboard personalizzati, i seguenti valori sono validi quando l'unità è`HOURS`:`1`,,, `6` `12` `24` 

     Per i dashboard personalizzati, l'unico valore valido quando l'unità è è`DAYS`. `1`
   + `Status`— Speciifica se la pianificazione dell'aggiornamento è abilitata. Imposta il valore `ENABLED` per abilitare la pianificazione dell'aggiornamento o `DISABLED` per disattivarla. 
   + `TimeOfDay `— L'ora del giorno in UTC in cui eseguire la pianificazione; per ora si fa riferimento solo ai minuti; l'impostazione predefinita è 00:00.

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

## Abilita il pannello di controllo Highlights con il AWS CLI
<a name="lake-dashboard-cli-create-highlights"></a>

La procedura seguente mostra come creare la dashboard Highlights, allegare le politiche basate sulle risorse richieste ai data store degli eventi e alla dashboard e aggiornare la dashboard per impostare e abilitare la pianificazione degli aggiornamenti.

1. Esegui il `create-dashboard` comando per creare la dashboard Highlights. Per creare questa dashboard, `--name` deve essere`AWSCloudTrail-Highlights`.

   ```
   aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights
   ```

1. 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](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard).

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

1. 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 un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

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

1. 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"}'
   ```

# Visualizza le proprietà dei widget
<a name="lake-widget-properties"></a>

Questa sezione descrive le proprietà di visualizzazione configurabili per i 4 tipi di visualizzazione: tabella, grafico a linee, grafico a torta e grafico a barre.

**Topics**
+ [Tabella](#lake-widget-table)
+ [Grafico a linee](#lake-widget-linechart)
+ [Grafico a torta](#lake-widget-piechart)
+ [Grafico a barre](#lake-widget-barchart)

## Tabella
<a name="lake-widget-table"></a>

L'esempio seguente mostra un widget configurato come tabella.

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

La tabella seguente descrive le proprietà di visualizzazione configurabili per una tabella.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza della tabella in pollici.  | 
|  `Width`  |  Sì  |  La larghezza della tabella in pollici.  | 
|  `Title`  |  Sì  |  Il titolo della tabella.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per una tabella, il valore è`Table`.  | 

## Grafico a linee
<a name="lake-widget-linechart"></a>

L'esempio seguente mostra un widget configurato come grafico a linee.

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

La tabella seguente descrive le proprietà di visualizzazione configurabili per un grafico a linee.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza del grafico a linee in pollici.  | 
|  `Width`  |  Sì  |  La larghezza del grafico a linee in pollici.  | 
|  `Title`  |  Sì  |  Il titolo del grafico a linee.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per un grafico a linee, il valore è`LineChart`.  | 
|  `YAxisColumn`  |  Sì  |  Il campo dei risultati della query che si desidera utilizzare per la colonna dell'asse Y. Ad esempio, `eventCount`.  | 
|  `XAxisColumn`  |  Sì  |  Il campo dei risultati della query che si desidera utilizzare per la colonna dell'asse X. Ad esempio, `eventDate`.  | 
|  `FilterColumn`  |  No  |  Il campo dei risultati della query in base al quale si desidera filtrare. Ad esempio, `readOnly`.  | 

## Grafico a torta
<a name="lake-widget-piechart"></a>

L'esempio seguente mostra un widget configurato come grafico a torta.

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

La tabella seguente descrive le proprietà di visualizzazione configurabili per un grafico a torta.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza del grafico a torta in pollici.  | 
|  `Width`  |  Sì  |  La larghezza del grafico a torta in pollici.  | 
|  `Title`  |  Sì  |  Il titolo del grafico a torta.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per un grafico a torta, il valore è`PieChart`.  | 
|  `LabelColumn`  |  Sì  |  L'etichetta per i segmenti nel grafico a torta. Ad esempio, `awsRegion`.  | 
|  `ValueColumn`  |  Sì  |  Il valore dei segmenti nel grafico a torta. Ad esempio, `ValueColumn`.  | 
|  `FilterColumn`  |  No  |  Il campo dei risultati della query in base al quale si desidera filtrare. Ad esempio, `awsRegion`.  | 

## Grafico a barre
<a name="lake-widget-barchart"></a>

L'esempio seguente mostra un widget configurato come grafico a barre.

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

La tabella seguente descrive le proprietà di visualizzazione configurabili per un grafico a barre.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza del grafico a barre in pollici.  | 
|  `Width`  |  Sì  |  La larghezza del grafico a barre in pollici.  | 
|  `Title`  |  Sì  |  Il titolo del grafico a barre.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per un grafico a barre, il valore è`BarChart`.  | 
|  `LabelColumn`  |  Sì  |  L'etichetta per le barre nel grafico a barre. Ad esempio, `service`.  | 
|  `ValueColumn`  |  Sì  |  Il valore delle barre nel grafico a barre. Ad esempio, `eventCount`.  | 
|  `FilterColumn`  |  No  |  Il campo dei risultati della query in base al quale si desidera filtrare. Ad esempio, `service`.  | 
|  `Orientation`  |  No  |  L'orientamento del grafico a barre, `Horizontal` o`Vertical`.  |