Send data

Instatus modtager logs, traces og metrikker via OpenTelemetry (OTLP over HTTPS). Der er to måder at forbinde en app på. Vælg én.

Mulighed 1: Kopier en prompt

Den hurtigste vej, hvis du bruger en kodeagent som Claude Code, Cursor eller Copilot.

  1. Åbn Observability på din statusside.
  2. Under Medtag markerer du, hvad du vil sende: Logs, Traces, Metrikker. Marker også Startdashboard, hvis du senere vil have færdige dashboards til dine tjenester.
  3. Klik på Kopiér prompt.
  4. Indsæt den i din kodeagent, i din apps projekt.
  5. Læg din API-nøgle i miljøvariablen INSTATUS_API_KEY, og kør den test, agenten foreslår.
Opsætningskortet med logs, traces og metrikker at inkludere og en knap til at kopiere prompten

Prompten beder agenten bruge det officielle OpenTelemetry-SDK til dit sprog, beholde dit nuværende logbibliotek, læse nøglen fra en miljøvariabel og aldrig committe den. Dit side-ID står allerede i den.

Mulighed 2: Opsæt manuelt

  1. Åbn Observability på din statusside.
  2. Klik på Opsæt manuelt.
  3. Vælg dit sprog: Node.js, Python, Go, Java, .NET, Ruby, PHP eller OpenTelemetry Collector.
  4. Kopier kommandoen under Installér, og kør den, og kopier så koden under Konfigurer ind i din app.
  5. Sæt miljøvariablen INSTATUS_API_KEY til din API-nøgle, og start din app.
Manuel opsætning med Node.js valgt, med installationskommandoen og konfigurationskoden

Koden i dashboardet har allerede dit side-ID udfyldt. De samme eksempler står nedenfor, hvis du hellere vil kopiere herfra.

Det skal hver forespørgsel have

HvadVærdi
Endpointhttps://otel.instatus.com. Logs går til /v1/logs, traces til /v1/traces, metrikker til /v1/metrics.
AuthorizationBearer <API_KEY>, med nøglen fra en ejer, administrator eller redaktør af siden.
X-Instatus-Site-IdID’et på den statusside, dataene hører til.
ProtokolOTLP over HTTP, som protobuf eller JSON. Bruger dit SDK gRPC som standard, så skift det til HTTP.

Din API-nøgle giver adgang til hele din konto. Opbevar den på dine servere, i en miljøvariabel. Læg den aldrig i en browser, en mobilapp eller et offentligt repository.

Find din API-nøgle

Åbn menuen under din avatar, vælg Brugerindstillinger og derefter Udvikler, eller gå direkte til udviklerindstillinger. Klik på Kopiér ved siden af nøglen.

API-nøglen i udviklerindstillinger med en knap til at kopiere den

Find dit side-ID

Det er sjældent nødvendigt: prompten og koden i dashboardet indeholder det allerede. Vil du kopiere det selv, så højreklik på projektnavnet øverst i dashboardet, og vælg Copy Project ID.

Copy Project ID i menuen for projektnavnet

Send en testlog

Én forespørgsel fra en terminal er nok til at tjekke din nøgle og dit side-ID:

curl -X POST https://otel.instatus.com/v1/logs \
-H "Authorization: Bearer $INSTATUS_API_KEY" \
-H "X-Instatus-Site-Id: $INSTATUS_PAGE_ID" \
-H "Content-Type: application/json" \
-d '{
"resourceLogs": [{
"resource": {
"attributes": [
{ "key": "service.name", "value": { "stringValue": "api" } }
]
},
"scopeLogs": [{
"logRecords": [{
"timeUnixNano": "'$(date +%s)'000000000",
"severityText": "INFO",
"body": { "stringValue": "Hello from Instatus" }
}]
}]
}]
}'

Et 200-svar betyder, at loggen blev accepteret. Åbn Observability → Logs, så er den der inden for få sekunder.

Alle sprog, uden kodeændringer

Alle OpenTelemetry-SDK’er læser de samme miljøvariabler. Med dem sender auto-instrumentering traces, metrikker og logs uden at røre din kode:

export OTEL_SERVICE_NAME="api"
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otel.instatus.com"
export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer%20${INSTATUS_API_KEY},X-Instatus-Site-Id=${INSTATUS_PAGE_ID}"
export OTEL_TRACES_EXPORTER="otlp"
export OTEL_METRICS_EXPORTER="otlp"
export OTEL_LOGS_EXPORTER="otlp"

Mellemrummet efter Bearer skrives som %20, fordi header-variablen er URL-kodet. Start derefter din app med auto-instrumenteringen til dens sprog:

# Node.js
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register app.js
# Python
pip install opentelemetry-distro opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install
OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true opentelemetry-instrument python app.py

Java, .NET, Go, Ruby og PHP har deres egen auto-instrumentering og læser de samme variabler. Se OpenTelemetrys zero-code-vejledninger.

Node.js

For at sende logs fra din kode skal du installere logs-SDK’et:

npm install @opentelemetry/api-logs @opentelemetry/sdk-logs \
@opentelemetry/exporter-logs-otlp-http @opentelemetry/resources

Opsæt det én gang, når din app starter:

import { SeverityNumber } from '@opentelemetry/api-logs'
import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http'
import { resourceFromAttributes } from '@opentelemetry/resources'
import { BatchLogRecordProcessor, LoggerProvider } from '@opentelemetry/sdk-logs'
const provider = new LoggerProvider({
resource: resourceFromAttributes({ 'service.name': 'api' }),
processors: [
new BatchLogRecordProcessor(
new OTLPLogExporter({
url: 'https://otel.instatus.com/v1/logs',
headers: {
Authorization: `Bearer ${process.env.INSTATUS_API_KEY}`,
'X-Instatus-Site-Id': process.env.INSTATUS_PAGE_ID
}
})
)
]
})
const logger = provider.getLogger('api')
logger.emit({
severityNumber: SeverityNumber.ERROR,
severityText: 'ERROR',
body: 'Payment failed: card declined',
attributes: { 'customer.id': 'cus_123', route: '/v2/charges' }
})
process.on('beforeExit', () => provider.shutdown())

Logger du allerede med pino eller winston? Behold dem. pino-opentelemetry-transport og @opentelemetry/winston-transport sender hver eksisterende loglinje, som den er.

Python

pip install opentelemetry-sdk opentelemetry-exporter-otlp-proto-http

SDK’et kobler sig på Pythons logging-modul, så dine eksisterende logging-kald sendes, som de er:

import logging
import os
from opentelemetry._logs import set_logger_provider
from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter
from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler
from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
from opentelemetry.sdk.resources import Resource
provider = LoggerProvider(resource=Resource.create({"service.name": "worker"}))
provider.add_log_record_processor(
BatchLogRecordProcessor(
OTLPLogExporter(
endpoint="https://otel.instatus.com/v1/logs",
headers={
"Authorization": f"Bearer {os.environ['INSTATUS_API_KEY']}",
"X-Instatus-Site-Id": os.environ["INSTATUS_PAGE_ID"],
},
)
)
)
set_logger_provider(provider)
logging.getLogger().addHandler(LoggingHandler(level=logging.INFO, logger_provider=provider))
logging.getLogger().setLevel(logging.INFO)
logging.warning("Card declined for customer %s", "cus_123")

OpenTelemetry Collector

Kører du allerede OpenTelemetry Collector? Tilføj Instatus som exporter, og lad dine apps være, som de er:

exporters:
otlphttp/instatus:
endpoint: https://otel.instatus.com
headers:
Authorization: Bearer ${env:INSTATUS_API_KEY}
X-Instatus-Site-Id: ${env:INSTATUS_PAGE_ID}
service:
pipelines:
logs:
receivers: [otlp]
processors: [batch]
exporters: [otlphttp/instatus]
traces:
receivers: [otlp]
processors: [batch]
exporters: [otlphttp/instatus]
metrics:
receivers: [otlp]
processors: [batch]
exporters: [otlphttp/instatus]

Exporteren tilføjer selv /v1/logs, /v1/traces og /v1/metrics, så endpointet er kun værten. For at sende logfiler skal du tilføje en filelog-receiver til logs-pipelinen.

Hvad du sender

Instatus læser disse felter. Alt andet gemmes som en attribut, du kan søge og filtrere på.

FeltBruges til
service.name (ressource)Kolonnen og filteret Tjeneste. Sæt det i hver app, worker og job.
bodyLogbeskeden, som fritekstsøgning søger i.
severityText eller severityNumberNiveauet: fatal, error, warn, info, debug eller trace.
traceId og spanIdKnytter en log til dens trace, så du kan hoppe mellem dem.
AttributterAlt, du tilføjer, fx customer.id eller http.route. Hver bliver et filter.

Attributter, der starter med instatus., er reserveret og erstattes, når dataene ankommer.

Fejlfinding

Du serLøsning
401Tjek nøglen og headeren X-Instatus-Site-Id. Nøglens ejer skal være ejer, administrator eller redaktør af siden.
400Body’en er ikke gyldig OTLP. Tjek Content-Type og JSON-strukturen i testloggen.
429Månedens datamængde er brugt op. Se abonnementer og grænser.
200, men intet visesVent et par sekunder, og tjek så tidsrummet. En log med et tidsstempel i fortiden vises kun, når tidsrummet dækker det.
Slet intetSDK’er sender i batches. Sørg for, at din app tømmer eller lukker provideren, før den stopper.

Når du genererer en ny API-nøgle i udviklerindstillinger, holder den gamle op med at virke med det samme, så opdater først alle apps, der bruger den.