KVStore Split, Partition, and Reflection Report API

Dremio 15.0.0 provides a KVStore report API that returns files that help Support determine if individual stores contain incorrect entries. Support may ask these files when you request assistance.

Syntax

GET /apiv2/kvstore/report

If no query parameter is specified, Dremio returns analysis on six KVStores, KVStore statistics, and configuration of data sources.

GET /apiv2/kvstore/report?store=<store>

The store query parameter may be one or more of the following:

  • none
  • metadata-multi-splits
  • metadata-dataset-splits
  • dac-namespace
  • materialization-store
  • reflection-goals
  • reflection-entries

If none is passed to the store parameter, Dremio returns only KVStore statistics and configuration of data sources.

Example Request and Response

The following example returns analysis on six KVStores and configuration of data sources.

curl -X GET "http://{DREMIO-HOST}:9047/apiv2/kvstore/report" -H "Authorization:_dremio{AUTH-TOKEN}" --output kvstore-report-0.zip  -H "Accept:octet-stream"
 % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  5486    0  5486    0     0   198k      0 --:--:-- --:--:-- --:--:--  198k

Dremio places the following files in kvstore-report-0.zip in the current directory:

  • dac-namespace.csv
  • kvstores_stats.log
  • materialization-store.csv
  • metadata-dataset-splits.csv
  • metadata-multi-splits.csv
  • reflection-entries.csv
  • reflection-goals.csv
  • sources.json

Example Request and Response

The following example returns information about metadata multi-splits.

 curl -X GET "http://{DREMIO-HOST}:9047/apiv2/kvstore/report?store=metadata-multi-splits" -H "Authorization:_dremio{AUTH-TOKEN}" --output kvstore-report-0.zip  -H "Accept:octet-stream"
 % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  1638    0  1638    0     0   145k      0 --:--:-- --:--:-- --:--:--  145k

Dremio places the following files in kvstore-report-0.zip in the current directory:

  • kvstores_stats.log
  • metadata-multi-splits.csv
  • sources.json