Set up Tag Monitor (server-side)

Tag Monitor checks in real time whether the tags in your Google Tag Manager server container fire correctly, and alerts you when they don't. New to Code-Cube.io? Start with What is Code-Cube.io?

This guide walks you through the full server-side setup of Tag Monitor using Google Tag Manager (GTM). Setting up client-side monitoring? See Set up Tag Monitor (client-side).

What will you do?

• Configure your domains and containers in the Code-Cube.io portal
• Import the Tag Monitor template into your GTM server container
• Set up the tag with sampling and metadata
• Publish and verify your implementation

⏰ Estimated time: 10 - 15 minutes

🔧 Requirements: Access to your GTM server container with Publish permission, and access to the Code-Cube.io portal

• Step 1 – Portal configuration
• 1.1 Domains and time zone
• 1.2 GTM container settings
• Step 2 – Import the template in GTM
• 2.1 Download the template
• 2.2 Import the template in GTM
• Step 3 – Configure the tag in GTM
• 3.1 Create the tag
• 3.2 Set up the trigger
• 3.3 Enable required variables
• Step 4 – Configure tag metadata
• Option A: Automatic update (recommended)
• Option B: Manual update
• Step 5 – Deploy and verify
• 5.1 Publish changes
• 5.2 Verify
• Troubleshooting
• Next steps

Step 1 – Portal configuration

Before configuring anything in GTM, define which domains and containers should be monitored with Tag Monitor.

1.1 Domains and time zone

• Go to the step 'General settings' on the Tag Monitor configuration page
• Add all domains you want to monitor
• Select the appropriate time zone

1.2 GTM container settings

• Go to the step 'Server-side error monitoring' on the Tag Monitor configuration page
• Add the GTM server container IDs you want to enable monitoring for

Step 2 – Import the template in GTM

Install the Tag Monitor tag template in your GTM server container. This provides the logic needed to send tag data to Code-Cube.io.

2.1 Download the template

• Go to 'Server-side error monitoring' on the Tag Monitor configuration page
• Click "Download template"

2.2 Import the template in GTM

1. Open your GTM server container
2. Go to "Templates" > "Tag Templates"
3. Click "New"
4. Click the three dots > "Import"
5. Upload the downloaded file
6. Save without making any changes

Step 3 – Configure the tag in GTM

Now configure how the Tag Monitor tag collects and sends data, including basic settings and sampling.

3.1 Create the tag

1. Create a new tag
2. Choose the imported Tag Monitor template as the tag type
3. Fill in the required fields:
• Database name: Copy from the configuration page

• Consent: Set to 'No additional consent required'
• Metadata: Add key exclude with value true

3.2 Set up the trigger

Use a Custom Event trigger with regex matching and optional sampling to control data volume.

1. Create a new trigger
2. Trigger type: Custom Event
3. Event name: .* (match all)
4. Enable "Use regex matching"

Optional: add sampling

Sampling minimizes the impact on performance in high-traffic environments.

1. Enable the built-in variable "Random Number"
2. Add the condition Random Number – less than or equal to – [value] to the trigger, using a value from the table below

3.3 Enable required variables

Tag Monitor uses these built-in variables to identify the container the tag was fired from.

• Go to Variables > Built-in Variables
• Enable:
• Container ID
• Container Version

Step 4 – Configure tag metadata

Add your tag names to the outgoing requests for easier debugging and reporting. Choose one of these options.

Option A: Automatic update (recommended)

1. Go to 'Configure tag names' on the configuration page
2. Click Start bulk editing
3. Follow the guided process to update your GTM container via the API. See Bulk edit tags in Google Tag Manager for details

Option B: Manual update

For each tag in your container:

1. Open Advanced Settings
2. Check "Include tag name" under Additional Metadata
3. Set the key name to name

Step 5 – Deploy and verify

Once everything is configured, go live and confirm everything works as expected.

5.1 Publish changes

• Submit and publish your GTM workspace
• Choose the right environment (usually production)

5.2 Verify

1. Open the Tag Monitor dashboard in the Code-Cube.io portal
2. Look for incoming data from your configured domain and container
3. Check that tag names are being registered correctly

Troubleshooting

Still stuck? Contact the Code-Cube.io team.

Next steps

• Notifications & alerts: choose where and how you receive alerts
• Set up Tag Volume monitoring: get alerted when tag volume drops
• Monitor Cloud Run: monitor the server that hosts your container
• Understanding & solving errors: learn how to read and fix the errors Tag Monitor reports