Cisco Intersight Telemetry API
Time-series telemetry query operations returning aggregated infrastructure metrics via the Druid query interface. 8 operations across 8 paths and 1 resource tag(s), from Cisco's own OpenAPI 3.0.2 document.
Cisco Intersight Telemetry API is one of 11 APIs that Cisco Intersight publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Telemetry, Metrics, and Observability. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.
This API exposes 8 operations across 8 paths, and defines 119 schemas. It is described by OpenAPI 3.0.2, at version 1.0.11-20260807064027971.
Requests are made against a single base URL, https://{server}.
8 operations
8 paths
119 schemas
8 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 3
Cisco Intersight Telemetry API declares
3 security schemes
for authenticating requests.
An API key is passed in the cookie as X-Starship-Token (cookieAuth).
It uses HTTP signature authentication (http_signature).
It supports OAuth 2.0 (oAuth2) using the authorizationCode and clientCredentials flows, exposing 3315 scopes.
cookieAuth— The authentication cookie obtained from a Single-Sign-On SAML assertion.http_signature— The 'HTTP signature' security scheme. Each HTTP request is cryptographically signed as specified in https://datatracker.ietf.org/doc/draft-cavage-http-signatur…oAuth2— The client uses the OAuth2 security scheme. To use OAuth2, a client application must be registered by creating a iam.AppRegistration resource. The user who cre…
Paths & Operations 8
Across 8 paths, the API surfaces 8 operations — 8 POST. Each is listed below with its method, path, parameters, and response codes.
telemetry 8
POST
/api/v1/telemetry/TimeSeries
Perform a Druid TimeSeries request.
POST
/api/v1/telemetry/Topns
Perform a Druid TopN request.
POST
/api/v1/telemetry/GroupBys
Perform a Druid GroupBy request.
POST
/api/v1/telemetry/Scans
Perform a Druid Scan request.
POST
/api/v1/telemetry/Searches
Perform a Druid Search request.
POST
/api/v1/telemetry/TimeBoundaries
Perform a Druid TimeBoundary request.
POST
/api/v1/telemetry/SegmentMetadata
Perform a Druid SegmentMetadata request.
POST
/api/v1/telemetry/DataSourceMetadata
Perform a Druid DatasourceMetadata request.
Schemas 119
The contract defines 119 schemas that model the data the API accepts and returns. The most detailed are telemetry.DruidQueryContext (20 properties), telemetry.DruidSegmentMetadataResult (7 properties), telemetry.DruidError (3 properties), telemetry.DruidScanResult (3 properties). Each schema is shown below with its type and property counts.
telemetry.DruidBaseRequest
object
The base structure for all Druid requests.
1 property
1 required
telemetry.DruidError
object
The error response when a Druid query fails.
3 properties
telemetry.DruidIntervalResult
object
The time series results for a particular interval
2 properties
telemetry.DruidTopNResult
object
Sorted time series results for a particular interval based on some criteria
2 properties
telemetry.DruidGroupByResult
object
A time series result based on a provided groupBy query. Result can contain multiple dimensions and values.
3 properties
telemetry.DruidScanResult
object
Druid Scan row result.
3 properties
telemetry.DruidSearchResult
object
Dimension value matching the search query.
2 properties
telemetry.DruidTimeBoundaryResult
object
The earliest and latest timestamps for a dataset
2 properties
telemetry.DruidSegmentMetadataResult
object
Metadata about a Druid segment
7 properties
telemetry.DruidDataSourceMetadataResult
object
Metadata about a Druid datasource
2 properties
telemetry.DruidBaseGranularity
object
The base structure for a Druid granularity.
1 property
1 required
telemetry.DruidGranularity
The granularity field determines how data gets bucketed across the time dimension, or how it gets aggregated by hour, day, minute, etc. It can be specified eit…
telemetry.DruidDurationGranularity
Duration granularities are specified as an exact duration in milliseconds and timestamps are returned as UTC. Duration granularity values are in milliseconds.…
telemetry.DruidPeriodGranularity
Period granularities are specified as arbitrary period combinations of years, months, weeks, hours, minutes and seconds (e.g., P2W, P3M, PT1H30M, PT0.750S) in…
telemetry.DruidBaseDataSource
object
A data source is the Apache Druid equivalent of a database table. However, a query can also masquerade as a data source, providing subquery-like functionality.…
1 property
1 required
telemetry.DruidDataSource
A data source is the Apache Druid equivalent of a database table. However, a query can also masquerade as a data source, providing subquery-like functionality.…
telemetry.DruidTableDataSource
The table data source is the most common datasource type. They are split up into segments, distributed around the cluster, and queried in parallel.
telemetry.DruidUnionDataSource
This data source unions two or more table data sources. Note that the data sources being unioned should have the same schema.
telemetry.DruidQueryDataSource
This is used for nested groupBys and is only currently supported for groupBys.
telemetry.DruidLookupDataSource
Lookup datasources correspond to Druid's key-value lookup objects. In Druid SQL, they reside in the the lookup schema. They are preloaded in memory on all serv…
telemetry.DruidInlineDataSource
Inline datasources allow you to query a small amount of data that is embedded in the query itself. They are useful when you want to write a query on a small am…
telemetry.DruidJoinDataSource
Join datasources allow you to do a SQL-style join of two datasources. Stacking joins on top of each other allows you to join arbitrarily many datasources. Join…
telemetry.DruidBaseTopNMetricSpec
object
A Druid TopN metric spec.
1 property
1 required
telemetry.DruidTopNMetricSpec
A Druid TopN metric spec.
telemetry.DruidNumericTopNMetricSpec
The simplest metric specification is a String value indicating the metric to sort topN results by.
telemetry.DruidDimensionTopNMetricSpec
This metric specification sorts TopN results by dimension value, using one of the sorting orders.
telemetry.DruidInvertedTopNMetricSpec
Sort dimension values in inverted order, i.e inverts the order of the delegate metric spec. It can be used to sort the values in ascending order.
telemetry.DruidBaseDimensionSpec
object
A dimension spec is used in a query to operate on dimension values.
1 property
1 required
telemetry.DruidDimensionSpec
telemetry.DruidDefaultDimensionSpec
Returns dimension values as is and optionally renames the dimension.
telemetry.DruidExtractionDimensionSpec
Returns dimension values transformed using the given extraction function.
telemetry.DruidExtractionFunction
The extraction function is used to transform input values before the filter is applied. Transformations can be applied to both regular (string) dimensions, as…
telemetry.DruidBaseExtractionFunction
object
Extraction functions define the transformation applied to each dimension value. Transformations can be applied to both regular (string) dimensions, as well as…
1 property
1 required
telemetry.DruidExtractionFunctionRegex
Returns the first matching group for the given regular expression. If there is no match, it returns the dimension value as is.
telemetry.DruidExtractionFunctionPartial
Returns the dimension value unchanged if the regular expression matches, otherwise returns null.
telemetry.DruidExtractionFunctionSearchQuery
Returns the dimension value unchanged if the given SearchQuerySpec matches, otherwise returns null.
telemetry.DruidExtractionFunctionSubstring
Returns a substring of the dimension value starting from the supplied index and of the desired length. Both index and length are measured in the number of Unic…
telemetry.DruidExtractionFunctionStrlen
Returns the length of dimension values, as measured in the number of Unicode code units present in the string as if it were encoded in UTF-16. Note that some U…
telemetry.DruidExtractionFunctionTimeFormat
Returns the dimension value formatted according to the given format string, time zone, and locale. For time dimension values, this formats the time value bucke…
telemetry.DruidExtractionFunctionTimeParsing
Parses dimension values as timestamps using the given input format, and returns them formatted using the given output format. Note, if you are working with the…
telemetry.DruidExtractionFunctionInlineLookup
Lookups are a concept in Druid where dimension values are (optionally) replaced with new values. The "lookup" extraction function lets you specify an inline lo…
telemetry.DruidExtractionFunctionCascade
Provides chained execution of extraction functions. A property of extractionFns contains an array of any extraction functions, which is executed in the array i…
telemetry.DruidExtractionFunctionStringFormat
Returns the dimension value formatted according to the given format string.
telemetry.DruidExtractionFunctionUpperCase
Returns the dimension values as all upper case. Optionally user can specify the language to use in order to perform upper transformation.
telemetry.DruidExtractionFunctionLowerCase
Returns the dimension values as all lower case. Optionally user can specify the language to use in order to perform lower transformation.
telemetry.DruidExtractionFunctionBucket
Bucket extraction function is used to bucket numerical values in each range of the given size by converting them to the same base value. Non numeric values are…
telemetry.DruidBaseHavingFilter
object
A having clause is a JSON object identifying which rows from a groupBy query should be returned, by specifying conditions on aggregated values. It is essential…
1 property
1 required
telemetry.DruidHavingFilter
telemetry.DruidHavingQueryFilter
Query filter HavingSpecs allow all Druid query filters to be used in the Having part of the query.
telemetry.DruidHavingNumericFilter
The simplest having clause is a numeric filter. Numeric filters can be used as the base filters for more complex boolean expressions of filters.
telemetry.DruidHavingDimensionSelectorFilter
The dimSelector filter will match rows with dimension values equal to the specified value.
telemetry.DruidBaseFilter
object
A filter is a JSON object indicating which rows of data should be included in the computation for a query. It's essentially the equivalent of the WHERE clause…
1 property
1 required
telemetry.DruidFilter
telemetry.DruidSelectorFilter
The selector filter matches a specific dimension with a specific value. Selector filters can be used as the base filters for more complex Boolean expressions o…
telemetry.DruidEqualityFilter
The equality filter is a replacement for the selector filter with the ability to match against any type of column. The equality filter is designed to have more…
telemetry.DruidNullFilter
The null filter is a partial replacement for the selector filter. It is dedicated to matching NULL values.
telemetry.DruidInFilter
The in filter can match input rows against a set of values, where a match occurs if the value is contained in the set. If an empty values array is passed to th…
telemetry.DruidBoundFilter
Bound filters can be used to filter on ranges of dimension values. It can be used for comparison filtering like greater than, less than, greater than or equal…
telemetry.DruidRangeFilter
The range filter is a replacement for the bound filter. It compares against any type of column and is designed to have has more SQL compliant behavior than the…
telemetry.DruidLikeFilter
Like filters can be used for basic wildcard searches. They are equivalent to the SQL LIKE operator. Special characters supported are "%" (matches any number of…
telemetry.DruidColumnComparisonFilter
The column comparison filter compares dimensions to each other.
telemetry.DruidRegexFilter
The regular expression filter is similar to the selector filter, but using regular expressions. It matches the specified dimension with the given pattern. Note…
telemetry.DruidIntervalFilter
The Interval filter enables range filtering on columns that contain long millisecond values, with the boundaries specified as ISO 8601 time intervals. It is su…
telemetry.DruidTrueFilter
A filter which matches all values. You can use it to temporarily disable other filters without removing them.
telemetry.DruidFalseFilter
A filter matches no values. You can use it to force a query to match no values.
telemetry.DruidSearchFilter
You can use search filters to filter on partial string matches.
telemetry.DruidBaseQuerySpec
object
A Druid query spec.
1 property
1 required
telemetry.DruidQuerySpec
telemetry.DruidQuerySpecContains
A 'contains' query spec.
telemetry.DruidQuerySpecInsensitiveContains
A 'insensitivecontains' query spec. Note that an "insensitivecontains" search is equivalent to a "contains" search with "caseSensitive" false (or not provided).
telemetry.DruidQuerySpecFragment
A 'fragment' query spec.
telemetry.DruidExpressionFilter
The expression filter allows for the implementation of arbitrary conditions, leveraging the Druid expression system. This filter allows for complete flexibilit…
telemetry.DruidAndFilter
A logical AND expression filter.
telemetry.DruidOrFilter
A logical OR expression filter.
telemetry.DruidNotFilter
A logical NOT expression filter.
telemetry.DruidBaseAggregator
object
A Druid aggregator.
1 property
1 required
telemetry.DruidAggregator
telemetry.DruidCountAggregator
Computes the count of Druid rows that match the filters. The count aggregator counts the number of Druid rows, which does not always reflect the number of raw…
telemetry.DruidSumAggregator
Computes the sum of values.
telemetry.DruidMinMaxAggregator
Computes the min or max of values.
telemetry.DruidFirstLastAggregator
(Double/Float/Long) First and Last aggregator cannot be used in ingestion spec, and should only be specified as part of queries. Note that queries with first/l…
telemetry.DruidStringFirstLastAggregator
Computes the metric value with the minimum/maximum timestamp or null if no row exist.
telemetry.DruidAnyAggregator
Returns any value including null. This aggregator can simplify and optimize the performance by returning the first encountered value (including null).
telemetry.DruidStringAnyAggregator
Returns any value including null. This aggregator can simplify and optimize the performance by returning the first encountered value (including null).
telemetry.DruidFilteredAggregator
A filtered aggregator wraps any given aggregator, but only aggregates the values for which the given dimension filter matches. This makes it possible to comput…
telemetry.DruidThetaSketchAggregator
Theta sketch aggregation provides a class of specialized algorithms, called streaming algorithms, or sketches that can produce results orders-of magnitude fast…
telemetry.DruidBaseLimitSpec
object
The limitSpec field provides the functionality to sort and limit the set of results from a groupBy query. If you group by a single dimension and are ordering b…
1 property
1 required
telemetry.DruidDefaultLimitSpec
The default limit spec takes a limit and the list of columns to do an orderBy operation over.
telemetry.DruidOrderByColumnSpec
object
OrderByColumnSpecs indicate how to do order by operations. Each order-by condition can be a jsonString or a map.
3 properties
telemetry.DruidBaseVirtualColumn
object
Virtual columns are columns that are computed on the fly during query execution. If you include a virtual column as part of a query, make sure to include all a…
1 property
1 required
telemetry.DruidVirtualColumn
telemetry.DruidExpressionVirtualColumn
A virtual column defined as a Druid expression. Supported Druid expressions are documented at https://druid.apache.org/docs/latest/misc/math-expr.html.
telemetry.NestedFieldVirtualColumn
A virtual column defined as a nested field. The nested field virtual column is an optimized virtual column that can provide direct access into various paths of…
telemetry.DruidListFilteredVirtualColumn
This virtual column provides an alternative way to use 'list filtered' dimension spec as a virtual column. It has optimized access to the underlying column val…
telemetry.DruidBasePostAggregator
object
Post-aggregations are specifications of processing that should happen on aggregated values as they come out of Apache Druid. If you include a post aggregation…
2 properties
1 required
telemetry.DruidPostAggregator
telemetry.DruidArithmeticPostAggregator
The arithmetic post-aggregator applies the provided function to the given fields from left to right. The fields can be aggregators or other post aggregators. S…
telemetry.DruidExpressionPostAggregator
A post-aggregator defined as a Druid expression. Supported Druid expressions are documented at https://druid.apache.org/docs/latest/misc/math-expr.html.
telemetry.DruidFieldAccessorPostAggregator
These post-aggregators return the value produced by the specified aggregator. 'fieldName' refers to the output name of the aggregator given in the aggregations…
telemetry.DruidConstantPostAggregator
The constant post-aggregator always returns the specified value.
telemetry.DruidGreatestLeastPostAggregator
doubleGreatest and longGreatest computes the maximum of all fields and Double.NEGATIVEINFINITY. doubleLeast and longLeast computes the minimum of all fields an…
telemetry.DruidHyperUniquePostAggregator
The hyperUniqueCardinality post aggregator is used to wrap a hyperUnique object such that it can be used in post aggregations. This post-aggregator will inheri…
telemetry.DruidThetaSketchEstimatePostAggregator
Post aggregator of type fieldAccess that refers to a thetaSketch aggregator or that of type thetaSketchSetOp.
telemetry.DruidThetaSketchOperationsPostAggregator
telemetry.DruidQueryContext
object
The query context is used for various query configuration parameters. Can be used to modify query behavior, including grand totals and zero-filling.
20 properties
telemetry.DruidTimeSeriesRequest
These types of queries take a timeseries query object and return an array of JSON objects where each object represents a value asked for by the timeseries quer…
telemetry.DruidTopNRequest
TopN queries return a sorted set of results for the values in a given dimension according to some criteria. Conceptually, they can be thought of as an approxim…
telemetry.DruidGroupByRequest
These types of Apache Druid queries take a groupBy query object and return an array of JSON objects where each object represents a grouping asked for by the qu…
telemetry.DruidScanRequest
The Scan query returns raw Apache Druid rows in streaming mode. In addition to straightforward usage where a Scan query is issued to the Broker, the Scan query…
telemetry.DruidSearchRequest
These types of queries returns dimension values that match the search specification
telemetry.DruidBaseSearchSpec
object
The base structure for all Druid search specifications.
1 property
1 required
telemetry.DruidAggregateSearchSpec
Generic search specification descriptor
telemetry.DruidInsensitiveContainsSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidFragmentSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidContainsSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidRegexSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidTimeBoundaryRequest
Time boundary queries return the earliest and latest data points of a data set.
telemetry.DruidSegmentMetadataRequest
Time boundary queries return the earliest and latest data points of a data set.
telemetry.DruidDataSourceMetadataRequest
Data Source Metadata queries return metadata information for a dataSource. These queries return information about the timestamp of latest ingested event for th…
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Cisco Intersight 10
Other APIs Cisco Intersight publishes across the network.
Cisco Intersight Fabric API
Cisco Intersight HyperFlex API
Cisco Intersight Kubernetes API
Cisco Intersight Nexus Insight Advisor API
Cisco Intersight Orchestrator API
Cisco Intersight Server API
Cisco Intersight Storage API
Cisco Intersight System API
Cisco Intersight Virtualization API
Cisco Intersight Workflows API
#Telemetry#Metrics#Observability
Where this information came from
This is an independent, third-party profile of Cisco Intersight Telemetry API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.