diff --git a/src/content/docs/logs/logpull/requesting-logs.mdx b/src/content/docs/logs/logpull/requesting-logs.mdx index 062ced7d4eb04c4..0505bba85e5b7c0 100644 --- a/src/content/docs/logs/logpull/requesting-logs.mdx +++ b/src/content/docs/logs/logpull/requesting-logs.mdx @@ -47,7 +47,7 @@ The following table describes the parameters available: | Parameter | Description | Applies to | Required | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | -------- | -| start |

- Inclusive

- Timestamp formatted as `UNIX` (UTC by definition), `UNIX Nano`, or `rfc3339`. To specify `rfc3339` time zone in URL query parameters, the URL needs to be enconded, like this `start=2024-08-07T07:00:00%2B08:00&end=2024-08-07T07:01:00%2B08:00`.

- Must be no more than 7 days earlier than now

| /logs/received | Yes | +| start |

- Inclusive

- Timestamp formatted as `UNIX` (UTC by definition), `UNIX Nano`, or `rfc3339`. To specify `rfc3339` time zone in URL query parameters, the URL needs to be encoded, like this `start=2024-08-07T07:00:00%2B08:00&end=2024-08-07T07:01:00%2B08:00`.

- Must be no more than 7 days earlier than now

| /logs/received | Yes | | end |

- Exclusive

- Same format as start

- Must be at least 1 minute earlier than now and later than start

| /logs/received | Yes | | count |

- Return up to that many records

- Do not include if returning all records

- Results are not sorted; therefore, different data for repeated requests is likely

- Applies to number of total records returned, not number of sampled records

| /logs/received | No | | sample |

- Return only a sample of records

- Do not include if returning all records

- Value can range from `0.0` (exclusive) to `1.0` (inclusive)

- `sample=0.1` means return 10% (1 in 10) of all records

- Results are random; therefore, different numbers of results for repeated requests are likely

| /logs/received | No |