Exemplos do CloudWatch que usam o Tools for PowerShell V4 - Ferramentas da AWS para PowerShell (versão 4)
Ações

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Exemplos do CloudWatch que usam o Tools for PowerShell V4

Os exemplos de código a seguir mostram a você como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 com o CloudWatch.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Get-CWAlarm.

Ferramentas para PowerShell V4

Exemplo 1: retorna todos os alarmes, incluindo alarmes compostos e de métrica do CloudWatch.

Get-CWAlarm -MaxRecords 1

Saída:

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

Exemplo 2: retorna somente os dados de alarmes compostos do CloudWatch após definir o parâmetro -AlarmType como CompositeAlarms.

Get-CWAlarm -AlarmType 'CompositeAlarms'

Saída:

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

  • Para ver detalhes da API, consulte DescribeAlarms na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).

O código de exemplo a seguir mostra como usar Get-CWDashboard.

Ferramentas para PowerShell V4

Exemplo 1: retorna o ARN do corpo do painel especificado.

Get-CWDashboard -DashboardName Dashboard1

Saída:

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

  • Para obter detalhes da API, consulte GetDashboard em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-CWDashboardList.

Ferramentas para PowerShell V4

Exemplo 1: retorna a coleção de painéis para sua conta.

Get-CWDashboardList

Saída:

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

Exemplo 2: retorna a coleção de painéis para sua conta cujos nomes começam com o prefixo “dev'.

Get-CWDashboardList -DashboardNamePrefix dev

  • Para obter detalhes da API, consulte ListDashboards na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Remove-CWDashboard.

Ferramentas para PowerShell V4

Exemplo 1: exclui o painel especificado, solicitando uma confirmação antes de continuar. Para ignorar a confirmação, adicione a opção -Force para o comando.

Remove-CWDashboard -DashboardName Dashboard1

  • Para obter detalhes da API, consulte DeleteDashboards na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Write-CWDashboard.

Ferramentas para PowerShell V4

Exemplo 1: cria ou atualiza o painel denominado “Dashboard1” para incluir dois widgets de métricas lado a lado.

$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

Exemplo 2: cria ou atualiza o painel, redirecionando o conteúdo que descreve o painel para o cmdlet.

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

  • Para obter detalhes da API, consulte PutDashboard na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Write-CWMetricData.

Ferramentas para PowerShell V4

Exemplo 1: cria um novo objeto MetricDatum e o grava nas métricas do CloudWatch da 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 obter detalhes da API, consulte PutMetricData na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).