> ## 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.
# AppSignal voor Ruby laadvolgorde
De AppSignal Ruby gem kan op verschillende manieren worden geconfigureerd. Via een
initializer, met een configuratiebestand of via omgevingsvariabelen.
In Ruby gem versie 2.0 is de laadvolgorde gewijzigd! Stap 4 en 5 zijn omgewisseld,
zodat omgevingsvariabelen worden geladen na het
`appsignal.yml`-configuratiebestand. Lees er meer over in de [Pull Request op
GitHub](https://github.com/appsignal/appsignal-ruby/pull/180).
De configuratie wordt geladen in een proces met vijf stappen. Beginnend met de
standaardwaarden van de gem en eindigend met het lezen van omgevingsvariabelen. De configuratie-
opties kunnen worden gecombineerd zonder configuratie van een andere optie te verliezen.
Een initializer, een configuratiebestand en omgevingsvariabelen samen gebruiken
werkt prima.
## Configuratiebronnen
* 1. [Gem-standaardwaarden - `default`](#1-gem-defaults)
* 2. [Door het systeem gedetecteerde instellingen - `system`](#2-system-detected-settings)
* 3. [Initiële configuratie - `initial`](#3-initial-configuration-given-to-config-initializer)
* 4. [`appsignal.yml` config-bestand - `file`](#4-appsignalyml-config-file)
* 5. [Omgevingsvariabelen - `env`](#5-environment-variables)
* 6. [`appsignal.rb` config-bestand - `dsl`](#appsignal-rb-config-file)
* 7. [`Appsignal.configure` - `dsl`](#appsignal-configure-helper)
## 1. Gem-standaardwaarden
De AppSignal gem begint met het laden van de standaardconfiguratie, het instellen van paden
en het inschakelen van bepaalde functies.
De agent-standaardwaarden zijn te vinden in de [gem-broncode](https://github.com/appsignal/appsignal-ruby/blob/main/lib/appsignal/config.rb)
als `Appsignal::Config::DEFAULT_CONFIG`.
Deze bron staat vermeld als `default` in de uitvoer van [diagnose](/ruby/command-line/diagnose).
## 2. Door het systeem gedetecteerde instellingen
De gem detecteert op wat voor systeem hij draait en configureert zichzelf
dienovereenkomstig.
Bijvoorbeeld, wanneer hij draait in een op containers gebaseerd systeem (zoals Docker
en Heroku) zet hij de configuratieoptie `:running_in_container` op `true`.
Deze bron staat vermeld als `system` in de uitvoer van [diagnose](/ruby/command-line/diagnose).
## 3. Initiële configuratie meegegeven aan de `Config`-initializer
Deze configuratiemethode is verouderd sinds Ruby gem 3.12 en verwijderd in Ruby gem 4.0.0 ten gunste van [`Appsignal.configure`](#appsignal-configure-helper).
Bij het handmatig aanmaken van een `Appsignal::Config`-klasse kunt u de
initiële configuratie meegeven die u wilt toepassen. Dit is een hash van een van de
hieronder beschreven opties.
```ruby Ruby theme={null}
Appsignal.config = Appsignal::Config.new(Dir.pwd, "production", {
active: true,
name: "My app!",
push_api_key: "e55f8e96-62df-4817-b672-d10c8d924065"
})
```
Deze stap overschrijft alle opgegeven opties uit de standaardwaarden of door het systeem
gedetecteerde configuratie.
Deze bron staat vermeld als `initial` in de uitvoer van [diagnose](/ruby/command-line/diagnose).
## 4. `appsignal.yml` config-bestand
Deze configuratiemethode wordt verwijderd in de volgende major-versie van de Ruby gem.
We raden aan in plaats daarvan het [`appsignal.rb` config-bestand](#6-appsignal-dsl) te gebruiken.
Een manier om uw applicatie te configureren is met behulp van het `appsignal.yml`-bestand.
Wanneer u het `appsignal install`-commando gebruikt, maakt de gem er een voor u aan.
Het pad van dit configuratiebestand is `{project_root}/config/appsignal.yml`.
Deze stap overschrijft alle opgegeven opties uit de standaardwaarden, door het systeem
gedetecteerde en initializer-configuratie.
Lees de documentatie over [het `appsignal.yml` config-bestand](/ruby/configuration#yaml-configuration-file) voor meer informatie over hoe deze configuratiemethode werkt.
Deze bron staat vermeld als `file` in de uitvoer van [diagnose](/ruby/command-line/diagnose).
## 5. Omgevingsvariabelen
AppSignal zoekt zijn configuratie in omgevingsvariabelen.
Wanneer deze gevonden worden, overschrijven ze alle opgegeven configuratieopties uit
eerdere stappen.
```bash Bash theme={null}
export APPSIGNAL_APP_NAME="my custom app name"
# start your app here
```
Lees de documentatie over [systeem-omgevingsvariabelen](/ruby/configuration#system-environment-variables) voor meer informatie over hoe deze configuratiemethode werkt.
Deze bron staat vermeld als `env` in de uitvoer van [diagnose](/ruby/command-line/diagnose).
## 6. `appsignal.rb` config-bestand {/* id: appsignal-rb-config-file */}
Een manier om uw applicatie te configureren is met behulp van het `appsignal.rb`-bestand.
Het pad van dit configuratiebestand is `{project_root}/config/appsignal.rb`.
Dit laadpad kan niet worden aangepast.
Deze stap overschrijft alle opgegeven opties uit de standaardwaarden, door het systeem gedetecteerde en omgevingsvariabelen.
Als zowel een [`appsignal.yml` config-bestand](#4-appsignalyml-config-file) als een `appsignal.rb` config-bestand aanwezig zijn, wordt alleen het `appsignal.rb` config-bestand geladen.
Lees de documentatie over [het `appsignal.rb` config-bestand](/ruby/configuration#ruby-configuration-file) voor meer informatie over hoe deze configuratiemethode werkt.
Deze bron staat vermeld als `dsl` in de uitvoer van [diagnose](/ruby/command-line/diagnose).
## 7. Appsignal.configure helper {/* id: configure-helper */}
In versies 3 en 4 van de Ruby gem laadt het aanroepen van de `Appsignal.configure` helper ook het `appsignal.yml`-bestand, indien aanwezig.
Dit gedrag wordt *verwijderd* in de volgende major-versie van de Ruby gem.
Gebruik alleen het [`appsignal.rb` config-bestand](#appsignal-rb-config-file) of de [`Appsignal.configure` helper](#configure-helper).
Tot slot kan de Ruby gem worden geconfigureerd met de `Appsignal.configure` helper in de applicatie.
Wanneer aangeroepen, overschrijven alle configuratieopties die met deze helper zijn geconfigureerd alle opgegeven configuratieopties uit eerdere bronnen.
Als er ook een `config/appsignal.rb` config-bestand in het project aanwezig is, wordt het **niet geladen** als de `Appsignal.configure` helper eerst in uw applicatie wordt aangeroepen.
Lees de documentatie over [de `Appsignal.configure` helper](/ruby/configuration#appsignalconfigure-helper) voor meer informatie over hoe deze configuratiemethode werkt.
Deze bron staat vermeld als `dsl` in de uitvoer van [diagnose](/ruby/command-line/diagnose).