REST API trace folders and files

You can trace REST API calls in the Run time debugging of bshell (ttstpbshdebug) session. See REST API tracing.

Information from tracing REST API calls is stored in subfolders in the AWS_S3_admin\tmp\http traces folder on the tenant. You can access this folder through the File Manager (ttfmafileman) session.

The name of a subfolder matches the name of the Trace ID specified in the Run time debugging of bshell (ttstpbshdebug) session. For example:

  • admin01_001: user admin01, trace ID sequence number 1
  • admin01_002: user admin01, trace ID sequence number 2

A <trace ID> subfolder contains subfolders for 10-minute timeslots. The names of the subfolders indicate the UTC time. For example:

  • 2024-05-15T13-2 – contains trace files generated on May 15, 2024, between 13.20.00 and 13.29.59 UTC time.
  • 2024-05-15T13-3 – contains trace files generated on May 15, 2024, between 13.30.00 and 13.39.59 UTC time.
  • 2024-05-15T13-4 – contains trace files generated on May 15, 2024, between 13.40.00 and 13.49.59 UTC time.

Trace file names

The trace files in the ‘timeslot’ folders are compressed and have a .gz extension.

The names of the trace files depend on the trace settings you specified. A name can contain these elements:

  • Trace ID. For example, admin01_008. In this example, admin01 is the user who started the trace; 8 is the sequence number of the trace configuration.
  • Information about the filter (HTTP method, company, identity) that was applied.
  • HTTP path that was traced.
  • UTC date and time stamp.
  • .gz extension

Generation of trace file names

Examples of trace file names that are generated when tracing the ttapi-aadJobMgmt API:

No filter applied
admin01_001+++-lnapi-internal-odata-v4-ttapi-aadJobMgmt+2024-05-13T14-42-05-590Z+3e42f5ea-41ae-fcc0-1e98-21dab92eae73+3297c054.gz
Filter on HTTP method GET
admin01_001+GET++-lnapi-internal-odata-v4-ttapi-aadJobMgmt+2024-05-14T09-34-58-196Z+aa751993-341e-7d93-e740-3ee3b3ce826d+0a193e50.gz
Filter on HTTP method POST
admin01_001+POST++-lnapi-internal-odata-v4-ttapi-aadJobMgmt+2024-05-14T09-01-57-339Z+cea184c7-4919-4c75-9a22-53db6fe216d2+4c51e080.gz
Filter on company 3050
admin01_007++X-Infor-LnCompany_3050+-lnapi-internal-odata-v4-ttapi-aadJobMgmt+2024-05-21T07-54-02-176Z+91df20ac-1e46-477a-b0b5-5e3ada3be917+6ca06c61.gz
Filter on identity api_jdoe
admin01_008++X-Infor-LnIdentity_api_jdoe+-lnapi-internal-odata-v4-ttapi-aadJobMgmt+2024-05-21T08-48-09-864Z+845d4296-1c85-4fd6-91ad-d6acc762bc98+5f90c010.gz