Erstellen Sie Ihre erste STACKIT Logs-Instanz und senden Sie Ihre ersten Log-Nachrichten

Voraussetzungen

• Sie verfügen über ein STACKIT-Kundenkonto: Kundenkonto erstellen
• Sie verfügen über ein STACKIT-Benutzerkonto: Benutzerkonto erstellen
• Sie verfügen über ein STACKIT-Projekt: Projekt erstellen

Instanz vorbereiten, bestellen und erstellen

In dieser Anleitung für die ersten Schritte erstellen und konfigurieren Sie eine Instanz. Dieser Leitfaden zeigt die gängigsten Einstellungen für eine kleine Entwicklungsumgebung. Wenn Sie dieser Anleitung folgen, arbeiten Sie mit dem STACKIT Portal.

1. Besuchen Sie das STACKIT Portal.
2. Klicken Sie in der Seitenleiste auf Logs.
3. Klicken Sie in der oberen Leiste auf Create Logs.

Nach Abschluss der Schritte sehen Sie ein Overlay mit drei Abschnitten (General information und Setup).

Allgemeine Informationen

• Geben Sie den Namen für die Instanz ein.

Setup

• Geben Sie die Aufbewahrungsdauer in Tagen für die Instanz ein.

• Fügen Sie die IPv4-Adresse Ihres Clients zur Liste der ACL hinzu.

  Wenn Sie sich mit dem Computer verbinden möchten, mit dem Sie diese Dokumentation aufrufen, verwenden Sie das IP-Trace-Tool von Cloudflare, um Ihre IPv4-Adresse zu ermitteln. Öffnen Sie den Browser Ihrer Wahl und besuchen Sie das Cloudflare Trace Tool. Kopieren Sie den Wert hinter ip. Er sollte wie xxx.xxx.xxx.xxx aussehen. Ergänzen Sie anschließend /32 und fügen Sie ihn als ACL-Eintrag hinzu. Klicken Sie dazu auf Add IP Range und fügen Sie den Wert in das Feld ein.

Wenn Sie die IPv4-Adresse Ihres Clients nicht zur Liste der ACL hinzufügen, können Sie keine Verbindung zu Ihrer Instanz herstellen.

Nachdem Sie alle Einstellungen überprüft haben, klicken Sie auf Order fee-based, um Ihre neue Instanz zu erstellen. Anschließend sehen Sie eine Bestätigung, dass Ihre Instanz erstellt wurde. Ihre neue Instanz wird der Liste der Instanzen hinzugefügt. Nach einigen Minuten wechselt der Status von Reconciling zu Active.

Die hier beschriebene Aktion kann Kosten verursachen oder Ihre laufenden Kosten verändern. Bitte prüfen Sie sorgfältig, welche einmaligen und/oder laufenden Kosten anfallen, und führen Sie die Aktion nur aus, wenn Sie damit einverstanden und dazu berechtigt sind.

Zugangsdaten abrufen

Sobald die Instanz den Status Active anzeigt:

1. Klicken Sie auf Ihre Logs-Instanz.

2. Öffnen Sie den Tab API.

3. Öffnen Sie den Tab Access tokens.

4. Klicken Sie auf Create access token.

5. Geben Sie einen Namen ein.

6. Wählen Sie die Laufzeit Unlimited.

   Eine unbegrenzte Laufzeit wird für den Produktionseinsatz nicht empfohlen.

7. Wählen Sie die Rolle Read and Write.

8. Klicken Sie auf Create.

9. Speichern Sie den Token an einem sicheren Ort.

   Diese Information kann später nicht erneut abgerufen werden.

Sie benötigen diese Zugangsdaten für den API-Zugriff sowie für Promtail- und Grafana-Agents.

Erste Logs senden und abfragen

Sie können Logs über die REST API, Promtail, den Grafana Agent oder Drittanbieter-Tools senden.

Im Folgenden finden Sie Beispiele mit der Loki-API.

Logs per cURL senden

Parameter	Bedeutung	Beispiel
InstanceId	Die Instanz-ID Ihrer Logs-Instanz.	e074181e-5a2c-4515-9980-af03bee08922
AccessToken	Der soeben erstellte Access Token	eyJhbGc…
AppName	Der Name Ihrer App in Loki	demo-app
Timestamp	Der Startzeitpunkt der Logs	1763294137000000000

curl
  -X POST https://[InstanceId].logs.eu01.onstackit.cloud/loki/api/v1/push \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [AccessToken]" \
  --data '{
            "streams": [
              {
                "stream": {
                  "app": "[AppName]",
                  "level": "info"
                },
                "values": [
                  [ [Timestamp], "Hello from STACKIT Logs!" ]
                ]
              }
            ]
          }'

Sie sollten eine Antwort mit 204 No Content erhalten.

Logs per cURL abfragen

Parameter	Bedeutung	Beispiel
InstanceId	Die Instanz-ID Ihrer Logs-Instanz.	e074181e-5a2c-4515-9980-af03bee08922
AccessToken	Der soeben erstellte Access Token	eyJhbGc…
AppName	Der Name Ihrer App in Loki	demo-app
Start	Der Startzeitpunkt der Logs	1763294136000000000
End	Der Endzeitpunkt der Logs	1763294138000000000

curl
  -X POST https://[InstanceId].logs.eu01.onstackit.cloud/loki/api/v1/query_range?query={app="[AppName]"}&end=[End]&start=[Start] \
  -H "Authorization: Bearer [AccessToken]"

Logs sollten mit den entsprechenden Log-Einträgen antworten, zum Beispiel:

{
    "status": "success",
    "data": {
        "resultType": "streams",
        "result": [
            {
                "stream": {
                    "app": "demo-app",
                    "detected_level": "info",
                    "level": "info",
                    "service_name": "demo-app"
                },
                "values": [
                    [
                        "1763294137000000000",
                        "Hello from STACKIT Logs!"
                    ]
                ]
            }
        ],
      [...]
    }
}