Instanzen erstellen und verwalten

Der Telemetry Router ist eine selbst verwaltbare Komponente, über welche Telemetry Daten eingeleitet werden können. Um Daten am Endpunkt des Telemetry Routers einleiten zu können, wird ein individuell erstellbares Zugriffstoken benötigt. Die Erstellung eines Telemetry Routers ermöglicht das Anlegen von Destinations Filterung und Emission der erfassten Daten.

Voraussetzungen

• Sie haben ein STACKIT Kundenkonto: Kundenkonto erstellen
• Sie haben ein STACKIT Benutzerkonto: Benutzerkonto erstellen
• Sie haben ein STACKIT Projekt: Projekt erstellen

API-Voraussetzungen & Variablen

Um die API-Befehle in dieser Anleitung auszuführen, müssen Sie zuerst die folgenden Pfadparameter als Umgebungsvariablen in Ihrem Terminal exportieren (oder diese direkt in den Befehlen ersetzen):

• $PROJECT_ID: Ihre eindeutige STACKIT Projekt-ID (z. B. 16dbfb51...).
• $REGION_ID: Die Region, in der sich Ihre Instanz befinden wird (z. B. eu01 oder eu02).
• $TELEMETRY_ROUTER_ID: Die eindeutige ID Ihrer Telemetry Router-Instanz (erforderlich für die Vorgänge Anzeigen, Bearbeiten und Löschen).

Wenn Sie Hilfe beim Finden dieser Bezeichner benötigen oder erfahren möchten, wie der Wrapper stackit curl funktioniert, lesen Sie unsere zentrale Anleitung: Interagieren mit der Telemetry Router API.

Eine konzeptionelle Übersicht über die verschiedenen Authentifizierungspfade finden Sie in unserer Authentifizierungsübersicht.

Instanz erstellen

STACKIT API

Um eine Telemetry Router-Instanz zu erstellen, müssen Sie den entsprechenden Endpunkt aufrufen.

Wählen Sie die Eigenschaften für Ihre neue Instanz

Parameter	Bedeutung	Beispiel
displayName	Ein Name für die Telemetry Router-Instanz	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Telemetry Router-Instanz

stackit curl -X POST \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers" \
-H "Content-Type: application/json" \
--data '{
    "displayName": "<DISPLAY_NAME>",
    "description": "<DESCRIPTION>"
}'

Beispiel

stackit curl -X POST \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers" \
-H "Content-Type: application/json" \
--data '{
    "displayName": "my-telemetry-router",
    "description": "Meine Telemetry Router-Instanz"
}'

STACKIT Portal

Führen Sie die Schritte im Portal aus, um eine Telemetry Router-Instanz zu erstellen.

1. Wählen Sie in der Seitenleiste Telemetry Router aus.

2. Wählen Sie in der oberen Leiste Create Telemetry Router aus.

3. Tragen Sie im Bereich einen Router name ein.

4. Nachdem Sie alles nach Ihren Wünschen konfiguriert haben, erstellen Sie Ihre Instanz.

   Das System fügt Ihre neu erstellte Instanz zur Liste Ihrer Telemetry Router-Instanzen hinzu. Nach einigen Sekunden wechselt der Instanzstatus von Reconciling zu Active. Herzlichen Glückwunsch, Ihre Telemetry Router-Instanz ist einsatzbereit!

Alle Instanzen auflisten

STACKIT API

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers" \
-H "Content-Type: application/json"

Beispiel

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers" \
-H "Content-Type: application/json"

STACKIT Portal

Führen Sie die Schritte im Portal aus, um eine Telemetry Router-Instanz zu erstellen.

1. Wählen Sie in der Seitenleiste Telemetry Router aus.

   Sie sehen eine Liste aller Telemetry Router-Instanzen.

Eine Instanz anzeigen

STACKIT API

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID" \
-H "Content-Type: application/json"

Beispiel

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557" \
-H "Content-Type: application/json"

STACKIT Portal

Führen Sie die Schritte im Portal aus, um eine Telemetry Router-Instanz zu erstellen.

1. Wählen Sie in der Seitenleiste Telemetry Router aus.

   Sie sehen eine Liste aller Telemetry Router-Instanzen.

2. Navigieren Sie zu der Instanz, die Sie anzeigen möchten, und wählen Sie den Eintrag aus.

   Sie gelangen in die Detailansicht Ihrer Instanz, wo Sie eine Übersicht über alle Eigenschaften haben.

Eine Instanz bearbeiten

STACKIT API

Parameter	Bedeutung	Beispiel
displayName	Ein Name für die Telemetry Router-Instanz. In diesem Endpunkt ist der Parameter optional.	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Telemetry Router-Instanz
filter	Ein optionales Filter-Objekt. Lesen Sie Filter, um zu erfahren, wie Filter funktionieren.	Siehe Filter-Beispiel

stackit curl -X PUT \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID" \
-H "Content-Type: application/json" \
--data '{
    "displayName": "<DISPLAY_NAME>",
    "description": "<DESCRIPTION>",
    "filter": <FILTER_OBJECT>
}'

Filter-Beispiel

"attributes": [
    {
        "key": "my-special-filter",
        "level": "scope",
        "matcher": "=",
        "value": "user"
    }
]

Beispiel für das Hinzufügen eines Filters zu einer bestehenden Telemetry Router-Instanz

stackit curl -X PUT \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557" \
-H "Content-Type: application/json" \
--data '{
    "filter": {
        "attributes": [
            {
                "key": "my-special-filter",
                "level": "scope",
                "matcher": "=",
                "value": "user"
            }
        ]
    }
}'

STACKIT Portal

Führen Sie die Schritte im Portal aus, um eine Telemetry Router-Instanz zu erstellen.

1. Wählen Sie in der Seitenleiste Telemetry Router aus.

   Sie sehen eine Liste aller Telemetry Router-Instanzen.

2. Navigieren Sie zu der Instanz, die Sie anzeigen möchten, und wählen Sie den Eintrag aus.

   Sie gelangen in die Detailansicht Ihrer Instanz, wo Sie eine Übersicht über alle Eigenschaften haben.

3. Um den Namen oder die Beschreibung Ihrer Instanz zu ändern, wählen Sie Edit neben General information aus. Gehen Sie ebenso vor, um Attribute filters zu bearbeiten.

Eine Instanz löschen

STACKIT API

Um eine Telemetry Router-Instanz zu löschen, müssen Sie den DELETE-Endpunkt aufrufen.

stackit curl -X DELETE \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID" \
-H "Content-Type: application/json"

Beispiel:

stackit curl -X DELETE \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557" \
-H "Content-Type: application/json"

STACKIT Portal

Führen Sie die Schritte im Portal aus, um eine Telemetry Router-Instanz zu erstellen.

1. Wählen Sie in der Seitenleiste Telemetry Router aus.

   Sie sehen eine Liste aller Telemetry Router-Instanzen.

2. Navigieren Sie zu der Instanz, die Sie löschen möchten, und öffnen Sie das Drei-Punkte-Menü des Eintrags.

3. Wählen Sie im Menü Delete aus.

4. Geben Sie im neuen Bereich den Namen Ihrer Instanz ein und wählen Sie „Delete” aus.