Dzienniki diagnostyczne — Azure Content Delivery Network

Za pomocą dzienników diagnostycznych platformy Azure można wyświetlać podstawowe analizy i zapisywać je w co najmniej jednym miejscu docelowym, w tym:

• Konto usługi Azure Storage
• Obszar roboczy usługi Log Analytics
• Azure Event Hubs

Ta funkcja jest dostępna w punktach końcowych sieci dostarczania zawartości dla wszystkich warstw cenowych.

Dzienniki diagnostyczne umożliwiają eksportowanie podstawowych metryk użycia z punktu końcowego sieci dostarczania zawartości do różnych źródeł, dzięki czemu można z nich korzystać w dostosowany sposób. Możesz wykonać następujące typy eksportu danych:

• Export data to blob storage, export to CSV, and generate graphs in Excel.
• Eksportowanie danych do usługi Event Hubs i korelowanie z danymi z innych usług platformy Azure.
• Eksportowanie danych do dzienników usługi Azure Monitor i wyświetlanie danych we własnym obszarze roboczym usługi Log Analytics

Do wykonania poniższych kroków jest wymagany profil usługi Azure Content Delivery Network. Przed kontynuowaniem zapoznaj się z artykułem Tworzenie profilu i punktu końcowego usługi Azure Content Delivery Network.

Włączanie rejestrowania w witrynie Azure Portal

Wykonaj następujące kroki, aby włączyć rejestrowanie punktu końcowego usługi Azure Content Delivery Network:

1. Zaloguj się w witrynie Azure Portal.

2. W portalu Azure przejdź do Wszystkie zasoby>your-cdn-profile.

3. Wybierz punkt końcowy sieci dostarczania zawartości, dla którego chcesz włączyć dzienniki diagnostyczne.

4. Wybierz pozycję Dzienniki diagnostyczne w sekcji Monitorowanie .

Włączanie rejestrowania za pomocą usługi Azure Storage

Aby przechowywać logi przy użyciu konta magazynowego, wykonaj następujące kroki:

1. W polu Nazwa ustawienia diagnostycznego wprowadź nazwę ustawień dziennika diagnostycznego.

2. Select Archive to a storage account, then select CoreAnalytics.

3. W obszarze Przechowywanie (dni) wybierz liczbę dni przechowywania. A retention of zero days stores the logs indefinitely.

4. Select the subscription and storage account for the logs.

5. Wybierz pozycję Zapisz.

Wysyłanie do usługi Log Analytics

Aby użyć usługi Log Analytics dla dzienników, wykonaj następujące kroki:

1. W polu Nazwa ustawienia diagnostycznego wprowadź nazwę ustawień dziennika diagnostycznego.

2. Wybierz pozycję Wyślij do usługi Log Analytics, a następnie wybierz pozycję CoreAnalytics.

3. Wybierz subskrypcję i obszar roboczy usługi Log Analytics dla dzienników.

   

4. Wybierz pozycję Zapisz.

Stream to an event hub

Aby użyć centrum zdarzeń dla dzienników, wykonaj następujące kroki:

1. W polu Nazwa ustawienia diagnostycznego wprowadź nazwę ustawień dziennika diagnostycznego.

2. Select Stream to an event hub, then select CoreAnalytics.

3. Select the subscription and event hub namespace for the logs.

   

4. Wybierz pozycję Zapisz.

Włączanie rejestrowania przy użyciu programu PowerShell

W poniższym przykładzie pokazano, jak włączyć dzienniki diagnostyczne za pomocą poleceń cmdlet programu Azure PowerShell.

Enable diagnostic logs in a storage account

1. Zaloguj się do programu Azure PowerShell:

   Connect-AzAccount 
   

2. To enable Diagnostic Logs in a storage account, enter these commands. Zastąp zmienne swoimi wartościami:

   $rsg = <your-resource-group-name>
   $cdnprofile = <your-cdn-profile-name>
   $cdnendpoint = <your-cdn-endpoint-name>
   $storageacct = <your-storage-account-name>
   $diagname = <your-diagnostic-setting-name>
   
   $cdn = Get-AzCdnEndpoint -ResourceGroupName $rsg -ProfileName $cdnprofile -EndpointName $cdnendpoint
   
   $storage = Get-AzStorageAccount -ResourceGroupName $rsg -Name $storageacct
   
   Set-AzDiagnosticSetting -Name $diagname -ResourceId $cdn.id -StorageAccountId $storage.id -Enabled $true -Categories CoreAnalytics
   

Włączanie dzienników diagnostycznych dla obszaru roboczego usługi Log Analytics

1. Zaloguj się do programu Azure PowerShell:

   Connect-AzAccount 
   

2. Aby włączyć dzienniki diagnostyczne dla obszaru roboczego usługi Log Analytics, wprowadź te polecenia. Zastąp zmienne swoimi wartościami:

   $rsg = <your-resource-group-name>
   $cdnprofile = <your-cdn-profile-name>
   $cdnendpoint = <your-cdn-endpoint-name>
   $workspacename = <your-log-analytics-workspace-name>
   $diagname = <your-diagnostic-setting-name>
   
   $cdn = Get-AzCdnEndpoint -ResourceGroupName $rsg -ProfileName $cdnprofile -EndpointName $cdnendpoint
   
   $workspace = Get-AzOperationalInsightsWorkspace -ResourceGroupName $rsg -Name $workspacename
   
   Set-AzDiagnosticSetting -Name $diagname -ResourceId $cdn.id -WorkspaceId $workspace.ResourceId -Enabled $true -Categories CoreAnalytics
   

Enable diagnostics logs for event hub namespace

1. Zaloguj się do programu Azure PowerShell:

   Connect-AzAccount 
   

2. Aby włączyć dzienniki diagnostyczne dla obszaru roboczego usługi Log Analytics, wprowadź te polecenia. Zastąp zmienne swoimi wartościami:

   $rsg = <your-resource-group-name>
   $cdnprofile = <your-cdn-profile-name>
   $cdnendpoint = <your-cdn-endpoint-name>
   $eventhubname = <your-event-hub-namespace-name>
   $diagname = <your-diagnostic-setting-name>
   
   $cdn = Get-AzCdnEndpoint -ResourceGroupName $rsg -ProfileName $cdnprofile -EndpointName $cdnendpoint
   
   Set-AzDiagnosticSetting -Name $diagname -ResourceId $cdn.id -EventHubName $eventhubname -Enabled $true -Categories CoreAnalytics
   

Consuming diagnostics logs from Azure Storage

W tej sekcji opisano schemat analizy podstawowej sieci dostarczania zawartości, organizacji na koncie usługi Azure Storage i zawiera przykładowy kod umożliwiający pobranie dzienników w pliku CSV.

Korzystanie z Eksploratora usługi Microsoft Azure Storage

Aby pobrać narzędzie, zobacz Eksplorator usługi Azure Storage. Po pobraniu i zainstalowaniu oprogramowania skonfiguruj go tak, aby używał tego samego konta usługi Azure Storage, które zostało skonfigurowane jako miejsce docelowe w dziennikach diagnostycznych sieci dostarczania zawartości.

1. Otwórz Eksplorator usługi Microsoft Azure Storage
2. Zlokalizuj konto magazynowe
3. Expand the Blob Containers node under this storage account.
4. Wybierz kontener o nazwie insights-logs-coreanalytics.
5. Wyniki są wyświetlane w okienku po prawej stronie, zaczynając od pierwszego poziomu, jako resourceId=. Kontynuuj wybieranie każdego poziomu, aż znajdziesz plik PT1H.json. For an explanation of the path, see Blob path format.
6. Each blob PT1H.json file represents the analytics logs for one hour for a specific content delivery network endpoint or its custom domain.
7. Schemat zawartości tego pliku JSON jest opisany w sekcji schematu podstawowych dzienników analitycznych.

Blob path format

Core analytics logs are generated every hour and the data is collected and stored inside a single Azure blob as a JSON payload. Narzędzie Eksploratora usługi Storage interpretuje znak "/" jako separator katalogu i pokazuje hierarchię. The path to the Azure blob appears as if there's a hierarchical structure and represents the blob name. The name of the blob follows the following naming convention:

resourceId=/SUBSCRIPTIONS/{Subscription Id}/RESOURCEGROUPS/{Resource Group Name}/PROVIDERS/MICROSOFT.CDN/PROFILES/{Profile Name}/ENDPOINTS/{Endpoint Name}/ y=/m=/d=/h=/m=/PT1H.json

Opis pól:

Eksportowanie podstawowych danych analitycznych do pliku CSV

Aby uzyskać dostęp do podstawowej analizy, udostępniany jest przykładowy kod narzędzia. To narzędzie umożliwia pobieranie plików JSON do prostego formatu pliku rozdzielanego przecinkami, który może służyć do tworzenia wykresów lub innych agregacji.

Oto jak można użyć narzędzia:

1. Odwiedź link usługi GitHub: https://github.com/Azure-Samples/azure-cdn-samples/tree/master/CoreAnalytics-ExportToCsv
2. Pobierz kod.
3. Postępuj zgodnie z instrukcjami, aby skompilować i skonfigurować.
4. Uruchom narzędzie.
5. Wynikowy plik CSV przedstawia dane analityczne w prostej płaskiej hierarchii.

Log data delays

Dane dziennika firmy Microsoft są opóźnione o maksymalnie 1 godzinę. To opóźnienie jest spowodowane czasem potrzebnym na przetworzenie i zapisanie danych.

Typy dzienników diagnostycznych na potrzeby analizy podstawowej sieci dostarczania zawartości

Firma Microsoft obecnie oferuje jedynie podstawowe dzienniki analityczne, które prezentują metryki ukazujące statystyki odpowiedzi HTTP oraz statystyki dotyczące ruchu wychodzącego, widoczne z punktów POP i krawędzi sieci dostarczania treści.

Szczegóły metryk analizy podstawowej

W poniższej tabeli przedstawiono listę metryk dostępnych w podstawowych dziennikach analizy.

Nie wszystkie metryki są dostępne dla wszystkich dostawców, chociaż takie różnice są minimalne. W tabeli przedstawiono również, czy dana metryka jest dostępna u dostawcy. Metryki są dostępne tylko dla punktów końcowych sieci dostarczania zawartości, które mają na nich ruch.

*Transfer danych wychodzących odnosi się do ruchu dostarczonego z serwerów POP sieci dostarczania zawartości do klienta.

Schemat podstawowych dzienników analitycznych

Wszystkie dzienniki są przechowywane w formacie JSON, a każdy wpis zawiera pola ciągów zgodnie z następującym schematem:

    "records": [
        {
            "time": "2017-04-27T01:00:00",
            "resourceId": "<ARM Resource Id of the CDN Endpoint>",
            "operationName": "Microsoft.Cdn/profiles/endpoints/contentDelivery",
            "category": "CoreAnalytics",
            "properties": {
                "DomainName": "<Name of the domain for which the statistics is reported>",
                "RequestCountTotal": integer value,
                "RequestCountHttpStatus2xx": integer value,
                "RequestCountHttpStatus3xx": integer value,
                "RequestCountHttpStatus4xx": integer value,
                "RequestCountHttpStatus5xx": integer value,
                "RequestCountHttpStatusOthers": integer value,
                "RequestCountHttpStatus200": integer value,
                "RequestCountHttpStatus206": integer value,
                "RequestCountHttpStatus302": integer value,
                "RequestCountHttpStatus304": integer value,
                "RequestCountHttpStatus404": integer value,
                "RequestCountCacheHit": integer value,
                "RequestCountCacheMiss": integer value,
                "RequestCountCacheNoCache": integer value,
                "RequestCountCacheUncacheable": integer value,
                "RequestCountCacheOthers": integer value,
                "EgressTotal": double value,
                "EgressHttpStatus2xx": double value,
                "EgressHttpStatus3xx": double value,
                "EgressHttpStatus4xx": double value,
                "EgressHttpStatus5xx": double value,
                "EgressHttpStatusOthers": double value,
                "EgressCacheHit": double value,
                "EgressCacheMiss": double value,
                "EgressCacheNoCache": double value,
                "EgressCacheUncacheable": double value,
                "EgressCacheOthers": double value,
            }
        }

    ]
}

Gdzie czas oznacza początek przedziału godzinowego, dla którego raportowane są statystyki. Metryka nieobsługiwana przez dostawcę sieci dostarczania zawartości zamiast wartości podwójnej lub całkowitej powoduje wartość null. Ta wartość null wskazuje brak metryki i różni się od wartości 0. Jeden zestaw tych metryk na domenę jest skonfigurowany w punkcie końcowym.

Przykładowe właściwości:

{
     "DomainName": "azurecdntest.azureedge.net",
     "RequestCountTotal": 480,
     "RequestCountHttpStatus2xx": 480,
     "RequestCountHttpStatus3xx": 0,
     "RequestCountHttpStatus4xx": 0,
     "RequestCountHttpStatus5xx": 0,
     "RequestCountHttpStatusOthers": 0,
     "RequestCountHttpStatus200": 480,
     "RequestCountHttpStatus206": 0,
     "RequestCountHttpStatus302": 0,
     "RequestCountHttpStatus304": 0,
     "RequestCountHttpStatus404": 0,
     "RequestCountCacheHit": null,
     "RequestCountCacheMiss": null,
     "RequestCountCacheNoCache": null,
     "RequestCountCacheUncacheable": null,
     "RequestCountCacheOthers": null,
     "EgressTotal": 0.09,
     "EgressHttpStatus2xx": null,
     "EgressHttpStatus3xx": null,
     "EgressHttpStatus4xx": null,
     "EgressHttpStatus5xx": null,
     "EgressHttpStatusOthers": null,
     "EgressCacheHit": null,
     "EgressCacheMiss": null,
     "EgressCacheNoCache": null,
     "EgressCacheUncacheable": null,
     "EgressCacheOthers": null
}

Więcej zasobów

• Dzienniki diagnostyczne platformy Azure
• Podstawowe analizy za pośrednictwem portalu uzupełniającego usługi Azure Content Delivery Network
• Dzienniki usługi Azure Monitor
• Azure Log Analytics REST API