O Application Insights é um serviço de monitoramento de desempenho de aplicativos da Microsoft Azure que permite aos desenvolvedores e administradores monitorar a performance e a saúde de suas aplicações. Uma das funcionalidades poderosas do Application Insights são os Workbooks, que permitem a criação de relatórios e dashboards interativos.

Neste artigo, vamos explorar como utilizar o cmdlet New-AzApplicationInsightsWorkbook no PowerShell para criar e gerenciar esses Workbooks. Esse cmdlet faz parte do módulo Az.ApplicationInsights, que fornece uma interface para interagir com o Application Insights diretamente do PowerShell.

Pré-requisitos

Antes de começarmos, certifique-se de que você tem os seguintes pré-requisitos:

1. Conta Azure: Você deve ter uma conta ativa no Azure.
2. Módulo Az.ApplicationInsights: Este módulo deve estar instalado no seu ambiente PowerShell. Você pode instalá-lo usando o comando:

   Install-Module -Name Az.ApplicationInsights -AllowClobber -Force

3. Autenticação no Azure: Você deve estar autenticado no Azure. Utilize o comando:

   Connect-AzAccount

Exemplo 1: Criando um Workbook Simples

Vamos começar criando um Workbook simples. Este exemplo cria um Workbook com um título e uma descrição básica.

# Parâmetros do Workbook
$resourceGroupName = "SeuResourceGroup"
$applicationInsightsName = "SeuAppInsights"
$workbookName = "MeuPrimeiroWorkbook"
$workbookTitle = "Título do Workbook"
$workbookDescription = "Descrição do Workbook"

# JSON de configuração do Workbook
$workbookConfig = @"
{
    "version": "Notebook/1.0",
    "items": [
        {
            "type": 1,
            "content": {
                "json": {
                    "chartId": "chart1",
                    "title": "Exemplo de Gráfico",
                    "query": "requests | summarize count() by bin(timestamp, 1h)",
                    "chartType": "line"
                }
            }
        }
    ]
}
"@

# Criando o Workbook
New-AzApplicationInsightsWorkbook -ResourceGroupName $resourceGroupName -ResourceName $applicationInsightsName -Name $workbookName -Title $workbookTitle -Description $workbookDescription -SerializedData $workbookConfig

Exemplo 2: Atualizando um Workbook Existente

Se você já possui um Workbook e deseja atualizá-lo, você pode usar o cmdlet Set-AzApplicationInsightsWorkbook.

# Parâmetros do Workbook
$resourceGroupName = "SeuResourceGroup"
$applicationInsightsName = "SeuAppInsights"
$workbookName = "MeuPrimeiroWorkbook"
$workbookTitle = "Título Atualizado do Workbook"
$workbookDescription = "Descrição Atualizada do Workbook"

# JSON de configuração do Workbook atualizado
$workbookConfigAtualizado = @"
{
    "version": "Notebook/1.0",
    "items": [
        {
            "type": 1,
            "content": {
                "json": {
                    "chartId": "chart1",
                    "title": "Exemplo de Gráfico Atualizado",
                    "query": "requests | summarize count() by bin(timestamp, 1h)",
                    "chartType": "bar"
                }
            }
        }
    ]
}
"@

# Atualizando o Workbook
Set-AzApplicationInsightsWorkbook -ResourceGroupName $resourceGroupName -ResourceName $applicationInsightsName -Name $workbookName -Title $workbookTitle -Description $workbookDescription -SerializedData $workbookConfigAtualizado

Exemplo 3: Deletando um Workbook

Para deletar um Workbook existente, utilize o cmdlet Remove-AzApplicationInsightsWorkbook.

# Parâmetros do Workbook
$resourceGroupName = "SeuResourceGroup"
$applicationInsightsName = "SeuAppInsights"
$workbookName = "MeuPrimeiroWorkbook"

# Deletando o Workbook
Remove-AzApplicationInsightsWorkbook -ResourceGroupName $resourceGroupName -ResourceName $applicationInsightsName -Name $workbookName

Conclusão

Neste artigo, vimos como criar, atualizar e deletar Workbooks no Application Insights utilizando o PowerShell. Esses comandos são extremamente úteis para automatizar a gestão de Workbooks e integrar o monitoramento de aplicações em seus scripts de gerenciamento.