Überwachen und verwalten Sie Ihre Bereitstellung

XenServer bietet eine detaillierte Überwachung der Leistungsmetriken. Zu diesen Metriken gehören CPU-, Arbeitsspeicher-, Datenträger-, Netzwerk-, C-State/P-State-Informationen und Speicher. Gegebenenfalls sind diese Metriken pro Host und pro VM verfügbar. Diese Metriken sind direkt verfügbar oder können in XenCenter oder anderen Anwendungen von Drittanbietern abgerufen und grafisch angezeigt werden.

XenServer bietet auch System- und Leistungswarnungen. Warnungen sind Benachrichtigungen, die als Reaktion auf ausgewählte Systemereignisse auftreten. Diese Benachrichtigungen treten auch auf, wenn einer der folgenden Werte einen bestimmten Schwellenwert auf einem verwalteten Host, einer VM oder einem Speicherrepository überschreitet: CPU-Auslastung, Netzwerkauslastung, Speicherauslastung, Steuerung der Domänenspeicherauslastung, Speicherdurchsatz oder VM-Datenträgerauslastung. Sie können die Warnungen mit der Xe-Befehlszeilenschnittstelle oder mit XenCenter konfigurieren. Informationen zum Erstellen von Benachrichtigungen basierend auf einer der verfügbaren Host- oder VM-Leistungsmetriken finden Sie unter Leistungswarnungen.

Überwachen Sie die XenServer-Leistung

Kunden können die Leistung ihrer XenServer-Hosts und virtuellen Maschinen (VMs) anhand der über Round-Robin-Datenbanken (RRDs) bereitgestellten Metriken überwachen. Diese Metriken können über HTTP oder über das RRD2CSV-Tool abgefragt werden. Darüber hinaus verwendet XenCenter diese Daten, um Diagramme zur Systemleistung zu erstellen. Weitere Informationen finden Sie unter Analysieren und Visualisieren von Metriken.

In den folgenden Tabellen sind alle verfügbaren Host- und VM-Metriken aufgeführt.

Hinweise:

• Die Latenz über einen Zeitraum ist definiert als die durchschnittliche Latenz der Vorgänge während dieses Zeitraums.
• Die Verfügbarkeit und der Nutzen bestimmter Metriken sind SR- und CPU-abhängig.

Verfügbare Host-Messwerte

Verfügbare VM-Messwerte

Hinweis:

Der Wert von <XenCenter-pif-name> kann einer der folgenden Werte sein:

• NIC <pif> - if <pif> contains pif_eth#, where ## is 0–9
• <pif> - if <pif> contains pif_eth#.## or pif_xenbr## or pif_bond##
• <Internal> Network <pif> - if <pif> contains pif_xapi##, (note that <Internal> appears as is)
• TAP <tap> - if <pif> contains pif_tap##
• xapi Loopback - if <pif> contains pif_lo

Analysieren und Visualisieren von Metriken

Die Registerkarte Leistung in XenCenter bietet eine Echtzeitüberwachung von Leistungsstatistiken über Ressourcenpools hinweg sowie grafische Trends der Leistung virtueller und physischer Maschinen. Diagramme, die CPU, Speicher, Netzwerk und Datenträger-E/A zeigen, sind standardmäßig auf der Registerkarte Leistung enthalten. Sie können weitere Metriken hinzufügen, das Erscheinungsbild der vorhandenen Diagramme ändern oder zusätzliche erstellen. Weitere Informationen finden Sie im folgenden Abschnitt unter Konfigurieren von Metriken.

• Sie können Leistungsdaten von bis zu 12 Monaten anzeigen und vergrößern, um die Leistungsspitzen genauer zu betrachten.

• XenCenter kann Leistungswarnungen generieren, wenn die CPU-, Speicher-, Netzwerk-I/O-, Speicher-I/O- oder Datenträger-I/O-Auslastung einen bestimmten Schwellenwert auf einem Host, einer VM oder einer SR überschreitet. Weitere Informationen finden Sie im folgenden Abschnitt unter Alerts.

Hinweis:

Installieren Sie die XenServer VM Tools, um die vollständigen VM-Leistungsdaten zu sehen.

Konfigurieren von Leistungsdiagrammen

So fügen Sie eine Grafik hinzu:

1. Klicken Sie auf der Registerkarte Leistung auf Aktionen und dann auf Neues Diagramm. Das Dialogfeld “ Neues Diagramm “ wird angezeigt.

2. Geben Sie im Feld Name einen Namen für das Diagramm ein.

3. Wählen Sie aus der Liste der Datenquellen die Kontrollkästchen für die Datenquellen aus, die Sie in das Diagramm aufnehmen möchten.

4. Klicken Sie auf Speichern.

So bearbeiten Sie ein vorhandenes Diagramm:

1. Navigieren Sie zur Registerkarte Leistung und wählen Sie das Diagramm aus, das Sie ändern möchten.

2. Klicken Sie mit der rechten Maustaste auf das Diagramm und wählen Sie Aktionen oder klicken Sie auf die Schaltfläche Aktionen. Wählen Sie dann Diagramm bearbeiten aus.

3. Nehmen Sie im Fenster “Diagrammdetails” die erforderlichen Änderungen vor, und klicken Sie auf OK.

Konfigurieren des Diagrammtyps

Daten in den Leistungsdiagrammen können als Linien oder als Bereiche angezeigt werden. So ändern Sie den Diagrammtyp:

1. Klicken Sie im Menü Extras auf Optionen, und wählen Sie Diagrammeaus.

2. Um Leistungsdaten als Liniendiagramm anzuzeigen, klicken Sie auf die Option Liniendiagramm .

3. Um Leistungsdaten als Flächendiagramm anzuzeigen, klicken Sie auf die Option Flächendiagramm .

4. Klicken Sie auf OK, um die Änderungen zu speichern.

Umfassende Details zum Konfigurieren und Anzeigen von XenCenter-Leistungsdiagrammen finden Sie in der XenCenter-Dokumentation im Abschnitt Überwachung der Systemleistung.

Metriken konfigurieren

Hinweis:

C-States und P-States sind Energieverwaltungsfunktionen einiger Prozessoren. Der Bereich der verfügbaren Zustände hängt von den physikalischen Fähigkeiten des Hosts sowie der Energieverwaltungskonfiguration ab.

Sowohl Host- als auch VM-Befehle geben Folgendes zurück:

• Eine vollständige Beschreibung der Datenquelle

• Die auf die Metrik angewendeten Einheiten

• Der Bereich der möglichen Werte, die verwendet werden können

Beispiel:

    name_label: cpu0-C1
    name_description: Proportion of time CPU 0 spent in C-state 1
    enabled: true
    standard: true
    min: 0.000
    max: 1.000
    units: Percent
<!--NeedCopy-->

Eine bestimmte Metrik aktivieren

Die meisten Metriken sind standardmäßig aktiviert und erfasst. Um die Metriken zu aktivieren, die dies nicht sind, geben Sie Folgendes ein:

xe host-data-source-record data-source=metric name host=hostname
<!--NeedCopy-->

Deaktiviert eine bestimmte Metrik

Möglicherweise möchten Sie bestimmte Metriken nicht regelmäßig sammeln. Um eine zuvor aktivierte Metrik zu deaktivieren, geben Sie Folgendes ein:

xe host-data-source-forget data-source=metric name host=hostname
<!--NeedCopy-->

Zeigt eine Liste der aktuell aktivierten Host-Metriken

Um die aktuell erfassten Host-Metriken aufzulisten, geben Sie Folgendes ein:

xe host-data-source-list host=hostname
<!--NeedCopy-->

Zeigt eine Liste der aktuell aktivierten VM-Metriken

Um die aktuell erfassten VM-Metriken zu hosten, geben Sie Folgendes ein:

xe vm-data-source-list vm=vm_name
<!--NeedCopy-->

Verwenden Sie RRDs

XenServer verwendet RRDs zum Speichern von Leistungsmetriken. Diese RRDs bestehen aus mehreren Round Robin Archives (RRAs) in einer Datenbank fester Größe.

Jedes Archiv in der Datenbank tastet seine bestimmte Metrik mit einer bestimmten Granularität ab:

• Alle 5 Sekunden für 10 Minuten
• Jede Minute der letzten zwei Stunden
• Jede Stunde der letzten Woche
• Jeden Tag des letzten Jahres

Die Stichprobe, die alle fünf Sekunden stattfindet, zeichnet tatsächliche Datenpunkte auf, die folgenden RRAs verwenden jedoch stattdessen Konsolidierungsfunktionen. Die von XenServer unterstützten Konsolidierungsfunktionen sind:

• AVERAGE
• MIN.
• MAX.

RRDs existieren für einzelne VMs (einschließlich dom0) und den XenServer-Host. VM-RRDs werden auf dem Host gespeichert, auf dem sie ausgeführt werden, oder auf dem Poolkoordinator, wenn sie nicht ausgeführt werden. Daher muss der Standort einer VM bekannt sein, um die zugehörigen Leistungsdaten abzurufen.

Ausführliche Informationen zur Verwendung von XenServer RRDs finden Sie im XenServer Software DevelopmentKit Guide.

Analysieren Sie RRDs mit HTTP

Sie können RRDs über HTTP von dem angegebenen XenServer-Host herunterladen, indem Sie den HTTP-Handler verwenden, der unter oder registriert ist. /host_rrd/vm_rrd Beide Adressen erfordern eine Authentifizierung entweder durch HTTP-Authentifizierung oder durch Angabe einer gültigen Verwaltungs-API-Sitzungsreferenz als Abfrageargument. Beispiel:

Laden Sie eine Host-RRD herunter.

wget http://server/host_rrd?session_id=OpaqueRef:SESSION HANDLE>
<!--NeedCopy-->

Laden Sie eine VM-RRD herunter.

wget http://server/vm_rrd?session_id=OpaqueRef:SESSION HANDLE>&uuid=VM UUID>
<!--NeedCopy-->

Beide Aufrufe laden XML in einem Format herunter, das zur Analyse in das rrdtool importiert oder direkt analysiert werden kann.

Analysieren Sie RRDs mit rrd2csv

Neben der Anzeige von Leistungsmetriken in XenCenter protokolliert das rrd2csv-Tool RRDs im Comma Separated Value (CSV) -Format. Man- und Hilfeseiten werden bereitgestellt. Führen Sie den folgenden Befehl aus, um die Benutzer- oder Hilfeseiten des rrd2csv-Werkzeugs anzuzeigen:

man rrd2csv
<!--NeedCopy-->

Oder

rrd2csv --help
<!--NeedCopy-->

Hinweis:

Wenn mehrere Optionen verwendet werden, geben Sie diese einzeln an. Beispiel: Um sowohl die UUID als auch die Namensbezeichnung zurückzugeben, die mit einer VM oder einem Host verknüpft sind, rufen Sie rrd2csv auf, wie unten gezeigt:

rrd2csv -u -n

Die zurückgegebene UUID ist eindeutig und als Primärschlüssel geeignet, allerdings muss das Namenslabel einer Entität nicht unbedingt eindeutig sein.

Die Manpage (rrd2csv --help) ist der endgültige Hilfetext des Tools.

Warnungen

Sie können XenServer so konfigurieren, dass Warnungen auf der Grundlage der verfügbaren Host- oder VM-Metriken generiert werden. Darüber hinaus bietet XenServer vorkonfigurierte Warnungen, die ausgelöst werden, wenn Hosts bestimmten Bedingungen und Zuständen ausgesetzt sind. Sie können diese Warnungen mit XenCenter oder der xe CLI anzeigen.

Warnungen mit XenCenter anzeigen

Sie können verschiedene Arten von Warnungen in XenCenter anzeigen, indem Sie auf Benachrichtigungen und dann auf Warnungenklicken. In der Ansicht “Warnungen” werden verschiedene Arten von Warnungen angezeigt, darunter Leistungswarnungen, Systemwarnungen und Softwareupdate-Warnungen.

Performance-Warnungen

Leistungswarnungen können generiert werden, wenn einer der folgenden Werte einen bestimmten Schwellenwert auf einem verwalteten Host, einer VM oder einem Speicherrepository (SR) überschreitet: CPU-Auslastung, Netzwerkauslastung, Speicherauslastung, Steuerung der Domänenspeicherauslastung, Speicherdurchsatz oder VM-Datenträgerauslastung.

Standardmäßig ist das Wiederholungsintervall für Warnungen auf 60 Minuten festgelegt und kann bei Bedarf geändert werden. Warnungen werden auf der Seite “Warnungen” im Bereich “Benachrichtigungen” in XenCenter angezeigt. Sie können XenCenter auch so konfigurieren, dass eine E-Mail für angegebene Leistungswarnungen zusammen mit anderen schwerwiegenden Systemwarnungen gesendet wird.

Alle benutzerdefinierten Warnungen, die mit der xe CLI konfiguriert wurden, werden auch auf der Seite “Warnungen” in XenCenter angezeigt.

Jeder Alert hat eine entsprechende Priorität/Schweregrad. Sie können diese Stufen ändern und optional eine E-Mail erhalten, wenn die Warnung ausgelöst wird. Die standardmäßige Priorität/der Schweregrad der Warnung ist auf festgelegt 3.

Konfigurieren von Leistungswarnungen

1. Wählen Sie im Bereich Ressourcen den entsprechenden Host, die VM oder das SR aus, und klicken Sie dann auf die Registerkarte Allgemein und dann auf Eigenschaften.

2. Wählen Sie die Registerkarte Warnungen aus. Die folgende Tabelle fasst zusammen, welche Warnungen für Hosts, VMs oder SRs verfügbar sind:

   Name der Warnung	Host	VM	SR	Beschreibung
   Warnungen zur CPU-Auslastung generieren	X	X		Legen Sie die CPU-Auslastung und den Zeitschwellenwert fest, die die Warnung auslösen.
   Warnungen zur CPU-Auslastung der Steuerdomäne generieren	X			Legen Sie die CPU-Auslastung und den Zeitschwellenwert der Steuerdomäne fest, die die Warnung auslösen.
   Warnungen zur Speichernutzung generieren	X			Legen Sie den Speicherverbrauch und den Zeitschwellenwert fest, der die Warnung auslöst.
   Warnungen zur Speichernutzung der Steuerdomäne generieren	X			Stellen Sie die Speichernutzung der Steuerdomäne und den Zeitschwellenwert ein, der die Warnung auslöst.
   Warnmeldungen über freien Speicher in der Steuerdomäne gemerierem	X			Legen Sie den freien Speicher der Steuerdomäne und den Zeitschwellenwert fest, der die Warnung auslöst.
   Warnmeldungen zur Datenträgernutzung generieren		X		Festlegen der Datenträgernutzung und des Zeitschwellenwerts die Warnung auslösen.
   Speicherdurchsatzwarnungen generieren			X	Legen Sie den Speicherdurchsatz und den Zeitschwellenwert fest, die die Warnung auslösen. Hinweis: Physical Block Devices (PBD) stellen die Schnittstelle zwischen einem bestimmten XenServer-Host und einem angeschlossenen SR dar. Wenn die gesamte SR-Durchsatzaktivität mit Lese-/Schreibzugriff auf einem PBD den angegebenen Schwellenwert überschreitet, werden Warnungen auf dem mit dem PBD verbundenen Host generiert. Im Gegensatz zu anderen XenServer-Host-Warnungen muss diese Warnung auf der SR konfiguriert werden.
   Warnmeldungen zur Netzwerknutzung generieren	X	X		Legen Sie die Netzwerknutzung und den Zeitschwellenwert fest, der die Warnung auslöst.

   Um das Warnwiederholungsintervall zu ändern, geben Sie die Anzahl der Minuten in das Feld Warnwiederholungsintervall ein. Wenn ein Alarmschwellenwert erreicht und eine Warnung generiert wurde, wird erst nach Ablauf des Alert-Wiederholungsintervalls eine weitere Warnung generiert.

3. Klicken Sie auf OK, um die Änderungen zu speichern.

Umfassende Informationen zum Anzeigen, Filtern und Konfigurieren von Schweregraden von Leistungswarnungen finden Sie unter Konfigurieren von Leistungswarnungen in der XenCenter-Dokumentation.

Systemwarnungen

In der folgenden Tabelle werden die Systemereignisse/-bedingungen angezeigt, die eine Warnung auslösen, die auf der Seite “Warnungen” in XenCenter angezeigt wird.

Warnungen zu Softwareupgrades

• XenCenter alt: XenServer erwartet eine neuere Version, kann aber trotzdem eine Verbindung zur aktuellen Version herstellen
• XenCenter veraltet: XenCenter ist zu alt, um eine Verbindung zu XenServer herzustellen
• XenServer veraltet: XenServer ist eine alte Version, zu der das aktuelle XenCenter keine Verbindung herstellen kann
• Warnung “Lizenz abgelaufen”: Die XenServer-Lizenz ist abgelaufen
• Fehlende IQN-Warnung: XenServer verwendet iSCSI-Speicher, aber der Host-IQN ist leer
• Warnung wegen doppelter IQN: XenServer verwendet iSCSI-Speicher und es gibt doppelte Host-IQNs

Konfigurieren Sie Leistungswarnungen über die xe-CLI

Hinweis:

Auslöser für Alerts werden in einem Mindestintervall von fünf Minuten geprüft. Dieses Intervall vermeidet eine übermäßige Belastung des Systems, um nach diesen Bedingungen zu suchen und Fehlalarme zu melden. Wenn Sie ein Alert-Wiederholungsintervall von weniger als fünf Minuten festlegen, werden die Warnungen weiterhin im Mindestintervall von fünf Minuten generiert.

Das perfmon Tool zur Leistungsüberwachung wird alle fünf Minuten ausgeführt und fordert Updates von XenServer an, die durchschnittlich über eine Minute liegen. Diese Standardwerte können in /etc/sysconfig/perfmon geändert werden.

perfmon liest alle fünf Minuten Updates von Leistungsvariablen, die auf demselben Host ausgeführt werden. Diese Variablen sind in eine Gruppe unterteilt, die sich auf den Host selbst bezieht, und eine Gruppe für jede VM, die auf diesem Host ausgeführt wird. Für jede VM und jeden Host liest perfmon den Parameter other-config:perfmon und verwendet diese Zeichenfolge, um zu bestimmen, welche Variablen überwacht werden sollen und unter welchen Umständen eine Nachricht generiert werden soll.

Im folgenden Beispiel wird ein Beispiel für die Konfiguration einer VM-Warnung “CPU-Auslastung” gezeigt, indem eine XML-Zeichenfolge in den Parameter other-config:perfmon geschrieben wird:

xe vm-param-set uuid=vm_uuid other-config:perfmon=\

'<config>
    <variable>
        <name value="cpu_usage"/>
        <alarm_trigger_level value="0.5"/>
    </variable>
</config>'
<!--NeedCopy-->

Hinweis:

Sie können mehrere variable Knoten verwenden.

Nachdem Sie die neue Konfiguration festgelegt haben, verwenden Sie den folgenden Befehl, um perfmon für jeden Host zu aktualisieren:

xe host-call-plugin host=host_uuid plugin=perfmon fn=refresh
<!--NeedCopy-->

Wenn diese Aktualisierung nicht durchgeführt wird, gibt es eine Verzögerung, bis die neue Konfiguration wirksam wird, da standardmäßig perfmon alle 30 Minuten nach einer neuen Konfiguration sucht. Diese Standardeinstellung kann in /etc/sysconfig/perfmon geändert werden.

Gültige VM-Elemente

• name: Der Name der Variablen (kein Standard). Wenn der Namenswert entweder cpu_usage, network_usage oder disk_usage ist, sind die Parameter alarm_trigger_sense und rrd_regex nicht erforderlich, da Standardwerte für diese Werte verwendet werden.

• alarm_priority: Die Priorität der generierten Alerts (Standard 3).

• alarm_trigger_level: Die Wertebene, die eine Warnung auslöst (kein Standardwert).

• alarm_trigger_sense: Der Wert ist high wenn alarm_trigger_level ein Maximalwert ist, andernfalls low, wenn alarm_trigger_level ein Minimalwert ist (der Standardwert high).

• alarm_trigger_period: Die Anzahl der Sekunden, die Werte (über oder unter dem Alarmschwellenwert) empfangen werden können, bevor eine Warnung gesendet wird (der Standardwert ist 60).

• alarm_auto_inhibit_period: Die Anzahl der Sekunden, in denen diese Warnung deaktiviert wird, nachdem eine Warnung gesendet wurde (der Standardwert ist 3600).

• consolidation_fn: Kombiniert Variablen aus rrd_updates zu einem Wert. Die Standardeinstellung für cpu-usage ist average, für fs_usage ist die Standardeinstellung get_percent_fs_usage und für alle anderen - sum.

• rrd_regex: Entspricht den Namen der Variablen von xe vm-data-sources-list uuid=vm_uuid, um Leistungswerte zu berechnen. Dieser Parameter hat Standardwerte für die benannten Variablen:

  • cpu_usage
  • memory_internal_free
  • network_usage
  • disk_verwendung

Falls angegeben, werden die Werte aller zurückgegebenen Elemente xe vm-data-source-list, deren Namen mit dem angegebenen regulären Ausdruck übereinstimmen, mit der als angegebenen Methode konsolidiert consolidation_fn.

Gültige Host-Elemente

• name: Der Name der Variablen (kein Standard).
• alarm_priority: Die Priorität der generierten Alerts (Standard 3).
• alarm_trigger_level: Die Wertebene, die eine Warnung auslöst (kein Standardwert).
• alarm_trigger_sense: Der Wert ist high, wenn alarm_trigger_level ein Maximalwert ist, andernfalls low, wenn der ein Minimalwert alarm_trigger_level ist. (Standard high)
• alarm_trigger_period: Die Anzahl der Sekunden, die Werte (über oder unter dem Alarmschwellenwert) empfangen werden können, bevor eine Warnung gesendet wird (Standard 60).
• alarm_auto_inhibit_period: Die Anzahl der Sekunden, für die die Warnung nach dem Senden einer Warnung deaktiviert ist. (Standard 3600).
• consolidation_fn: Kombiniert Variablen aus rrd_updates in einem Wert (Standard sum - oder average)
• rrd_regex: Ein regulärer Ausdruck, der den Namen der Variablen entspricht, die vom Befehl xe vm-data-source-list uuid=vm_uuid zurückgegeben werden, zur Berechnung des statistischen Werts. Dieser Parameter hat Standardwerte für die folgenden benannten Variablen:
  • cpu_usage
  • network_usage
  • memory_free_kib
  • sr_io_throughput_total_xxxxxxxx (wo xxxxxxxx die ersten acht Zeichen der SR-UUID sind).

SR-Durchsatz: Warnungen zum Speicherdurchsatz müssen in dem SR und nicht auf dem Host konfiguriert werden. Beispiel:

xe sr-param-set uuid=sr_uuid other-config:perfmon=\
'<config>
    <variable>
        <name value="sr_io_throughput_total_per_host"/>
        <alarm_trigger_level value="0.01"/>
    </variable>
</config>'
<!--NeedCopy-->

Generische Beispielkonfiguration

Das folgende Beispiel zeigt eine generische Konfiguration:

<config>
    <variable>
    <name value="NAME_CHOSEN_BY_USER"/>
    <alarm_trigger_level value="THRESHOLD_LEVEL_FOR_ALERT"/>
    <alarm_trigger_period value="RAISE_ALERT_AFTER_THIS_MANY_SECONDS_OF_BAD_VALUES"/>
    <alarm_priority value="PRIORITY_LEVEL"/>
    <alarm_trigger_sense value="HIGH_OR_LOW"/>
    <alarm_auto_inhibit_period value="MINIMUM_TIME_BETWEEN_ALERT_FROM_THIS_MONITOR"/>
    <consolidation_fn value="FUNCTION_FOR_COMBINING_VALUES"/>
    <rrd_regex value="REGULAR_EXPRESSION_TO_CHOOSE_DATASOURCE_METRIC"/>
    </variable>

    <variable>
    ...
    </variable>

    ...
</config>
<!--NeedCopy-->

Konfigurieren von E-Mail-Benachrichtigungen

Sie können XenServer so konfigurieren, dass E-Mail-Benachrichtigungen gesendet werden, wenn XenServer-Hosts Warnungen generieren. Das Mail-Alarm-Hilfsprogramm in XenServer verwendet SSMTP, um diese E-Mail-Benachrichtigungen zu senden. Sie können grundlegende E-Mail-Benachrichtigungen mithilfe von XenCenter oder der XE-Befehlszeilenschnittstelle (CLI) aktivieren. Für die weitere Konfiguration von E-Mail-Benachrichtigungen können Sie die Konfigurationsdatei mail-alarm.conf ändern.

Verwenden Sie einen SMTP-Server, der keine Authentifizierung erfordert. E-Mails, die über SMTP-Server gesendet werden und für die eine Authentifizierung erforderlich ist, können nicht zugestellt werden.

Aktivieren von E-Mail-Warnungen über XenCenter

1. Klicken Sie im Bereich Resources mit der rechten Maustaste auf einen Pool und wählen Sie Properties aus.

2. Wählen Sie Email Options im Fenster Properties.

3. Markieren Sie das Kontrollkästchen Send email alert notifications. Geben Sie Ihre bevorzugte Zieladresse für die Benachrichtigungs-E-Mails und die SMTP-Serverdetails ein.

4. Wählen Sie Ihre bevorzugte Sprache aus der Liste Mail language aus. Die Standardsprache für E-Mails mit Leistungswarnungen ist Englisch.

Aktivieren Sie E-Mail-Benachrichtigungen mit der xe-CLI

Um E-Mail-Benachrichtigungen zu konfigurieren, geben Sie Ihre bevorzugte Zieladresse für die Benachrichtigungs-E-Mails und den SMTP-Server an:

xe pool-param-set uuid=pool_uuid other-config:mail-destination=joe.bloggs@example.com
xe pool-param-set uuid=pool_uuid other-config:ssmtp-mailhub=smtp.example.com:<port>
<!--NeedCopy-->

XenServer konfiguriert die Absenderadresse automatisch als. noreply@<hostname> Sie können die Absenderadresse jedoch explizit festlegen:

xe pool-param-set uuid=pool_uuid other-config:mail-sender=serveralerts@example.com
<!--NeedCopy-->

Wenn Sie E-Mail-Benachrichtigungen aktivieren, erhalten Sie eine E-Mail-Benachrichtigung, wenn eine Warnung mit einer Priorität von 3 oder höher generiert wird. Daher lautet die standardmäßige Mindestprioritätsstufe 3. Sie können diese Standardeinstellung mit dem folgenden Befehl ändern:

xe pool-param-set uuid=pool_uuid other-config:mail-min-priority=level
<!--NeedCopy-->

Hinweis:

Manche SMTP-Server leiten nur E-Mails mit Adressen weiter, die FQDNs verwenden. Wenn Sie feststellen, dass E-Mails nicht weitergeleitet werden, kann dies aus diesem Grund geschehen. In diesem Fall können Sie den Serverhostnamen auf den FQDN festlegen, sodass diese Adresse verwendet wird, wenn Sie eine Verbindung zu Ihrem Mailserver herstellen.

Um die Sprache für die E-Mails mit Leistungswarnungen zu konfigurieren, gehen Sie wie folgt vor:

xe pool-param-set uuid=pool_uuid other-config:mail-language=ja-JP
<!--NeedCopy-->

Die Standardsprache für E-Mails mit Leistungswarnungen ist Englisch.

Weitere Konfiguration

Um das Mail-Alarm-Hilfsprogramm in XenServer weiter zu konfigurieren, erstellen Sie eine /etc/mail-alarm.conf Datei, die Folgendes enthält:

root=postmaster
authUser=<username>
authPass=<password>
mailhub=@MAILHUB@
<!--NeedCopy-->

/etc/mail-alarm.conf ist eine vom Benutzer bereitgestellte Vorlage für die SSMTP-Konfigurationsdatei ssmtp.conf und wird für alle von XenServer-Hosts generierten Warnungen verwendet. Sie besteht aus Schlüsseln, wobei key=@KEY@ und @KEY@ durch den entsprechenden Wert von ssmtp-key in pool.other_config ersetzt wird. Diese Werte werden dann an ssmtp übergeben, sodass Sie Aspekte der sSMTP-Konfiguration mithilfe von Werten von steuern können pool.other_config. Beachten Sie, wie @KEY@ (Großbuchstaben) sich zu ssmtp-key (Kleinbuchstaben, mit Präfix ssmtp-) verhält.

Wenn Sie beispielsweise den SMTP-Server wie folgt einrichten:

xe pool-param-set uuid=pool_uuid other-config:ssmtp-mailhub=smtp.example.com
<!--NeedCopy-->

und Sie dann Folgendes zur Datei /etc/mail-alarm.conf hinzufügen:

mailhub=@MAILHUB@
<!--NeedCopy-->

wird mailhub=@MAILHUB@ zu mailhub=smtp.example.com.

Jeder SMTP-Server kann sich in seiner Einrichtung geringfügig unterscheiden und erfordert möglicherweise eine zusätzliche Konfiguration. Um sSMTP weiter zu konfigurieren, ändern Sie die Konfigurationsdatei ssmtp.conf. Indem Sie die entsprechenden Schlüssel in der Datei mail-alarm.conf speichern, können Sie die Werte in pool.other_config verwenden, um sSMTP zu konfigurieren. Der folgende Auszug aus der ssmtp.conf-Manpage zeigt die korrekte Syntax und die verfügbaren Optionen:

NAME
    ssmtp.conf – ssmtp configuration file

DESCRIPTION
    ssmtp reads configuration data from /etc/ssmtp/ssmtp.conf The file con-
    tains keyword-argument pairs, one per line. Lines starting with '#'
    and empty lines are interpreted as comments.

The possible keywords and their meanings are as follows (both are case-
insensitive):

    Root
    The user that gets all mail for userids less than 1000. If blank,
    address rewriting is disabled.

    Mailhub
        The host to send mail to, in the form host | IP_addr port :
        <port>. The default port is 25.

    RewriteDomain
    The domain from which mail seems to come. For user authentication.

    Hostname
        The full qualified name of the host. If not specified, the host
        is queried for its hostname.

    FromLineOverride
        Specifies whether the From header of an email, if any, may over-
        ride the default domain. The default is "no".

    UseTLS
    Specifies whether ssmtp uses TLS to talk to the SMTP server.
    The default is "no".

    UseSTARTTLS
        Specifies whether ssmtp does a EHLO/STARTTLS before starting TLS
        negotiation. See RFC 2487.

    TLSCert
        The file name of an RSA certificate to use for TLS, if required.

    AuthUser
        The user name to use for SMTP AUTH. The default is blank, in
        which case SMTP AUTH is not used.

    AuthPass
        The password to use for SMTP AUTH.

    AuthMethod
        The authorization method to use. If unset, plain text is used.
        May also be set to "cram-md5".
<!--NeedCopy-->

Benutzerdefinierte Felder und Tags

XenCenter unterstützt das Erstellen von ags und benutzerdefinierten Feldern, die eine Organisation und schnelle Suche von VMs, Speicher usw. ermöglichen. Weitere Informationen finden Sie unter Überwachen der Systemleistung.

Benutzerdefinierte Suchen

XenCenter unterstützt die Erstellung von benutzerdefinierten Suchvorgängen. Suchen können exportiert und importiert werden, und die Ergebnisse einer Suche können im Navigationsbereich angezeigt werden. Weitere Informationen finden Sie unter Überwachen der Systemleistung.

Bestimmen des Durchsatzes von physikalischen Busadaptern

Für FC-, SAS- und iSCSI-HBAs können Sie den Netzwerkdurchsatz Ihrer PBDs mithilfe des folgenden Verfahrens ermitteln.

1. Listen Sie die PBDs auf einem Host auf.
2. Bestimmen Sie, welche LUNs über welche PBDs geroutet werden.
3. Listen Sie für jedes PBD und SR die VBDs auf, die auf VDIs in dem SR verweisen.
4. Berechnen Sie für alle aktiven VBDs, die an VMs auf dem Host angeschlossen sind, den kombinierten Durchsatz.

Überprüfen Sie für iSCSI- und NFS-Speicher Ihre Netzwerkstatistiken, um festzustellen, ob am Array ein Durchsatzengpass vorliegt oder ob die PBD überlastet ist.

Überwachen Sie Host- und dom0-Ressourcen mit NRPE

Hinweis:

Die NRPE-Funktion ist für XenServer Premium- oder Trial Edition-Kunden verfügbar. Weitere Informationen zur XenServer-Lizenzierung finden Sie unter Lizenzierung. Besuchen Sie die XenServer-Website, um ein Upgrade durchzuführen oder eine XenServer-Lizenz zu kaufen.

Benutzer mit der Rolle Pool Admin können jedes Überwachungstool eines Drittanbieters verwenden, das den Nagios Remote Plugin Executor (NRPE) unterstützt, um die von Ihrem XenServer-Host und dom0 — der Steuerdomäne Ihres Hosts — verbrauchten Ressourcen zu überwachen.

Sie können die folgenden Check-Plugins verwenden, um Host- und dom0-Ressourcen zu überwachen:

NRPE ist ein on-premises Dienst, der in dom0 ausgeführt wird und am TCP-Port (Standard) 5666 auf Anfragen zur Prüfausführung von einem Überwachungstool wartet. Nachdem eine Anfrage eingetroffen ist, analysiert NRPE sie, findet den entsprechenden Prüfbefehl einschließlich der Parameterdetails aus der Konfigurationsdatei und führt ihn dann aus. Das Ergebnis der Prüfung wird an das Monitoring-Tool gesendet, das die Ergebnisse vergangener Prüfungen speichert und ein Diagramm mit den historischen Leistungsdaten bereitstellt.

Voraussetzungen

Um NRPE zur Überwachung von Host- und dom0-Ressourcen verwenden zu können, muss das von Ihnen verwendete Überwachungstool die folgenden Voraussetzungen erfüllen:

• Das Monitoring-Tool muss mit der NRPE-Version 4.1.0 kompatibel sein.
• Um die Kommunikation zwischen NRPE und dem Überwachungstool zu ermöglichen, muss das Überwachungstool TLS 1.2 mit den Chiffren ECDHE-RSA-AES256-GCM-SHA384 und ECDHE-RSA-AES128-GCM-SHA256 unterstützen, und die EC-Kurve muss secp384r1 sein.

Einschränkungen

• Sie können NRPE-Einstellungen für einen gesamten Pool oder für einen eigenständigen Host konfigurieren, der nicht Teil eines Pools ist. Derzeit können Sie keine NRPE-Einstellungen für einen einzelnen Host in einem Pool konfigurieren.

• Wenn Sie einem Pool einen Host hinzufügen, auf dem NRPE bereits aktiviert und konfiguriert ist, wendet XenCenter die NRPE-Einstellungen des Pools nicht automatisch auf den neuen Host an. Sie müssen die NRPE-Einstellungen im Pool neu konfigurieren, nachdem Sie den neuen Host hinzugefügt haben, oder den neuen Host mit denselben NRPE-Einstellungen konfigurieren, bevor Sie ihn zum Pool hinzufügen.

  Hinweis:

  Wenn Sie die NRPE-Einstellungen in einem Pool nach dem Hinzufügen eines neuen Hosts neu konfigurieren, stellen Sie sicher, dass der Host betriebsbereit ist.

• Wenn ein Host aus einem Pool entfernt wird, auf dem NRPE aktiviert und konfiguriert ist, ändert XenCenter die NPRE-Einstellungen auf dem Host oder Pool nicht.

Konfigurieren Sie NRPE mithilfe der Xe-CLI

Sie können NRPE mithilfe der Xe-CLI oder XenCenter konfigurieren. Weitere Informationen zur Konfiguration von NRPE mithilfe von XenCenter finden Sie unter Überwachen von Host- und dom0-Ressourcenmit NRPE.

Nachdem Sie die Konfiguration von NRPE geändert haben, starten Sie den NRPE-Dienst neu, indem Sie:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=restart
<!--NeedCopy-->

NRPE aktivieren

NRPE ist in XenServer standardmäßig deaktiviert. Führen Sie die folgenden Befehle in der XE-CLI aus, um NRPE in der Steuerdomäne eines Hosts (dom0) zu aktivieren:

1. Ermitteln Sie die Host-UUID des Hosts, den Sie überwachen möchten:

   xe host-list

2. Aktivieren Sie NRPE auf dem Host:

   xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=enable

   Wenn der Vorgang erfolgreich ausgeführt wird, wird dieser Befehl ausgegeben Success. Wenn XenServer neu gestartet wird, wird NRPE automatisch gestartet.

Um NRPE zu beenden, zu starten, neu zu starten oder zu deaktivieren:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=<operation>
<!--NeedCopy-->

wo Operationstop, startrestart, oder ist disable.

Server überwachen

Dies ist eine kommagetrennte Liste von IP-Adressen oder Hostnamen, die mit dem NRPE-Daemon kommunizieren dürfen. Netzwerkadressen mit einer Bitmaske (zum Beispiel 192.168.1.0/24) werden ebenfalls unterstützt.

Sehen Sie sich die aktuelle Liste der Überwachungsserver an:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=get-config args:allowed_hosts
<!--NeedCopy-->

Erlauben Sie dem Monitoring-Tool, Prüfungen auszuführen:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=set-config args:allowed_hosts=<IP address or hostname>
<!--NeedCopy-->

Alle NRPE-Einstellungen abfragen:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=get-config
<!--NeedCopy-->

Konfigurieren Sie mehrere NRPE-Einstellungen:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=set-config args:allowed_hosts=<IP address or hostname> args:ssl_logging=<SSL log level> args:debug=<debug log level>
<!--NeedCopy-->

Protokolle

Protokollierung debuggen

Die Debug-Protokollierung ist standardmäßig deaktiviert.

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob die Debug-Protokollierung aktiviert ist:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=get-config args:debug
<!--NeedCopy-->

Wenn debug: 0 zurückgegeben wird, ist die Debug-Protokollierung deaktiviert.

So aktivieren Sie die Debug-Protokollierung:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=set-config args:debug=1
<!--NeedCopy-->

SSL-Protokollierung

Standardmäßig ist die SSL-Protokollierung deaktiviert:

ssl_logging=0x00
<!--NeedCopy-->

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob die SSL-Protokollierung aktiviert ist:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=get-config args:ssl_logging
<!--NeedCopy-->

So aktivieren Sie die SSL-Protokollierung:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=set-config args:ssl_logging=0x2f
<!--NeedCopy-->

Warnung und kritische Schwellenwerte

Für einige dieser Check-Plugins können Sie Warn- und kritische Schwellenwerte festlegen, sodass eine Warnung generiert wird, wenn der von einem Check-Plugin zurückgegebene Wert die Schwellenwerte überschreitet. Der Warnschwellenwert weist auf ein potenzielles Problem hin, und der kritische Schwellenwert weist auf ein schwerwiegenderes Problem hin, das sofortige Aufmerksamkeit erfordert. Obwohl Standardwerte für die Warnung und die kritischen Schwellenwerte festgelegt sind, können Sie die Schwellenwerte anpassen.

Um die Standardwarnungs- und kritischen Schwellenwerte für alle Prüfungen abzufragen, führen Sie den folgenden xe-CLI-Befehl aus, der eine Liste aller Prüfungen und der zugehörigen Warn- und kritischen Schwellenwerte zurückgibt:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=get-threshold
<!--NeedCopy-->

Sie können auch die Schwellenwerte für eine bestimmte Prüfung abfragen. Um beispielsweise die Warn- und kritischen Schwellenwerte für das Check-Plug-In check_memory abzurufen, führen Sie den folgenden xe-CLI-Befehl aus:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=get-threshold args:check_memory
<!--NeedCopy-->

Sie können auch den Standardwert eines Schwellenwerts ändern. Um beispielsweise die Standardschwellenwerte für das Check-Plug-In check_memory zu ändern, führen Sie den folgenden xe-CLI-Befehl aus:

xe host-call-plugin host-uuid=<host uuid> plugin=nrpe fn=set-threshold args:check_memory args:w=75 args:c=85
<!--NeedCopy-->

Überwachen Sie Host- und dom0-Ressourcen mit SNMP

Hinweis:

Die SNMP-Funktion ist für XenServer Premium- oder Trial Edition-Kunden verfügbar. Weitere Informationen zur XenServer-Lizenzierung finden Sie unter Lizenzierung. Besuchen Sie die XenServer-Website, um ein Upgrade durchzuführen oder eine XenServer-Lizenz zu kaufen.

Mit der Pool-Admin-Rolle können Sie SNMP verwenden, um Ressourcen, die von Ihrem XenServer-Host und dom0, der Steuerdomäne Ihres Hosts, verbraucht werden, remote zu überwachen. Ein SNMP-Manager, auch bekannt als Netzwerkmanagementsystem (NMS), sendet Abfrageanforderungen an einen SNMP-Agenten, der auf einem XenServer-Host ausgeführt wird. Der SNMP-Agent beantwortet diese Abfrageanforderungen, indem er Daten, die auf verschiedenen Metriken gesammelt wurden, zurück an das NMS sendet. Die Daten, die gesammelt werden können, werden durch Objektkennungen (OIDs) in einer Textdatei definiert, die als Management Information Base (MIB) bezeichnet wird. Eine OID steht für eine bestimmte messbare Information über ein Netzwerkgerät, z. B. die CPU- oder Speicherauslastung.

Sie können auch Traps konfigurieren. Dabei handelt es sich um vom Agenten initiierte Meldungen, die den NMS darauf hinweisen, dass ein bestimmtes Ereignis in XenServer eingetreten ist. Sowohl Abfrageanforderungen als auch Traps können verwendet werden, um den Status Ihrer XenServer-Pools zu überwachen. Diese sind als Metrik- und Trap-Objekte definiert und werden durch OIDs in der MIB-Datei XENSERVER-MIB.txt identifiziert, die von der XenServer-Downloadseite heruntergeladen werden kann. Die folgenden Tabellen enthalten Informationen zu diesen Metrik- und Trap-Objekten.

Metrische Objekte

Sie können mithilfe der in der folgenden Tabelle aufgeführten Metriken bestimmte Informationen über Ihre XenServer-Hosts anfordern. Diese Metriken werden vom SNMP-Manager verwendet, wenn er Abfrageanforderungen an einen SNMP-Agenten sendet, sodass Sie diese Daten in Ihrem NMS anzeigen können.

Sie können die von diesen Metrikobjekten zurückgegebenen Daten in Ihrem NMS oder in der xe-CLI anzeigen. Um die Metrikobjekte über die XE-CLI abzufragen, führen Sie host-data-source-query oder vm-data-source-query aus und geben Sie die RRDD-Datenquelle als Wert für den Parameter data-source an. Beispiel:

xe host-data-source-query data-source=cpu_avg host=<host UUID>
<!--NeedCopy-->

Hinweis:

Standardmäßig sendet das NMS OID-Abfrageanforderungen über Port 161 an SNMP-Agents.

Hinweise:

1. Der Name einer pCPU hat das Format cpu gefolgt von einer Zahl. Führen Sie den folgenden Befehl aus, um die Anzahl der PCPUs über die xe-CLI abzufragen:

   xe host-data-source-list host=<host UUID> | grep -E 'cpu[0-9]+$'

   This returns a list of the CPU metrics that match the regular expression cpu[0-9]+.

Traps

Traps sind Warnungen, die vom SNMP-Agenten gesendet werden, um den SNMP-Manager zu benachrichtigen, wenn bestimmte Ereignisse eintreten. So können Sie Ihre XenServer-Hosts überwachen und Probleme frühzeitig erkennen. Sie können Ihre SNMP-Einstellungen so konfigurieren, dass ein Trap generiert wird, wenn ein Limit erreicht wird (z. B. wenn die Host-CPU-Auslastung zu hoch ist). Wenn ein Trap generiert wird, wird er an Ihr NMS gesendet und die folgenden Felder werden als Teil des Trapobjekts zurückgegeben.

Hinweis:

Standardmäßig sendet der SNMP-Agent auf dem Poolkoordinatorhost Traps über den UPD-Port 162 an den NMS.

Voraussetzungen

• Auf allen Hosts in einem Pool muss dieselbe XenServer-Version ausgeführt werden, und diese Version muss das SNMP-Plugin enthalten.

  Hinweis:

  Wenn Sie die Registerkarte SNMP in XenCenter nicht sehen können, liegt dies möglicherweise daran, dass der Host oder ein Mitglied des Pools keine Version von XenServer ausführt, die SNMP unterstützt. Aktualisieren Sie den Host oder Pool auf die neueste Version von XenServer.

• Das von Ihnen verwendete NMS muss SNMPv2c oder SNMPv3 unterstützen.

• Ihr NMS und XenServer müssen mit dem Netzwerk verbunden sein.

Einschränkungen

• Sie können SNMP-Einstellungen für einen gesamten Pool oder für einen eigenständigen Host konfigurieren, der nicht Teil eines Pools ist. Derzeit können Sie keine SNMP-Einstellungen für einen einzelnen Host in einem Pool konfigurieren.

• Wenn Sie einen Host zu einem Pool hinzufügen, auf dem SNMP bereits aktiviert und konfiguriert ist, wendet XenCenter die SNMP-Einstellungen des Pools nicht automatisch auf den neuen Host an. Sie müssen die SNMP-Einstellungen im Pool neu konfigurieren, nachdem Sie den neuen Host hinzugefügt haben, oder den neuen Host mit denselben SNMP-Einstellungen konfigurieren, bevor Sie ihn dem Pool hinzufügen.

  Hinweis:

  Wenn Sie die SNMP-Einstellungen in einem Pool nach dem Hinzufügen eines neuen Hosts neu konfigurieren, stellen Sie sicher, dass der Host betriebsbereit ist und sich nicht im Wartungsmodus befindet.

• Bevor Sie ein Rolling-Pool-Upgrade von Citrix Hypervisor 8.2 CU1 auf XenServer 8 durchführen oder Updates auf Ihre XenServer-Hosts und -Pools anwenden, sichern Sie die folgenden Konfigurationsdateien, falls Sie sie zuvor manuell geändert haben und benötigen:

  • /etc/snmp/snmpd.xs.conf
  • /etc/sysconfig/snmp
  • /var/lib/net-snmp/snmpd.conf
• Wenn der SNMP-Agent offline ist, können keine Traps generiert werden. Zum Beispiel, wenn der SNMP-Agent neu gestartet oder der Poolkoordinator neu gestartet oder neu benannt wird.

SNMP mit der xe-CLI konfigurieren

Sie können SNMP mit der xe-CLI oder XenCenter konfigurieren. Weitere Informationen zur Konfiguration von SNMP mit XenCenter finden Sie unter Host- und dom0-Ressourcen mit SNMP überwachen.

result Objekte

Bei der Konfiguration von SNMP werden alle Antworten im JSON-Format zurückgegeben. Wenn ein Befehl erfolgreich ausgeführt wird, gibt er das Schlüssel-Wert-Paar "code": 0 zurück. Einige Befehle (wie der Befehl get-config) geben ein verschachteltes JSON-Objekt mit dem Namen resultzurück. Das JSON-Objekt result ist auch für den Befehl set-config erforderlich, der zum Aktualisieren der SNMP-Konfiguration verwendet wird.

Das JSON-Objekt result besteht aus den folgenden Objekten common, agent und nmss.

common

agent

nmss

Hinweise:

1. COMMON_STRING_TYPE bezieht sich auf eine Zeichenfolge, die die folgenden Anforderungen erfüllt:
   • Jede Kombination aus Buchstaben, Zahlen, Bindestrich (-), Punkt (.), Pfund (#), At-Zeichen (@), Gleichheitszeichen (=), Doppelpunkt (:) oder Unterstrich (_).
   • Länge zwischen 6 und einschließlich 32.
2. Kennwörter werden in keiner Konfigurationsdatei in XenServer im Klartext gespeichert. Sie werden in einen lokalisierten Schlüssel umgewandelt und gespeichert. Der Befehl get-config zeigt das Kennwort als versteckte Konstante an, die aus Sternchen (*) besteht.

Konfigurieren Sie den SNMP-Dienst

Rufen Sie den Status des SNMP-Dienstes ab:

xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=status
<!--NeedCopy-->

Starten, beenden oder starten Sie den SNMP-Dienst neu:

xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=<operation>
<!--NeedCopy-->

Dabei gilt: operaiton ist start, stop oder restart.

Rufen Sie die SNMP-Konfigurationsdetails ab:

xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=get-config
<!--NeedCopy-->

Bei Erfolg gibt dieser Befehl das Schlüsselwertpaar "code": 0 und das JSON-Objekt result zurück, das die Konfigurationsdetails des SNMP-Dienstes enthält. Beispiel:

"code": 0,
  "result": {
    "common": {
      "enabled": "no",
      "debug_log": "no",
      "max_nmss": 1
    },
    "agent": {
      "v2c": "yes",
      "v3": "no",
      "community": "public",
      "user_name": "",
      "authentication_password": "",
      "authentication_protocol": "",
      "privacy_password": "",
      "privacy_protocol": "",
      "engine_id": "<engine_id>"
    },
    "nmss": []
  }
<!--NeedCopy-->

Kopieren Sie das JSON-Objekt result in Ihren bevorzugten Texteditor und entfernen Sie alle Zeilenumbrüche (\n) aus der Datei. Aktualisieren Sie die Felder mit Ihren SNMP-Konfigurationsdetails. Konfigurieren Sie Ihr NMS, indem Sie auf Ihre NMS-Dokumentation verweisen und Werte für die Felder angeben, die für das Objekt nmss erforderlich sind. Weitere Informationen finden Sie in den oben aufgeführten Objekten.

Um den SNMP-Dienst zu konfigurieren, führen Sie den Befehl set-config aus und geben Sie das bearbeitete JSON-Objekt result als Parameterwert für den Parameter args:config an.

Stellen Sie die SNMP-Konfiguration ein:

xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=set-config args:config='<result>'
<!--NeedCopy-->

Dabei gilt: result ist das JSON-Objekt result, das von dem Befehl get-config zurückgegeben wurde, den Sie kopiert und bearbeitet haben.

Hinweis:

Um SNMP für einen gesamten Pool zu konfigurieren, müssen Sie den Befehl set-config für jeden Host im Pool ausführen.

Wenn die Konfigurationsänderungen erfolgreich sind, gibt der Befehl das Schlüssel-Wert-Paar "code": 0 zurück. Wenn die Konfigurationsänderungen nicht erfolgreich sind, gibt der Befehl set-config eines der folgenden Schlüssel-Wert-Paare zurück, die darauf hinweisen, dass ein Fehler aufgetreten ist:

• "code": 1: Häufige Fehlerzeichenfolge. Zum Beispiel eine unbekannte Ausnahme.
• "code": 2: Fehlerstring (Parameter fehlt).
• "code": 3: Gibt ein message-Objekt als Liste zurück, in der jedes Element das Format [field_path, key, value, error string] hat.

Sie können auch einen Test-SNMP-Trap an Ihren NMS senden, um zu überprüfen, ob die angegebenen Trap-Empfängerinformationen korrekt sind.

Senden Sie einen Test-SNMP-Trap:

xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=send-test-trap args:config='{"nmss":[{"uuid":"<uuid>","address":"<address>","port":162,"v2c":"yes","v3":"no","community":"public","user_name":"<user_name>","authentication_password":"<authentication_password>","authentication_protocol":"<authentication_protocol>","privacy_password":"<privacy_password>","privacy_protocol":"<privacy_protocol>"}]}'
<!--NeedCopy-->

Dieser Befehl sendet einen Testtrap an Ihr NMS mit TEST_TRAPals msg_name und This is a test trap from XenServer pool "<pool name>" to verify the NMS Trap Receiver configuration. als msg_body.

Wenn Sie den Testtrap nicht erhalten, überprüfen Sie Ihre SNMP-Konfiguration erneut. Wenn der Befehl nicht erfolgreich ist, gibt der Befehl send-test-trap auch eines der folgenden Schlüssel-Wert-Paare zurück, die darauf hinweisen, dass ein Fehler aufgetreten ist:

• "code": 1: Häufige Fehlerzeichenfolge. Zum Beispiel eine unbekannte Ausnahme.
• "code": 2: Fehlerstring (Parameter fehlt).
• "code": 3: Gibt ein message-Objekt als Liste zurück, in der jedes Element das Format [field_path, key, value, error string] hat.
• "code": 4: Gibt das Objekt message als Liste zurück, in der jedes Element das Format [nms address, nms port, error string] hat.