The Aerospike Knowledge Base has moved to https://support.aerospike.com. Content on https://discuss.aerospike.com is being migrated to either https://support.aerospike.com or https://docs.aerospike.com. Maintenance on articles stored in this repository ceased on December 31st 2022 and this article may be stale. If you have any questions, please do not hesitate to raise a case via https://support.aerospike.com.
How To generate logs for an Aerospike Support Case
Context
When you raise a case via the Aerospike Portal, it will generate a list of logs to attach to the case. This article will show you how to obtain those logs.
Method
Collectinfo
Collectinfo is a basic diagnostic that gives Support information about how your Aerospike cluster is configured. It also collects system diagnostics from the host it is run from and so should be run with sudo
.
sudo asadm -e collectinfo –u USER –p
It will produce a tar file which can then be uploaded via FTP or sent in via email.
Aerospike logs
Aerospike logs are text based and easy to obtain. If the system is writing the logs directly to disk they will be found at:
/var/log/aerospike/aerospike.log
If you are managing logs using journald
you might not find that directory, in that case you’ll need to run a command to get the logs.
$ journalctl -u aerospike -a -o cat –f | /tmp/aerospike.log
Please remember that, wherever possible, we’ll need logs from all of the cluster nodes.
Configuration Enabled Benchmarks
If certain transactions are slow then it might be a good idea to get configuration enabled benchmarks. These give Aerospike Support a breakdown of what is happening inside the transaction flow. They’re useful for finding bottlenecks when the system is slow.
Ideally these should be switched on for all nodes during a period of slowness. 60 minutes of logging is usually enough.
These benchmarks do generate extra logging information but normally do not affect performance. It is safe have these switched on in a production system.
Once the data has been collected, the benchmarks can be switched off by running the same commands but using the keyword false
instead of true
.
To switch on the benchmarks across all nodes, run the commands from asadm
.
To decide which benchmarks to send, use the table below. For each transaction type that is slow, activate the benchmark. You may need to fill in specific information for your system, such as the namespace
name or the secondary index
that is slow.
Transaction Type | Command |
---|---|
Read | manage config namespace param enable-benchmarks-read to true |
Batch Read | manage config namespace param enable-benchmarks-batch-sub to true |
Write | manage config namespace param enable-benchmarks-write to true |
Secondary Index Query | asinfo -v “sindex-histogram:ns=NAMESPACE;indexname=INDEX;enable=true” |
Additionally, if you are storing data on disk, please also provide storage benchmarks for the disk.
asadm -e 'manage config namespace <namespaceName> param enable-benchmarks-storage to true'
Notes
- Certain older Aerospike versions may use different commands for Configuration Enabled Benchmarks. Please contact Aerospike Support for help with commands.
- Logs can be uploaded by attaching to the ‘Files’ tab of the case via the portal or via FTP
Applies To
Aerospike 5 and above.
Keywords
CONFIGURATION BENCHMARK LOG COLLECTINFO
Timestamp
February 2022