Add maintenance commands to README

README.md

@@ -142,11 +142,29 @@ docker exec -it safe-transaction-service-web-1 python manage.py createsuperuser
 - [v1.3.0 L2](https://github.com/safe-global/safe-deployments/blob/main/src/assets/v1.3.0/gnosis_safe_l2.json)
 - [Other related contracts and previous Safe versions](https://github.com/safe-global/safe-deployments/blob/main/src/assets)
 
-## Troubleshooting
-
-### Issues installing grpc on a Mac M1
-
-If you face issues installing the `grpc` dependency locally (required by this project) on a M1 chip, set `GRPC_PYTHON_BUILD_SYSTEM_OPENSSL=1` and `GRPC_PYTHON_BUILD_SYSTEM_ZLIB=1` and then try to install the dependency again.
+## Service maintenance
+
+Service can run into some issues when running in production:
+
+### Indexing issues
+You can tell there are indexing issues if:
+- Executed transactions are missing from the API (`all-transactions`, `multisig-transactions`, `module-transactions`... endpoints). If you
+use the **web UI** please make sure by checking **Transaction Service API**, as sometimes it can be a cache delay in
+the **Safe Client Gateway** which is between web UI and **Safe Transaction Service**.
+- Asset transfers (ERC20/721) are missing from `all-transactions` or `transfers` endpoints.
+- You see in the logs errors about an owner cannot be removed or similar inconsistent errors when `worker-indexer` is processing decoded data.
+
+There are multiple options for this. Connect to either `web` or `worker` instances. Running commands inside of `tmux` is recommended
+(installed by default):
+- `python manage.py check_index_problems`: it will try to automatically fix missing transactions.
+Tokens related transactions (ERC20/721) will not be fixed with this method. This method will take a while, as it needs to compare
+database data with blockchain data for every Safe.
+- `python manage.py reindex_master_copies --from-block-number X --addresses 0x111 0x222`: if you know the first problematic block,
+it's faster if you trigger a manual reindex. `--addresses` argument is optional, but if you know the problematic Safes providing
+them will make reindexing **way** faster, as if not all the Safes are reindexed.
+
+If you see ERC20/ERC721 missing:
+- `python manage.py reindex_erc20 --from-block-number X --addresses 0x111 0x222`: same logic as with `reindex_master_copies`.
 
 ## FAQ
 ### Why `/v1/safes/{address}` endpoint shows a nonce that indicates that a transaction was executed but the transaction is not shown or marked as executed in the other endpoints?
@@ -176,5 +194,11 @@ https://docs.safe.global/learn/safe-core/safe-core-api/available-services
 ### What means banned field in SafeContract model?
 The `banned` field in the `SafeContract` model is used to prevent indexing of certain Safes that have an unsupported `MasterCopy` or unverified proxies that have issues during indexing. This field does not remove the banned Safe and indexing can be resumed once the issue has been resolved.
 
+## Troubleshooting
+
+### Issues installing grpc on a Mac M1
+
+If you face issues installing the `grpc` dependency locally (required by this project) on a M1 chip, set `GRPC_PYTHON_BUILD_SYSTEM_OPENSSL=1` and `GRPC_PYTHON_BUILD_SYSTEM_ZLIB=1` and then try to install the dependency again.
+
 ## Contributors
 [See contributors](https://github.com/safe-global/safe-transaction-service/graphs/contributors)