Ejemplos de PowerShell de Azure MonitorAzure Monitor PowerShell samples

En este artículo se muestran comandos de PowerShell de ejemplo para ayudarle a acceder a las características de Azure Monitor.This article shows you sample PowerShell commands to help you access Azure Monitor features.

Nota

Azure Monitor es el nuevo nombre de lo que se conocía como "Azure Insights" hasta el 25 de septiembre de 2016.Azure Monitor is the new name for what was called "Azure Insights" until Sept 25th, 2016. Sin embargo, los espacios de nombres y, por tanto, los siguientes comandos, aún contienen el término insights.However, the namespaces and thus the following commands still contain the word insights.

Nota

Este artículo se ha actualizado para usar el módulo Az de Azure PowerShell.This article has been updated to use the Azure Az PowerShell module. El módulo Az de PowerShell es el módulo de PowerShell que se recomienda para interactuar con Azure.The Az PowerShell module is the recommended PowerShell module for interacting with Azure. Para empezar a trabajar con el módulo Az de PowerShell, consulte Instalación de Azure PowerShell.To get started with the Az PowerShell module, see Install Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.To learn how to migrate to the Az PowerShell module, see Migrate Azure PowerShell from AzureRM to Az.

Configurar PowerShellSet up PowerShell

Si no lo ha hecho ya, configure PowerShell para que se ejecute en el equipo.If you haven't already, set up PowerShell to run on your computer. Para más información, consulte el artículo de instalación y configuración de PowerShell.For more information, see How to Install and Configure PowerShell.

Ejemplos de este artículoExamples in this article

Los ejemplos de este artículo muestran cómo puede usar cmdlets de Azure Monitor.The examples in the article illustrate how you can use Azure Monitor cmdlets. También puede consultar toda la lista de cmdlets de PowerShell de Azure Monitor en Azure Monitor Cmdlets (Cmdlets de Azure Monitor).You can also review the entire list of Azure Monitor PowerShell cmdlets at Azure Monitor (Insights) Cmdlets.

Inicio de sesión y uso de suscripcionesSign in and use subscriptions

Primero, inicie sesión en la suscripción de Azure.First, log in to your Azure subscription.

Connect-AzAccount

Verá una pantalla de inicio de sesión.You'll see a sign in screen. Una vez que inicie sesión, se muestran el identificador predeterminado de la suscripción, el identificador de inquilino y la cuenta.Once you sign in your Account, TenantID, and default Subscription ID are displayed. Todos los cmdlets de Azure funcionan en el contexto de la suscripción predeterminada.All the Azure cmdlets work in the context of your default subscription. Para ver la lista de suscripciones a las que tiene acceso, use el siguiente comando:To view the list of subscriptions you have access to, use the following command:

Get-AzSubscription

Para ver el contexto de trabajo (en qué suscripción se ejecutan los comandos), use el siguiente comando:To see your working context (which subscription your commands are run against), use the following command:

Get-AzContext

Para cambiar el contexto de trabajo a una suscripción diferente, utilice el siguiente comando:To change your working context to a different subscription, use the following command:

Set-AzContext -SubscriptionId <subscriptionid>

Recuperación del registro de actividadRetrieve Activity log

Use el cmdlet Get AzLog.Use the Get-AzLog cmdlet. A continuación se muestran algunos ejemplos comunes.The following are some common examples. El registro de actividad contiene los últimos 90 días de operaciones.The Activity Log holds the last 90 days of operations. El uso de las fechas anteriores a ese período provoca un mensaje de error.Using dates before this time results in an error message.

Vea cuál es la fecha y hora actual para comprobar qué períodos se deben usar en el siguiente comando:See what the current date/time are to verify what times to use in the commands below:

Get-Date

Obtención de entradas de registro desde esta fecha y hora hasta la actual:Get log entries from this time/date to present:

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

Obtención de entradas de registro entre un intervalo de fecha y hora:Get log entries between a time/date range:

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

Obtención de entradas de registro de un grupo de recursos específico:Get log entries from a specific resource group:

Get-AzLog -ResourceGroup 'myrg1'

Obtención de entradas de registro de un proveedor de recursos específico entre un intervalo de fecha y 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

Obtener todas las entradas de registro con un llamador concreto:Get all log entries with a specific caller:

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

El comando siguiente recupera los últimos 1000 eventos desde el registro de actividades:The following command retrieves the last 1000 events from the activity log:

Get-AzLog -MaxRecord 1000

Get-AzLog es compatible con muchos otros parámetros.Get-AzLog supports many other parameters. Consulte la referencia Get-AzLog para obtener más información.See the Get-AzLog reference for more information.

Nota

Get-AzLog solo proporciona 15 días de historial.Get-AzLog only provides 15 days of history. El parámetro -MaxRecords permite consultar los últimos eventos N más allá de 15 días.Using the -MaxRecords parameter allows you to query the last N events, beyond 15 days. Para acceder a eventos de hace más de 15 días, use el SDK o la API de REST (ejemplo de C# usando el SDK).To access events older than 15 days, use the REST API or SDK (C# sample using the SDK). Si no incluye StartTime, el valor predeterminado será EndTime menos una hora.If you do not include StartTime, then the default value is EndTime minus one hour. Si no incluye EndTime, el valor predeterminado será la hora actual.If you do not include EndTime, then the default value is current time. Todas las horas se muestran en UTC.All times are in UTC.

Recuperación del historial de alertasRetrieve alerts history

Para ver todos los eventos de alerta, puede consultar los registros de Azure Resource Manager con los ejemplos siguientes.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 el historial de una regla de alerta específica, puede utilizar el cmdlet Get-AzAlertHistory, con lo que se transmitirá el id. de recurso de la regla 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

El cmdlet Get-AzAlertHistory admite varios parámetros.The Get-AzAlertHistory cmdlet supports various parameters. Puede obtener más información en Get-AlertHistory.More information, see Get-AlertHistory.

Recuperación de información sobre reglas de alertaRetrieve information on alert rules

Todos los comandos siguientes se realizan en un grupo de recursos denominado "montest".All of the following commands act on a Resource Group named "montest".

Consulta de todas las propiedades de la regla de alerta:View all the properties of the alert rule:

Get-AzAlertRule -Name simpletestCPU -ResourceGroup montest -DetailedOutput

Recuperación de todas las alertas de un grupo de recursos:Retrieve all alerts on a resource group:

Get-AzAlertRule -ResourceGroup montest

Recuperación de todas las reglas de alerta de un recurso de destino.Retrieve all alert rules set for a target resource. Por ejemplo, todas las reglas de alerta se establecen en una máquina virtual.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 es compatible con otros parámetros.Get-AzAlertRule supports other parameters. Consulte Get AlertRule para obtener más información.See Get-AlertRule for more information.

Creación de alertas de métricaCreate metric alerts

Puede usar el cmdlet Add-AlertRule para crear, actualizar o deshabilitar una regla de alerta.You can use the Add-AlertRule cmdlet to create, update, or disable an alert rule.

Puede crear propiedades de correo electrónico y webhook mediante New-AzAlertRuleEmail y New-AzAlertRuleWebhook respectivamente.You can create email and webhook properties using New-AzAlertRuleEmail and New-AzAlertRuleWebhook, respectively. En el cmdlet de regla de alerta, asigne estas propiedades como acciones a la propiedad Actions de la regla de alerta.In the Alert rule cmdlet, assign these properties as actions to the Actions property of the Alert Rule.

En la tabla siguiente se describen los parámetros y valores utilizados para crear una alerta con una métrica.The following table describes the parameters and values used to create an alert using a metric.

parámetroparameter valuevalue
NombreName simpletestdiskwritesimpletestdiskwrite
Ubicación (Location) de esta regla de alertaLocation of this alert rule Este de EE. UU.East US
ResourceGroupResourceGroup montestmontest
TargetResourceIdTargetResourceId /subscriptions/s1/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/testconfig/subscriptions/s1/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/testconfig
Nombre de la métrica (MetricName) de la alerta que se creaMetricName of the alert that is created \Disco físico(_Total)\Escrituras de disco/s. Consulte el cmdlet Get-MetricDefinitions acerca de cómo recuperar los nombres exactos de las métricas\PhysicalDisk(_Total)\Disk Writes/sec. See the Get-MetricDefinitions cmdlet about how to retrieve the exact metric names
operatoroperator GreaterThanGreaterThan
Valor de umbral (número por segundo para esta métrica)Threshold value (count/sec in for this metric) 11
WindowSize (formato hh:mm:ss)WindowSize (hh:mm:ss format) 00:05:0000:05:00
aggregator (estadística de la métrica que, en este caso, usa el recuento medio)aggregator (statistic of the metric, which uses Average count, in this case) AverageAverage
mensajes de correo electrónico personalizados (matriz de cadenas)custom emails (string array) 'foo@example.com','bar@example.com''foo@example.com','bar@example.com'
enviar correo electrónico a los propietarios, colaboradores y lectoressend email to owners, contributors and readers -SendToServiceOwners-SendToServiceOwners

Creación de una acción de correo electrónicoCreate an Email action

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

Crear una acción de WebhookCreate a Webhook action

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

Creación de la regla de alerta de la métrica CPU% en una máquina virtual clásicaCreate 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%"

Recuperación de la regla de alertaRetrieve the alert rule

Get-AzAlertRule -Name vmcpu_gt_1 -ResourceGroup myrg1 -DetailedOutput

El cmdlet Add alert también actualiza la regla si ya existe una para las propiedades determinadas.The Add alert cmdlet also updates the rule if an alert rule already exists for the given properties. Para deshabilitar una regla de alerta, incluya el parámetro -DisableRule.To disable an alert rule, include the parameter -DisableRule.

Obtención de una lista de métricas disponibles para las alertasGet a list of available metrics for alerts

Puede usar el cmdlet Get-AzMetricDefinition para ver la lista de todas las métricas de un 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>

En el ejemplo siguiente se genera una tabla con el nombre y la unidad de la métrica.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

Hay disponible una lista completa de opciones para Get-AzMetricDefinition en Get-MetricDefinitions.A full list of available options for Get-AzMetricDefinition is available at Get-MetricDefinitions.

Creación y administración de alertas del registro de actividadesCreate and manage Activity Log alerts

Puede usar el cmdlet Set-AzActivityLogAlert para establecer una alerta de registro de actividad.You can use the Set-AzActivityLogAlert cmdlet to set an Activity Log alert. Una alerta de registro de actividad requiere que primero defina las condiciones como un diccionario de condiciones, y luego cree una alerta que utilice esas condiciones.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

Las propiedades de webhook adicionales son opcionales.The additional webhook properties are optional. Puede volver el contenido de una alerta de registro de actividad con Get-AzActivityLogAlert.You can get back the contents of an Activity Log Alert using Get-AzActivityLogAlert.

Creación y administración de la configuración de escalado automáticoCreate and manage AutoScale settings

Nota

Para Cloud Services (Microsoft.ClassicCompute), el escalado automático admite un intervalo de tiempo de 5 minutos (PT5M).For Cloud Services (Microsoft.ClassicCompute), autoscale supports a time grain of 5 minutes (PT5M). En el caso de los demás servicios, el escalado automático admite un intervalo de tiempo mínimo de 1 minuto (PT1M).For the other services autoscale supports a time grain of minimum of 1 minute (PT1M)

Los recursos (aplicaciones web, las máquinas virtuales, los servicios en la nube o los conjuntos de escalado de máquinas virtuales) solo pueden tener una configuración de escalado automático.A resource (a Web app, VM, Cloud Service, or Virtual Machine Scale Set) can have only one autoscale setting configured for it. Sin embargo, cada configuración de escalado automático puede tener varios perfiles.However, each autoscale setting can have multiple profiles. Por ejemplo, uno para un perfil de escalado basado en el rendimiento y otro para uno basado en la programación.For example, one for a performance-based scale profile and a second one for a schedule-based profile. Cada perfil puede tener varias reglas configuradas.Each profile can have multiple rules configured on it. Para obtener más información sobre el escalado automático, consulte Escalado automático de una aplicación.For more information about Autoscale, see How to Autoscale an Application.

Estos son los pasos que debe seguir:Here are the steps to use:

  1. Cree reglas.Create rule(s).
  2. Cree perfiles que asignen las reglas que ha creado anteriormente a los perfiles.Create profile(s) mapping the rules that you created previously to the profiles.
  3. Opcional: cree notificaciones de escalado automático configurando las propiedades de Webhook y correo electrónico.Optional: Create notifications for autoscale by configuring webhook and email properties.
  4. Cree una configuración de escalado automático con un nombre en el recurso de destino mediante la asignación de los perfiles y las notificaciones que creó en los pasos 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.

En los ejemplos siguientes se muestra cómo crear una configuración de escalado automático para un conjunto de escalado de máquinas virtuales de un sistema operativo de Windows mediante la métrica de uso de 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.

En primer lugar, cree una regla de escalado horizontal con aumento del recuento de instancias.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

Después, cree una regla de reducción de escalado con una disminución del recuento de instancias.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

Después, cree un perfil para las reglas.Then, create a profile for the rules.

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

Cree una propiedad de Webhook.Create a webhook property.

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

Cree la propiedad de notificación para la configuración de escalado automático, incluidas las de correo electrónico y Webhook que creó 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

Finalmente, cree la configuración de escalado automático para agregar el perfil que creó antes.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 obtener más información sobre cómo administrar la configuración de escalado automático, consulte Get-AutoscaleSetting.For more information about managing Autoscale settings, see Get-AutoscaleSetting.

Historial de escalado automáticoAutoscale history

En el ejemplo siguiente se muestra cómo puede ver los eventos de alerta y escalado automático recientes.The following example shows you how you can view recent autoscale and alert events. Utilice la búsqueda de registros de actividades para ver el historial de escalado automático.Use the activity log search to view the autoscale history.

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

Puede usar el cmdlet Get-AzAutoScaleHistory para recuperar el historial de escalado 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 obtener más información, consulte Get-AutoscaleHistory.For more information, see Get-AutoscaleHistory.

Consulta de los detalles de una configuración de escalado automáticoView details for an autoscale setting

Puede usar el cmdlet Get-Autoscalesetting para recuperar más información sobre la configuración de escalado automático.You can use the Get-Autoscalesetting cmdlet to retrieve more information about the autoscale setting.

En el ejemplo siguiente se muestra información sobre todas las configuraciones de escalado automático del grupo de recursos "myrg1".The following example shows details about all autoscale settings in the resource group 'myrg1'.

Get-AzAutoscalesetting -ResourceGroup myrg1 -DetailedOutput

En el ejemplo siguiente se muestra información sobre todas las configuraciones de escalado automático del grupo de recursos "myrg1" y, en concreto, la configuración de escalado automático con el nombre "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

Eliminación de una configuración de escalado automáticoRemove an autoscale setting

Puede usar el cmdlet Remove-Autoscalesetting para eliminar una configuración de escalado automático.You can use the Remove-Autoscalesetting cmdlet to delete an autoscale setting.

Remove-AzAutoscalesetting -ResourceGroup myrg1 -Name MyScaleVMSSSetting

Administración de perfiles de registro para el registro de actividadesManage log profiles for activity log

Puede crear un perfil de registro y exportar los datos de su registro de actividades a una cuenta de almacenamiento y configurar la retención de datos.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. Si lo desea, también puede transmitir los datos al Centro de eventos.Optionally, you can also stream the data to your Event Hub. Esta característica se encuentra actualmente en la fase de vista previa y solo puede crear un perfil de registro por suscripción.This feature is currently in Preview and you can only create one log profile per subscription. Puede utilizar los siguientes cmdlets con su suscripción actual para crear y administrar perfiles de registro.You can use the following cmdlets with your current subscription to create and manage log profiles. También puede elegir una suscripción específica.You can also choose a particular subscription. Aunque PowerShell tiene como valor predeterminado la suscripción actual, puede cambiarla cuando quiera con Set-AzContext.Although PowerShell defaults to the current subscription, you can always change that using Set-AzContext. Puede configurar el registro de actividades para enrutar los datos a cualquier cuenta de almacenamiento o al centro de eventos de dicha suscripción.You can configure activity log to route data to any storage account or Event Hub within that subscription. Los datos se escriben como archivos blob en formato JSON.Data is written as blob files in JSON format.

Obtención de un perfil de registroGet a log profile

Para capturar los perfiles de registro existentes, use el cmdlet Get-AzLogProfile .To fetch your existing log profiles, use the Get-AzLogProfile cmdlet.

Adición de un perfil de registro sin retención de datosAdd 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

Eliminación de un perfil de registroRemove a log profile

Remove-AzLogProfile -name my_log_profile_s1

Adición de un perfil de registro con retención de datosAdd a log profile with data retention

Puede especificar la propiedad -RetentionInDays con el número de días, como un entero positivo, que se conservarán los datos.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

Adición de un perfil de registro retención y EventHubAdd log profile with retention and EventHub

Además de enrutar los datos a la cuenta de almacenamiento, también puede transmitirlos a un Centro de eventos.In addition to routing your data to storage account, you can also stream it to an Event Hub. En esta versión preliminar, la configuración de la cuenta de almacenamiento es obligatoria; sin embargo, la configuración del Centro de eventos es 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

Configuración de registros de diagnósticoConfigure diagnostics logs

Muchos servicios de Azure proporcionan registros adicionales y telemetría que pueden realizar una o varias de las siguientes acciones:Many Azure services provide additional logs and telemetry that can do one or more of the following:

  • configurarse para guardar los datos en su cuenta de Azure Storage.be configured to save data in your Azure Storage account
  • enviarse a Event Hubs.sent to Event Hubs
  • enviarse a un área de trabajo de Log Analytics.sent to a Log Analytics workspace.

La operación solo puede realizarse en un nivel de recursos.The operation can only be performed at a resource level. La cuenta de almacenamiento o el centro de eventos debe encontrarse en la misma región que el recurso de destino donde se ha ajustado la configuración de diagnóstico.The storage account or event hub should be present in the same region as the target resource where the diagnostics setting is configured.

Obtención de la configuración de diagnósticoGet diagnostic setting

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

Deshabilitación de la configuración 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

Habilitación de la configuración de diagnóstico sin retenciónEnable 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

Habilitación la configuración de diagnóstico con retenciónEnable 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

Habilitación de la configuración de diagnóstico con retención para una categoría de registro específicaEnable 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

Habilitación de la configuración de diagnóstico para Event HubsEnable 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

Habilitación de la configuración de diagnóstico para 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

Tenga en cuenta que la propiedad WorkspaceId usa el id. de recurso del área de trabajo.Note that the WorkspaceId property takes the resource ID of the workspace. Puede obtener el identificador de recurso de su área de trabajo de Log Analytics con el comando siguiente:You can obtain the resource ID of your Log Analytics workspace using the following command:

(Get-AzOperationalInsightsWorkspace).ResourceId

Estos comandos se pueden combinar para enviar datos a varios destinos.These commands can be combined to send data to multiple destinations.