Debugging Transaction Buffering
================================

Troubleshooting transaction buffering issues.

Common Issues
-------------

**Buffer not draining**:

Check background processor status:

.. code-block:: bash

   curl http://localhost:8000/health

Check database connectivity:

.. code-block:: bash

   curl http://localhost:8000/api/site/info

**Transactions failing**:

View failed transactions:

.. code-block:: bash

   redis-cli
   > LRANGE site:observatory:failed_transactions 0 -1

**Replication lag**:

Check LSN status:

.. code-block:: bash

   curl http://localhost:8000/health | jq '.replication_lag'

Debugging Tools
---------------

See :doc:`redis-inspection` for Redis debugging commands.

See :doc:`../deep-dive/transaction-buffering/overview` for system architecture.