Skip to content

Toolbelt overview ​

A SaaS support engineer does not need fifty apps. You need a small stack you can operate under time pressure, plus the discipline to keep customer secrets out of it.

This chapter is product-agnostic. Prefer principles over brand names. If your company standardized on Zendesk instead of Intercom, the job does not change: capture evidence, classify, resolve or escalate.

The six jobs of the stack ​

JobWhat it is forTypical tools
ConversationTalk to the customer, keep a record, hit SLAsHelp desk / ticketing
Browser truthSee what the client actually sent and receivedChrome/Edge DevTools, Firefox, Safari Web Inspector
API truthReplay a call without the UI in the wayPostman, Bruno, Insomnia, curl
Data truthConfirm what is stored (read-only)DBeaver, TablePlus, psql, mongosh
System truthLogs, traces, exceptions, deploy markersSentry, Datadog, CloudWatch, Grafana, your log search
HygieneDecode tokens, inspect JSON, convert timezonesjwt.io alternatives you run locally, JSON formatter, timezone converter

If a tool does not serve one of those jobs, it is a distraction.

Default order of operations ​

  1. Ticket context: who, tenant, plan, when it started.
  2. Browser Network + Console on a reproduce (or their HAR). See Network and HAR files.
  3. Replay the failing API call in an API client if you have a safe environment. See API clients.
  4. Confirm state in the database only if Network + logs are not enough. See Database clients and SQL.
  5. Correlate by request ID in observability. See Observability.

Skipping to SQL because it feels powerful is how people leak PII and miss a 401 sitting in the HAR.

What "best" means here ​

Best for support is not "most features." It is:

  • Works offline or with a local file (HAR, console dump) when the customer's VPN is a mess
  • Makes status, headers, and bodies obvious
  • Does not upload customer data to a random website by default
  • Has a clear audit trail (you can say who looked up which tenant)

Privacy constraints for every tool: Privacy and customer data.

Public craft handbook. Product runbooks are excluded from this build.