list_application_hosts

Instructions

Implementation Reference

• src/tools/rest/metrics.ts:158-167 (handler)

  The async handler function that executes the 'list_application_hosts' tool logic. It creates a REST client, builds the path /applications/{id}/hosts, adds optional filter[hostname], filter[ids], and page query params, and returns the REST API response.

  async listApplicationHosts(args: ListHostsArgs): Promise<unknown> {
    const client = this.restFor(args.region);
    const path = `/applications/${args.application_id}/hosts`;
    const query: Record<string, unknown> = {};
    if (args.filter_hostname) query['filter[hostname]'] = args.filter_hostname;
    if (args.filter_ids) query['filter[ids]'] = args.filter_ids;
    if (args.page) query.page = args.page;
    const res = await client.get<unknown>(path, query);
    return res;
  }

• src/tools/rest/metrics.ts:27-34 (schema)

  The ListHostsArgs input type definition with fields: application_id (required), filter_hostname, filter_ids, page, auto_paginate, region.

  type ListHostsArgs = {
    application_id: number;
    filter_hostname?: string;
    filter_ids?: string; // comma-separated
    page?: number;
    auto_paginate?: boolean;
    region?: Region;
  };

• src/tools/rest/metrics.ts:139-156 (schema)

  The getListApplicationHostsTool() method defines the tool schema: name 'list_application_hosts', description, and inputSchema (object with application_id, filter_hostname, filter_ids, page, auto_paginate, region).

  getListApplicationHostsTool(): Tool {
    return {
      name: 'list_application_hosts',
      description: 'List hosts for an APM application (REST v2).',
      inputSchema: {
        type: 'object',
        properties: {
          application_id: { type: 'number' },
          filter_hostname: { type: 'string' },
          filter_ids: { type: 'string' },
          page: { type: 'number' },
          auto_paginate: { type: 'boolean' },
          region: { type: 'string', enum: ['US', 'EU'] },
        },
        required: ['application_id'],
      },
    };
  }

• src/server.ts:87-87 (registration)

  Registration: the tool is added to the tools map via restMetrics.getListApplicationHostsTool() in registerTools().

  restMetrics.getListApplicationHostsTool(),

• src/server.ts:199-202 (registration)

  Dispatcher: the executeTool() method routes 'list_application_hosts' to new RestMetricsTool().listApplicationHosts(args).

  case 'list_application_hosts':
    return await new RestMetricsTool().listApplicationHosts(
      args as Parameters<RestMetricsTool['listApplicationHosts']>[0]
    );