---
title: "Troubleshooting"
description: "Guide to diagnosing Aerospike Database issues via server logs, asadm statistics, cluster latency, and network checks."
---

# Troubleshooting

> For the complete documentation index see: [llms.txt](https://aerospike.com/docs/llms.txt)
> 
> All documentation pages available in markdown.

Search the [Knowledge Base](https://support.aerospike.com/hc/en-us) topics as a wide variety of issues and remediations are covered there.

## Diagnosing problems

Review the following points to diagnose system problems before you contact Aerospike Technical Support:

-   If you have problems [starting a server](https://aerospike.com/docs/database/advanced/troubleshoot/startup), check the server logs. The logs usually mention the reason for startup failure.
-   If the servers are already [running](https://aerospike.com/docs/database/advanced/troubleshoot/node), check system information by running [`asadm`](https://aerospike.com/docs/database/tools/asadm) and using the `info` command. Ensure none of the statistics are in red.
-   Check for [cluster problems](https://aerospike.com/docs/database/advanced/troubleshoot/cluster):
    -   Check the system [latency](https://aerospike.com/docs/database/observe/latency/)
    -   Review the log files ([Configuring log files](https://aerospike.com/docs/database/manage/logging/logs) on each node to see if there are warning or error messages.
-   Check your [client](https://aerospike.com/docs/database/advanced/troubleshoot/client) machines (application servers and application logs).
-   Check the network (switches/routers/firewalls/load balancers)
-   Some problems could be [data-related](https://aerospike.com/docs/database/advanced/troubleshoot/misc) and must be corrected on application side.
-   Search through our Knowledge-Base reference guide if the issue observed has been previously reported - [Knowledge Base reference](https://support.aerospike.com/hc/en-us).

The troubleshooting pages in this section of the documentation provide details for how to address some common problems you may encounter when running Aerospike.

## Check for Aerospike upgrades

After you figure out the problem, be sure to check the release notes to see if a newer version of Aerospike Database resolves your issue. You can do a hot upgrade using the [rolling upgrade procedure](https://aerospike.com/docs/database/install/upgrade/standard).

In the troubleshooting pages, we assume that you know how to do the following standard tasks with Aerospike Database:

-   How to look at the Aerospike log, located in `/var/log/aerospike/aerospike.log` by default.
-   How to use [asadm to update configuration dynamically](https://aerospike.com/docs/database/tools/asadm/live-mode/#manage).
-   How to [update parameters in the configuration file](https://aerospike.com/docs/database/manage/database/as-config)
-   How to use asinfo to [read](https://aerospike.com/docs/database/reference/info#get-config) and [write](https://aerospike.com/docs/database/reference/info#set-config) parameters dynamically.
-   How to check [latency](https://github.com/aerospike-examples/asloglatency).
-   How to [start and stop asd](https://aerospike.com/docs/database/manage/database/daemon) (the main Aerospike process).
-   How to do a [cold](https://aerospike.com/docs/database/manage/database/cold-start) or a [fast](https://aerospike.com/docs/database/manage/database/fast-start) restart.