IBM Instana MCP Server

resmi

IBM Instana MCP sunucusu, IBM Instana gözlemlenebilirlik platformuyla sorunsuz etkileşim sağlayarak, geliştirme iş akışınız içinde doğrudan gerçek zamanlı gözlemlenebilirlik verilerine erişmenize olanak tanır.

GitHub

IBM Instana MCP ile neler yapabilirsiniz?

Altyapı anlık görüntülerini alın — Belirli bir ana bilgisayar, işlem veya kapsayıcının anlık görüntüsünü get_infra_snapshot kullanarak isteyin.
Uygulama veya hizmet metriklerini analiz edin — Çağrı, hata veya gecikme süresi için zaman serisi metriklerini get_app_metrics veya get_service_metrics ile talep edin.
Aktif uyarıları ve olayları listeleyin — Geçerli uyarıları, olayları veya global akıllı uyarıları get_alerts ve get_incidents aracılığıyla alın.
Kubernetes olaylarını inceleyin — Bir küme veya ad alanı için son Kubernetes olaylarını get_k8s_events ile çekin.
Web sitesi izleme verilerini sorgulayın — Web sitesi performans metriklerini veya işaretçi sonuçlarını get_website_metrics aracılığıyla getirin.

Dokümantasyon

İçindekiler

IBM Instana için MCP Sunucusu

IBM Instana için MCP Sunucusu

📚 Hızlı Bağlantılar

Araçlar ve Örnekler - Gerçek dünya örnekleriyle kapsamlı araç dokümantasyonu
Gizlilik Politikası - Veri işleme ve gizlilik bilgileri
Docker Dağıtım Kılavuzu - Kapsamlı Docker dağıtımı, çoklu mimari yapıları ve üretim ortamı kurulumu

Instana MCP sunucusu, Instana gözlemlenebilirlik platformuyla sorunsuz etkileşim sağlayarak, gerçek zamanlı gözlemlenebilirlik verilerine doğrudan geliştirme iş akışınız içinde erişmenize olanak tanır.

İstemciler (AI ajanları veya özel araçlar gibi) ile Instana REST API'leri arasında bir köprü görevi görerek, kullanıcı sorgularını Instana API isteklerine dönüştürür ve yanıtları yapılandırılmış, kolayca tüketilebilir formatlara dönüştürür.

Sunucu, farklı MCP istemcileriyle maksimum uyumluluk için hem Akışkan HTTP hem de Stdio aktarım modlarını destekler. Daha fazla ayrıntı için MCP Aktarım Modları belirtimine bakın.

Mimariye Genel Bakış

graph LR
    subgraph "Application Host Process"
        MH[MCP Host]
        MSI[Instana MCP Server]
        MST[ProductA MCP Server]
        MSC[ProductB MCP Server]

        MH <--> MSI
        MH <--> MSC
        MH <--> MST
    end

    subgraph "Remote Service"
        II[Instana Instance]
        TI[ProductA Instance]
        CI[ProductB Instance]

        MSI <--> II
        MST <--> TI
        MSC <--> CI
    end

    subgraph "LLM"
        L[LLM]
        MH <--> L
    end

İş Akışı

Basit bir örnek düşünün: Instana MCP Sunucusuna bağlı bir MCP Ana Bilgisayarı (Claude Desktop, VS Code veya başka bir istemci gibi) kullanıyorsunuz. Instana uyarıları hakkında bilgi istediğinizde aşağıdaki süreç gerçekleşir:

MCP istemcisi, Instana MCP sunucusundan kullanılabilir araçların listesini alır
Sorgunuz, araç açıklamalarıyla birlikte LLM'ye gönderilir
LLM, kullanılabilir araçları analiz eder ve Instana uyarılarını almak için uygun olan(lar)ı seçer
İstemci, seçilen araç(lar)ı Instana MCP sunucusu aracılığıyla yürütür
Sonuçlar (en son uyarılar) LLM'ye döndürülür
LLM, doğal dilde bir yanıt oluşturur
Yanıt size gösterilir

sequenceDiagram
    participant User
    participant ChatBot as MCP Host
    participant MCPClient as MCP Client
    participant MCPServer as Instana MCP Server
    participant LLM
    participant Instana as Instana Instance

    ChatBot->>MCPClient: Load available tools from MCP Server
    MCPClient->>MCPServer: Request available tool list
    MCPServer->>MCPClient: Return list of available tools
    User->>ChatBot: Ask "Show me the latest alerts from Instana for application robot-shop"
    ChatBot->>MCPClient: Forward query
    MCPClient->>LLM: Send query and tool description
    LLM->>MCPClient: Select appropriate tool(s) for Instana alert query
    MCPClient->>MCPServer: Execute selected tool(s)
    MCPServer->>Instana: Retrieve alerts for application robot-shop
    MCPServer->>MCPClient: Send alerts of Instana result
    MCPClient->>LLM: Forward alerts of Instana
    LLM->>ChatBot: Generate natural language response for Instana alerts
    ChatBot->>User: Show Instana alert response

Ön Koşullar

Seçenek 1: PyPI'den Kurulum (Önerilen)

mcp-instana'yı kullanmanın en kolay yolu, doğrudan PyPI'den kurmaktır:

pip install mcp-instana

Kurulumdan sonra, sunucuyu doğrudan mcp-instana komutunu kullanarak çalıştırabilirsiniz.

Seçenek 2: Geliştirme Kurulumu

Geliştirme veya yerel özelleştirme için projeyi klonlayabilir ve yerel olarak kurabilirsiniz.

uv'nin Kurulumu

Bu proje, hızlı bir Python paket yükleyici ve çözümleyici olan uv kullanır. uv'yi kurmak için birkaç seçeneğiniz vardır:

pip kullanarak:

pip install uv

Homebrew kullanarak (macOS):

brew install uv

Daha fazla kurulum seçeneği ve ayrıntılı talimatlar için uv dokümantasyonunu ziyaret edin.

Ortamın Hazırlanması

uv'yi kurduktan sonra, aşağıdakini çalıştırarak proje ortamını hazırlayın:

uv sync

Akışkan HTTP Modu için Başlık Tabanlı Kimlik Doğrulama

Akışkan HTTP modunu kullanırken, Instana kimlik bilgilerini HTTP başlıkları aracılığıyla iletmeniz gerekir. Bu yaklaşım aşağıdakileri sağlayarak güvenliği ve esnekliği artırır:

Kimlik bilgilerinin ortam değişkenlerinde saklanmasını önleme
Farklı istekler için farklı kimlik bilgilerinin kullanılmasını sağlama
Ortam değişkeni değişikliğinin kısıtlandığı paylaşımlı ortamları destekleme
Hem API anahtarı hem de oturum tabanlı kimlik doğrulamayı destekleme

Desteklenen Kimlik Doğrulama Modları:

1. API Anahtarı Kimlik Doğrulaması (Doğrudan API Çağrıları)

Gerekli Başlıklar:

instana-base-url: Instana örneğinizin URL'si
instana-api-token: Instana API anahtarınız

Örnek:

--header "instana-base-url: https://your-instance.instana.io"
--header "instana-api-token: your-api-token"

2. Oturum Anahtarı Kimlik Doğrulaması (Kullanıcı Arayüzü Başlatmalı Çağrılar)

Gerekli Başlıklar:

instana-base-url: Instana örneğinizin URL'si
instana-auth-token: Kullanıcı arayüzü arka ucundan oturum kimlik doğrulama anahtarı
instana-csrf-token: Kullanıcı arayüzü arka ucundan CSRF anahtarı
instana-cookie-name: (İsteğe bağlı) Oturum kimlik doğrulaması için çerez adı (varsayılan: instanaAuthToken)

Örnek:

--header "instana-base-url: https://your-instance.instana.io"
--header "instana-auth-token: your-session-token"
--header "instana-csrf-token: your-csrf-token"
--header "instana-cookie-name: in-token"

3. JWT Anahtarı Kimlik Doğrulaması (IBM Platform Entegrasyonu)

Gerekli Başlıklar:

instana-base-url: Instana örneğinizin URL'si
instana-jwt-token: IBM Platformundan JWT anahtarı
instana-csrf-token: İstek doğrulaması için CSRF anahtarı

Örnek Yapılandırma:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://0.0.0.0:8080/mcp",
        "--allow-http",
        "--header",
        "instana-base-url: https://your-instana-instance.instana.io",
        "--header",
        "instana-jwt-token: your_jwt_token_here",
        "--header",
        "instana-csrf-token: your_csrf_token_here"
      ]
    }
  }
}

Kimlik Doğrulama Önceliği:

JWT Anahtarı (CSRF anahtarı ile sağlanmışsa) - IBM Platform entegrasyonu için önceliklidir
Oturum Anahtarları (hem auth_token hem de csrf_token sağlanmışsa)
API Anahtarı (sağlanmışsa) - Standart kimlik doğrulama
Ortam Değişkeni (INSTANA_API_TOKEN) - Yedek

Kimlik Doğrulama Akışı:

HTTP başlıkları her istekte bulunmalıdır
Sunucu, kimlik bilgilerini öncelik sırasına göre doğrular
Geçerli kimlik doğrulaması olmayan istekler başarısız olur

Bu tasarım, güvenli kimlik bilgisi iletimini sağlar ve WebSocket → Koordinatör → MCP Sunucusu üzerinden kullanıcı arayüzü başlatmalı çağrılar dahil olmak üzere birden fazla kimlik doğrulama akışını destekler.

Kullanılan anahtarın MCP araçlarını çağırmak için gerekli izinlere sahip olduğundan emin olun. Daha fazla bilgi için buraya bakın.

Yerel MCP Sunucusunu Başlatma

Herhangi bir MCP istemcisini (Claude Desktop, GitHub Copilot veya özel MCP istemcileri) yapılandırmadan önce, yerel MCP sunucusunu başlatmanız gerekir. Sunucu iki aktarım modunu destekler: Akışkan HTTP ve Stdio.

Sunucu Komut Seçenekleri

CLI Kullanımı (PyPI Kurulumu)

mcp-instana'yı PyPI'den kurduysanız, mcp-instana komutunu kullanın:

mcp-instana [OPTIONS]

Geliştirme Kurulumu Kullanımı

Yerel geliştirme için uv run komutunu kullanın:

uv run src/core/server.py [OPTIONS]

Kullanılabilir Seçenekler:

--transport <mode>: Aktarım modu (seçenekler: streamable-http, stdio)
--env KEY=VALUE: Ortam değişkeni ayarla (birden fazla değişken için tekrarlanabilir, örn. --env INSTANA_BASE_URL=https://... --env INSTANA_API_TOKEN=...)
--debug: Ek günlükleme ile hata ayıklama modunu etkinleştir
--log-level <level>: Günlükleme seviyesini ayarla (seçenekler: DEBUG, INFO, WARNING, ERROR, CRITICAL)
--tools <categories>: Etkinleştirilecek araç kategorilerinin virgülle ayrılmış listesi (örn. infra,app,events,website). Bir kategoriyi etkinleştirmek, ilgili istemleri de etkinleştirecektir. Örneğin: --tools infra, infra araçlarını ve tüm infra ile ilgili istemleri etkinleştirir.
--list-tools: Tüm kullanılabilir araç kategorilerini listele ve çık
--port <port>: MCP sunucu bağlantı noktası (varsayılan: 8080, PORT ortam değişkeni ile geçersiz kılınabilir)
--help: Yardım mesajını göster ve çık

Akışkan HTTP Modunda Başlatma

Akışkan HTTP modu bir REST API arayüzü sağlar ve çoğu kullanım durumu için önerilir.

CLI Kullanımı (PyPI Kurulumu)

# Start with all tools enabled (default)
mcp-instana --transport streamable-http

# Start with debug logging
mcp-instana --transport streamable-http --debug

# Start with a specific log level
mcp-instana --transport streamable-http --log-level WARNING

# Start with specific tool categories only
mcp-instana --transport streamable-http --tools infra,events

# Combine options (specific log level, custom tools)
mcp-instana --transport streamable-http --log-level DEBUG --tools app,events

Geliştirme Kurulumu Kullanımı

# Start with all tools enabled (default)
uv run src/core/server.py --transport streamable-http

# Start with debug logging
uv run src/core/server.py --transport streamable-http --debug

# Start with a specific log level
uv run src/core/server.py --transport streamable-http --log-level WARNING

# Start with specific tool and prompts categories only
uv run src/core/server.py --transport streamable-http --tools infra,events

# Start with custom port
uv run src/core/server.py --transport streamable-http --port 9000

# Combine options (specific log level, custom tools and prompts)
uv run src/core/server.py --transport streamable-http --log-level DEBUG --tools app,events

Akışkan HTTP Modunun Temel Özellikleri:

Kimlik doğrulama için HTTP başlıklarını kullanır (ortam değişkenlerine gerek yoktur)
İstek başına farklı kimlik bilgilerini destekler
Paylaşımlı ortamlar için daha uygundur
MCP sunucu varsayılan bağlantı noktası: 8080
MCP uç noktası: http://0.0.0.0:8080/mcp/

Stdio Modunda Başlatma

Stdio modu iletişim için standart giriş/çıkış kullanır ve kimlik doğrulama için ortam değişkenleri gerektirir.

CLI Kullanımı (PyPI Kurulumu)

# Option 1: Set environment variables first
export INSTANA_BASE_URL="https://your-instana-instance.instana.io"
export INSTANA_API_TOKEN="your_instana_api_token"

# Start the server (stdio is the default if no transport specified)
mcp-instana

# Or explicitly specify stdio mode
mcp-instana --transport stdio

# Option 2: Use --env flag to set environment variables directly
mcp-instana --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

# Or with explicit stdio mode
mcp-instana --transport stdio --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

Geliştirme Kurulumu Kullanımı

# Option 1: Set environment variables first
export INSTANA_BASE_URL="https://your-instana-instance.instana.io"
export INSTANA_API_TOKEN="your_instana_api_token"

# Start the server (stdio is the default if no transport specified)
uv run src/core/server.py

# Or explicitly specify stdio mode
uv run src/core/server.py --transport stdio

# Option 2: Use --env flag to set environment variables directly
uv run src/core/server.py --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

# Or with explicit stdio mode
uv run src/core/server.py --transport stdio --env INSTANA_BASE_URL=https://your-instana-instance.instana.io --env INSTANA_API_TOKEN=your_instana_api_token

Stdio Modunun Temel Özellikleri:

Kimlik doğrulama için ortam değişkenlerini kullanır (export veya --env bayrağı ile ayarlanabilir)
stdin/stdout üzerinden doğrudan iletişim
Belirli MCP istemci yapılandırmaları için gereklidir
--env bayrağı, kabuk ortamını değiştirmeden kimlik bilgilerini ayarlamak için uygun bir yol sağlar

Araç Kategorileri

Yalnızca ihtiyacınız olan araç ve istem kategorilerini etkinleştirerek sunucu performansını optimize edebilirsiniz:

CLI Kullanımı (PyPI Kurulumu)

# List all available categories
mcp-instana --list-tools

# Enable specific categories
mcp-instana --transport streamable-http --tools infra,app
mcp-instana --transport streamable-http --tools events

Geliştirme Kurulumu Kullanımı

# List all available categories
uv run src/core/server.py --list-tools

# Enable specific categories
uv run src/core/server.py --transport streamable-http --tools infra,app
uv run src/core/server.py --transport streamable-http --tools events

Kullanılabilir Kategoriler:

infra: Altyapı izleme araçları ve istemleri (kaynaklar, katalog, topoloji, analiz, metrikler)
app: Uygulama performansı araçları ve istemleri (kaynaklar, metrikler, uyarılar, katalog, topoloji, analiz, ayarlar, genel uyarılar)
events: Olay izleme araçları ve istemleri (Kubernetes olayları, ajan izleme)
website: Web sitesi izleme araçları ve istemleri (metrikler, katalog, analiz, yapılandırma)

Sunucu Durumunu Doğrulama

Başlatıldıktan sonra sunucunun çalıştığını doğrulayabilirsiniz:

Akışkan HTTP modu için:

# Check MCP server
curl http://0.0.0.0:8080/mcp/

# Or with custom port
curl http://0.0.0.0:9000/mcp/

Stdio modu için: Sunucu başlayacak ve MCP istemcilerinden stdin girişini bekleyecektir.

Sık Karşılaşılan Başlatma Sorunları

Sertifika Sorunları: SSL sertifika hatalarıyla karşılaşırsanız, Python ortamınızın sistem sertifikalarına erişimi olduğundan emin olun:

# macOS - Install certificates for Python
/Applications/Python\ 3.13/Install\ Certificates.command

Bağlantı Noktası Zaten Kullanımda: 8080 bağlantı noktası zaten kullanılıyorsa, farklı bir bağlantı noktası belirtin:

uv run src/core/server.py --transport streamable-http --port 9000

Eksik Bağımlılıklar: Tüm bağımlılıkların kurulu olduğundan emin olun:

uv sync

Kurulum ve Kullanım

Bob IDE

Bob, MCP entegrasyonunu yerel olarak destekleyen IBM'in yapay zeka destekli IDE'sidir. Bob, yerleşik yapay zeka yardımı ve gözlemlenebilirlik araçlarıyla sorunsuz bir geliştirme deneyimi sunar.

Akışkan HTTP Modu

Akışkan HTTP modu, HTTP üzerinden JSON-RPC kullanarak MCP iletişimi için bir REST API arayüzü sağlar.

Adım 1: MCP Sunucusunu Akışkan HTTP Modunda Başlatın

Bob'u yapılandırmadan önce, MCP sunucusunu Akışkan HTTP modunda başlatmanız gerekir. Ayrıntılı talimatlar için lütfen Yerel MCP Sunucusunu Başlatma bölümüne bakın.

Adım 2: Bob'u Yapılandırın

Bob panelinin sağ üst köşesinde, MCP sunucularının bulunduğu bir açılır menü göreceksiniz:

Bunu seçtiğinizde, MCP'yi proje düzeyinde veya genel düzeyde yapılandırma seçeneğini görebilmeniz gerekir.

MCP Yapılandırma Kapsamları

Bob, kullanım durumunuza en uygun kapsamı seçmenize olanak tanıyan iki MCP yapılandırma düzeyini destekler:

1. Genel Yapılandırma (Kullanıcı Düzeyi)

Genel yapılandırma, MCP sunucularını mevcut kullanıcı için tüm projelerde uygular. Bu, üzerinde çalıştığınız her projede aynı MCP sunucularının kullanılabilir olmasını istediğinizde idealdir.

Dosya Konumları:

macOS: ~/Library/Application Support/Bob/bob_config.json
Windows: %APPDATA%\Bob\bob_config.json
Linux: ~/.config/Bob/bob_config.json

2. Proje Yapılandırması (Proje Düzeyi)

Proje yapılandırması, MCP sunucularını yalnızca belirli bir projeye uygular. Bu, farklı projeler farklı MCP sunucu yapılandırmaları gerektirdiğinde veya MCP ayarlarını sürüm kontrolü aracılığıyla ekibinizle paylaşmak istediğinizde kullanışlıdır.

Dosya Konumu:

Proje kök dizininizdeki .bob/bob_config.json

Genel ve Proje Yapılandırması Arasında Seçim Yapma:

Tüm projelerinizde kullanılabilir olmasını istediğiniz MCP sunucuları için genel yapılandırmayı kullanın
Projeye özgü MCP sunucuları veya yapılandırmaları ekibinizle paylaşmak için proje yapılandırmasını kullanın
Her iki yapılandırma bir arada bulunabilir - aynı sunucu adı için proje düzeyindeki ayarlar genel ayarlara göre önceliklidir

Bob ve MCP yapılandırması hakkında daha fazla bilgi için şu adresi ziyaret edin: https://bob.ibm.com/docs/ide/configuration/mcp/mcp-in-bob

Yerel Yapılandırma:

Bob'u yerel Instana MCP sunucunuza bağlanacak şekilde yapılandırın:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

Uzak Yapılandırma:

Bob'u uzak bir Instana MCP sunucusuna (örneğin, IBM Code Engine'de dağıtılmış) bağlanacak şekilde yapılandırın:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "https://app-instana-750.1zetetanw8ul.us-east.codeengine.appdomain.cloud/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

Not: npx kullanmak için önce NVM'yi (Node Version Manager) yüklemenizi, ardından Node.js'i yüklemek için onu kullanmanızı öneririz. Kurulum talimatları şu adreste mevcuttur: https://nodejs.org/en/download

Adım 3: Bağlantıyı Test Edin

MCP yapılandırmasını ayarladıktan sonra, yeni yapılandırılan MCP sunucusu etkin olarak görünmelidir. Yeşil bir nokta, sunucunun başarıyla çalıştığını gösterir.

Artık Bob IDE'de sorgular çalıştırabilirsiniz:

get me all applications from Instana in the last 24 hours

Stdio Modu

CLI Kullanarak Yapılandırma (PyPI Kurulumu - Önerilir):

Seçenek 1: Yapılandırmada ortam değişkenlerini kullanma:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

Seçenek 2: --env bayrağını kullanma (alternatif yöntem):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Not: "command not found" hatalarıyla karşılaşırsanız, mcp-instana'nın tam yolunu kullanın. which mcp-instana ile bulun ve bunun yerine bu yolu kullanın.

Geliştirme Kurulumu Kullanarak Yapılandırma:

Seçenek 1: Yapılandırmada ortam değişkenlerini kullanma:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py"
      ],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

Seçenek 2: --env bayrağını kullanma (alternatif yöntem):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Claude Desktop

Claude Desktop, MCP entegrasyonu için hem Akışkan HTTP hem de Stdio modlarını destekler.

Claude Desktop'ı yapılandırma dosyasını düzenleyerek yapılandırın:

Dosya Konumları:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Akışkan HTTP Modu

Akışkan HTTP modu, HTTP üzerinden JSON-RPC kullanarak MCP iletişimi için bir REST API arayüzü sağlar.

Adım 1: MCP Sunucusunu Akışkan HTTP Modunda Başlatın

Claude Desktop'ı yapılandırmadan önce, MCP sunucusunu Akışkan HTTP modunda başlatmanız gerekir. Ayrıntılı talimatlar için lütfen Yerel MCP Sunucusunu Başlatma bölümüne bakın.

Adım 2: Claude Desktop'ı Yapılandırın

Claude Desktop'ı Instana kimlik bilgilerini başlıklar aracılığıyla iletecek şekilde yapılandırın:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

Adım 3: Bağlantıyı Test Edin

Claude Desktop'ı yeniden başlatın. Artık Instana MCP Sunucusunu aşağıda gösterildiği gibi Claude Desktop arayüzünde görmelisiniz:

Artık Claude Desktop'ta sorgular çalıştırabilirsiniz:

get me all endpoints from Instana

Stdio Modu

CLI Kullanarak Yapılandırma (PyPI Kurulumu - Önerilir):

Seçenek 1: Yapılandırmada ortam değişkenlerini kullanma:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

Seçenek 2: --env bayrağını kullanma (alternatif yöntem):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Not: "command not found" hatalarıyla karşılaşırsanız, mcp-instana'nın tam yolunu kullanın. which mcp-instana ile bulun ve bunun yerine bu yolu kullanın.

Geliştirme Kurulumu Kullanarak Yapılandırma:

Seçenek 1: Yapılandırmada ortam değişkenlerini kullanma:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py"
      ],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

Seçenek 2: --env bayrağını kullanma (alternatif yöntem):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-mcp-instana-folder>",
        "run",
        "src/core/server.py",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Kiro Kurulumu

Kiro, VS Code veya başka bir IDE'ye indirilebilen bir uzantı değil, etmen tabanlı bir IDE'dir.

Adım 1: https://kiro.dev/. adresinden işletim sisteminiz için Kiro'yu indirin ve yükleyin**

Adım 2: Kurulumdan sonra Kiro'yu başlatın ve IDE'de herhangi bir projeyi açın. alt text

Adım 3: Kiro'nun özelliklerine erişmek için sol kenar çubuğundaki Kiro (Hayalet) simgesine tıklayın. alt text

Adım 4: MCP Sunucuları bölümünün sağ üst köşesindeki Yapılandırmayı Düzenle simgesini seçin. alt text

Adım 5: MCP sunucu yapılandırma dosyasını (mcp.json) açın ve tercih ettiğiniz aktarım moduna göre yapılandırın:

Akışkan HTTP Modu (Kiro için Önerilir)

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ]
    }
  }
}

Not: Bu yapılandırmayı kullanmadan önce MCP sunucusunu streamable-http modunda başlattığınızdan emin olun:

mcp-instana --transport streamable-http

Stdio Modu

Seçenek 1: Yapılandırmada ortam değişkenlerini kullanma:

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

Seçenek 2: --env bayrağını kullanma (alternatif yöntem):

{
  "mcpServers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Adım 6: Dosyayı kaydettikten sonra, MCP'yi Etkinleştir düğmesine tıklayın; MCP sunucunuzun ve kullanılabilir araçlarının Kiro'nun sol alt bölümünde göründüğünü göreceksiniz. alt text

Adım 7: AI Sohbet paneline gidin, MCP sunucunuzla ilgili bir istem girin ve yanıtı doğrudan Kiro içinde görüntüleyin. alt text

GitHub Copilot

GitHub Copilot, VS Code yapılandırması aracılığıyla MCP entegrasyonunu destekler. GitHub Copilot'ın VS Code ile entegrasyonu için bu kurulum kılavuzuna bakın.

Akışkan HTTP Modu

Adım 1: MCP Sunucusunu Akışkan HTTP Modunda Başlatın

VS Code'u yapılandırmadan önce, MCP sunucusunu Akışkan HTTP modunda başlatmanız gerekir. Ayrıntılı talimatlar için lütfen Yerel MCP Sunucusunu Başlatma bölümüne bakın.

Adım 2: VS Code'u Yapılandırın

Ayrıntılı yapılandırma için VS Code'da MCP sunucularını kullanma bölümüne bakın.

Aşağıdaki yapılandırmayla doğrudan .vscode/mcp.json oluşturabilir veya güncelleyebilirsiniz:

{
  "servers": {
    "Instana MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://0.0.0.0:8080/mcp/",
        "--allow-http",
        "--header", "instana-base-url: https://your-instana-instance.instana.io",
        "--header", "instana-api-token: your_instana_api_token"
      ],
      "env": {
        "PATH": "/usr/local/bin:/bin:/usr/bin",
        "SHELL": "/bin/sh"
      }
    }
  }
}

Not: Aşağıdaki değerleri gerçek yapılandırmanızla değiştirin:

instana-base-url: Instana örnek URL'niz
instana-api-token: Instana API belirteciniz
command: npx yolunu sisteminizin Node.js kurulumuyla eşleşecek şekilde güncelleyin (örneğin, /path/to/your/node/bin/npx)
Ortam değişkenleri: PATH ve diğer ortam değişkenlerini sisteminiz için gerektiği gibi ayarlayın

Stdio Modu

Adım 1: VS Code MCP Yapılandırması Oluşturun

CLI Kullanarak (PyPI Kurulumu - Önerilir):

Proje kökünüzde .vscode/mcp.json oluşturun:

Seçenek 1: Yapılandırmada ortam değişkenlerini kullanma:

{
  "servers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": ["--transport", "stdio"],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

Seçenek 2: --env bayrağını kullanma (alternatif yöntem):

{
  "servers": {
    "Instana MCP Server": {
      "command": "mcp-instana",
      "args": [
        "--transport", "stdio",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Geliştirme Kurulumu Kullanarak:

Proje kökünüzde .vscode/mcp.json oluşturun:

Seçenek 1: Yapılandırmada ortam değişkenlerini kullanma:

{
  "servers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/project/mcp-instana",
        "run",
        "src/core/server.py"
      ],
      "env": {
        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
        "INSTANA_API_TOKEN": "your_instana_api_token"
      }
    }
  }
}

Seçenek 2: --env bayrağını kullanma (alternatif yöntem):

{
  "servers": {
    "Instana MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/project/mcp-instana",
        "run",
        "src/core/server.py",
        "--env", "INSTANA_BASE_URL=https://your-instana-instance.instana.io",
        "--env", "INSTANA_API_TOKEN=your_instana_api_token"
      ]
    }
  }
}

Not: Aşağıdaki değerleri gerçek yapılandırmanızla değiştirin:

CLI kurulumu için: mcp-instana öğesinin PATH'inizde olduğundan emin olun
Geliştirme kurulumu için:
- command: uv yolunu sisteminizin uv kurulumuyla eşleşecek şekilde güncelleyin (örneğin, /path/to/your/uv/bin/uv veya /usr/local/bin/uv)
- --directory: mcp-instana proje dizininizin mutlak yoluyla güncelleyin
INSTANA_BASE_URL: Instana örnek URL'niz
INSTANA_API_TOKEN: Instana API belirteciniz

Adım 2: VS Code'da Sunucuyu Yönetin

.vscode/mcp.json öğesini açın - üstte sunucu yönetim kontrollerini göreceksiniz
Sunucuyu başlatmak için Instana MCP Server yanındaki Start öğesine tıklayın
Araç sayısıyla birlikte çalışma durumu, sunucunun çalıştığını gösterir

Adım 3: Entegrasyonu Test Edin

GitHub Copilot'ta Etmen Moduna geçin ve araçları yeniden yükleyin. İşte bir GitHub Copilot yanıtı örneği:

GitHub Copilot Response

Mistral AI

Mistral AI, MCP entegrasyonunu yalnızca Akışkan HTTP modu aracılığıyla destekler.

Adım 1: MCP Sunucusunu Akışkan HTTP Modunda Başlatın

Instana kimlik bilgilerinizi sağlayarak MCP sunucusunu Akışkan HTTP modunda başlatın. Aşağıdaki komutu çalıştırın:

uv run src/core/server.py --transport streamable-http \
  --api-token "your_instana_api_token" \
  --base-url "https://your-instana-instance.instana.io" \
  --port 8080

Adım 2: Ngrok ile Bağlantı Noktası Yönlendirmeyi Ayarlayın

Yerel sunucunuzu açığa çıkarmak için bağlantı noktası yönlendirmeyi yapılandırın. Ayrıntılı talimatlar için Ngrok kurulum belgelerini izleyin.

Adım 3: Mistral AI'ı Yapılandırın

Sol kenar çubuğundaki Intelligence sekmesine gidin ve Connectors öğesini seçin
Add Connector öğesine tıklayın
Bir bağlayıcı adı ve Ngrok ile yönlendirilmiş MCP sunucu URL'sini girerek özel bir bağlayıcı oluşturun
Yeni bir sohbet oturumu başlatın ve MCP araçlarının etkin olduğunu doğrulayın. Yanıtı burada görüntüleyebilirsiniz

Desteklenen Özellikler

Mevcut Araçlar

Araç	Kategori	Açıklama
`manage_applications`	Uygulama ve Altyapı	Uygulama metriklerini, uyarı yapılandırmalarını, ayarları ve kataloğu yönetmek için birleşik araç
`manage_websites`	Web Sitesi İzleme	Web sitesi analizi, katalog, yapılandırma ve gelişmiş yapılandırma işlemleri için birleşik akıllı yönlendirici
`manage_custom_dashboards`	Özel Panolar	Özel pano CRUD işlemlerini yönetmek için birleşik araç
`analyze_infrastructure`	Altyapı Analizi	Varlık/metrik çıkarımı ile iki aşamalı altyapı analizi
`manage_automation`	Otomasyon	Otomasyon için birleşik akıllı yönlendirici: eylem kataloğuna göz atma ve yürütme geçmişini görüntüleme
`manage_events`	Olaylar	Olay izleme için birleşik akıllı yönlendirici: kimliğe göre olay alma, kimliklere göre olayları alma, Kubernetes olayları, ajan izleme olayları ve tüm olaylar
`manage_slo`	SLO Yönetimi	Akıllı saat dilimi işleme ile SLO yapılandırmaları, raporları, uyarıları ve düzeltme pencereleri için birleşik akıllı yönlendirici
`manage_releases`	Sürüm Yönetimi	Sürüm takibi için birleşik akıllı yönlendirici: sayfalandırma ve ad filtreleme ile sürümleri listeleme, sürüm detaylarını alma, saat dilimi desteği ile sürüm oluşturma/güncelleme/silme
`manage_maintenance_windows`	Bakım Pencereleri	Bakım penceresi yaşam döngüsü yönetimi için birleşik akıllı yönlendirici: şablon desteği ve ServiceNow entegrasyonu ile bakım pencerelerini oluşturma, değiştirme, kapatma ve listeleme
`manage_mobile_apps`	Mobil Uygulama İzleme	Mobil uygulama izleme için birleşik akıllı yönlendirici: işaretleri, performans metriklerini, yapılandırmayı ve uyarı yönetimini analiz etme

👉 Detaylı araç dokümantasyonu, yetenekler ve teknik referans için bkz. Araçlar ve Örnekler

Araç Filtreleme

MCP sunucusu, performansı optimize etmek ve kaynak kullanımını azaltmak için seçici araç yüklemeyi destekler. Özel kullanım durumunuz için yalnızca ihtiyacınız olan araç kategorilerini etkinleştirebilirsiniz.

Mevcut Araç Kategorileri

router: Birleşik uygulama ve altyapı yönetimi
- manage_instana_resources: Uygulama metrikleri, uyarı yapılandırmaları, ayarlar ve katalog için tek araç
- Uygulama perspektiflerini, uç noktaları, servisleri ve manuel servisleri destekler
- Hem uygulamaya özel hem de genel uyarı yapılandırmalarını yönetir
- Uygulama etiket kataloğuna ve metrik kataloğuna erişim sağlar
dashboard: Özel pano yönetimi
- manage_custom_dashboards: Özel panolar için CRUD işlemleri
- Pano oluşturma, alma, güncelleme ve silmeyi destekler
- Panolar için paylaşılabilir kullanıcıları ve API belirteçlerini yönetir
infra: Altyapı analiz araçları
- analyze_infrastructure: Varlık/metrik çıkarımı ile iki aşamalı altyapı analizi
- Instana kurulumunuzda mevcut olan tüm varlık türlerini dinamik olarak destekler (API kataloğundan otomatik olarak yüklenir)
- JVM, Kubernetes, Docker, ana bilgisayarlar, veritabanları, mesaj kuyrukları ve herhangi bir özel veya yeni eklenen varlık türünü içerir
- Esnek metrik toplama, filtreleme, gruplama ve zaman aralığı sorguları
automation: Otomasyon eylem araçları
- manage_automation: Otomasyon kataloğu ve yürütme geçmişi için birleşik akıllı yönlendirici
- Eylem Kataloğu: eylemlere göz atma, detayları alma, ada/açıklamaya göre arama, uygulama veya anlık görüntü kimliğine göre filtreleme
- Eylem Geçmişi: filtreleme ile yürütme örneklerini listeleme, yürütme detaylarını alma
events: Olay izleme araçları
- Olaylar: Kubernetes olayları, ajan izleme ve sistem olay takibi
website: Web sitesi izleme araçları
- Web Sitesi Metrikleri: Web siteleri için performans ölçümü
- Web Sitesi Kataloğu: Web sitesi meta verileri ve tanımları
- Web Sitesi Analizi: Web sitesi performans analizi
- Web Sitesi Yapılandırması: Web sitesi yapılandırma yönetimi
slo: Hizmet Seviyesi Hedefi (SLO) yönetimi
- manage_slo: Kapsamlı SLO işlemleri için birleşik akıllı yönlendirici
- Yapılandırma Yönetimi: Zamana dayalı ve olaya dayalı göstergeler desteği ile SLO yapılandırmalarını oluşturma, okuma, güncelleme, silme
- Rapor Oluşturma: SLI değerleri, hata bütçeleri, tükenme oranları ve zaman serisi grafikleri ile detaylı SLO raporları oluşturma
- Uyarı Yapılandırması: Hata bütçesi izleme ve tükenme oranı takibi için SLO uyarı yapılandırmalarını yönetme
- Düzeltme Pencereleri: Planlı kesintileri SLO hesaplamalarından hariç tutmak için bakım pencereleri oluşturma ve yönetme
- Akıllı Saat Dilimi İşleme: Doğru zaman bağlamı sağlamak için tarih/saat girişlerinde otomatik saat dilimi çıkarımı
- İki Aşamalı Çıkarım: Birden çok girdi gerektiren karmaşık işlemler için etkileşimli parametre toplama
releases: Sürüm takibi ve dağıtım yönetimi
- manage_releases: Sürüm işlemleri için birleşik akıllı yönlendirici
- Sürümleri Listeleme: Verimli sayfalandırma (page_number, page_size) ve ada dayalı filtreleme ile tüm sürümleri alma
- Sürüm Detayları: Uygulamalar, servisler ve kapsamlar dahil olmak üzere kimliğe göre belirli sürüm bilgilerini alma
- Oluşturma/Güncelleme/Silme: Sürüm yönetimi için tam CRUD işlemleri
- Akıllı Saat Dilimi İşleme: Sürüm başlangıç zamanları için otomatik saat dilimi çıkarımı
- Verimli Sayfalandırma: Uygun sayfa tabanlı gezinme ile gereksiz veri alımını önleme
- Ad Filtreleme: Ada göre sürümleri bulmak için büyük/küçük harf duyarsız alt dize eşleştirme
maintenance_window: Bakım penceresi yaşam döngüsü yönetimi
- manage_maintenance_windows: Bakım penceresi işlemleri için birleşik akıllı yönlendirici
- Pencere İşlemleri: Bakım pencerelerini oluşturma, değiştirme, kapatma ve listeleme (aktif, planlanmış, tümü, süresi dolmuş)
- Toplu İşlemler: Aynı anda birden çok uygulama için bakım pencereleri oluşturma
- Şablon Desteği: Yaygın senaryolar için önceden tanımlanmış şablonlar (dağıtım, veritabanı_geçişi, altyapı_yükseltme, acil_durum, rutin)
- Yinelenen Pencereler: RFC 5545 RRULE formatını kullanarak yinelenen bakım pencereleri desteği
- ServiceNow Entegrasyonu: ServiceNow değişiklik talepleri ile isteğe bağlı entegrasyon
- Doğrulama: Pencere oluşturmadan önce parametre doğrulama
- Esnek Süre: Dakika, saat veya gün cinsinden süre belirtme
mobile_app: Mobil uygulama izleme
- manage_mobile_apps: Mobil uygulama izleme operasyonları için birleşik akıllı yönlendirici
- Beacon Analizi: Mobil uygulama beacon verilerini gruplama ve filtreleme ile sorgulama
- Performans Metrikleri: Oturum süresi, çökme oranları ve HTTP istek performansını takip etme
- Coğrafi Analiz: Kullanıcı dağılımını ülke, şehir ve bölge bazında analiz etme
- Cihaz Analizi: Farklı cihazlar, platformlar ve işletim sistemi sürümleri arasında performansı izleme
- Yapılandırma Yönetimi: Mobil uygulama yapılandırmalarını, coğrafi konum ve IP maskeleme ayarlarını yönetme
- Uyarı Yönetimi: Mobil uygulama uyarı yapılandırmalarını yapılandırma ve yönetme

Kullanım Örnekleri

CLI Kullanımı (PyPI Kurulumu)

# Enable only router (unified app/infra management) and events tools
mcp-instana --tools router,events --transport streamable-http

# Enable only infrastructure analysis tools
mcp-instana --tools infra --transport streamable-http

# Enable router and infrastructure analysis
mcp-instana --tools router,infra --transport streamable-http

# Enable events and website tools
mcp-instana --tools events,website --transport streamable-http

# Enable dashboard and router tools
mcp-instana --tools dashboard,router --transport streamable-http

# Enable releases and events tools
mcp-instana --tools releases,events --transport streamable-http

# Enable maintenance window and events tools
mcp-instana --tools maintenance_window,events --transport streamable-http

# Enable all tools (default behavior)
mcp-instana --transport streamable-http

# List all available tool categories and their tools
mcp-instana --list-tools

Geliştirme Kurulumu Kullanımı

# Enable only router (unified app/infra management) and events tools
uv run src/core/server.py --tools router,events --transport streamable-http

# Enable only infrastructure analysis tools
uv run src/core/server.py --tools infra --transport streamable-http

# Enable router and infrastructure analysis
uv run src/core/server.py --tools router,infra --transport streamable-http

# Enable events and website tools
uv run src/core/server.py --tools events,website --transport streamable-http

# Enable dashboard and router tools
uv run src/core/server.py --tools dashboard,router --transport streamable-http

# Enable releases and events tools
uv run src/core/server.py --tools releases,events --transport streamable-http

# Enable maintenance window and events tools
uv run src/core/server.py --tools maintenance_window,events --transport streamable-http

# Enable all tools (default behavior)
uv run src/core/server.py --transport streamable-http

# List all available tool categories and their tools
uv run src/core/server.py --list-tools

Araç Filtrelemenin Faydaları

Performans: Azaltılmış başlangıç süresi ve bellek kullanımı
Güvenlik: Yalnızca gerekli API'lere erişimi sınırlama
Netlik: Belirli kullanım durumlarına odaklanma (ör. yalnızca altyapı izleme)
Kaynak Verimliliği: Daha düşük CPU ve ağ kullanımı

👉 Kullanım örnekleri ve istemler için Örnek İstemler sayfasına bakın

Docker Dağıtımı

MCP Instana sunucusu, üretim ortamları için Docker kullanılarak dağıtılabilir. Docker kurulumu güvenlik, performans ve minimum kaynak kullanımı için optimize edilmiştir.

Docker Mimarisi

Proje iki dosyalı bağımlılık yönetimi stratejisi kullanır:

pyproject.toml

Amaç: Hem geliştirme hem de üretim için birleşik yapılandırma
Bağımlılıklar: İsteğe bağlı geliştirme bağımlılıklarıyla birlikte tüm temel bağımlılıklar
Kullanım: Yerel geliştirme, test, CI/CD ve Docker üretim yapıları
Faydalar: Tüm bağımlılıklar için tek doğruluk kaynağı, basitleştirilmiş bakım

Docker İmajı Oluşturma

Ön Koşullar

Docker kurulu ve çalışıyor olmalı
Proje kaynak koduna erişim
Çoklu mimari yapılar için Docker BuildKit (yeni Docker sürümlerinde varsayılan olarak etkindir)

Derleme Komutu

# Build the optimized production image
docker build -t mcp-instana:latest .

# Build with a specific tag
docker build -t mcp-instana:<image_tag> .

#### **Run Command**
# Run the container (no credentials needed in the container)
docker run -p 8080:8080 mcp-instana

# Run with custom port
docker run -p 8081:8080 mcp-instana

📖 Çoklu mimari yapılar, Docker Compose kurulumu, güvenlik en iyi uygulamaları ve üretim dağıtım örnekleri dahil kapsamlı Docker belgeleri için DOCKER.md dosyasına bakın.

Sorun Giderme

Docker Sorunları

Konteyner Başlamıyor

# Check container logs
docker logs <container_id>
# Common issues:
# 1. Port already in use
# 2. Invalid container image
# 3. Missing dependencies
# Credentials are passed via HTTP headers from the MCP client

Bağlantı Sorunları

# Test container connectivity
docker exec -it <container_id> curl http://127.0.0.1:8080/health
# Check port mapping
docker port <container_id>

Performans Sorunları

# Check container resource usage
docker stats <container_id>
# Monitor container health
docker inspect <container_id> | grep -A 10 Health

Genel Sorunlar

GitHub Copilot
- GitHub Copilot ile sorun yaşarsanız, mcp.json dosyasında sunucuyu başlatmayı/durdurmayı/yeniden başlatmayı deneyin ve aynı anda yalnızca bir sunucu çalışır durumda tutun.
Sertifika Sorunları
- [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate gibi sertifika sorunlarıyla karşılaşırsanız:
  - curl veya wget kullanarak SSL doğrulaması ile Instana API uç noktasına erişip erişemediğinizi kontrol edin.
    - Bu çalışıyorsa, Python ortamınız sertifikayı doğrulayamıyor olabilir ve kabuğunuz veya sisteminizle aynı sertifikalara erişemiyor olabilir. Python ortamınızın sistem sertifikalarını kullandığından emin olun (macOS). Bunu, Python'a sertifikaları yükleyerek yapabilirsiniz: //Applications/Python\ 3.13/Install\ Certificates.command
  - SSL doğrulaması ile uç noktaya erişemiyorsanız, doğrulama olmadan deneyin. Bu çalışıyorsa, sisteminizin CA sertifikalarını kontrol edin ve güncel olduklarından emin olun.