Naar hoofdinhoud gaan
Deze pagina beschrijft onze nieuwste querysyntaxis. Voor de syntaxis met attributes, zie onze verouderde querysyntaxis
Het logfiltersysteem van AppSignal stelt u in staat te zoeken en te filteren in de logs van uw applicatie met behulp van een intuïtieve querysyntaxis. Of u nu specifieke foutmeldingen wilt vinden, op ernstniveau wilt filteren of door aangepaste attributen wilt zoeken: onze querytaal maakt het eenvoudig om precies te vinden wat u zoekt. Schermafbeelding van uitgeklapte log

Snel aan de slag

Ga aan de slag met deze eenvoudige query’s:
timeout
Zoekt naar “timeout” in het message-veld.
severity=error
Vindt alle logs op error-niveau.
severity=error hostname=production-web-1
Vindt fouten van een specifieke server.

Beschikbare velden

U kunt de volgende velden in uw logs bevragen:
VeldBeschrijvingVoorbeeld
severityLogniveau (error, warning, info, debug, trace)severity=error
hostnameApplicatiehosthostname=production-1
groupNamespace gedefinieerd voor uw applicatiegroup="background jobs"
messageInhoud van het logberichtmessage:timeout
Aangepaste attributenElk aangepast attribuut gedefinieerd in uw logsduration>10.1
Als geen veld wordt opgegeven, zoekt de query in het message-veld.

Query-operatoren

Zoekoperatoren

OperatorSyntaxisBeschrijvingVoorbeeld
:field:valueBevat waardemessage:error
!:field!:valueBevat geen waardehostname!:test
=field=valueExacte overeenkomstseverity=error
!=field!=valueNiet gelijk aansource!=mongodb
Gebruik aanhalingstekens voor waarden met spaties: group:"background jobs"

Vergelijkingsoperatoren

Voor numerieke waarden:
OperatorSyntaxisBeschrijvingVoorbeeld
>attribute>valueGroter danduration>100
<attribute<valueKleiner danuser_id<1000
>=attribute>=valueGroter dan of gelijk aanduration>=100
<=attribute<=valueKleiner dan of gelijk aanuser_id<=1000

Geneste attributen

We gebruiken de volgende voorbeeld-JSON-structuur:
{
  "message": "User logged in",
  "group": "admin",
  "hostname": "production-1",
  "user": {
    "id": 123,
    "name": "John Doe",
    "emails": ["john@example.com", "john@work.com"],
    "location.country": "US"
  }
}
Bevraag geneste JSON-attributen met puntnotatie:
user.id=123
Toegang tot eigenschappen van geneste objecten.
user.emails.0=john@example.com
Bevraag array-elementen op index (zero-based).
user.location\.country=US
Escape punten die deel uitmaken van de veldnaam zelf met een backslash.

Query’s combineren

AND-logica (standaard)

Query’s gescheiden door spaties worden gecombineerd met AND:
severity=error hostname=production-1
Vindt fouten van production-1.

OR-logica

Gebruik OR om aan een van beide voorwaarden te voldoen:
severity=error OR severity=warning
Vindt fouten of waarschuwingen.

Groeperen met haakjes

Gebruik haakjes voor complexe query’s:
severity=error AND (hostname=web-1 OR hostname=web-2)
Vindt fouten van web-1 of web-2.