Once AppSignal Logging is successfully configured, you'll be able to see logs for all of your sources from within the AppSignal application. You can filter and query logs and expand specific logs for their trace data. When viewing your logs you can:
- Filter and Query Logs
- Copy Log Meta Data as JSON
- Share Log
- View What Happened Here
- Jump to Date
- View Live Trail
Filter and Query Logs
Use the "Source" drop down to filter which sources you see the logs for. Use the "Severity" drop down to filter the severity of logs
Filtering and querying are further explained in the Filtering and Querying section of this guide.
Copy Log Meta Data As JSON
Expand a log by pressing the "+" button, click "Copy as JSON". Meta data will automatically be copied to your clipboard as a valid JSON object.
Click "Copy link to log line" and a link to this log line will automatically be copied to your clipboard.
What Happened Here
Want to see a snapshot of your application's metric at the exact time the logline was made? Click "What Happened Here"
Jump to Date
Something happened while you were having coffee? No problem. Use the "Jump to date" button to navigate to the date and time you want to investigate.
Clicking "Go to live" will take you to a live trail of your logs.
Filtering and Querying
AppSignal supports log filtering by:
|A Log Source from your application, eg MongoDB or Sidekiq|
|Log severity level. Accepted values are: error, warning, info, debug and trace|
|Application Host (via search)|
|Namespaces defined for your application (via search)|
|Log message contents (via search)|
|Attributes defined in your logs (via search)|
Search Syntax Explained
The below table explains the current AppSignal Logs search query syntax.
Queries can be combined with a space between them (see Combined Queries in Search Query Overview).
Search Query Overview
|Query Name||AppSignal Syntax||Description|
|Wildcard||Returns all logs that contain a value like |
|Multiple Wildcards||Returns all logs that contain a value like |
|Wildcard For Words With Spaces||Returns all logs that contain a value like |
|Field Search||Returns all logs where field hostname is like |
|Multiple Word Field Search||Returns all logs where field hostname is like |
|Exact Match||Returns all logs where field hostname is |
|Exact Query Negation||Returns all logs where field hostname is not |
|Wildcard Query Negatiom||Returns all logs where field hostname is not like |
|Attribute Specific Query||Queries log attributes. Replace |
|Greater Than||Returns all logs where |
|Less Than||Returns all logs where |
|Combined Queries||Returns all logs where logs contain a value like |
To modify a source go to AppSignal > Logging > Sources and click "Manage source"
When managing a source, you can:
To edit the source click "Edit source" in the top right corner of the screen. You can edit the following source attributes:
- Platform (currently limited to syslog)
Changing the log format only applies to new log lines. The attributes and message of existing log lines will not change.
Deletion is permanent and will revoke the API key used for that source.
Before removing a log source, we recommend ensuring that the source is no longer sending logs to AppSignal so that your application is not making unnecessary calls to third parties. Before removing the log source in AppSignal, remove the rsyslog configuration file for this log source (located in
etc/rsyslog.d) and restart rsyslog with the below command.
/etc/rc.d/init.d/systemctl restart rsyslogd
To remove a source click "Remove source" from the Source Management page. When prompted to confirm removal read the dialogue box carefully and click "Yes, delete this". The source will be deleted.