> ## Documentation Index > Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt > Use this file to discover all available pages before exploring further. # Logs > Tail en doorzoek applicatielogs vanuit de terminal, en beheer log-derived metrics en log-based triggers. Het `logs`-commando brengt uw applicatielogs naar de terminal: tail ze terwijl ze binnenkomen, doorzoek over een tijdsbereik en beheer de log-derived metrics en log-based triggers die ervan zijn opgebouwd. ## Gemeenschappelijke opties Elk `logs`-commando identificeert één applicatie en gebruikt uw standaardorganisatie tenzij u anders aangeeft: | Flag | Beschrijving | | --------------------- | ------------------------------------------------------------------------------------------------------------------------- | | `--app ` | Applicatienaam (voeg `--environment` toe wanneer meer dan één app de naam deelt) | | `--environment ` | Omgeving, gebruikt met `--app` | | `--app-id ` | Het ID van de app (een lange hexadecimale string uit `appsignal-cli apps list`), in plaats van `--app` en `--environment` | | `--org ` | Organisatie-slug (gebruikt uw standaard indien weggelaten) | ## Logs tailen Stream logregels terwijl ze binnenkomen (de CLI poll elke seconde): ```sh Shell theme={null} appsignal-cli logs tail --app "MyApp" --environment production ``` ## Logs doorzoeken Doorzoek vorige logregels en print de matches. Bijvoorbeeld, vind recente error-level regels: ```sh Shell theme={null} appsignal-cli logs search --app "MyApp" --environment production --query "severity:error" ``` Standaard retourneert `search` maximaal 100 van de meest recente matches. Bovenop de gemeenschappelijke opties en filters voegt het toe: | Flag | Beschrijving | | ------------------- | ----------------------------------------------------------------------------------------------- | | `--start ` | Starttijd, bijv. `2025-01-01T00:00:00Z` | | `--end ` | Eindtijd | | `--limit ` | Maximaal aantal te retourneren regels (max 100, ook de standaard) | | `--order ` | `ASC` (oudste eerst) of `DESC` (nieuwste eerst, de standaard) | | `--page-all` | Haal elke matchende regel in het bereik op. Vereist `--start` en negeert `--limit` en `--order` | Om elke regel in een venster op te halen als JSON, voor een script of agent: ```sh Shell theme={null} appsignal-cli --output json logs search --app "MyApp" --environment production \ --start "2025-01-01T00:00:00Z" --query "severity:error" --page-all ``` ## Filters `tail` en `search` delen deze filters: | Flag | Beschrijving | | --------------------- | ------------------------------------------------------------------------- | | `--query ` | Logqueryfilter, met de [querysyntax](/logging/query-syntax) van AppSignal | | `--severities ` | Kommagescheiden severities, bijv. `ERROR,CRITICAL` | | `--source-ids ` | Kommagescheiden source-ID's | | `--view ` | Pas de filters van een opgeslagen logweergave toe als standaarden | Som de beschikbare weergaven voor een app op met `appsignal-cli logs views`, en geef er één mee aan `--view` op naam of ID. Eventuele andere filters die u toevoegt, overschrijven de opgeslagen standaarden van de weergave. Bijvoorbeeld, pas een weergave toe maar beperk deze tot kritieke regels: ```sh Shell theme={null} appsignal-cli logs search --app "MyApp" --environment production \ --view "Production errors" --severities CRITICAL ``` ### Querysyntax De `--query`-flag gebruikt de [log-querysyntax](/logging/query-syntax) van AppSignal. Veelvoorkomende patronen: * `severity=error`: exacte veldovereenkomst * `message:timeout`: bericht bevat "timeout" * `group=notifiers`: exacte groepovereenkomst * `hostname:web-1`: hostname bevat "web-1" * Spatiegescheiden termen worden gecombineerd met `AND`; gebruik `OR` voor alternatieven Vierkante haken hebben een speciale betekenis in de parser, dus quote ze om ze letterlijk te matchen: `message:"[Email]"`. ## Opgeslagen weergaven en bronnen Som de opgeslagen logweergaven (filter-presets) en logbronnen van een app op: ```sh Shell theme={null} appsignal-cli logs views --app "MyApp" --environment production appsignal-cli logs sources --app "MyApp" --environment production ``` Geef de naam of het ID van een weergave mee aan `--view` en het ID van een bron aan `--source-ids`. ## Log-derived metrics `logs metrics` zet matchende logregels om in metrics, met `list`, `create`, `update` en `delete`: ```sh Shell theme={null} appsignal-cli logs metrics create --app "MyApp" --environment production \ --name "Checkout latency" \ --query "group:checkout" \ --metric "name=log.checkout_duration_ms,type=distribution,field=duration_ms" \ --source-id ``` `create` en `update` delen deze flags (`create` vereist `--name`, `--query` en ten minste één `--metric`): | Flag | Beschrijving | | ------------------ | ------------------------------------------------------------------------------------------------------- | | `--name ` | Naam van de metric-configuratie | | `--query ` | Query die de te meten logregels matcht | | `--metric ` | Metric-definitie in `key=value`-vorm (herhaal voor meerdere), bijv. `name=log.error_count,type=counter` | | `--source-id ` | Beperk tot een source-ID (herhaal voor meer) | `update` kan de volgende aanvullende flags accepteren. De `--clear-*`-flags maken velden leeg in plaats van ze bij te werken. | Flag | Beschrijving | | ----------------- | ----------------------------------------------------------------------- | | `--id ` | De metric die moet worden bijgewerkt, uit `logs metrics list` (vereist) | | `--clear-metrics` | Verwijder alle metric-definities | | `--clear-sources` | Verwijder alle source-scoping | `delete` accepteert alleen `--id`. Een log-derived metric begint pas met het verzamelen van gegevens zodra deze is gescoped naar een logbron, dus geef `--source-id` mee (vind ID's met `appsignal-cli logs sources`). De CLI kan het severity-filter van een metric niet instellen; als uw metric er één nodig heeft, stel dan het Severity-veld in in de AppSignal-app-UI nadat u deze heeft aangemaakt. ## Log-based triggers `logs triggers` waarschuwt bij matchende logregels, met `list`, `create`, `update` en `delete`: ```sh Shell theme={null} appsignal-cli logs triggers create --app "MyApp" --environment production \ --name "Root login" \ --query "message:root" \ --severity ERROR \ --notifier-id ``` `create` en `update` delen deze flags (`create` vereist `--name` en `--query`): | Flag | Beschrijving | | ---------------------- | ------------------------------------------------ | | `--name ` | Triggernaam | | `--query ` | Query die de te waarschuwen logregels matcht | | `--severity ` | Match alleen deze severities (herhaal voor meer) | | `--notifier-id ` | Koppel een notifier (herhaal voor meer) | | `--source-id ` | Beperk tot een source-ID (herhaal voor meer) | | `--description ` | Trigger-beschrijving | `update` kan de volgende aanvullende flags accepteren. De `--clear-*`-flags maken velden leeg in plaats van ze bij te werken. | Flag | Beschrijving | | --------------------- | ------------------------------------------------------------------------- | | `--id ` | De trigger die moet worden bijgewerkt, uit `logs triggers list` (vereist) | | `--clear-description` | Verwijder de beschrijving | | `--clear-notifiers` | Verwijder alle notifiers | | `--clear-severities` | Verwijder alle severities | | `--clear-sources` | Verwijder alle source-scoping | `delete` accepteert alleen `--id`. Dit zijn log-based triggers, opgebouwd uit logregels. Voor anomaly detection-triggers op metrics, zie [Triggers](/cli/triggers). ## Volgende stappen Iets gevonden in de logs? Open de gerelateerde [incidents](/cli/incidents) of stel [anomaly detection-triggers](/cli/triggers) in.