All Products
Document Center

Gateway exception troubleshooting

Last Updated: Jan 28, 2021

Single request troubleshooting

1. Capture client-side request packets

Generally, Charles (recommended) or Fiddler tool is used to capture client-side packets. With the packet capture tool, you can find some critical data of the RPC requests.

Here is an example of packet capture:

  • Example of request header:
    request header

  • Example of response header:
    request header

2. Query MGS log by TraceId

  1. Obtain Mgw-TraceId from the response header.
  2. In mPaaS console, select the target App, go to the Mobile Gateway > Manage gateway> Tools > Trace analysis page, and enter the TraceId to parse the corresponding MGS server IP and processing time of the request.
  3. Connect MGS server through SSH, and then query the request-related logs by TraceId.
    1. ssh -p2022 log@#ip# Account: log/mpaas123456
    2. cd /home/admin/logs/gateway
    3. grep #traceid# *.log
  4. Analyze logs according to the Gateway logs and Gateway result codes.

Cluster GREP troubleshooting (for private cloud only)

Sometimes, you may need to search a certain log in MGS cluster. At this time, you can use the open-source PSSH tool.

  1. Download PSSH tool.
  2. Export the server IP list of MGS from Gamma platform to mgs_host.txt file, for example:

    1. log@
    2. log@
    3. log@
  3. Run the following command:
    1. pssh -i -h mgs_host.txt -A -P 'grep "xxxx" /home/admin/logs/gateway/xxx.log'