Veri gönderin
Instatus logları, izleri ve metrikleri OpenTelemetry (HTTPS üzerinden OTLP) ile alır. Bir uygulamayı bağlamanın iki yolu vardır. Birini seçin.
Seçenek 1: Bir istem kopyalayın
Claude Code, Cursor veya Copilot gibi bir kodlama ajanı kullanıyorsanız en hızlı yol budur.
- Durum sayfanızda Observability bölümünü açın.
- Dahil et altında göndermek istediklerinizi işaretleyin: Loglar, İzler, Metrikler. Daha sonra servisleriniz için hazır panolar istiyorsanız Başlangıç panosu seçeneğini de işaretleyin.
- İstemi kopyala düğmesine tıklayın.
- Uygulamanızın projesinde, kodlama ajanınıza yapıştırın.
- API anahtarınızı
INSTATUS_API_KEYortam değişkenine koyun ve ajanın önerdiği testi çalıştırın.

İstem, ajana dilinizin resmî OpenTelemetry SDK’sını kullanmasını, mevcut log kütüphanenizi korumasını, anahtarı bir ortam değişkeninden okumasını ve asla commit etmemesini söyler. Sayfa kimliğiniz zaten içindedir.
Seçenek 2: Elle kurun
- Durum sayfanızda Observability bölümünü açın.
- Elle kur düğmesine tıklayın.
- Dilinizi seçin: Node.js, Python, Go, Java, .NET, Ruby, PHP veya OpenTelemetry Collector.
- Kurulum altındaki komutu kopyalayıp çalıştırın, ardından Yapılandırma altındaki kodu uygulamanıza kopyalayın.
INSTATUS_API_KEYortam değişkenini API anahtarınıza ayarlayın ve uygulamanızı başlatın.

Panodaki kodda sayfa kimliğiniz zaten doldurulmuştur. Buradan kopyalamayı tercih ederseniz aynı örnekler aşağıdadır.
Her isteğin ihtiyacı olanlar
| Ne | Değer |
|---|---|
| Uç nokta | https://otel.instatus.com. Loglar /v1/logs, izler /v1/traces, metrikler /v1/metrics adresine gider. |
Authorization | Bearer <API_KEY>; sayfanın sahibi, yöneticisi veya editörünün anahtarıyla. |
X-Instatus-Site-Id | Verilerin ait olduğu durum sayfasının kimliği. |
| Protokol | HTTP üzerinden OTLP, protobuf veya JSON olarak. SDK’nız varsayılan olarak gRPC kullanıyorsa HTTP’ye geçirin. |
API anahtarınız tüm hesabınıza erişim sağlar. Sunucularınızda, bir ortam değişkeninde saklayın. Asla bir tarayıcıya, mobil uygulamaya veya herkese açık bir depoya koymayın.
API anahtarınızı bulun
Avatar menünüzü açın, Kullanıcı ayarları ve ardından Geliştirici seçeneğini seçin ya da doğrudan geliştirici ayarlarına gidin. Anahtarın yanındaki Kopyala düğmesine tıklayın.

Sayfa kimliğinizi bulun
Nadiren gerekir: istem ve panodaki kod onu zaten içerir. Kendiniz kopyalamak için panonun üstündeki proje adına sağ tıklayın ve Copy Project ID seçeneğini seçin.

Bir test logu gönderin
Anahtarınızı ve sayfa kimliğinizi kontrol etmek için terminalden tek bir istek yeterlidir:
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" }}]}]}]}'
200 yanıtı logun kabul edildiği anlamına gelir. Observability → Loglar bölümünü açın; birkaç saniye içinde orada olur.
Her dil, kod değişikliği olmadan
Her OpenTelemetry SDK’sı aynı ortam değişkenlerini okur. Bunlarla otomatik enstrümantasyon, kodunuza dokunmadan izleri, metrikleri ve logları gönderir:
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"
Başlık değişkeni URL olarak kodlandığı için Bearer sonrasındaki boşluk %20 olarak yazılır. Ardından uygulamanızı dilinin otomatik enstrümantasyonuyla başlatın:
# 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 ve PHP’nin kendi otomatik enstrümantasyonu vardır ve aynı değişkenleri okur. OpenTelemetry sıfır kod kılavuzlarına bakın.
Node.js
Kodunuzdan log göndermek için log SDK’sını kurun:
npm install @opentelemetry/api-logs @opentelemetry/sdk-logs \@opentelemetry/exporter-logs-otlp-http @opentelemetry/resources
Uygulamanız başlarken bir kez kurun:
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())
Zaten pino veya winston ile log mu tutuyorsunuz? Onları koruyun. pino-opentelemetry-transport ve @opentelemetry/winston-transport mevcut her log satırını olduğu gibi gönderir.
Python
pip install opentelemetry-sdk opentelemetry-exporter-otlp-proto-http
SDK, Python’ın logging modülüne bağlanır; bu yüzden mevcut logging çağrılarınız olduğu gibi gönderilir:
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
Zaten OpenTelemetry Collector mı çalıştırıyorsunuz? Instatus’u bir dışa aktarıcı olarak ekleyin ve uygulamalarınızı olduğu gibi bırakın:
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]
Dışa aktarıcı /v1/logs, /v1/traces ve /v1/metrics yollarını kendisi ekler, bu yüzden uç nokta yalnızca ana bilgisayardır. Log dosyaları göndermek için log hattına bir filelog alıcısı ekleyin.
Ne gönderilmeli
Instatus bu alanları okur. Geri kalan her şey, arayıp filtreleyebileceğiniz bir öznitelik olarak saklanır.
| Alan | Kullanım |
|---|---|
service.name (kaynak) | Servis sütunu ve filtresi. Her uygulamada, worker’da ve işte ayarlayın. |
body | Serbest metin aramasının aradığı log mesajı. |
severityText veya severityNumber | Seviye: fatal, error, warn, info, debug veya trace. |
traceId ve spanId | Bir logu izine bağlar, böylece ikisi arasında geçiş yapabilirsiniz. |
| Öznitelikler | customer.id veya http.route gibi eklediğiniz her şey. Her biri bir filtreye dönüşür. |
instatus. ile başlayan öznitelikler ayrılmıştır ve veri geldiğinde değiştirilir.
Sorun giderme
| Gördüğünüz | Çözüm |
|---|---|
401 | Anahtarı ve X-Instatus-Site-Id başlığını kontrol edin. Anahtarın sahibi sayfanın sahibi, yöneticisi veya editörü olmalıdır. |
400 | Gövde geçerli OTLP değil. Content-Type değerini ve test logundaki JSON yapısını kontrol edin. |
429 | Bu ayın veri kotası doldu. Planlar ve sınırlar bölümüne bakın. |
200, ama hiçbir şey görünmüyor | Birkaç saniye bekleyin, sonra zaman aralığını kontrol edin. Zaman damgası geçmişte olan bir log, yalnızca aralık onu kapsıyorsa görünür. |
| Hiçbir şey yok | SDK’lar toplu gönderir. Uygulamanızın çıkmadan önce sağlayıcıyı boşalttığından veya kapattığından emin olun. |
Geliştirici ayarlarında API anahtarınızı yeniden oluşturmak eskisini hemen durdurur, bu yüzden önce onu kullanan her uygulamayı güncelleyin.