;
};
Deze documentatie beschrijft hoe u logging configureert met de AppSignal for Elixir-integratie.
## Logging configureren
🔐 Stuur geen Persoonlijk Identificeerbare Informatie (PII) naar AppSignal. Filter PII (bijv. namen, e-mailadressen) uit logs en gebruik in plaats daarvan een ID, hash of gepseudonimiseerde identificator.
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).
U hoeft geen logbron aan te maken om logs te versturen vanuit de AppSignal for Elixir-integratie. Er wordt automatisch een "application"-logbron aangemaakt.
### Logger Handler
U kunt de Erlang `:logger` configureren om de `Appsignal.Logger.Handler`-module als handler te gebruiken, door de functie `Appsignal.Logger.Handler.add/2` aan te roepen in uw `Application.start/2`-callback:
```elixir Elixir theme={null}
@impl true
def start(_type, _args) do
Appsignal.Logger.Handler.add("phoenix")
end
```
Het meegegeven argument is de groepsnaam die beschrijft vanwaar u logt. Deze groepsnaam kan in AppSignal worden gebruikt om uw logs te filteren.
### Logger Backend
Vanaf Elixir-versie 1.15 worden Elixir logger-backends niet langer
aanbevolen. Zie de sectie [Logger Handler](#logger-handler) hierboven voor
het aanbevolen alternatief.
In plaats van een Elixir logger-handler te gebruiken, kunt u de Elixir logger-backend configureren om de `Appsignal.Logger.Backend`-module als backend te gebruiken door de onderstaande code in het bestand `config/runtime.exs` te plaatsen:
```elixir Elixir theme={null}
config :logger, backends: [:console, {Appsignal.Logger.Backend, [group: "phoenix"]}]
```
De optie `group` beschrijft vanwaar u logt. Deze groepsnaam kan in AppSignal worden gebruikt om uw logs te filteren.
U kunt de backend ook toevoegen met de functie `add_backend/2` in uw `Application.start/2`-callback:
```elixir Elixir theme={null}
@impl true
def start(_type, _args) do
Logger.add_backend(Appsignal.Logger.Backend, group: "phoenix")
end
```
### Elixir Logger
Om logs naar AppSignal te sturen zonder de Elixir Logger-backend te gebruiken, kunt u een van de logging-functies van `Appsignal.Logger` gebruiken en deze voorzien van een `groupname` die definieert vanwaar u logt. Bijvoorbeeld, als wij zouden loggen vanuit een helper voor het factureren van klanten:
```elixir Elixir theme={null}
Appsignal.Logger.info(
"invoice_helper",
"Generating invoice for customer 129"
)
```
## Gebruik
### Logs versturen
Net als de Elixir/Phoenix logger-klasse kunt u de severity-niveau van uw logs definiëren met `fatal`, `error`, `warning`, `info` en `debug`:
```elixir Elixir theme={null}
Appsignal.Logger.warning(
"app",
"Something's gone terribly wrong here"
)
```
U kunt aangepaste attributen als het laatste argument doorgeven om loginformatie te versturen die kan worden gebruikt bij het filteren en opvragen van logs:
```elixir Elixir theme={null}
Appsignal.Logger.info(
"invoice_helper",
"Generated invoice for customer #{customer.id}",
%{ customer_id: customer.id, invoice_id: invoice.id }
)
```
U kunt op berichtinhoud en attribuutwaarden filteren en opvragen met behulp van onze [zoeksyntaxis](/logging/query-syntax).
Eenmaal geconfigureerd, worden de gewenste attributen als log-tags naar AppSignal verstuurd en zijn ze opvraagbaar in de AppSignal logging-interface.
## Formaten
### Automatisch gedetecteerd formaat
Het AppSignal for Elixir-pakket detecteert het formaat van de logregel standaard automatisch als JSON, Logfmt of plaintext en parseert er attributen uit.
U hoeft het logformaat niet handmatig in te stellen, tenzij het niet correct wordt gedetecteerd.
[Laat het ons ook weten](mailto:support@appsignal.com?subject=Log%20format%20auto%20detection%20not%20working) als dit niet automatisch werkt.
```elixir Elixir theme={null}
# Plaintext format
Appsignal.Logger.info(
"invoice_helper",
"Generated invoice"
)
# Logfmt format
Appsignal.Logger.info(
"invoice_helper",
"Generated invoice invoice_id=A145 for customer customer_id=123"
)
# JSON format
Appsignal.Logger.info(
"invoice_helper",
~s({"message": "Generated invoice for customer", "invoice_id": "A145", "customer_id": "123"})
)
```
### Logfmt
De AppSignal Logger kan expliciet worden geconfigureerd om te verwachten dat de regel in Logfmt-formaat is en hier attributen uit te parsen.
Gebruik deze optie wanneer u een oudere versie van het AppSignal for Elixir-pakket gebruikt die geen [automatische formaatdetectie](#auto-detected-format) ondersteunt.
Het Logfmt-formaat kan worden opgegeven wanneer de AppSignal-logger wordt aangeroepen door de waarde `:logfmt` als het laatste argument toe te voegen.
```elixir Elixir theme={null}
Appsignal.Logger.info(
"invoice_helper",
"Generated invoice invoice_id=A145 for customer customer_id=123",
:logfmt
)
```
### JSON
De AppSignal Logger kan expliciet worden geconfigureerd om te verwachten dat de regel in JSON-formaat is en hier attributen uit te parsen.
Gebruik deze optie wanneer u een oudere versie van het AppSignal for Elixir-pakket gebruikt die geen [automatische formaatdetectie](#auto-detected-format) ondersteunt.
Het JSON-formaat kan worden opgegeven wanneer de AppSignal-logger wordt aangeroepen door de waarde `:json` als het laatste argument toe te voegen.
```elixir Elixir theme={null}
Appsignal.Logger.info(
"invoice_helper",
~s({"message": "Generated invoice for customer", "invoice_id": "A145", "customer_id": "123"}),
:json
)
```
Alleen primitieve niet-geneste waarden (getallen, strings, booleans en `null`) worden als log-attributen weergegeven. Alle andere attributen worden verwijderd.
## Logs filteren
U kunt [de configuratieoptie `ignore_logs`](/elixir/configuration/options#option-ignore_logs) gebruiken om logregels op basis van hun bericht te negeren. Zie [onze gids Logs negeren](/guides/filter-data/ignore-logs) voor meer informatie.
## Hulp nodig?
Nadat u uw Elixir-applicatie hebt geconfigureerd om logs te versturen, zouden er logs in AppSignal moeten verschijnen. Als u twijfelt over deze stap of AppSignal geen logs ontvangt, kunt u altijd [contact opnemen](mailto:support@appsignal.com) voor hulp. Wij helpen u graag weer op weg!