View Logs
The blocklet server logs
command is an essential tool for debugging and monitoring. It displays the locations of all relevant log files for the Blocklet Server daemon and each installed blocklet, helping you quickly identify and resolve issues.
Usage#
To view the log file paths, execute the following command in your terminal:
blocklet server logs
The command will print a structured list of paths for the server's daemon logs and then list the specific log files for each installed blocklet.
Example Output#
Here is a sample output from running the command on a server with a couple of blocklets installed:
$ blocklet server logs
Blocklet Server Logs
- Latest logs: /path/to/your/data/logs/daemon/daemon-2023-10-27.log
- Daemon Logs Directory: /path/to/your/data/logs/daemon
Daemon Logs
- access-<date>.log: access logs rotated by day
- daemon-<date>.log: business logs rotated by day
- daemon-error-<date>.log: error logs rotated by day
- service.log: abtnode service logs
- stderr.log: stderr logs
- stdout.log: stdout logs
my-blocklet@1.0.0
- Output: /path/to/your/data/logs/my-blocklet/output.log
- Error: /path/to/your/data/logs/my-blocklet/error.log
another-blocklet@2.1.0
- Output: /path/to/your/data/logs/another-blocklet/output.log
- Error: /path/to/your/data/logs/another-blocklet/error.log
Understanding the Log Files#
The output is divided into two main sections: server-level logs and blocklet-specific logs.
Server Daemon Logs#
All server-level logs are stored within the Daemon Logs Directory
. The different log files are categorized to help you find information efficiently.
File Pattern | Description |
---|---|
| Contains daily rotated access logs for the server. |
| Stores general business and operational logs, rotated daily. |
| Collects error-specific logs, also rotated daily. |
| Logs from the underlying node service manager. |
| Captures the standard error stream from the main server process. |
| Captures the standard output stream from the main server process. |
Individual Blocklet Logs#
For each installed blocklet, the command lists two primary log files:
- Output: The path to the blocklet's standard output log (
output.log
). - Error: The path to the blocklet's standard error log (
error.log
).
Note: The Blocklet Server must be running for the command to list the log paths for individual blocklets. If the server is stopped, it will only display the server-level log paths along with a warning message.
After diagnosing issues with logs, you might need to manage your server's version. Learn how in the next section: Upgrade Server.