Apache ZooKeeper Admin Server API — Monitoring

naftiko: 1.0.0-alpha2
info:
  label: Apache ZooKeeper Admin Server API — Monitoring
  description: 'Apache ZooKeeper Admin Server API — Monitoring. 9 operations. Lead operation: Apache ZooKeeper List Client
    Connections. Self-contained Naftiko capability covering one Apache Zookeeper business surface.'
  tags:
  - Apache Zookeeper
  - Monitoring
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    APACHE_ZOOKEEPER_API_KEY: APACHE_ZOOKEEPER_API_KEY
capability:
  consumes:
  - type: http
    namespace: zookeeper-admin-monitoring
    baseUri: http://localhost:8080/commands
    description: Apache ZooKeeper Admin Server API — Monitoring business capability. Self-contained, no shared references.
    resources:
    - name: cons
      path: /cons
      operations:
      - name: getconnections
        method: GET
        description: Apache ZooKeeper List Client Connections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: crst
      path: /crst
      operations:
      - name: resetconnectionstats
        method: GET
        description: Apache ZooKeeper Reset Connection Statistics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: dump
      path: /dump
      operations:
      - name: getdump
        method: GET
        description: Apache ZooKeeper List Sessions and Ephemeral Nodes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: hash
      path: /hash
      operations:
      - name: gethash
        method: GET
        description: Apache ZooKeeper Get Data Tree Digest
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: last_snapshot
      path: /last_snapshot
      operations:
      - name: getlastsnapshot
        method: GET
        description: Apache ZooKeeper Get Last Snapshot Info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: mntr
      path: /mntr
      operations:
      - name: getmonitormetrics
        method: GET
        description: Apache ZooKeeper Get Monitoring Metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: srst
      path: /srst
      operations:
      - name: resetstats
        method: GET
        description: Apache ZooKeeper Reset Server Statistics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: srvr
      path: /srvr
      operations:
      - name: getserverinfo
        method: GET
        description: Apache ZooKeeper Get Full Server Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: stat
      path: /stat
      operations:
      - name: getserverstats
        method: GET
        description: Apache ZooKeeper Get Server Statistics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: zookeeper-admin-monitoring-rest
    port: 8080
    description: REST adapter for Apache ZooKeeper Admin Server API — Monitoring. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/cons
      name: cons
      description: REST surface for cons.
      operations:
      - method: GET
        name: getconnections
        description: Apache ZooKeeper List Client Connections
        call: zookeeper-admin-monitoring.getconnections
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/crst
      name: crst
      description: REST surface for crst.
      operations:
      - method: GET
        name: resetconnectionstats
        description: Apache ZooKeeper Reset Connection Statistics
        call: zookeeper-admin-monitoring.resetconnectionstats
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/dump
      name: dump
      description: REST surface for dump.
      operations:
      - method: GET
        name: getdump
        description: Apache ZooKeeper List Sessions and Ephemeral Nodes
        call: zookeeper-admin-monitoring.getdump
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/hash
      name: hash
      description: REST surface for hash.
      operations:
      - method: GET
        name: gethash
        description: Apache ZooKeeper Get Data Tree Digest
        call: zookeeper-admin-monitoring.gethash
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/last-snapshot
      name: last-snapshot
      description: REST surface for last_snapshot.
      operations:
      - method: GET
        name: getlastsnapshot
        description: Apache ZooKeeper Get Last Snapshot Info
        call: zookeeper-admin-monitoring.getlastsnapshot
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/mntr
      name: mntr
      description: REST surface for mntr.
      operations:
      - method: GET
        name: getmonitormetrics
        description: Apache ZooKeeper Get Monitoring Metrics
        call: zookeeper-admin-monitoring.getmonitormetrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/srst
      name: srst
      description: REST surface for srst.
      operations:
      - method: GET
        name: resetstats
        description: Apache ZooKeeper Reset Server Statistics
        call: zookeeper-admin-monitoring.resetstats
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/srvr
      name: srvr
      description: REST surface for srvr.
      operations:
      - method: GET
        name: getserverinfo
        description: Apache ZooKeeper Get Full Server Details
        call: zookeeper-admin-monitoring.getserverinfo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/stat
      name: stat
      description: REST surface for stat.
      operations:
      - method: GET
        name: getserverstats
        description: Apache ZooKeeper Get Server Statistics
        call: zookeeper-admin-monitoring.getserverstats
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: zookeeper-admin-monitoring-mcp
    port: 9090
    transport: http
    description: MCP adapter for Apache ZooKeeper Admin Server API — Monitoring. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: apache-zookeeper-list-client-connections
      description: Apache ZooKeeper List Client Connections
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.getconnections
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-reset-connection-statistics
      description: Apache ZooKeeper Reset Connection Statistics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.resetconnectionstats
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-list-sessions-and
      description: Apache ZooKeeper List Sessions and Ephemeral Nodes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.getdump
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-get-data-tree
      description: Apache ZooKeeper Get Data Tree Digest
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.gethash
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-get-last-snapshot
      description: Apache ZooKeeper Get Last Snapshot Info
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.getlastsnapshot
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-get-monitoring-metrics
      description: Apache ZooKeeper Get Monitoring Metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.getmonitormetrics
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-reset-server-statistics
      description: Apache ZooKeeper Reset Server Statistics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.resetstats
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-get-full-server
      description: Apache ZooKeeper Get Full Server Details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.getserverinfo
      outputParameters:
      - type: object
        mapping: $.
    - name: apache-zookeeper-get-server-statistics
      description: Apache ZooKeeper Get Server Statistics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: zookeeper-admin-monitoring.getserverstats
      outputParameters:
      - type: object
        mapping: $.