Ejemplos de CloudWatch con Herramientas para PowerShell V5

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes usando Herramientas de AWS para PowerShell V5 con CloudWatch.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

Get-CWDashboard

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CWDashboard.

Herramientas para PowerShell V5

Ejemplo 1: devuelve el arn al cuerpo del panel especificado.

Get-CWDashboard -DashboardName Dashboard1

Salida:

DashboardArn                                          DashboardBody
------------                                          -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...

• Para obtener información sobre la API, consulte GetDashboard en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).

Get-CWDashboardList

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CWDashboardList.

Herramientas para PowerShell V5

Ejemplo 1: devuelve el conjunto de paneles de su cuenta.

Get-CWDashboardList

Salida:

DashboardArn DashboardName LastModified        Size
------------ ------------- ------------        ----
arn:...      Dashboard1    7/6/2017 8:14:15 PM 252

Ejemplo 2: devuelve el conjunto de paneles de su cuenta cuyos nombres comienzan con el prefijo “dev”.

Get-CWDashboardList -DashboardNamePrefix dev

• Para obtener información sobre la API, consulte ListDashboards en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).

Remove-CWDashboard

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-CWDashboard.

Herramientas para PowerShell V5

Ejemplo 1: elimina el panel especificado y lo confirma antes de continuar. Para omitir la confirmación, agregue el modificador -Force al comando.

Remove-CWDashboard -DashboardName Dashboard1

• Para obtener información sobre la API, consulte DeleteDashboards en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).

Write-CWDashboard

En el siguiente ejemplo de código, se muestra cómo utilizar Write-CWDashboard.

Herramientas para PowerShell V5

Ejemplo 1: crea o actualiza el panel denominado “Dashboard1” para incluir dos widgets de métricas uno al lado del otro.

$dashBody = @"
{
    "widgets":[
        {
             "type":"metric",
             "x":0,
             "y":0,
             "width":12,
             "height":6,
             "properties":{
                "metrics":[
                   [
                      "AWS/EC2",
                      "CPUUtilization",
                      "InstanceId",
                      "i-012345"
                   ]
                ],
                "period":300,
                "stat":"Average",
                "region":"us-east-1",
                "title":"EC2 Instance CPU"
             }
        },
        {
             "type":"metric",
             "x":12,
             "y":0,
             "width":12,
             "height":6,
             "properties":{
                "metrics":[
                   [
                      "AWS/S3",
                      "BucketSizeBytes",
                      "BucketName",
                      "amzn-s3-demo-bucket"
                   ]
                ],
                "period":86400,
                "stat":"Maximum",
                "region":"us-east-1",
                "title":"amzn-s3-demo-bucket bytes"
            }
        }
    ]
}
"@

Write-CWDashboard -DashboardName Dashboard1 -DashboardBody $dashBody

Ejemplo 2: crea o actualiza el panel y canaliza el contenido que describe el panel al cmdlet.

$dashBody = @"
{
...
}
"@
        
$dashBody | Write-CWDashboard -DashboardName Dashboard1

• Para obtener información sobre la API, consulte PutDashboard en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).

Write-CWMetricData

En el siguiente ejemplo de código, se muestra cómo utilizar Write-CWMetricData.

Herramientas para PowerShell V5

Ejemplo 1: crea un nuevo objeto MetricDatum y lo escribe en Métricas de CloudWatch de Amazon Web Services.

### Create a MetricDatum .NET object
$Metric = New-Object -TypeName Amazon.CloudWatch.Model.MetricDatum
$Metric.Timestamp = [DateTime]::UtcNow
$Metric.MetricName = 'CPU'
$Metric.Value = 50

### Write the metric data to the CloudWatch service
Write-CWMetricData -Namespace instance1 -MetricData $Metric

• Para obtener información sobre la API, consulte PutMetricData en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).