Introduction

Astra CLI provides a simple way to inspect and troubleshoot Astra services directly from the command line. This guide explains how to view, filter, tail, and export logs for both Astra Traffic Collector and Astra Proxy Service using Astra CLI. These logs can be used to verify service health, investigate connectivity issues, and troubleshoot deployment problems.

Prerequisites

Before proceeding, ensure the following:

• Astra CLI is installed on the host machine.

• Astra Traffic Collector and/or Astra Proxy Service have been installed using Astra CLI.

• You have terminal access to the machine where the services are running.

• The Astra services are running and accessible through Astra CLI commands.

How to inspect logs of Astra Traffic Collector?

Note that the following command gives full logs of selected service.

./astra-cli collector logs

If you need most recent logs, say last 5 minutes, you can use a small variant of the command by passing in a flag

./astra-cli collector logs --since=5m

If you need most recent logs, say last 1 hour, you can use a small variant of the command by passing in a flag

./astra-cli collector logs --since=1h

If you want to tail the logs, then you can use this command

./astra-cli collector logs --tail=0 -f

If you want to redirect the logs to a file for further inspection, you can use this command

./astra-cli collector logs --since=1h > collector.log 2>&1

How to inspect logs of Astra Proxy Service?

Note that the following command gives full logs of selected service.

./astra-cli proxy logs

If you need most recent logs, say last 5 minutes, you can use a small variant of the command by passing in a flag

./astra-cli proxy logs --since=5m

If you need most recent logs, say last 1 hour, you can use a small variant of the command by passing in a flag

./astra-cli proxy logs --since=1h

If you want to tail the logs, then you can use this command

./astra-cli proxy logs --tail=0 -f

If you want to redirect the logs to a file for further inspection, you can use this command

./astra-cli proxy logs --since=1h > collector.log 2>&1

Troubleshooting

To know how to download the Astra-Cli and setup the Astra Proxy Service and Astra Traffic Collector, please refer to the below article
📄 How to Setup Astra Proxy Service Integration using astra-cli