Amostras de PowerShell monitor Azure MonitorAzure Monitor PowerShell samples

Este artigo mostra-lhe a amostra de comandos PowerShell para ajudá-lo a aceder às funcionalidades do Azure Monitor.This article shows you sample PowerShell commands to help you access Azure Monitor features.

Nota

Azure Monitor é o novo nome do que foi chamado de "Azure Insights" até 25 de setembro de 2016.Azure Monitor is the new name for what was called "Azure Insights" until Sept 25th, 2016. No entanto, os espaços de nome e, portanto, os seguintes comandos ainda contêm a palavra insights.However, the namespaces and thus the following commands still contain the word insights.

Nota

Este artigo foi atualizado para utilizar o módulo Azure Az PowerShell.This article has been updated to use the Azure Az PowerShell module. O módulo Az PowerShell é o módulo do PowerShell recomendado para interagir com o Azure.The Az PowerShell module is the recommended PowerShell module for interacting with Azure. Para começar a utilizar o módulo Azure PowerShell, veja Instalar o Azure PowerShell.To get started with the Az PowerShell module, see Install Azure PowerShell. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.To learn how to migrate to the Az PowerShell module, see Migrate Azure PowerShell from AzureRM to Az.

Configurar PowerShellSet up PowerShell

Se ainda não o fez, configura o PowerShell para executar o seu computador.If you haven't already, set up PowerShell to run on your computer. Para obter mais informações, consulte Como Instalar e Configurar o PowerShell.For more information, see How to Install and Configure PowerShell.

Exemplos neste artigoExamples in this article

Os exemplos do artigo ilustram como pode utilizar cmdlets do Azure Monitor.The examples in the article illustrate how you can use Azure Monitor cmdlets. Também pode rever toda a lista de cmdlets Azure Monitor PowerShell no Azure Monitor (Insights) Cmdlets.You can also review the entire list of Azure Monitor PowerShell cmdlets at Azure Monitor (Insights) Cmdlets.

Iniciar s.000 e utilizar subscriçõesSign in and use subscriptions

Primeiro, faça login na sua assinatura Azure.First, log in to your Azure subscription.

Connect-AzAccount

Verá um sinal no ecrã.You'll see a sign in screen. Assim que assinar na sua Conta, o TenantID e o ID de subscrição predefinido são apresentados.Once you sign in your Account, TenantID, and default Subscription ID are displayed. Todos os cmdlets Azure funcionam no contexto da sua subscrição padrão.All the Azure cmdlets work in the context of your default subscription. Para ver a lista de subscrições a que tem acesso, utilize o seguinte comando:To view the list of subscriptions you have access to, use the following command:

Get-AzSubscription

Para ver o seu contexto de trabalho (contra a subscrição dos seus comandos), utilize o seguinte comando:To see your working context (which subscription your commands are run against), use the following command:

Get-AzContext

Para alterar o seu contexto de trabalho para uma subscrição diferente, utilize o seguinte comando:To change your working context to a different subscription, use the following command:

Set-AzContext -SubscriptionId <subscriptionid>

Registar atividades de recuperaçãoRetrieve Activity log

Utilize o cmdlet Get-AzLog.Use the Get-AzLog cmdlet. Seguem-se alguns exemplos comuns.The following are some common examples. O Registo de atividades mantém os últimos 90 dias de operações.The Activity Log holds the last 90 days of operations. A utilização de datas antes desta hora resulta numa mensagem de erro.Using dates before this time results in an error message.

Veja qual a data/hora atuais para verificar as horas a utilizar nos comandos abaixo:See what the current date/time are to verify what times to use in the commands below:

Get-Date

Obtenha entradas de registo a partir desta hora/data para apresentar:Get log entries from this time/date to present:

Get-AzLog -StartTime 2019-03-01T10:30

Obtenha entradas de registo entre um intervalo de hora/data:Get log entries between a time/date range:

Get-AzLog -StartTime 2019-01-01T10:30 -EndTime 2015-01-01T11:30

Obtenha entradas de registo de um grupo de recursos específico:Get log entries from a specific resource group:

Get-AzLog -ResourceGroup 'myrg1'

Obtenha entradas de registo de um fornecedor de recursos específico entre um intervalo de tempo/data:Get log entries from a specific resource provider between a time/date range:

Get-AzLog -ResourceProvider 'Microsoft.Web' -StartTime 2015-01-01T10:30 -EndTime 2015-01-01T11:30

Obtenha todas as entradas de registo com um chamador específico:Get all log entries with a specific caller:

Get-AzLog -Caller 'myname@company.com'

O seguinte comando recupera os últimos 1000 eventos do registo de atividades:The following command retrieves the last 1000 events from the activity log:

Get-AzLog -MaxRecord 1000

Get-AzLog suporta muitos outros parâmetros.Get-AzLog supports many other parameters. Consulte a Get-AzLog referência para mais informações.See the Get-AzLog reference for more information.

Nota

Get-AzLog só fornece 15 dias de história.Get-AzLog only provides 15 days of history. A utilização do parâmetro -MaxRecords permite-lhe consultar os últimos N eventos, para além dos 15 dias.Using the -MaxRecords parameter allows you to query the last N events, beyond 15 days. Para aceder a eventos com mais de 15 dias, utilize a API REST ou o SDK (exemplo de C# com o SDK).To access events older than 15 days, use the REST API or SDK (C# sample using the SDK). Se não incluir o StartTime, o valor predefinido será EndTime menos uma hora.If you do not include StartTime, then the default value is EndTime minus one hour. Se não incluir o EndTime, o valor predefinido será a hora atual.If you do not include EndTime, then the default value is current time. Todas as horas estão em UTC.All times are in UTC.

Recuperar alertas históricoRetrieve alerts history

Para visualizar todos os eventos de alerta, pode consultar os registos do Azure Resource Manager utilizando os seguintes exemplos.To view all alert events, you can query the Azure Resource Manager logs using the following examples.

Get-AzLog -Caller "Microsoft.Insights/alertRules" -DetailedOutput -StartTime 2015-03-01

Para visualizar o histórico para uma regra de alerta específica, pode utilizar o Get-AzAlertHistory cmdlet, passando no ID de recurso da regra de alerta.To view the history for a specific alert rule, you can use the Get-AzAlertHistory cmdlet, passing in the resource ID of the alert rule.

Get-AzAlertHistory -ResourceId /subscriptions/s1/resourceGroups/rg1/providers/microsoft.insights/alertrules/myalert -StartTime 2016-03-1 -Status Activated

O Get-AzAlertHistory cmdlet suporta vários parâmetros.The Get-AzAlertHistory cmdlet supports various parameters. Mais informações, consulte a História do Alerta.More information, see Get-AlertHistory.

Recuperar informações sobre regras de alertaRetrieve information on alert rules

Todos os seguintes comandos atuam num Grupo de Recursos chamado "montest".All of the following commands act on a Resource Group named "montest".

Ver todas as propriedades da regra de alerta:View all the properties of the alert rule:

Get-AzAlertRule -Name simpletestCPU -ResourceGroup montest -DetailedOutput

Recupere todos os alertas de um grupo de recursos:Retrieve all alerts on a resource group:

Get-AzAlertRule -ResourceGroup montest

Recupere todas as regras de alerta definidas para um recurso alvo.Retrieve all alert rules set for a target resource. Por exemplo, todas as regras de alerta definidas num VM.For example, all alert rules set on a VM.

Get-AzAlertRule -ResourceGroup montest -TargetResourceId /subscriptions/s1/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/testconfig

Get-AzAlertRule suporta outros parâmetros.Get-AzAlertRule supports other parameters. Consulte o Get-AlertRule para obter mais informações.See Get-AlertRule for more information.

Criar alertas de métricasCreate metric alerts

Pode utilizar o Add-AlertRule cmdlet para criar, atualizar ou desativar uma regra de alerta.You can use the Add-AlertRule cmdlet to create, update, or disable an alert rule.

Pode criar propriedades de e-mail e webhook usando New-AzAlertRuleEmail New-AzAlertRuleWebhook e, respectivamente.You can create email and webhook properties using New-AzAlertRuleEmail and New-AzAlertRuleWebhook, respectively. Na regra de alerta, atribuir estes imóveis como ações à propriedade de Ações da Regra de Alerta.In the Alert rule cmdlet, assign these properties as actions to the Actions property of the Alert Rule.

A tabela seguinte descreve os parâmetros e valores utilizados para criar um alerta utilizando uma métrica.The following table describes the parameters and values used to create an alert using a metric.

parameterparameter valorvalue
NameName simpletestdiskwritesimpletestdiskwrite
Localização desta regra de alertaLocation of this alert rule E.U.A. LesteEast US
ResourceGroupResourceGroup montestmontest
TargetResourceIdTargetResourceId /subscrições/s1/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/testconfig/subscriptions/s1/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/testconfig
Nome métrico do alerta que é criadoMetricName of the alert that is created \PhysicalDisk (_Total)\Discos de disco/seg. Veja o Get-MetricDefinitions cmdlet sobre como recuperar os nomes métricos exatos\PhysicalDisk(_Total)\Disk Writes/sec. See the Get-MetricDefinitions cmdlet about how to retrieve the exact metric names
operadoroperator GreaterThanGreaterThan
Valor limiar (contagem/seg para esta métrica)Threshold value (count/sec in for this metric) 11
JanelaSSize (formato hh:mm:ss)WindowSize (hh:mm:ss format) 00:05:0000:05:00
agregador (estatística da métrica, que utiliza a contagem média, neste caso)aggregator (statistic of the metric, which uses Average count, in this case) MédiaAverage
e-mails personalizados (matriz de cordas)custom emails (string array) 'foo@example.com','bar@example.com''foo@example.com','bar@example.com'
enviar e-mail para proprietários, colaboradores e leitoressend email to owners, contributors and readers -SendToServiceOwners-SendToServiceOwners

Criar uma ação de e-mailCreate an Email action

$actionEmail = New-AzAlertRuleEmail -CustomEmail myname@company.com

Criar uma ação WebhookCreate a Webhook action

$actionWebhook = New-AzAlertRuleWebhook -ServiceUri https://example.com?token=mytoken

Crie a regra de alerta na métrica cpu% num VM clássicoCreate the alert rule on the CPU% metric on a classic VM

Add-AzMetricAlertRule -Name vmcpu_gt_1 -Location "East US" -ResourceGroup myrg1 -TargetResourceId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.ClassicCompute/virtualMachines/my_vm1 -MetricName "Percentage CPU" -Operator GreaterThan -Threshold 1 -WindowSize 00:05:00 -TimeAggregationOperator Average -Action $actionEmail, $actionWebhook -Description "alert on CPU > 1%"

Recuperar a regra de alertaRetrieve the alert rule

Get-AzAlertRule -Name vmcpu_gt_1 -ResourceGroup myrg1 -DetailedOutput

O Cmdlet de alerta add também atualiza a regra se já existe uma regra de alerta para as propriedades dadas.The Add alert cmdlet also updates the rule if an alert rule already exists for the given properties. Para desativar uma regra de alerta, inclua o parâmetro -DisableRule.To disable an alert rule, include the parameter -DisableRule.

Obtenha uma lista de métricas disponíveis para alertasGet a list of available metrics for alerts

Pode utilizar o Get-AzMetricDefinition cmdlet para visualizar a lista de todas as métricas para um recurso específico.You can use the Get-AzMetricDefinition cmdlet to view the list of all metrics for a specific resource.

Get-AzMetricDefinition -ResourceId <resource_id>

O exemplo a seguir gera uma tabela com o Nome métrico e a Unidade para o mesmo.The following example generates a table with the metric Name and the Unit for it.

Get-AzMetricDefinition -ResourceId <resource_id> | Format-Table -Property Name,Unit

Uma lista completa das opções disponíveis Get-AzMetricDefinition está disponível na Get-MetricDefinitions.A full list of available options for Get-AzMetricDefinition is available at Get-MetricDefinitions.

Criar e gerir alertas de Registo de AtividadesCreate and manage Activity Log alerts

Pode utilizar o Set-AzActivityLogAlert cmdlet para definir um alerta de Registo de Atividade.You can use the Set-AzActivityLogAlert cmdlet to set an Activity Log alert. Um alerta de Registo de Atividade requer que primeiro defina as suas condições como um dicionário de condições e, em seguida, crie um alerta que utilize essas condições.An Activity Log alert requires that you first define your conditions as a dictionary of conditions, then create an alert that uses those conditions.


$condition1 = New-AzActivityLogAlertCondition -Field 'category' -Equal 'Administrative'
$condition2 = New-AzActivityLogAlertCondition -Field 'operationName' -Equal 'Microsoft.Compute/virtualMachines/write'
$additionalWebhookProperties = New-Object "System.Collections.Generic.Dictionary``2[System.String,System.String]"
$additionalWebhookProperties.Add('customProperty', 'someValue')
$actionGrp1 = New-AzActionGroup -ActionGroupId '/subscriptions/<subid>/providers/Microsoft.Insights/actiongr1' -WebhookProperty $additionalWebhookProperties
Set-AzActivityLogAlert -Location 'Global' -Name 'alert on VM create' -ResourceGroupName 'myResourceGroup' -Scope '/subscriptions/<subid>' -Action $actionGrp1 -Condition $condition1, $condition2

As propriedades adicionais do webhook são opcionais.The additional webhook properties are optional. Pode recuperar o conteúdo de um Alerta de Registo de Atividade utilizando Get-AzActivityLogAlert .You can get back the contents of an Activity Log Alert using Get-AzActivityLogAlert.

Criar e gerir definições de AutoScaleCreate and manage AutoScale settings

Nota

Para serviços cloud (Microsoft.ClassicCompute), a autoescala suporta um grão de tempo de 5 minutos (PT5M).For Cloud Services (Microsoft.ClassicCompute), autoscale supports a time grain of 5 minutes (PT5M). Para os outros serviços, a autoescala suporta um grão de tempo de mínimo de 1 minuto (PT1M)For the other services autoscale supports a time grain of minimum of 1 minute (PT1M)

Um recurso (uma aplicação Web, VM, Cloud Service ou Virtual Machine Scale set) pode ter apenas uma definição de escala automática configurada para o mesmo.A resource (a Web app, VM, Cloud Service, or Virtual Machine Scale Set) can have only one autoscale setting configured for it. No entanto, cada definição de autoescala pode ter vários perfis.However, each autoscale setting can have multiple profiles. Por exemplo, um para um perfil de escala baseado no desempenho e um segundo para um perfil baseado em agenda.For example, one for a performance-based scale profile and a second one for a schedule-based profile. Cada perfil pode ter várias regras configuradas nele.Each profile can have multiple rules configured on it. Para obter mais informações sobre a Autoscale, consulte Como autoescalar uma aplicação.For more information about Autoscale, see How to Autoscale an Application.

Aqui estão os passos a utilizar:Here are the steps to use:

  1. Criar regras.s.Create rule(s).
  2. Crie perfis mapeando as regras que criou anteriormente para os perfis.Create profile(s) mapping the rules that you created previously to the profiles.
  3. Opcional: Criar notificações para autoescala configurando propriedades webhook e email.Optional: Create notifications for autoscale by configuring webhook and email properties.
  4. Crie uma definição de autoescalação com um nome no recurso-alvo mapeando os perfis e notificações que criou nos passos anteriores.Create an autoscale setting with a name on the target resource by mapping the profiles and notifications that you created in the previous steps.

Os exemplos que se seguem mostram-lhe como pode criar uma definição de escala automática para um Conjunto de Escala de Máquina Virtual para um sistema operativo Windows baseado na métrica de utilização do CPU.The following examples show you how you can create an Autoscale setting for a Virtual Machine Scale Set for a Windows operating system based by using the CPU utilization metric.

Primeiro, criar uma regra para escalar, com um aumento da contagem de casos.First, create a rule to scale out, with an instance count increase.

$rule1 = New-AzAutoscaleRule -MetricName "Percentage CPU" -MetricResourceId /subscriptions/s1/resourceGroups/big2/providers/Microsoft.Compute/virtualMachineScaleSets/big2 -Operator GreaterThan -MetricStatistic Average -Threshold 60 -TimeGrain 00:01:00 -TimeWindow 00:10:00 -ScaleActionCooldown 00:10:00 -ScaleActionDirection Increase -ScaleActionValue 1

Em seguida, criar uma regra para escalar, com uma contagem de casos diminuir.Next, create a rule to scale in, with an instance count decrease.

$rule2 = New-AzAutoscaleRule -MetricName "Percentage CPU" -MetricResourceId /subscriptions/s1/resourceGroups/big2/providers/Microsoft.Compute/virtualMachineScaleSets/big2 -Operator GreaterThan -MetricStatistic Average -Threshold 30 -TimeGrain 00:01:00 -TimeWindow 00:10:00 -ScaleActionCooldown 00:10:00 -ScaleActionDirection Decrease -ScaleActionValue 1

Então, criar um perfil para as regras.Then, create a profile for the rules.

$profile1 = New-AzAutoscaleProfile -DefaultCapacity 2 -MaximumCapacity 10 -MinimumCapacity 2 -Rules $rule1,$rule2 -Name "My_Profile"

Crie uma propriedade webhook.Create a webhook property.

$webhook_scale = New-AzAutoscaleWebhook -ServiceUri "https://example.com?mytoken=mytokenvalue"

Crie a propriedade de notificação para a definição de autoescala, incluindo o e-mail e o webhook que criou anteriormente.Create the notification property for the autoscale setting, including email and the webhook that you created previously.

$notification1= New-AzAutoscaleNotification -CustomEmails ashwink@microsoft.com -SendEmailToSubscriptionAdministrators SendEmailToSubscriptionCoAdministrators -Webhooks $webhook_scale

Por fim, crie a definição de autoescala para adicionar o perfil que criou anteriormente.Finally, create the autoscale setting to add the profile that you created previously.

Add-AzAutoscaleSetting -Location "East US" -Name "MyScaleVMSSSetting" -ResourceGroup big2 -TargetResourceId /subscriptions/s1/resourceGroups/big2/providers/Microsoft.Compute/virtualMachineScaleSets/big2 -AutoscaleProfiles $profile1 -Notifications $notification1

Para obter mais informações sobre a gestão das definições de Autoscale, consulte Get-AutoscaleSetting.For more information about managing Autoscale settings, see Get-AutoscaleSetting.

História da autoescalaAutoscale history

O exemplo que se segue mostra-lhe como pode ver eventos recentes de autoescala e alerta.The following example shows you how you can view recent autoscale and alert events. Utilize a pesquisa de registo de atividade para visualizar o histórico de autoescala.Use the activity log search to view the autoscale history.

Get-AzLog -Caller "Microsoft.Insights/autoscaleSettings" -DetailedOutput -StartTime 2015-03-01

Pode utilizar o Get-AzAutoScaleHistory cmdlet para recuperar o histórico da AutoScale.You can use the Get-AzAutoScaleHistory cmdlet to retrieve AutoScale history.

Get-AzAutoScaleHistory -ResourceId /subscriptions/s1/resourceGroups/myrg1/providers/microsoft.insights/autoscalesettings/myScaleSetting -StartTime 2016-03-15 -DetailedOutput

Para mais informações, consulte a História da Escala Automática.For more information, see Get-AutoscaleHistory.

Ver detalhes para uma definição de escala automáticaView details for an autoscale setting

Pode utilizar o Get-Autoscalesetting cmdlet para obter mais informações sobre a definição de autoescala.You can use the Get-Autoscalesetting cmdlet to retrieve more information about the autoscale setting.

O exemplo a seguir mostra detalhes sobre todas as definições de autoescala no grupo de recursos 'myrg1'.The following example shows details about all autoscale settings in the resource group 'myrg1'.

Get-AzAutoscalesetting -ResourceGroup myrg1 -DetailedOutput

O exemplo a seguir mostra detalhes sobre todas as definições de autoescala no grupo de recursos 'myrg1' e especificamente a definição de autoescala denominada 'MyScaleVMSSSetting'.The following example shows details about all autoscale settings in the resource group 'myrg1' and specifically the autoscale setting named 'MyScaleVMSSSetting'.

Get-AzAutoscalesetting -ResourceGroup myrg1 -Name MyScaleVMSSSetting -DetailedOutput

Remova uma definição de autoescalaRemove an autoscale setting

Pode utilizar o Remove-Autoscalesetting cmdlet para eliminar uma definição de escala automática.You can use the Remove-Autoscalesetting cmdlet to delete an autoscale setting.

Remove-AzAutoscalesetting -ResourceGroup myrg1 -Name MyScaleVMSSSetting

Gerir perfis de registo para registo de atividadeManage log profiles for activity log

Pode criar um perfil de registo e exportar dados do seu registo de atividade para uma conta de armazenamento e pode configurar a retenção de dados para o mesmo.You can create a log profile and export data from your activity log to a storage account and you can configure data retention for it. Opcionalmente, também pode transmitir os dados para o seu Centro de Eventos.Optionally, you can also stream the data to your Event Hub. Esta funcionalidade encontra-se atualmente em Pré-visualização e só pode criar um perfil de registo por subscrição.This feature is currently in Preview and you can only create one log profile per subscription. Pode utilizar os seguintes cmdlets com a sua subscrição atual para criar e gerir perfis de registo.You can use the following cmdlets with your current subscription to create and manage log profiles. Também pode escolher uma subscrição específica.You can also choose a particular subscription. Embora o PowerShell predefinindo a subscrição atual, pode sempre alterar isso utilizando Set-AzContext .Although PowerShell defaults to the current subscription, you can always change that using Set-AzContext. Pode configurar o registo de atividades para encaminhar dados para qualquer conta de armazenamento ou Centro de Eventos dentro dessa subscrição.You can configure activity log to route data to any storage account or Event Hub within that subscription. Os dados são escritos como ficheiros blob no formato JSON.Data is written as blob files in JSON format.

Obtenha um perfil de registoGet a log profile

Para obter os perfis de registo existentes, utilize o Get-AzLogProfile cmdlet.To fetch your existing log profiles, use the Get-AzLogProfile cmdlet.

Adicionar um perfil de registo sem retenção de dadosAdd a log profile without data retention

Add-AzLogProfile -Name my_log_profile_s1 -StorageAccountId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Storage/storageAccounts/my_storage -Location global,westus,eastus,northeurope,westeurope,eastasia,southeastasia,japaneast,japanwest,northcentralus,southcentralus,eastus2,centralus,australiaeast,australiasoutheast,brazilsouth,centralindia,southindia,westindia

Remover um perfil de registoRemove a log profile

Remove-AzLogProfile -name my_log_profile_s1

Adicione um perfil de registo com a retenção de dadosAdd a log profile with data retention

Pode especificar a propriedade -RetentionInDays com o número de dias, como um número inteiro positivo, onde os dados são retidos.You can specify the -RetentionInDays property with the number of days, as a positive integer, where the data is retained.

Add-AzLogProfile -Name my_log_profile_s1 -StorageAccountId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Storage/storageAccounts/my_storage -Location global,westus,eastus,northeurope,westeurope,eastasia,southeastasia,japaneast,japanwest,northcentralus,southcentralus,eastus2,centralus,australiaeast,australiasoutheast,brazilsouth,centralindia,southindia,westindia -RetentionInDays 90

Adicione o perfil de registo com retenção e EventHubAdd log profile with retention and EventHub

Além de encaminhar os seus dados para a conta de armazenamento, também pode transmiti-lo para um Centro de Eventos.In addition to routing your data to storage account, you can also stream it to an Event Hub. Nesta versão de pré-visualização, a configuração da conta de armazenamento é obrigatória, mas a configuração do Event Hub é opcional.In this preview release the storage account configuration is mandatory but Event Hub configuration is optional.

Add-AzLogProfile -Name my_log_profile_s1 -StorageAccountId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Storage/storageAccounts/my_storage -serviceBusRuleId /subscriptions/s1/resourceGroups/Default-ServiceBus-EastUS/providers/Microsoft.ServiceBus/namespaces/mytestSB/authorizationrules/RootManageSharedAccessKey -Location global,westus,eastus,northeurope,westeurope,eastasia,southeastasia,japaneast,japanwest,northcentralus,southcentralus,eastus2,centralus,australiaeast,australiasoutheast,brazilsouth,centralindia,southindia,westindia -RetentionInDays 90

Configurar registos de diagnósticosConfigure diagnostics logs

Muitos serviços da Azure fornecem registos e telemetria adicionais que podem fazer um ou mais dos seguintes:Many Azure services provide additional logs and telemetry that can do one or more of the following:

  • ser configurado para guardar dados na sua conta de Armazenamento Azurebe configured to save data in your Azure Storage account
  • enviado para Centros de Eventossent to Event Hubs
  • enviado para um espaço de trabalho Log Analytics.sent to a Log Analytics workspace.

A operação só pode ser efetuada a nível de recursos.The operation can only be performed at a resource level. A conta de armazenamento ou o centro de eventos devem estar presentes na mesma região que o recurso-alvo onde a definição de diagnóstico está configurada.The storage account or event hub should be present in the same region as the target resource where the diagnostics setting is configured.

Obtenha a definição de diagnósticoGet diagnostic setting

Get-AzDiagnosticSetting -ResourceId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Logic/workflows/andy0315logicapp

Desativar a definição de diagnósticoDisable diagnostic setting

Set-AzDiagnosticSetting -ResourceId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Logic/workflows/andy0315logicapp -StorageAccountId /subscriptions/s1/resourceGroups/Default-Storage-WestUS/providers/Microsoft.Storage/storageAccounts/mystorageaccount -Enable $false

Ativar a definição de diagnóstico sem retençãoEnable diagnostic setting without retention

Set-AzDiagnosticSetting -ResourceId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Logic/workflows/andy0315logicapp -StorageAccountId /subscriptions/s1/resourceGroups/Default-Storage-WestUS/providers/Microsoft.Storage/storageAccounts/mystorageaccount -Enable $true

Ativar a definição de diagnóstico com retençãoEnable diagnostic setting with retention

Set-AzDiagnosticSetting -ResourceId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Logic/workflows/andy0315logicapp -StorageAccountId /subscriptions/s1/resourceGroups/Default-Storage-WestUS/providers/Microsoft.Storage/storageAccounts/mystorageaccount -Enable $true -RetentionEnabled $true -RetentionInDays 90

Ativar a definição de diagnóstico com retenção para uma categoria de registo específicoEnable diagnostic setting with retention for a specific log category

Set-AzDiagnosticSetting -ResourceId /subscriptions/s1/resourceGroups/insights-integration/providers/Microsoft.Network/networkSecurityGroups/viruela1 -StorageAccountId /subscriptions/s1/resourceGroups/myrg1/providers/Microsoft.Storage/storageAccounts/sakteststorage -Categories NetworkSecurityGroupEvent -Enable $true -RetentionEnabled $true -RetentionInDays 90

Ativar a definição de diagnóstico para centros de eventosEnable diagnostic setting for Event Hubs

Set-AzDiagnosticSetting -ResourceId /subscriptions/s1/resourceGroups/insights-integration/providers/Microsoft.Network/networkSecurityGroups/viruela1 -serviceBusRuleId /subscriptions/s1/resourceGroups/Default-ServiceBus-EastUS/providers/Microsoft.ServiceBus/namespaces/mytestSB/authorizationrules/RootManageSharedAccessKey -Enable $true

Ativar a definição de diagnóstico para o Log AnalyticsEnable diagnostic setting for Log Analytics

Set-AzDiagnosticSetting -ResourceId /subscriptions/s1/resourceGroups/insights-integration/providers/Microsoft.Network/networkSecurityGroups/viruela1 -WorkspaceId /subscriptions/s1/resourceGroups/insights-integration/providers/providers/microsoft.operationalinsights/workspaces/myWorkspace -Enabled $true

Note que a propriedade WorkspaceId requer o ID de recursos do espaço de trabalho.Note that the WorkspaceId property takes the resource ID of the workspace. Pode obter o ID de recurso do seu espaço de trabalho Log Analytics utilizando o seguinte comando:You can obtain the resource ID of your Log Analytics workspace using the following command:

(Get-AzOperationalInsightsWorkspace).ResourceId

Estes comandos podem ser combinados para enviar dados para vários destinos.These commands can be combined to send data to multiple destinations.