Upgrade správy starších pravidel na aktuální rozhraní API upozornění protokolu ze starší verze rozhraní API upozornění Log Analytics

Poznámka

Tento článek je relevantní jenom pro veřejnost Azure (ne pro Azure Government nebo cloud Azure China).

Poznámka

Jakmile se uživatel rozhodne přepnout pravidla se starší verzí správy na aktuální plánované rozhraní APIQueryRules , není možné se vrátit zpět ke staršímu staršímu staršímu rozhraní API upozornění Log Analytics.

V minulosti uživatelé ke správě pravidel upozornění protokolu použili starší rozhraní API upozornění Log Analytics . V současné době pracovní prostory používají rozhraní ScheduledQueryRules API pro nová pravidla. Tento článek popisuje výhody a proces přepnutí správy starších pravidel upozornění protokolu ze starší verze rozhraní API na aktuální rozhraní API.

Výhody

  • Spravujte všechna pravidla protokolu v jednom rozhraní API.
  • Jedna šablona pro vytvoření pravidel upozornění (dříve potřebovala tři samostatné šablony).
  • Jedno rozhraní API pro upozornění protokolu všech prostředků Azure
  • Podpora stavových (Preview) a 1minutových upozornění protokolu
  • Rutiny PowerShellu a podpora Azure CLI pro přepnulá pravidla
  • Zarovnání závažností se všemi ostatními typy výstrah a novějšími pravidly
  • Možnost vytvořit upozornění protokolu mezi pracovními prostory , které zahrnuje několik externích prostředků, jako jsou pracovní prostory Služby Log Analytics nebo prostředky Application Insights pro přepnulá pravidla.
  • Uživatelé můžou určit dimenze, které mají rozdělit výstrahy pro přepnulá pravidla.
  • Upozornění protokolu mají pro přepnutá pravidla delší dobu až dva dny dat (dříve omezená na jeden den).

Dopad

Proces

Zobrazte pracovní prostory pro upgrade pomocí tohoto dotazu Azure Resource Graph Exploreru. Otevřete odkaz, vyberte všechna dostupná předplatná a spusťte dotaz.

Proces přepínání není interaktivní a ve většině případů nevyžaduje ruční kroky. Během nebo po přepnutí se pravidla upozornění nezastavují nebo zastavují. Toto volání provede přepnutí všech pravidel upozornění přidružených ke každému pracovnímu prostoru služby Log Analytics:

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

S textem požadavku obsahujícím následující JSON:

{
    "scheduledQueryRulesEnabled" : true
}

Tady je příklad použití ARMClient, opensourcového nástroje příkazového řádku, který zjednodušuje volání výše uvedeného rozhraní API:

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

Můžete také použít nástroj Azure CLI :

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

Pokud je přepínač úspěšný, odpověď je následující:

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

Kontrola stavu přepnutí pracovního prostoru

Pomocí tohoto volání rozhraní API můžete také zkontrolovat stav přepínače:

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

Můžete také použít nástroj ARMClient :

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

Můžete také použít nástroj Azure CLI :

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

Pokud se pracovní prostor služby Log Analytics přepnul na plánované rozhraní APIQueryRules, odpověď je následující:

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

Pokud se pracovní prostor služby Log Analytics nepřepnul, odpověď je následující:

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

Další kroky