IBM Instana MCP Server

chính thức

Máy chủ IBM Instana MCP cho phép tương tác liền mạch với nền tảng quan sát IBM Instana, giúp bạn truy cập dữ liệu quan sát thời gian thực trực tiếp trong quy trình phát triển của mình.

GitHub

Bạn có thể làm gì với IBM Instana MCP?

Truy xuất ảnh chụp nhanh cơ sở hạ tầng — Yêu cầu ảnh chụp nhanh của một host, tiến trình hoặc container cụ thể bằng cách sử dụng get_infra_snapshot.
Phân tích số liệu ứng dụng hoặc dịch vụ — Yêu cầu số liệu chuỗi thời gian cho các cuộc gọi, lỗi hoặc độ trễ bằng get_app_metrics hoặc get_service_metrics.
Liệt kê cảnh báo và sự cố đang hoạt động — Lấy các cảnh báo, sự cố hoặc cảnh báo thông minh toàn cầu hiện tại qua get_alerts và get_incidents.
Kiểm tra sự kiện Kubernetes — Kéo các sự kiện Kubernetes gần đây cho một cluster hoặc namespace bằng get_k8s_events.
Truy vấn dữ liệu giám sát trang web — Lấy số liệu hiệu suất trang web hoặc kết quả beacon thông qua get_website_metrics.

Tài liệu

Mục lục

Máy chủ MCP cho IBM Instana

Máy chủ MCP cho IBM Instana

📚 Liên kết nhanh

Công cụ & Ví dụ - Tài liệu công cụ toàn diện với các ví dụ thực tế
Chính sách quyền riêng tư - Thông tin về xử lý dữ liệu và quyền riêng tư
Hướng dẫn triển khai Docker - Triển khai Docker toàn diện, xây dựng đa kiến trúc và thiết lập production

Máy chủ Instana MCP cho phép tương tác liền mạch với nền tảng quan sát Instana, cho phép bạn truy cập dữ liệu quan sát thời gian thực trực tiếp trong quy trình phát triển của mình.

Nó đóng vai trò là cầu nối giữa các máy khách (như tác nhân AI hoặc công cụ tùy chỉnh) và API REST của Instana, chuyển đổi các truy vấn của người dùng thành yêu cầu API Instana và định dạng phản hồi thành các định dạng có cấu trúc, dễ sử dụng.

Máy chủ hỗ trợ cả hai chế độ truyền tải HTTP có thể truyền phát và Stdio để tương thích tối đa với các máy khách MCP khác nhau. Để biết thêm chi tiết, hãy tham khảo đặc tả Chế độ truyền tải MCP.

Tổng quan kiến trúc

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

Luồng công việc

Xét một ví dụ đơn giản: Bạn đang sử dụng MCP Host (như Claude Desktop, VS Code hoặc một máy khách khác) được kết nối với Máy chủ Instana MCP. Khi bạn yêu cầu thông tin về các cảnh báo Instana, quy trình sau sẽ diễn ra:

Máy khách MCP truy xuất danh sách các công cụ có sẵn từ máy chủ Instana MCP
Truy vấn của bạn được gửi đến LLM cùng với mô tả công cụ
LLM phân tích các công cụ có sẵn và chọn (các) công cụ phù hợp để truy xuất cảnh báo Instana
Máy khách thực thi (các) công cụ đã chọn thông qua máy chủ Instana MCP
Kết quả (cảnh báo mới nhất) được trả về cho LLM
LLM xây dựng phản hồi bằng ngôn ngữ tự nhiên
Phản hồi được hiển thị cho bạn

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

Điều kiện tiên quyết

Tùy chọn 1: Cài đặt từ PyPI (Khuyến nghị)

Cách dễ nhất để sử dụng mcp-instana là cài đặt trực tiếp từ PyPI:

pip install mcp-instana

Sau khi cài đặt, bạn có thể chạy máy chủ bằng lệnh mcp-instana trực tiếp.

Tùy chọn 2: Cài đặt phát triển

Để phát triển hoặc tùy chỉnh cục bộ, bạn có thể sao chép và thiết lập dự án cục bộ.

Cài đặt uv

Dự án này sử dụng uv, một trình cài đặt và giải quyết gói Python nhanh. Để cài đặt uv, bạn có một số tùy chọn:

Sử dụng pip:

pip install uv

Sử dụng Homebrew (macOS):

brew install uv

Để biết thêm các tùy chọn cài đặt và hướng dẫn chi tiết, hãy truy cập tài liệu uv.

Thiết lập môi trường

Sau khi cài đặt uv, hãy thiết lập môi trường dự án bằng cách chạy:

uv sync

Xác thực dựa trên Header cho chế độ HTTP có thể truyền phát

Khi sử dụng chế độ HTTP có thể truyền phát, bạn phải truyền thông tin xác thực Instana qua các header HTTP. Cách tiếp cận này tăng cường bảo mật và tính linh hoạt bằng cách:

Tránh lưu trữ thông tin xác thực trong biến môi trường
Cho phép sử dụng thông tin xác thực khác nhau cho các yêu cầu khác nhau
Hỗ trợ môi trường dùng chung nơi việc sửa đổi biến môi trường bị hạn chế
Hỗ trợ cả xác thực dựa trên API token và session

Các chế độ xác thực được hỗ trợ:

1. Xác thực bằng API Token (Gọi API trực tiếp)

Header bắt buộc:

instana-base-url: URL phiên bản Instana của bạn
instana-api-token: API token Instana của bạn

Ví dụ:

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

2. Xác thực bằng Session Token (Gọi từ giao diện người dùng)

Header bắt buộc:

instana-base-url: URL phiên bản Instana của bạn
instana-auth-token: Token xác thực phiên từ backend giao diện người dùng
instana-csrf-token: Token CSRF từ backend giao diện người dùng
instana-cookie-name: (Tùy chọn) Tên cookie cho xác thực phiên (mặc định: instanaAuthToken)

Ví dụ:

--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. Xác thực bằng JWT Token (Tích hợp nền tảng IBM)

Header bắt buộc:

instana-base-url: URL phiên bản Instana của bạn
instana-jwt-token: JWT token từ nền tảng IBM
instana-csrf-token: Token CSRF để xác thực yêu cầu

Ví dụ cấu hình:

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

Ưu tiên xác thực:

JWT Token (nếu được cung cấp cùng token CSRF) - Được ưu tiên cho tích hợp nền tảng IBM
Session Token (nếu cả auth_token và csrf_token được cung cấp)
API Token (nếu được cung cấp) - Xác thực tiêu chuẩn
Biến môi trường (INSTANA_API_TOKEN) - Dự phòng

Luồng xác thực:

Các header HTTP phải có mặt trong mỗi yêu cầu
Máy chủ xác thực thông tin đăng nhập dựa trên thứ tự ưu tiên
Các yêu cầu không có xác thực hợp lệ sẽ thất bại

Thiết kế này đảm bảo truyền tải thông tin xác thực an toàn và hỗ trợ nhiều luồng xác thực bao gồm các cuộc gọi do giao diện người dùng khởi tạo qua WebSocket → Coordinator → MCP Server.

Đảm bảo rằng token được sử dụng có các quyền cần thiết để gọi các công cụ MCP. Kiểm tra tại đây để biết thêm thông tin.

Khởi động máy chủ MCP cục bộ

Trước khi cấu hình bất kỳ máy khách MCP nào (Claude Desktop, GitHub Copilot hoặc các máy khách MCP tùy chỉnh), bạn cần khởi động máy chủ MCP cục bộ. Máy chủ hỗ trợ hai chế độ truyền tải: HTTP có thể truyền phát và Stdio.

Tùy chọn lệnh máy chủ

Sử dụng CLI (Cài đặt PyPI)

Nếu bạn đã cài đặt mcp-instana từ PyPI, hãy sử dụng lệnh mcp-instana:

mcp-instana [OPTIONS]

Sử dụng cài đặt phát triển

Đối với phát triển cục bộ, hãy sử dụng lệnh uv run:

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

Tùy chọn có sẵn:

--transport <mode>: Chế độ truyền tải (lựa chọn: streamable-http, stdio)
--env KEY=VALUE: Đặt biến môi trường (có thể lặp lại cho nhiều biến, ví dụ: --env INSTANA_BASE_URL=https://... --env INSTANA_API_TOKEN=...)
--debug: Bật chế độ gỡ lỗi với ghi nhật ký bổ sung
--log-level <level>: Đặt mức ghi nhật ký (lựa chọn: DEBUG, INFO, WARNING, ERROR, CRITICAL)
--tools <categories>: Danh sách các danh mục công cụ được phân tách bằng dấu phẩy để kích hoạt (ví dụ: infra,app,events,website). Kích hoạt một danh mục cũng sẽ kích hoạt các prompt liên quan của nó. Ví dụ: --tools infra kích hoạt các công cụ infra và tất cả các prompt liên quan đến infra.
--list-tools: Liệt kê tất cả các danh mục công cụ có sẵn và thoát
--port <port>: Cổng máy chủ MCP (mặc định: 8080, có thể được ghi đè bằng biến môi trường PORT)
--help: Hiển thị thông báo trợ giúp và thoát

Khởi động ở chế độ HTTP có thể truyền phát

Chế độ HTTP có thể truyền phát cung cấp giao diện API REST và được khuyến nghị cho hầu hết các trường hợp sử dụng.

Sử dụng CLI (Cài đặt 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

Sử dụng cài đặt phát triển

# 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

Các tính năng chính của chế độ HTTP có thể truyền phát:

Sử dụng header HTTP để xác thực (không cần biến môi trường)
Hỗ trợ thông tin xác thực khác nhau cho mỗi yêu cầu
Phù hợp hơn cho môi trường dùng chung
Cổng mặc định của máy chủ MCP: 8080
Điểm cuối MCP: http://0.0.0.0:8080/mcp/

Khởi động ở chế độ Stdio

Chế độ Stdio sử dụng đầu vào/đầu ra tiêu chuẩn để giao tiếp và yêu cầu biến môi trường để xác thực.

Sử dụng CLI (Cài đặt 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

Sử dụng cài đặt phát triển

# 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

Các tính năng chính của chế độ Stdio:

Sử dụng biến môi trường để xác thực (có thể được đặt qua cờ export hoặc --env)
Giao tiếp trực tiếp qua stdin/stdout
Yêu cầu cho một số cấu hình máy khách MCP nhất định
Cờ --env cung cấp cách thuận tiện để đặt thông tin xác thực mà không cần sửa đổi môi trường shell

Danh mục công cụ

Bạn có thể tối ưu hóa hiệu suất máy chủ bằng cách chỉ kích hoạt các danh mục công cụ và prompt bạn cần:

Sử dụng CLI (Cài đặt 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

Sử dụng cài đặt phát triển

# 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

Danh mục có sẵn:

infra: Công cụ và prompt giám sát cơ sở hạ tầng (tài nguyên, catalog, topology, analyze, metrics)
app: Công cụ và prompt hiệu suất ứng dụng (tài nguyên, metrics, alerts, catalog, topology, analyze, settings, global alerts)
events: Công cụ và prompt giám sát sự kiện (sự kiện Kubernetes, giám sát agent)
website: Công cụ và prompt giám sát website (metrics, catalog, analyze, configuration)

Xác minh trạng thái máy chủ

Sau khi khởi động, bạn có thể xác minh máy chủ đang chạy:

Đối với chế độ HTTP có thể truyền phát:

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

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

Đối với chế độ Stdio: Máy chủ sẽ khởi động và chờ đầu vào stdin từ các máy khách MCP.

Các sự cố khởi động thường gặp

Sự cố chứng chỉ: Nếu bạn gặp lỗi chứng chỉ SSL, hãy đảm bảo môi trường Python của bạn có quyền truy cập vào chứng chỉ hệ thống:

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

Cổng đã được sử dụng: Nếu cổng 8080 đã được sử dụng, hãy chỉ định một cổng khác:

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

Thiếu phụ thuộc: Đảm bảo tất cả các phụ thuộc đã được cài đặt:

uv sync

Thiết lập và sử dụng

Bob IDE

Bob là IDE hỗ trợ AI của IBM, hỗ trợ tích hợp MCP một cách tự nhiên. Bob cung cấp trải nghiệm phát triển liền mạch với trợ lý AI tích hợp và các công cụ quan sát.

Chế độ HTTP có thể truyền phát

Chế độ HTTP có thể truyền phát cung cấp giao diện REST API cho giao tiếp MCP sử dụng JSON-RPC qua HTTP.

Bước 1: Khởi động MCP Server ở Chế độ HTTP có thể truyền phát

Trước khi cấu hình Bob, bạn cần khởi động MCP server ở chế độ HTTP có thể truyền phát. Vui lòng tham khảo phần Khởi động MCP Server Cục bộ để biết hướng dẫn chi tiết.

Bước 2: Cấu hình Bob

Ở góc trên bên phải của bảng điều khiển Bob, bạn sẽ thấy một menu thả xuống với các MCP server:

Khi chọn mục này, bạn sẽ thấy tùy chọn để cấu hình MCP ở cấp độ dự án hoặc cấp độ toàn cục.

Phạm vi Cấu hình MCP

Bob hỗ trợ hai cấp độ cấu hình MCP, cho phép bạn chọn phạm vi phù hợp nhất với trường hợp sử dụng của mình:

1. Cấu hình Toàn cục (Cấp độ Người dùng)

Cấu hình toàn cục áp dụng MCP server cho tất cả các dự án của người dùng hiện tại. Điều này lý tưởng khi bạn muốn các MCP server giống nhau có sẵn trong mọi dự án bạn làm việc.

Vị trí Tệp:

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

2. Cấu hình Dự án (Cấp độ Dự án)

Cấu hình dự án chỉ áp dụng MCP server cho một dự án cụ thể. Điều này hữu ích khi các dự án khác nhau yêu cầu cấu hình MCP server khác nhau hoặc khi bạn muốn chia sẻ cài đặt MCP với nhóm của mình thông qua kiểm soát phiên bản.

Vị trí Tệp:

.bob/bob_config.json trong thư mục gốc của dự án

Lựa chọn giữa Cấu hình Toàn cục và Dự án:

Sử dụng cấu hình toàn cục cho các MCP server bạn muốn có sẵn trên tất cả các dự án
Sử dụng cấu hình dự án cho các MCP server cụ thể của dự án hoặc để chia sẻ cấu hình với nhóm của bạn
Cả hai cấu hình có thể cùng tồn tại - cài đặt cấp dự án được ưu tiên hơn cài đặt toàn cục cho cùng một tên server

Để biết thêm thông tin về Bob và cấu hình MCP, hãy truy cập: https://bob.ibm.com/docs/ide/configuration/mcp/mcp-in-bob

Cấu hình Cục bộ:

Cấu hình Bob để kết nối với Instana MCP server cục bộ của bạ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"
      ]
    }
  }
}

Cấu hình Từ xa:

Cấu hình Bob để kết nối với Instana MCP server từ xa (ví dụ: được triển khai trên 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"
      ]
    }
  }
}

Lưu ý: Để sử dụng npx, chúng tôi khuyên bạn nên cài đặt NVM (Node Version Manager) trước, sau đó sử dụng nó để cài đặt Node.js. Hướng dẫn cài đặt có sẵn tại: https://nodejs.org/en/download

Bước 3: Kiểm tra Kết nối

Sau khi bạn thiết lập cấu hình MCP, MCP server mới được cấu hình sẽ hiển thị là đã được kích hoạt. Một chấm xanh cho biết server đang chạy thành công.

Bây giờ bạn có thể chạy các truy vấn trong Bob IDE:

get me all applications from Instana in the last 24 hours

Chế độ Stdio

Cấu hình sử dụng CLI (Cài đặt PyPI - Khuyến nghị):

Tùy chọn 1: Sử dụng biến môi trường trong cấu hình:

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

Tùy chọn 2: Sử dụng cờ --env (phương pháp thay thế):

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

Lưu ý: Nếu bạn gặp lỗi "không tìm thấy lệnh", hãy sử dụng đường dẫn đầy đủ đến mcp-instana. Tìm nó bằng which mcp-instana và sử dụng đường dẫn đó thay thế.

Cấu hình sử dụng Cài đặt Phát triển:

Tùy chọn 1: Sử dụng biến môi trường trong cấu hình:

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

Tùy chọn 2: Sử dụng cờ --env (phương pháp thay thế):

{
  "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 hỗ trợ cả hai chế độ HTTP có thể truyền phát và Stdio để tích hợp MCP.

Cấu hình Claude Desktop bằng cách chỉnh sửa tệp cấu hình:

Vị trí Tệp:

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

Chế độ HTTP có thể truyền phát

Chế độ HTTP có thể truyền phát cung cấp giao diện REST API cho giao tiếp MCP sử dụng JSON-RPC qua HTTP.

Bước 1: Khởi động MCP Server ở Chế độ HTTP có thể truyền phát

Trước khi cấu hình Claude Desktop, bạn cần khởi động MCP server ở chế độ HTTP có thể truyền phát. Vui lòng tham khảo phần Khởi động MCP Server Cục bộ để biết hướng dẫn chi tiết.

Bước 2: Cấu hình Claude Desktop

Cấu hình Claude Desktop để truyền thông tin xác thực Instana qua các tiêu đề:

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

Bước 3: Kiểm tra Kết nối

Khởi động lại Claude Desktop. Bây giờ bạn sẽ thấy Instana MCP Server trong giao diện Claude Desktop như hiển thị bên dưới:

Bây giờ bạn có thể chạy các truy vấn trong Claude Desktop:

get me all endpoints from Instana

Chế độ Stdio

Cấu hình sử dụng CLI (Cài đặt PyPI - Khuyến nghị):

Tùy chọn 1: Sử dụng biến môi trường trong cấu hình:

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

Tùy chọn 2: Sử dụng cờ --env (phương pháp thay thế):

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

Cấu hình sử dụng Cài đặt Phát triển:

Tùy chọn 1: Sử dụng biến môi trường trong cấu hình:

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

Tùy chọn 2: Sử dụng cờ --env (phương pháp thay thế):

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

Thiết lập Kiro

Kiro là một IDE tác nhân, không phải là một tiện ích mở rộng có thể tải xuống vào VS Code hoặc một số IDE khác.

Bước 1: Tải xuống và cài đặt Kiro cho hệ điều hành của bạn từ https://kiro.dev/.

Bước 2: Sau khi cài đặt, khởi chạy Kiro và mở bất kỳ dự án nào trong IDE. alt text

Bước 3: Nhấp vào biểu tượng Kiro (Ghost) trên thanh bên trái để truy cập các tính năng của Kiro. alt text

Bước 4: Chọn biểu tượng Chỉnh sửa Cấu hình ở góc trên bên phải của phần MCP Servers. alt text

Bước 5: Mở tệp cấu hình MCP server (mcp.json) và cấu hình dựa trên chế độ truyền tải ưa thích của bạn:

Chế độ HTTP có thể truyền phát (Khuyến nghị cho 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"
      ]
    }
  }
}

Lưu ý: Đảm bảo khởi động MCP server ở chế độ streamable-http trước khi sử dụng cấu hình này:

mcp-instana --transport streamable-http

Chế độ Stdio

Tùy chọn 1: Sử dụng biến môi trường trong cấu hình:

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

Tùy chọn 2: Sử dụng cờ --env (phương pháp thay thế):

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

Bước 6: Sau khi lưu tệp, Nhấp vào nút Enable MCP và bạn sẽ thấy MCP server của mình cùng các công cụ có sẵn xuất hiện ở phần dưới cùng bên trái của Kiro. alt text

Bước 7: Đi tới bảng AI Chat, nhập một lời nhắc liên quan đến MCP server của bạn và xem phản hồi trực tiếp trong Kiro. alt text

GitHub Copilot

GitHub Copilot hỗ trợ tích hợp MCP thông qua cấu hình VS Code. Để tích hợp GitHub Copilot với VS Code, hãy tham khảo hướng dẫn thiết lập này.

Chế độ HTTP có thể truyền phát

Bước 1: Khởi động MCP Server ở Chế độ HTTP có thể truyền phát

Trước khi cấu hình VS Code, bạn cần khởi động MCP server ở chế độ HTTP có thể truyền phát. Vui lòng tham khảo phần Khởi động MCP Server Cục bộ để biết hướng dẫn chi tiết.

Bước 2: Cấu hình VS Code

Tham khảo Sử dụng MCP server trong VS Code để biết cấu hình chi tiết.

Bạn có thể trực tiếp tạo hoặc cập nhật .vscode/mcp.json với cấu hình sau:

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

Lưu ý: Thay thế các giá trị sau bằng cấu hình thực tế của bạn:

instana-base-url: URL phiên bản Instana của bạn
instana-api-token: Mã thông báo API Instana của bạn
command: Cập nhật đường dẫn npx để khớp với cài đặt Node.js trên hệ thống của bạn (ví dụ: /path/to/your/node/bin/npx)
Biến môi trường: Điều chỉnh PATH và các biến môi trường khác khi cần thiết cho hệ thống của bạn

Chế độ Stdio

Bước 1: Tạo Cấu hình MCP cho VS Code

Sử dụng CLI (Cài đặt PyPI - Khuyến nghị):

Tạo .vscode/mcp.json trong thư mục gốc của dự án:

Tùy chọn 1: Sử dụng biến môi trường trong cấu hình:

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

Tùy chọn 2: Sử dụng cờ --env (phương pháp thay thế):

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

Sử dụng Cài đặt Phát triển:

Tạo .vscode/mcp.json trong thư mục gốc của dự án:

Tùy chọn 1: Sử dụng biến môi trường trong cấu hình:

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

Tùy chọn 2: Sử dụng cờ --env (phương pháp thay thế):

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

Lưu ý: Thay thế các giá trị sau bằng cấu hình thực tế của bạn:

Đối với cài đặt CLI: Đảm bảo mcp-instana nằm trong PATH của bạn
Đối với cài đặt phát triển:
- command: Cập nhật đường dẫn uv để khớp với cài đặt uv trên hệ thống của bạn (ví dụ: /path/to/your/uv/bin/uv hoặc /usr/local/bin/uv)
- --directory: Cập nhật bằng đường dẫn tuyệt đối đến thư mục dự án mcp-instana của bạn
INSTANA_BASE_URL: URL phiên bản Instana của bạn
INSTANA_API_TOKEN: Mã thông báo API Instana của bạn

Bước 2: Quản lý Server trong VS Code

Mở .vscode/mcp.json - bạn sẽ thấy các điều khiển quản lý server ở trên cùng
Nhấp vào Start bên cạnh Instana MCP Server để khởi động server
Trạng thái đang chạy cùng với số lượng công cụ cho biết server đang chạy

Bước 3: Kiểm tra Tích hợp

Chuyển sang Chế độ Tác nhân trong GitHub Copilot và tải lại các công cụ. Đây là một ví dụ về phản hồi của GitHub Copilot:

GitHub Copilot Response

Mistral AI

Mistral AI hỗ trợ tích hợp MCP độc quyền thông qua chế độ HTTP có thể truyền phát.

Bước 1: Khởi chạy MCP Server ở Chế độ HTTP có thể truyền phát

Khởi động MCP server ở chế độ HTTP có thể truyền phát bằng cách cung cấp thông tin xác thực Instana của bạn. Chạy lệnh sau:

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

Bước 2: Thiết lập Chuyển tiếp Cổng với Ngrok

Cấu hình chuyển tiếp cổng để hiển thị server cục bộ của bạn. Làm theo tài liệu thiết lập Ngrok để biết hướng dẫn chi tiết.

Bước 3: Cấu hình Mistral AI

Điều hướng đến tab Intelligence trong thanh bên trái và chọn Connectors
Nhấp vào Add Connector
Tạo một trình kết nối tùy chỉnh bằng cách nhập tên trình kết nối và URL MCP server đã được chuyển tiếp qua Ngrok
Bắt đầu một phiên trò chuyện mới và xác minh rằng các công cụ MCP đã được kích hoạt. Bạn có thể xem phản hồi tại đây

Các Tính năng được Hỗ trợ

Công cụ Có sẵn

Công cụ	Danh mục	Mô tả
`manage_applications`	Ứng dụng & Cơ sở hạ tầng	Công cụ hợp nhất để quản lý chỉ số ứng dụng, cấu hình cảnh báo, cài đặt và danh mục
`manage_websites`	Giám sát Website	Bộ định tuyến thông minh hợp nhất cho các thao tác phân tích, danh mục, cấu hình và cấu hình nâng cao của website
`manage_custom_dashboards`	Bảng điều khiển Tùy chỉnh	Công cụ hợp nhất để quản lý các thao tác CRUD bảng điều khiển tùy chỉnh
`analyze_infrastructure`	Phân tích Cơ sở hạ tầng	Phân tích cơ sở hạ tầng hai lượt với thu thập thực thể/chỉ số
`manage_automation`	Tự động hóa	Bộ định tuyến thông minh hợp nhất cho tự động hóa: duyệt danh mục hành động và xem lịch sử thực thi
`manage_events`	Sự kiện	Bộ định tuyến thông minh hợp nhất cho giám sát sự kiện: lấy sự kiện theo ID, lấy sự kiện theo nhiều ID, sự kiện Kubernetes, sự kiện giám sát tác nhân và tất cả sự kiện
`manage_slo`	Quản lý SLO	Bộ định tuyến thông minh hợp nhất cho cấu hình SLO, báo cáo, cảnh báo và cửa sổ hiệu chỉnh với xử lý múi giờ thông minh
`manage_releases`	Quản lý Phát hành	Bộ định tuyến thông minh hợp nhất cho theo dõi phát hành: liệt kê phát hành với phân trang và lọc theo tên, lấy chi tiết phát hành, tạo/cập nhật/xóa phát hành với hỗ trợ múi giờ
`manage_maintenance_windows`	Cửa sổ Bảo trì	Bộ định tuyến thông minh hợp nhất cho quản lý vòng đời cửa sổ bảo trì: tạo, sửa, đóng và liệt kê cửa sổ bảo trì với hỗ trợ mẫu và tích hợp ServiceNow
`manage_mobile_apps`	Giám sát Ứng dụng Di động	Bộ định tuyến thông minh hợp nhất cho giám sát ứng dụng di động: phân tích beacon, chỉ số hiệu suất, cấu hình và quản lý cảnh báo

👉 Để có tài liệu công cụ chi tiết, khả năng và tham khảo kỹ thuật, xem Công cụ & Ví dụ

Lọc Công cụ

Máy chủ MCP hỗ trợ tải công cụ có chọn lọc để tối ưu hiệu suất và giảm sử dụng tài nguyên. Bạn có thể chỉ bật các danh mục công cụ cần thiết cho trường hợp sử dụng cụ thể của mình.

Danh mục Công cụ Có sẵn

router: Quản lý ứng dụng và cơ sở hạ tầng hợp nhất
- manage_instana_resources: Công cụ duy nhất cho chỉ số ứng dụng, cấu hình cảnh báo, cài đặt và danh mục
- Hỗ trợ góc nhìn ứng dụng, điểm cuối, dịch vụ và dịch vụ thủ công
- Quản lý cả cấu hình cảnh báo cụ thể cho ứng dụng và toàn cục
- Cung cấp quyền truy cập vào danh mục thẻ ứng dụng và danh mục chỉ số
dashboard: Quản lý bảng điều khiển tùy chỉnh
- manage_custom_dashboards: Thao tác CRUD cho bảng điều khiển tùy chỉnh
- Hỗ trợ tạo, truy xuất, cập nhật và xóa bảng điều khiển
- Quản lý người dùng và token API có thể chia sẻ cho bảng điều khiển
infra: Công cụ phân tích cơ sở hạ tầng
- analyze_infrastructure: Phân tích cơ sở hạ tầng hai lượt với thu thập thực thể/chỉ số
- Hỗ trợ động tất cả loại thực thể có sẵn trong cài đặt Instana của bạn (tự động tải từ danh mục API)
- Bao gồm JVM, Kubernetes, Docker, máy chủ, cơ sở dữ liệu, hàng đợi tin nhắn và bất kỳ loại thực thể tùy chỉnh hoặc mới thêm nào
- Tổng hợp chỉ số linh hoạt, lọc, nhóm và truy vấn khoảng thời gian
automation: Công cụ hành động tự động hóa
- manage_automation: Bộ định tuyến thông minh hợp nhất cho danh mục tự động hóa và lịch sử thực thi
- Danh mục Hành động: duyệt hành động, lấy chi tiết, tìm kiếm theo tên/mô tả, lọc theo ID ứng dụng hoặc ảnh chụp nhanh
- Lịch sử Hành động: liệt kê phiên bản thực thi với bộ lọc, lấy chi tiết thực thi
events: Công cụ giám sát sự kiện
- Sự kiện: Sự kiện Kubernetes, giám sát tác nhân và theo dõi sự kiện hệ thống
website: Công cụ giám sát website
- Chỉ số Website: Đo lường hiệu suất cho website
- Danh mục Website: Siêu dữ liệu và định nghĩa website
- Phân tích Website: Phân tích hiệu suất website
- Cấu hình Website: Quản lý cấu hình website
slo: Quản lý Mục tiêu Mức Dịch vụ (SLO)
- manage_slo: Bộ định tuyến thông minh hợp nhất cho các thao tác SLO toàn diện
- Quản lý Cấu hình: Tạo, đọc, cập nhật, xóa cấu hình SLO với hỗ trợ chỉ báo dựa trên thời gian và sự kiện
- Tạo Báo cáo: Tạo báo cáo SLO chi tiết với giá trị SLI, ngân sách lỗi, tỷ lệ tiêu hao và biểu đồ chuỗi thời gian
- Cấu hình Cảnh báo: Quản lý cấu hình cảnh báo SLO để giám sát ngân sách lỗi và theo dõi tỷ lệ tiêu hao
- Cửa sổ Hiệu chỉnh: Tạo và quản lý cửa sổ bảo trì để loại trừ thời gian ngừng hoạt động có kế hoạch khỏi tính toán SLO
- Xử lý Múi giờ Thông minh: Tự động thu thập múi giờ cho đầu vào datetime để đảm bảo ngữ cảnh thời gian chính xác
- Thu thập Hai lượt: Thu thập tham số tương tác cho các thao tác phức tạp yêu cầu nhiều đầu vào
releases: Theo dõi phát hành và quản lý triển khai
- manage_releases: Bộ định tuyến thông minh hợp nhất cho thao tác phát hành
- Liệt kê Phát hành: Lấy tất cả phát hành với phân trang hiệu quả (page_number, page_size) và lọc theo tên
- Chi tiết Phát hành: Truy xuất thông tin phát hành cụ thể theo ID bao gồm ứng dụng, dịch vụ và phạm vi
- Tạo/Cập nhật/Xóa: Thao tác CRUD đầy đủ cho quản lý phát hành
- Xử lý Múi giờ Thông minh: Tự động thu thập múi giờ cho thời gian bắt đầu phát hành
- Phân trang Hiệu quả: Tránh tải dữ liệu dư thừa với điều hướng dựa trên trang hợp lý
- Lọc theo Tên: So khớp chuỗi con không phân biệt hoa thường để tìm phát hành theo tên
maintenance_window: Quản lý vòng đời cửa sổ bảo trì
- manage_maintenance_windows: Bộ định tuyến thông minh hợp nhất cho thao tác cửa sổ bảo trì
- Thao tác Cửa sổ: Tạo, sửa, đóng và liệt kê cửa sổ bảo trì (đang hoạt động, đã lên lịch, tất cả, đã hết hạn)
- Thao tác Hàng loạt: Tạo cửa sổ bảo trì cho nhiều ứng dụng đồng thời
- Hỗ trợ Mẫu: Mẫu định sẵn cho các tình huống phổ biến (triển khai, di chuyển cơ sở dữ liệu, nâng cấp cơ sở hạ tầng, khẩn cấp, định kỳ)
- Cửa sổ Định kỳ: Hỗ trợ cửa sổ bảo trì định kỳ sử dụng định dạng RFC 5545 RRULE
- Tích hợp ServiceNow: Tích hợp tùy chọn với yêu cầu thay đổi ServiceNow
- Xác thực: Xác thực tham số trước khi tạo cửa sổ
- Thời lượng Linh hoạt: Chỉ định thời lượng bằng phút, giờ hoặc ngày
mobile_app: Giám sát ứng dụng di động
- manage_mobile_apps: Bộ định tuyến thông minh hợp nhất cho các thao tác giám sát ứng dụng di động
- Phân tích Beacon: Truy vấn dữ liệu beacon của ứng dụng di động với khả năng nhóm và lọc
- Chỉ số Hiệu suất: Theo dõi thời lượng phiên, tỷ lệ sự cố và hiệu suất yêu cầu HTTP
- Phân tích Địa lý: Phân tích phân bố người dùng theo quốc gia, thành phố và khu vực
- Phân tích Thiết bị: Giám sát hiệu suất trên các thiết bị, nền tảng và phiên bản hệ điều hành khác nhau
- Quản lý Cấu hình: Quản lý cấu hình ứng dụng di động, vị trí địa lý và cài đặt che IP
- Quản lý Cảnh báo: Cấu hình và quản lý cấu hình cảnh báo cho ứng dụng di động

Ví dụ Sử dụng

Sử dụng CLI (Cài đặt qua 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

Sử dụng Cài đặt Phát triển

# 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

Lợi ích của Lọc Công cụ

Hiệu suất: Giảm thời gian khởi động và sử dụng bộ nhớ
Bảo mật: Hạn chế tiếp xúc chỉ với các API cần thiết
Rõ ràng: Tập trung vào các trường hợp sử dụng cụ thể (ví dụ: chỉ giám sát cơ sở hạ tầng)
Hiệu quả Tài nguyên: Giảm sử dụng CPU và mạng

👉 Để biết ví dụ sử dụng và lời nhắc, xem Lời nhắc Ví dụ

Triển khai Docker

Máy chủ MCP Instana có thể được triển khai bằng Docker cho môi trường sản xuất. Thiết lập Docker được tối ưu hóa cho bảo mật, hiệu suất và sử dụng tài nguyên tối thiểu.

Kiến trúc Docker

Dự án sử dụng chiến lược quản lý phụ thuộc hai tệp:

pyproject.toml

Mục đích: Cấu hình hợp nhất cho cả phát triển và sản xuất
Phụ thuộc: Tất cả các phụ thuộc thiết yếu cùng với các phụ thuộc phát triển tùy chọn
Cách dùng: Phát triển cục bộ, kiểm thử, CI/CD và các bản dựng Docker sản xuất
Lợi ích: Nguồn thông tin duy nhất cho mọi phụ thuộc, đơn giản hóa việc bảo trì

Xây dựng Ảnh Docker

Điều kiện tiên quyết

Docker đã được cài đặt và đang chạy
Có quyền truy cập vào mã nguồn dự án
Docker BuildKit cho các bản dựng đa kiến trúc (được bật theo mặc định trong các phiên bản Docker gần đây)

Lệnh Xây dựng

# 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

📖 Để có tài liệu Docker toàn diện bao gồm các bản dựng đa kiến trúc, thiết lập Docker Compose, các phương pháp bảo mật tốt nhất và ví dụ triển khai sản xuất, xem DOCKER.md.

Khắc phục sự cố

Sự cố Docker

Container Không Khởi động

# 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

Sự cố Kết nối

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

Sự cố Hiệu suất

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

Sự cố Chung

GitHub Copilot
- Nếu bạn gặp sự cố với GitHub Copilot, hãy thử khởi động/dừng/khởi động lại máy chủ trong tệp mcp.json và chỉ giữ một máy chủ chạy tại một thời điểm.
Sự cố Chứng chỉ
- Nếu bạn gặp sự cố chứng chỉ, chẳng hạn như [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate:
  - Kiểm tra xem bạn có thể truy cập điểm cuối API Instana bằng curl hoặc wget với xác minh SSL hay không.
    - Nếu được, môi trường Python của bạn có thể không xác minh được chứng chỉ và có thể không có quyền truy cập vào cùng các chứng chỉ như shell hoặc hệ thống của bạn. Đảm bảo môi trường Python của bạn sử dụng chứng chỉ hệ thống (macOS). Bạn có thể thực hiện việc này bằng cách cài đặt chứng chỉ vào Python: //Applications/Python\ 3.13/Install\ Certificates.command
  - Nếu bạn không thể truy cập điểm cuối với xác minh SSL, hãy thử mà không có nó. Nếu cách đó hoạt động, hãy kiểm tra chứng chỉ CA của hệ thống và đảm bảo chúng được cập nhật.