Monitorowanie metryk i dzienników przy użyciu rozszerzenia diagnostycznego systemu Linux 4.0

W tym artykule opisano najnowsze wersje rozszerzenia diagnostycznego systemu Linux (LAD).

resources
| where type contains "extension"
| extend parsedProperties = parse_json(properties)
| extend publisher = tostring(parsedProperties.publisher)
| project-away parsedProperties
| where publisher == "Microsoft.Azure.Diagnostics"
| distinct id

Rozszerzenie diagnostyczne systemu Linux ułatwia monitorowanie kondycji maszyny wirtualnej z systemem Linux na platformie Microsoft Azure. Posiada on następujące możliwości:

To rozszerzenie działa zarówno z modelami wdrażania platformy Azure: usługą Azure Resource Manager i modelem klasycznym.

Wymagania wstępne

• Agent systemu Linux platformy Azure w wersji 2.2.0 lub nowszej. Większość obrazów galerii maszyn wirtualnych platformy Azure z systemem Linux obejmuje wersję 2.2.7 lub nowszą. Uruchom polecenie /usr/sbin/waagent -version , aby potwierdzić wersję zainstalowaną na maszynie wirtualnej. Jeśli maszyna wirtualna uruchamia starszą wersję agenta gościa, zaktualizuj agenta systemu Linux.
• Interfejs wiersza polecenia platformy Azure. Skonfiguruj środowisko interfejsu wiersza polecenia platformy Azure na maszynie.
• Poleceniewget. Jeśli jeszcze go nie masz, zainstaluj go przy użyciu odpowiedniego menedżera pakietów.
• Subskrypcja platformy Azure i konto magazynowe ogólnego przeznaczenia do przechowywania danych. Konta magazynu ogólnego przeznaczenia obsługują magazyn tabel, który jest wymagany. Konto pamięci masowej Blob nie działa poprawnie.
• Python 2.

Obsługiwane dystrybucje systemu Linux

Zobacz Obsługiwane systemy operacyjne agenta.

Wymaganie języka Python

Rozszerzenie diagnostyczne systemu Linux wymaga języka Python 2. Jeśli maszyna wirtualna korzysta z dystrybucji, która nie zawiera języka Python 2, zainstaluj ją.

Aby zainstalować język Python 2, uruchom jedno z następujących przykładowych poleceń:

• Red Hat, CentOS, Oracle: yum install -y python2
• Ubuntu, Debian: apt-get install -y python2
• SUSE: zypper install -y python2

Plik python2 wykonywalny musi mieć alias na python.

1. Uruchom następujące polecenie, aby usunąć wszystkie istniejące aliasy.

   sudo update-alternatives --remove-all python
   

2. Uruchom następujące polecenie, aby utworzyć nowy alias.

   sudo update-alternatives --install /usr/bin/python python /usr/bin/python2 1
   

Instalowanie rozszerzenia

To rozszerzenie dla maszyn wirtualnych i zestawu skalowania maszyn wirtualnych można włączyć przy użyciu poleceń cmdlet programu Azure PowerShell, skryptów interfejsu wiersza polecenia platformy Azure, szablonów usługi Azure Resource Manager (szablonów usługi ARM) lub witryny Azure Portal. Aby uzyskać więcej informacji, zobacz Virtual machine extensions and features for Linux (Rozszerzenia i funkcje maszyny wirtualnej dla systemu Linux).

Aby skonfigurować usługę LAD 4.0, skorzystaj z instrukcji instalacji i konfiguracji przykładowej do pobrania :

• Przechwyć i przechowaj te same metryki, które zapewniały wersje LAD 2.3 i 3.x.
• Wysyłaj metryki do odbiornika usługi Azure Monitor oraz do standardowego odbiornika w usłudze Azure Storage. Ta funkcja jest nowa w systemie LAD 4.0.
• Przechwyć przydatny zestaw metryk systemu plików, jak w LAD 3.0.
• Przechwyć domyślną kolekcję dziennika systemowego włączoną przez usługę LAD 2.3.
• Włącz środowisko witryny Azure Portal na potrzeby tworzenia wykresów i alertów dotyczących metryk maszyn wirtualnych.

Konfiguracja do pobrania jest tylko przykładem. Zmodyfikuj go zgodnie z potrzebami.

Instalacja

Usługę LAD 4.0 można zainstalować i skonfigurować w interfejsie wiersza polecenia platformy Azure lub w programie Azure PowerShell.

az vm extension set --publisher Microsoft.Azure.Diagnostics \
  --name LinuxDiagnostic --version 4.0 --resource-group <resource_group_name> \
  --vm-name <vm_name> --protected-settings ProtectedSettings.json \
  --settings PublicSettings.json

Set-AzVMExtension -ResourceGroupName <resource_group_name> -VMName <vm_name> `
  -Location <vm_location> -ExtensionType LinuxDiagnostic `
  -Publisher Microsoft.Azure.Diagnostics -Name LinuxDiagnostic `
  -SettingString $publicSettings -ProtectedSettingString $protectedSettings `
  -TypeHandlerVersion 4.0

Włączanie automatycznej aktualizacji

Aby włączyć automatyczną aktualizację agenta, zalecamy włączenie funkcji automatycznego uaktualniania rozszerzeń :

az vm extension set --publisher Microsoft.Azure.Diagnostics --name LinuxDiagnostic \
  --version 4.0 --resource-group <resource_group_name> --vm-name <vm_name> \
  --protected-settings ProtectedSettings.json --settings PublicSettings.json \
  --enable-auto-upgrade true

Set-AzVMExtension -ResourceGroupName <resource_group_name> -VMName <vm_name> `
  -Location <vm_location> -ExtensionType LinuxDiagnostic `
  -Publisher Microsoft.Azure.Diagnostics -Name LinuxDiagnostic `
  -SettingString $publicSettings -ProtectedSettingString $protectedSettings `
  -TypeHandlerVersion 4.0 -EnableAutomaticUpgrade $true

Przykładowa instalacja

W tych przykładach przykładowa konfiguracja zbiera zestaw danych standardowych i wysyła je do magazynu tabel. Adres URL przykładowej konfiguracji i jego zawartość mogą ulec zmianie.

W większości przypadków należy pobrać kopię pliku JSON ustawień portalu i dostosować go zgodnie z potrzebami. Użyj szablonów lub własnej automatyzacji, aby użyć dostosowanej wersji pliku konfiguracji, a nie pobierania z adresu URL za każdym razem.

Po włączeniu nowego ujścia usługi Azure Monitor maszyny wirtualne muszą mieć włączoną tożsamość przypisaną przez system w celu wygenerowania tokenów uwierzytelniania tożsamości usługi zarządzanej (MSI). Te ustawienia można dodać podczas tworzenia maszyny wirtualnej lub po jej utworzeniu. Aby uzyskać instrukcje dotyczące witryny Azure Portal, interfejsu wiersza polecenia platformy Azure, programu PowerShell i usługi Azure Resource Manager, zobacz Konfigurowanie tożsamości zarządzanych.

# Set your Azure VM diagnostic variables.
my_subscription_id=<your_azure_subscription_id>
my_resource_group=<your_azure_resource_group_name_containing_your_azure_linux_vm>
my_linux_vm=<your_azure_linux_vm_name>
my_diagnostic_storage_account=<your_azure_storage_account_for_storing_vm_diagnostic_data>

# Login to Azure before you do anything else.
az login

# Select the subscription that contains the storage account.
az account set --subscription $my_subscription_id

# Enable system-assigned identity on the existing VM.
az vm identity assign --resource-group $my_resource_group --name $my_linux_vm

# Download the sample public settings. You could instead use curl or any web browser.
wget https://raw.githubusercontent.com/Azure/azure-linux-extensions/master/Diagnostic/tests/lad_2_3_compatible_portal_pub_settings.json -O portal_public_settings.json

# Build the VM resource ID. Replace the storage account name and resource ID in the public settings.
my_vm_resource_id=$(az vm show --resource-group $my_resource_group \
  --name $my_linux_vm --query "id" -o tsv)
sed -i "s#__DIAGNOSTIC_STORAGE_ACCOUNT__#$my_diagnostic_storage_account#g" portal_public_settings.json
sed -i "s#__VM_RESOURCE_ID__#$my_vm_resource_id#g" portal_public_settings.json

# Build the protected settings (storage account SAS token).
my_diagnostic_storage_account_sastoken=$(az storage account generate-sas \
  --account-name $my_diagnostic_storage_account --expiry 2037-12-31T23:59:00Z \
  --permissions wlacu --resource-types co --services bt -o tsv)
my_lad_protected_settings="{'storageAccountName': '$my_diagnostic_storage_account', \
  'storageAccountSasToken': '$my_diagnostic_storage_account_sastoken'}"

# Finally, tell Azure to install and enable the extension.
az vm extension set --publisher Microsoft.Azure.Diagnostics --name LinuxDiagnostic \
  --version 4.0 --resource-group $my_resource_group --vm-name $my_linux_vm \
  --protected-settings "${my_lad_protected_settings}" --settings portal_public_settings.json

$storageAccountName = "yourStorageAccountName"
$storageAccountResourceGroup = "yourStorageAccountResourceGroupName"
$vmName = "yourVMName"
$VMresourceGroup = "yourVMResourceGroupName"

# Get the VM object
$vm = Get-AzVM -Name $vmName -ResourceGroupName $VMresourceGroup

# Enable system-assigned identity on an existing VM
Update-AzVM -ResourceGroupName $VMresourceGroup -VM $vm -IdentityType SystemAssigned

# Get the public settings template from GitHub and update the templated values for the storage account and resource ID
$publicSettings = (Invoke-WebRequest -Uri https://raw.githubusercontent.com/Azure/azure-linux-extensions/master/Diagnostic/tests/lad_2_3_compatible_portal_pub_settings.json).Content
$publicSettings = $publicSettings.Replace('__DIAGNOSTIC_STORAGE_ACCOUNT__', $storageAccountName)
$publicSettings = $publicSettings.Replace('__VM_RESOURCE_ID__', $vm.Id)

# If you have your own customized public settings, you can inline those rather than using the preceding template: $publicSettings = '{"ladCfg":  { ... },}'

# Generate a SAS token for the agent to use to authenticate with the storage account
$sasToken = New-AzStorageAccountSASToken -Service Blob,Table `
  -ResourceType Service,Container,Object -Permission "racwdlup" `
  -Context (Get-AzStorageAccount -ResourceGroupName $storageAccountResourceGroup `
  -AccountName $storageAccountName).Context -ExpiryTime $([System.DateTime]::Now.AddYears(10))

# Build the protected settings (storage account SAS token)
$protectedSettings="{'storageAccountName': '$storageAccountName', `
  'storageAccountSasToken': '$sasToken'}"

# Finally, install the extension with the settings you built
Set-AzVMExtension -ResourceGroupName $VMresourceGroup -VMName $vmName `
  -Location $vm.Location -ExtensionType LinuxDiagnostic `
  -Publisher Microsoft.Azure.Diagnostics -Name LinuxDiagnostic `
  -SettingString $publicSettings -ProtectedSettingString $protectedSettings `
  -TypeHandlerVersion 4.0

Przykład instalacji dla zestawów skalowania maszyn wirtualnych - Azure CLI

# Set your Azure virtual machine scale set diagnostic variables.
my_subscription_id=<your_azure_subscription_id>
my_resource_group=<your_azure_resource_group_name_containing_your_azure_linux_vm>
my_linux_vmss=<your_azure_linux_vmss_name>
my_diagnostic_storage_account=<your_azure_storage_account_for_storing_vm_diagnostic_data>

# Login to Azure before you do anything else.
az login

# Select the subscription that contains the storage account.
az account set --subscription $my_subscription_id

# Enable system-assigned identity on the existing virtual machine scale set.
az vmss identity assign --resource-group $my_resource_group --name $my_linux_vmss

# Download the sample public settings. You could also use curl or any web browser.
wget https://raw.githubusercontent.com/Azure/azure-linux-extensions/master/Diagnostic/tests/lad_2_3_compatible_portal_pub_settings.json -O portal_public_settings.json

# Build the virtual machine scale set resource ID. Replace the storage account name and resource ID in the public settings.
my_vmss_resource_id=$(az vmss show --resource-group $my_resource_group \
  --name $my_linux_vmss --query "id" -o tsv)
sed -i "s#__DIAGNOSTIC_STORAGE_ACCOUNT__#$my_diagnostic_storage_account#g" portal_public_settings.json
sed -i "s#__VM_RESOURCE_ID__#$my_vmss_resource_id#g" portal_public_settings.json

# Build the protected settings (storage account SAS token).
my_diagnostic_storage_account_sastoken=$(az storage account generate-sas \
  --account-name $my_diagnostic_storage_account --expiry 2037-12-31T23:59:00Z \
  --permissions wlacu --resource-types co --services bt -o tsv)
my_lad_protected_settings="{'storageAccountName': '$my_diagnostic_storage_account', 'storageAccountSasToken': '$my_diagnostic_storage_account_sastoken'}"

# Finally, tell Azure to install and enable the extension.
az vmss extension set --publisher Microsoft.Azure.Diagnostics --name LinuxDiagnostic
  --version 4.0 --resource-group $my_resource_group --vmss-name $my_linux_vmss \
  --protected-settings "${my_lad_protected_settings}" --settings portal_public_settings.json

Aktualizowanie ustawień rozszerzenia

Po zmianie chronionych lub publicznych ustawień uruchom to samo polecenie, aby wdrożyć je na maszynie wirtualnej. Jeśli jakiekolwiek ustawienia zostaną zmienione, aktualizacje zostaną wysłane do rozszerzenia. Usługa LAD ponownie ładuje konfigurację i uruchamia się ponownie.

Migrowanie z poprzednich wersji rozszerzenia

Najnowsza wersja rozszerzenia to 4.0, która jest obecnie dostępna w publicznej wersji zapoznawczej. Starsze wersje wersji 3.x są nadal obsługiwane. Wersje 2.x są przestarzałe od 31 lipca 2018 r.

Po zainstalowaniu nowego rozszerzenia włącz automatyczne uaktualnienia wersji pomocniczej:

• Na maszynach wirtualnych modelu wdrażania usługi Azure Resource Manager, uwzględnij "autoUpgradeMinorVersion": true w szablonie wdrażania VM.
• Na klasycznych maszynach wirtualnych modelu wdrażania określ wersję 4.* , jeśli instalujesz rozszerzenie za pomocą interfejsu wiersza polecenia platformy Azure lub programu PowerShell.

Możesz użyć tego samego konta magazynu, którego używałeś dla LAD 3.x.

Ustawienia chronione

Ten zestaw informacji o konfiguracji zawiera poufne informacje, które powinny być chronione przed widokiem publicznym. Zawiera on na przykład dane uwierzytelniające magazynu. Ustawienia są przesyłane do rozszerzenia, które przechowuje je w postaci zaszyfrowanej.

{
    "storageAccountName" : "the storage account to receive data",
    "storageAccountEndPoint": "the hostname suffix for the cloud for this account",
    "storageAccountSasToken": "SAS access token",
    "mdsdHttpProxy": "HTTP proxy settings",
    "sinksConfig": { ... }
}

Aby uzyskać token SAS w szablonie ARM, użyj funkcji listAccountSas. Przykładowy szablon można znaleźć w sekcji Przykład funkcji List.

Wymagany token sygnatury dostępu współdzielonego można utworzyć za pośrednictwem witryny Azure Portal:

1. Wybierz konto magazynu ogólnego przeznaczenia, do którego ma zostać zapisane rozszerzenie.
2. W menu po lewej stronie w obszarze Zabezpieczenia i sieć wybierz pozycję Sygnatura dostępu współdzielonego.
3. Ustaw wybrane opcje zgodnie z wcześniejszym opisem.
4. Wybierz Generuj sygnaturę SAS i ciąg połączenia.

Skopiuj wygenerowaną sygnaturę dostępu współdzielonego do pola storageAccountSasToken. Usuń wiodący znak zapytania (?).

konfiguracjaZlewu

"sinksConfig": {
    "sink": [
        {
            "name": "sinkname",
            "type": "sinktype",
            ...
        },
        ...
    ]
},

Sekcja opcjonalna sinksConfig definiuje więcej miejsc docelowych, do których rozszerzenie wysyła zebrane informacje. Tablica "sink" zawiera obiekt dla każdego dodatkowego ujścia danych. Atrybut "type" określa inne atrybuty w obiekcie.

Rozszerzenie diagnostyczne systemu Linux 4.0 obsługuje dwa chronione typy ujścia: EventHub i JsonBlob.

Ujście usługi EventHub

"sink": [
    {
        "name": "sinkname",
        "type": "EventHub",
        "sasURL": "https SAS URL"
    },
    ...
]

Wpis "sasURL" zawiera pełny adres URL, w tym token sygnatury dostępu współdzielonego, dla centrum zdarzeń, do którego mają zostać opublikowane dane. Usługa LAD wymaga sygnatury dostępu współdzielonego do zidentyfikowania zasady, która umożliwia wysyłanie żądania. Oto przykład:

• Utwórz przestrzeń nazw usługi Event Hubs o nazwie contosohub.
• Utwórz centrum zdarzeń w przestrzeni nazw o nazwie syslogmsgs.
• Utwórz zasady dostępu współdzielonego w centrum zdarzeń o nazwie writer, które umożliwia uprawnienie do wysyłania.

Jeśli utworzysz SAS ważną do północy czasu UTC 1 stycznia 2018 r., wartość sasURL może być podobna do poniższego przykładu.

https://contosohub.servicebus.windows.net/syslogmsgs?sr=contosohub.servicebus.windows.net%2fsyslogmsgs&sig=xxxxxxxxxxxxxxxxxxxxxxxxx&se=1514764800&skn=writer

Aby uzyskać więcej informacji na temat generowania i pobierania informacji na temat tokenów SAS dla usługi Event Hubs, zobacz Generowanie tokenu SAS.

Ujście JsonBlob

"sink": [
    {
        "name": "sinkname",
        "type": "JsonBlob"
    },
    ...
]

Dane kierowane do ujścia JsonBlob są przechowywane w obiektach blob w usłudze Azure Storage. Każda instancja LAD tworzy blob co godzinę dla każdej nazwy kanału. Każdy obiekt blob zawsze zawiera syntaktycznie prawidłową tablicę obiektów JSON. Nowe wpisy są atomowo dodawane do tablicy.

Obiekty blob są przechowywane w kontenerze o takiej samej nazwie jak ujście. Reguły usługi Azure Storage dotyczące nazw kontenerów JsonBlob obiektów blob mają zastosowanie do nazw wyjść. Nazwy muszą zawierać od 3 do 63 małych liter alfanumeryczne znaki ASCII lub kreski.

Ustawienia publiczne

Struktura ustawień publicznych zawiera różne bloki ustawień, które kontrolują informacje zbierane przez rozszerzenie. Każde ustawienie, z wyjątkiem ladCfg, jest opcjonalne. Jeśli określisz zbieranie metryk lub syslogów w ladCfg, musisz także określić parametr StorageAccount. Należy określić sinksConfig element, aby włączyć ujście usługi Azure Monitor dla metryk z usługi LAD 4.0.

{
    "ladCfg":  { ... },
    "fileLogs": { ... },
    "StorageAccount": "the storage account to receive data",
    "sinksConfig": { ... },
    "mdsdHttpProxy" : ""
}

Poniższe sekcje zawierają szczegółowe informacje o pozostałych elementach.

ladCfg

"ladCfg": {
    "diagnosticMonitorConfiguration": {
        "eventVolume": "Medium",
        "metrics": { ... },
        "performanceCounters": { ... },
        "syslogEvents": { ... }
    },
    "sampleRateInSeconds": 15
}

Struktura ladCfg kontroluje zbieranie metryk i dzienników w celu dostarczenia do usługi Azure Monitor Metrics i innych odbiorników danych. Określ performanceCounters, syslogEvents lub oba. Określ również strukturę metrics.

Jeśli nie chcesz włączać zbierania dzienników syslog lub metryk, określ pustą strukturę elementu ladCfg :

"ladCfg": {
    "diagnosticMonitorConfiguration": {}
}

metryki

"metrics": {
    "resourceId": "/subscriptions/...",
    "metricAggregation" : [
        { "scheduledTransferPeriod" : "PT1H" },
        { "scheduledTransferPeriod" : "PT5M" }
    ]
}

Próbki metryk określonych w performanceCounters sekcji są zbierane co 15 sekund lub przy jawnym tempie próbkowania zdefiniowanym dla licznika. Jeśli pojawia się wiele scheduledTransferPeriod częstotliwości, tak jak w przykładzie, każda agregacja jest obliczana niezależnie.

performanceCounters (Liczniki wydajności)

"performanceCounters": {
    "sinks": "",
    "performanceCounterConfiguration": [
        {
            "type": "builtin",
            "class": "Processor",
            "counter": "PercentIdleTime",
            "counterSpecifier": "/builtin/Processor/PercentIdleTime",
            "condition": "IsAggregate=TRUE",
            "sampleRate": "PT15S",
            "unit": "Percent",
            "annotation": [
                {
                    "displayName" : "cpu idle time",
                    "locale" : "en-us"
                }
            ]
        }
    ]
}

Opcjonalna performanceCounters sekcja steruje kolekcją metryk. Nieprzetworzone próbki są agregowane dla każdego scheduledTransferPeriod w celu utworzenia tych wartości:

• Znaczyć
• Minimalna wartość
• Maksimum
• Ostatnio zbierana wartość
• Liczba nieprzetworzonych próbek używanych do obliczania agregacji

counterSpecifier jest dowolnym identyfikatorem. Konsumenci metryk, takich jak funkcja tworzenia wykresów i alertów w witrynie Azure Portal, używają counterSpecifier jako klucza identyfikującego metrykę lub wystąpienie metryki.

Zalecamy wartości builtin dla metryk counterSpecifier rozpoczynające się od /builtin/. Aby zebrać określone wystąpienie metryki, dołącz identyfikator wystąpienia do wartości counterSpecifier. Oto kilka przykładów:

• /builtin/Processor/PercentIdleTime. Średni czas bezczynności dla wszystkich procesorów wirtualnych
• /builtin/Disk/FreeSpace(/mnt). Wolne miejsce dla /mnt systemu plików
• /builtin/Disk/FreeSpace. Wolne miejsce średnio we wszystkich zainstalowanych systemach plików

LaD i portal Azure nie oczekują, że wartość counterSpecifier będzie zgodna z żadnym wzorcem. Bądź spójny w sposobie konstruowania counterSpecifier wartości.

Po określeniu performanceCounters LAD zawsze zapisuje dane w tabeli w usłudze Azure Storage. Te same dane można zapisywać w obiektach blob JSON lub Event Hubs lub obu tych obiektach. Nie można wyłączyć przechowywania danych w tabeli.

Wszystkie wystąpienia usługi LAD, które używają tej samej nazwy konta magazynu i punktu końcowego, dodają metryki i dzienniki do tej samej tabeli. Jeśli zbyt wiele maszyn wirtualnych zapisuje w tej samej partycji tabeli, platforma Azure może ograniczyć zapisy do tej partycji.

Ustawienie eventVolume powoduje rozłożenie wpisów na partycje 1 (małe), 10 (średnie) lub 100 (duże). Zwykle średnie podziały są wystarczające, aby uniknąć ograniczenia ruchu.

Funkcja Metryk usługi Azure Monitor w witrynie Azure Portal używa danych w tej tabeli do tworzenia grafów lub wyzwalania alertów. Nazwa tabeli to łączenie tych ciągów:

• WADMetrics
• Wartość "scheduledTransferPeriod" dla zagregowanych wartości przechowywanych w tabeli
• P10DV2S
• Data w postaci RRRRMMDD, która zmienia się co 10 dni

Przykłady obejmują WADMetricsPT1HP10DV2S20170410 i WADMetricsPT1MP10DV2S20170609.

syslogEvents

"syslogEvents": {
    "sinks": "",
    "syslogEventConfiguration": {
        "facilityName1": "minSeverity",
        "facilityName2": "minSeverity",
        ...
    }
}

Opcjonalna syslogEvents sekcja steruje kolekcją zdarzeń dziennika z dziennika systemowego. Jeśli sekcja zostanie pominięta, zdarzenia dziennika systemowego nie są w ogóle przechwytywane.

Kolekcja syslogEventConfiguration ma jeden wpis dla każdej interesującej jednostki obiektu syslog. Jeśli minSeverity jest "NONE" dla określonego obiektu lub jeśli ten obiekt w ogóle nie pojawia się w elemencie, żadne zdarzenia z tej instalacji nie są przechwytywane.

Po określeniu wartości syslogEventsusługa LAD zawsze zapisuje dane w tabeli o nazwie LinuxSyslogVer2v0 w usłudze Azure Storage. Te same dane można zapisywać w obiektach blob JSON lub Event Hubs lub obu tych obiektach. Nie można wyłączyć przechowywania danych w tabeli.

konfiguracjaZlewu

Opcjonalna sekcja publiczna sinksConfig umożliwia wysyłanie metryk do ujścia usługi Azure Monitor oprócz konta magazynu i domyślnego widoku metryk gościa.

  "sinksConfig": {
    "sink": [
      {
        "name": "AzMonSink",
        "type": "AzMonSink",
        "AzureMonitor": {}
      }
    ]
  },

dzienniki plików

Sekcja fileLogs steruje przechwytywaniem plików dziennika. Usługa LAD przechwytuje nowe wiersze tekstu podczas zapisywania ich w pliku. Zapisuje je w wierszach tabeli i wszystkich określonych ujściach, takich jak JsonBlob i EventHub.

"fileLogs": [
    {
        "file": "/var/log/mydaemonlog",
        "table": "MyDaemonEvents",
        "sinks": ""
    }
]

Należy określić jeden z elementów "table" lub "sinks", lub oba.

Metryki obsługiwane przez wbudowanego dostawcę

Domyślne metryki obsługiwane przez usługę LAD są agregowane we wszystkich systemach plików, dyskach lub nazwach. W przypadku nieagregowanych metryk zapoznaj się z nowszą obsługą metryk ujścia usługi Azure Monitor.

Dostawca builtin metryk jest źródłem metryk, które są najbardziej interesujące dla szerokiego zestawu użytkowników. Te metryki należą do pięciu szerokich klas:

• Procesor
• Pamięć
• Sieć
• System plików
• Disk

wbudowane metryki dla klasy Procesor

Klasa Procesora metryk zawiera informacje o użyciu procesora na maszynie wirtualnej. Gdy wartości procentowe są agregowane, wynik jest średnią dla wszystkich CPU.

W maszynie wirtualnej z dwoma wirtualnymi procesorami, jeśli jeden wirtualny procesor jest zajęty w 100 procentach, a drugi jest w 100 procentach bezczynny, raportowany PercentIdleTime wynosi 50. Jeśli każdy procesor wirtualny jest zajęty o 50 procent w tym samym okresie, zgłoszony wynik wynosi również 50. W przypadku maszyny wirtualnej z czterema vCPU, gdy jeden vCPU jest zajęty w 100 procentach, a pozostałe są nieaktywne, raport PercentIdleTime wynosi 75.

Pierwsze cztery liczniki powinny sumować się do 100 procent. Ostatnie trzy liczniki również dają sumę 100 procent. Te trzy liczniki dzielą sumę PercentProcessorTime, PercentIOWaitTime i PercentInterruptTime.

wbudowane metryki dla klasy Memory

Klasa metryk pamięci zawiera informacje o użyciu pamięci, stronicowaniu i zamianie pamięci.

Ta klasa metryk ma tylko jedno wystąpienie. Atrybut "condition" nie ma przydatnych ustawień i powinien zostać pominięty.

wbudowane metryki dla klasy Network

Klasa sieci metryk zawiera informacje o aktywności sieciowej w poszczególnych interfejsach sieciowych od momentu uruchomienia.

Usługa LAD nie uwidacznia metryk przepustowości. Te metryki można pobrać z metryk hosta.

wbudowane metryki dla klasy System plików

Klasa systemu plików metryk zawiera informacje o użyciu systemu plików. Wartości bezwzględne i procentowe są przedstawiane tak, jak byłyby wyświetlane dla zwykłego użytkownika, a nie root.

builtin metrics for the Disk class (wbudowane metryki dla klasy Dysk)

Klasa metryk dysku zawiera informacje o użyciu urządzenia dyskowego. Te statystyki dotyczą całego dysku.

Gdy urządzenie ma wiele systemów plików, liczniki dla tego urządzenia są, skutecznie, agregowane we wszystkich systemach plików.

Przykładowa konfiguracja usługi LAD 4.0

Na podstawie powyższych definicji ta sekcja zawiera przykładową konfigurację rozszerzenia LAD 4.0 i niektóre wyjaśnienia. Aby zastosować ten przykład, użyj własnej nazwy konta magazynu, tokenu sygnatury dostępu współdzielonego konta i tokenów SAS usługi Event Hubs.

Konfiguracja ustawień chronionych

Ustawienia chronione konfigurują:

• Konto magazynowe.
• Pasujący token sygnatury dostępu współdzielonego konta.
• Kilka ujść: JsonBlob lub EventHub z tokenami SAS.

{
  "storageAccountName": "yourdiagstgacct",
  "storageAccountSasToken": "sv=xxxx-xx-xx&ss=bt&srt=co&sp=wlacu&st=yyyy-yy-yyT21%3A22%3A00Z&se=zzzz-zz-zzT21%3A22%3A00Z&sig=fake_signature",
  "sinksConfig": {
    "sink": [
      {
        "name": "SyslogJsonBlob",
        "type": "JsonBlob"
      },
      {
        "name": "FilelogJsonBlob",
        "type": "JsonBlob"
      },
      {
        "name": "LinuxCpuJsonBlob",
        "type": "JsonBlob"
      },
      {
        "name": "MyJsonMetricsBlob",
        "type": "JsonBlob"
      },
      {
        "name": "LinuxCpuEventHub",
        "type": "EventHub",
        "sasURL": "https://youreventhubnamespace.servicebus.windows.net/youreventhubpublisher?sr=https%3a%2f%2fyoureventhubnamespace.servicebus.windows.net%2fyoureventhubpublisher%2f&sig=fake_signature&se=1808096361&skn=yourehpolicy"
      },
      {
        "name": "MyMetricEventHub",
        "type": "EventHub",
        "sasURL": "https://youreventhubnamespace.servicebus.windows.net/youreventhubpublisher?sr=https%3a%2f%2fyoureventhubnamespace.servicebus.windows.net%2fyoureventhubpublisher%2f&sig=yourehpolicy&skn=yourehpolicy"
      },
      {
        "name": "LoggingEventHub",
        "type": "EventHub",
        "sasURL": "https://youreventhubnamespace.servicebus.windows.net/youreventhubpublisher?sr=https%3a%2f%2fyoureventhubnamespace.servicebus.windows.net%2fyoureventhubpublisher%2f&sig=yourehpolicy&se=1808096361&skn=yourehpolicy"
      }
    ]
  }
}

Konfiguracja ustawień publicznych

Ustawienia publiczne powodują, że usługa LAD może:

• Przekaż metryki czasu procesora procentowego i metryki używanego miejsca na dysku do WADMetrics* tabeli.
• Przekazywanie komunikatów z funkcji "user" syslog i ważności "info" do LinuxSyslog* tabeli.
• Przekaż dołączone wiersze w pliku /var/log/myladtestlog do MyLadTestLog tabeli.

W każdym przypadku dane są również przekazywane do:

• Azure Blob Storage. Nazwa kontenera jest zdefiniowana w ujściu JsonBlob .
• Punkt końcowy usługi Event Hubs określony w ujściu EventHub .

{
  "StorageAccount": "yourdiagstgacct",
  "ladCfg": {
    "sampleRateInSeconds": 15,
    "diagnosticMonitorConfiguration": {
      "performanceCounters": {
        "sinks": "MyMetricEventHub,MyJsonMetricsBlob",
        "performanceCounterConfiguration": [
          {
            "unit": "Percent",
            "type": "builtin",
            "counter": "PercentProcessorTime",
            "counterSpecifier": "/builtin/Processor/PercentProcessorTime",
            "annotation": [
              {
                "locale": "en-us",
                "displayName": "cpu percentage guest os"
              }
            ],
            "condition": "IsAggregate=TRUE",
            "class": "Processor"
          },
          {
            "unit": "Bytes",
            "type": "builtin",
            "counter": "UsedSpace",
            "counterSpecifier": "/builtin/FileSystem/UsedSpace",
            "annotation": [
              {
                "locale": "en-us",
                "displayName": "Used disfilesystem used space"
              }
            ],
            "condition": "Name=\"/\"",
            "class": "Filesystem"
          }
        ]
      },
      "metrics": {
        "metricAggregation": [
          {
            "scheduledTransferPeriod": "PT1H"
          },
          {
            "scheduledTransferPeriod": "PT1M"
          }
        ],
        "resourceId": "/subscriptions/your_azure_subscription_id/resourceGroups/your_resource_group_name/providers/Microsoft.Compute/virtualMachines/your_vm_name"
      },
      "eventVolume": "Large",
      "syslogEvents": {
        "sinks": "SyslogJsonBlob,LoggingEventHub",
        "syslogEventConfiguration": {
          "LOG_USER": "LOG_INFO"
        }
      }
    }
  },
  "sinksConfig": {
    "sink": [
      {
        "name": "AzMonSink",
        "type": "AzMonSink",
        "AzureMonitor": {}
      }
    ]
  },
  "fileLogs": [
    {
      "file": "/var/log/myladtestlog",
      "table": "MyLadTestLog",
      "sinks": "FilelogJsonBlob,LoggingEventHub"
    }
  ]
}

Element resourceId w konfiguracji musi być zgodny z maszyną wirtualną lub zestawem skalowania maszyn wirtualnych.

• Wykresy metryk platformy Azure i alerty rozpoznają resourceId maszyny wirtualnej, na której pracujesz. Oczekuje się, że dane maszyny wirtualnej będą znajdowane przy użyciu resourceId jako klucza wyszukiwania.
• Jeśli używasz automatycznego skalowania w Azure, resourceId w konfiguracji musi być zgodna z resourceId używaną przez LAD.
• Obiekt resourceId jest wbudowany w nazwy obiektów blob JSON napisanych przez usługę LAD.

Wyświetlanie danych

Użyj witryny Azure Portal, aby wyświetlić dane wydajności lub ustawić alerty:

Dane performanceCounters są zawsze przechowywane w tabeli usługi Azure Storage. Interfejsy API usługi Azure Storage są dostępne dla wielu języków i platform.

Dane wysyłane do JsonBlob odbiorników są przechowywane w plikach blobów na koncie magazynowym określonym w ustawieniach chronionych. Można używać danych blobów w dowolnym interfejsie API usługi Azure Blob Storage.

Możesz również użyć tych narzędzi interfejsu użytkownika, aby uzyskać dostęp do danych w usłudze Azure Storage:

• Eksplorator programu Visual Studio Server
• Eksplorator usługi Azure Storage

Poniższy zrzut ekranu sesji Eksploratora usługi Azure Storage przedstawia wygenerowane tabele i kontenery usługi Azure Storage z poprawnie skonfigurowanego rozszerzenia USŁUGI LAD 4.0 na testowej maszynie wirtualnej. Obraz nie jest dokładnie zgodny z przykładową konfiguracją usługi LAD 4.0.

Aby uzyskać więcej informacji na temat korzystania z komunikatów publikowanych w punkcie końcowym usługi Event Hubs, zobacz odpowiednią dokumentację usługi Event Hubs.

Dalsze kroki

• W usłudze Azure Monitor utwórz alerty dotyczące zbieranych metryk.
• Tworzenie wykresów monitorowania dla metryk.
• Utwórz zestaw skalowania maszyn wirtualnych przy użyciu metryk w celu kontrolowania skalowania automatycznego.