Ejemplos de CloudWatch con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)
Acciones

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Ejemplos de CloudWatch con las Herramientas para PowerShell V4

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante Herramientas de AWS para PowerShell V4 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

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

Herramientas para PowerShell V4

Ejemplo 1: Devuelve todas las alarmas, incluidas las alarmas compuestas y métricas, de CloudWatch.

Get-CWAlarm -MaxRecords 1

Salida:

CompositeAlarms MetricAlarms         NextToken
--------------- ------------         ---------
                {MetricAlarms-01}    NextToken-01
                {MetricAlarms-02}    NextToken-02
                {MetricAlarms-03}    NextToken-03

Ejemplo 2: Devuelve solo los datos de alarmas compuestas de CloudWatch después de establecer el parámetro -AlarmType como CompositeAlarms.

Get-CWAlarm -AlarmType 'CompositeAlarms'

Salida:

CompositeAlarms        MetricAlarms NextToken
---------------        ------------ ---------
{CompositeAlarms-01}
{CompositeAlarms-02}
{CompositeAlarms-03}

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

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

Herramientas para PowerShell V4

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 (V4).

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

Herramientas para PowerShell V4

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 (V4).

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

Herramientas para PowerShell V4

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 (V4).

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

Herramientas para PowerShell V4

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 (V4).

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

Herramientas para PowerShell V4

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 (V4).