curl --request POST \
--url https://telemetry.{region}.basaltic.sh/v1/logs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"logs": [
{
"log_group": "/app/prod/api",
"log_stream": "api-host-07",
"body": "request completed status=200 dur=12ms",
"timestamp": "2026-01-15T09:30:00Z",
"severity": "INFO",
"attributes": {},
"resource": {},
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"span_id": "00f067aa0ba902b7"
}
]
}
'import requests
url = "https://telemetry.{region}.basaltic.sh/v1/logs"
payload = { "logs": [
{
"log_group": "/app/prod/api",
"log_stream": "api-host-07",
"body": "request completed status=200 dur=12ms",
"timestamp": "2026-01-15T09:30:00Z",
"severity": "INFO",
"attributes": {},
"resource": {},
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"span_id": "00f067aa0ba902b7"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
logs: [
{
log_group: '/app/prod/api',
log_stream: 'api-host-07',
body: JSON.stringify('request completed status=200 dur=12ms'),
timestamp: '2026-01-15T09:30:00Z',
severity: 'INFO',
attributes: {},
resource: {},
trace_id: '4bf92f3577b34da6a3ce929d0e0e4736',
span_id: '00f067aa0ba902b7'
}
]
})
};
fetch('https://telemetry.{region}.basaltic.sh/v1/logs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://telemetry.{region}.basaltic.sh/v1/logs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'logs' => [
[
'log_group' => '/app/prod/api',
'log_stream' => 'api-host-07',
'body' => 'request completed status=200 dur=12ms',
'timestamp' => '2026-01-15T09:30:00Z',
'severity' => 'INFO',
'attributes' => [
],
'resource' => [
],
'trace_id' => '4bf92f3577b34da6a3ce929d0e0e4736',
'span_id' => '00f067aa0ba902b7'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://telemetry.{region}.basaltic.sh/v1/logs"
payload := strings.NewReader("{\n \"logs\": [\n {\n \"log_group\": \"/app/prod/api\",\n \"log_stream\": \"api-host-07\",\n \"body\": \"request completed status=200 dur=12ms\",\n \"timestamp\": \"2026-01-15T09:30:00Z\",\n \"severity\": \"INFO\",\n \"attributes\": {},\n \"resource\": {},\n \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\",\n \"span_id\": \"00f067aa0ba902b7\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://telemetry.{region}.basaltic.sh/v1/logs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"logs\": [\n {\n \"log_group\": \"/app/prod/api\",\n \"log_stream\": \"api-host-07\",\n \"body\": \"request completed status=200 dur=12ms\",\n \"timestamp\": \"2026-01-15T09:30:00Z\",\n \"severity\": \"INFO\",\n \"attributes\": {},\n \"resource\": {},\n \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\",\n \"span_id\": \"00f067aa0ba902b7\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://telemetry.{region}.basaltic.sh/v1/logs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"logs\": [\n {\n \"log_group\": \"/app/prod/api\",\n \"log_stream\": \"api-host-07\",\n \"body\": \"request completed status=200 dur=12ms\",\n \"timestamp\": \"2026-01-15T09:30:00Z\",\n \"severity\": \"INFO\",\n \"attributes\": {},\n \"resource\": {},\n \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\",\n \"span_id\": \"00f067aa0ba902b7\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"accepted": 998,
"rejected": 2,
"errors": [
"record 3: unknown log_group \"/app/prod/unregistered\"",
"record 7: body exceeds 256KiB"
]
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Ingerir um lote de registros de log
Anexe um ou mais registros de log ao armazenamento de telemetria da organização. As falhas de validação por registro são relatadas no campo rejected do corpo de resposta; a própria solicitação retorna 202 sempre que o lote foi aceito no nível de fio. Requer telemetry:WriteLogs permissão.
curl --request POST \
--url https://telemetry.{region}.basaltic.sh/v1/logs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"logs": [
{
"log_group": "/app/prod/api",
"log_stream": "api-host-07",
"body": "request completed status=200 dur=12ms",
"timestamp": "2026-01-15T09:30:00Z",
"severity": "INFO",
"attributes": {},
"resource": {},
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"span_id": "00f067aa0ba902b7"
}
]
}
'import requests
url = "https://telemetry.{region}.basaltic.sh/v1/logs"
payload = { "logs": [
{
"log_group": "/app/prod/api",
"log_stream": "api-host-07",
"body": "request completed status=200 dur=12ms",
"timestamp": "2026-01-15T09:30:00Z",
"severity": "INFO",
"attributes": {},
"resource": {},
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"span_id": "00f067aa0ba902b7"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
logs: [
{
log_group: '/app/prod/api',
log_stream: 'api-host-07',
body: JSON.stringify('request completed status=200 dur=12ms'),
timestamp: '2026-01-15T09:30:00Z',
severity: 'INFO',
attributes: {},
resource: {},
trace_id: '4bf92f3577b34da6a3ce929d0e0e4736',
span_id: '00f067aa0ba902b7'
}
]
})
};
fetch('https://telemetry.{region}.basaltic.sh/v1/logs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://telemetry.{region}.basaltic.sh/v1/logs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'logs' => [
[
'log_group' => '/app/prod/api',
'log_stream' => 'api-host-07',
'body' => 'request completed status=200 dur=12ms',
'timestamp' => '2026-01-15T09:30:00Z',
'severity' => 'INFO',
'attributes' => [
],
'resource' => [
],
'trace_id' => '4bf92f3577b34da6a3ce929d0e0e4736',
'span_id' => '00f067aa0ba902b7'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://telemetry.{region}.basaltic.sh/v1/logs"
payload := strings.NewReader("{\n \"logs\": [\n {\n \"log_group\": \"/app/prod/api\",\n \"log_stream\": \"api-host-07\",\n \"body\": \"request completed status=200 dur=12ms\",\n \"timestamp\": \"2026-01-15T09:30:00Z\",\n \"severity\": \"INFO\",\n \"attributes\": {},\n \"resource\": {},\n \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\",\n \"span_id\": \"00f067aa0ba902b7\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://telemetry.{region}.basaltic.sh/v1/logs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"logs\": [\n {\n \"log_group\": \"/app/prod/api\",\n \"log_stream\": \"api-host-07\",\n \"body\": \"request completed status=200 dur=12ms\",\n \"timestamp\": \"2026-01-15T09:30:00Z\",\n \"severity\": \"INFO\",\n \"attributes\": {},\n \"resource\": {},\n \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\",\n \"span_id\": \"00f067aa0ba902b7\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://telemetry.{region}.basaltic.sh/v1/logs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"logs\": [\n {\n \"log_group\": \"/app/prod/api\",\n \"log_stream\": \"api-host-07\",\n \"body\": \"request completed status=200 dur=12ms\",\n \"timestamp\": \"2026-01-15T09:30:00Z\",\n \"severity\": \"INFO\",\n \"attributes\": {},\n \"resource\": {},\n \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\",\n \"span_id\": \"00f067aa0ba902b7\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"accepted": 998,
"rejected": 2,
"errors": [
"record 3: unknown log_group \"/app/prod/unregistered\"",
"record 7: body exceeds 256KiB"
]
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}telemetry:WriteLogs. Consulte permissões de telemetria para obter a lista completa, o que cada uma abrange e um exemplo de política.Autorizações
Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.
Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.
Corpo
1000Show child attributes
Show child attributes

