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.
- Åbn Observability på din statusside.
- 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.
- Klik på Kopiér prompt.
- Indsæt den i din kodeagent, i din apps projekt.
- Læg din API-nøgle i miljøvariablen
INSTATUS_API_KEY, og kør den test, agenten foreslår.

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
- Åbn Observability på din statusside.
- Klik på Opsæt manuelt.
- Vælg dit sprog: Node.js, Python, Go, Java, .NET, Ruby, PHP eller OpenTelemetry Collector.
- Kopier kommandoen under Installér, og kør den, og kopier så koden under Konfigurer ind i din app.
- Sæt miljøvariablen
INSTATUS_API_KEYtil din API-nøgle, og start din app.

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
| Hvad | Værdi |
|---|---|
| Endpoint | https://otel.instatus.com. Logs går til /v1/logs, traces til /v1/traces, metrikker til /v1/metrics. |
Authorization | Bearer <API_KEY>, med nøglen fra en ejer, administrator eller redaktør af siden. |
X-Instatus-Site-Id | ID’et på den statusside, dataene hører til. |
| Protokol | OTLP 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.

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.

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.jsnpm install @opentelemetry/api @opentelemetry/auto-instrumentations-nodenode --require @opentelemetry/auto-instrumentations-node/register app.js# Pythonpip install opentelemetry-distro opentelemetry-exporter-otlpopentelemetry-bootstrap -a installOTEL_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 loggingimport osfrom opentelemetry._logs import set_logger_providerfrom opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporterfrom opentelemetry.sdk._logs import LoggerProvider, LoggingHandlerfrom opentelemetry.sdk._logs.export import BatchLogRecordProcessorfrom opentelemetry.sdk.resources import Resourceprovider = 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.comheaders: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å.
| Felt | Bruges til |
|---|---|
service.name (ressource) | Kolonnen og filteret Tjeneste. Sæt det i hver app, worker og job. |
body | Logbeskeden, som fritekstsøgning søger i. |
severityText eller severityNumber | Niveauet: fatal, error, warn, info, debug eller trace. |
traceId og spanId | Knytter en log til dens trace, så du kan hoppe mellem dem. |
| Attributter | Alt, 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 ser | Løsning |
|---|---|
401 | Tjek nøglen og headeren X-Instatus-Site-Id. Nøglens ejer skal være ejer, administrator eller redaktør af siden. |
400 | Body’en er ikke gyldig OTLP. Tjek Content-Type og JSON-strukturen i testloggen. |
429 | Månedens datamængde er brugt op. Se abonnementer og grænser. |
200, men intet vises | Vent et par sekunder, og tjek så tidsrummet. En log med et tidsstempel i fortiden vises kun, når tidsrummet dækker det. |
| Slet intet | SDK’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.