Hochladen von Nutzungsdaten, Metriken und Protokollen in Azure

  • Artikel

Sie können in regelmäßigen Abständen Nutzungsinformationen zu Abrechnungszwecken, Überwachungsmetriken und Protokolle exportieren und dann in Azure hochladen. Beim Exportieren und Hochladen dieser drei Datentypen werden auch die Ressourcen des Datencontrollers und der verwalteten SQL-Instanz in Azure erstellt und aktualisiert.

Bevor Sie Nutzungsdaten, Metriken oder Protokolle hochladen können, müssen Sie folgende Schritte ausführen:

Beispiele in diesem Artikel verwenden eckige Klammern < ... >, um Werte zu identifizieren, die Sie ersetzen müssen, bevor Sie das Skript ausführen. Ersetzen Sie die Klammern und die Werte in den Klammern.

Installieren von Tools

Erforderliche Tools:

  • Azure CLI (az)
  • arcdata-Erweiterung

Informationen finden Sie unter Installieren von Clienttools zum Bereitstellen und Verwalten von Azure Arc-fähigen Datendiensten.

Registrieren des Ressourcenanbieters

Vor dem Hochladen von Metriken oder Benutzerdaten in Azure müssen Sie sicherstellen, dass der Ressourcenanbieter Microsoft.AzureArcData für Ihr Azure-Abonnement registriert wurde.

Führen Sie den folgenden Befehl aus, um den Ressourcenanbieter zu überprüfen:

az provider show -n Microsoft.AzureArcData -o table

Falls der Ressourcenanbieter nicht bereits für Ihr Abonnement registriert ist, können Sie ihn registrieren. Führen Sie den folgenden Befehl aus, um ihn zu registrieren: Die Ausführung dieses Befehls dauert unter Umständen ein bis zwei Minuten.

az provider register -n Microsoft.AzureArcData --wait

Erstellen eines Dienstprinzipals

Der Dienstprinzipal wird verwendet, um Nutzungs- und Metrikdaten hochzuladen.

Führen Sie die folgenden Befehle aus, um den Dienstprinzipal für den Metrikupload zu erstellen:

Hinweis

Zum Erstellen eines Dienstprinzipals sind bestimmte Berechtigungen in Azure erforderlich.

Aktualisieren Sie zum Erstellen eines Dienstprinzipals das folgende Beispiel. Ersetzen Sie <ServicePrincipalName>, SubscriptionId und resourcegroup durch Ihre eigenen Werte, und führen Sie folgenden Befehl aus:

az ad sp create-for-rbac --name <ServicePrincipalName> --role Contributor --scopes /subscriptions/<SubscriptionId>/resourceGroups/<resourcegroup>

Wenn Sie den Dienstprinzipal zuvor erstellt haben und nur die aktuellen Anmeldeinformationen abrufen müssen, führen Sie den folgenden Befehl aus, um die Anmeldeinformationen zurückzusetzen:

az ad sp credential reset --name <ServicePrincipalName>

Führen Sie zum Erstellen eines Dienstprinzipals mit dem Namen azure-arc-metrics beispielsweise den folgenden Befehl aus:

az ad sp create-for-rbac --name azure-arc-metrics --role Contributor --scopes /subscriptions/<SubscriptionId>/resourceGroups/myresourcegroup

Beispielausgabe:

"appId": "<appId>",
"displayName": "azure-arc-metrics",
"name": "http://azure-arc-metrics",
"password": "<password>",
"tenant": "<tenant>"

Speichern Sie die Werte appId, password und tenant in einer Umgebungsvariable, um sie später zu verwenden. Diese Werte befinden sich in Form von GUID (Globally Unique Identifier).

SET SPN_CLIENT_ID=<appId>
SET SPN_CLIENT_SECRET=<password>
SET SPN_TENANT_ID=<tenant>

Weisen Sie nach der Erstellung des Dienstprinzipals diesen der entsprechenden Rolle zu.

Zuweisen von Rollen zum Dienstprinzipal

Führen Sie den folgenden Befehl aus, um dem Dienstprinzipal die Rolle Monitoring Metrics Publisher für das Abonnement zuzuweisen, in dem sich Ihre Datenbankinstanzressourcen befinden:

Hinweis

Bei der Ausführung in einer Windows-Umgebung müssen Sie für Rollennamen doppelte Anführungszeichen verwenden.

az role assignment create --assignee <appId> --role "Monitoring Metrics Publisher" --scope subscriptions/<SubscriptionID>/resourceGroups/<resourcegroup>

Beispielausgabe:

{
  "canDelegate": null,
  "id": "/subscriptions/<Subscription ID>/providers/Microsoft.Authorization/roleAssignments/<globally unique identifier>",
  "name": "<globally unique identifier>",
  "principalId": "<principal id>",
  "principalType": "ServicePrincipal",
  "roleDefinitionId": "/subscriptions/<Subscription ID>/providers/Microsoft.Authorization/roleDefinitions/<globally unique identifier>",
  "scope": "/subscriptions/<Subscription ID>",
  "type": "Microsoft.Authorization/roleAssignments"
}

Überprüfen der Dienstprinzipalrolle

az role assignment list --scope subscriptions/<SubscriptionID>/resourceGroups/<resourcegroup> -o table

Nachdem der Dienstprinzipal der entsprechenden Rolle zugewiesen wurde, können Sie mit dem Hochladen von Metriken oder Benutzerdaten fortfahren.

Hochladen von Protokollen, Metriken oder Nutzungsdaten

Welche Schritte zum Hochladen von Protokollen, Metriken oder Nutzungsdaten erforderlich sind, hängt davon ab, welche Art von Informationen Sie hochladen.

Hochladen von Protokollen in Azure Monitor

Hochladen von Metriken in Azure Monitor

Hochladen von Nutzungsdaten in Azure

Allgemeine Anleitung zum Exportieren und Hochladen von Nutzungsdaten und Metriken

Erstellungs-, Lese-, Aktualisierungs- und Löschvorgänge – sogenannte CRUD-Vorgänge (Create, Read, Update, Delete) – in Azure Arc-fähigen Datendiensten werden zu Abrechnungs- und Überwachungszwecken protokolliert. Hintergrunddienste überwachen diese CRUD-Vorgänge und berechnen den Verbrauch entsprechend. Die tatsächliche Berechnung der Nutzung oder des Verbrauchs erfolgt nach einem Zeitplan und wird im Hintergrund durchgeführt.

Laden Sie die Nutzung nur einmal pro Tag hoch. Wenn Nutzungsinformationen innerhalb desselben 24-Stunden-Zeitraums mehrmals exportiert und hochgeladen werden, wird nur der Ressourcenbestand im Azure-Portal aktualisiert, jedoch nicht der Ressourcenverbrauch.

Hinweis

Nutzungsdaten werden automatisch für den Azure Arc-Datencontroller hochgeladen, der im direkten Verbindungsmodus bereitgestellt wird.

Beim Hochladen von Metriken können in Azure Monitor nur die Daten der letzten 30 Minuten hochgeladen werden (weitere Informationen). Beim Hochladen von Metriken wird empfohlen, die Metriken unmittelbar nach dem Erstellen der Exportdatei hochzuladen, damit Sie das gesamte Dataset im Azure-Portal anzeigen können. Beispiel: Sie haben die Metriken um 14:00 Uhr exportiert und den Befehl für den Upload um 14:50 Uhr ausgeführt. Da in Azure Monitor nur die Daten der letzten 30 Minuten akzeptiert werden, werden im Portal möglicherweise keine Daten angezeigt.

Zugehöriger Inhalt

Informieren Sie sich über Dienstprinzipale.

Hochladen von Abrechnungsdaten in Azure und Anzeigen im Azure-Portal

Anzeigen der Azure Arc-Datencontrollerressource im Azure-Portal