> ## 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.

# HTTP-JSON configuratie

<Warning>
  🔐 Stuur geen <strong>Persoonlijk Identificeerbare Informatie (PII)</strong> naar AppSignal. Filter PII (bijv. namen, e-mailadressen) uit logs en gebruik in plaats daarvan een ID, hash of gepseudonimiseerde identificator. <br /> <br /> Voor **onder HIPAA vallende entiteiten** vindt u meer informatie over het ondertekenen van een Business Associate Agreement (BAA) in onze [documentatie over Business Add-Ons](/support/business-add-ons).
</Warning>

## Endpoint

U kunt logs naar AppSignal `POST`-en. Uw logs moeten geformatteerd zijn in [`NDJSON`](#ndjson) en naar het volgende endpoint worden gestuurd:

<CodeGroup>
  ```shell Shell theme={null}
  https://appsignal-endpoint.net/logs/json?api_key=YOUR_LOG_SOURCE_API_KEY
  ```
</CodeGroup>

## NDJSON

Ons HTTP-JSON-endpoint verwacht dat de logs in een `NDJSON`-formaat naar ons endpoint worden gestuurd.
`NDJSON` staat voor Newline Delimited JSON, wat betekent dat elke logregel zijn eigen JSON-object is, bijvoorbeeld:

<CodeGroup>
  ```shell Shell theme={null}
  {"timestamp": "2022-06-02T04:17:25.783Z", "message": "foo", [...]}
  {"timestamp": "2022-06-02T04:17:26.000Z", "message": "bar", [...]}
  ```
</CodeGroup>

### Vereiste gegevens

Hieronder staat een voorbeeld van een (verfraaid) `NDJSON`-bericht. U kunt meer lezen over de gegevens die AppSignal vereist in de sectie [Vereiste velden](#required-fields).

#### Voorbeeldbericht

<Warning>
  **Waarschuwing:** Dit is geformatteerd met nieuwe regels voor de
  leesbaarheid. Uw client **moet** de logregel als één regel versturen, zonder
  nieuwe regels.
</Warning>

<CodeGroup>
  ```json JSON theme={null}
  {
    "timestamp": "2022-06-02T04:17:25.783Z",
    "group": "organisations",
    "severity": "warn",
    "message": "This is a test message",
    "hostname": "frontend1",
    "attributes": {
      "org": "appsignal",
      "step": 1,
      "seen_terms": true,
      "entries": 10.01
    }
  }
  ```
</CodeGroup>

#### Vereiste velden

<Warning>
  AppSignal zal stilzwijgend elk bericht negeren dat niet de hieronder vereiste
  velden of onjuiste waarden bevat.
</Warning>

De `NDJSON`-payload die u naar AppSignal stuurt, moet de volgende velden bevatten:

#### timestamp

Een `RFC 3339`-geformatteerde tijdstempel met een nanoseconde-precisie van 3 cijfers.

```yaml YAML theme={null}
YYYY-MM-DDThh:mm:ss.sss
2022-01-12T07:20:50.520Z
```

#### group

String van één woord waarmee de gebruiker logregels op een bepaalde context kan scheiden (bijv. logs voor een specifiek deel van uw applicatie, group kan "admin", "payments", "database" of "background" zijn).

#### severity

Het severity-veld accepteert de volgende waarden: `unknown`, `trace`, `debug`, `info`, `notice`, `warn`, `error`, `critical`, `alert` en `fatal`.

#### message

`Plaintext`-bericht.

#### hostname

Hostname van de server die het bericht verstuurt.

#### Optionele velden

De volgende velden zijn optioneel maar worden aanbevolen voor rijkere loggegevens:

#### attributes

Attributen die kunnen worden gebruikt om het bericht te filteren of doorzoeken, met de volgende regels:

* Attributen kunnen niet genest zijn of arrays bevatten
* De maximale sleutelgrootte is `50` tekens
* Het maximale aantal attributen is `100`
* De volgende primitieven worden als waarden geaccepteerd:
  * String: idealiter gebruikt als "tags", bijv. waarden van één woord, met een maximum van `100` tekens
  * Integer: `10`
  * Double: `0.01`
  * Boolean: `true`/`false`

#### format

Overschrijft het geconfigureerde formaat van de logbron bij het parsen van het `message`. Accepteert `plaintext`, `logfmt`, `json` of `autodetect`; onbekende waarden worden genegeerd.