Naar hoofdinhoud gaan
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:
FlagBeschrijving
--app <name>Applicatienaam (voeg --environment toe wanneer meer dan één app de naam deelt)
--environment <env>Omgeving, gebruikt met --app
--app-id <id>Het ID van de app (een lange hexadecimale string uit appsignal-cli apps list), in plaats van --app en --environment
--org <slug>Organisatie-slug (gebruikt uw standaard indien weggelaten)

​
Logs tailen

Stream logregels terwijl ze binnenkomen (de CLI poll elke seconde):
Shell
appsignal-cli logs tail --app "MyApp" --environment production

​
Logs doorzoeken

Doorzoek vorige logregels en print de matches. Bijvoorbeeld, vind recente error-level regels:
Shell
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:
FlagBeschrijving
--start <ISO8601>Starttijd, bijv. 2025-01-01T00:00:00Z
--end <ISO8601>Eindtijd
--limit <N>Maximaal aantal te retourneren regels (max 100, ook de standaard)
--order <ORDER>ASC (oudste eerst) of DESC (nieuwste eerst, de standaard)
--page-allHaal 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:
Shell
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:
FlagBeschrijving
--query <text>Logqueryfilter, met de querysyntax van AppSignal
--severities <list>Kommagescheiden severities, bijv. ERROR,CRITICAL
--source-ids <list>Kommagescheiden source-ID’s
--view <name-or-id>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:
Shell
appsignal-cli logs search --app "MyApp" --environment production \
  --view "Production errors" --severities CRITICAL

​
Querysyntax

De --query-flag gebruikt de log-querysyntax 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:
Shell
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:
Shell
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 <SOURCE_ID>
create en update delen deze flags (create vereist --name, --query en ten minste één --metric):
FlagBeschrijving
--name <name>Naam van de metric-configuratie
--query <text>Query die de te meten logregels matcht
--metric <def>Metric-definitie in key=value-vorm (herhaal voor meerdere), bijv. name=log.error_count,type=counter
--source-id <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.
FlagBeschrijving
--id <id>De metric die moet worden bijgewerkt, uit logs metrics list (vereist)
--clear-metricsVerwijder alle metric-definities
--clear-sourcesVerwijder 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:
Shell
appsignal-cli logs triggers create --app "MyApp" --environment production \
  --name "Root login" \
  --query "message:root" \
  --severity ERROR \
  --notifier-id <NOTIFIER_ID>
create en update delen deze flags (create vereist --name en --query):
FlagBeschrijving
--name <name>Triggernaam
--query <text>Query die de te waarschuwen logregels matcht
--severity <level>Match alleen deze severities (herhaal voor meer)
--notifier-id <id>Koppel een notifier (herhaal voor meer)
--source-id <id>Beperk tot een source-ID (herhaal voor meer)
--description <text>Trigger-beschrijving
update kan de volgende aanvullende flags accepteren. De --clear-*-flags maken velden leeg in plaats van ze bij te werken.
FlagBeschrijving
--id <id>De trigger die moet worden bijgewerkt, uit logs triggers list (vereist)
--clear-descriptionVerwijder de beschrijving
--clear-notifiersVerwijder alle notifiers
--clear-severitiesVerwijder alle severities
--clear-sourcesVerwijder alle source-scoping
delete accepteert alleen --id.
Dit zijn log-based triggers, opgebouwd uit logregels. Voor anomaly detection-triggers op metrics, zie Triggers.

​
Volgende stappen

Iets gevonden in de logs? Open de gerelateerde incidents of stel anomaly detection-triggers in.