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.

  1. Durum sayfanızda Observability bölümünü açın.
  2. 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.
  3. İstemi kopyala düğmesine tıklayın.
  4. Uygulamanızın projesinde, kodlama ajanınıza yapıştırın.
  5. API anahtarınızı INSTATUS_API_KEY ortam değişkenine koyun ve ajanın önerdiği testi çalıştırın.
Dahil edilecek loglar, izler ve metrikler ile istemi kopyalama düğmesi olan kurulum kartı

İ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

  1. Durum sayfanızda Observability bölümünü açın.
  2. Elle kur düğmesine tıklayın.
  3. Dilinizi seçin: Node.js, Python, Go, Java, .NET, Ruby, PHP veya OpenTelemetry Collector.
  4. Kurulum altındaki komutu kopyalayıp çalıştırın, ardından Yapılandırma altındaki kodu uygulamanıza kopyalayın.
  5. INSTATUS_API_KEY ortam değişkenini API anahtarınıza ayarlayın ve uygulamanızı başlatın.
Node.js seçili elle kurulum; kurulum komutu ve yapılandırma kodu görünüyor

Panodaki kodda sayfa kimliğiniz zaten doldurulmuştur. Buradan kopyalamayı tercih ederseniz aynı örnekler aşağıdadır.

Her isteğin ihtiyacı olanlar

NeDeğer
Uç noktahttps://otel.instatus.com. Loglar /v1/logs, izler /v1/traces, metrikler /v1/metrics adresine gider.
AuthorizationBearer <API_KEY>; sayfanın sahibi, yöneticisi veya editörünün anahtarıyla.
X-Instatus-Site-IdVerilerin ait olduğu durum sayfasının kimliği.
ProtokolHTTP ü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.

Geliştirici ayarlarındaki API anahtarı ve kopyalama düğmesi

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.

Proje adı menüsündeki Copy Project ID

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.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 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 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

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.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]

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.

AlanKullanım
service.name (kaynak)Servis sütunu ve filtresi. Her uygulamada, worker’da ve işte ayarlayın.
bodySerbest metin aramasının aradığı log mesajı.
severityText veya severityNumberSeviye: fatal, error, warn, info, debug veya trace.
traceId ve spanIdBir logu izine bağlar, böylece ikisi arasında geçiş yapabilirsiniz.
Özniteliklercustomer.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
401Anahtarı ve X-Instatus-Site-Id başlığını kontrol edin. Anahtarın sahibi sayfanın sahibi, yöneticisi veya editörü olmalıdır.
400Gövde geçerli OTLP değil. Content-Type değerini ve test logundaki JSON yapısını kontrol edin.
429Bu ayın veri kotası doldu. Planlar ve sınırlar bölümüne bakın.
200, ama hiçbir şey görünmüyorBirkaç 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 yokSDK’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.