Get usage information
Get information about the features that are currently enabled and available under the current license. The API also provides some usage statistics.
Query parameters
-
master_timeout
string The period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. To indicate that the request should never timeout, set it to
-1
.
Responses
-
200 application/json
Hide response attributes Show response attributes object
-
aggregate_metric
object Required Additional properties are allowed.
-
analytics
object Additional properties are allowed.
Hide analytics attributes Show analytics attributes object
-
available
boolean Required -
enabled
boolean Required -
stats
object Required Additional properties are allowed.
Hide stats attributes Show stats attributes object
-
boxplot_usage
number Required -
cumulative_cardinality_usage
number Required -
string_stats_usage
number Required -
top_metrics_usage
number Required -
t_test_usage
number Required -
moving_percentiles_usage
number Required -
normalize_usage
number Required -
rate_usage
number Required -
multi_terms_usage
number
-
-
-
archive
object Additional properties are allowed.
Hide archive attributes Show archive attributes object
-
available
boolean Required -
enabled
boolean Required -
indices_count
number Required
-
-
watcher
object Additional properties are allowed.
Hide watcher attributes Show watcher attributes object
-
available
boolean Required -
enabled
boolean Required -
execution
object Required Additional properties are allowed.
Hide execution attribute Show execution attribute object
-
actions
object Required Hide actions attribute Show actions attribute object
-
*
object Additional properties Additional properties are allowed.
Hide * attributes Show * attributes object
-
total
string Required A duration. Units can be
nanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
-
-
-
-
watch
object Required Additional properties are allowed.
Hide watch attributes Show watch attributes object
-
count
object Required Additional properties Additional properties are allowed.
-
-
ccr
object Additional properties are allowed.
Hide ccr attributes Show ccr attributes object
-
available
boolean Required -
enabled
boolean Required -
auto_follow_patterns_count
number Required -
follower_indices_count
number Required
-
-
data_frame
object Additional properties are allowed.
-
data_science
object Additional properties are allowed.
-
data_streams
object Additional properties are allowed.
Hide data_streams attributes Show data_streams attributes object
-
available
boolean Required -
enabled
boolean Required -
data_streams
number Required -
indices_count
number Required
-
-
data_tiers
object Additional properties are allowed.
Hide data_tiers attributes Show data_tiers attributes object
-
available
boolean Required -
enabled
boolean Required -
data_warm
object Required Additional properties are allowed.
Hide data_warm attributes Show data_warm attributes object
-
node_count
number Required -
index_count
number Required -
total_shard_count
number Required -
primary_shard_count
number Required -
doc_count
number Required -
total_size_bytes
number Required -
primary_size_bytes
number Required -
primary_shard_size_avg_bytes
number Required -
primary_shard_size_median_bytes
number Required -
primary_shard_size_mad_bytes
number Required
-
-
data_frozen
object Additional properties are allowed.
Hide data_frozen attributes Show data_frozen attributes object
-
node_count
number Required -
index_count
number Required -
total_shard_count
number Required -
primary_shard_count
number Required -
doc_count
number Required -
total_size_bytes
number Required -
primary_size_bytes
number Required -
primary_shard_size_avg_bytes
number Required -
primary_shard_size_median_bytes
number Required -
primary_shard_size_mad_bytes
number Required
-
-
data_cold
object Required Additional properties are allowed.
Hide data_cold attributes Show data_cold attributes object
-
node_count
number Required -
index_count
number Required -
total_shard_count
number Required -
primary_shard_count
number Required -
doc_count
number Required -
total_size_bytes
number Required -
primary_size_bytes
number Required -
primary_shard_size_avg_bytes
number Required -
primary_shard_size_median_bytes
number Required -
primary_shard_size_mad_bytes
number Required
-
-
data_content
object Required Additional properties are allowed.
Hide data_content attributes Show data_content attributes object
-
node_count
number Required -
index_count
number Required -
total_shard_count
number Required -
primary_shard_count
number Required -
doc_count
number Required -
total_size_bytes
number Required -
primary_size_bytes
number Required -
primary_shard_size_avg_bytes
number Required -
primary_shard_size_median_bytes
number Required -
primary_shard_size_mad_bytes
number Required
-
-
data_hot
object Required Additional properties are allowed.
Hide data_hot attributes Show data_hot attributes object
-
node_count
number Required -
index_count
number Required -
total_shard_count
number Required -
primary_shard_count
number Required -
doc_count
number Required -
total_size_bytes
number Required -
primary_size_bytes
number Required -
primary_shard_size_avg_bytes
number Required -
primary_shard_size_median_bytes
number Required -
primary_shard_size_mad_bytes
number Required
-
-
-
enrich
object Additional properties are allowed.
-
eql
object Additional properties are allowed.
Hide eql attributes Show eql attributes object
-
available
boolean Required -
enabled
boolean Required -
features
object Required Additional properties are allowed.
Hide features attributes Show features attributes object
-
join
number Required -
joins
object Required Additional properties are allowed.
Hide joins attributes Show joins attributes object
-
join_queries_two
number Required -
join_queries_three
number Required -
join_until
number Required -
join_queries_five_or_more
number Required -
join_queries_four
number Required
-
-
keys
object Required Additional properties are allowed.
Hide keys attributes Show keys attributes object
-
join_keys_two
number Required -
join_keys_one
number Required -
join_keys_three
number Required -
join_keys_five_or_more
number Required -
join_keys_four
number Required
-
-
event
number Required -
pipes
object Required Additional properties are allowed.
-
sequence
number Required -
sequences
object Required Additional properties are allowed.
Hide sequences attributes Show sequences attributes object
-
sequence_queries_three
number Required -
sequence_queries_four
number Required -
sequence_queries_two
number Required -
sequence_until
number Required -
sequence_queries_five_or_more
number Required -
sequence_maxspan
number Required
-
-
-
queries
object Required
-
-
flattened
object Additional properties are allowed.
Hide flattened attributes Show flattened attributes object
-
available
boolean Required -
enabled
boolean Required -
field_count
number Required
-
-
frozen_indices
object Additional properties are allowed.
Hide frozen_indices attributes Show frozen_indices attributes object
-
available
boolean Required -
enabled
boolean Required -
indices_count
number Required
-
-
graph
object Required Additional properties are allowed.
-
health_api
object Additional properties are allowed.
Hide health_api attributes Show health_api attributes object
-
available
boolean Required -
enabled
boolean Required -
invocations
object Required Additional properties are allowed.
Hide invocations attribute Show invocations attribute object
-
total
number Required
-
-
-
ilm
object Required Additional properties are allowed.
Hide ilm attributes Show ilm attributes object
-
policy_count
number Required -
policy_stats
array[object] Required Hide policy_stats attributes Show policy_stats attributes object
-
indices_managed
number Required -
phases
object Required Additional properties are allowed.
Hide phases attributes Show phases attributes object
-
-
-
logstash
object Required Additional properties are allowed.
-
ml
object Additional properties are allowed.
Hide ml attributes Show ml attributes object
-
available
boolean Required -
enabled
boolean Required -
datafeeds
object Required -
jobs
object Required Job usage statistics. The
_all
entry is always present and gathers statistics for all jobs.Hide jobs attribute Show jobs attribute object
-
*
object Additional properties Additional properties are allowed.
Hide * attributes Show * attributes object
-
count
number Required -
created_by
object Required Hide created_by attribute Show created_by attribute object
-
*
number Additional properties
-
-
detectors
object Required Additional properties are allowed.
-
forecasts
object Required Additional properties are allowed.
Hide forecasts attributes Show forecasts attributes object
-
total
number Required -
forecasted_jobs
number Required
-
-
model_size
object Required Additional properties are allowed.
-
-
-
node_count
number Required -
data_frame_analytics_jobs
object Required Additional properties are allowed.
Hide data_frame_analytics_jobs attributes Show data_frame_analytics_jobs attributes object
-
memory_usage
object Additional properties are allowed.
Hide memory_usage attribute Show memory_usage attribute object
-
peak_usage_bytes
object Required Additional properties are allowed.
-
-
_all
object Required Additional properties are allowed.
Hide _all attribute Show _all attribute object
-
count
number Required
-
-
analysis_counts
object Additional properties are allowed.
Hide analysis_counts attributes Show analysis_counts attributes object
-
classification
number -
outlier_detection
number -
regression
number
-
-
stopped
object Additional properties are allowed.
Hide stopped attribute Show stopped attribute object
-
count
number Required
-
-
-
inference
object Required Additional properties are allowed.
Hide inference attributes Show inference attributes object
-
ingest_processors
object Required Hide ingest_processors attribute Show ingest_processors attribute object
-
*
object Additional properties Additional properties are allowed.
Hide * attributes Show * attributes object
-
num_docs_processed
object Required Additional properties are allowed.
-
pipelines
object Required Additional properties are allowed.
-
num_failures
object Required Additional properties are allowed.
-
time_ms
object Required Additional properties are allowed.
-
-
-
trained_models
object Required Additional properties are allowed.
Hide trained_models attributes Show trained_models attributes object
-
estimated_operations
object Additional properties are allowed.
-
Additional properties are allowed.
-
count
object Additional properties are allowed.
Hide count attributes Show count attributes object
-
total
number Required -
prepackaged
number Required -
other
number Required -
pass_through
number -
regression
number -
classification
number -
ner
number -
text_embedding
number
-
-
_all
object Required Additional properties are allowed.
Hide _all attribute Show _all attribute object
-
count
number Required
-
-
model_size_bytes
object Additional properties are allowed.
-
-
deployments
object Additional properties are allowed.
Hide deployments attributes Show deployments attributes object
-
count
number Required -
inference_counts
object Required Additional properties are allowed.
-
model_sizes_bytes
object Required Additional properties are allowed.
-
time_ms
object Required Additional properties are allowed.
Hide time_ms attribute Show time_ms attribute object
-
avg
number Required
-
-
-
-
-
monitoring
object Additional properties are allowed.
Hide monitoring attributes Show monitoring attributes object
-
available
boolean Required -
enabled
boolean Required -
collection_enabled
boolean Required -
enabled_exporters
object Required Hide enabled_exporters attribute Show enabled_exporters attribute object
-
*
number Additional properties
-
-
-
rollup
object Required Additional properties are allowed.
-
runtime_fields
object Additional properties are allowed.
Hide runtime_fields attributes Show runtime_fields attributes object
-
available
boolean Required -
enabled
boolean Required -
field_types
array[object] Required Hide field_types attributes Show field_types attributes object
-
chars_max
number Required -
chars_total
number Required -
count
number Required -
doc_max
number Required -
doc_total
number Required -
index_count
number Required -
lang
array[string] Required -
lines_max
number Required -
lines_total
number Required -
name
string Required Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
scriptless_count
number Required -
shadowed_count
number Required -
source_max
number Required -
source_total
number Required
-
-
-
spatial
object Required Additional properties are allowed.
-
searchable_snapshots
object Additional properties are allowed.
Hide searchable_snapshots attributes Show searchable_snapshots attributes object
-
available
boolean Required -
enabled
boolean Required -
indices_count
number Required -
full_copy_indices_count
number -
shared_cache_indices_count
number
-
-
security
object Additional properties are allowed.
Hide security attributes Show security attributes object
-
available
boolean Required -
enabled
boolean Required -
api_key_service
object Required Additional properties are allowed.
Hide api_key_service attribute Show api_key_service attribute object
-
enabled
boolean Required
-
-
anonymous
object Required Additional properties are allowed.
Hide anonymous attribute Show anonymous attribute object
-
enabled
boolean Required
-
-
audit
object Additional properties are allowed.
-
fips_140
object Required Additional properties are allowed.
Hide fips_140 attribute Show fips_140 attribute object
-
enabled
boolean Required
-
-
ipfilter
object Required Additional properties are allowed.
-
realms
object Required -
role_mapping
object Required -
roles
object Required Additional properties are allowed.
Hide roles attributes Show roles attributes object
-
native
object Required Additional properties are allowed.
-
dls
object Required Additional properties are allowed.
Hide dls attribute Show dls attribute object
-
bit_set_cache
object Required Additional properties are allowed.
Hide bit_set_cache attributes Show bit_set_cache attributes object
-
count
number Required -
memory_in_bytes
number Required
-
-
-
file
object Required Additional properties are allowed.
-
-
ssl
object Required Additional properties are allowed.
Hide ssl attributes Show ssl attributes object
-
system_key
object Additional properties are allowed.
Hide system_key attribute Show system_key attribute object
-
enabled
boolean Required
-
-
token_service
object Required Additional properties are allowed.
Hide token_service attribute Show token_service attribute object
-
enabled
boolean Required
-
-
operator_privileges
object Required Additional properties are allowed.
-
-
slm
object Additional properties are allowed.
Hide slm attributes Show slm attributes object
-
available
boolean Required -
enabled
boolean Required -
policy_count
number -
policy_stats
object Additional properties are allowed.
Hide policy_stats attributes Show policy_stats attributes object
-
retention_deletion_time
string A duration. Units can be
nanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value. -
Time unit for milliseconds
-
retention_failed
number -
retention_runs
number -
retention_timed_out
number -
policy
string -
total_snapshots_deleted
number -
total_snapshots_failed
number -
total_snapshots_taken
number
-
-
-
sql
object Additional properties are allowed.
Hide sql attributes Show sql attributes object
-
transform
object Required Additional properties are allowed.
-
vectors
object Additional properties are allowed.
Hide vectors attributes Show vectors attributes object
-
available
boolean Required -
enabled
boolean Required -
dense_vector_dims_avg_count
number Required -
dense_vector_fields_count
number Required -
sparse_vector_fields_count
number
-
-
voting_only
object Required Additional properties are allowed.
-
curl \
--request GET http://api.example.com/_xpack/usage \
--header "Authorization: $API_KEY"
{
"aggregate_metric": {
"available": true,
"enabled": true
},
"": {
"available": true,
"enabled": true,
"dense_vector_dims_avg_count": 42.0,
"dense_vector_fields_count": 42.0,
"sparse_vector_fields_count": 42.0
},
"data_frame": {
"available": true,
"enabled": true
},
"data_science": {
"available": true,
"enabled": true
},
"enrich": {
"available": true,
"enabled": true
},
"graph": {
"available": true,
"enabled": true
},
"ilm": {
"policy_count": 42.0,
"policy_stats": [
{
"indices_managed": 42.0,
"phases": {
"cold": {
"actions": [
"string"
]
},
"delete": {
"actions": [
"string"
]
},
"frozen": {
"actions": [
"string"
]
},
"hot": {
"actions": [
"string"
]
},
"warm": {
"actions": [
"string"
]
}
}
}
]
},
"logstash": {
"available": true,
"enabled": true
},
"rollup": {
"available": true,
"enabled": true
},
"spatial": {
"available": true,
"enabled": true
},
"transform": {
"available": true,
"enabled": true
},
"voting_only": {
"available": true,
"enabled": true
}
}