Eine Anbindung benötigt die Berechtigung zum Senden von Messwerten, aber nicht automatisch Verwaltungsrechte für ein ganzes Konto. Der passende Zugangstyp und ein klarer Ressourcenumfang erleichtern den Betrieb und einen späteren Wechsel der Zuständigkeit.
MetriBeacon unterscheidet Telemetrieschlüssel, Maschinenzugänge zur Ressourcenverwaltung und den Zugang zu Remote-MCP. Diese Anleitung konzentriert sich auf Telemetrieschlüssel: Anlage, Geltungsbereich und einen nachvollziehbaren Austausch der verwendeten Zugangsdaten.
Den Zugang passend zur Aufgabe wählen
Geräte- beziehungsweise Telemetrieschlüssel mit dem Präfix mbk_ senden Messwerte für die freigegebenen Ressourcen. Maschinenzugänge mit mbm_ verwalten Ressourcen entsprechend ihrer ausdrücklichen Berechtigungen. Remote-MCP verwendet ein separates Zugriffstoken.
Diese Zugangstypen sind keine austauschbaren Bezeichnungen für ein unbegrenzt berechtigtes Geheimnis. Verwenden Sie für die klassische Telemetrieannahme den vorgesehenen Telemetrieschlüssel und keinen ersatzweise eingesetzten Maschinenzugang. Eine Verwaltungsanbindung erhält nur die Lese- oder Schreibrechte, die ihre Aufgabe benötigt.
Die Schlüsselanleitung beschreibt die Bedienung der Telemetrieschlüssel. Für einen Dialog- oder Automatisierungsclient mit Remote-MCP verwenden Sie die gesonderte MCP-Zugangsanleitung.
Die benötigten Monitore vor der Anlage festlegen
Notieren Sie zunächst, für welche Monitore die Anbindung schreiben soll. Ein Skript für die Messwerte einer Anwendung benötigt normalerweise einen engeren Umfang als ein bewusst gemeinsam eingesetzter Collector für mehrere Monitore.
Wählen Sie einzelne Monitore oder den gesamten Arbeitsbereich. Ein arbeitsbereichsweiter Schlüssel umfasst auch künftig angelegte Monitore dieses Arbeitsbereichs. Verstehen Sie dies als dauerhafte Freigabe und nicht als Abkürzung zum Überspringen der Ressourcenauswahl.
Der Sender muss das vorgesehene Ziel weiterhin in seiner Anfrage angeben. Ein großer Schlüsselumfang sorgt nicht automatisch dafür, dass eine mehrdeutige Nutzlast beim richtigen Monitor landet. Prüfen Sie sowohl die freigegebenen Ressourcen als auch die von der Anbindung verwendeten Zielkennungen.
Einen Schlüssel anlegen und den Klartext einmalig sichern
Öffnen Sie API-Schlüssel, prüfen Sie den Arbeitsbereich und legen Sie einen verständlich benannten Schlüssel an. Der Name sollte die Anbindung später erkennbar machen, beispielsweise über Dienst und Umgebung. Er sollte keine Eigentümerschaft oder Berechtigung behaupten, die der Schlüssel nicht besitzt.
Wählen Sie Monitore oder Arbeitsbereichsumfang, prüfen Sie die Auswahl und speichern Sie. Der vollständige Geheimwert wird nur einmal angezeigt. Übernehmen Sie ihn direkt in die geschützte Konfiguration oder Geheimnisverwaltung der Anbindung, bevor Sie die Anzeige schließen.
Schlüssel gehören nicht in URLs, öffentliche Repositorys, geteilte Artikel, Chatverläufe oder gewöhnliche Anwendungslogs. Halten Sie auch HTTP-Autorisierungsheader aus Diagnoseausgaben heraus. Dokumentieren Sie in Ihrem Betriebsablauf den Ablageort und die Verantwortung, statt den Geheimwert in jede Übergabenotiz zu kopieren.
Den tatsächlichen Datenempfang prüfen
Konfigurieren Sie die Anbindung anhand der HTTPS-API-Dokumentation mit den passenden Zielkennungen. Beginnen Sie mit den Messgrößen, die diese Anbindung tatsächlich senden soll. Prüfen Sie Anfrageergebnisse und die aktuellen Werte des Monitors.
Der Zeitpunkt der Schlüsselverwendung ist ein hilfreicher Hinweis. Ein Kontakt allein bestätigt jedoch nicht die Speicherung der erwarteten Messung. Kontrollieren Sie Messreihenname, Einheit, Erfassungszeit und letzten Wert in MetriBeacon. Stellen Sie sicher, dass die Daten zum vorgesehenen Monitor und Arbeitsbereich gehören.
Wiederholt die Anbindung eine Anfrage, erhalten Sie stabile Messwertkennungen und beachten Sie das dokumentierte Wiederholungsverhalten. Ein neuer Schlüssel für jeden Wiederholungsversuch behebt weder ein Annahmeproblem noch einen Formatfehler.
Die Folgen einer Rotation verstehen
Eine Rotation ersetzt den Geheimwert und beendet die Gültigkeit des alten Schlüssels sofort. Sie bietet keine automatische Übergangsfrist, in der sich alle Sender selbst aktualisieren. Ermitteln Sie deshalb vor dieser Aktion die beteiligten Verbraucher.
Bei einer selbst verwalteten API-Anbindung kann ein geordneter Wechsel über einen separat angelegten neuen Schlüssel mit dem benötigten Umfang erfolgen: anlegen, Sender umstellen, Datenempfang prüfen und den alten Schlüssel anschließend widerrufen. Die geltenden Schlüsselkontingente bleiben zu beachten. Lassen Sie nicht beide Zugänge dauerhaft ohne begründeten Bedarf aktiv.
Verwenden Sie die ausdrückliche Aktion Rotieren, planen Sie den sofortigen Wechsel und aktualisieren Sie die betreffenden Verbraucher. Ein Sender mit altem Geheimwert kann sich danach nicht mehr anmelden. Geht der einmal angezeigte neue Wert verloren, ist ein weiterer bewusster Austausch nötig. Der alte Klartext lässt sich nicht erneut einblenden.
Installierte Agenten im passenden Zusammenhang behandeln
Ein Serverinstallationsschlüssel kann eine Installationsherkunft und zusätzliche Beziehungen für den verwalteten Agenten besitzen. Lesen Sie diesen Zusammenhang, bevor Sie ihn durch einen allgemeinen Integrationsschlüssel ersetzen.
Nutzen Sie für installierte Collectoren den vorgesehenen Server- und Agentenkonfigurationsablauf. Die Änderung eines Schlüssels aktualisiert nicht automatisch jede geschützte Konfigurationsdatei und überträgt keine Installationsbeziehung auf einen anderen Monitor.
Die Anleitung zur Agentenkonfiguration hilft beim Auffinden der passenden Einstellungen. Prüfen Sie nach einer Änderung frische Messwerte und den bestätigten Konfigurationsstand. Eine bearbeitete Datei allein belegt nicht den Abschluss des gesamten Vorgangs.
Nicht mehr benötigten Zugriff widerrufen
Widerrufen Sie einen Schlüssel, wenn die Anbindung endet oder ihr Zugriff gestoppt werden soll. Prüfen Sie bei einer geplanten Änderung vorher die Verbraucher. Wurde ein Geheimwert möglicherweise offengelegt, stimmen Sie Austausch und Zugriffsende passend zum Vorfall ab, statt weiter auf den alten Wert zu vertrauen.
Widerruf und Rotation entfernen keine historischen Messwerte des Monitors. Sie bestimmen, ob künftige Anfragen mit diesen Zugangsdaten authentifiziert werden können. Kontrollieren Sie verbleibende Schlüssel gesondert. Ein Widerruf bedeutet nicht, dass damit jede andere berechtigte Anbindung beendet wurde.
Auch Mitgliedschaften und Ressourcenrechte bleiben relevant. Ein Schlüssel setzt die umgebenden Konto- und Arbeitsbereichsrechte nicht außer Kraft. Prüfen Sie diese Beziehungen, wenn eine zuvor funktionierende Anbindung nach einer bewussten Rechteänderung keinen Zugriff mehr hat.
Fehler vor dem nächsten Schlüsseltausch eingrenzen
Ein Anmeldefehler kann auf einen alten, widerrufenen oder falsch kopierten Geheimwert hinweisen. Bei einem Berechtigungsfehler sind Umfang und Ziel zu prüfen. Eine Raten- oder Kontingentantwort erfordert die passende Wartezeit oder Kapazitätsprüfung. Lesen Sie vor der Reparatur die konkrete Fehlerkennung und Antwortheader.
Beginnen Sie mit einer kurzen Prüffolge: passender Zugangstyp, richtige Geheimnisquelle, korrekter Arbeitsbereich, freigegebener Monitor und eindeutig bezeichnete Nutzlast. Kontrollieren Sie danach Datenformat, Zeitangaben und Verbrauchsgrenzen.
Sie können ein MetriBeacon-Konto erstellen, einen Monitor anbinden und einen eng begrenzten Schlüssel für Ihre eigene Integration anlegen. Halten Sie Zweck, Verbraucher und Austauschablauf von Anfang an verständlich fest. Die Website/API-Vorlage unter diesem Artikel erstellt eine Prüfung. Sie richtet keinen Telemetriesender ein und verteilt keinen Schlüssel automatisch.



