Dokumentation / API · Logs / OTLP-Logs annehmen Auf dieser Seite Zugriff und Rechte Parameter und Header Anfragekörper Antworten Wiederholungen und asynchrone Aufträge Anfragebeispiele Verwandte Anleitungen Nehmen Sie OTLP/HTTP-Protobuf- oder Protobuf-JSON-Logs mit einem Quellenschlüssel an. Wiederholbare Fehler enthalten Retry-After und OTLP-Statusantworten.
LogSourceKey
Benötigte Maschinenberechtigungen (Scopes): logs:manage Keine Pfad-, Query- oder zusätzlichen Anfrageheader-Parameter.
Feld Typ und Grenzen Erforderlich Bedeutung $ object; {"additionalProperties":true} Ja —
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
200 · Das berechtigte Ergebnis des Vorgangs. application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object; {"additionalProperties":true} Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
401 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_credential unauthorized
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
403 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes csrf insufficient_scope invalid_origin operator_required forbidden
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
404 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_workspace not_found
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
409 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_workspace stale_check result_conflict
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
422 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_config invalid_monitor
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
429 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_workspace check_capacity
Header Typ und Grenzen Bedeutung Retry-After string; {"pattern":"^[0-9]+$"} Temporärer Serverfehler; unverändert mit Retry-After und derselben Idempotenzkennung wiederholen
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
503 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes unavailable feature_unavailable check_location_unavailable
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
413 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes log_limit request_too_large
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
400 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_log invalid_source log_identifier_conflict
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ object Ja — $.code integer Ja — $.message string Ja — $.details array<object> Nein — $.details[] object Ja —
application/x-protobuf
Feld Typ und Grenzen Erforderlich Bedeutung $ string Ja —
Für diese Änderung gibt es keine allgemeine Wiederholungsgarantie. Prüfen Sie bei unklarer Antwort den betroffenen Eintrag, bevor Sie es erneut versuchen. Beachten Sie Wartezeiten aus Retry-After und fordern Sie abgelaufene Anmelde- oder Aktionscodes neu an.
Ersetzen Sie Demokennungen, Zeitstempel und Platzhalter durch eigene Werte. Behalten Sie bei Wiederholungen Kennungen, Zeit und Inhalt bei. Diese Beispiele führen auf der Seite keine Anfragen aus.
Halten Sie Anmeldelinks, Codes, Cookies und Schlüssel privat. Schreiben Sie sie nicht in Logs und teilen Sie sie nicht in Hilfeanfragen.
shell Beispiel kopieren
curl --proto "=https" --tlsv1.2 --fail- with -body --max-time 30 --request POST --header @ "$HOME/.config/metribeacon/headers.txt" --header "Content-Type: application/json" --data-binary '{"resourceLogs":[{"scopeLogs":[{"logRecords":[{"severityText":"INFO","body":{"stringValue":"worker ready"}}]}]}]}' https://metribeacon.com/api/v1/otlp/v1/logs
python Beispiel kopieren
import json
from pathlib import Path
from urllib.request import Request, urlopen
headers=json.loads((Path.home()/ ".config/metribeacon/headers.json" ).read_text())
headers[ "Content-Type" ]= "application/json"
request=Request( 'https://metribeacon.com/api/v1/otlp/v1/logs' ,headers=headers,method= 'POST' ,data= '{"resourceLogs":[{"scopeLogs":[{"logRecords":[{"severityText":"INFO","body":{"stringValue":"worker ready"}}]}]}]}' .encode())
with urlopen(request,timeout=30) as response:
print(response.status)
javascript Beispiel kopieren
import {readFile} from "node:fs/promises" ;
import {homedir} from "node:os" ;
const headers=JSON.parse(await readFile(homedir()+ "/.config/metribeacon/headers.json" , "utf8" ));
headers[ "Content-Type" ]= "application/json" ;
const response=await fetch( "https://metribeacon.com/api/v1/otlp/v1/logs" ,{method: "POST" ,headers,redirect: "error" ,signal:AbortSignal.timeout(30000),body: "{\"resourceLogs\":[{\"scopeLogs\":[{\"logRecords\":[{\"severityText\":\"INFO\",\"body\":{\"stringValue\":\"worker ready\"}}]}]}]}" });
console.log(response.status);await response.body?.cancel();
go Beispiel kopieren
package main
import ( "net/http" ; "os" ; "path/filepath" ; "encoding/json" ; "time" ; "fmt" ; "strings" )
func main(){home,_:=os.UserHomeDir();raw,e:=os.ReadFile(filepath.Join(home, ".config/metribeacon/headers.json" )); if e!=nil{panic( "headers unavailable" )};var h map[string]string; if json.Unmarshal(raw,&h)!=nil{panic( "invalid headers" )};r,_:=http.NewRequest( "POST" , "https://metribeacon.com/api/v1/otlp/v1/logs" ,strings.NewReader( "{\"resourceLogs\":[{\"scopeLogs\":[{\"logRecords\":[{\"severityText\":\"INFO\",\"body\":{\"stringValue\":\"worker ready\"}}]}]}]}" )); for k,v:=range h{r.Header.Set(k,v)};r.Header.Set( "Content-Type" , "application/json" );c:=&http.Client{Timeout:30*time.Second,CheckRedirect: func (*http.Request,[]*http.Request)error{ return http.ErrUseLastResponse}};res,e:=c.Do(r); if e!=nil{panic( "request failed" )}; defer res.Body.Close();fmt.Println(res.StatusCode)}
Verwandte Anleitungen HTTP-API, OAuth und MCP Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
GET Freigegebene Logregeln lesenEin Quellenschlüssel liest nur die eigene Aktivierung und Maskierung. Neue lokale Dateien oder Befehle kann er nicht freigeben.
POST Abdeckung der Logerfassung meldenMeldet den Erfassungs- oder Übertragungszustand einer ausgewählten Logteilquelle. Bereit allein bestätigt keine vollständige Übertragung; Cursorprüfpunkte werden gemeinsam mit ihren Logpaketen bestätigt. Gepufferte Unterbrechungen bleiben bis zum Nachweis der lückenlosen Fortsetzung offen.
GET Logalarme auflistenLesen Sie Logalarmdefinitionen, Zustellkonfiguration und aktuelle Auswertungsabdeckung des berechtigten Arbeitsbereichs.