Skip to content

Recommended Practices

  1. Correlation Id: Include unique identifier at the start of the interaction to tie down aggregated data from various system components and provide a holistic view. Read more guidelines about using correlation id.
  2. Ensure health of the services are monitored and provide insights into system's performance and behavior.
  3. Ensure dependent services are monitored properly. Errors and exceptions in dependent services like Redis cache, Service bus, etc. should be logged and alerted. Also, metrics related to dependent services should be captured and logged.

    - Additionally, failures in dependent services should be propagated up each level of the stack by the health check.

  4. Faults, crashes, and failures are logged as discrete events. This helps engineers identify problem area(s) during failures.

  5. Ensure logging configuration (eg: setting logging to "verbose") can be controlled without code changes.
  6. Ensure that metrics around latency and duration are collected and can be aggregated.
  7. Start small and add where there is customer impact. Avoiding metric fatigue is very crucial to collecting actionable data.
  8. It is important that every data that is collected contains relevant and rich context.
  9. Personally Identifiable Information or any other customer sensitive information should never be logged. Special attention should be paid to any local privacy data regulations and collected data must adhere to those. (ex: GDPR)
  10. Health checks : Appropriate health checks should added to determine if service is healthy and ready to serve traffic. On a kubernetes platform different types of probes e.g. Liveness, Readiness, Startup etc. can be used to determine health and readiness of the deployed service.

Read more here to understand what to watch out for while designing and building an observable system.

Last update: August 17, 2022