# Veri gönderin

Source: https://instatus.com/help/tr/observability/send-logs

Instatus logları, izleri ve metrikleri OpenTelemetry (HTTPS üzerinden OTLP) ile alır. Bir uygulamayı bağlamanın iki yolu vardır. Birini seçin.

| At a glance | Details |
| :-- | :-- |
| [En hızlı](https://instatus.com/help/tr/observability/send-logs#seçenek-1-bir-istem-kopyalayın) | Kodlama ajanınız için bir istem kopyalayın |
| [Elle](https://instatus.com/help/tr/observability/send-logs#seçenek-2-elle-kurun) | Dilinizi seçin ve kodu yapıştırın |
| [Uç nokta](https://instatus.com/help/tr/observability/send-logs#her-isteğin-ihtiyacı-olanlar) | https://otel.instatus.com ve iki başlık |
| [Test](https://instatus.com/help/tr/observability/send-logs#bir-test-logu-gönderin) | Tek bir curl isteği |
| [Hiçbir şey görünmüyor mu?](https://instatus.com/help/tr/observability/send-logs#sorun-giderme) | Yaygın sorunları çözün |

## 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ı](#api-anahtarınızı-bulun) `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ı](https://instatus.com/help/observability/setup.png)

İ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](#api-anahtarınızı-bulun) 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](https://instatus.com/help/observability/setup-by-hand.png)

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](https://dashboard.instatus.com/developer) gidin. Anahtarın yanındaki **Kopyala** düğmesine tıklayın.

![Geliştirici ayarlarındaki API anahtarı ve kopyalama düğmesi](https://instatus.com/help/observability/api-key.png)

### 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](https://instatus.com/help/observability/copy-page-id.png)

## Bir test logu gönderin

Anahtarınızı ve sayfa kimliğinizi kontrol etmek için terminalden tek bir istek yeterlidir:

```bash
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:

```bash
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:

```bash
# 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](https://opentelemetry.io/docs/zero-code/) bakın.

## Node.js

Kodunuzdan log göndermek için log SDK’sını kurun:

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

Uygulamanız başlarken bir kez kurun:

```js
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`](https://www.npmjs.com/package/pino-opentelemetry-transport) ve [`@opentelemetry/winston-transport`](https://www.npmjs.com/package/@opentelemetry/winston-transport) mevcut her log satırını olduğu gibi gönderir.

## Python

```bash
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:

```python
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:

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

| 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](#bir-test-logu-gönderin) JSON yapısını kontrol edin.             |
| `429`                       | Bu ayın veri kotası doldu. [Planlar ve sınırlar](https://instatus.com/help/tr/observability#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.

- [Loglar](https://instatus.com/help/tr/observability/logs): Loglarınızı arayın, filtreleyin ve canlı izleyin
- [İzler](https://instatus.com/help/tr/observability/traces): Her isteğin zamanını nerede harcadığını görün
