Is er iets kapot en weet je niet waarom, begin dan met onderzoek in plaats van een fix: zo pak je problemen oplossen en troubleshooten in CodeLynq aan. Een troubleshoot-sessie is een alleen-lezen debugchat: de agent bekijkt de code en, als je dat toestaat, een draaiend systeem - logs, een alleen-lezen database, commando's op een allowlist. Hij kan nooit iets wijzigen. Heeft hij de oorzaak gevonden, dan maak je van de diagnose een gewone fix-taak.
Een onderzoek starten
Dat kan op twee manieren:
- Maak een troubleshoot-taak aan. Kies in het volledige taakformulier het type Troubleshoot (zie Taken). Zo'n taak heeft een tabblad Onderzoek in plaats van een specificatie. Open dat tabblad.
- Vanuit elke taak. Open het tabblad Troubleshoot van de taak.
Daarna:
- Kies onder Onderzoek starten een Omgeving: Alleen code, geen live omgeving, of een van de gekoppelde omgevingen van het project. Je ziet wat de sessie dan kan.
- Klik op Onderzoek starten.
- Beschrijf bij Vraag wat er misgaat… wat er misgaat en klik op Versturen.
Het onderzoek volgen
De agent werkt stap voor stap en laat alles zien wat hij doet: elke Logs lezen, Database bevragen (met de SQL) en Commando uitvoeren kun je uitklappen om precies te zien wat er werd uitgevoerd en wat er terugkwam. Een verzoek buiten wat is toegestaan, staat er als geweigerd.
Terwijl hij bezig is zie je Nadenken… of Onderzoeken…. Stel vervolgvragen, deel wat jij weet of stuur hem een kant op - het is een gesprek.
Diagnose en fix
- Denk je dat er genoeg bekend is, klik dan op Diagnose stellen. De agent sluit af met een Diagnose van de oorzaak.
- Daaronder krijg je de vraag Er is een diagnose klaar. Er een fix-taak van maken? Klik op Fix-taak aanmaken.
- Klik op Openen om naar de nieuwe taak te gaan. Die volgt de gewone flow: specificatie, goedkeuring, run en pull request - zie De specificatie (TSD) en goedkeuring.
Een diagnose die klaar is, verschijnt ook in de Inbox, met Fix-taak aanmaken er direct bij.
Een omgeving koppelen
Zonder omgeving kan een sessie alleen de code lezen. Wil je dat hij naar een draaiend systeem kan kijken, koppel dan een omgeving aan het project. Daarvoor moet je beheerder van de organisatie of eigenaar van het project zijn.
- Open het project en ga naar Instellingen → Omgevingen.
- Klik op Omgeving toevoegen en geef een Naam, een Omgeving (bijvoorbeeld
production) en een Beschrijving van wat er draait en wat de agent moet weten. - Zet alleen de mogelijkheden aan die je wilt toestaan:
- Toegang tot code - kloon de repositories van het project in de sandbox van de sessie, zodat de agent ze kan lezen en doorzoeken.
- Logs / observability - logs lezen uit een HTTP-endpoint, Grafana Loki, Sentry of GitHub Actions.
- Alleen-lezen database - begrensde
SELECT-query's draaien. Gebruik een databaserol die alleen mag lezen; CodeLynq weigert ook alles wat geenSELECTis, maar de rechten van de rol zijn de garantie die telt. Je kunt het aantal rijen, de tijd per query en de zichtbare tabellen beperken. - Shell-commando's (allowlist) - alleen commando's uitvoeren die beginnen met een prefix die jij opgeeft, bijvoorbeeld
docker logs. Shell-operators worden geweigerd, en een lege lijst betekent dat er niets mag draaien.
- Sla de omgeving op. De kaart toont de mogelijkheden, en waarschuwt als er een aanstaat maar niet volledig is ingesteld.
Elke mogelijkheid staat los van de rest, dus je kunt op productie alleen logs openstellen en op staging meer. Vink Actief uit om een omgeving niet meer in sessies te gebruiken zonder hem te verwijderen.
Goed om te weten
- Alles is alleen-lezen. Een sessie kan niet naar je database schrijven, geen bestanden wijzigen en niet deployen.
- De agent toont elke query en elk commando, zodat je precies kunt nagaan waar hij naar heeft gekeken.
- Troubleshooten kan niet op je telefoon; gebruik daarvoor de webapp.
- Zie ook Alerts: binnenkomende monitoringalerts kunnen automatisch bugtaken openen.