IBM Instana MCP Server

आधिकारिक

IBM Instana MCP सर्वर IBM Instana ऑब्ज़र्वेबिलिटी प्लेटफ़ॉर्म के साथ सहज इंटरैक्शन सक्षम करता है, जिससे आप अपने डेवलपमेंट वर्कफ़्लो में सीधे रीयल-टाइम ऑब्ज़र्वेबिलिटी डेटा तक पहुँच सकते हैं।

GitHub

IBM Instana MCP के साथ आप क्या कर सकते हैं?

बुनियादी ढांचे के स्नैपशॉट प्राप्त करें — get_infra_snapshot का उपयोग करके किसी विशिष्ट होस्ट, प्रक्रिया या कंटेनर का स्नैपशॉट मांगें।
एप्लिकेशन या सेवा मीट्रिक का विश्लेषण करें — get_app_metrics या get_service_metrics के साथ कॉल, त्रुटियों या विलंबता के लिए समय-श्रृंखला मीट्रिक का अनुरोध करें।
सक्रिय अलर्ट और घटनाओं की सूची बनाएं — get_alerts और get_incidents के माध्यम से वर्तमान अलर्ट, घटनाएं या वैश्विक स्मार्ट अलर्ट प्राप्त करें।
Kubernetes ईवेंट का निरीक्षण करें — get_k8s_events के साथ किसी क्लस्टर या नेमस्पेस के लिए हाल के Kubernetes ईवेंट खींचें।
वेबसाइट निगरानी डेटा क्वेरी करें — get_website_metrics के माध्यम से वेबसाइट प्रदर्शन मीट्रिक या बीकन परिणाम प्राप्त करें।

दस्तावेज़

विषय-सूची

IBM Instana के लिए MCP सर्वर

IBM Instana के लिए MCP सर्वर

📚 त्वरित लिंक

टूल और उदाहरण - वास्तविक दुनिया के उदाहरणों के साथ व्यापक टूल दस्तावेज़ीकरण
गोपनीयता नीति - डेटा हैंडलिंग और गोपनीयता जानकारी
Docker डिप्लॉयमेंट गाइड - व्यापक Docker डिप्लॉयमेंट, मल्टी-आर्किटेक्चर बिल्ड और प्रोडक्शन सेटअप

Instana MCP सर्वर Instana ऑब्ज़र्वेबिलिटी प्लेटफ़ॉर्म के साथ सहज इंटरैक्शन सक्षम करता है, जिससे आप अपने डेवलपमेंट वर्कफ़्लो में सीधे रीयल-टाइम ऑब्ज़र्वेबिलिटी डेटा तक पहुँच सकते हैं।

यह क्लाइंट (जैसे AI एजेंट या कस्टम टूल) और Instana REST API के बीच एक सेतु के रूप में कार्य करता है, उपयोगकर्ता प्रश्नों को Instana API अनुरोधों में परिवर्तित करता है और प्रतिक्रियाओं को संरचित, आसानी से उपभोग योग्य प्रारूपों में स्वरूपित करता है।

सर्वर विभिन्न MCP क्लाइंट के साथ अधिकतम संगतता के लिए स्ट्रीमेबल HTTP और Stdio दोनों ट्रांसपोर्ट मोड का समर्थन करता है। अधिक विवरण के लिए, MCP ट्रांसपोर्ट मोड विनिर्देश देखें।

आर्किटेक्चर अवलोकन

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

कार्यप्रवाह

एक सरल उदाहरण पर विचार करें: आप Instana MCP सर्वर से जुड़े एक MCP होस्ट (जैसे Claude Desktop, VS Code, या कोई अन्य क्लाइंट) का उपयोग कर रहे हैं। जब आप Instana अलर्ट के बारे में जानकारी का अनुरोध करते हैं, तो निम्नलिखित प्रक्रिया होती है:

MCP क्लाइंट Instana MCP सर्वर से उपलब्ध टूल की सूची प्राप्त करता है
आपकी क्वेरी टूल विवरण के साथ LLM को भेजी जाती है
LLM उपलब्ध टूल का विश्लेषण करता है और Instana अलर्ट प्राप्त करने के लिए उपयुक्त टूल का चयन करता है
क्लाइंट Instana MCP सर्वर के माध्यम से चुने गए टूल को निष्पादित करता है
परिणाम (नवीनतम अलर्ट) LLM को लौटाए जाते हैं
LLM एक प्राकृतिक भाषा प्रतिक्रिया तैयार करता है
प्रतिक्रिया आपको प्रदर्शित की जाती है

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

पूर्वापेक्षाएँ

विकल्प 1: PyPI से इंस्टॉल करें (अनुशंसित)

mcp-instana का उपयोग करने का सबसे आसान तरीका इसे सीधे PyPI से इंस्टॉल करना है:

pip install mcp-instana

इंस्टॉलेशन के बाद, आप सीधे mcp-instana कमांड का उपयोग करके सर्वर चला सकते हैं।

विकल्प 2: डेवलपमेंट इंस्टॉलेशन

डेवलपमेंट या स्थानीय अनुकूलन के लिए, आप प्रोजेक्ट को क्लोन करके स्थानीय रूप से सेट अप कर सकते हैं।

uv इंस्टॉल करना

यह प्रोजेक्ट uv का उपयोग करता है, जो एक तेज़ Python पैकेज इंस्टॉलर और रिज़ॉल्वर है। uv इंस्टॉल करने के लिए, आपके पास कई विकल्प हैं:

pip का उपयोग करना:

pip install uv

Homebrew का उपयोग करना (macOS):

brew install uv

अधिक इंस्टॉलेशन विकल्पों और विस्तृत निर्देशों के लिए, uv दस्तावेज़ीकरण पर जाएँ।

एनवायरनमेंट सेट अप करना

uv इंस्टॉल करने के बाद, निम्न चलाकर प्रोजेक्ट एनवायरनमेंट सेट अप करें:

uv sync

स्ट्रीमेबल HTTP मोड के लिए हेडर-आधारित प्रमाणीकरण

स्ट्रीमेबल HTTP मोड का उपयोग करते समय, आपको HTTP हेडर के माध्यम से Instana क्रेडेंशियल पास करने होंगे। यह दृष्टिकोण निम्नलिखित द्वारा सुरक्षा और लचीलापन बढ़ाता है:

एनवायरनमेंट वेरिएबल में क्रेडेंशियल स्टोरेज से बचना
विभिन्न अनुरोधों के लिए विभिन्न क्रेडेंशियल का उपयोग सक्षम करना
साझा एनवायरनमेंट का समर्थन करना जहाँ एनवायरनमेंट वेरिएबल संशोधन प्रतिबंधित है
API टोकन और सेशन-आधारित प्रमाणीकरण दोनों का समर्थन करना

समर्थित प्रमाणीकरण मोड:

1. API टोकन प्रमाणीकरण (डायरेक्ट API कॉल)

आवश्यक हेडर:

instana-base-url: आपका Instana इंस्टेंस URL
instana-api-token: आपका Instana API टोकन

उदाहरण:

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

2. सेशन टोकन प्रमाणीकरण (UI-आरंभित कॉल)

आवश्यक हेडर:

instana-base-url: आपका Instana इंस्टेंस URL
instana-auth-token: UI बैकएंड से सेशन प्रमाणीकरण टोकन
instana-csrf-token: UI बैकएंड से CSRF टोकन
instana-cookie-name: (वैकल्पिक) सेशन प्रमाणीकरण के लिए कुकी नाम (डिफ़ॉल्ट: instanaAuthToken)

उदाहरण:

--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 टोकन प्रमाणीकरण (IBM प्लेटफ़ॉर्म एकीकरण)

आवश्यक हेडर:

instana-base-url: आपका Instana इंस्टेंस URL
instana-jwt-token: IBM प्लेटफ़ॉर्म से JWT टोकन
instana-csrf-token: अनुरोध सत्यापन के लिए CSRF टोकन

उदाहरण कॉन्फ़िगरेशन:

{
  "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"
      ]
    }
  }
}

प्रमाणीकरण प्राथमिकता:

JWT टोकन (यदि CSRF टोकन के साथ प्रदान किया गया हो) - IBM प्लेटफ़ॉर्म एकीकरण के लिए प्राथमिकता लेता है
सेशन टोकन (यदि auth_token और csrf_token दोनों प्रदान किए गए हों)
API टोकन (यदि प्रदान किया गया हो) - मानक प्रमाणीकरण
एनवायरनमेंट वेरिएबल (INSTANA_API_TOKEN) - फ़ॉलबैक

प्रमाणीकरण प्रवाह:

प्रत्येक अनुरोध में HTTP हेडर मौजूद होने चाहिए
सर्वर प्राथमिकता क्रम के आधार पर क्रेडेंशियल मान्य करता है
वैध प्रमाणीकरण के बिना अनुरोध विफल हो जाएंगे

यह डिज़ाइन सुरक्षित क्रेडेंशियल ट्रांसमिशन सुनिश्चित करता है और WebSocket → कोऑर्डिनेटर → MCP सर्वर के माध्यम से UI-आरंभित कॉल सहित कई प्रमाणीकरण प्रवाहों का समर्थन करता है।

सुनिश्चित करें कि उपयोग किए गए टोकन के पास MCP टूल लागू करने के लिए आवश्यक अनुमतियाँ हैं। अधिक जानकारी के लिए यहाँ देखें।

लोकल MCP सर्वर शुरू करना

किसी भी MCP क्लाइंट (Claude Desktop, GitHub Copilot, या कस्टम MCP क्लाइंट) को कॉन्फ़िगर करने से पहले, आपको लोकल MCP सर्वर शुरू करना होगा। सर्वर दो ट्रांसपोर्ट मोड का समर्थन करता है: स्ट्रीमेबल HTTP और Stdio।

सर्वर कमांड विकल्प

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

यदि आपने PyPI से mcp-instana इंस्टॉल किया है, तो mcp-instana कमांड का उपयोग करें:

mcp-instana [OPTIONS]

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

स्थानीय डेवलपमेंट के लिए, uv run कमांड का उपयोग करें:

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

उपलब्ध विकल्प:

--transport <mode>: ट्रांसपोर्ट मोड (विकल्प: streamable-http, stdio)
--env KEY=VALUE: एनवायरनमेंट वेरिएबल सेट करें (कई वेरिएबल के लिए दोहराया जा सकता है, जैसे, --env INSTANA_BASE_URL=https://... --env INSTANA_API_TOKEN=...)
--debug: अतिरिक्त लॉगिंग के साथ डीबग मोड सक्षम करें
--log-level <level>: लॉगिंग स्तर सेट करें (विकल्प: DEBUG, INFO, WARNING, ERROR, CRITICAL)
--tools <categories>: सक्षम करने के लिए टूल श्रेणियों की अल्पविराम-पृथक सूची (जैसे, infra,app,events,website)। किसी श्रेणी को सक्षम करने से उसके संबंधित प्रॉम्प्ट भी सक्षम हो जाएंगे। उदाहरण के लिए: --tools infra infra टूल और सभी infra-संबंधित प्रॉम्प्ट सक्षम करता है।
--list-tools: सभी उपलब्ध टूल श्रेणियों को सूचीबद्ध करें और बाहर निकलें
--port <port>: MCP सर्वर पोर्ट (डिफ़ॉल्ट: 8080, PORT env var से ओवरराइड किया जा सकता है)
--help: सहायता संदेश दिखाएं और बाहर निकलें

स्ट्रीमेबल HTTP मोड में शुरू करना

स्ट्रीमेबल HTTP मोड एक REST API इंटरफ़ेस प्रदान करता है और अधिकांश उपयोग मामलों के लिए अनुशंसित है।

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

# 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

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

# 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

स्ट्रीमेबल HTTP मोड की मुख्य विशेषताएँ:

प्रमाणीकरण के लिए HTTP हेडर का उपयोग करता है (किसी एनवायरनमेंट वेरिएबल की आवश्यकता नहीं)
प्रति अनुरोध विभिन्न क्रेडेंशियल का समर्थन करता है
साझा एनवायरनमेंट के लिए बेहतर अनुकूल
MCP सर्वर डिफ़ॉल्ट पोर्ट: 8080
MCP एंडपॉइंट: http://0.0.0.0:8080/mcp/

Stdio मोड में शुरू करना

Stdio मोड संचार के लिए मानक इनपुट/आउटपुट का उपयोग करता है और प्रमाणीकरण के लिए एनवायरनमेंट वेरिएबल की आवश्यकता होती है।

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

# 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

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

# 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 मोड की मुख्य विशेषताएँ:

प्रमाणीकरण के लिए एनवायरनमेंट वेरिएबल का उपयोग करता है (export या --env फ़्लैग के माध्यम से सेट किया जा सकता है)
stdin/stdout के माध्यम से सीधा संचार
कुछ MCP क्लाइंट कॉन्फ़िगरेशन के लिए आवश्यक
--env फ़्लैग शेल एनवायरनमेंट को संशोधित किए बिना क्रेडेंशियल सेट करने का एक सुविधाजनक तरीका प्रदान करता है

टूल श्रेणियाँ

आप केवल अपनी आवश्यकतानुसार टूल और प्रॉम्प्ट श्रेणियों को सक्षम करके सर्वर प्रदर्शन को अनुकूलित कर सकते हैं:

CLI का उपयोग करना (PyPI इंस्टॉलेशन)

# 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

डेवलपमेंट इंस्टॉलेशन का उपयोग करना

# 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

उपलब्ध श्रेणियाँ:

infra: इंफ्रास्ट्रक्चर मॉनिटरिंग टूल और प्रॉम्प्ट (संसाधन, कैटलॉग, टोपोलॉजी, विश्लेषण, मेट्रिक्स)
app: एप्लिकेशन प्रदर्शन टूल और प्रॉम्प्ट (संसाधन, मेट्रिक्स, अलर्ट, कैटलॉग, टोपोलॉजी, विश्लेषण, सेटिंग्स, वैश्विक अलर्ट)
events: ईवेंट मॉनिटरिंग टूल और प्रॉम्प्ट (Kubernetes ईवेंट, एजेंट मॉनिटरिंग)
website: वेबसाइट मॉनिटरिंग टूल और प्रॉम्प्ट (मेट्रिक्स, कैटलॉग, विश्लेषण, कॉन्फ़िगरेशन)

सर्वर स्थिति सत्यापित करना

एक बार शुरू होने पर, आप सत्यापित कर सकते हैं कि सर्वर चल रहा है:

स्ट्रीमेबल HTTP मोड के लिए:

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

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

Stdio मोड के लिए: सर्वर शुरू होगा और MCP क्लाइंट से stdin इनपुट की प्रतीक्षा करेगा।

सामान्य स्टार्टअप समस्याएँ

प्रमाणपत्र समस्याएँ: यदि आपको SSL प्रमाणपत्र त्रुटियाँ आती हैं, तो सुनिश्चित करें कि आपके Python एनवायरनमेंट की सिस्टम प्रमाणपत्रों तक पहुँच है:

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

पोर्ट पहले से उपयोग में: यदि पोर्ट 8080 पहले से उपयोग में है, तो एक अलग पोर्ट निर्दिष्ट करें:

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

गुम निर्भरताएँ: सुनिश्चित करें कि सभी निर्भरताएँ इंस्टॉल हैं:

uv sync

सेटअप और उपयोग

Bob IDE

Bob IBM का AI-संचालित IDE है जो मूल रूप से MCP एकीकरण का समर्थन करता है। Bob अंतर्निहित AI सहायता और ऑब्ज़र्वेबिलिटी टूल के साथ एक सहज डेवलपमेंट अनुभव प्रदान करता है।

स्ट्रीमेबल HTTP मोड

स्ट्रीमेबल HTTP मोड HTTP पर JSON-RPC का उपयोग करके MCP संचार के लिए एक REST API इंटरफ़ेस प्रदान करता है।

चरण 1: MCP सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करें

Bob को कॉन्फ़िगर करने से पहले, आपको MCP सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करना होगा। विस्तृत निर्देशों के लिए कृपया स्थानीय MCP सर्वर प्रारंभ करना अनुभाग देखें।

चरण 2: Bob कॉन्फ़िगर करें

Bob पैनल के ऊपरी दाएं कोने पर, आपको MCP सर्वर के साथ एक ड्रॉपडाउन दिखाई देगा:

इसे चुनने पर, आपको प्रोजेक्ट स्तर या वैश्विक स्तर पर MCP कॉन्फ़िगर करने का विकल्प दिखाई देना चाहिए।

MCP कॉन्फ़िगरेशन स्कोप

Bob MCP कॉन्फ़िगरेशन के दो स्तरों का समर्थन करता है, जिससे आप अपने उपयोग के मामले के लिए सबसे उपयुक्त स्कोप चुन सकते हैं:

1. वैश्विक कॉन्फ़िगरेशन (उपयोगकर्ता-स्तर)

वैश्विक कॉन्फ़िगरेशन वर्तमान उपयोगकर्ता के लिए सभी प्रोजेक्टों में MCP सर्वर लागू करता है। यह तब आदर्श है जब आप चाहते हैं कि समान MCP सर्वर आपके द्वारा काम किए जाने वाले प्रत्येक प्रोजेक्ट में उपलब्ध हों।

फ़ाइल स्थान:

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

2. प्रोजेक्ट कॉन्फ़िगरेशन (प्रोजेक्ट-स्तर)

प्रोजेक्ट कॉन्फ़िगरेशन MCP सर्वर को केवल एक विशिष्ट प्रोजेक्ट पर लागू करता है। यह तब उपयोगी है जब विभिन्न प्रोजेक्टों को अलग-अलग MCP सर्वर कॉन्फ़िगरेशन की आवश्यकता होती है या जब आप संस्करण नियंत्रण के माध्यम से अपनी टीम के साथ MCP सेटिंग्स साझा करना चाहते हैं।

फ़ाइल स्थान:

आपके प्रोजेक्ट रूट निर्देशिका में .bob/bob_config.json

वैश्विक और प्रोजेक्ट कॉन्फ़िगरेशन के बीच चयन:

वैश्विक कॉन्फ़िगरेशन का उपयोग उन MCP सर्वरों के लिए करें जिन्हें आप अपने सभी प्रोजेक्टों में उपलब्ध कराना चाहते हैं
प्रोजेक्ट कॉन्फ़िगरेशन का उपयोग प्रोजेक्ट-विशिष्ट MCP सर्वरों के लिए या अपनी टीम के साथ कॉन्फ़िगरेशन साझा करने के लिए करें
दोनों कॉन्फ़िगरेशन सह-अस्तित्व में रह सकते हैं - समान सर्वर नाम के लिए प्रोजेक्ट-स्तरीय सेटिंग्स वैश्विक सेटिंग्स पर प्राथमिकता लेती हैं

Bob और MCP कॉन्फ़िगरेशन के बारे में अधिक जानकारी के लिए, यहां जाएं: https://bob.ibm.com/docs/ide/configuration/mcp/mcp-in-bob

स्थानीय कॉन्फ़िगरेशन:

Bob को अपने स्थानीय Instana MCP सर्वर से कनेक्ट करने के लिए कॉन्फ़िगर करें:

{
  "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"
      ]
    }
  }
}

दूरस्थ कॉन्फ़िगरेशन:

Bob को दूरस्थ Instana MCP सर्वर (जैसे, IBM Code Engine पर तैनात) से कनेक्ट करने के लिए कॉन्फ़िगर करें:

{
  "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"
      ]
    }
  }
}

नोट: npx का उपयोग करने के लिए, हम पहले NVM (Node Version Manager) स्थापित करने और फिर इसका उपयोग Node.js स्थापित करने की अनुशंसा करते हैं। स्थापना निर्देश यहां उपलब्ध हैं: https://nodejs.org/en/download

चरण 3: कनेक्शन का परीक्षण करें

एक बार जब आप MCP कॉन्फ़िगरेशन सेट कर लेते हैं, तो नया कॉन्फ़िगर किया गया MCP सर्वर सक्षम के रूप में दिखाई देना चाहिए। एक हरा बिंदु इंगित करता है कि सर्वर सफलतापूर्वक चल रहा है।

अब आप Bob IDE में क्वेरी चला सकते हैं:

get me all applications from Instana in the last 24 hours

Stdio मोड

CLI का उपयोग करके कॉन्फ़िगरेशन (PyPI स्थापना - अनुशंसित):

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "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"
      }
    }
  }
}

विकल्प 2: --env फ़्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "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"
      ]
    }
  }
}

नोट: यदि आपको "command not found" त्रुटियां मिलती हैं, तो mcp-instana के पूर्ण पथ का उपयोग करें। इसे which mcp-instana से खोजें और इसके बजाय उस पथ का उपयोग करें।

विकास स्थापना का उपयोग करके कॉन्फ़िगरेशन:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "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"
      }
    }
  }
}

विकल्प 2: --env फ़्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "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 एकीकरण के लिए स्ट्रीमेबल HTTP और Stdio दोनों मोड का समर्थन करता है।

कॉन्फ़िगरेशन फ़ाइल को संपादित करके Claude Desktop कॉन्फ़िगर करें:

फ़ाइल स्थान:

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

स्ट्रीमेबल HTTP मोड

चरण 1: MCP सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करें

Claude Desktop को कॉन्फ़िगर करने से पहले, आपको MCP सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करना होगा। विस्तृत निर्देशों के लिए कृपया स्थानीय MCP सर्वर प्रारंभ करना अनुभाग देखें।

चरण 2: Claude Desktop कॉन्फ़िगर करें

हेडर के माध्यम से Instana क्रेडेंशियल पास करने के लिए Claude Desktop कॉन्फ़िगर करें:

{
  "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"
      ]
    }
  }
}

चरण 3: कनेक्शन का परीक्षण करें

Claude Desktop को पुनरारंभ करें। अब आपको Claude Desktop इंटरफ़ेस में Instana MCP सर्वर दिखाई देना चाहिए जैसा कि नीचे दिखाया गया है:

अब आप Claude Desktop में क्वेरी चला सकते हैं:

get me all endpoints from Instana

Stdio मोड

CLI का उपयोग करके कॉन्फ़िगरेशन (PyPI स्थापना - अनुशंसित):

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "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"
      }
    }
  }
}

विकल्प 2: --env फ़्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "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"
      ]
    }
  }
}

विकास स्थापना का उपयोग करके कॉन्फ़िगरेशन:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "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"
      }
    }
  }
}

विकल्प 2: --env फ़्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "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 सेटअप

Kiro एक एजेंटिक IDE है, कोई एक्सटेंशन नहीं जिसे VS Code या किसी अन्य IDE में डाउनलोड किया जा सके।

चरण 1: https://kiro.dev/. से अपने ऑपरेटिंग सिस्टम के लिए Kiro डाउनलोड और इंस्टॉल करें**

चरण 2: स्थापना के बाद, Kiro लॉन्च करें और IDE में कोई भी प्रोजेक्ट खोलें। alt text

चरण 3: Kiro की सुविधाओं तक पहुंचने के लिए बाएं साइडबार पर Kiro (Ghost) आइकन पर क्लिक करें। alt text

चरण 4: MCP सर्वर अनुभाग के ऊपरी दाएं कोने में Edit Config आइकन चुनें। alt text

चरण 5: MCP सर्वर कॉन्फ़िगरेशन फ़ाइल (mcp.json) खोलें और इसे अपने पसंदीदा ट्रांसपोर्ट मोड के आधार पर कॉन्फ़िगर करें:

स्ट्रीमेबल HTTP मोड (Kiro के लिए अनुशंसित)

{
  "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"
      ]
    }
  }
}

नोट: इस कॉन्फ़िगरेशन का उपयोग करने से पहले MCP सर्वर को स्ट्रीमेबल-http मोड में प्रारंभ करना सुनिश्चित करें:

mcp-instana --transport streamable-http

Stdio मोड

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "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"
      }
    }
  }
}

विकल्प 2: --env फ़्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "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"
      ]
    }
  }
}

चरण 6: फ़ाइल सहेजने के बाद, Enable MCP बटन पर क्लिक करें और आप अपने MCP सर्वर और उसके उपलब्ध टूल को Kiro के निचले-बाएँ अनुभाग में दिखाई देंगे। alt text

चरण 7: AI चैट पैनल पर जाएं, अपने MCP सर्वर से संबंधित एक प्रॉम्प्ट दर्ज करें, और सीधे Kiro के भीतर प्रतिक्रिया देखें। alt text

GitHub Copilot

GitHub Copilot VS Code कॉन्फ़िगरेशन के माध्यम से MCP एकीकरण का समर्थन करता है। VS Code के साथ GitHub Copilot एकीकरण के लिए, इस सेटअप गाइड को देखें।

स्ट्रीमेबल HTTP मोड

चरण 1: MCP सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करें

VS Code को कॉन्फ़िगर करने से पहले, आपको MCP सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करना होगा। विस्तृत निर्देशों के लिए कृपया स्थानीय MCP सर्वर प्रारंभ करना अनुभाग देखें।

चरण 2: VS Code कॉन्फ़िगर करें

विस्तृत कॉन्फ़िगरेशन के लिए VS Code में MCP सर्वर का उपयोग करें देखें।

आप निम्नलिखित कॉन्फ़िगरेशन के साथ सीधे .vscode/mcp.json बना या अपडेट कर सकते हैं:

{
  "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"
      }
    }
  }
}

नोट: निम्नलिखित मानों को अपने वास्तविक कॉन्फ़िगरेशन से बदलें:

instana-base-url: आपका Instana इंस्टेंस URL
instana-api-token: आपका Instana API टोकन
command: अपने सिस्टम की Node.js स्थापना से मिलान करने के लिए npx पथ अपडेट करें (जैसे, /path/to/your/node/bin/npx)
पर्यावरण चर: अपने सिस्टम के लिए आवश्यकतानुसार PATH और अन्य पर्यावरण चर समायोजित करें

Stdio मोड

चरण 1: VS Code MCP कॉन्फ़िगरेशन बनाएं

CLI का उपयोग करना (PyPI स्थापना - अनुशंसित):

अपने प्रोजेक्ट रूट में .vscode/mcp.json बनाएं:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "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"
      }
    }
  }
}

विकल्प 2: --env फ़्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "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"
      ]
    }
  }
}

विकास स्थापना का उपयोग करना:

अपने प्रोजेक्ट रूट में .vscode/mcp.json बनाएं:

विकल्प 1: कॉन्फ़िग में पर्यावरण चर का उपयोग करना:

{
  "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"
      }
    }
  }
}

विकल्प 2: --env फ़्लैग का उपयोग करना (वैकल्पिक विधि):

{
  "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"
      ]
    }
  }
}

नोट: निम्नलिखित मानों को अपने वास्तविक कॉन्फ़िगरेशन से बदलें:

CLI स्थापना के लिए: सुनिश्चित करें कि mcp-instana आपके PATH में है
विकास स्थापना के लिए:
- command: अपने सिस्टम की uv स्थापना से मिलान करने के लिए uv पथ अपडेट करें (जैसे, /path/to/your/uv/bin/uv या /usr/local/bin/uv)
- --directory: अपनी mcp-instana प्रोजेक्ट निर्देशिका के पूर्ण पथ के साथ अपडेट करें
INSTANA_BASE_URL: आपका Instana इंस्टेंस URL
INSTANA_API_TOKEN: आपका Instana API टोकन

चरण 2: VS Code में सर्वर प्रबंधित करें

.vscode/mcp.json खोलें - आपको शीर्ष पर सर्वर प्रबंधन नियंत्रण दिखाई देंगे
सर्वर प्रारंभ करने के लिए Instana MCP Server के बगल में Start पर क्लिक करें
टूल की संख्या के साथ चलने की स्थिति इंगित करती है कि सर्वर चल रहा है

चरण 3: एकीकरण का परीक्षण करें

GitHub Copilot में एजेंट मोड पर स्विच करें और टूल पुनः लोड करें। यहां GitHub Copilot प्रतिक्रिया का एक उदाहरण दिया गया है:

GitHub Copilot Response

Mistral AI

Mistral AI विशेष रूप से स्ट्रीमेबल HTTP मोड के माध्यम से MCP एकीकरण का समर्थन करता है।

चरण 1: MCP सर्वर को स्ट्रीमेबल HTTP मोड में लॉन्च करें

अपने Instana क्रेडेंशियल प्रदान करके MCP सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करें। निम्नलिखित कमांड चलाएँ:

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

चरण 2: Ngrok के साथ पोर्ट फ़ॉरवर्डिंग सेट करें

अपने स्थानीय सर्वर को उजागर करने के लिए पोर्ट फ़ॉरवर्डिंग कॉन्फ़िगर करें। विस्तृत निर्देशों के लिए Ngrok सेटअप दस्तावेज़ीकरण का पालन करें।

चरण 3: Mistral AI कॉन्फ़िगर करें

बाएं साइडबार में Intelligence टैब पर नेविगेट करें और Connectors चुनें
Add Connector पर क्लिक करें
एक कनेक्टर नाम और Ngrok-अग्रेषित MCP सर्वर URL दर्ज करके एक कस्टम कनेक्टर बनाएं
एक नया चैट सत्र प्रारंभ करें और सत्यापित करें कि MCP उपकरण सक्षम हैं। आप यहां प्रतिक्रिया देख सकते हैं

समर्थित सुविधाएँ

उपलब्ध उपकरण

उपकरण	श्रेणी	विवरण
`manage_applications`	अनुप्रयोग और अवसंरचना	अनुप्रयोग मेट्रिक्स, अलर्ट कॉन्फ़िग, सेटिंग्स और कैटलॉग के प्रबंधन के लिए एकीकृत उपकरण
`manage_websites`	वेबसाइट निगरानी	वेबसाइट विश्लेषण, कैटलॉग, कॉन्फ़िगरेशन और उन्नत कॉन्फ़िग संचालन के लिए एकीकृत स्मार्ट राउटर
`manage_custom_dashboards`	कस्टम डैशबोर्ड	कस्टम डैशबोर्ड CRUD संचालन के प्रबंधन के लिए एकीकृत उपकरण
`analyze_infrastructure`	अवसंरचना विश्लेषण	एंटिटी/मीट्रिक प्राप्ति के साथ दो-चरणीय अवसंरचना विश्लेषण
`manage_automation`	स्वचालन	स्वचालन के लिए एकीकृत स्मार्ट राउटर: कार्रवाई कैटलॉग ब्राउज़ करें और निष्पादन इतिहास देखें
`manage_events`	घटनाएँ	घटना निगरानी के लिए एकीकृत स्मार्ट राउटर: ID द्वारा घटना प्राप्त करें, IDs द्वारा घटनाएँ प्राप्त करें, Kubernetes घटनाएँ, एजेंट निगरानी घटनाएँ और सभी घटनाएँ
`manage_slo`	SLO प्रबंधन	बुद्धिमान समयक्षेत्र प्रबंधन के साथ SLO कॉन्फ़िगरेशन, रिपोर्ट, अलर्ट और सुधार विंडो के लिए एकीकृत स्मार्ट राउटर
`manage_releases`	रिलीज़ प्रबंधन	रिलीज़ ट्रैकिंग के लिए एकीकृत स्मार्ट राउटर: पृष्ठांकन और नाम फ़िल्टरिंग के साथ रिलीज़ सूचीबद्ध करें, रिलीज़ विवरण प्राप्त करें, समयक्षेत्र समर्थन के साथ रिलीज़ बनाएँ/अपडेट करें/हटाएँ
`manage_maintenance_windows`	रखरखाव विंडो	रखरखाव विंडो जीवनचक्र प्रबंधन के लिए एकीकृत स्मार्ट राउटर: टेम्पलेट समर्थन और ServiceNow एकीकरण के साथ रखरखाव विंडो बनाएँ, संशोधित करें, बंद करें और सूचीबद्ध करें
`manage_mobile_apps`	मोबाइल ऐप निगरानी	मोबाइल ऐप निगरानी के लिए एकीकृत स्मार्ट राउटर: बीकन, प्रदर्शन मेट्रिक्स, कॉन्फ़िगरेशन और अलर्ट प्रबंधन का विश्लेषण करें

👉 विस्तृत उपकरण दस्तावेज़ीकरण, क्षमताओं और तकनीकी संदर्भ के लिए, उपकरण और उदाहरण देखें

उपकरण फ़िल्टरिंग

MCP सर्वर प्रदर्शन को अनुकूलित करने और संसाधन उपयोग को कम करने के लिए चयनात्मक उपकरण लोडिंग का समर्थन करता है। आप अपने विशिष्ट उपयोग मामले के लिए आवश्यक केवल उपकरण श्रेणियों को सक्षम कर सकते हैं।

उपलब्ध उपकरण श्रेणियाँ

router: एकीकृत अनुप्रयोग और अवसंरचना प्रबंधन
- manage_instana_resources: अनुप्रयोग मेट्रिक्स, अलर्ट कॉन्फ़िगरेशन, सेटिंग्स और कैटलॉग के लिए एकल उपकरण
- अनुप्रयोग परिप्रेक्ष्य, एंडपॉइंट, सेवाओं और मैन्युअल सेवाओं का समर्थन करता है
- अनुप्रयोग-विशिष्ट और वैश्विक दोनों अलर्ट कॉन्फ़िगरेशन प्रबंधित करता है
- अनुप्रयोग टैग कैटलॉग और मीट्रिक कैटलॉग तक पहुँच प्रदान करता है
dashboard: कस्टम डैशबोर्ड प्रबंधन
- manage_custom_dashboards: कस्टम डैशबोर्ड के लिए CRUD संचालन
- डैशबोर्ड निर्माण, पुनर्प्राप्ति, अपडेट और विलोपन का समर्थन करता है
- डैशबोर्ड के लिए साझा करने योग्य उपयोगकर्ताओं और API टोकन का प्रबंधन करता है
infra: अवसंरचना विश्लेषण उपकरण
- analyze_infrastructure: एंटिटी/मीट्रिक प्राप्ति के साथ दो-चरणीय अवसंरचना विश्लेषण
- आपके Instana इंस्टॉलेशन में उपलब्ध सभी एंटिटी प्रकारों का गतिशील रूप से समर्थन करता है (API कैटलॉग से स्वचालित रूप से लोड)
- इसमें JVM, Kubernetes, Docker, होस्ट, डेटाबेस, संदेश कतारें और कोई भी कस्टम या नए जोड़े गए एंटिटी प्रकार शामिल हैं
- लचीला मीट्रिक एकत्रीकरण, फ़िल्टरिंग, समूहीकरण और समय सीमा क्वेरीज़
automation: स्वचालन कार्रवाई उपकरण
- manage_automation: स्वचालन कैटलॉग और निष्पादन इतिहास के लिए एकीकृत स्मार्ट राउटर
- कार्रवाई कैटलॉग: कार्रवाइयाँ ब्राउज़ करें, विवरण प्राप्त करें, नाम/विवरण द्वारा खोजें, अनुप्रयोग या स्नैपशॉट ID द्वारा फ़िल्टर करें
- कार्रवाई इतिहास: फ़िल्टरिंग के साथ निष्पादन उदाहरण सूचीबद्ध करें, निष्पादन विवरण प्राप्त करें
events: घटना निगरानी उपकरण
- घटनाएँ: Kubernetes घटनाएँ, एजेंट निगरानी और सिस्टम घटना ट्रैकिंग
website: वेबसाइट निगरानी उपकरण
- वेबसाइट मेट्रिक्स: वेबसाइटों के लिए प्रदर्शन मापन
- वेबसाइट कैटलॉग: वेबसाइट मेटाडेटा और परिभाषाएँ
- वेबसाइट विश्लेषण: वेबसाइट प्रदर्शन विश्लेषण
- वेबसाइट कॉन्फ़िगरेशन: वेबसाइट कॉन्फ़िगरेशन प्रबंधन
slo: सेवा स्तर उद्देश्य (SLO) प्रबंधन
- manage_slo: व्यापक SLO संचालन के लिए एकीकृत स्मार्ट राउटर
- कॉन्फ़िगरेशन प्रबंधन: समय-आधारित और घटना-आधारित संकेतकों के समर्थन के साथ SLO कॉन्फ़िगरेशन बनाएँ, पढ़ें, अपडेट करें, हटाएँ
- रिपोर्ट निर्माण: SLI मान, त्रुटि बजट, बर्न दर और समय-श्रृंखला चार्ट के साथ विस्तृत SLO रिपोर्ट तैयार करें
- अलर्ट कॉन्फ़िगरेशन: त्रुटि बजट निगरानी और बर्न दर ट्रैकिंग के लिए SLO अलर्ट कॉन्फ़िग प्रबंधित करें
- सुधार विंडो: SLO गणनाओं से नियोजित डाउनटाइम को बाहर करने के लिए रखरखाव विंडो बनाएँ और प्रबंधित करें
- बुद्धिमान समयक्षेत्र प्रबंधन: सटीक समय संदर्भ सुनिश्चित करने के लिए डेटटाइम इनपुट के लिए स्वचालित समयक्षेत्र प्राप्ति
- दो-चरणीय प्राप्ति: एकाधिक इनपुट की आवश्यकता वाले जटिल संचालन के लिए इंटरैक्टिव पैरामीटर संग्रह
releases: रिलीज़ ट्रैकिंग और परिनियोजन प्रबंधन
- manage_releases: रिलीज़ संचालन के लिए एकीकृत स्मार्ट राउटर
- रिलीज़ सूचीबद्ध करें: कुशल पृष्ठांकन (page_number, page_size) और नाम-आधारित फ़िल्टरिंग के साथ सभी रिलीज़ प्राप्त करें
- रिलीज़ विवरण: अनुप्रयोगों, सेवाओं और स्कोप सहित ID द्वारा विशिष्ट रिलीज़ जानकारी पुनर्प्राप्त करें
- बनाएँ/अपडेट करें/हटाएँ: रिलीज़ प्रबंधन के लिए पूर्ण CRUD संचालन
- बुद्धिमान समयक्षेत्र प्रबंधन: रिलीज़ प्रारंभ समय के लिए स्वचालित समयक्षेत्र प्राप्ति
- कुशल पृष्ठांकन: उचित पृष्ठ-आधारित नेविगेशन के साथ अनावश्यक डेटा प्राप्ति से बचें
- नाम फ़िल्टरिंग: नाम से रिलीज़ खोजने के लिए केस-असंवेदनशील सबस्ट्रिंग मिलान
maintenance_window: रखरखाव विंडो जीवनचक्र प्रबंधन
- manage_maintenance_windows: रखरखाव विंडो संचालन के लिए एकीकृत स्मार्ट राउटर
- विंडो संचालन: रखरखाव विंडो बनाएँ, संशोधित करें, बंद करें और सूचीबद्ध करें (सक्रिय, निर्धारित, सभी, समाप्त)
- बल्क संचालन: एक साथ कई अनुप्रयोगों के लिए रखरखाव विंडो बनाएँ
- टेम्पलेट समर्थन: सामान्य परिदृश्यों के लिए पूर्वनिर्धारित टेम्पलेट (deployment, database_migration, infrastructure_upgrade, emergency, routine)
- आवर्ती विंडो: RFC 5545 RRULE प्रारूप का उपयोग करके आवर्ती रखरखाव विंडो के लिए समर्थन
- ServiceNow एकीकरण: ServiceNow परिवर्तन अनुरोधों के साथ वैकल्पिक एकीकरण
- सत्यापन: विंडो निर्माण से पहले पैरामीटर सत्यापन
- लचीली अवधि: मिनटों, घंटों या दिनों में अवधि निर्दिष्ट करें
mobile_app: मोबाइल एप्लिकेशन निगरानी
- manage_mobile_apps: मोबाइल ऐप निगरानी संचालन के लिए एकीकृत स्मार्ट राउटर
- बीकन विश्लेषण: समूहीकरण और फ़िल्टरिंग के साथ मोबाइल ऐप बीकन डेटा क्वेरी करें
- प्रदर्शन मीट्रिक्स: सत्र अवधि, क्रैश दरें और HTTP अनुरोध प्रदर्शन ट्रैक करें
- भौगोलिक विश्लेषण: देश, शहर और क्षेत्र के अनुसार उपयोगकर्ता वितरण का विश्लेषण करें
- डिवाइस विश्लेषण: विभिन्न डिवाइसों, प्लेटफ़ॉर्म और OS संस्करणों में प्रदर्शन की निगरानी करें
- कॉन्फ़िगरेशन प्रबंधन: मोबाइल ऐप कॉन्फ़िगरेशन, भू-स्थान और IP मास्किंग सेटिंग्स प्रबंधित करें
- अलर्ट प्रबंधन: मोबाइल ऐप अलर्ट कॉन्फ़िगरेशन कॉन्फ़िगर और प्रबंधित करें

उपयोग उदाहरण

CLI का उपयोग (PyPI इंस्टॉलेशन)

# 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

डेवलपमेंट इंस्टॉलेशन का उपयोग

# 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

टूल फ़िल्टरिंग के लाभ

प्रदर्शन: स्टार्टअप समय और मेमोरी उपयोग में कमी
सुरक्षा: केवल आवश्यक API तक ही एक्सपोज़र सीमित करें
स्पष्टता: विशिष्ट उपयोग मामलों पर ध्यान केंद्रित करें (जैसे, केवल इंफ्रास्ट्रक्चर निगरानी)
संसाधन दक्षता: कम CPU और नेटवर्क उपयोग

👉 उपयोग उदाहरणों और प्रॉम्प्ट के लिए, उदाहरण प्रॉम्प्ट देखें

Docker डिप्लॉयमेंट

MCP Instana सर्वर को उत्पादन परिवेशों के लिए Docker का उपयोग करके डिप्लॉय किया जा सकता है। Docker सेटअप सुरक्षा, प्रदर्शन और न्यूनतम संसाधन उपयोग के लिए अनुकूलित है।

Docker आर्किटेक्चर

यह प्रोजेक्ट दो-फ़ाइल निर्भरता प्रबंधन रणनीति का उपयोग करता है:

pyproject.toml

उद्देश्य: डेवलपमेंट और उत्पादन दोनों के लिए एकीकृत कॉन्फ़िगरेशन
निर्भरताएँ: वैकल्पिक डेवलपमेंट निर्भरताओं के साथ सभी आवश्यक निर्भरताएँ
उपयोग: स्थानीय डेवलपमेंट, परीक्षण, CI/CD और Docker उत्पादन बिल्ड
लाभ: सभी निर्भरताओं के लिए एकल सत्य स्रोत, सरलीकृत रखरखाव

Docker इमेज बनाना

पूर्वापेक्षाएँ

Docker इंस्टॉल और चालू हो
प्रोजेक्ट स्रोत कोड तक पहुँच
मल्टी-आर्किटेक्चर बिल्ड के लिए Docker BuildKit (हाल के Docker संस्करणों में डिफ़ॉल्ट रूप से सक्षम)

बिल्ड कमांड

# 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

📖 मल्टी-आर्किटेक्चर बिल्ड, Docker Compose सेटअप, सुरक्षा सर्वोत्तम अभ्यास और उत्पादन डिप्लॉयमेंट उदाहरणों सहित व्यापक Docker दस्तावेज़ीकरण के लिए, DOCKER.md देखें।

समस्या निवारण

Docker समस्याएँ

कंटेनर शुरू नहीं होगा

# 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

कनेक्शन समस्याएँ

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

प्रदर्शन समस्याएँ

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

सामान्य समस्याएँ

GitHub Copilot
- यदि आपको GitHub Copilot के साथ समस्याएँ आती हैं, तो mcp.json फ़ाइल में सर्वर को शुरू/बंद/पुनः आरंभ करने का प्रयास करें और एक समय में केवल एक सर्वर चालू रखें।
प्रमाणपत्र समस्याएँ
- यदि आपको प्रमाणपत्र समस्याएँ आती हैं, जैसे [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate:
  - जाँचें कि क्या आप SSL सत्यापन के साथ curl या wget का उपयोग करके Instana API एंडपॉइंट तक पहुँच सकते हैं।
    - यदि वह काम करता है, तो आपका Python परिवेश प्रमाणपत्र सत्यापित करने में सक्षम नहीं हो सकता है और हो सकता है कि उसके पास आपके शेल या सिस्टम के समान प्रमाणपत्रों तक पहुँच न हो। सुनिश्चित करें कि आपका Python परिवेश सिस्टम प्रमाणपत्रों (macOS) का उपयोग करता है। आप Python में प्रमाणपत्र इंस्टॉल करके ऐसा कर सकते हैं: //Applications/Python\ 3.13/Install\ Certificates.command
  - यदि आप SSL सत्यापन के साथ एंडपॉइंट तक नहीं पहुँच सकते हैं, तो इसके बिना प्रयास करें। यदि वह काम करता है, तो अपने सिस्टम के CA प्रमाणपत्रों की जाँच करें और सुनिश्चित करें कि वे अद्यतित हैं।