Erreichbarkeit eines Tagging-Servers prüfen

Direkter Nachweis

Vorschau starten und eindeutige Testanfrage senden

Öffne Deinen Google Tag Manager Server-Container und starte den Vorschau-Modus.

Rufe anschließend in einem zweiten Browser-Tab einen eindeutig erkennbaren Testpfad über die konfigurierte Server-URL auf. Bei einer klassischen Tracking-Domain beispielsweise:

https://collect.example.com/infrastructure-test?timestamp=20260908T120000

Bei einer Same-Origin-Konfiguration beispielsweise:

https://www.example.com/metrics/infrastructure-test?timestamp=20260908T120000

Der Zeitstempel oder ein anderer eindeutiger Wert hilft Dir dabei, die Testanfrage in der Vorschau wiederzufinden. Entscheidend ist, dass sie dort als eingehende Anfrage erscheint. Sie muss für diesen Test nicht von einem Client beansprucht werden.

Erscheint die Testanfrage in der Vorschau, hast Du nachgewiesen, dass der vorgesehene Tracking-Endpunkt die Anfrage zu diesem Zeitpunkt bis zur Vorschau des erwarteten Server-Containers weiterleitet. Damit sind die grundlegende Erreichbarkeit und das Routing geprüft.

Die Google-Dokumentation zum manuellen Setup liefert dafür die technische Referenz: Eine über die konfigurierte Server-URL gesendete Anfrage muss in der Vorschau erscheinen.

Der Test weist jedoch weder dauerhafte Verfügbarkeit noch Redundanz, Skalierung oder korrekt ausgelöste Tags nach. Auch zeitweise oder nur unter Last auftretende Infrastrukturprobleme lassen sich damit nicht ausschließen.

https://collect.example.com/healthy

https://www.example.com/metrics/healthy

curl -fsS 
  https://collect.example.com/healthy

curl -fsS 
  https://www.example.com/metrics/healthy

ok

Tracking-Domain

Fehlersuche bei einer Tracking-Domain

Eine Tracking-Domain wie collect.example.com ist unmittelbar mit dem Tagging-Server verbunden. Kann der Health-Endpoint nicht aufgerufen werden, prüfst Du nacheinander DNS, TLS und die Konfiguration des Tagging-Servers.

1. DNS-Auflösung der Tracking-Domain prüfen
2. TLS und Zertifikat der Tracking-Domain prüfen
3. Konfiguration des Tagging-Servers prüfen

DNS prüfen

Ist bereits der Health-Endpoint nicht erreichbar, solltest Du als Nächstes die Namensauflösung prüfen.

Zum Beispiel:

dig CNAME collect.example.com +short
dig A collect.example.com +short
dig AAAA collect.example.com +short

Wenn Du die Antwort verschiedener öffentlicher Resolver vergleichen möchtest:

dig @8.8.8.8 CNAME collect.example.com +short
dig @1.1.1.1 CNAME collect.example.com +short

Die entscheidende Frage ist:

Zeigt die Tracking-Domain auf das vorgesehene Ziel?

Gerade nach einer Änderung der DNS-Konfiguration kann es außerdem vorkommen, dass unterschiedliche Resolver noch unterschiedliche Ergebnisse liefern.

TLS und Zertifikat prüfen

Löst die Domain korrekt auf, funktioniert der HTTPS-Aufruf aber trotzdem nicht, solltest Du Dir als Nächstes die TLS-Verbindung ansehen.

• Ist das Zertifikat gültig?
• Passt es zur verwendeten Domain?
• Wird die Zertifikatskette korrekt ausgeliefert?

Häufig liefert bereits der Browser einen brauchbaren Hinweis darauf, ob hier ein Problem vorliegt.

Auf der Kommandozeile kannst Du zunächst den vollständigen HTTPS-Aufruf einschließlich TLS-Verbindungsaufbau anzeigen:

curl -v -o /dev/null 
  https://collect.example.com/healthy

Für eine genauere Prüfung von Hostname und Zertifikatskette:

openssl s_client 
  -connect collect.example.com:443 
  -servername collect.example.com 
  -verify_hostname collect.example.com 
  -verify_return_error 
  -showcerts </dev/null

Die Ausgabe sollte keine Verifizierungsfehler enthalten. -servername sorgt dafür, dass der Hostname beim TLS-Verbindungsaufbau per SNI übermittelt wird; -verify_hostname prüft, ob das Zertifikat zur Tracking-Domain passt.

Konfiguration des Tagging-Servers prüfen

Wenn die grundlegenden Verbindungstests keine eindeutige Ursache zeigen, solltest Du die Hosting-Konfiguration kontrollieren.

Bei ProxyRiders kannst Du beispielsweise direkt in der Anwendung prüfen:

• Ist die Konfiguration des Tagging-Servers korrekt?
• Ist am Tagging-Server die richtige Domain hinterlegt?
• Wird die Domain als verbunden angezeigt?

Antwortet der Health-Endpoint der Tracking-Domain erfolgreich, die eindeutige Testanfrage erscheint aber nicht in der Vorschau, solltest Du außerdem kontrollieren, ob im Server-Container genau diese Server-URL hinterlegt und für die Vorschau ausgewählt ist.

https://www.example.com/metrics/healthy

curl -sS -o /dev/null 
  -w 'Website: HTTP %{http_code}n' 
  https://www.example.com/

curl -fsS 
  https://www.example.com/metrics/healthy

Same-Origin

Routing / Reverse Proxy prüfen

Dieser Prüfschritt gehört ausschließlich zur Same-Origin-Konfiguration: Anfragen für den vorgesehenen Pfad müssen von der Website-Infrastruktur korrekt an den Tagging-Server weitergeleitet werden. Je nach technischem Aufbau übernimmt das eine Routing-Regel oder ein Reverse Proxy.

Prüfe insbesondere:

• Werden alle Anfragen unter dem vorgesehenen Pfad an den Tagging-Server weitergeleitet?
• Bleibt der benötigte Pfad erhalten beziehungsweise wird er wie vorgesehen umgeschrieben?
• Werden Query-Parameter, Cookies und benötigte Header weitergegeben?
• Wird die Antwort des Tagging-Servers unverändert an den Browser zurückgegeben?
• Greifen Weiterleitungen, Cache-Regeln oder Sicherheitsregeln in den Tracking-Pfad ein?

Mit curl -v kannst Du Statuscode, Weiterleitungen und den angesprochenen Pfad sichtbar machen. -o /dev/null unterdrückt dabei den Response-Body:

curl -v -o /dev/null 
  'https://www.example.com/metrics/infrastructure-test?timestamp=20260908T120000'

Dieser Kommandozeilenaufruf macht das von außen beobachtbare HTTP-Verhalten sichtbar und liefert Hinweise auf Routingfehler. Er ersetzt nicht den Aufruf im selben Browser, in dem die GTM-Vorschau läuft, weil die Zuordnung zur Vorschausitzung vom Browserkontext abhängt.

Server-URL der Vorschau überprüfen

Antwortet /metrics/healthy erfolgreich, die eindeutige Testanfrage erscheint aber nicht in der Vorschau, ist der Tagging-Server grundsätzlich über den Pfad erreichbar. Prüfe dann:

• Ist die vollständige Same-Origin-URL als Server-URL im GTM Server-Container hinterlegt?
• Wurde bei mehreren Server-URLs die richtige URL für die Vorschau ausgewählt?

Damit bleibt die Fehlergrenze klar: DNS und TLS erklären die grundsätzliche Erreichbarkeit. Das Routing unter dem Same-Origin-Pfad entscheidet, ob eine konkrete Anfrage beim Tagging-Server ankommt.