Levering van diagnostisch logboek configureren

Artikel
08/20/2024

In dit artikel wordt beschreven hoe u de levering van diagnostische logboeken inschakelt voor uw Azure Databricks-werkruimten.

Notitie

Voor diagnostische logboeken is het Premium-abonnement vereist.

Meld u aan bij Azure Portal als eigenaar, inzender of als gebruiker met een aangepaste rol met de Microsoft.Databricks/workspaces/assignWorkspaceAdmin/action machtiging voor de Azure Databricks-werkruimte. Klik vervolgens op uw Azure Databricks-serviceresource.
Klik in de sectie Bewaking van de zijbalk op het tabblad Diagnostische instellingen .
Klik op Diagnostische gegevens inschakelen.
Geef op de pagina Diagnostische instellingen de volgende configuratie op:

Naam

Voer een naam in voor de logboeken die u wilt maken.

Archiveren naar een opslagaccount

Als u deze optie wilt gebruiken, hebt u een bestaand opslagaccount nodig om verbinding mee te maken. Als u een nieuw opslagaccount in de portal wilt maken, raadpleegt u Een opslagaccount maken en volgt u de instructies voor het maken van een Azure Resource Manager-account voor algemeen gebruik. Ga vervolgens terug naar deze pagina in de portal om uw opslagaccount te selecteren. Het kan enkele minuten duren voordat nieuw gemaakte opslagaccounts worden weergegeven in de vervolgkeuzelijst. Zie de prijzen van Azure Storage voor meer informatie over extra kosten die worden gemaakt door naar een opslagaccount te schrijven.

Streamen naar een Event Hub

Als u deze optie wilt gebruiken, hebt u een bestaande Azure Event Hubs-naamruimte en Event Hub nodig om verbinding te maken met. Zie Een Event Hubs-naamruimte en een Event Hubs-naamruimte maken met behulp van Azure Portal om een Event Hubs-naamruimte te maken. Ga vervolgens terug naar deze pagina in de portal om de Event Hubs-naamruimte en beleidsnaam te selecteren. Zie de prijzen van Azure Event Hubs voor meer informatie over extra kosten die worden gemaakt door naar een Event Hub te schrijven.

Verzenden naar Log Analytics

Als u deze optie wilt gebruiken, gebruikt u een bestaande Log Analytics-werkruimte of maakt u een nieuwe werkruimte door de stappen te volgen voor het maken van een nieuwe werkruimte in de portal. Zie de prijzen van Azure Monitor voor meer informatie over extra kosten die worden gemaakt door logboeken naar Log Analytics te verzenden.
Kies de services waarvoor u diagnostische logboeken wilt gebruiken.
Selecteer Opslaan.
Als u een foutmelding krijgt met de tekst 'Kan diagnostische gegevens niet bijwerken voor <workspace name>. Het abonnement <subscription id> is niet geregistreerd voor het gebruik van microsoft.insights. Volg de instructies voor probleemoplossing voor Azure Diagnostics om het account te registreren en voer deze procedure opnieuw uit.
Als u wilt wijzigen hoe uw diagnostische logboeken op elk gewenst moment in de toekomst worden opgeslagen, gaat u terug naar deze pagina om de instellingen voor diagnostisch logboeken voor uw account te wijzigen.

Notitie

Als u bewaarbeleid voor opslag wilt instellen, configureert u een beleid voor levenscyclusbeheer van Azure.

Logboekregistratie inschakelen met PowerShell

Start een Azure PowerShell-sessie en meld u aan bij uw Azure-account met de volgende opdracht:
```
 Connect-AzAccount
```
Als u zich als gebruiker wilt aanmelden bij uw Azure-account, raadpleegt u PowerShell-aanmelding met een Azure Databricks-gebruikersaccount. Als u zich als service-principal wilt aanmelden bij uw Azure-account, raadpleegt u PowerShell-aanmelding met een Microsoft Entra ID-service-principal.

Als u Azure Powershell nog niet hebt geïnstalleerd, gebruikt u de volgende opdrachten om Azure PowerShell te installeren.
```
 Install-Module -Name Az -AllowClobber
```
Voer in het pop-upvenster in de browser uw gebruikersnaam en wachtwoord voor uw Azure-account in. Azure PowerShell haalt alle abonnementen op die zijn gekoppeld aan dit account en maakt standaard gebruik van het eerste abonnement.

Als u meer dan één abonnement hebt, moet u mogelijk het specifieke abonnement opgeven dat is gebruikt om uw Azure Key Vault te maken. Als u de abonnementen voor uw account wilt zien, typt u de volgende opdracht:
```
Get-AzSubscription
```
Als u het abonnement wilt opgeven dat is gekoppeld aan het Azure Databricks-account dat u wilt registreren, typt u de volgende opdracht:
```
Set-AzContext -SubscriptionId <subscription ID>
```

Stel de naam van uw Log Analytics-resource in op een variabele met de naam logAnalytics, waarbij ResourceName de naam van de Log Analytics-werkruimte is.

$logAnalytics = Get-AzResource -ResourceGroupName <resource group name> -ResourceName <resource name> -ResourceType "Microsoft.OperationalInsights/workspaces"

Stel de naam van de Azure Databricks-serviceresource in op een variabele met de naam databricks, waarbij ResourceName de naam van de Azure Databricks-service is.

$databricks = Get-AzResource -ResourceGroupName <your resource group name> -ResourceName <your Azure Databricks service name> -ResourceType "Microsoft.Databricks/workspaces"

Als u logboekregistratie voor Azure Databricks wilt inschakelen, gebruikt u de cmdlet New-AzDiagnosticSetting met variabelen voor het nieuwe opslagaccount, de Azure Databricks-service en de categorie om logboekregistratie in te schakelen. Voer de volgende opdracht uit en stel de -Enabled vlag in op $true:
```
New-AzDiagnosticSetting -ResourceId $databricks.ResourceId -WorkspaceId $logAnalytics.ResourceId -Enabled $true -name "<diagnostic setting name>" -Category <comma separated list>
```

Logboekregistratie inschakelen met behulp van Azure CLI

Open PowerShell.
Gebruik de volgende opdracht om verbinding te maken met uw Azure-account:
```
az login
```
Als u verbinding wilt maken met behulp van een Microsoft Entra ID-service-principal, raadpleegt u azure CLI-aanmelding met een Service-principal voor Microsoft Entra ID.

Als u verbinding wilt maken met behulp van een Azure Databricks-gebruikersaccount, raadpleegt u azure CLI-aanmelding met een Azure Databricks-gebruikersaccount.

Voer de volgende opdracht voor diagnostische instellingen uit:

az monitor diagnostic-settings create --name <diagnostic name>
--resource-group <log analytics workspace resource group>
--workspace <log analytics name or object ID>
--resource <target resource object ID>
--logs '[
{
 \"category\": <category name>,
  \"enabled\": true
}
]'

REST-API

Gebruik de LogSettings-API .

Aanvraag

PUT https://management.azure.com/{resourceUri}/providers/microsoft.insights/diagnosticSettings/{name}?api-version=2017-05-01-preview

Aanvraagtekst

{
    "properties": {
    "workspaceId": "<log analytics resourceId>",
    "logs": [
      {
        "category": "<category name>",
        "enabled": true,
        "retentionPolicy": {
          "enabled": false,
          "days": 0
        }
      }
    ]
  }
}

Latentie van diagnostisch logboek

Nadat logboekregistratie is ingeschakeld voor uw account, verzendt Azure Databricks automatisch diagnostische logboeken naar uw bezorgingslocatie. Logboeken zijn doorgaans binnen 15 minuten na activering beschikbaar. Controleerbare gebeurtenissen van Azure Databricks worden doorgaans binnen 15 minuten in diagnostische logboeken weergegeven in commerciële Azure-regio's.

SSH-aanmeldingslogboeken worden geleverd met hoge latentie.

Notitie

Hoewel de meeste logboeken naar verwachting binnen 15 minuten worden geleverd, garandeert Azure Databricks geen tijdsbestek voor het leveren van logboeken.

Delen via

Levering van diagnostisch logboek configureren

Logboekregistratie inschakelen met PowerShell

Logboekregistratie inschakelen met behulp van Azure CLI

REST-API

Aanvraag

Aanvraagtekst

Latentie van diagnostisch logboek

Feedback

Aanvullende resources