Logs feature

The Logs feature provides real-time and historical records of the data flowing in and out of your server-side Google Tag Manager (sGTM) container. Logs make it straightforward to monitor and troubleshoot your server-side tracking setup so that any issues with your network or vendor don’t go unnoticed.

The Logs feature is available for Pro, Business, and Enterprise server-side GTM subscription users:

• Pro / Pro+ - last 3 days’ logs.
• Business / Business+ - last 10 days’ logs.
• Enterprise / Enterprise+ - last 10 days’ logs.

The Export logs feature is available for Enterprise plans or higher.

Optionally, you may also want to check out Stape’s Logger tag. This tag allows you to log the incoming request event data, request details, and custom information to stape.io, GCP, BigQuery, or other cloud platform logs.

How to use Logs

1. Log in to your stape.io account.

2. Select your sGTM container on the dashboard.

3. Open the Logs tab.

4. Configure your Logs request:

Type of requests:

• Incoming requests - these logs display the requests that your GTM server has received. Please note that they don’t contain cookies or personally identifiable information (PII).

• Outgoing requests - the requests that have been sent by the server GTM to Facebook, TikTok, and other platforms. They are only displayed if you enabled the toggle in the Outgoing requests tab. Since Outgoing requests may contain sensitive data, we need your consent to store the logs securely for a specific period of time (Pro plan users - 3 days, Business/Enterprise - 10 days).

• Date and time - select the time period for which you want to receive the logs.

• Request parameters - these allow you to filter your logs to find the ones you’re interested in. Different types of Logs offer different parameters, such as Status (the logs’ request code), Client (the logs’ origin), or Platform (that sent or received the logs).

After that, click Show logs. 

5. You will see the list of all logs that fit your request. You can download the data by clicking Download as CSV or clicking on any log record to expand to the Detailed view.

6. You can also enable the ability to Export logs (available for Enterprise plans or higher). This will automatically export your incoming and outgoing (if configured) logs to a cloud storage of your choosing.

To activate log export, toggle the switch and enter the required information to connect Stape Logs to your cloud storage. To do this, select a Destination (either Amazon Web Services (AWS), Google Cloud Platform (GCP), or another S3-compatible bucket) where the logs will be exported to. Depending on your selection, you will also need to enter some service-dependent configurations, such as Bucket name, Region, Endpoint URL, Access Key ID, or Secret Key. Please refer to your cloud storage provider if you need help with finding some of this information.

Testing the Logs feature

To verify that the Logs feature is working properly, perform actions on your website that are supposed to trigger your configured events and then check whether these events appear on the Logs dashboard. To check that log export is working properly, trigger the events and see that its logs appear in your cloud storage bucket that you configured.

Use cases of debugging with Logs

Stape Logs can be used to:

• Identify discrepancies across platforms
• Debug inaccurate attribution in Meta
• Monitor the full flow of incoming and outgoing requests.