使用 API
编辑使用 API
编辑提供有关已安装 X-Pack 功能的使用信息。
请求
编辑GET /_xpack/usage
前提条件
编辑- 如果启用了 Elasticsearch 安全功能,您必须拥有
monitor
或manage
集群权限才能使用此 API。
描述
编辑此 API 提供有关当前许可证下哪些功能已启用和可用的信息以及一些使用统计信息。
查询参数
编辑-
master_timeout
- (可选,时间单位)等待主节点的时间。如果在超时到期之前主节点不可用,则请求失败并返回错误。默认为
30s
。也可以设置为-1
表示请求永远不应超时。
示例
编辑resp = client.xpack.usage() print(resp)
response = client.xpack.usage puts response
const response = await client.xpack.usage(); console.log(response);
GET /_xpack/usage
{ "security" : { "available" : true, "enabled" : true, ... }, "monitoring" : { "available" : true, "enabled" : true, "collection_enabled" : false, "enabled_exporters" : { "local" : 1 } }, "watcher" : { "available" : true, "enabled" : true, "execution" : { "actions" : { "_all" : { "total" : 0, "total_time_in_ms" : 0 } } }, "watch" : { "input" : { "_all" : { "total" : 0, "active" : 0 } }, "trigger" : { "_all" : { "total" : 0, "active" : 0 } } }, "count" : { "total" : 0, "active" : 0 } }, "graph" : { "available" : true, "enabled" : true }, "ml" : { "available" : true, "enabled" : true, "jobs" : { "_all" : { "count" : 0, "detectors" : { ... }, "created_by" : { }, "model_size" : { ... }, "forecasts" : { "total" : 0, "forecasted_jobs" : 0 } } }, "datafeeds" : { "_all" : { "count" : 0 } }, "data_frame_analytics_jobs" : { "_all" : { "count" : 0 }, "analysis_counts": { }, "memory_usage": { "peak_usage_bytes": { "min": 0.0, "max": 0.0, "avg": 0.0, "total": 0.0 } } }, "inference" : { "ingest_processors" : { "_all" : { "num_docs_processed" : { "max" : 0, "sum" : 0, "min" : 0 }, "pipelines" : { "count" : 0 }, "num_failures" : { "max" : 0, "sum" : 0, "min" : 0 }, "time_ms" : { "max" : 0, "sum" : 0, "min" : 0 } } }, "trained_models" : { "_all" : { "count": 1 }, "count": { "total": 1, "prepackaged": 1, "other": 0 }, "model_size_bytes": { "min": 0.0, "max": 0.0, "avg": 0.0, "total": 0.0 }, "estimated_operations": { "min": 0.0, "max": 0.0, "avg": 0.0, "total": 0.0 } }, "deployments": { "count": 0, "inference_counts": { "total": 0.0, "min": 0.0, "avg": 0.0, "max": 0.0 }, "stats_by_model": [], "model_sizes_bytes": { "total": 0.0, "min": 0.0, "avg": 0.0, "max": 0.0 }, "time_ms": { "avg": 0.0 } } }, "node_count" : 1, "memory": { anomaly_detectors_memory_bytes: 0, data_frame_analytics_memory_bytes: 0, pytorch_inference_memory_bytes: 0, total_used_memory_bytes: 0 } }, "inference": { "available" : true, "enabled" : true, "models" : [{ "service": "elasticsearch", "task_type": "SPARSE_EMBEDDING", "count": 1 }, { "service": "elasticsearch", "task_type": "TEXT_EMBEDDING", "count": 1 }, ] }, "logstash" : { "available" : true, "enabled" : true }, "eql" : { "available" : true, "enabled" : true }, "esql" : { "available" : true, "enabled" : true, "features" : { "eval" : 0, "stats" : 0, "dissect": 0, "grok" : 0, "limit" : 0, "where" : 0, "sort" : 0, "drop" : 0, "show" : 0, "rename" : 0, "mv_expand" : 0, "keep" : 0, "enrich" : 0, "from" : 0, "row" : 0 }, "queries" : { "rest" : { "total" : 0, "failed" : 0 }, "kibana" : { "total" : 0, "failed" : 0 }, "_all" : { "total" : 0, "failed" : 0 } } }, "sql" : { "available" : true, "enabled" : true, "features" : { "having" : 0, "subselect" : 0, "limit" : 0, "orderby" : 0, "where" : 0, "join" : 0, "groupby" : 0, "command" : 0, "local" : 0 }, "queries" : { "rest" : { "total" : 0, "paging" : 0, "failed" : 0 }, "cli" : { "total" : 0, "paging" : 0, "failed" : 0 }, "canvas" : { "total" : 0, "paging" : 0, "failed" : 0 }, "odbc" : { "total" : 0, "paging" : 0, "failed" : 0 }, "jdbc" : { "total" : 0, "paging" : 0, "failed" : 0 }, "odbc32" : { "total" : 0, "paging" : 0, "failed" : 0 }, "odbc64" : { "total" : 0, "paging" : 0, "failed" : 0 }, "_all" : { "total" : 0, "paging" : 0, "failed" : 0 }, "translate" : { "count" : 0 } } }, "rollup" : { "available" : true, "enabled" : true, ... }, "ilm" : { "policy_count" : 3, "policy_stats" : [ ... ] }, "slm" : { "available" : true, "enabled" : true }, "ccr" : { "available" : true, "enabled" : true, "follower_indices_count" : 0, "auto_follow_patterns_count" : 0 }, "transform" : { "available" : true, "enabled" : true }, "voting_only" : { "available" : true, "enabled" : true }, "searchable_snapshots" : { "available" : true, "enabled" : true, "indices_count" : 0, "full_copy_indices_count" : 0, "shared_cache_indices_count" : 0 }, "frozen_indices" : { "available" : true, "enabled" : true, "indices_count" : 0 }, "spatial" : { "available" : true, "enabled" : true }, "analytics" : { "available" : true, "enabled" : true, "stats": { "boxplot_usage" : 0, "top_metrics_usage" : 0, "normalize_usage" : 0, "cumulative_cardinality_usage" : 0, "t_test_usage" : 0, "rate_usage" : 0, "string_stats_usage" : 0, "moving_percentiles_usage" : 0, "multi_terms_usage" : 0 } }, "data_streams" : { "available" : true, "enabled" : true, "data_streams" : 0, "indices_count" : 0 }, "data_lifecycle" : { "available": true, "enabled": true, "count": 0, "default_rollover_used": true, "data_retention": { "configured_data_streams": 0 }, "effective_retention": { "retained_data_streams": 0 }, "global_retention": { "default": { "defined": false }, "max": { "defined": false } } }, "data_tiers" : { "available" : true, "enabled" : true, "data_warm" : { "node_count" : 0, "index_count" : 0, "total_shard_count" : 0, "primary_shard_count" : 0, "doc_count" : 0, "total_size_bytes" : 0, "primary_size_bytes" : 0, "primary_shard_size_avg_bytes" : 0, "primary_shard_size_median_bytes" : 0, "primary_shard_size_mad_bytes" : 0 }, "data_frozen" : { "node_count" : 1, "index_count" : 0, "total_shard_count" : 0, "primary_shard_count" : 0, "doc_count" : 0, "total_size_bytes" : 0, "primary_size_bytes" : 0, "primary_shard_size_avg_bytes" : 0, "primary_shard_size_median_bytes" : 0, "primary_shard_size_mad_bytes" : 0 }, "data_cold" : { "node_count" : 0, "index_count" : 0, "total_shard_count" : 0, "primary_shard_count" : 0, "doc_count" : 0, "total_size_bytes" : 0, "primary_size_bytes" : 0, "primary_shard_size_avg_bytes" : 0, "primary_shard_size_median_bytes" : 0, "primary_shard_size_mad_bytes" : 0 }, "data_content" : { "node_count" : 0, "index_count" : 0, "total_shard_count" : 0, "primary_shard_count" : 0, "doc_count" : 0, "total_size_bytes" : 0, "primary_size_bytes" : 0, "primary_shard_size_avg_bytes" : 0, "primary_shard_size_median_bytes" : 0, "primary_shard_size_mad_bytes" : 0 }, "data_hot" : { "node_count" : 0, "index_count" : 0, "total_shard_count" : 0, "primary_shard_count" : 0, "doc_count" : 0, "total_size_bytes" : 0, "primary_size_bytes" : 0, "primary_shard_size_avg_bytes" : 0, "primary_shard_size_median_bytes" : 0, "primary_shard_size_mad_bytes" : 0 } }, "aggregate_metric" : { "available" : true, "enabled" : true }, "archive" : { "available" : true, "enabled" : true, "indices_count" : 0 }, "health_api" : { "available" : true, "enabled" : true, "invocations": { "total": 0 } }, "remote_clusters": { "size": 0, "mode": { "proxy": 0, "sniff": 0 }, "security": { "cert": 0, "api_key": 0 } }, "enterprise_search" : { "available": true, "enabled": true, "search_applications" : { "count": 0 }, "analytics_collections": { "count": 0 }, "query_rulesets": { "total_rule_count": 0, "total_count": 0, "min_rule_count": 0, "max_rule_count": 0 } }, "universal_profiling" : { "available" : true, "enabled" : true }, "logsdb": { "available": true, "enabled": false, "indices_count": 0, "indices_with_synthetic_source": 0 } }