Exemplos de início rápido do Azure PowerShell de MonitorAzure Monitor PowerShell quick start samples

Este artigo será apresentado exemplo de comandos do PowerShell para o ajudar a aceder aos recursos do Azure Monitor.This article shows you sample PowerShell commands to help you access Azure Monitor features.

Nota

O Azure Monitor é o novo nome para o que foi chamado de "Azure Insights" até dia 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 nomes e, portanto, os seguintes comandos ainda contêm a palavra "informações".However, the namespaces and thus the following commands still contain the word "insights."

Nota

Este artigo foi atualizado para utilizar o novo módulo AZ do Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Pode continuar a utilizar o módulo AzureRM, que continuará a receber correções de erros até, pelo menos, dezembro de 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para obter mais informações sobre o novo módulo Az e a compatibilidade do AzureRM, veja Apresentação do novo módulo Az do Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obter instruções de instalação do módulo Az, veja Instalar o Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Configurar o PowerShellSet up PowerShell

Se ainda não o fez, configure o PowerShell para executar no 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 neste artigo mostram como pode utilizar os cmdlets do Azure Monitor.The examples in the article illustrate how you can use Azure Monitor cmdlets. Também pode rever a lista completa de cmdlets do PowerShell de Monitor do Azure no Cmdlets do Azure Monitor (informações).You can also review the entire list of Azure Monitor PowerShell cmdlets at Azure Monitor (Insights) Cmdlets.

Iniciar sessão e utilizar as subscriçõesSign in and use subscriptions

Inicie sessão em primeiro lugar, na sua subscrição do Azure.First, log in to your Azure subscription.

Connect-AzAccount

Verá um ecrã de início de sessão.You'll see a sign in screen. Uma vez que iniciar sessão na sua conta, TenantID, e o padrão de ID de subscrição são apresentados.Once you sign in your Account, TenantID, and default Subscription ID are displayed. Todos os cmdlets do Azure funciona no contexto de sua assinatura padrão.All the Azure cmdlets work in the context of your default subscription. Para ver a lista de subscrições 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 seu contexto de trabalho (que seus comandos são executados na subscrição), 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 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>

Obter o registo de atividades para uma subscriçãoRetrieve Activity log for a subscription

Utilize o Get-AzLog cmdlet.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. Usando as datas antes deste resultados de tempo numa mensagem de erro.Using dates before this time results in an error message.

Veja o que a data/hora atual está a verificar o que o tempo para utilizar os comandos abaixo:See what the current date/time are to verify what times to use in the commands below:

Get-Date

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

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

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

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

Obter entradas de log do grupo de recursos específico:Get log entries from a specific resource group:

Get-AzLog -ResourceGroup 'myrg1'

Obter entradas de registo de um fornecedor de recursos específico entre um intervalo de data/hora: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

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

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

O seguinte comando obtém os últimas 1 000 eventos de registo de atividades:The following command retrieves the last 1000 events from the activity log:

Get-AzLog -MaxRecord 10

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

Nota

Get-AzLog Fornece apenas 15 dias do histórico.Get-AzLog only provides 15 days of history. Utilizar o - MaxRecords parâmetro permite-lhe consultar os eventos de N últimos, além de 15 dias.Using the -MaxRecords parameter allows you to query the last N events, beyond 15 days. Para mais de 15 dias de eventos de acesso, utilize a REST API ou 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 StartTime, em seguida, o valor predefinido é EndTime menos uma hora.If you do not include StartTime, then the default value is EndTime minus one hour. Se não incluir EndTime, em seguida, o valor predefinido é a hora atual.If you do not include EndTime, then the default value is current time. Todas as horas são em formato UTC.All times are in UTC.

Obter histórico de alertasRetrieve alerts history

Para ver todos os eventos de alerta, pode consultar os registos do Azure Resource Manager com os exemplos seguintes.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 ver o histórico para uma regra de alerta específico, pode usar o Get-AzAlertHistory cmdlet, passando o ID de recurso de 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 oferece suporte a vários parâmetros.The Get-AzAlertHistory cmdlet supports various parameters. Obter mais informações, consulte Get-AlertHistory.More information, see Get-AlertHistory.

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

Todos os comandos seguintes agirem sobre um grupo de recursos com o nome "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

Obter todos os alertas num grupo de recursos:Retrieve all alerts on a resource group:

Get-AzAlertRule -ResourceGroup montest

Obter todas as regras de alerta definido para um recurso de destino.Retrieve all alert rules set for a target resource. Por exemplo, todas as regras de alerta definido numa 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 oferece suporte a outros parâmetros.Get-AzAlertRule supports other parameters. Ver 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 e New-AzAlertRuleWebhook, respectivamente.You can create email and webhook properties using New-AzAlertRuleEmail and New-AzAlertRuleWebhook, respectively. O cmdlet de regra de alerta, atribuir essas propriedades como ações para o ações propriedade de 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 através de uma métrica.The following table describes the parameters and values used to create an alert using a metric.

Parâmetroparameter valuevalue
NameName simpletestdiskwritesimpletestdiskwrite
Localização desta regra de alertaLocation of this alert rule East USEast US
ResourceGroupResourceGroup montestmontest
TargetResourceIdTargetResourceId /subscriptions/s1/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/testconfig/subscriptions/s1/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/testconfig
MetricName do alerta que é criadoMetricName of the alert that is created \PhysicalDisk(_Total)\Disk Writes/sec. See the Get-MetricDefinitions cmdlet about how to retrieve the exact metric names\PhysicalDisk(_Total)\Disk Writes/sec. See the Get-MetricDefinitions cmdlet about how to retrieve the exact metric names
Operadoroperator GreaterThanGreaterThan
Valor de limiar (contagem por segundo para esta métrica)Threshold value (count/sec in for this metric) 11
WindowSize (formato hh: mm:)WindowSize (hh:mm:ss format) 00:05:0000:05:00
agregador (estatística da métrica, que usa a contagem média, neste caso)aggregator (statistic of the metric, which uses Average count, in this case) AverageAverage
e-mails personalizados (matriz de cadeia de caracteres)custom emails (string array) 'foo@example.com','bar@example.com''foo@example.com','bar@example.com'
enviar um e-mail para proprietários, contribuidores 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 de WebhookCreate a Webhook action

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

Criar a regra de alerta sobre a métrica de % de CPU numa VM clássicaCreate 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%"

Obter a regra de alertaRetrieve the alert rule

Get-AzAlertRule -Name vmcpu_gt_1 -ResourceGroup myrg1 -DetailedOutput

O cmdlet de alerta de adicionar também atualiza a regra se já existe uma regra de alerta para as propriedades de determinada.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.

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

Pode utilizar o Get-AzMetricDefinition cmdlet para ver 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 a métrica de nome e a unidade para ele.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 para Get-AzMetricDefinition está disponível em 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 atividades.You can use the Set-AzActivityLogAlert cmdlet to set an Activity Log alert. Um alerta de registo de atividades requer que primeiro define suas condições como um dicionário de condições, em seguida, criar um alerta que utiliza 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 de webhook adicionais são opcionais.The additional webhook properties are optional. Pode obter novamente o conteúdo de um alerta de registo de atividade usando Get-AzActivityLogAlert.You can get back the contents of an Activity Log Alert using Get-AzActivityLogAlert.

Criar e gerir definições de dimensionamento automáticoCreate and manage AutoScale settings

Um recurso (uma aplicação Web, VM, serviço Cloud ou o conjunto de dimensionamento de máquinas virtuais) pode ter apenas uma definição de dimensionamento automático 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 dimensionamento automático pode ter vários perfis.However, each autoscale setting can have multiple profiles. Por exemplo, um para um perfil de dimensionamento baseados no desempenho e um segundo para um perfil com base na 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 no mesmo.Each profile can have multiple rules configured on it. Para obter mais informações sobre o dimensionamento automático, consulte como Dimensionar automaticamente um aplicativo.For more information about Autoscale, see How to Autoscale an Application.

Eis os passos a utilizar:Here are the steps to use:

  1. Crie Regra (s).Create rule(s).
  2. Crie perfis mapear as regras que criou anteriormente para os perfis.Create profile(s) mapping the rules that you created previously to the profiles.
  3. Opcional: Configurar propriedades de e-mail e webhook para criar notificações do dimensionamento automático.Optional: Create notifications for autoscale by configuring webhook and email properties.
  4. Crie uma definição de dimensionamento automático com um nome do recurso de destino, mapeando os perfis e as 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 seguintes mostram como pode criar uma definição de dimensionamento automático para um conjunto de dimensionamento de Máquina Virtual para um sistema de operativo do Windows com base com a métrica de utilização da 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, crie uma regra para aumentar horizontalmente, com um aumento de contagem de instância.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, crie uma regra para reduzir horizontalmente, com uma diminuição de contagem de instância.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

Em seguida, crie 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 do 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 dimensionamento automático, 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 dimensionamento automático 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 de definições de dimensionamento automático, consulte Get-AutoscaleSetting.For more information about managing Autoscale settings, see Get-AutoscaleSetting.

Histórico de dimensionamento automáticoAutoscale history

O exemplo seguinte mostra como pode ver o dimensionamento automático recente e eventos de alerta.The following example shows you how you can view recent autoscale and alert events. Utilize a pesquisa de registos de atividade para ver o histórico de dimensionamento automático.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 obter o histórico de dimensionamento automático.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 obter mais informações, consulte Get-AutoscaleHistory.For more information, see Get-AutoscaleHistory.

Ver detalhes de uma definição de dimensionamento automáticoView details for an autoscale setting

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

O exemplo seguinte mostra detalhes sobre todas as definições de dimensionamento automático 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 seguinte mostra detalhes sobre todas as definições de dimensionamento automático no grupo de recursos "myrg1' e especificamente a definição de dimensionamento automático com o nome '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

Remover uma definição de dimensionamento automáticoRemove an autoscale setting

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

Remove-AzAutoscalesetting -ResourceGroup myrg1 -Name MyScaleVMSSSetting

Gerir perfis de registo para o registo de atividadesManage log profiles for activity log

Pode criar uma perfil de registo e exportar dados a partir do seu registo de atividades para uma conta de armazenamento e podem 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 ao seu Hub de eventos.Optionally, you can also stream the data to your Event Hub. Esta funcionalidade está 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 é predefinido para a subscrição atual, pode sempre alterar esses 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 os dados para qualquer conta de armazenamento ou Hub de eventos nessa subscrição.You can configure activity log to route data to any storage account or Event Hub within that subscription. Dados são escritos como ficheiros de blob no formato JSON.Data is written as blob files in JSON format.

Obter um perfil de registoGet a log profile

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

Adicionar um perfil de registo sem a 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 -Locations 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

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

Pode especificar a - RetentionInDays propriedade com o número de dias, como um número inteiro, 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 -Locations global,westus,eastus,northeurope,westeurope,eastasia,southeastasia,japaneast,japanwest,northcentralus,southcentralus,eastus2,centralus,australiaeast,australiasoutheast,brazilsouth,centralindia,southindia,westindia -RetentionInDays 90

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

Além do encaminhamento seus dados para a conta de armazenamento, pode também transmitir para um Hub 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 de conta de armazenamento é obrigatória, mas a configuração do Hub de eventos é 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 -Locations global,westus,eastus,northeurope,westeurope,eastasia,southeastasia,japaneast,japanwest,northcentralus,southcentralus,eastus2,centralus,australiaeast,australiasoutheast,brazilsouth,centralindia,southindia,westindia -RetentionInDays 90

Configurar os registos de diagnósticoConfigure diagnostics logs

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

  • ser configurado para guardar os dados na sua conta de armazenamento do Azurebe configured to save data in your Azure Storage account
  • enviado para os Hubs de eventossent to Event Hubs
  • enviado para uma área de trabalho do Log Analytics.sent to a Log Analytics workspace.

A operação só pode ser executada num nível de recursos.The operation can only be performed at a resource level. O hub de evento ou a conta de armazenamento deve estar presente na mesma região que o recurso de destino em que 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.

Obter 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 o período de retenção para uma categoria de registo específicosEnable 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 os Hubs 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

Tenha em atenção que a propriedade WorkspaceId leva a ID de recurso da área de trabalho.Note that the WorkspaceId property takes the resource ID of the workspace. Pode obter o ID de recurso da sua área de trabalho do Log Analytics com 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.