Rozszerzenie maszyny wirtualnej usługi Log Analytics dla systemu WindowsLog Analytics virtual machine extension for Windows

Dzienniki Azure Monitor udostępniają możliwości monitorowania między zasobami w chmurze i lokalnymi.Azure Monitor Logs provides monitoring capabilities across cloud and on-premises assets. Rozszerzenie maszyny wirtualnej Log Analytics agenta dla systemu Windows jest publikowane i obsługiwane przez firmę Microsoft.The Log Analytics agent virtual machine extension for Windows is published and supported by Microsoft. Rozszerzenie instaluje agenta Log Analytics na maszynach wirtualnych platformy Azure i rejestruje maszyny wirtualne w istniejącym Log Analytics obszarze roboczym.The extension installs the Log Analytics agent on Azure virtual machines, and enrolls virtual machines into an existing Log Analytics workspace. Ten dokument zawiera szczegółowe informacje o obsługiwanych platformach, konfiguracjach i opcjach wdrażania dla rozszerzenia maszyny wirtualnej Log Analytics dla systemu Windows.This document details the supported platforms, configurations, and deployment options for the Log Analytics virtual machine extension for Windows.

Wymagania wstępnePrerequisites

System operacyjnyOperating system

Szczegółowe informacje o obsługiwanych systemach operacyjnych Windows można znaleźć w artykule omówienie Azure Monitor agentów .For details about the supported Windows operating systems, refer to the Overview of Azure Monitor agents article.

Wersja rozszerzenia agenta i maszyny wirtualnejAgent and VM Extension version

Poniższa tabela zawiera mapowanie wersji rozszerzenia maszyny wirtualnej z systemem Windows Log Analytics i pakietu agenta Log Analytics dla każdej wersji.The following table provides a mapping of the version of the Windows Log Analytics VM extension and Log Analytics agent bundle for each release.

Wersja pakietu Log Analytics Windows AgentLog Analytics Windows agent bundle version Log Analytics wersja rozszerzenia maszyny wirtualnej z systemem WindowsLog Analytics Windows VM extension version Data wydaniaRelease Date Informacje o wersjiRelease Notes
10.20.1805310.20.18053 1.0.18053.01.0.18053.0 Październik 2020 r.October 2020
  • Nowe narzędzie do rozwiązywania problemów z agentemNew Agent Troubleshooter
  • Aktualizacje dotyczące sposobu, w jaki Agent obsługuje zmiany certyfikatów w usługach platformy AzureUpdates to how the agent handles certificate changes to Azure services
10.20.1804010.20.18040 1.0.18040.21.0.18040.2 Sierpień 2020 r.August 2020
  • Rozwiązuje problem w usłudze Azure ArcResolves an issue on Azure Arc
10.20.1803810.20.18038 1.0.180381.0.18038 Kwiecień 2020 r.April 2020
  • Umożliwia łączność za pośrednictwem prywatnego linku przy użyciu Azure Monitor zakresy linków prywatnychEnables connectivity over Private Link using Azure Monitor Private Link Scopes
  • Dodaje ograniczenie pozyskiwania, aby uniknąć nagłego i przypadkowego napływu w obszarze roboczymAdds ingestion throttling to avoid a sudden, accidental influx in ingestion to a workspace
  • Dodaje obsługę dodatkowych chmur Azure Government i regionówAdds support for additional Azure Government clouds and regions
  • Rozwiązuje usterkę, w której HealthService.exe awariaResolves a bug where HealthService.exe crashed
10.20.1802910.20.18029 1.0.180291.0.18029 Marzec 2020 r.March 2020
  • Dodaje obsługę podpisywania kodu SHA-2Adds SHA-2 code signing support
  • Udoskonalenie instalacji i zarządzania rozszerzeniami maszyny wirtualnejImproves VM extension installation and management
  • Rozwiązuje usterkę w usłudze Azure Arc na potrzeby integracji serwerówResolves a bug in Azure Arc for Servers integration
  • Dodaje wbudowane narzędzie do rozwiązywania problemów z obsługą klientaAdds a built-in troubleshooting tool for customer support
  • Dodaje obsługę dodatkowych regionów Azure GovernmentAdds support for additional Azure Government regions
10.20.1801810.20.18018 1.0.180181.0.18018 Październik 2019 r.October 2019
  • Drobne poprawki błędów i ulepszenia stabilizacjiMinor bug fixes and stabilization improvements
10.20.1801110.20.18011 1.0.180111.0.18011 Lipiec 2019 r.July 2019
  • Drobne poprawki błędów i ulepszenia stabilizacjiMinor bug fixes and stabilization improvements
  • Zwiększono MaxExpressionDepth do 10000Increased MaxExpressionDepth to 10000
10.20.1800110.20.18001 1.0.180011.0.18001 Czerwiec 2019 r.June 2019
  • Drobne poprawki błędów i ulepszenia stabilizacjiMinor bug fixes and stabilization improvements
  • Dodano możliwość wyłączania poświadczeń domyślnych podczas nawiązywania połączenia z serwerem proxy (obsługa WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH)Added ability to disable default credentials when making proxy connection (support for WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH)
10.19.1351510.19.13515 1.0.135151.0.13515 Marzec 2019 r.March 2019
  • Niewielkie poprawki stabilizacjiMinor stabilization fixes
10.19.1000610.19.10006 n/dn/a Dec 2018Dec 2018
  • Niewielkie poprawki stabilizacjiMinor stabilization fixes
8.0.111368.0.11136 n/dn/a Września 2018Sept 2018
  • Dodano obsługę wykrywania zmiany identyfikatora zasobu podczas przenoszenia maszyny wirtualnejAdded support for detecting resource ID change on VM move
  • Dodano obsługę identyfikatora zasobu raportowania podczas korzystania z instalacji niezwiązanej z rozszerzeniemAdded Support for reporting resource ID when using non-extension install
8.0.111038.0.11103 n/dn/a Kwiecień 2018 r.April 2018
8.0.110818.0.11081 1.0.110811.0.11081 Lis 2017Nov 2017
8.0.110728.0.11072 1.0.110721.0.11072 Września 2017Sept 2017
8.0.110498.0.11049 1.0.110491.0.11049 2017 lutegoFeb 2017

Azure Security CenterAzure Security Center

Azure Security Center automatycznie inicjuje agenta Log Analytics i łączy go z domyślnym obszarem roboczym Log Analytics subskrypcji platformy Azure.Azure Security Center automatically provisions the Log Analytics agent and connects it with the default Log Analytics workspace of the Azure subscription. Jeśli używasz Azure Security Center, nie wykonuj kroków opisanych w tym dokumencie.If you are using Azure Security Center, do not run through the steps in this document. Spowoduje to zastąpienie skonfigurowanego obszaru roboczego i przerwanie połączenia z Azure Security Center.Doing so overwrites the configured workspace and break the connection with Azure Security Center.

Łączność z InternetemInternet connectivity

Rozszerzenie agenta Log Analytics dla systemu Windows wymaga, aby docelowa maszyna wirtualna była połączona z Internetem.The Log Analytics agent extension for Windows requires that the target virtual machine is connected to the internet.

Schemat rozszerzeniaExtension schema

Poniższy kod JSON przedstawia schemat rozszerzenia agenta Log Analytics.The following JSON shows the schema for the Log Analytics agent extension. Rozszerzenie wymaga identyfikatora obszaru roboczego i klucza obszaru roboczego z docelowego obszaru roboczego Log Analytics.The extension requires the workspace ID and workspace key from the target Log Analytics workspace. Można je znaleźć w ustawieniach obszaru roboczego w Azure Portal.These can be found in the settings for the workspace in the Azure portal. Ponieważ klucz obszaru roboczego powinien być traktowany jako poufne dane, powinien on być przechowywany w konfiguracji chronionego ustawienia.Because the workspace key should be treated as sensitive data, it should be stored in a protected setting configuration. Dane ustawienia chronionego rozszerzenia maszyny wirtualnej platformy Azure są szyfrowane i odszyfrowywane tylko na docelowej maszynie wirtualnej.Azure VM extension protected setting data is encrypted, and only decrypted on the target virtual machine. Należy pamiętać, że w Identyfikator obszaru roboczego i workspaceKey jest rozróżniana wielkość liter.Note that workspaceId and workspaceKey are case-sensitive.

{
    "type": "extensions",
    "name": "OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

Wartości właściwościProperty values

NazwaName Wartość/przykładValue / Example
apiVersionapiVersion 2015-06-152015-06-15
publisherpublisher Microsoft. EnterpriseCloud. MonitoringMicrosoft.EnterpriseCloud.Monitoring
typtype MicrosoftMonitoringAgentMicrosoftMonitoringAgent
typeHandlerVersiontypeHandlerVersion 1.01.0
Identyfikator obszaru roboczego (np.) *workspaceId (e.g)* 6f680a37-00c6-41c7-a93f-1437e34625746f680a37-00c6-41c7-a93f-1437e3462574
workspaceKey (np.)workspaceKey (e.g) z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI + rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ = =z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ==

* Identyfikator obszaru roboczego jest nazywana consumerId w interfejsie API Log Analytics.* The workspaceId is called the consumerId in the Log Analytics API.

Uwaga

Aby uzyskać dodatkowe właściwości, zobacz Azure Connect komputery z systemem Windows do Azure monitor.For additional properties see Azure Connect Windows Computers to Azure Monitor.

Wdrażanie na podstawie szablonuTemplate deployment

Rozszerzenia maszyny wirtualnej platformy Azure można wdrażać za pomocą szablonów Azure Resource Manager.Azure VM extensions can be deployed with Azure Resource Manager templates. Schemat JSON opisany w poprzedniej sekcji można użyć w szablonie Azure Resource Manager, aby uruchomić rozszerzenie agenta Log Analytics podczas wdrażania szablonu Azure Resource Manager.The JSON schema detailed in the previous section can be used in an Azure Resource Manager template to run the Log Analytics agent extension during an Azure Resource Manager template deployment. Przykładowy szablon zawierający rozszerzenie maszyny wirtualnej agenta Log Analytics można znaleźć w galerii szybkiego startu platformy Azure.A sample template that includes the Log Analytics agent VM extension can be found on the Azure Quickstart Gallery.

Uwaga

Szablon nie obsługuje określania więcej niż jednego identyfikatora obszaru roboczego i klucza obszaru roboczego, jeśli chcesz skonfigurować agenta do raportowania do wielu obszarów roboczych.The template does not support specifying more than one workspace ID and workspace key when you want to configure the agent to report to multiple workspaces. Aby skonfigurować agenta do raportowania do wielu obszarów roboczych, zobacz Dodawanie lub usuwanie obszaru roboczego.To configure the agent to report to multiple workspaces, see Adding or removing a workspace.

KOD JSON rozszerzenia maszyny wirtualnej może być zagnieżdżony w obrębie zasobu maszyny wirtualnej lub umieszczony na głównym lub najwyższym poziomie szablonu JSON Menedżer zasobów.The JSON for a virtual machine extension can be nested inside the virtual machine resource, or placed at the root or top level of a Resource Manager JSON template. Położenie pliku JSON wpływa na wartość nazwy zasobu i typu.The placement of the JSON affects the value of the resource name and type. Aby uzyskać więcej informacji, zobacz Ustawianie nazwy i typu dla zasobów podrzędnych.For more information, see Set name and type for child resources.

W poniższym przykładzie założono, że rozszerzenie Log Analytics jest zagnieżdżone w ramach zasobu maszyny wirtualnej.The following example assumes the Log Analytics extension is nested inside the virtual machine resource. Podczas zagnieżdżania zasobu rozszerzenia kod JSON jest umieszczany w "resources": [] obiekcie maszyny wirtualnej.When nesting the extension resource, the JSON is placed in the "resources": [] object of the virtual machine.

{
    "type": "extensions",
    "name": "OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

Podczas umieszczania kodu JSON rozszerzenia w katalogu głównym szablonu nazwa zasobu zawiera odwołanie do nadrzędnej maszyny wirtualnej, a typ odzwierciedla konfigurację zagnieżdżoną.When placing the extension JSON at the root of the template, the resource name includes a reference to the parent virtual machine, and the type reflects the nested configuration.

{
    "type": "Microsoft.Compute/virtualMachines/extensions",
    "name": "<parentVmResource>/OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

Wdrażanie przy użyciu programu PowerShellPowerShell deployment

Za pomocą Set-AzVMExtension polecenia można wdrożyć rozszerzenie maszyny wirtualnej agenta log Analytics na istniejącej maszynie wirtualnej.The Set-AzVMExtension command can be used to deploy the Log Analytics agent virtual machine extension to an existing virtual machine. Przed uruchomieniem polecenia należy zapisać konfigurację publiczną i prywatną w tabeli skrótów programu PowerShell.Before running the command, the public and private configurations need to be stored in a PowerShell hash table.

$PublicSettings = @{"workspaceId" = "myWorkspaceId"}
$ProtectedSettings = @{"workspaceKey" = "myWorkspaceKey"}

Set-AzVMExtension -ExtensionName "MicrosoftMonitoringAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.EnterpriseCloud.Monitoring" `
    -ExtensionType "MicrosoftMonitoringAgent" `
    -TypeHandlerVersion 1.0 `
    -Settings $PublicSettings `
    -ProtectedSettings $ProtectedSettings `
    -Location WestUS 

Rozwiązywanie problemów i pomoc technicznaTroubleshoot and support

Rozwiązywanie problemówTroubleshoot

Dane dotyczące stanu wdrożeń rozszerzeń można pobrać z Azure Portal i przy użyciu modułu Azure PowerShell.Data about the state of extension deployments can be retrieved from the Azure portal, and by using the Azure PowerShell module. Aby wyświetlić stan wdrożenia dla danej maszyny wirtualnej, uruchom następujące polecenie przy użyciu modułu Azure PowerShell.To see the deployment state of extensions for a given VM, run the following command using the Azure PowerShell module.

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

Dane wyjściowe wykonania rozszerzenia są rejestrowane w plikach znalezionych w następującym katalogu:Extension execution output is logged to files found in the following directory:

C:\WindowsAzure\Logs\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\

Pomoc technicznaSupport

Jeśli potrzebujesz więcej pomocy w dowolnym punkcie tego artykułu, możesz skontaktować się z ekspertami platformy Azure na forach MSDN i Stack Overflow.If you need more help at any point in this article, you can contact the Azure experts on the MSDN Azure and Stack Overflow forums. Alternatywnie możesz zaplikować zdarzenie pomocy technicznej platformy Azure.Alternatively, you can file an Azure support incident. Przejdź do witryny pomocy technicznej systemu Azure i wybierz pozycję Uzyskaj pomoc techniczną.Go to the Azure support site and select Get support. Aby uzyskać informacje o korzystaniu z pomocy technicznej platformy Azure, przeczytaj temat Microsoft Azure support — często zadawane pytania.For information about using Azure Support, read the Microsoft Azure support FAQ.