Traceer verbindingsproblemen met Collabora met behulp van coolwsd-logbestanden.

Voor een Collabora Online Development Edition (CODE)-container verhoogt u coolwsdde logging naar debug, zorgt u ervoor dat de Socketen WebSocketgebieden niet zijn uitgeschakeld en reproduceert u vervolgens een mislukte documentopening terwijl u de containerlogs volgt. Geef in Docker Compose de instellingen door via de extra_paramsomgevingsvariabele van de CODE-image en maak de service opnieuw aan. Gebruik deze optie tracealleen als de debug-uitvoer niet laat zien waar de verbinding stopt, en keer terug naar het vorige niveau wanneer u klaar bent.

Deze methode is geschikt voor een Docker- of Compose-implementatie waarbij u de containerconfiguratie kunt bijwerken. Een native pakketinstallatie gebruikt /etc/coolwsd/coolwsd.xmlin plaats daarvan de bijbehorende servicemanager. De instelling voegt diagnostische details toe; het lost geen proxy-, WOPI-host-, certificaat- of netwerkproblemen op.

1. Begin met één gecontroleerde reproductie.

Kies één document en noteer het tijdstip waarop u het probeert te openen, de openbare Collabora-URL en de naam van de container of de Compose-service. Vermijd het herhaaldelijk vernieuwen van meerdere bestanden: één poging maakt het gemakkelijker om de browsersymptomen, proxylogboeken, integratieserverlogboeken en coolwsd-vermeldingen op elkaar af te stemmen.

Controleer of de container actief is en achterhaal de naam ervan:

docker ps --format 'table {.Names}	{.Status}	{.Ports}'

Vervang collaboraonderstaande tekst door de containernaam die op uw host wordt weergegeven. Start de volgende uitvoer kort voordat het probleem zich voordoet:

docker logs --since 2m --follow --timestamps collabora

--followstreamt nieuwe uitvoer, --sincebeperkt de initiële geschiedenis en --timestampsvoegt Docker-tijdstempels toe. Docker documenteert deze opties in de referentie voor containerlogboeken . In Compose kunt u gebruiken docker compose logs --since=2m --follow collabora, waarbij collaborade servicesleutel is.

2. Verhoog de status van coolwsd naar de debugmodus voor de test.

Het configuratieschema van Collabora ondersteunt benoemde niveaus, waaronder warning, notice, information, debug, en trace. Het definieert ook ; de gedocumenteerde standaardinstelling schakelt onder andere disabled_areasde gedetailleerde uitvoer van Socketen uit. Dit is belangrijk voor het oplossen van verbindingsproblemen: het wijzigen van alleen het niveau kan er nog steeds voor zorgen dat de meest nuttige handshake-details worden onderdrukt. Deze opties worden beschreven in de Collabora coolwsd-configuratiesjabloon en de Collabora Online SDK-handleiding (sectie Docker-configuratie; gecontroleerd in oktober 2026).WebSocket

Voor de officiële collabora/codeimage voegt u de twee opties toe aan de bestaande waarde van de service extra_params. Behoud alle opties die al vereist zijn voor uw installatie, zoals SSL-terminatie of servernaam:

services:
  collabora:
    environment:
      extra_params: "--o:logging.level=debug --o:logging.disabled_areas=Admin,Pixel"

De tweede optie laat Socketen WebSocketbeschikbaar voor logboekregistratie met hoge detailgraad, terwijl Adminen Pixeluitgeschakeld blijven. Voeg deze twee gebieden tijdens deze test niet opnieuw toe aan de lijst met uitgeschakelde gebieden. De CODE-image-documentatie beschrijft extra_paramsals een manier om opdrachtregelopties aan coolwsd door te geven. Als uw implementatie gebruikmaakt van een gekoppeld configuratiebestand of een door de leverancier beheerde image, volg dan in plaats daarvan de configuratiemethode van die implementatie.

Pas de Compose-bewerking toe door de service opnieuw aan te maken:

docker compose up -d --force-recreate collabora

Gebruik de daadwerkelijke naam van uw Compose-service. Voor een kortstondige container die is gestart met docker run, moet u de uitvoeringsconfiguratie bijwerken en de container opnieuw aanmaken met dezelfde volumes, netwerken, poorten en andere opties. De CODE-handleiding zegt dat de image extra_paramsbij het opstarten accepteert; ga er niet vanuit dat het wijzigen van de omgeving van een reeds aangemaakte container het draaiende coolwsd-proces wijzigt.

3. Lees het verband in de juiste volgorde.

Reproduceer de fout eenmaal en analyseer alleen dat tijdsinterval. Zoek in de uitvoer naar termen zoals WebSocket, WOPI, ERR, en WRN, en vergelijk vervolgens de tijdstempels. De exacte formulering en loggebieden variëren per Collabora-versie, dus beschouw deze als categorieën om te inspecteren in plaats van gegarandeerde letterlijke berichten.

• Geen nieuwe coolwsd-vermeldingen op het moment van de test: het verzoek bereikt deze container mogelijk niet. Controleer de geconfigureerde openbare URL, DNS, load balancer, toegangs-/foutlogboeken van de reverse proxy en of u de juiste replica volgt.
• De browser bereikt de service, maar de WebSocket blijft niet open: controleer de afhandeling door de proxy van de WebSocket-upgrade, de doorgestuurde host en het schema, de TLS-beëindiging, de padroutering en de inactiviteitstime-outs. Vergelijk dit met de ontwikkelaarsconsole van de browser en de proxylogboeken; coolwsd kan een verzoek dat de proxy nooit doorstuurt niet verklaren.
• Er verschijnt een WOPI-verzoek dat mislukt: controleer de WOPI-URL van de integratieserver, de whitelist of aliasconfiguratie van de host, de bereikbaarheid vanuit de Collabora-container en het antwoord van de integratieserver. Een WOPI-fout is een aparte fase van de WebSocket-verbinding tussen de browser en Collabora.
• WOPI slaagt erin, maar de browser verbreekt nog steeds de verbinding: richt je vervolgens op de WebSocket-route en verbindingsfouten aan de browserzijde. Deze stappen verkleinen de zoektocht; ze bewijzen niet welke proxy- of netwerkinstelling onjuist is.

Als Docker geen uitvoer weergeeft, terwijl de service actief is, controleer dan de logboekconfiguratie in de container. Het `log`-commando van Docker leest de standaarduitvoer en foutstreams van de container; een installatie die is geconfigureerd om naar een bestand te schrijven, gebruikt mogelijk in plaats daarvan een pad zoals `/usr/log/` /var/log/coolwsd.log, zoals gedefinieerd in de configuratie. Controleer het daadwerkelijke bestand in plaats van uit te gaan van dat pad:

docker exec collabora sh -c 'grep -n -A25 "<logging>" /etc/coolwsd/coolwsd.xml'

Als bestandslogboekregistratie is ingeschakeld, gebruik dan het geconfigureerde pad, bijvoorbeeld:

docker exec collabora sh -c 'tail -n 200 /var/log/coolwsd.log'

4. Controleer het resultaat en herstel de normale logboekregistratie.

Voer na de test een begrensde leesbewerking uit om te bevestigen dat de beoogde poging nieuwe gegevens heeft opgeleverd:

docker logs --since 5m --timestamps collabora

Je hebt een nuttig resultaat als je de mislukte open-poging kunt koppelen aan een coolwsd-gebeurtenis of kunt vaststellen dat het verzoek deze container nooit heeft bereikt. Vervolgens kun je bepalen welke verbindingsfase vervolgactie vereist. Als je de uitvoer wilt filteren, gebruik dan eerst een kort tijdsvenster.

docker logs --since 5m collabora | grep -Ei 'coolwsd|WOPI|WebSocket|ERR|WRN'

Herstel de vorige waarden logging.levelen disabled_areasmaak de service vervolgens opnieuw aan. Debug- en traceerniveaus kunnen veel meer uitvoer genereren en gevoelige operationele details bevatten. Voordat u logbestanden deelt, dient u toegangstokens, documentnamen, gebruikers-ID's, hostnamen en interne adressen te anonimiseren. Als de service niet de officiële CODE-image is, dient u het configuratiepad en de ondersteunde parameters te bevestigen met de beheerder van die image.