Hochladen von Metriken in Azure Monitor

  • Artikel

Sie können in regelmäßigen Abständen Überwachungsmetriken exportieren und diese dann in Azure hochladen. Beim Exportieren und Hochladen von Daten werden auch die Ressourcen des Datencontrollers, der verwalteten SQL-Instanz und des PostgreSQL-Servers in Azure erstellt und aktualisiert.

Mit Azure Arc-Datendiensten können Sie optional Metriken in Azure Monitor hochladen, um Metriken aggregieren und analysieren, Warnungen auslösen, Benachrichtigungen senden oder automatisierte Aktionen auslösen zu können.

Wenn Sie Ihre Daten an Azure Monitor senden, können Sie auch Metrikdaten außerhalb des Standorts und in riesigem Umfang für die langfristige Aufbewahrung der Daten für erweiterte Analysen speichern.

Wenn Sie Azure Arc-Datendienste an mehreren Standorten verwenden, können Sie Azure Monitor als zentralen Speicherort verwenden, um alle Protokolle und Metriken für Ihre Standorte zu erfassen.

Hochladen von Metriken für Azure Arc-Datencontrollers im direkten Modus

Im direkt verbundenen Modus kann der Metrikupload nur im automatischen Modus eingerichtet werden. Dieser automatische Upload von Metrikdaten kann während oder nach der Bereitstellung des Azure Arc-Datencontrollers eingerichtet werden. Die verwaltete Identität der Arc-Datendiensteerweiterung wird zum Hochladen von Metriken verwendet. Der verwalteten Identität muss die Rolle Herausgeber von Überwachungsmetriken zugewiesen werden.

Hinweis

Wenn das automatische Hochladen von Metriken während der Bereitstellung des Azure Arc-Datencontrollers deaktiviert wurde, müssen Sie zunächst die verwaltete Identität der Arc-Datencontrollererweiterung abrufen und ihr die Rolle Herausgeber von Überwachungsmetriken gewähren, bevor Sie den automatischen Upload aktivieren. Führen Sie die folgenden Schritte aus, um die verwaltete Identität abzurufen und die erforderlichen Rollen zu gewä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.

(1) Abrufen der verwalteten Identität der Arc-Datencontrollererweiterung

$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group <resource group>  --cluster-name <connectedclustername> --cluster-type connectedClusters --name <name of extension> | convertFrom-json).identity.principalId
#Example
$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group myresourcegroup  --cluster-name myconnectedcluster --cluster-type connectedClusters --name ads-extension | convertFrom-json).identity.principalId

(2) Zuweisen einer Rolle zur verwalteten Identität

Führen Sie den folgenden Befehl aus, um die Rolle Herausgeber von Überwachungsmetriken zuzuweisen:

az role assignment create --assignee $Env:MSI_OBJECT_ID --role 'Monitoring Metrics Publisher' --scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME"

Das automatische Hochladen von Metriken kann wie folgt aktiviert werden:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics true
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics true

Führen Sie den folgenden Befehl aus, um das automatische Hochladen von Metriken in Azure Monitor zu deaktivieren:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics false
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics false

Hochladen von Metriken für Azure Arc-Datencontrollers im indirekten Modus

Im indirekt verbundenen Modus wird der Dienstprinzipal zum Hochladen von Metriken verwendet.

Voraussetzungen

Stellen Sie vor dem Fortfahren sicher, dass Sie den erforderlichen Dienstprinzipal erstellt und einer geeigneten Rolle zugewiesen haben. Einzelheiten dazu finden Sie unter:

Festlegen und Bestätigen von Umgebungsvariablen

Legen Sie die URL der SPN-Autorität in einer Umgebungsvariablen fest:

$Env:SPN_AUTHORITY='https://login.microsoftonline.com'

Stellen Sie sicher, dass alle erforderlichen Umgebungsvariablen festgelegt sind:

$Env:SPN_TENANT_ID
$Env:SPN_CLIENT_ID
$Env:SPN_CLIENT_SECRET
$Env:SPN_AUTHORITY

Hochladen von Metriken in Azure Monitor

Führen Sie die folgenden CLI-Befehle aus, um Metriken für durch Azure Arc aktiviertes SQL Managed Instance und PostgreSQL mit Azure Arc-Unterstützung hochzuladen:

  1. Exportieren Sie alle Metriken in die angegebene Datei:

Hinweis

Das Exportieren von Nutzungs-/Abrechnungsinformationen, Metriken und Protokollen mithilfe des Befehls az arcdata dc export erfordert vorerst die Umgehung der SSL-Überprüfung. Sie werden aufgefordert, die SSL-Überprüfung zu umgehen, oder Sie können die Umgebungsvariable AZDATA_VERIFY_SSL=no festlegen, um Aufforderungen zu vermeiden. Derzeit gibt es keine Möglichkeit, ein SSL-Zertifikat für die Datencontroller-Export-API zu konfigurieren.

az arcdata dc export --type metrics --path metrics.json --k8s-namespace arc

  1. Laden Sie die Metriken in Azure Monitor hoch:

    az arcdata dc upload --path metrics.json

    Hinweis

    Warten Sie mindestens 30 Minuten, nachdem die Azure Arc-fähigen Dateninstanzen für den ersten Upload erstellt wurden.

    Führen Sie direkt nach dem export unbedingt den upload durch, da Azure Monitor nur Metriken für die letzten 30 Minuten akzeptiert. Weitere Informationen

Wenn beim Exportieren Fehler vom Typ „Failure to get metrics“ (Fehler beim Abrufen der Metriken) angezeigt werden, überprüfen Sie, ob die Datensammlung auf true festgelegt ist, indem Sie den folgenden Befehl ausführen:

az arcdata dc config show  --k8s-namespace arc --use-k8s

Sehen Sie sich den Abschnitt „security“ an.

 "security": {
      "allowDumps": true,
      "allowNodeMetricsCollection": true,
      "allowPodMetricsCollection": true,
    },

Überprüfen Sie, ob die Eigenschaften allowNodeMetricsCollection und allowPodMetricsCollection auf true festgelegt sind.

Anzeigen der Metriken im Portal

Nachdem die Metriken hochgeladen wurden, können Sie sie im Azure-Portal anzeigen.

Hinweis

Beachten Sie, dass es einige Minuten dauern kann, bis die hochgeladenen Daten verarbeitet wurden und die Metriken im Portal angezeigt werden.

Um Ihre Metriken anzuzeigen, navigieren Sie zum Azure-Portal. Suchen Sie anschließend in der Suchleiste anhand ihres Namens nach Ihrer Datenbankinstanz:

Sie können die CPU-Auslastung auf der Übersichtsseite anzeigen, oder Sie können ausführlichere Metriken anzeigen, indem Sie im linken Navigationsbereich auf „Metriken“ klicken.

Wählen Sie „sql server“ oder „postgres“ als Metriknamespace aus.

Wählen Sie die Metrik aus, die Sie visualisieren möchten (Sie können auch mehrere auswählen).

Ändern Sie die Häufigkeit in die letzten 30 Minuten.

Hinweis

Metriken können nur für die letzten 30 Minuten hochgeladen werden. Azure Monitor lehnt Metriken ab, die älter als 30 Minuten sind.

Automatisieren von Uploads (optional)

Wenn Sie Metriken und Protokolle nach einem Zeitplan hochladen möchten, können Sie ein Skript erstellen und es mit einem Timer alle paar Minuten ausführen. Im Folgenden finden Sie ein Beispiel für die Automatisierung der Uploads mithilfe eines Linux-Shellskripts.

Fügen Sie in Ihrem bevorzugten Text- oder Code-Editor das folgende Skript in eine Datei ein, und speichern Sie diese als ausführbare Skriptdatei, z. B. .sh (Linux/Mac), .cmd, .bat oder .ps1.

az arcdata dc export --type metrics --path metrics.json --force  --k8s-namespace arc
az arcdata dc upload --path metrics.json

Ausführen der Skriptdatei

chmod +x myuploadscript.sh

Führen Sie das Skript alle 20 Minuten aus:

watch -n 1200 ./myuploadscript.sh

Sie können auch einen Auftragsplaner wie cron oder den Windows-Taskplaner bzw. einen Orchestrator wie Ansible, Puppet oder Chef verwenden.

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.

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

Hochladen von Protokollen in Azure Monitor

Hochladen von Nutzungsdaten, Metriken und Protokollen in Azure Monitor

Hochladen von Abrechnungsdaten in Azure und Anzeigen im Azure-Portal

Anzeigen der Azure Arc-Datencontrollerressource im Azure-Portal