Internal logs

When you visit the Grafana Fleet Management interface in Grafana Cloud after registering a collector, a self_monitoring_logs_* configuration pipeline is automatically created and assigned based on the collector’s operating system. This pipeline collects internal logs.

View logs for a registered collector

The Fleet Management service displays internal logs in the application interface.

In your Grafana Cloud instance, click Connections > Collector > Fleet Management in the left navigation menu.
Search, filter, or sort to find the collector in your Inventory.
Click on the collector to open the details view drawer and switch to the Logs tab.

Note
If you don’t see any log records, refer to Logs don’t appear in app for help.

Error-level logs

The following log messages can help you diagnose collector errors.

Log message	Cause	Fix
`failed to fetch remote configuration from the API`	Alloy cannot reach the Fleet Management API or could not load the latest configuration.	Check if the API is operational. Check for authentication errors, such as an invalid token. Check configuration for invalid syntax or missing components and revert if necessary.
`failed to fetch remote config`	Variant of previous message that is logged when the error occurs during Alloy startup or when the `remotecfg` block arguments are changed.	Check if the API is operational. Check for authentication errors, such as an invalid token. Check configuration for invalid syntax or missing components and revert if necessary.
`failed to read from cache`	Alloy cannot access or read the locally cached remote configuration file.	If logged at startup, check if the file exists. Alternatively, check for a permissions issue.
`failed to load from cache`	Alloy cannot load the contents it read from the locally cached remote configuration file.	Check if the file has been truncated or corrupted.
`failed to flush remote configuration contents to the on-disk cache`	Alloy cannot write new configuration to the locally cached remote configuration file.	Check for a permissions issue.

Debug-level logs

The following log messages can help you identify the source and context of events to debug collector issues.

Log message	Event
`fetching remote configuration`	Alloy reaches a polling interval and requests the current remote configuration from the API.
`skipping over API response since it has not been modified since last fetch`	The API response to a `GetConfig` request is the same as the most recent locally cached remote configuration file.
`skipping over API response since it matched the last loaded one`	The API response to a `GetConfig` request is the same as the last loaded remote configuration. The last loaded remote configuration might differ from the most recent locally cached remote configuration if the cached file had an error. Alloy always loads and runs the last known good configuration if it encounters an error. If the error is corrected with a rollback in the UI, an API response with the corrected configuration might match the last known good configuration, meaning there’s no need to reload the configuration.

Query for pipeline logs

To isolate logs from specific pipelines, you can use queries in the Grafana Cloud Explore application.

In your Grafana Cloud instance, click Explore in the left navigation menu.
Select your logs datasource from the dropdown menu. The datasource name should be similar to grafanacloud-<instance_name>-logs.
Switch the query editor from Builder to Code.
Copy and paste one of the following queries into the box. Make sure to substitute your own pipeline name for the placeholder. Click Run query.

Find component logs for a specific pipeline:

{collector_id=~".+"} |= "component_path=/remotecfg/<pipeline_name>.default"

Find logs emitted when a pipeline is refreshed or has an issue loading:

{collector_id=~".+"} |= "controller_path=/remotecfg" |=  "controller_id=<pipeline_name>.default"

Find logs emitted when a pipeline can’t be loaded at all:

{collector_id=~".+"} |= "controller_path=/" |= "controller_id=remotecfg" |= "node=<pipeline_name>.default"

The `logging` block

Remote configuration does not support top-level configuration blocks, which means that the logging block cannot be used in Fleet Management configuration pipelines.

If you want to use the logging block, you must do so by adding the block to the collector’s local configuration file.

Log levels

The self_monitoring_logs* pipelines do not support a change in log level. If you wish to change log levels for debugging, you must use the logging block in the collector’s local configuration.