174 lines
12 KiB
Markdown
174 lines
12 KiB
Markdown
|
# Aerospike Input Plugin
|
||
|
|
|
||
|
|
This plugin queries [Aerospike][aerospike] server(s) for node statistics and
|
||
|
|
statistics on all configured namespaces.
|
||
|
|
|
||
|
|
> [!CAUTION]
|
||
|
|
> As of version 1.30 the Aerospike plugin has been deprecated in favor of the
|
||
|
|
> [prometheus plugin](/plugins/inputs/prometheus/README.md) and the officially
|
||
|
|
> supported [Aerospike Prometheus Exporter][prometheus_exporter]
|
||
|
|
|
||
|
|
For details on the measurements mean, please consult the
|
||
|
|
[Aerospike Metrics Reference Docs][ref_manual].
|
||
|
|
|
||
|
|
> [!NOTE]
|
||
|
|
> Metric names will have dashes (`-`) replaced as underscores (`_`) to make
|
||
|
|
> querying more consistently and easy.
|
||
|
|
|
||
|
|
All metrics are attempted to be cast to integers, then booleans, then strings
|
||
|
|
in order.
|
||
|
|
|
||
|
|
⭐ Telegraf v0.2.0
|
||
|
|
🚩 Telegraf v1.30.0
|
||
|
|
🔥 Telegraf v1.40.0
|
||
|
|
🏷️ server
|
||
|
|
💻 all
|
||
|
|
|
||
|
|
[aerospike]: https://www.aerospike.com
|
||
|
|
[prometheus_exporter]: https://aerospike.com/docs/monitorstack/configure/configure-exporter
|
||
|
|
[ref_manual]: https://www.aerospike.com/docs/reference/metrics
|
||
|
|
|
||
|
|
## Global configuration options <!-- @/docs/includes/plugin_config.md -->
|
||
|
|
|
||
|
|
In addition to the plugin-specific configuration settings, plugins support
|
||
|
|
additional global and plugin configuration settings. These settings are used to
|
||
|
|
modify metrics, tags, and field or create aliases and configure ordering, etc.
|
||
|
|
See the [CONFIGURATION.md][CONFIGURATION.md] for more details.
|
||
|
|
|
||
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
```toml @sample.conf
|
||
|
|
# Read stats from aerospike server(s)
|
||
|
|
[[inputs.aerospike]]
|
||
|
|
## Aerospike servers to connect to (with port)
|
||
|
|
## This plugin will query all namespaces the aerospike
|
||
|
|
## server has configured and get stats for them.
|
||
|
|
servers = ["localhost:3000"]
|
||
|
|
|
||
|
|
# username = "telegraf"
|
||
|
|
# password = "pa$$word"
|
||
|
|
|
||
|
|
## Optional TLS Config
|
||
|
|
# enable_tls = false
|
||
|
|
# tls_ca = "/etc/telegraf/ca.pem"
|
||
|
|
# tls_cert = "/etc/telegraf/cert.pem"
|
||
|
|
# tls_key = "/etc/telegraf/key.pem"
|
||
|
|
# tls_name = "tlsname"
|
||
|
|
## If false, skip chain & host verification
|
||
|
|
# insecure_skip_verify = true
|
||
|
|
|
||
|
|
# Feature Options
|
||
|
|
# Add namespace variable to limit the namespaces executed on
|
||
|
|
# Leave blank to do all
|
||
|
|
# disable_query_namespaces = true # default false
|
||
|
|
# namespaces = ["namespace1", "namespace2"]
|
||
|
|
|
||
|
|
# Enable set level telemetry
|
||
|
|
# query_sets = true # default: false
|
||
|
|
# Add namespace set combinations to limit sets executed on
|
||
|
|
# Leave blank to do all sets
|
||
|
|
# sets = ["namespace1/set1", "namespace1/set2", "namespace3"]
|
||
|
|
|
||
|
|
# Histograms
|
||
|
|
# enable_ttl_histogram = true # default: false
|
||
|
|
# enable_object_size_linear_histogram = true # default: false
|
||
|
|
|
||
|
|
# by default, aerospike produces a 100 bucket histogram
|
||
|
|
# this is not great for most graphing tools, this will allow
|
||
|
|
# the ability to squash this to a smaller number of buckets
|
||
|
|
# To have a balanced histogram, the number of buckets chosen
|
||
|
|
# should divide evenly into 100.
|
||
|
|
# num_histogram_buckets = 100 # default: 10
|
||
|
|
```
|
||
|
|
|
||
|
|
## Metrics
|
||
|
|
|
||
|
|
The aerospike metrics are under a few measurement names:
|
||
|
|
|
||
|
|
***aerospike_node***: These are the aerospike **node** measurements, which are
|
||
|
|
available from the aerospike `statistics` command.
|
||
|
|
|
||
|
|
```text
|
||
|
|
telnet localhost 3003
|
||
|
|
statistics
|
||
|
|
...
|
||
|
|
```
|
||
|
|
|
||
|
|
***aerospike_namespace***: These are aerospike namespace measurements, which
|
||
|
|
are available from the aerospike `namespace/<namespace_name>` command.
|
||
|
|
|
||
|
|
```text
|
||
|
|
telnet localhost 3003
|
||
|
|
namespaces
|
||
|
|
<namespace_1>;<namespace_2>;etc.
|
||
|
|
namespace/<namespace_name>
|
||
|
|
...
|
||
|
|
```
|
||
|
|
|
||
|
|
***aerospike_set***: These are aerospike set measurements, which
|
||
|
|
are available from the aerospike `sets/<namespace_name>/<set_name>` command.
|
||
|
|
|
||
|
|
```text
|
||
|
|
telnet localhost 3003
|
||
|
|
sets
|
||
|
|
sets/<namespace_name>
|
||
|
|
sets/<namespace_name>/<set_name>
|
||
|
|
...
|
||
|
|
```
|
||
|
|
|
||
|
|
***aerospike_histogram_ttl***: These are aerospike ttl hisogram measurements,
|
||
|
|
which is available from the aerospike
|
||
|
|
`histogram:namespace=<namespace_name>;[set=<set_name>;]type=ttl` command.
|
||
|
|
|
||
|
|
```text
|
||
|
|
telnet localhost 3003
|
||
|
|
histogram:namespace=<namespace_name>;type=ttl
|
||
|
|
histogram:namespace=<namespace_name>;[set=<set_name>;]type=ttl
|
||
|
|
...
|
||
|
|
```
|
||
|
|
|
||
|
|
***aerospike_histogram_object_size_linear***: These are aerospike object size
|
||
|
|
linear histogram measurements, which is available from the aerospike
|
||
|
|
`histogram:namespace=<namespace_name>;[set=<set_name>;]type=object_size_linear`
|
||
|
|
command.
|
||
|
|
|
||
|
|
```text
|
||
|
|
telnet localhost 3003
|
||
|
|
histogram:namespace=<namespace_name>;type=object_size_linear
|
||
|
|
histogram:namespace=<namespace_name>;[set=<set_name>;]type=object_size_linear
|
||
|
|
...
|
||
|
|
```
|
||
|
|
|
||
|
|
### Tags
|
||
|
|
|
||
|
|
All measurements have tags:
|
||
|
|
|
||
|
|
- aerospike_host
|
||
|
|
- node_name
|
||
|
|
|
||
|
|
Namespace metrics have tags:
|
||
|
|
|
||
|
|
- namespace_name
|
||
|
|
|
||
|
|
Set metrics have tags:
|
||
|
|
|
||
|
|
- namespace_name
|
||
|
|
- set_name
|
||
|
|
|
||
|
|
Histogram metrics have tags:
|
||
|
|
|
||
|
|
- namespace_name
|
||
|
|
- set_name (optional)
|
||
|
|
- type
|
||
|
|
|
||
|
|
## Example Output
|
||
|
|
|
||
|
|
```text
|
||
|
|
aerospike_node,aerospike_host=localhost:3000,node_name="BB9020011AC4202" batch_error=0i,batch_index_complete=0i,batch_index_created_buffers=0i,batch_index_destroyed_buffers=0i,batch_index_error=0i,batch_index_huge_buffers=0i,batch_index_initiate=0i,batch_index_queue="0:0,0:0,0:0,0:0",batch_index_timeout=0i,batch_index_unused_buffers=0i,batch_initiate=0i,batch_queue=0i,batch_timeout=0i,client_connections=6i,cluster_integrity=true,cluster_key="8AF422E05281249E",cluster_size=1i,delete_queue=0i,demarshal_error=0i,early_tsvc_batch_sub_error=0i,early_tsvc_client_error=0i,early_tsvc_udf_sub_error=0i,fabric_connections=16i,fabric_msgs_rcvd=0i,fabric_msgs_sent=0i,heartbeat_connections=0i,heartbeat_received_foreign=0i,heartbeat_received_self=0i,info_complete=47i,info_queue=0i,migrate_allowed=true,migrate_partitions_remaining=0i,migrate_progress_recv=0i,migrate_progress_send=0i,objects=0i,paxos_principal="BB9020011AC4202",proxy_in_progress=0i,proxy_retry=0i,query_long_running=0i,query_short_running=0i,reaped_fds=0i,record_refs=0i,rw_in_progress=0i,scans_active=0i,sindex_gc_activity_dur=0i,sindex_gc_garbage_cleaned=0i,sindex_gc_garbage_found=0i,sindex_gc_inactivity_dur=0i,sindex_gc_list_creation_time=0i,sindex_gc_list_deletion_time=0i,sindex_gc_locktimedout=0i,sindex_gc_objects_validated=0i,sindex_ucgarbage_found=0i,sub_objects=0i,system_free_mem_pct=92i,system_swapping=false,tsvc_queue=0i,uptime=1457i 1468923222000000000
|
||
|
|
aerospike_namespace,aerospike_host=localhost:3000,namespace=test,node_name="BB9020011AC4202" allow_nonxdr_writes=true,allow_xdr_writes=true,available_bin_names=32768i,batch_sub_proxy_complete=0i,batch_sub_proxy_error=0i,batch_sub_proxy_timeout=0i,batch_sub_read_error=0i,batch_sub_read_not_found=0i,batch_sub_read_success=0i,batch_sub_read_timeout=0i,batch_sub_tsvc_error=0i,batch_sub_tsvc_timeout=0i,client_delete_error=0i,client_delete_not_found=0i,client_delete_success=0i,client_delete_timeout=0i,client_lang_delete_success=0i,client_lang_error=0i,client_lang_read_success=0i,client_lang_write_success=0i,client_proxy_complete=0i,client_proxy_error=0i,client_proxy_timeout=0i,client_read_error=0i,client_read_not_found=0i,client_read_success=0i,client_read_timeout=0i,client_tsvc_error=0i,client_tsvc_timeout=0i,client_udf_complete=0i,client_udf_error=0i,client_udf_timeout=0i,client_write_error=0i,client_write_success=0i,client_write_timeout=0i,cold_start_evict_ttl=4294967295i,conflict_resolution_policy="generation",current_time=206619222i,data_in_index=false,default_ttl=432000i,device_available_pct=99i,device_free_pct=100i,device_total_bytes=4294967296i,device_used_bytes=0i,disallow_null_setname=false,enable_benchmarks_batch_sub=false,enable_benchmarks_read=false,enable_benchmarks_storage=false,enable_benchmarks_udf=false,enable_benchmarks_udf_sub=false,enable_benchmarks_write=false,enable_hist_proxy=false,enable_xdr=false,evict_hist_buckets=10000i,evict_tenths_pct=5i,evict_ttl=0i,evicted_objects=0i,expired_objects=0i,fail_generation=0i,fail_key_busy=0i,fail_record_too_big=0i,fail_xdr_forbidden=0i,geo2dsphere_within.earth_radius_meters=6371000i,geo2dsphere_within.level_mod=1i,geo2dsphere_within.max_cells=12i,geo2dsphere_within.max_level=30i,geo2dsphere_within.min_level=1i,geo2dsphere_within.strict=true,geo_region_query_cells=0i,geo_region_query_falsepos=0i,geo_region_query_points=0i,geo_region_query_reqs=0i,high_water_disk_pct=50i,high_water_memory_pct=60i,hwm_breached=false,ldt_enabled=false,ldt_gc_rate=0i,ldt_page_size=8192i,master_objects=0i,master_sub_objects=0i,max_ttl=315360000i,max_void_time=0i,memory_free_pct=100i,memory_size=1073741824i,memory_used_bytes=0i,memory_used_data_bytes=0i,memory_used_index_bytes=0i,memory_used_sindex_bytes=0i,migrate_order=5i,migrate_record_receives=0i,migrate_record_retransmits=0i,migrate_records_skipped=0i,migrate_records_transmitted=0i,migrate_rx_instances=0i,migrate_rx_partitions_active=0i,migrate_rx_partitions_initial=0i,migrate_rx_partitions_remaining=0i,migrate_sleep=1i,migrate_tx_instances=0i,migrate_tx_partitions_active=0i,migrate_tx_partitions_imbalance=0i,migrate_tx_partitions_initial=0i,migrate_tx_partitions_remaining=0i,non_expirable_objects=0i,ns_forward_xdr_writes=false,nsup_cycle_duration=0i,nsup_cycle_sleep_pct=0i,objects=0i,prole_objects=0i,prole_sub_objects=0i,query_agg=0i,query_agg_abort=0i,query_agg_avg_rec_count=0i,query_agg_error=0i,query_agg_success=0i,query_fail=0i,query_long_queue_full=0i,query_long_reqs=0i,query_lookup_abort=0i,query_lookup_avg_rec_count=0i,query_lookup_error=0i,query_lookup_success=0i,query_lookups=0i,query_reqs=0i,query_short_queue_full=0i,query_short_reqs=0i,query_udf_bg_failure=0i,query_udf_bg_success=0i,read_consistency_level_override="off",repl_factor=1i,scan_aggr_abort=0i,scan_aggr_complete=0i,scan_aggr_error=0i,scan_basic_abort=0i,scan_basic_complete=0i,scan_basic_error=0i,scan_udf_bg_abort=0i,scan_udf_bg_complete=0i,scan_udf_bg_error=0i,set_deleted_objects=0i,sets_enable_xdr=true,sindex.data_max_memory="ULONG_MAX",sindex.num_partitions=32i,single_bin=false,stop_writes=false,stop_writes_pct=90i,storage_engine="device",storage_engine.cold_start_empty=false,storage_engine.data_in_memory=true,storage_engine.defrag_lwm_pct=50i,storage_engine.defrag_queue_min=0i,storage_engine.defrag_sleep=1000i,storage_engine.defrag_startup_minimum=10i,storage_engine.disable_odirect=false,storage_engine.enable_osync=false,storage_engine.file="/opt/aerospike/data/test.dat",storage_engine.filesize=4294967296i,storage_engine.flush_max_ms=1000i,storage_engine.fsyn
|
||
|
|
aerospike_set,aerospike_host=localhost:3000,node_name=BB99458B42826B0,set=test/test disable_eviction=false,memory_data_bytes=0i,objects=0i,set_enable_xdr="use-default",stop_writes_count=0i,tombstones=0i,truncate_lut=0i 1598033805000000000
|
||
|
|
aerospike_histogram_ttl,aerospike_host=localhost:3000,namespace=test,node_name=BB98EE5B42826B0,set=test 0=0i,1=0i,10=0i,11=0i,12=0i,13=0i,14=0i,15=0i,16=0i,17=0i,18=0i,19=0i,2=0i,20=0i,21=0i,22=0i,23=0i,24=0i,25=0i,26=0i,27=0i,28=0i,29=0i,3=0i,30=0i,31=0i,32=0i,33=0i,34=0i,35=0i,36=0i,37=0i,38=0i,39=0i,4=0i,40=0i,41=0i,42=0i,43=0i,44=0i,45=0i,46=0i,47=0i,48=0i,49=0i,5=0i,50=0i,51=0i,52=0i,53=0i,54=0i,55=0i,56=0i,57=0i,58=0i,59=0i,6=0i,60=0i,61=0i,62=0i,63=0i,64=0i,65=0i,66=0i,67=0i,68=0i,69=0i,7=0i,70=0i,71=0i,72=0i,73=0i,74=0i,75=0i,76=0i,77=0i,78=0i,79=0i,8=0i,80=0i,81=0i,82=0i,83=0i,84=0i,85=0i,86=0i,87=0i,88=0i,89=0i,9=0i,90=0i,91=0i,92=0i,93=0i,94=0i,95=0i,96=0i,97=0i,98=0i,99=0i 1598034191000000000
|
||
|
|
```
|