Atualizar a gestão de regras legadas para a API de Alertas de Registo atual a partir da API de Alertas do Log Analytics legada

  • Artigo
  • 3 minutos para ler

Nota

Este artigo só é relevante para clouds públicas e governamentais do Azure (não para a cloud do Azure China).

Nota

Quando um utilizador opta por mudar as regras com a gestão legada para a API scheduledQueryRules atual, não é possível reverter para a API de Alerta do Log Analytics antiga legada.

No passado, os utilizadores utilizaram a API de Alertas do Log Analytics legada para gerir as regras de alerta de registo. Atualmente, as áreas de trabalho utilizam a API ScheduledQueryRules para novas regras. Este artigo descreve os benefícios e o processo de mudança da gestão de regras de alertas de registo legadas da API legada para a API atual.

Benefícios

  • Gerir todas as regras de registo numa API.
  • Modelo único para a criação de regras de alerta (anteriormente necessários três modelos separados).
  • API única para todos os alertas de registo de recursos do Azure.
  • Suporte para alertas de registo com monitorização de estado (pré-visualização) e de 1 minuto.
  • Cmdlets do PowerShell e suporte da CLI do Azure para regras comutada.
  • Alinhamento de gravidades com todos os outros tipos de alerta e regras mais recentes.
  • Capacidade de criar um alerta de registo entre áreas de trabalho que abrange vários recursos externos, como áreas de trabalho do Log Analytics ou recursos do Application Insights para regras comutados.
  • Os utilizadores podem especificar dimensões para dividir os alertas de regras comutados.
  • Os alertas de registo prolongaram um período máximo de dois dias de dados (anteriormente limitados a um dia) para regras comutados.

Impacto

Processo

Ver áreas de trabalho para atualizar com esta consulta do Azure Resource Graph Explorer. Abra a ligação, selecione todas as subscrições disponíveis e execute a consulta.

O processo de mudança não é interativo e não requer passos manuais, na maioria dos casos. As regras de alerta não são paradas ou paradas, durante ou após a mudança. Efetue esta chamada para mudar todas as regras de alerta associadas a cada uma das áreas de trabalho do Log Analytics:

PUT /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

Com o corpo do pedido que contém o JSON abaixo:

{
    "scheduledQueryRulesEnabled" : true
}

Eis um exemplo de utilização do ARMClient, uma ferramenta de linha de comandos open source, que simplifica a invocação da chamada à API acima:

$switchJSON = '{"scheduledQueryRulesEnabled": true}'
armclient PUT /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview $switchJSON

Também pode utilizar a ferramenta da CLI do Azure :

az rest --method put --url /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview --body "{\"scheduledQueryRulesEnabled\" : true}"

Se o comutador for bem-sucedido, a resposta será:

{
    "version": 2,
    "scheduledQueryRulesEnabled" : true
}

Verificar o estado de mudança da área de trabalho

Também pode utilizar esta chamada à API para verificar o estado do comutador:

GET /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

Também pode utilizar a ferramenta ARMClient :

armclient GET /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

Também pode utilizar a ferramenta da CLI do Azure :

az rest --method get --url /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

Se a área de trabalho do Log Analytics tiver sido mudada para a API scheduledQueryRules, a resposta será:

{
    "version": 2,
    "scheduledQueryRulesEnabled" : true
}

Se a área de trabalho do Log Analytics não tiver sido trocada, a resposta será:

{
    "version": 2,
    "scheduledQueryRulesEnabled" : false
}

Passos seguintes