Integrace služby Azure Automation State Configuration s protokoly služby Azure Monitor

Azure Automation State Configuration uchovává data o stavu uzlu po dobu 30 dnů. Pokud dáváte přednost delšímu uchovávání těchto dat, můžete data stavu uzlu odeslat do protokolů služby Azure Monitor. Stav dodržování předpisů se zobrazuje na webu Azure Portal nebo v PowerShellu pro uzly a pro jednotlivé prostředky DSC v konfiguracích uzlů.

Protokoly služby Azure Monitor poskytují lepší provozní přehled o datech služby Automation State Configuration a můžou pomoct rychleji řešit incidenty. Protokoly služby Azure Monitor umožňují:

• Získejte informace o dodržování předpisů pro spravované uzly a jednotlivé prostředky.
• Aktivují e-mail nebo upozornění na základě stavu dodržování předpisů.
• Psaní pokročilých dotazů napříč spravovanými uzly
• Korelace stavu dodržování předpisů napříč účty Automation
• Pomocí vlastních zobrazení a vyhledávacích dotazů můžete vizualizovat výsledky runbooku, stav úlohy runbooku a další související klíčové ukazatele nebo metriky.

Požadavky

Pokud chcete začít odesílat sestavy služby Automation State Configuration do protokolů služby Azure Monitor, potřebujete:

• Modul modulu Az PowerShell. Ujistěte se, že máte nejnovější verzi. V případě potřeby spusťte Update-Module -Name Az.
• Účet Azure Automation. Další informace najdete v tématu Úvod ke službě Azure Automation.
• Pracovní prostor služby Log Analytics. Další informace najdete v přehledu protokolů služby Azure Monitor.
• Alespoň jeden uzel azure Automation State Configuration. Další informace najdete v tématu Onboarding machines for management by Azure Automation State Configuration.
• Modul xDscDiagnostics verze 2.7.0.0 nebo vyšší. Postup instalace najdete v tématu Řešení potíží se službou Azure Automation Desired State Configuration.

Nastavení integrace s protokoly služby Azure Monitor

Pokud chcete začít importovat data ze služby Azure Automation State Configuration do protokolů služby Azure Monitor, proveďte následující kroky. Postup použití portálu najdete v tématu Předávání dat úloh Azure Automation do protokolů služby Azure Monitor.

1. Z počítače se přihlaste k předplatnému Azure pomocí rutiny PowerShell Connect-AzAccount a postupujte podle pokynů na obrazovce.

   # Sign in to your Azure subscription
   $sub = Get-AzSubscription -ErrorAction SilentlyContinue
   if (-not($sub)) {
       Connect-AzAccount
   }
   # If you have multiple subscriptions, set the one to use
   # Select-AzSubscription -SubscriptionId "<SUBSCRIPTIONID>"
   

2. Zadejte odpovídající hodnotu pro proměnné automationAccount se skutečným názvem vašeho účtu Automation a workspaceName skutečným názvem pracovního prostoru služby Log Analytics. Pak spusťte skript.

   $automationAccount = "automationAccount"
   $law = "workspaceName"
   

3. Spuštěním následujících příkazů PowerShellu získejte ID prostředku vašeho účtu Automation.

   # Find the ResourceId for the Automation account
   $AutomationResourceId = (Get-AzResource -ResourceType 'Microsoft.Automation/automationAccounts' |
      Where-Object {$_.Name -eq $automationAccount}).ResourceId
   

4. Spuštěním následujících příkazů PowerShellu získejte ID prostředku pracovního prostoru služby Log Analytics.

    # Find the ResourceId for the Log Analytics workspace
    $WorkspaceResourceId = (Get-AzResource `
        -ResourceType 'Microsoft.OperationalInsights/workspaces' |
        WHERE {$_.Name -eq $law}).ResourceId
   

5. Pokud chcete nakonfigurovat nastavení diagnostiky v účtu Automation tak, aby předávala data protokolu stavu uzlu DSC do protokolů služby Azure Monitor, následující rutina PowerShellu vytvoří nastavení diagnostiky pomocí tohoto cíle.

   $setAzDiagnosticSettingSplat = @{
       ResourceId = $AutomationResourceId
       WorkspaceId = $WorkspaceResourceId
       Enabled = $true
       Category = 'DscNodeStatus'
   }
   Set-AzDiagnosticSetting @setAzDiagnosticSettingSplat
   

   Pokud chcete ukončit předávání dat protokolu ze služby Automation State Configuration do protokolů služby Azure Monitor, spusťte následující rutinu PowerShellu.

   $setAzDiagnosticSettingSplat = @{
       ResourceId = $AutomationResourceId
       WorkspaceId = $WorkspaceResourceId
       Enabled = $false
       Category = 'DscNodeStatus'
   }
   Set-AzDiagnosticSetting @setAzDiagnosticSettingSplat
   

Zobrazení protokolů konfigurace stavu

Protokoly konfigurace stavu pro operace DSC můžete prohledávat hledáním v protokolech služby Azure Monitor. Po nastavení integrace s protokoly služby Azure Monitor pro data služby Automation State Configuration přejděte na webu Azure Portal ke svému účtu Automation. Potom v části Monitorování vyberte Protokoly.

Zavřete dialogové okno Dotazy. Otevře se podokno Prohledávání protokolů s oblastí dotazu s oborem vašeho prostředku účtu Automation. Záznamy pro operace DSC jsou uloženy v AzureDiagnostics tabulce. Pokud chcete najít uzly, které nevyhovují předpisům, zadejte následující dotaz.

AzureDiagnostics
| where Category == "DscNodeStatus"
| where OperationName contains "DSCNodeStatusData"
| where ResultType != "Compliant"

Podrobnosti filtrování:

• DscNodeStatusData Vyfiltrujte, aby se vrátily operace pro každý uzel Konfigurace stavu.
• DscResourceStatusData Vyfiltrujte vrácení operací pro každý prostředek DSC volaný v konfiguraci uzlu použité pro daný prostředek.
• Filtrováním vrátíte DscResourceStatusData informace o chybě pro všechny prostředky DSC, které selžou.

Další informace o vytváření dotazů protokolu pro vyhledání dat najdete v tématu Přehled dotazů na protokoly ve službě Azure Monitor.

Odeslání e-mailu, když selže kontrola dodržování předpisů konfigurace stavu

1. Vraťte se k dříve vytvořenému dotazu.

2. Kliknutím na tlačítko + Nové pravidlo upozornění spustíte tok vytváření upozornění.

3. V následujícím dotazu nahraďte NODENAME skutečným názvem spravovaného uzlu a pak upravený dotaz vložte do textového pole vyhledávacího dotazu :

   AzureDiagnostics
   | where Category == "DscNodeStatus"
   | where NodeName_s == "NODENAME"
   | where OperationName == "DscNodeStatusData"
   | where ResultType == "Failed"
   

   Pokud nakonfigurujete protokoly pro více než jeden účet Automation nebo předplatné, můžete upozornění seskupit podle předplatného a účtu Automation. Odvodit název účtu Automation z Resource vlastnosti ve výsledcích DscNodeStatusDatahledání protokolu .

4. Projděte si vytváření, zobrazení a správu upozornění na metriky pomocí služby Azure Monitor a dokončete zbývající kroky.

Zjištění neúspěšných prostředků DSC ve všech uzlech

Jednou z výhod použití protokolů služby Azure Monitor je, že můžete vyhledávat neúspěšné kontroly napříč uzly. Pokud chcete najít všechny výskyty selhání, použijte následující dotaz:

AzureDiagnostics
| where Category == "DscNodeStatus"
| where OperationName == "DscResourceStatusData"
| where ResultType == "Failed"

Zobrazení historického stavu uzlu DSC

Pokud chcete vizualizovat historii stavu uzlu DSC v průběhu času, můžete použít tento dotaz:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.AUTOMATION"
| where Category == "DscNodeStatus"
| where ResultType != "started"
| summarize count() by ResultType

Tento dotaz zobrazuje graf stavu uzlu v průběhu času.

Záznamy protokolů služby Azure Monitor

Diagnostika Azure Automation vytvoří v protokolech služby Azure Monitor dvě kategorie záznamů:

• Data stavu uzlu (DscNodeStatusData)
• Data o stavu zdroje (DscResourceStatusData)

DscNodeStatusData

DscResourceStatusData

Další kroky

• Přehled najdete v přehledu služby Azure Automation State Configuration.
• Pokud chcete začít, přečtěte si téma Začínáme se službou Azure Automation State Configuration.
• Další informace o kompilaci konfigurací DSC, abyste je mohli přiřadit cílovým uzlům, najdete v tématu Kompilace konfigurací DSC ve službě Azure Automation State Configuration.
• Referenční informace k rutinám PowerShellu najdete v tématu Az.Automation.
• Informace o cenách najdete v tématu Ceny služby Azure Automation State Configuration.
• Příklad použití služby Azure Automation State Configuration v kanálu průběžného nasazování najdete v tématu Nastavení průběžného nasazování pomocí Chocolatey.
• Další informace o vytváření různých vyhledávacích dotazů a kontrole protokolů služby Automation State Configuration pomocí protokolů služby Azure Monitor najdete v tématu Prohledávání protokolů ve službě Azure Monitor.
• Další informace o protokolech a zdrojích shromažďování dat služby Azure Monitor najdete v přehledu shromažďování dat úložiště Azure v protokolech služby Azure Monitor.