Aerospike Admin provides an interface for Aerospike users to view the stat
of their Aerospike Cluster by fetching information from a running cluster (Cluster mode)
a collectinfo file (Collectinfo-Analyzer), or logs (Log-analyser mode).
To get started run asadm
and issue the help
command. The
full documentation can be found here.
The Aerospike Admin repo now contains asinfo. Asinfo has been a long time member of the Aerospike Tools package but is now build together with asadm. Asinfo provides a raw interface to Aerospike info protocol and is useful for debugging and development. The full documentation can be found here.
There are no runtime dependencies. This is because the python interpreter is now bundled with asadm version 2.6 and later.
- python 3.10
- pipenv
- Install python 3.10
- Install pipenv
- Build Asadm
There are two ways asadm can be bundled: one-file and one-dir. Both, are related to
pyinstaller's two methods of bundling. The one-file build is great if you want a single
executable artifact. The downside of one-file is that it must decompress into a /tmp
directory in order to execute. This causes a number of problems. On macOS, the startup
time is drastically increased because of the codesigning mechanism. The /tmp directory
must be mounted with the the exec option. If the above scenarios describe your environment
then use the one-dir build.
- one-dir (default)
make one-dir
- one-file
make one-file
- one-dir (default)
- Install asadm
sudo make install
asadm -h <Aerospike Server Address\>
Admin> help
asadm -l [-f <location of logs\>]
Admin> help
asadm -c [-f <location of collectinfo\>]
Admin> help
asadm has unit and e2e tests. To setup environment for e2e tests, execute following steps:
- Enable security in the aerospike.conf file.
- Verify that the default user
admin
exists and that is has the default roles:sys-admin
,user-admin
, andread-write
. - Start Aerospike cluster: Test machine should be part of this cluster with 3000 as asinfo port.
- Write a few records to cluster
asbenchmark -h <host> -Uadmin -Padmin
- Wait for a few seconds so cluster can return histogram output properly.
pipenv
./run_tests.sh
- yappi
asadm --profile Do not exit with 'ctrl+c' exit with the exit command