Last9

{
  "mcp": {
    "servers": {
      "last9": {
        "type": "stdio",
        "command": "/opt/homebrew/bin/last9-mcp",
        "env": {
          "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
        }
      }
    }
  }
}

NPM के लिए: "command": "npx" का उपयोग करें और "args": ["-y", "@last9/mcp-server@latest"] जोड़ें।

GitHub Releases से डाउनलोड करने के बाद, निकालें और पूर्ण पथ पर इंगित करें:

{
  "mcpServers": {
    "last9": {
      "command": "C:\\Users\\<user>\\AppData\\Local\\Programs\\last9-mcp-server.exe",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

Windows पर NPM मार्ग आसान है — कोई पथ प्रबंधन नहीं।

HTTP मोड में चलाएँ

export LAST9_REFRESH_TOKEN="your_refresh_token"
export LAST9_HTTP=true
export LAST9_PORT=8080
./last9-mcp-server

सर्वर http://localhost:8080/mcp पर शुरू होता है।

curl के साथ परीक्षण करें

Streamable HTTP हैंडलर स्टेटलेस मोड में चलता है, इसलिए कोई भी अनुरोध स्वतंत्र रूप से परोसा जाता है। एक initialize हैंडशेक और एक Mcp-Session-Id हेडर वैकल्पिक हैं — जो क्लाइंट उन्हें भेजते हैं वे अभी भी काम करते हैं (हेडर स्वीकार किया जाता है और अनदेखा किया जाता है), और क्लाइंट सीधे tools/list / tools/call पर भी जा सकते हैं। हर टूल एक स्वतंत्र अनुरोध/प्रतिक्रिया क्वेरी है; सर्वर कोई सर्वर→क्लाइंट सूचनाएँ जारी नहीं करता, इसलिए GET /mcp (SSE स्ट्रीम) 405 लौटाता है।

# List tools — a session handshake is optional in stateless mode
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Call a tool
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "tools/call",
      "params": {
        "name": "get_service_logs",
        "arguments": {
          "service_name": "your-service-name",
          "lookback_minutes": 30,
          "limit": 10
        }
      }
    }'

स्रोत से निर्माण

git clone https://github.com/last9/last9-mcp-server.git
cd last9-mcp-server
go build -o last9-mcp-server
LAST9_HTTP=true ./last9-mcp-server

LAST9_HTTP=true स्थानीय विकास के लिए है। वास्तविक उपयोग के लिए, होस्टेड HTTP एंडपॉइंट आसान है।

समय इनपुट

• निरपेक्ष समय (start_time_iso/end_time_iso, या time_iso) lookback_minutes पर प्राथमिकता लेते हैं।
• सापेक्ष विंडो के लिए: lookback_minutes का उपयोग करें।
• निरपेक्ष विंडो के लिए: RFC3339/ISO8601 का उपयोग करें — 2026-02-09T15:04:05Z।
• विरासत YYYY-MM-DD HH:MM:SS केवल संगतता के लिए स्वीकार किया जाता है।

get_exceptions

• limit (पूर्णांक, वैकल्पिक): अधिकतम अपवाद। डिफ़ॉल्ट: 20।
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक): निरपेक्ष समय सीमा।
• service_name (स्ट्रिंग, वैकल्पिक): सेवा द्वारा फ़िल्टर करें।
• span_name (स्ट्रिंग, वैकल्पिक): स्पैन नाम द्वारा फ़िल्टर करें।
• env (स्ट्रिंग, वैकल्पिक): वातावरण द्वारा फ़िल्टर करें।

get_service_summary

• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• env (स्ट्रिंग, वैकल्पिक): PromQL regex। डिफ़ॉल्ट .* है। सटीक मिलान के लिए एंकर चाहिए (जैसे ^prod$)।
• sort_by (स्ट्रिंग, वैकल्पिक): request_count (डिफ़ॉल्ट), throughput_rpm, http_4xx_count, http_5xx_count, या grpc_error_count।
• limit (पूर्णांक, वैकल्पिक): अधिकतम रैंक की गई पंक्तियाँ। छोड़ें या 0 का मतलब 10; 100 से ऊपर के मान 100 पर क्लैम्प होते हैं।

get_service_environments

• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)

अन्य सभी APM टूल के लिए एक env मान आवश्यक है। यदि यह खाली लौटता है, तो "" का उपयोग करें।

get_service_performance_details

• service_name (स्ट्रिंग, आवश्यक)
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• env (स्ट्रिंग, वैकल्पिक): डिफ़ॉल्ट prod है।

get_service_operations_summary

• service_name (स्ट्रिंग, आवश्यक)
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• env (स्ट्रिंग, वैकल्पिक): डिफ़ॉल्ट prod है।

get_service_dependency_graph

• service_name (स्ट्रिंग, वैकल्पिक)
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• env (स्ट्रिंग, वैकल्पिक): डिफ़ॉल्ट prod है।

get_apm_service_deviations

• service_name (स्ट्रिंग, वैकल्पिक): फ्लीट स्कोप के लिए छोड़ें; एक सेवा और उसके ऑपरेशन सहसंबंधों के लिए प्रदान करें।
• lookback_minutes (पूर्णांक, वैकल्पिक): वर्तमान विंडो। डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक): स्पष्ट वर्तमान विंडो।
• baseline_start_time_iso / baseline_end_time_iso (स्ट्रिंग, वैकल्पिक): स्पष्ट बेसलाइन। डिफ़ॉल्ट तुरंत पिछली समान-अवधि विंडो है।
• datasource (स्ट्रिंग, वैकल्पिक): तुलना को एक डेटासोर्स तक सीमित करें।
• env (स्ट्रिंग, वैकल्पिक): डिफ़ॉल्ट prod है।
• max_services / max_operations (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट 10, अधिकतम 10 प्रत्येक।

get_databases

• env (स्ट्रिंग, वैकल्पिक): वातावरण द्वारा फ़िल्टर करें। एक नियमित अभिव्यक्ति स्वीकार करता है। डिफ़ॉल्ट: सभी।
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60। विंडो 7 दिनों से अधिक नहीं हो सकती।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)

get_database_slow_queries

• db_system (स्ट्रिंग, वैकल्पिक): जैसे postgresql, mysql, mongodb, redis।
• host (स्ट्रिंग, वैकल्पिक): डेटाबेस होस्ट (net_peer_name)।
• service_name (स्ट्रिंग, वैकल्पिक): कॉल करने वाली सेवा का नाम।
• env (स्ट्रिंग, वैकल्पिक)
• min_duration_ms (फ्लोट, वैकल्पिक): ms में न्यूनतम क्वेरी अवधि।
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• limit (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 20।

get_database_queries

• db_system (स्ट्रिंग, वैकल्पिक)
• host (स्ट्रिंग, वैकल्पिक)
• service_name (स्ट्रिंग, वैकल्पिक)
• env (स्ट्रिंग, वैकल्पिक)
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• limit (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 20।

get_database_server_metrics

• db_system (स्ट्रिंग, आवश्यक): जैसे postgresql, mysql, mongodb, redis, aerospike।
• host (स्ट्रिंग, वैकल्पिक)
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)

prometheus_range_query

• query (स्ट्रिंग, आवश्यक): PromQL क्वेरी।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक): डिफ़ॉल्ट पिछले 60 मिनट।
• lookback_minutes (फ्लोट, वैकल्पिक): डिफ़ॉल्ट: 60।

prometheus_instant_query

• query (स्ट्रिंग, आवश्यक)
• time_iso (स्ट्रिंग, वैकल्पिक): डिफ़ॉल्ट अभी।
• lookback_minutes (फ्लोट, वैकल्पिक)

prometheus_label_values

• match_query (स्ट्रिंग, वैकल्पिक): PromQL फ़िल्टर।
• label (स्ट्रिंग, आवश्यक): लेबल नाम।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)

prometheus_labels

• match_query (स्ट्रिंग, वैकल्पिक): PromQL फ़िल्टर।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)

get_logs

• logjson_query (सरणी, आवश्यक): JSON पाइपलाइन क्वेरी।
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 5।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• limit (पूर्णांक, वैकल्पिक): सर्वर डिफ़ॉल्ट: 5000।
• index (स्ट्रिंग, वैकल्पिक): physical_index:<name> या rehydration_index:<block_name>।

लॉग-आधारित सेवा इन्वेंट्री के लिए, पहले physical_index_service_count क्वेरी करें:

sum by (name, service_name, env) (physical_index_service_count{destination="logs"})

service_name को ServiceName के रूप में उपयोग करें, मौजूद होने पर env को वातावरण के रूप में, और name को भौतिक इंडेक्स नाम के रूप में। यदि name="default", तो index छोड़ें; उपयोगकर्ता द्वारा चयनित गैर-डिफ़ॉल्ट भौतिक इंडेक्स के लिए, index: "physical_index:<name>" पास करें। यदि बैकएंड स्पष्ट भौतिक इंडेक्स फ़िल्टरिंग को अस्वीकार करता है, तो index के बिना पुनः प्रयास करें और रिपोर्ट करें कि स्पष्ट भौतिक इंडेक्स फ़िल्टरिंग उस बैकएंड के लिए अनुपलब्ध है।

get_service_logs

• service_name (स्ट्रिंग, आवश्यक)
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• limit (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 20।
• env (स्ट्रिंग, वैकल्पिक)
• severity_filters (सरणी, वैकल्पिक): जैसे ["error", "warn"]। OR तर्क।
• body_filters (सरणी, वैकल्पिक): जैसे ["timeout", "failed"]। OR तर्क।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• index (स्ट्रिंग, वैकल्पिक)

कई फ़िल्टर प्रकार AND के साथ संयोजित होते हैं। प्रत्येक सरणी आंतरिक रूप से OR का उपयोग करती है। पहले व्यापक समग्र गणनाओं के लिए get_logs का उपयोग करें; किसी सेवा/वातावरण/इंडेक्स और एक छोटे नमूना सेट पर संकीर्ण करने के बाद ही get_service_logs का उपयोग करें।

get_log_attributes

• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 15।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• region (स्ट्रिंग, वैकल्पिक)
• index (स्ट्रिंग, वैकल्पिक)

get_log_attributes_for_pipeline

• pipeline (सरणी, आवश्यक): डिस्कवरी को स्कोप करने के लिए पूर्व फ़िल्टर चरण, जैसे [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]।
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 15।
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• region (स्ट्रिंग, वैकल्पिक)
• index (स्ट्रिंग, वैकल्पिक)

get_drop_rules

कोई पैरामीटर नहीं। GET /otel_settings/drop?region=... के माध्यम से ड्रॉप नियम सूचीबद्ध करता है।

add_drop_rule

• name (स्ट्रिंग, आवश्यक)
• filters (सरणी, आवश्यक): प्रत्येक फ़िल्टर: key, value, operator (equals/not_equals), conjunction (and)।
• फ़िल्टर कुंजियों को attributes["key_name"] या resource.attributes["key_name"] का उपयोग करना चाहिए (Last9 API द्वारा आवश्यक)।
• POST /otel_settings/drop?region=...&cluster_id=... के माध्यम से नियम बनाता है।

get_traces

व्यापक खोजों और समुच्चयन के लिए उपयोग करें। सटीक ट्रेस ID लुकअप के लिए, get_service_traces का उपयोग करें।

• tracejson_query (सरणी, आवश्यक)
• start_time_iso / end_time_iso (स्ट्रिंग, वैकल्पिक)
• lookback_minutes (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 60।
• limit (पूर्णांक, वैकल्पिक): डिफ़ॉल्ट: 5000।

get_service_traces

trace_id या service_name में से ठीक एक आवश्यक है।

• trace_id (string, वैकल्पिक): डिफ़ॉल्ट लुकबैक: 72 घंटे।
• service_name (string, वैकल्पिक): डिफ़ॉल्ट लुकबैक: 60 मिनट।
• lookback_minutes (integer, वैकल्पिक)
• start_time_iso / end_time_iso (string, वैकल्पिक)
• limit (integer, वैकल्पिक): डिफ़ॉल्ट: 10।
• env (string, वैकल्पिक)

get_trace_attributes

• lookback_minutes (integer, वैकल्पिक): डिफ़ॉल्ट: 15।
• start_time_iso / end_time_iso (string, वैकल्पिक)
• region (string, वैकल्पिक)

get_trace_attributes_for_pipeline

• pipeline (array, आवश्यक): डिस्कवरी को सीमित करने के लिए पिछले फ़िल्टर चरण, जैसे [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]।
• lookback_minutes (integer, वैकल्पिक): डिफ़ॉल्ट: 15।
• start_time_iso / end_time_iso (string, वैकल्पिक)
• region (string, वैकल्पिक)

get_trace_attribute_values

• tag_name (string, आवश्यक): get_trace_attributes से विशेषता नाम (जैसे resource_department या attributes['http.method'])।
• pipeline (array, वैकल्पिक): मानों को सीमित करने के लिए पिछले फ़िल्टर चरण; वैश्विक मानों के लिए छोड़ दें।
• lookback_minutes (integer, वैकल्पिक): डिफ़ॉल्ट: 15।
• start_time_iso / end_time_iso (string, वैकल्पिक): ऐतिहासिक RFC3339 सीमाएँ; lookback_minutes पर प्राथमिकता लेती हैं।
• region (string, वैकल्पिक)

get_trace_attribute_deviations

• comparison_mode (string, आवश्यक): latency, errors, या time।
• service_name (string, आवश्यक)
• environment (string, आवश्यक): सटीक deployment.environment मान।
• operation (string, वैकल्पिक)
• filters (array, वैकल्पिक): ट्रेस JSON फ़िल्टर शर्तें।
• candidate_attributes (array, वैकल्पिक): अधिकतम 8; सीमित डिस्कवरी के लिए छोड़ दें।
• latency_threshold_ms (number, वैकल्पिक): latency मोड के लिए आवश्यक; अन्य मोड के लिए अस्वीकृत।
• start_time_iso / end_time_iso (string, वैकल्पिक)
• lookback_minutes (integer, वैकल्पिक): डिफ़ॉल्ट: 15। अधिकतम: 15।
• baseline_start_time_iso / baseline_end_time_iso (string, वैकल्पिक): time मोड के लिए आवश्यक; लक्ष्य विंडो की अवधि के बराबर और गैर-अतिव्यापी।
• minimum_cohort_size (integer, वैकल्पिक): डिफ़ॉल्ट: 100। न्यूनतम: 20।
• minimum_value_support (integer, वैकल्पिक): डिफ़ॉल्ट: 20। न्यूनतम: 10।
• limit (integer, वैकल्पिक): डिफ़ॉल्ट: 10। अधिकतम: 10।

साथी बैकएंड क्षमता सक्षम होना आवश्यक है।

get_trace_waterfall

• trace_id (string, आवश्यक)
• environment (string, वैकल्पिक)
• start_time_iso / end_time_iso (string, वैकल्पिक)
• lookback_minutes (integer, वैकल्पिक): डिफ़ॉल्ट: 4320 (72 घंटे)।
• selected_span_id (string, वैकल्पिक): केवल उस स्पैन के लिए विशेषताएँ, घटनाएँ और लिंक लौटाता है।
• max_spans (integer, वैकल्पिक): डिफ़ॉल्ट: 500। अधिकतम: 1000।

एक investigation-evidence/v1 लिफाफा लौटाता है; वॉटरफॉल data के अंतर्गत है।

get_change_events

• start_time_iso / end_time_iso (string, वैकल्पिक)
• lookback_minutes (integer, वैकल्पिक): डिफ़ॉल्ट: 60।
• service_name (string, वैकल्पिक)
• env (string, वैकल्पिक)
• event_name (string, वैकल्पिक): available_event_names प्राप्त करने के लिए पहले इसके बिना कॉल करें।

get_alert_groups

चेंजबोर्ड / लेबल-कवरेज ऑडिट के लिए कॉन्फ़िगर किया गया Compass अलर्ट-समूह इन्वेंट्री। शून्य नियमों वाले समूह और फायर नहीं करने वाले समूह शामिल हैं। PromQL नहीं लौटाता है।

• alert_group_name / alert_group_type / data_source_name (string, वैकल्पिक): केस-असंवेदनशील सबस्ट्रिंग मिलान।
• team / tier (string, वैकल्पिक): कॉन्फ़िगर किए गए मेटाडेटा पर सटीक केस-असंवेदनशील मिलान।
• label_key + label_value (string, वैकल्पिक): एक साथ सेट होना चाहिए। एक metadata.labels जोड़ी पर सटीक केस-असंवेदनशील मिलान — कुंजी और मान दोनों।

{"count":N,"groups":[...]}, id, name, type, entity_class, team, tier, metadata.labels और नियम गणनाओं के साथ कॉम्पैक्ट JSON लौटाता है। खाली team / labels का अर्थ अनसेट है।

get_alert_config

• search_term (string, वैकल्पिक): नाम, समूह, डेटा स्रोत, टैग में मुफ्त-पाठ खोज।
• rule_name (string, वैकल्पिक)
• severity (string, वैकल्पिक)
• rule_type (string, वैकल्पिक): static या anomaly।
• alert_group_name / alert_group_type / data_source_name (string, वैकल्पिक)
• tags (array, वैकल्पिक): सभी मेल खाने चाहिए (AND तर्क)।

get_alerts

• time_iso (string, वैकल्पिक): RFC3339 में मूल्यांकन समय।
• window (integer, वैकल्पिक): सेकंड में लुकबैक। डिफ़ॉल्ट: 900। सीमा: 60–86400।
• lookback_minutes (integer, वैकल्पिक): सीमा: 1–1440।

get_alert_rule_state

• start_time (integer, आवश्यक): सीमा की शुरुआत का Unix epoch (समावेशी)।
• end_time (integer, आवश्यक): सीमा का अंत Unix epoch (समावेशी)।
• step (integer, आवश्यक): नमूनों के बीच सेकंड में रिज़ॉल्यूशन। नमूनों की संख्या ((end_time - start_time) / step + 1) 100 पर सीमित है।
• alert_group_id (string, वैकल्पिक): अलर्ट समूह ID द्वारा फ़िल्टर करें।
• rule_name (string, वैकल्पिक): नियम नाम पर रेगेक्स फ़िल्टर।
• alert_group_name (string, वैकल्पिक): अलर्ट समूह नाम पर रेगेक्स फ़िल्टर।
• label_filters (string, वैकल्पिक): अल्पविराम-पृथक key=value लेबल फ़िल्टर।
• state (string, वैकल्पिक): स्थिति द्वारा फ़िल्टर करें (जैसे firing)।

rule_id -> [{timestamp, is_firing}] का JSON मानचित्र लौटाता है। एक टाइमस्टैम्प जिस पर एक नियम अपस्ट्रीम प्रतिक्रिया से अनुपस्थित है, is_firing=0 के रूप में रिपोर्ट किया जाता है — इसका अर्थ है "फायरिंग के रूप में नहीं देखा गया", पुष्टि की गई सामान्य स्थिति नहीं।

get_notification_channels

कोई पैरामीटर नहीं। सभी कॉन्फ़िगर किए गए अधिसूचना चैनल लौटाता है (Slack, PagerDuty, ईमेल, वेबहुक, आदि)।

did_you_mean

• query (string, आवश्यक): खोजने के लिए नाम — आंशिक, गलत वर्तनी, या संक्षिप्त।
• type (string, वैकल्पिक): इकाई प्रकार तक सीमित करें: service, environment, host, database, k8s_deployment, k8s_namespace, job।

समानता स्कोर के साथ अधिकतम 3 निकटतम मिलान लौटाता है। किसी भी टूल कॉल से पहले इसका उपयोग करें जहाँ इकाई नाम अनिश्चित है। यदि पिछली कॉल ने खाली परिणाम लौटाए हैं, तो पुनः प्रयास करने से पहले इसे आज़माएँ।

get_service_profile

• service_name (string, आवश्यक): सेवा जिसके लिए टेलीमेट्री प्रोफ़ाइल प्राप्त करनी है।
• datasource (string, वैकल्पिक): डेटासोर्स नाम। डिफ़ॉल्ट के लिए छोड़ दें।

एक संक्षिप्त जांच ब्रीफिंग लौटाता है जिसके बाद पूर्ण प्रोफ़ाइल कच्चे JSON के रूप में: सिग्नल उपस्थिति (logs/traces/metrics जैसे present, absent, या unknown), भाषा और रनटाइम, परिनियोजन वातावरण, लॉग signal_shape (log_format, severity_set, level_field), और एक अनुशंसित इन्जेस्ट फिक्स जहाँ लागू हो। अपस्ट्रीम से व्युत्पन्न और ~15 मिनट TTL के साथ कैश किया गया।

किसी भी सेवा-स्कोप्ड जांच से पहले इसे कॉल करें ताकि टूल चयन सेवा की वास्तविक टेलीमेट्री से मेल खाए — ट्रेस टूल छोड़ें जब traces absent है, और जब severity_set none या partial है तो लॉग बॉडी में level_field से गंभीरता पार्स करें, severity_filters का उपयोग करने के बजाय। metrics हमेशा unknown है और dependencies v1 में आबाद नहीं है। जब logs और traces दोनों absent हैं, तो सेवा अनमॉनिटर्ड निष्कर्ष निकालने से पहले did_you_mean के साथ नाम की पुष्टि करें।

list_dashboards

कोई पैरामीटर नहीं। संगठन में सभी कस्टम डैशबोर्ड id, name और मेटाडेटा के साथ JSON सरणी के रूप में लौटाता है।

get_dashboard

• id (string, आवश्यक): डैशबोर्ड UUID।
• region (string, वैकल्पिक): पैनल क्वेरी आबादी के लिए क्षेत्र। कॉन्फ़िगर किए गए डेटासोर्स क्षेत्र के लिए डिफ़ॉल्ट।

validate_dashboard

केवल-पढ़ने के लिए। कभी भी डैशबोर्ड नहीं बनाता या अपडेट नहीं करता। dashboard_id या dashboard_definition में से ठीक एक स्वीकार करता है।

• dashboard_id (string, वैकल्पिक): सहेजा गया डैशबोर्ड UUID सत्यापित करने के लिए।
• dashboard_definition (object, वैकल्पिक): इनलाइन असहेजा डैशबोर्ड बॉडी (सही ड्राई रन)।
• start_time_iso / end_time_iso (string, वैकल्पिक): सत्यापन विंडो (RFC3339)। ≤ 24h होना चाहिए।
• region (string, वैकल्पिक): पैनल क्वेरी निष्पादन के लिए क्षेत्र।

dashboard_validation/v1 लौटाता है: प्रति-पैनल लिंट + निष्पादन वर्गीकरण (data / no_data / invalid / error)। दिन-1 खाली परिणाम डायग्नोज़ प्रोब के बिना valid_no_data के रूप में वर्गीकृत होते हैं।

create_dashboard

केवल नया। इस कॉल के dashboard.id लौटाने के बाद, update_dashboard के साथ परिष्कृत करें — पैनल जोड़ने, ट्रिम करने या ठीक करने के लिए फिर से न बनाएं।

• dashboard (object, आवश्यक): name और panels[] के साथ डैशबोर्ड परिभाषा। प्रत्येक पैनल को name, version, layout (x, y, w, h), visualization.type और queries[] की आवश्यकता होती है।
• metadata (object, वैकल्पिक): डैशबोर्ड मेटाडेटा — _category और _type फ़ील्ड (जैसे {"_category":"custom","_type":"metrics"})।

update_dashboard

बनाने के बाद इसे प्राथमिकता दें। id द्वारा पूर्ण प्रतिस्थापन (create के समान बॉडी)।

• id (string, आवश्यक): अपडेट करने के लिए डैशबोर्ड UUID।
• dashboard (object, आवश्यक): पूर्ण प्रतिस्थापन डैशबोर्ड बॉडी (create के समान आकार)।
• metadata (object, वैकल्पिक): प्रतिस्थापन मेटाडेटा। केवल-पढ़ने वाले सिस्टम डैशबोर्ड 403 त्रुटि लौटाते हैं।

delete_dashboard

• id (string, आवश्यक): हटाने के लिए डैशबोर्ड UUID। केवल-पढ़ने वाले सिस्टम डैशबोर्ड हटाए नहीं जा सकते।

list_dashboard_snapshots

• dashboard_id (string, आवश्यक): डैशबोर्ड UUID जिसके स्नैपशॉट सूचीबद्ध करने हैं।

केवल मेटाडेटा लौटाता है (id, name, expires_at, आदि)। जमे हुए पैनल डेटा के लिए get_dashboard_snapshot का उपयोग करें।

get_dashboard_snapshot

• id (string, आवश्यक): स्नैपशॉट UUID।

dashboard_definition, panel_data, time_range और variables सहित पूर्ण जमे हुए स्नैपशॉट लौटाता है।

delete_dashboard_snapshot

• id (string, आवश्यक): हटाने के लिए स्नैपशॉट UUID।

get_profile_services

• lookback_minutes / start_time_iso / end_time_iso (वैकल्पिक): विंडो; लुकबैक या स्पष्ट ISO सीमाएँ पसंद करें (डिफ़ॉल्ट 60 मिनट)।
• region (string, वैकल्पिक): क्षेत्र ओवरराइड।

उन सेवाओं को लौटाता है जिनके पास विंडो में प्रोफाइलिंग डेटा है। get_flamegraph / get_top_functions / get_profile_summary से पहले इसे कॉल करें।

get_flamegraph

• service (string, आवश्यक): get_profile_services से सेवा नाम।
• profile_type (string, वैकल्पिक): cpu (डिफ़ॉल्ट), alloc, या wall। विंडो की तुलना करते समय एक प्रकार पिन करें।
• env / cluster / namespace / runtime (string, वैकल्पिक): स्कोप फ़िल्टर।
• limit (number, वैकल्पिक): अधिकतम एकत्रित स्टैक पंक्तियाँ (डिफ़ॉल्ट 1000, अधिकतम 10000)।
• lookback_minutes / start_time_iso / end_time_iso / region (वैकल्पिक)।

एक नेस्टेड फ्लेमग्राफ ट्री लौटाता है (name / value / self / children)। truncated: true का अर्थ है कि API पंक्ति सीमा हिट हुई थी।

get_top_functions

get_flamegraph के समान फ़िल्टर। सबसे गर्म फ़ंक्शन की सेल्फ-सैंपल रैंकिंग लौटाता है। छोटा हो सकता है; truncated जांचें।

get_profile_summary

get_flamegraph के समान फ़िल्टर। सेवा के लिए प्रोफ़ाइल का एक संक्षिप्त प्राकृतिक-भाषा ट्राइएज लौटाता है।

grafana_search_dashboards

• query (string, वैकल्पिक): शीर्षक सबस्ट्रिंग। खाली व्यापक रूप से सूचीबद्ध करता है (5,000-पंक्ति कैप के अधीन)।

{"dashboards":[…], "truncated":bool} को uid, title, uri, url, type, tags के साथ लौटाता है। uid को grafana_get_dashboard के साथ उपयोग करें।

grafana_get_dashboard

• uid (string, आवश्यक): Grafana डैशबोर्ड uid।
• full_json (boolean, वैकल्पिक): सत्य होने पर, फ़िल्टर किए गए सारांश के बजाय कच्चा Grafana JSON लौटाएँ। डिफ़ॉल्ट सारांश: संस्करण, टैग, टेम्प्लेटिंग वेरिएबल्स, और प्रत्येक पैनल का प्रकार/डेटासोर्स/gridPos/promQL लक्ष्य। अज्ञात प्लगइन पैनल प्रकार unsupportedPanelTypes में दिखाई देते हैं।

grafana_list_folders

कोई पैरामीटर नहीं। फ़ोल्डर ट्री लौटाता है।

grafana_list_folder_dashboards

• folder_uid (स्ट्रिंग, आवश्यक): Grafana फ़ोल्डर uid।

उस फ़ोल्डर में डैशबोर्ड के लिए {"dashboards":[…], "truncated":bool} लौटाता है (5,000 तक पेजिनेटेड)।

grafana_list_datasources

कोई पैरामीटर नहीं। डेटासोर्स का एक सुरक्षित प्रोजेक्शन लौटाता है (कोई क्रेडेंशियल फ़ील्ड नहीं)।