@grepr/cli 1.12.4-f240cd2 → 1.12.5-2e57f88

package/build/dist/commands/dataset-command.d.ts

@@ -1,9 +1,13 @@
 import { ListCommand, ListCommandOptions } from './list-command.js';
 import { CrudCommand, CrudCommandOptions, CrudCreateUpdateOptions } from './crud-command.js';
-import { CommandOption } from '../types.js';
+import { Command } from 'commander';
+import { CommandOption, MergeConfiguration } from '../types.js';
 export type DatasetListCommandOptions = ListCommandOptions;
 export type DatasetCrudCommandOptions = CrudCommandOptions;
 export type DatasetCreateUpdateOptions = CrudCreateUpdateOptions;
+export interface DatasetTableConfigOptions extends DatasetCrudCommandOptions {
+    table: string;
+}
 /**
  * Dataset list command implementation using the new architecture
  */
@@ -23,6 +27,11 @@ export declare class DatasetCrudCommand extends CrudCommand<DatasetCrudCommandOp
     protected supportsCreate(): boolean;
     protected supportsUpdate(): boolean;
     protected supportsDelete(): boolean;
+    /**
+     * Registers the CRUD commands plus dataset:table-config, which shows what a dataset table indexes.
+     */
+    addToProgram(program: Command, mergeConfiguration: MergeConfiguration): void;
+    executeTableConfig(datasetId: string, options: DatasetTableConfigOptions): Promise<void>;
     executeGet(datasetId: string, options: DatasetCrudCommandOptions): Promise<void>;
     executeCreate(options: CrudCreateUpdateOptions): Promise<void>;
     executeUpdate(datasetId: string, options: CrudCreateUpdateOptions): Promise<void>;

package/build/dist/commands/dataset-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataset-command.d.ts","sourceRoot":"","sources":["../../../src/main/typescript/commands/dataset-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE7F,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAEjE;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,yBAAyB,CAAC;IAC5E,cAAc,IAAI,MAAM;IAIxB,qBAAqB,IAAI,MAAM;IAI/B,iBAAiB,IAAI,aAAa,EAAE;IAM9B,WAAW,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAerE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,yBAAyB,CAAC;IAC5E,gBAAgB,IAAI,MAAM;IAI1B,eAAe,IAAI,MAAM;IAIzB,SAAS,CAAC,WAAW,IAAI,OAAO;IAIhC,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,cAAc,IAAI,OAAO;IAI7B,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhF,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjF,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1F"}
+{"version":3,"file":"dataset-command.d.ts","sourceRoot":"","sources":["../../../src/main/typescript/commands/dataset-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIhE,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAEjE,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,yBAAyB,CAAC;IAC5E,cAAc,IAAI,MAAM;IAIxB,qBAAqB,IAAI,MAAM;IAI/B,iBAAiB,IAAI,aAAa,EAAE;IAM9B,WAAW,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAerE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,yBAAyB,CAAC;IAC5E,gBAAgB,IAAI,MAAM;IAI1B,eAAe,IAAI,MAAM;IAIzB,SAAS,CAAC,WAAW,IAAI,OAAO;IAIhC,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,GAAG,IAAI;IAmBtE,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxF,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhF,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjF,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1F"}

package/build/dist/commands/dataset-command.js

@@ -1,6 +1,6 @@
 import { ListCommand } from './list-command.js';
 import { CrudCommand } from './crud-command.js';
-import { logHumanFooter } from '../lib/output-format.js';
+import { logHumanFooter, parseFieldsArg, parseOutputFormat, resolveDefaultFormat } from '../lib/output-format.js';
 /**
  * Dataset list command implementation using the new architecture
  */
@@ -52,6 +52,39 @@ export class DatasetCrudCommand extends CrudCommand {
     supportsDelete() {
         return true;
     }
+    /**
+     * Registers the CRUD commands plus dataset:table-config, which shows what a dataset table indexes.
+     */
+    addToProgram(program, mergeConfiguration) {
+        super.addToProgram(program, mergeConfiguration);
+        program
+            .command('dataset:table-config <id>')
+            .description("Show a dataset table's indexed (promoted) tags and attributes and its partition keys")
+            .option('--table <key>', 'Table key: logs_raw or metricdata_raw', 'logs_raw')
+            .option('-f, --format <format>', 'Output format (table, csv, pretty, raw, compact)', parseOutputFormat, resolveDefaultFormat('pretty'))
+            .option('--fields <list>', 'Comma-separated field paths to keep (e.g. "promotedTags")', parseFieldsArg)
+            .action(async (datasetId, options, command) => {
+            try {
+                const mergedGlobalOptions = await mergeConfiguration(command.parent?.opts() || {});
+                await this.executeTableConfig(datasetId, { ...mergedGlobalOptions, ...options });
+            }
+            catch (error) {
+                console.error(`Error getting ${options.table} config for dataset ${datasetId}:`, error.message);
+                process.exit(1);
+            }
+        });
+    }
+    async executeTableConfig(datasetId, options) {
+        try {
+            this.apiClient = this.createApiClient(options);
+            const config = await this.apiClient.getDatasetTableConfig(datasetId, options.table);
+            await this.formatAndOutputSingle((config ?? {}), options);
+        }
+        catch (error) {
+            console.error(`Error getting ${options.table} config for dataset ${datasetId}:`, error.message);
+            process.exit(1);
+        }
+    }
     async executeGet(datasetId, options) {
         try {
             this.apiClient = this.createApiClient(options);

package/build/dist/commands/dataset-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataset-command.js","sourceRoot":"","sources":["../../../src/main/typescript/commands/dataset-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dataset-command.js","sourceRoot":"","sources":["../../../src/main/typescript/commands/dataset-command.ts"],"names":[],"mappings":"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"}

package/build/dist/docs-index/08167c7c-48b1-41df-9866-24e6a81ad581.txt

@@ -0,0 +1,11 @@
+# CancellableInvestigationsResponse
+
+**Type**: `object`
+
+## Properties
+
+- name: canCancel (required)
+  type: boolean
+
+- name: counts (required)
+  type: `CancellableInvestigationCounts`

package/build/dist/docs-index/2b87879e-8998-4647-82f5-8744348cf771.txt

@@ -0,0 +1,44 @@
+# Update Job Tags
+
+**PUT** `/v1/jobs/{id}/tags`
+
+**Operation ID**: `updateJobTags`
+**Summary**: Update Job Tags
+Replaces all tags on the job's latest version. This does not create a new version or restart the job. Tags can be changed only while the pipeline is running or stopped. A job can have at most 10 tags; keys can be at most 64 characters and values at most 256.
+
+## Tags
+- Jobs
+## Parameters
+
+- **id** (required) - path
+  - Id of the job
+  - Type: string
+
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: object
+
+## Responses
+
+### 200
+
+Tags updated
+
+- **Content-Type**: `application/json` / `ReadJob`
+### 400
+
+Bad Request
+
+### 401
+
+Unauthorized
+
+### 404
+
+Job not found.
+
+### 409
+
+The pipeline is not running or stopped.

package/build/dist/docs-index/2fd7c51d-d9a0-441e-ae63-a89dc41061f2.txt

@@ -0,0 +1,104 @@
+Use actions in a Grepr pipeline to drop or keep events by condition, drop late-arriving events, and process events with SQL.
+
+# Filter and transform events with actions
+
+You can use *actions* in a Grepr pipeline to decide what happens to log events at a specific point in the pipeline. With actions, you can:
+
+* Drop events, or keep only the events that match a condition.
+* Drop late-arriving events.
+* Process all or some events with SQL, and send the results to a later pipeline step.
+
+Conditions use familiar query syntaxes, such as the Datadog-like syntax or the New Relic log query-like syntax. To learn more about the supported query syntaxes, see [Query log data in Grepr](/queries).
+
+## Where actions run in a pipeline \[#locations]
+
+Actions are available at three locations in a pipeline. Each location is named for the pipeline step it runs before:
+
+| Location | Runs before | CLI phase |
+| --- | --- | --- |
+| **Pre-Parsing Actions** | Parsing | `pre-parser` |
+| **Pre-Warehouse Actions** | Masking and the Data Lake | `pre-warehouse` |
+| **Pre-Reducer Actions** | Exceptions and the Reducer | `pre-exceptions` |
+
+Choose the earliest location that has the fields you need. An event dropped at **Pre-Parsing Actions** isn't parsed, stored, or reduced. An event dropped at **Pre-Warehouse Actions** is parsed but isn't stored in the data lake. An event dropped at **Pre-Reducer Actions** is stored in the data lake but isn't reduced or sent to your sinks.
+
+> **Pre-Warehouse Actions** run before masking. Conditions and SQL at this location see the original values of any fields that your masking rules replace.
+
+## Add actions to a pipeline \[#add]
+
+1. In the Grepr UI, go to the details page for your pipeline.
+
+2. In the left pane, select **Pre-Parsing Actions**, **Pre-Warehouse Actions**, or **Pre-Reducer Actions**.
+
+3. Click **Add Action**, and then select one of the following:
+
+   * **Condition (If/Else)**: Sends events down different branches based on a query. See [Drop or keep events with conditions](#conditions).
+   * **SQL**: Processes events with SQL. See [Process events with SQL](#sql).
+   * **Drop late-arriving events**: Drops events that arrive too long after their timestamp. See [Drop late-arriving events](#late-data).
+
+4. To save the change to your pipeline, click **Apply Changes**.
+
+Before you apply a change, you can test it against live data with the Pipeline Log Viewer. See [Test pipeline changes with live edit](/tutorials/live-edit).
+
+## Drop or keep events with conditions \[#conditions]
+
+A condition sends each event down exactly one branch. The first branch whose query matches the event handles it, and an event that matches no query goes to the **ELSE** branch.
+
+* To add a condition, enter a query in the **IF** row.
+* To test events against more queries, add **ELSE IF** branches. Branches are checked from top to bottom, so you can reorder them to change which query handles an event first.
+* Each branch ends with either **Drop**, which removes the events from the pipeline, or the next pipeline step, which sends the events on. To change how a branch ends, click its ending and select the other option.
+* To process the events on one branch with SQL, insert a SQL action into that branch.
+
+For example, to drop debug events and keep everything else, add a condition with the query `status:debug`, end the **IF** branch with **Drop**, and end the **ELSE** branch with the next pipeline step.
+
+## Process events with SQL \[#sql]
+
+A SQL action processes events with ANSI standard SQL queries. Each SQL action contains one or more statements. Each statement has a name and a SQL query that reads input events from the `logs` table or from an earlier statement by its name.
+
+To send the results of a statement to a pipeline step, connect the statement to that step. Depending on the location of the action, you can send results to steps such as the parsers, the Data Lake, the Reducer, or the pipeline sinks. Statements that aren't connected to a step are available only to later statements.
+
+A SQL action doesn't remove events from the pipeline. Events continue to the rest of the branch, and the results of connected statements are sent to the connected steps in addition.
+
+> The results of a SQL statement contain only the fields you select. To keep all fields from the original event, include the wildcard character (`*`) in your `SELECT` statement. For example, to transform the severity while keeping all other fields: `SELECT *, CASE WHEN severity > 16 THEN 21 ELSE severity END as severity FROM logs`.
+
+To learn more about using SQL in Grepr pipelines, see [Transform events with SQL](/transforms/sql-transform).
+
+## Drop late-arriving events \[#late-data]
+
+You can drop events whose received time is later than their event timestamp by more than a maximum duration. Enter the maximum duration in the ISO-8601 format, such as `PT48H` for 48 hours. This is useful when timely data is critical, and late-arriving events could affect analysis or reporting.
+
+The late-data rule applies to every event at that location, before any condition is checked.
+
+## Frequently Asked Questions
+
+### What are actions in a Grepr pipeline?
+
+Actions decide what happens to log events at a specific point in a pipeline. You can use actions to drop events, keep only events that match a condition, drop late-arriving events, or process events with SQL and send the results to a later pipeline step.
+
+### Where are actions located in a Grepr pipeline?
+
+Actions are available at three locations, each named for the step it runs before: Pre-Parsing Actions run before parsing, Pre-Warehouse Actions run before masking and the data lake, and Pre-Reducer Actions run before exceptions and the reducer. In the Grepr CLI, these locations are the pre-parser, pre-warehouse, and pre-exceptions phases.
+
+### What happened to pipeline filters?
+
+The pipeline steps named Pre-parsing filter, Post-parsing filter, and Post-warehouse filter are named Pre-Parsing Actions, Pre-Warehouse Actions, and Pre-Reducer Actions. They run at the same locations in the pipeline.
+
+### How do I drop events I don't need?
+
+Add a Condition (If/Else) action with a query that matches the events to drop, end the IF branch with Drop, and end the ELSE branch with the next pipeline step.
+
+### How do I filter out late-arriving events?
+
+Add the Drop late-arriving events action and enter a maximum duration in the ISO-8601 format. Events whose received time is later than their timestamp by more than this duration are dropped.
+
+### What query languages does Grepr support for conditions?
+
+Conditions support multiple query syntaxes, including the Datadog-like syntax and the New Relic log query-like syntax. SQL actions use ANSI standard SQL.
+
+### Does a SQL action remove events from the pipeline?
+
+No. Events continue to the rest of the branch after a SQL action. The results of each SQL statement that you connect to a pipeline step are sent to that step in addition.
+
+### Can I route different event types to different pipeline paths?
+
+Yes. Use a condition with a branch for each event type, or add several SQL statements and connect each one to a different pipeline step.

package/build/dist/docs-index/{bdca4eae-c107-4bdd-be02-8b3453ef8dbb.txt → 31b24e80-81ae-4012-9858-c2482e5210aa.txt}

@@ -40,7 +40,7 @@ For a complete reference and examples, see [Transform events with SQL](/transfor
 
 The Filter transform includes or excludes data records based on specified conditions. You can create filters using familiar query interfaces, such as SQL, as well as Datadog and New Relic log query-like syntaxes.
 
-In the Grepr pipelines UI, filters are located in predefined locations in the pipeline. To learn how to configure filters, see [Filter events in a Grepr pipeline](/transforms/filter-events).
+In the Grepr pipelines UI, you filter records with actions, which are available at three locations in a pipeline. To learn how to configure actions, see [Filter and transform events with actions](/transforms/filter-events).
 
 To have more flexibility for where filters are included in a pipeline, use the REST API. See [LogsFilter](/apis/api-spec#schema/LogsFilter).
 

package/build/dist/docs-index/{aafb2fa1-4c59-45b1-9eb3-1d1988be90df.txt → 3388564d-5c1d-425d-8f18-9eeb7d343a9e.txt}

@@ -16,4 +16,4 @@
 
 - name: uploadId (required)
   type: string
-  description: Unique identifier for the upload. The full S3 path will be constructed as uploaded_files/{organizationId}/{uploadId} to ensure customers can only access their own uploads.
+  description: Unique identifier for the upload. The full S3 path will be constructed as uploaded_files/{organizationId}/{uploadId} to ensure customers can only access their own uploads. Use the uploadId returned by the file upload endpoint.

package/build/dist/docs-index/4965b2c4-12c9-4b91-876a-797e9078f065.txt

@@ -0,0 +1,26 @@
+# Cancel every active investigation in the organization
+
+**POST** `/v1/investigations/cancel-all`
+
+**Operation ID**: `cancelAllInvestigations`
+**Summary**: Cancel every active investigation in the organization
+Marks every queued, running, and paused investigation of every agent in the organization as CANCELLING in one request. Cancellation is completed asynchronously. With pause=true, every active agent is paused in the same transaction so none starts new investigations; resume each agent to undo it.
+
+## Tags
+- Investigations
+## Parameters
+
+- **pause** (optional) - query
+  - Also pause every active agent in the organization
+  - Type: boolean
+
+## Responses
+
+### 202
+
+Cancellation requests recorded
+
+- **Content-Type**: `application/json` / `CancelAllInvestigationsResponse`
+### 401
+
+Unauthorized

package/build/dist/docs-index/{973f9e26-c567-4c29-aa6d-00b9094b3f36.txt → 4d1254fe-fd6e-4044-a3e8-04f6519f94f5.txt}

@@ -115,8 +115,26 @@ For automation, and for MCP clients that are not in the table and do not support
 
 > The access token expires after 24 hours and has no refresh token, so your client cannot renew it automatically. When the token expires, obtain a new token and update your client configuration. For scheduled automation, obtain a new token at the start of each run.
 
+## Use Grepr skills through the MCP server \[#skills]
+
+The MCP server also provides *skills*: instructions that teach an AI assistant how to work with Grepr efficiently. The server lists each skill in the instructions it sends when your client connects, and serves each skill's files as MCP resources at `skill://<skill-name>/SKILL.md`. MCP clients that read resources, such as Claude Code, load a skill when your request matches it.
+
+The server provides the following skills:
+
+* `cli`: Installs, configures, and signs in to the Grepr CLI, and points to the other Grepr skills.
+* `query`: Queries logs and spans with the Grepr CLI, scoped so that each query reads as little data as possible.
+* `query-predicate`: Translates a request into a Grepr query predicate.
+* `recover-reduced-logs`: Explains the summary logs that Grepr sends to your observability vendor in place of repeated logs, and finds the original logs behind a summary in the Grepr data lake.
+* `backfill-logs`: Sends original logs from the Grepr data lake to your observability vendor.
+
+When your AI assistant can run shell commands, the skills use the Grepr CLI instead of the MCP tools, because the CLI writes results to a file and has no page limit. To install the CLI, see [Grepr CLI](/cli). The [coding assistant plugins](/cli#agent-skills) include these skills and the rest of the Grepr skills.
+
 ## Frequently Asked Questions
 
+### Does the Grepr MCP server provide skills?
+
+Yes. The server lists its skills in the instructions it sends when a client connects and serves each skill as an MCP resource at skill://\<skill-name>/SKILL.md. The skills cover setting up the Grepr CLI, querying logs and spans, building query predicates, recovering the original logs behind a Grepr summary, and backfilling logs to your observability vendor.
+
 ### What is the Grepr MCP server URL?
 
 The MCP endpoint is https\://app.grepr.ai/mcp for the US region and https\://app.euc1.grepr.ai/mcp for the EU region.

package/build/dist/docs-index/7345f329-0694-4ace-92f4-bc3b36203da8.txt

@@ -0,0 +1,14 @@
+# CancellableInvestigationCounts
+
+**Type**: `object`
+
+## Properties
+
+- name: paused (required)
+  type: integer
+
+- name: queued (required)
+  type: integer
+
+- name: running (required)
+  type: integer

package/build/dist/docs-index/7d707c92-8af0-4f31-8eea-8d23fb7e97e2.txt

@@ -0,0 +1,20 @@
+# Count the organization's active investigations
+
+**GET** `/v1/investigations/cancellable-counts`
+
+**Operation ID**: `countCancellableInvestigations`
+**Summary**: Count the organization's active investigations
+Returns how many investigations across every agent in the organization are queued, running, or paused, and so would be cancelled by cancel-all, and whether the caller is authorized to call cancel-all.
+
+## Tags
+- Investigations
+## Responses
+
+### 200
+
+Counts retrieved
+
+- **Content-Type**: `application/json` / `CancellableInvestigationsResponse`
+### 401
+
+Unauthorized

package/build/dist/docs-index/{cba010e4-419c-4d24-98e4-1318c5660467.txt → 80dbc183-95e4-43b9-a5e4-3ad93820b225.txt}

@@ -44,23 +44,25 @@ You can use a local file containing logs for testing instead of streaming live d
 > * This example uses the pipeline created in the [Build your first Grepr pipeline](/tutorials/first-pipeline) tutorial. If you want to follow the example, first complete that tutorial.
 > * Although this example uses Datadog, you can use the live edit feature with any Grepr-supported observability platform. For the complete list of supported observability vendors, see [Supported integrations](/integrations/support-matrix).
 
-In this example, you use the following steps to test a filter that removes any log messages received by your Grepr pipeline that are assigned the hostname `my-test-host-1`.
+In this example, you use the following steps to test an action that drops any log messages received by your Grepr pipeline that are assigned the hostname `my-test-host-1`.
 
 1. In the Grepr UI, go to the details page for your running pipeline.
-2. In the left pane, click **Pre-parsing filter** to open the filter configuration, and click **Add** next to **Filters**.
-3. Make sure **Query language** is set to **Datadog**, and enter the following expression in the **Query** field:
+2. In the left pane, click **Pre-Parsing Actions**, click **Add Action**, and select **Condition (If/Else)**.
+3. Make sure the query language is set to **Datadog**, and enter the following query in the **IF** row:
 
 ```bash
--host:my-test-host-1
+host:my-test-host-1
 ```
 
-1. *Do not* click **Apply Changes**. Before applying the changes to the production pipeline, use the live edit feature to test and validate the filter.
+1. End the **IF** branch with **Drop**, and leave the **ELSE** branch ending with the next pipeline step.
 
-2. In the lower right corner of the page, click the expand icon to open the **Pipeline Log Viewer** and click the play icon to create and start a temporary copy of your pipeline with the filter added.
+2. *Do not* click **Apply Changes**. Before applying the changes to the production pipeline, use the live edit feature to test and validate the action.
 
-3. In the **Pipeline Log Viewer** left table, click a log message from `my-test-host-1`. The log detail pane opens. Because the filter removes the log messages from the pipeline, only the **LEFT** table view is displayed.
+3. In the lower right corner of the page, click the expand icon to open the **Pipeline Log Viewer** and click the play icon to create and start a temporary copy of your pipeline with the action added.
 
-4. When you complete validation of your change, click **Apply Changes** to save the new configuration to the production pipeline.
+4. In the **Pipeline Log Viewer** left table, click a log message from `my-test-host-1`. The log detail pane opens. Because the action drops the log messages from the pipeline, only the **LEFT** table view is displayed.
+
+5. When you complete validation of your change, click **Apply Changes** to save the new configuration to the production pipeline.
 
 ## Use a local file for testing
 

package/build/dist/docs-index/{62266181-bcdb-433e-a9da-7a0934528709.txt → 8d68281a-4dcf-43e8-9322-64067c92209e.txt}

@@ -20,4 +20,4 @@ Presigned URL for uploading a file
 
 - name: uploadId (optional)
   type: string
-  description: Unique identifier for this upload
+  description: Unique identifier for this upload. Pass it as the uploadId of a grepr-uploaded-log-file-source to read the uploaded file.

package/build/dist/docs-index/{b1391a7b-6903-4e15-b4b0-162ac7669268.txt → c54007a7-be1e-4085-9e7f-6ae1c98d23db.txt}

@@ -211,7 +211,8 @@ The following skills run CLI commands to manage resources and retrieve data:
 * `dataset-commands`: Manages data lake datasets.
 * `integration-commands`: Views vendor and storage integrations.
 * `docs-commands`: Searches the Grepr documentation.
-* `query-logs`: Queries data from datasets with filters and time ranges.
+* `query`: Queries data from datasets with filters and time ranges, scoped so that each query reads as little data as possible.
+* `recover-reduced-logs`: Explains the summary logs that Grepr sends to your observability vendor in place of repeated logs, and finds the original logs behind a summary in the Grepr data lake.
 * `backfill-logs`: Creates a manual backfill job that forwards raw logs from the Grepr data lake to your observability vendors. See [Backfill logs from the data lake to your vendors](#backfill).
 
 The following skills guide multi-step pipeline workflows. Before changing a pipeline, these skills validate the change with a plan, a readable diff, and a draft run against your data, and apply the change only after you approve it:
@@ -437,7 +438,7 @@ The Grepr CLI includes commands to:
 * Run queries against data in the Grepr data lake: `query`.
 * Forward raw logs from the Grepr data lake to your observability vendors: `backfill`.
 * Manage vendor and storage integrations: `integration:list`, `integration:get`.
-* Manage datasets for log storage and querying: `dataset:create`, `dataset:list`, `dataset:get`, `dataset:update`, `dataset:delete`.
+* Manage datasets for log storage and querying: `dataset:create`, `dataset:list`, `dataset:get`, `dataset:table-config`, `dataset:update`, `dataset:delete`.
 * Search and retrieve Grepr documentation: `docs:search`, `docs:get`.
 * Test Grok rules: `grok:parse`.
 * Read AI agents and their investigations: `agent:list`, `agent:get`, `investigation:list`, `investigation:get`, `investigation:turns`, `investigation:transcript`, `investigation:memory:search`, `investigation:memory:get`.
@@ -539,6 +540,22 @@ grepr dataset:get <dataset-id> -o app-logs-dataset.json
 
 Replace `<dataset-id>` with the unique identifier for the dataset to retrieve. You can find the dataset ID in the output of the `dataset:list` command.
 
+### Show the fields a dataset indexes
+
+Queries that filter on a dataset's indexed tags and attributes, and on its partition fields, read less data and run faster. To list a dataset's partition fields, indexed tags, and indexed attributes, use the `dataset:table-config` command. An entry with `excluded` set to `true` is not indexed. See [Indexed columns](/grepr-platform/indexed-columns).
+
+```console
+# Show the indexing settings of a dataset's raw logs table
+grepr dataset:table-config <dataset-id>
+```
+
+```console
+# Show only the partition fields and indexed fields, as JSON
+grepr dataset:table-config <dataset-id> -f compact --fields effectiveSpec,promotedTags,promotedAttributes
+```
+
+The command reads the raw logs table by default. To read the metric data table instead, add `--table metricdata_raw`.
+
 ### Create a dataset
 
 To create a dataset, pass a file containing the dataset definition to the `dataset:create` command. Dataset definitions are JSON files that specify the required and optional fields for creating a new Grepr dataset. See the **Payload** example in the [Create a new dataset API specification](/apis/api-spec#tag/Datasets/operation/createDataset).