Cisco Observability Platform Query Service API

Getting Started

Cisco AppDynamics exposes various APIs for customizing and extending its features. This API allows you to retrieve observation MELT data using Cisco Cloud Observability Topology.

Base URI

Every Query Service API request begins with this Base URI:

Code Snippet
Copyhttps://{tenant-name}.observe.appdynamics.com/monitoring/v1

Authentication

The Query Service API uses Open Authentication 2.0 (OAuth2) token-based authentication. Refer to Cisco Cloud Observability Authentication for details on how to generate an OAuth token.

Cisco Cloud Observability API requests adhere to a standard OAuth2 request format. You need a Service Principal and a valid JSON Web Token (JWT) to use this API. Service Principals are identities, represented as code, used by created applications, services, and automation tools to access specific resources. See Cisco Cloud Observability Authentication.

Use Cases

You can use the following queries to perform basic tasks using queries. Create a POST request to the query or execute resource and include the following queries in the request body.

List topology situation; aggregate entities by type and count it

Code Snippet
CopyFETCH type, count
FROM entities
SINCE -1d

Get entity details

Code Snippet
CopyFETCH id, attributes, createdAt
FROM entities(infra:container)
SINCE -1d

Get some metrics for entities

Code Snippet
CopyFETCH id, metrics(infra:container.cpu.system.utilization, 'infra-agent'){timestamp, min, max}
FROM entities(infra:container)
SINCE -1d

List limited count of logs (events)

Code Snippet
CopyFETCH events(logs:generic_record)[raw ~ 'DEBUG']{timestamp, raw}
SINCE -1d
LIMITS
  events.count(100)
Next