Szybki start: tworzenie alertów dziennika aktywności w powiadomieniach usługi przy użyciu pliku Bicep

  • Artykuł

W tym artykule pokazano, jak skonfigurować alerty dziennika aktywności dla powiadomień o kondycji usługi przy użyciu pliku Bicep.

Bicep to język specyficzny dla domeny (DSL), który używa składni deklaratywnej do wdrażania zasobów platformy Azure. Zapewnia zwięzłą składnię, niezawodne bezpieczeństwo typów i obsługę ponownego użycia kodu. Aplikacja Bicep oferuje najlepsze środowisko tworzenia rozwiązań infrastruktury jako kodu na platformie Azure.

Kondycja usługi powiadomienia są przechowywane w dzienniku aktywności platformy Azure. Biorąc pod uwagę prawdopodobnie dużą ilość informacji przechowywanych w dzienniku aktywności, istnieje oddzielny interfejs użytkownika, który ułatwia wyświetlanie i konfigurowanie alertów dotyczących powiadomień o kondycji usługi.

Alert można otrzymywać, gdy platforma Azure wysyła powiadomienia o kondycji usługi do subskrypcji platformy Azure. Alert można skonfigurować na podstawie następujących elementów:

  • Klasa powiadomień o kondycji usługi (problemy z usługą, planowana konserwacja, porady dotyczące kondycji).
  • Subskrypcja, której dotyczy problem.
  • Dotyczy to usług.
  • Dotyczy to regionów.

Uwaga

Kondycja usługi powiadomienia nie wysyłają alertu dotyczącego zdarzeń dotyczących kondycji zasobów.

Możesz również skonfigurować, do kogo powinien zostać wysłany alert:

  • Wybierz istniejącą grupę akcji.
  • Utwórz nową grupę akcji (która może być używana dla przyszłych alertów).

Aby dowiedzieć się więcej na temat grup akcji, zobacz Tworzenie grup akcji i zarządzanie nimi.

Wymagania wstępne

Przejrzyj plik Bicep

Poniższy plik Bicep tworzy grupę akcji z elementem docelowym wiadomości e-mail i włącza wszystkie powiadomienia o kondycji usługi dla subskrypcji docelowej. Zapisz ten plik Bicep jako CreateServiceHealthAlert.bicep.

param actionGroups_name string = 'SubHealth'
param activityLogAlerts_name string = 'ServiceHealthActivityLogAlert'
param emailAddress string

var alertScope = '/subscriptions/${subscription().subscriptionId}'

resource actionGroups_name_resource 'microsoft.insights/actionGroups@2019-06-01' = {
  name: actionGroups_name
  location: 'Global'
  properties: {
    groupShortName: actionGroups_name
    enabled: true
    emailReceivers: [
      {
        name: actionGroups_name
        emailAddress: emailAddress
      }
    ]
    smsReceivers: []
    webhookReceivers: []
  }
}

resource activityLogAlerts_name_resource 'microsoft.insights/activityLogAlerts@2017-04-01' = {
  name: activityLogAlerts_name
  location: 'Global'
  properties: {
    scopes: [
      alertScope
    ]
    condition: {
      allOf: [
        {
          field: 'category'
          equals: 'ServiceHealth'
        }
        {
          field: 'properties.incidentType'
          equals: 'Incident'
        }
      ]
    }
    actions: {
      actionGroups: [
        {
          actionGroupId: actionGroups_name_resource.id
          webhookProperties: {}
        }
      ]
    }
    enabled: true
  }
}

Plik Bicep definiuje dwa zasoby:

Wdrażanie pliku Bicep

Wdróż plik Bicep przy użyciu interfejsu wiersza polecenia platformy Azure i Azure PowerShell. Zastąp przykładowe wartości grupy zasobów i adresu e-mailAddress odpowiednimi wartościami środowiska.

az login
az deployment group create --name CreateServiceHealthAlert --resource-group my-resource-group --template-file CreateServiceHealthAlert.bicep --parameters emailAddress='user@contoso.com'

Weryfikowanie wdrożenia

Sprawdź, czy obszar roboczy został utworzony przy użyciu jednego z następujących poleceń. Zastąp przykładowe wartości grupy zasobów wartością użytą powyżej.

az monitor activity-log alert show --resource-group my-resource-group --name ServiceHealthActivityLogAlert

Oczyszczanie zasobów

Jeśli planujesz kontynuować pracę z kolejnymi przewodnikami Szybki start i samouczkami, warto pozostawić te zasoby. Gdy grupa zasobów nie będzie już potrzebna, usuń grupę zasobów, która usuwa regułę alertu i powiązane zasoby. Aby usunąć grupę zasobów przy użyciu interfejsu wiersza polecenia platformy Azure lub Azure PowerShell

az group delete --name my-resource-group

Następne kroki