@grepr/cli 1.11.10-e534892 → 1.11.12-616e521

package/build/dist/docs-index/d4475b8d-da44-49b3-976b-7c4402d6ae6c.txt

@@ -1,34 +0,0 @@
-# Creates or updates an OpenAI integration API key
-
-**PUT** `/v1/integrations/openai/{id}/api-key`
-
-**Operation ID**: `upsertApiKey_9`
-**Summary**: Creates or updates an OpenAI integration API key
-Creates an API key for an OpenAI integration if it doesn't exist and updates it otherwise. If the key is updated while the integration is being used by a pipeline, the new key will be picked at pipeline restart, rescaling or an update.
-
-## Tags
-- OpenAI Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `SecretApi`
-
-## Responses
-
-### 204
-
-API key upserted successfully.
-
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/d57a3a59-1f25-4aa9-80db-65b0cc38f544.txt

@@ -1,30 +0,0 @@
-# Delete a single OTLP integration secret header
-
-**DELETE** `/v1/integrations/otlp/{id}/secret-headers/{name}`
-
-**Operation ID**: `deleteSecretHeader`
-**Summary**: Delete a single OTLP integration secret header
-Deletes a single secret HTTP header from an OTLP integration.
-
-## Tags
-- OpenTelemetry Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-- **name** (required) - path
-  - Type: string
-
-## Responses
-
-### 204
-
-Secret header deleted successfully
-
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/d886ddd4-4ded-4346-943a-fd6830c3fd4f.txt

@@ -1,117 +0,0 @@
-Learn how Grepr indexes log attributes and tags as columns in the data lake, and the rules that decide which fields each dataset indexes.
-
-# Indexed columns
-
-Grepr stores each raw log's attributes as one JSON document and its tags as a map. A search that filters on one attribute reads every log's whole attribute document to find a match.
-
-An *indexed column* removes that cost for one field. Grepr writes the field into its own column in the dataset's data lake table, so a search that filters on the field reads that column and skips the files that can't contain a match. See [The Grepr data lake](/grepr-platform/data-lake).
-
-Searches don't change. The same search returns the same results whether or not a field is indexed, and runs faster when it is.
-
-## What Grepr indexes
-
-Each dataset's raw log table has indexing settings for two groups of fields:
-
-* Attributes, named by their dotted path, such as `http.method` or `kube.pod.name`. An indexed path has a column for its value, and a path that holds numbers can also have a numeric column, so that range filters skip files too.
-* Tags, named by their key, such as `region` or `pod_name`. An indexed tag key has a column for its value.
-
-Grepr always indexes the `service` and `host` tags, whatever the settings say.
-
-For each group, you choose whether Grepr discovers new fields, which fields it always indexes, and which fields it never indexes.
-
-## Discovery \[#discovery]
-
-When discovery is on, Grepr adds a column for a new field it finds in your logs, until the group has as many columns as its *discovery cap*. Your organization sets the largest cap you can choose. The tag cap doesn't count `service` and `host`.
-
-For attributes, the cap counts every attribute column, including the ones for paths on the always-index list, so to make room for more paths, raise the cap.
-
-Discovery is off for a new dataset, so until you turn it on, Grepr indexes only `service`, `host`, and the tag keys on the always-index list. Attribute paths on the always-index list get columns after you turn discovery on. Discovery then also indexes other attribute paths it finds, so to index only the paths you list, turn on **Exclude all by default** as well. See [Always index and never index](#lists).
-
-When discovery is on and Grepr finds a number at an indexed path, the path also gets a numeric column. A numeric column doesn't count toward the cap.
-
-Turning discovery off stops Grepr from adding columns for new fields. Columns the table already has keep being written. To stop writing a column, add the field to the never-index list.
-
-## Always index and never index \[#lists]
-
-Grepr stops writing a field on a never-index list.
-
-For attribute paths:
-
-* A path matches exactly and is case-sensitive. Write the path as it appears in the log.
-* An entry that includes nested paths covers the path and every path under it, split at dots. For example, `kube` with nested paths covers `kube` and `kube.pod.name`, but not `kubernetes`. Wildcards aren't supported.
-* A path on the always-index list counts toward the cap. An exact path gets its column when you save, if the table is under its cap; if it isn't, the path gets its column when you save a higher cap. Paths under a nested entry are discovered like any other path, so they get columns as pipelines find them, up to the cap.
-* An always-index entry marked numeric gets its numeric column when you save, even when the table has reached its cap, as long as the path has its value column. Use it for values that are numbers written as strings. Only an exact path can be marked numeric: a path under a nested entry gets its numeric column when Grepr finds a number there.
-* Always index wins over never index. To stop indexing a subtree except for one path, add the subtree to the never-index list with nested paths, and add the one path to the always-index list. An always-index entry can't cover a never-index entry entirely, because the never-index entry would then never take effect.
-* To index only the paths on the always-index list, turn on **Exclude all by default**. Columns the table already has for other paths stop being written and are removed from the table on the same schedule as a field on a never-index list. See [Excluded fields and removed columns](#excluded). Turning it off before the removal keeps them. The never-index list must be empty while it's on, because every other path is already excluded. To stop discovering new paths but keep writing the columns you have, set the cap to the number of columns the table has instead.
-
-For tag keys:
-
-* Grepr indexes a key on the always-index list whether discovery is on or off, and whether or not the group has reached its cap.
-* A key matches exactly.
-* A key can't be on both lists.
-* `service`, `host`, and any key the table is partitioned on can't be on the never-index list.
-* To partition a table on a tag key, the key must be on the always-index list, and it stays there while the table is partitioned on it.
-
-## When changes take effect
-
-A change reaches running pipelines within about a minute, without a restart. A tag key you add to the always-index list gets its column when you save, so you can partition on it immediately. An exact attribute path you add gets its column when you save, if the table is under its cap. A discovered path gets its column after pipelines find it in more than one log, while the table is under its cap.
-
-## Excluded fields and removed columns \[#excluded]
-
-When you add a field to a never-index list, Grepr stops writing the field's column within about a minute, and searches read the field from the log's attributes or tags instead, so they return the same results.
-
-Grepr schedules the column for removal from the table 6 hours after you exclude the field, and the table's indexing settings show that time under the field. While the pipeline is receiving logs, the column is removed at that time or within about an hour after it. A pipeline that receives no logs removes it once logs arrive again. Until then the column still counts toward the discovery cap; once it's removed, its place is free. Logs written before the removal stay searchable through their attributes and tags, but searches on that field no longer skip files using the column.
-
-If you take the field off the never-index list before then, the removal is cancelled: Grepr goes back to writing the same column, and everything already indexed in it stays. After the removal, the field gets a new column the same way a field that was never indexed does: from the always-index list when you save, if the table is under its cap for an attribute path, or from discovery if the table is under its discovery cap. The new column covers only logs written from then on.
-
-## Change indexing through the API
-
-Reading a table's configuration returns its indexing settings with a `revision`. To change them, send the complete settings for both groups to the promotion endpoint, which replaces what's stored. Include the `revision` you read: if the settings changed since then, the request fails with a 409 error, and you read them again before you retry. Without a `revision`, the request replaces the stored settings whatever they are. See the [Datasets specification](/apis/api-spec#tag/Datasets).
-
-Each excluded attribute entry, and each excluded tag key under `tags.scheduledRemovalAt`, comes back with `scheduledRemovalAt`: when Grepr removes its columns. While `attributes.excludeAllByDefault` is on, `attributes.excludeAllScheduledRemovalAt` is when Grepr removes the columns it excludes. Grepr sets it when the entry is first saved and ignores any value you send. To change how long Grepr waits before removing an excluded column, set `columnRemovalDelay` to an ISO-8601 duration from `PT2M` (2 minutes) to `P30D` (30 days). Without it, the delay is 6 hours. A new delay applies to entries you exclude from then on.
-
-## Frequently Asked Questions
-
-### What is an indexed column in Grepr?
-
-An indexed column is a log attribute path or tag key that Grepr writes into its own column in the dataset's data lake table, instead of leaving it only in the log's attribute document or tags. Searches that filter on the field read that column and skip files that can't match, which makes them faster.
-
-### Do I have to list the fields I want indexed?
-
-No, if you turn on discovery. Grepr then adds a column for each new field it finds, up to the discovery cap. Discovery is off for a new dataset. List a tag key on the always-index list to index it whether or not discovery is on. An attribute path on the always-index list counts toward the cap, so it gets a column only while the table is under its cap.
-
-### Do my searches change when a field is indexed?
-
-No. The same search returns the same results whether or not a field is indexed, and runs faster when it is.
-
-### What happens when I turn discovery off?
-
-Grepr stops adding columns for new fields, including for attribute paths on the always-index list. Every column the table already has keeps being written.
-
-### How do I stop Grepr from writing a column?
-
-Add the field to the never-index list. Turning discovery off doesn't do it, because that only stops new columns. Grepr stops writing the column within about a minute and removes it from the table 6 hours later. Take the field off the list before then to keep the column. The data already written stays searchable.
-
-### What if an attribute path is on both the always-index and never-index lists?
-
-Always index wins. You can exclude a subtree with a nested-paths entry and keep one path inside it indexed. An always-index entry can't cover a never-index entry entirely, because the never-index entry would then never take effect. A tag key can't be on both lists.
-
-### How do I index only the attribute paths I list?
-
-Turn on Exclude all by default. Every path that isn't on the always-index list stops being indexed, including paths the table already has columns for, and the never-index list must be empty. Grepr removes those columns from the table 6 hours later, unless you turn it off before then.
-
-### When do indexing changes take effect?
-
-Within about a minute on running pipelines, without a restart. A tag key you add gets its column when you save. An exact attribute path you add gets its column when you save, if the table is under its cap. A discovered path gets its column after pipelines find it in more than one log.
-
-### Can I delete an indexed column?
-
-Yes. Add the field to the never-index list. Grepr stops writing the column within about a minute and removes it from the table 6 hours later, which frees its place under the discovery cap. Logs already written stay searchable through their attributes and tags.
-
-### Can I stop indexing service and host?
-
-No. Grepr always indexes the service and host tags, and neither key can be on the never-index list.
-
-### What does marking an always-index path numeric do?
-
-The path gets its numeric column when you save, even when the table has reached its cap, as long as the path has its value column. Use it for values that are numbers written as strings. Only an exact path can be marked numeric.

package/build/dist/docs-index/d8e58452-1b9b-47d7-aeda-d4cfd966f231.txt

@@ -1,29 +0,0 @@
-# Get a Splunk integration with exceptions
-
-**GET** `/v1/integrations/splunk/{id}/with-exceptions`
-
-**Operation ID**: `getWithExceptions_2`
-**Summary**: Get a Splunk integration with exceptions
-Get an integration to connect to Splunk with vendor imported exceptions populated.
-
-## Tags
-- Splunk Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 200
-
-Integration retrieved successfully with exceptions
-
-- **Content-Type**: `application/json` / `ReadSplunk`
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/dd61d4eb-a1d8-46dc-9278-b75a3f203e0e.txt

@@ -1,34 +0,0 @@
-# Creates or updates a Datadog MCP integration application key
-
-**PUT** `/v1/integrations/datadog-mcp/{id}/app-key`
-
-**Operation ID**: `upsertAppKey_1`
-**Summary**: Creates or updates a Datadog MCP integration application key
-Creates the DD-APPLICATION-KEY for a Datadog MCP integration if it doesn't exist and updates it otherwise.
-
-## Tags
-- Datadog MCP Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `SecretApi`
-
-## Responses
-
-### 204
-
-Application key upserted successfully.
-
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/df01a7ce-d598-43db-82a6-bd196cfebe2f.txt

@@ -1,29 +0,0 @@
-# Get a Splunk integration
-
-**GET** `/v1/integrations/splunk/{id}`
-
-**Operation ID**: `get_18`
-**Summary**: Get a Splunk integration
-Get an integration to connect to Splunk.
-
-## Tags
-- Splunk Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 200
-
-Integration retrieved successfully
-
-- **Content-Type**: `application/json` / `ReadSplunk`
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/e233ecf1-1073-482c-8b8d-22a241d18bf0.txt

@@ -1,39 +0,0 @@
-# Update a PagerDuty MCP integration.
-
-**PUT** `/v1/integrations/pagerduty-mcp/{id}`
-
-**Operation ID**: `update_10`
-**Summary**: Update a PagerDuty MCP integration.
-Updates a PagerDuty MCP integration. The version should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
-
-## Tags
-- PagerDuty MCP Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `WritePagerDutyMcp`
-
-## Responses
-
-### 200
-
-Integration updated successfully
-
-- **Content-Type**: `application/json` / `ReadPagerDutyMcp`
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.
-
-### 409
-
-Integration was modified or deleted concurrently.

package/build/dist/docs-index/e3ceaa52-0018-484a-89e2-2d20b30c8f82.txt

@@ -1,34 +0,0 @@
-# Creates or updates a Splunk integration API auth token
-
-**PUT** `/v1/integrations/splunk/{id}/rest-auth-token`
-
-**Operation ID**: `upsertRestAuthToken`
-**Summary**: Creates or updates a Splunk integration API auth token
-Creates a Splunk API auth token for a Splunk integration if it doesn't exist and updates it otherwise.  If the token is updated while the integration is being used by a pipeline, the  new token will be picked at pipeline restart, rescaling or an update.  This token is used for the Splunk API to search and retrieve logs.
-
-## Tags
-- Splunk Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `SecretApi`
-
-## Responses
-
-### 204
-
-Splunk REST API auth token upserted successfully.
-
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/e5178616-15ff-49e5-baa3-a3715271db8c.txt

@@ -1,20 +0,0 @@
-# List all OpenAI integrations
-
-**GET** `/v1/integrations/openai`
-
-**Operation ID**: `list_15`
-**Summary**: List all OpenAI integrations
-Get all OpenAI integrations for your organization. This will contain masked API keys if present.
-
-## Tags
-- OpenAI Integration
-## Responses
-
-### 200
-
-Integrations retrieved successfully
-
-- **Content-Type**: `application/json` / `ItemsCollectionReadOpenAi`
-### 401
-
-Unauthorized

package/build/dist/docs-index/e5dd8859-510d-4e7b-a01f-3a89f4a4c8e8.txt

@@ -1,20 +0,0 @@
-# List all Splunk integrations
-
-**GET** `/v1/integrations/splunk`
-
-**Operation ID**: `list_18`
-**Summary**: List all Splunk integrations
-Get all Splunk integrations for your organization. This will contain masked keys if present.
-
-## Tags
-- Splunk Integration
-## Responses
-
-### 200
-
-Integrations retrieved successfully
-
-- **Content-Type**: `application/json` / `ItemsCollectionReadSplunk`
-### 401
-
-Unauthorized

package/build/dist/docs-index/e6452690-69ed-4570-9774-b8cb17a35d78.txt

@@ -1,32 +0,0 @@
-# Create a PagerDuty MCP integration
-
-**POST** `/v1/integrations/pagerduty-mcp`
-
-**Operation ID**: `create_11`
-**Summary**: Create a PagerDuty MCP integration
-Creates an integration to connect to a PagerDuty MCP server.
-
-## Tags
-- PagerDuty MCP Integration
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `WritePagerDutyMcp`
-
-## Responses
-
-### 200
-
-Integration created successfully
-
-- **Content-Type**: `application/json` / `ReadPagerDutyMcp`
-### 401
-
-Unauthorized
-
-### 409
-
-Integration already exists.
-
-- **Content-Type**: `application/json` / `ReadPagerDutyMcp`

package/build/dist/docs-index/e75c199e-5684-4619-9930-39a3aa6d878b.txt

@@ -1,24 +0,0 @@
-# Delete a GitHub MCP integration
-
-**DELETE** `/v1/integrations/github-mcp/{id}`
-
-**Operation ID**: `delete_9`
-**Summary**: Delete a GitHub MCP integration
-Deletes a GitHub MCP integration. This will delete the associated token as well. No-op if already deleted.
-
-## Tags
-- GitHub MCP Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 204
-
-Integration deleted successfully
-
-### 401
-
-Unauthorized

package/build/dist/docs-index/e7a405ce-249a-45c8-9043-259599fd23a2.txt

@@ -1,29 +0,0 @@
-# Get a Data Warehouse integration
-
-**GET** `/v1/integrations/data-warehouse/{id}`
-
-**Operation ID**: `get_6`
-**Summary**: Get a Data Warehouse integration
-Retrieves a Data Warehouse integration.
-
-## Tags
-- Grepr-hosted Data Warehouse Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 200
-
-Data Warehouse integration retrieved successfully
-
-- **Content-Type**: `application/json` / `ReadDataWarehouse`
-### 401
-
-Unauthorized
-
-### 404
-
-Data Warehouse integration not found

package/build/dist/docs-index/eb7124e5-e9fd-4a91-b9b4-bd74baf88f92.txt

@@ -1,35 +0,0 @@
-# Update a Data Warehouse integration
-
-**PUT** `/v1/integrations/data-warehouse/{id}`
-
-**Operation ID**: `update_4`
-**Summary**: Update a Data Warehouse integration
-Updates an existing Data Warehouse integration.
-
-## Tags
-- Grepr-hosted Data Warehouse Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `WriteDataWarehouse`
-
-## Responses
-
-### 200
-
-Data Warehouse integration updated successfully
-
-- **Content-Type**: `application/json` / `ReadDataWarehouse`
-### 401
-
-Unauthorized
-
-### 404
-
-Data Warehouse integration not found

package/build/dist/docs-index/ebbbe4ad-85d8-4b2f-941e-f030423e44c2.txt

@@ -1,30 +0,0 @@
-# Create a LiteLLM integration
-
-**POST** `/v1/integrations/litellm`
-
-**Operation ID**: `create_8`
-**Summary**: Create a LiteLLM integration
-## Tags
-- LiteLLM Integration
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `WriteLiteLlm`
-
-## Responses
-
-### 200
-
-Integration created successfully
-
-- **Content-Type**: `application/json` / `ReadLiteLlm`
-### 401
-
-Unauthorized
-
-### 409
-
-Integration already exists.
-
-- **Content-Type**: `application/json` / `ReadLiteLlm`

package/build/dist/docs-index/ed9d1b0e-249e-45c1-945a-a3a052845884.txt

@@ -1,29 +0,0 @@
-# Get a SumoLogic integration
-
-**GET** `/v1/integrations/sumo/{id}`
-
-**Operation ID**: `get_19`
-**Summary**: Get a SumoLogic integration
-Get an integration to connect to SumoLogic.
-
-## Tags
-- Sumo Logic Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 200
-
-Integration retrieved successfully
-
-- **Content-Type**: `application/json` / `ReadSumo`
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.

package/build/dist/docs-index/f33cf173-4ea4-4e77-bc0b-1b8a30c59ada.txt

@@ -1,39 +0,0 @@
-# Update a Splunk integration.
-
-**PUT** `/v1/integrations/splunk/{id}`
-
-**Operation ID**: `update_16`
-**Summary**: Update a Splunk integration.
-Updates an integration to connect to Splunk. The version should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
-
-## Tags
-- Splunk Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Request Body
-
-**Content-Type**: `application/json`
-
-**Schema**: `WriteSplunk`
-
-## Responses
-
-### 200
-
-Integration updated successfully
-
-- **Content-Type**: `application/json` / `ReadSplunk`
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.
-
-### 409
-
-Integration was modified or deleted concurrently.

package/build/dist/docs-index/f5f6148e-38f8-4b4d-a1c0-1b6a7f266e59.txt

@@ -1,29 +0,0 @@
-# Get a Slack MCP integration
-
-**GET** `/v1/integrations/slack-mcp/{id}`
-
-**Operation ID**: `get_13`
-**Summary**: Get a Slack MCP integration
-Get a Slack MCP integration by ID.
-
-## Tags
-- Slack MCP Integration
-## Parameters
-
-- **id** (required) - path
-  - Type: string
-
-## Responses
-
-### 200
-
-Integration retrieved successfully
-
-- **Content-Type**: `application/json` / `ReadSlackMcp`
-### 401
-
-Unauthorized
-
-### 404
-
-Integration not found.