Comment by liveoneggs

Comment by liveoneggs 15 hours ago

2 replies

Monitoring tools (APM) will show dependencies (web calls, databases, etc) and should contain things like deployment markers and trend lines.

All of those endpoints should be documented in an environment variable or similar as well.

The breakdown is when you don't instrument the same tooling everywhere.

Documentation is generally out of date by the time you finish writing it so I don't really bother with much detail there.

kennethops 15 hours ago

This has been my experience as well. imo documentation feels like one of the few areas that AI can be good at today.

  • liveoneggs 5 hours ago

    It's okay but it often lies. At an SRE level you need a pretty zoomed-out view of the world until you are trying to zoom-in to a problem component.

    Always start at the head (what a customer sees -- actually load the website) and work down into each layer.

    If something is breaking way downstream and customers don't see it then it doesn't actually matter right now.