mcpField
I
instana

instana

github.com/membranedev云与 DevOps27061 次安装26 周前更新
代码仓库

关于 instana

Instana 是通过 Membrane 命令行工具访问 Instana 可观测性数据的技能，面向 DevOps 团队和 SRE。它可查找监控及运维对象相关操作；当现有操作不适用时，也可通过代理发送 API 请求。

主要功能

  1. 01查找连接可用的操作
  2. 02使用 JSON 输入运行操作
  3. 03访问监控与运维对象
  4. 04通过代理发送直接 API 请求

适用场景

  1. 01检查 Instana 监控数据
  2. 02运行可用的 Instana 操作
  3. 03请求操作列表未覆盖的 API 功能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/membranedev/application-skills --skill instana

安装后在 Claude Code 中输入/instana确认已加载。

详细介绍

Instana

Instana 是一个可观测性平台，可帮助监控应用程序和基础设施的性能。它提供对复杂系统的自动发现、追踪和分析。DevOps 团队和 SRE 可借助它快速识别并解决性能问题。

官方文档：https://www.ibm.com/docs/en/instana-observability

Instana 概览

  • Dashboard
    • Dashboard Group
  • Application
  • Website
  • Alerting Channel
  • User
  • Infrastructure Monitoring
  • Kubernetes Monitoring
  • Technology Monitoring
  • Trace Monitoring
  • Event
  • Call
  • Service
  • Endpoint
  • Database
  • Query
  • Setting
  • Log Source
  • Log Mapping Template
  • Synthetic Monitor
  • Test Catalog
  • API Token
  • Release Marker
  • Maintenance Window
  • Agent Setting
  • License
  • Bill
  • Usage Profile
  • Integration
    • AWS Integration
    • Azure Integration
    • Google Cloud Integration
    • PCF Integration
    • Custom Integration
  • Technology
  • Span
  • Website Group
  • Mobile App
  • Mobile App Group
  • Session
  • User Session
  • Process Group
  • Container Group
  • Snapshot
  • Anomaly
  • Incident
  • Problem
  • Story
  • Perspective
  • Notebook
  • Report
  • Automation Rule
  • Correlation Configuration
  • Custom Event
  • Global Notification Group
  • External Website
  • Application Monitoring
  • Configuration Profile
  • Log Rule
  • Log Forwarding Rule
  • Log Management
  • Monitoring Template
  • Process
  • Container
  • Host
  • Virtual Machine
  • Datastore
  • Load Balancer
  • Network Interface
  • Volume
  • Queue Manager
  • Topic
  • Channel
  • Listener
  • Transaction
  • Program
  • Job
  • Step
  • Message
  • Cache
  • Lock
  • Sensor
  • Device
  • Firmware
  • Certificate
  • Key
  • Secret
  • Policy
  • Rule
  • Action
  • Task
  • Workflow
  • Schedule
  • Template
  • Script
  • Variable
  • Constant
  • Enumeration
  • Annotation
  • Comment
  • Attachment
  • Link
  • Bookmark
  • Tag
  • Category
  • Group
  • Role
  • Permission
  • Audit Log
  • System Log
  • Error Log
  • Access Log
  • Change Log
  • Event Log
  • Security Log
  • Performance Log
  • Debug Log
  • Trace Log
  • Alert
  • Notification
  • Incident Preference
  • Team
  • Calendar
  • Service Level Agreement (SLA)
  • Outage
  • Change Request
  • Knowledge Base Article
  • FAQ
  • Tutorial
  • Documentation
  • Release Note
  • Roadmap
  • Case
  • Opportunity
  • Lead
  • Contact
  • Account
  • Contract
  • Quote
  • Order
  • Invoice
  • Payment
  • Shipment
  • Return
  • Refund
  • Coupon
  • Discount
  • Tax
  • Currency
  • Language
  • Region
  • Country
  • City
  • Location
  • IP Address
  • Domain
  • Subnet
  • Network
  • Firewall
  • VPN
  • Proxy
  • DNS
  • DHCP
  • Routing Table
  • ARP Table
  • MAC Address
  • Port
  • Protocol
  • Interface
  • Bandwidth
  • Latency
  • Packet Loss
  • Jitter
  • Throughput
  • Availability
  • Reliability
  • Scalability
  • Performance
  • Security
  • Compliance
  • Cost
  • Risk
  • Impact
  • Urgency
  • Priority
  • Severity
  • Status
  • Resolution
  • Owner
  • Assignee
  • Reviewer
  • Approver
  • Watcher
  • Subscriber
  • Follower
  • Mention
  • Commenter
  • Reporter
  • Creator
  • Modifier
  • Deleter
  • Archiver
  • Restorer
  • Exporter
  • Importer
  • Validator
  • Analyzer
  • Optimizer
  • Simulator
  • Emulator
  • Debugger
  • Profiler
  • Monitor
  • Controller
  • Adapter
  • Connector
  • Driver
  • Plugin
  • Extension
  • Module
  • Library
  • Framework
  • Platform
  • Environment
  • Configuration
  • Deployment
  • Release
  • Version
  • Build
  • Test
  • Quality
  • Defect
  • Issue
  • Problem Report
  • Feature Request
  • Enhancement
  • Improvement
  • Refactoring
  • Technical Debt
  • Code Review
  • Unit Test
  • Integration Test
  • System Test
  • Acceptance Test
  • Regression Test
  • Performance Test
  • Security Test
  • Usability Test
  • Accessibility Test
  • Localization Test
  • Internationalization Test
  • Globalization Test
  • Data Migration
  • Data Integration
  • Data Synchronization
  • Data Replication
  • Data Backup
  • Data Recovery
  • Data Archiving
  • Data Purging
  • Data Masking
  • Data Encryption
  • Data Compression
  • Data De-duplication
  • Data Validation
  • Data Cleansing
  • Data Transformation
  • Data Enrichment
  • Data Analysis
  • Data Visualization
  • Data Reporting
  • Data Mining
  • Data Warehousing
  • Data Lake
  • Big Data
  • Machine Learning
  • Artificial Intelligence
  • Natural Language Processing
  • Computer Vision
  • Robotics
  • Internet of Things (IoT)
  • Blockchain
  • Cloud Computing
  • Edge Computing
  • Quantum Computing
  • Augmented Reality (AR)
  • Virtual Reality (VR)
  • Mixed Reality (MR)
  • Extended Reality (XR)
  • Metaverse

根据需要使用操作名称和参数。

使用 Instana

此技能使用 Membrane CLI 与 Instana 交互。Membrane 会自动处理身份验证和凭据刷新，因此你可以专注于集成逻辑，而不必处理身份验证的基础工作。

安装 CLI

安装 Membrane CLI，以便在终端中运行 membrane：

npm install -g @membranehq/cli@latest
身份验证
membrane login --tenant --clientName=<agentType>

根据是否支持交互模式，此命令会打开浏览器进行身份验证，或在控制台中打印授权 URL。

无头环境： 此命令会打印授权 URL。请让用户在浏览器中打开该 URL。用户完成登录后会看到一个代码，请使用以下命令完成操作：

membrane login complete <code>

在任意命令中添加 --json，即可获得机器可读的 JSON 输出。

Agent 类型：claude、openclaw、codex、warp、windsurf 等。系统会据此调整工具配置，以便更好地适配你的运行环境。

连接到 Instana

使用 membrane connection ensure，通过应用 URL 或域名查找或创建连接：

membrane connection ensure "https://www.instana.com/" --json

用户在浏览器中完成身份验证。输出中会包含新连接 ID。

这是获取连接最快的方式。URL 会规范化为域名，并与已知应用进行匹配。如果未找到应用，系统会创建一个应用并自动构建连接器。

如果返回的连接具有 state: "READY"，请跳至 步骤 2。

1b. 等待连接就绪

如果连接处于 BUILDING 状态，请轮询直到连接就绪：

npx @membranehq/cli connection get <id> --wait --json

--wait 标志会持续长轮询（最长等待 --timeout 秒，默认值为 30），直到状态发生变化。持续轮询，直到 state 不再是 BUILDING。

根据返回的状态决定下一步操作：

  • READY — 连接已完全设置。请跳至 步骤 2。

  • CLIENT_ACTION_REQUIRED — 用户或 Agent 需要执行某项操作。clientAction 对象会说明所需操作：

    • clientAction.type — 所需操作的类型：
      • "connect" — 用户需要进行身份验证（OAuth、API 密钥等）。这包括首次身份验证，以及已断开连接时的重新身份验证。
      • "provide-input" — 需要更多信息（例如要连接的应用）。
    • clientAction.description — 对所需操作的易读说明。
    • clientAction.uiUrl（可选）— 用户可在此预构建的 UI 中完成操作。若存在，请向用户显示。
    • clientAction.agentInstructions（可选）— AI Agent 如何以编程方式继续操作的说明。

    用户完成操作（例如在浏览器中进行身份验证）后，再次使用 membrane connection get <id> --json 轮询，以检查状态是否变为 READY。

  • CONFIGURATION_ERROR 或 SETUP_FAILED — 出现问题。请检查 error 字段了解详情。

搜索操作

使用自然语言描述你想执行的操作来进行搜索：

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

请始终在特定连接的上下文中搜索操作。

每个结果都包含 id、name、description、inputSchema（操作接受的参数）和 outputSchema（操作返回的内容）。

常用操作

使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现可用操作。

运行操作
membrane action run <actionId> --connectionId=CONNECTION_ID --json

传递 JSON 参数：

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段中。

代理请求

当可用操作无法满足你的使用场景时，你可以通过 Membrane 的代理直接向 Instana API 发送请求。Membrane 会自动将基础 URL 附加到你提供的路径，并注入正确的身份验证标头；如果凭据过期，还会自动透明地刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：

标志说明
-X, --methodHTTP 方法（GET、POST、PUT、PATCH、DELETE）。默认为 GET
-H, --header添加请求标头（可重复），例如 -H "Accept: application/json"
-d, --data请求正文（字符串）
--json用于发送 JSON 正文并设置 Content-Type: application/json 的简写
--rawData按原样发送正文，不进行任何处理
--query查询字符串参数（可重复），例如 --query "limit=10"
--pathParam路径参数（可重复），例如 --pathParam "id=123"

最佳实践

  • 始终优先使用 Membrane 与外部应用通信 — Membrane 提供预构建操作，内置身份验证、分页和错误处理。这样能减少令牌消耗，并让通信更安全。
  • 先发现，再构建 — 运行 membrane action list --intent=QUERY（将 QUERY 替换为你的意图），在编写自定义 API 调用前查找现有操作。预构建操作可以处理原始 API 调用容易遗漏的分页、字段映射和边界情况。
  • 让 Membrane 管理凭据 — 切勿向用户索要 API 密钥或令牌。请改为创建连接；Membrane 会在服务器端管理完整的身份验证生命周期，无需本地密钥。

评论

支持 Markdown