--- title: "Changes to Query available facets for a specific metric" method: GET path: "/environments/{envId}/analytics/definition/metrics/{metricName}/facets" --- # Changes to Query available facets for a specific metric `GET /environments/{envId}/analytics/definition/metrics/{metricName}/facets` > Every recorded change to this operation, newest first. ## Timeline Changed in 13 of 49 revisions. - **2026-08-18** `ff8d60356a08`: 4 warning, 21 info - **2026-06-01** `6889427e4080`: 4 warning, 3 info - **2026-05-27** `18f9da80195c`: 3 warning, 1 info - **2026-05-26** `62bb38b527c8`: 1 warning, 1 info - **2026-04-22** `8343ab9cffda`: 1 warning - **2026-03-18** `2b8d5cc6e7ad`: 2 breaking - **2026-03-12** `cb90e98052aa`: 18 breaking, 7 info - **2026-02-25** `929f62a57adb`: 1 breaking, 1 info - **2026-02-20** `52aff7b93cb4`: 4 warning - **2026-02-06** `ea8ac2e5939c`: 2 breaking, 2 info - **2026-02-06** `5956141ac3d1`: 2 warning, 2 info - **2025-11-28** `a8b6465c1046`: 1 warning - **2025-11-04** `a507f5b634be`: 1 info ## Changes - **2026-08-18** `ff8d60356a08`: 4 warning, 21 info - added the new `NATIVE_CLIENT_ID` enum value to the `data/items/name` response property for the response status `200` - added the new `NATIVE_FAILURE_SIDE` enum value to the `data/items/name` response property for the response status `200` - added the new `NATIVE_OPERATION` enum value to the `data/items/name` response property for the response status `200` - added the new `NATIVE_TOPIC` enum value to the `data/items/name` response property for the response status `200` - added the new enum value `NATIVE_ACTIVE_CONNECTIONS_DOWNSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_ACTIVE_CONNECTIONS_UPSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_AUTHENTICATIONS_FAILURE_DOWNSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_AUTHENTICATIONS_FAILURE_UPSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_AUTHENTICATIONS_SUCCESS_DOWNSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_AUTHENTICATIONS_SUCCESS_UPSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_BYTES_CONSUMED_DOWNSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_BYTES_CONSUMED_UPSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_BYTES_PRODUCED_DOWNSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_BYTES_PRODUCED_UPSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_MESSAGES_CONSUMED_DOWNSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_MESSAGES_CONSUMED_UPSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_MESSAGES_PRODUCED_DOWNSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_MESSAGES_PRODUCED_UPSTREAM` to the `path` request parameter `metricName` - added the new enum value `NATIVE_OPERATIONS_ANSWERED` to the `path` request parameter `metricName` - added the new enum value `NATIVE_OPERATIONS_COMPLETED` to the `path` request parameter `metricName` - added the new enum value `NATIVE_OPERATIONS_FORWARDED` to the `path` request parameter `metricName` - added the new enum value `NATIVE_OPERATIONS_RECEIVED` to the `path` request parameter `metricName` - added the new enum value `NATIVE_OPERATION_BROKER_DURATION` to the `path` request parameter `metricName` - added the new enum value `NATIVE_OPERATION_GATEWAY_REQUEST_DURATION` to the `path` request parameter `metricName` - added the new enum value `NATIVE_OPERATION_GATEWAY_RESPONSE_DURATION` to the `path` request parameter `metricName` - **2026-06-01** `6889427e4080`: 4 warning, 3 info - added the new `EDGE_MODEL` enum value to the `data/items/name` response property for the response status `200` - added the new `EDGE_TOOL` enum value to the `data/items/name` response property for the response status `200` - added the new `EDGE_TYPE` enum value to the `data/items/name` response property for the response status `200` - added the new `EDGE_VERSION` enum value to the `data/items/name` response property for the response status `200` - added the new enum value `EDGE_HEARTBEAT_COUNT` to the `path` request parameter `metricName` - added the new enum value `EDGE_TOKENS_IN` to the `path` request parameter `metricName` - added the new enum value `EDGE_TOKENS_OUT` to the `path` request parameter `metricName` - **2026-05-27** `18f9da80195c`: 3 warning, 1 info - added the new `EDGE_CLIENT` enum value to the `data/items/name` response property for the response status `200` - added the new `EDGE_PROCESS` enum value to the `data/items/name` response property for the response status `200` - added the new `EDGE_PROVIDER` enum value to the `data/items/name` response property for the response status `200` - added the new enum value `EDGE_DETECTION_COUNT` to the `path` request parameter `metricName` - **2026-05-26** `62bb38b527c8`: 1 warning, 1 info - added the new `NATIVE_CONNECTION_STATUS` enum value to the `data/items/name` response property for the response status `200` - added the new enum value `NATIVE_CONNECTIONS_SUMMARY` to the `path` request parameter `metricName` - **2026-04-22** `8343ab9cffda`: 1 warning - added the new `API_PRODUCT` enum value to the `data/items/name` response property for the response status `200` - **2026-03-18** `2b8d5cc6e7ad`: 2 breaking - removed the enum value `HTTP_RPS` from the `path` request parameter `metricName` - removed the enum value `MESSAGE_RPS` from the `path` request parameter `metricName` - **2026-03-12** `cb90e98052aa`: 18 breaking, 7 info - removed the enum value `APIS` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_ACTIVE_CONNECTIONS` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_AUTHENTICATED_CONNECTIONS` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_AUTHENTICATION_ERRORS` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_AUTHENTICATION_SUCCESSES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_PUBLISH_MESSAGES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_PUBLISH_MESSAGES_BYTES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_SUBSCRIBE_MESSAGES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_DOWNSTREAM_SUBSCRIBE_MESSAGE_BYTES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_ACTIVE_CONNECTIONS` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_AUTHENTICATED_CONNECTIONS` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_AUTHENTICATION_ERRORS` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_AUTHENTICATION_SUCCESSES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_PUBLISH_MESSAGES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_PUBLISH_MESSAGE_BYTES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_SUBSCRIBE_MESSAGES` from the `path` request parameter `metricName` - removed the enum value `KAFKA_UPSTREAM_SUBSCRIBE_MESSAGE_BYTES` from the `path` request parameter `metricName` - removed the enum value `SUBSCRIPTIONS` from the `path` request parameter `metricName` - added the new enum value `HTTP_ERROR_RATE` to the `path` request parameter `metricName` - added the new enum value `HTTP_RPS` to the `path` request parameter `metricName` - added the new enum value `MESSAGE_RPS` to the `path` request parameter `metricName` - removed the `API_LIFECYCLE_STATE` enum value from the `data/items/name` response property for the response status `200` - removed the `API_STATE` enum value from the `data/items/name` response property for the response status `200` - removed the `API_VISIBILITY` enum value from the `data/items/name` response property for the response status `200` - removed the `KAFKA_TOPIC` enum value from the `data/items/name` response property for the response status `200` - **2026-02-25** `929f62a57adb`: 1 breaking, 1 info - removed the enum value `LLM_PROMPT_TOKEN_COST` from the `path` request parameter `metricName` - added the new enum value `LLM_PROMPT_TOKEN_TOTAL_COST` to the `path` request parameter `metricName` - **2026-02-20** `52aff7b93cb4`: 4 warning - added the new `MCP_PROXY_METHOD` enum value to the `data/items/name` response property for the response status `200` - added the new `MCP_PROXY_PROMPT` enum value to the `data/items/name` response property for the response status `200` - added the new `MCP_PROXY_RESOURCE` enum value to the `data/items/name` response property for the response status `200` - added the new `MCP_PROXY_TOOL` enum value to the `data/items/name` response property for the response status `200` - **2026-02-06** `ea8ac2e5939c`: 2 breaking, 2 info - removed the enum value `LLM_TOTAL_TOKEN` from the `path` request parameter `metricName` - removed the enum value `LLM_TOTAL_TOKEN_COST` from the `path` request parameter `metricName` - added the new enum value `LLM_PROMPT_TOKEN_COST` to the `path` request parameter `metricName` - added the new enum value `LLM_PROMPT_TOTAL_TOKEN` to the `path` request parameter `metricName` - **2026-02-06** `5956141ac3d1`: 2 warning, 2 info - added the new `LLM_PROXY_MODEL` enum value to the `data/items/name` response property for the response status `200` - added the new `LLM_PROXY_PROVIDER` enum value to the `data/items/name` response property for the response status `200` - added the new enum value `LLM_TOTAL_TOKEN` to the `path` request parameter `metricName` - added the new enum value `LLM_TOTAL_TOKEN_COST` to the `path` request parameter `metricName` - **2025-11-28** `a8b6465c1046`: 1 warning - added the new `MESSAGE_CONNECTOR_ID` enum value to the `data/items/name` response property for the response status `200` - **2025-11-04** `a507f5b634be`: 1 info - endpoint added --- [Operation](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-analytics/docs/environments/:envId/analytics/definition/metrics/:metricName/facets/get.md) - [API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-analytics.md) - [Page](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-analytics/changes/environments/:envId/analytics/definition/metrics/:metricName/facets/get)