> ## Documentation Index > Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt > Use this file to discover all available pages before exploring further. # Ingesta mediante remote_write de Prometheus > Acepta un cuerpo WriteRequest protobuf comprimido con snappy, el formato de cable canónico de Prometheus remote_write. El servicio decodifica, sella las etiquetas `basaltic_account_id` + `basaltic_org_id` en cada serie temporal y mantiene las muestras en ClickHouse. Las etiquetas de inquilino suministradas por el llamador se quitan antes de estamparse: los productores no pueden suplantar su cuenta. Requiere `telemetry:WriteMetrics`. Devuelve 204 en caso de éxito (especificación de Prometheus); 4xx con un sobre de error JSON de lo contrario. Requiere la acción de IAM **`telemetry:WriteMetrics`**. Consulte [permisos de telemetría](/telemetry/permissions) para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva. ## OpenAPI ````yaml /es/api-reference/specs/telemetry.yaml post /v1/metrics/write openapi: 3.0.3 info: title: API de telemetría basaltica version: 1.0.0 description: > API de telemetría regional: grupos de registros + ingesta/búsqueda de registros, métricas de ClickHouse (escritura_remota + consulta estructurada con sobres JSON compatibles con Prometheus), ingesta de intervalos y búsqueda/detalle de trazas + configuración de trazas por cuenta. Las referencias de solicitud de grupo de registro aceptan UUID, CRN o nombres exactos de ámbito de cuenta, clasificados por sintaxis sin fallback de búsqueda. Los CRN deben coincidir con el identificador de cuenta autenticado y la región de entrega. Los registros HTTP y gRPC OTLP usan basaltic.log_group, que se refiere a service.name, con el mismo contrato de referencia. Los identificadores de traza/intervalo, las etiquetas de métrica y las dimensiones de búsqueda de región son valores de protocolo, independientes de la resolución del recurso. contact: name: Basaltic Support email: ping@basaltic.sh license: name: Proprietary url: https://basaltic.sh/terms servers: - url: https://telemetry.{region}.basaltic.sh description: Endpoint de API regional (uno por región) variables: region: default: sa-saopaulo-1 description: Código de región security: - BearerAuth: [] paths: /v1/metrics/write: post: tags: - Telemetry summary: Ingesta mediante remote_write de Prometheus description: > Acepta un cuerpo WriteRequest protobuf comprimido con snappy, el formato de cable canónico de Prometheus remote_write. El servicio decodifica, sella las etiquetas `basaltic_account_id` + `basaltic_org_id` en cada serie temporal y mantiene las muestras en ClickHouse. Las etiquetas de inquilino suministradas por el llamador se quitan antes de estamparse: los productores no pueden suplantar su cuenta. Requiere `telemetry:WriteMetrics`. Devuelve 204 en caso de éxito (especificación de Prometheus); 4xx con un sobre de error JSON de lo contrario. operationId: writeMetrics requestBody: required: true content: application/x-protobuf: schema: type: string format: binary description: ¿Qué es prometheus.prompb.WriteRequest? responses: '204': description: Aceptado '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalServerError' components: responses: BadRequest: description: Parámetros de solicitud no válidos content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INVALID_INPUT message: Invalid request parameters request_id: 550e8400-e29b-41d4-a716-446655440000 Unauthorized: description: Se requiere autenticación o el token no es válido content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: Authentication required request_id: 550e8400-e29b-41d4-a716-446655440000 Forbidden: description: Permisos insuficientes content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: ACCESS_DENIED message: You don't have permission to perform this action request_id: 550e8400-e29b-41d4-a716-446655440000 InternalServerError: description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_ERROR message: An internal error occurred request_id: 550e8400-e29b-41d4-a716-446655440000 schemas: Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: Código de error que identifica el tipo de error example: INVALID_INPUT message: type: string description: Mensaje de error legible por el ser humano example: Invalid request parameters params: type: object additionalProperties: true description: >- Valores no sensibles opcionales para la interpolación de errores localizados, codificados por código de error. Nunca presente por errores del servidor. example: instances: 2 pools: 0 request_id: type: string format: uuid description: Solicitar ID para depuración example: 550e8400-e29b-41d4-a716-446655440000 securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >+ Un token bearer de OAuth 2.0, enviado como `Authorization: Bearer `. Esta es la forma recomendada de autenticación. Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en `POST /v1/oauth/token` con `grant_type=client_credentials`. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti. ``` curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \ https://iam.basaltic.sh/v1/oauth/token ``` Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.