Custom Grouping
Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel,
n'hésitez pas à nous contacter.
Overview
Error Tracking intelligently groups similar errors into issues with a default strategy. By using custom fingerprinting, you can gain full control over the grouping decision and customize the grouping behavior for your error logs.
Provide an error.fingerprint attribute that Error Tracking can use to group error logs into issues. While the value of the error.fingerprint attribute does not have any particular format or requirement, the content must be a string.
If error.fingerprint is provided, the grouping behavior follows these rules:
- Custom grouping takes precedence over the default strategy.
- Custom grouping can be applied only to a subset of your error logs and can co-exist with the default strategy.
- The content of
error.fingerprint is used as-is without any modification. - Logs from the same service and with the same
error.fingerprint attribute are grouped into the same issue. - Logs with different
service attributes are grouped into different issues.
Setup
Custom grouping only needs an error log and an error.fingerprint string attribute.
If you aren’t already collecting logs with Datadog, see the Logs documentation to set up logs.
Ensure that the source tag (specifying language) is properly configured.
Example
If you’re already logging in JSON format, add a new error.fingerprint attribute to your error log.
Here’s an example in Python for a JSON-formatted logger:
import logging
import json_log_formatter
formatter = json_log_formatter.JSONFormatter()
json_handler = logging.FileHandler(filename='/var/log/my-log.json')
json_handler.setFormatter(formatter)
logger = logging.getLogger('my_json')
logger.addHandler(json_handler)
logger.setLevel(logging.INFO)
logger.error('Error processing request', extra={'error.fingerprint': 'my-custom-grouping-material'})
In this case, my-custom-grouping-material is used to group these error logs into a single
issue in Error Tracking.
Further Reading
Documentation, liens et articles supplémentaires utiles:
