Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# QueryMetrics
<a name="AMP-APIReference-QueryMetrics"></a>

La operación `QueryMetrics` evalúa una consulta instantánea en un único punto en el tiempo o en un intervalo de tiempo.

Verbos HTTP válidos:  
`GET`, `POST`

Válido URIs:  
`/workspaces/{{workspaceId}}/api/v1/query` Este URI evalúa una consulta instantánea en un único momento.  
`/workspaces/{{workspaceId}}/api/v1/query_range` Este URI evalúa una consulta instantánea en un intervalo de tiempo.

Parámetros de consulta de URL:  
`query=<string>` Una cadena de consulta de expresiones de Prometheus. Se utiliza tanto en `query` como en `query_range`.  
`time=<rfc3339 | unix_timestamp>` (Opcional) Marca temporal de evaluación si está utilizando la `query` para una consulta instantánea en un momento dado.  
`timeout=<duration>` (Opcional) Tiempo de espera de la evaluación. Por defecto, se limita al valor de la marca `-query.timeout`. Se utiliza tanto en `query` como en `query_range`.  
`start=<rfc3339 | unix_timestamp>` Marca de tiempo de inicio si está utilizando `query_range` para consultar un intervalo de tiempo.   
`end=<rfc3339 | unix_timestamp>` Marca de tiempo de finalización si está utilizando `query_range` para consultar un intervalo de tiempo.  
`step=<duration | float>` Ancho del paso de resolución de la consulta en formato `duration` o como número de segundos `float`. Úselo solo si va a utilizar `query_range` para realizar consultas durante un intervalo de tiempo y si es necesario para dichas consultas.  
`max_samples_processed_warning_threshold=<integer>` (Opcional) Establece el umbral de advertencia para las muestras de consulta procesadas (QSP). Cuando las consultas alcancen este umbral, se mostrará un mensaje de advertencia en la respuesta de la API.  
`max_samples_processed_error_threshold=<integer>>` (Opcional) Establece el umbral de error para las muestras de consulta procesadas (QSP). Las consultas que superen este umbral se rechazarán con un error y no se cobrará nada. Se utiliza para evitar costos de consulta excesivos.

**Duración**

En una API compatible con Prometheus, una `duration` es un número, seguido inmediatamente de una de las siguientes unidades:
+ `ms` milisegundos
+ `s` segundos
+ `m` minutos
+ `h` horas
+ `d` días, suponiendo que un día siempre tenga 24 horas
+ `w` semanas, suponiendo que una semana siempre tenga 7 días
+ `y` años, suponiendo que un año siempre tenga 365 días

**Solicitud de ejemplo**

```
POST /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/query?query=sum(node_cpu_seconds_total) HTTP/1.1
Content-Length: 0, 
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Grafana/8.1.0
```

**Respuesta de ejemplo**

```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length: 132
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
content-encoding: gzip

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {},
                "value": [
                    1634937046.322,
                    "252590622.81000024"
                ]
            }
        ]
    }
}
```