Configuratieopties van het Elixir-pakket

De onderstaande lijst bevat alle configuratieopties met de naam van de omgevingsvariabele en de naam van de sleutel in het configuratiebestand. Voor meer informatie over hoe u AppSignal configureert met een configuratiebestand of systeemomgevingsvariabelen, zie ons onderwerp Configuratie.

Beschikbare opties

Vereiste opties
- active
- env
- name
- otp_app
- push_api_key
Opties

active

Veld	Waarde
Configuratiebestand-sleutel	`active`
Systeemomgevingsvariabele	`APPSIGNAL_ACTIVE`
Vereist	ja
Type	Boolean (`true` / `false`)
Standaardwaarde	`false` / gedetecteerd door systeem
Beschikbaar sinds versie	`0.1.0`

Beschrijving

Opmerking: Wanneer de omgevingsvariabele APPSIGNAL_PUSH_API_KEY is ingesteld, is de standaardwaarde true. Dit kan worden overschreven door de systeemomgevingsvariabele APPSIGNAL_ACTIVE op false te zetten: APPSIGNAL_ACTIVE=false.

Configureer of AppSignal actief is of niet voor een bepaalde omgeving. Wordt meestal gebruikt in de bestandsconfiguratie per omgeving.

env

Veld	Waarde
Configuratiebestand-sleutel	`env`
Systeemomgevingsvariabele	`APPSIGNAL_APP_ENV`
Vereist	ja
Type	`Atom`
Standaardwaarde	`dev`
Beschikbaar sinds versie	`0.1.0`
	`0.9.2`: De naam van de omgevingsvariabele voor deze configuratie-optie is hernoemd van `APPSIGNAL_ENVIRONMENT` naar `APPSIGNAL_APP_ENV`.

Beschrijving

De omgeving van de app die aan AppSignal wordt gerapporteerd. Deze optie wordt standaard door onze installer ingesteld op Mix.env. Om dit te overschrijven, wijzigt u de waarde in config/appsignal.exs (of het configuratiebestand van uw keuze).

Elixir

# config/appsignal.exs
# or config/config.exs
config :appsignal, :config,
  env: Mix.env # Installer default

# Set your own value
config :appsignal, :config,
  env: :staging

Om de configuratie-optie in de systeemomgeving te overschrijven, gebruikt u de omgevingsvariabele APPSIGNAL_APP_ENV.

Shell

# The method of setting environment variables may differ on your system
export APPSIGNAL_APP_ENV=staging
mix run

De omgevingsvariabele-optie wordt vaak gebruikt op platforms, zoals Heroku, waar apps standaard in de production-omgeving draaien. Deze instelling maakt het mogelijk om de omgeving bijvoorbeeld op staging te zetten.

Shell

heroku config:set APPSIGNAL_APP_ENV=staging

Opmerking: Het wijzigen van de naam of omgeving van een bestaande app zal een nieuwe app aanmaken op AppSignal.com.

name

Veld	Waarde
Sleutel in configuratiebestand	`name`
Sleutel in systeemomgeving	`APPSIGNAL_APP_NAME`
Vereist	ja
Type	`String`
Standaardwaarde	nil (Standaard niet ingesteld)

Beschrijving

Naam van uw applicatie zoals deze op AppSignal.com moet worden weergegeven.

Opmerking: Het wijzigen van de naam of environment van een bestaande app maakt een nieuwe app aan op AppSignal.com.

otp_app

Veld	Waarde
Sleutel in configuratiebestand	`otp_app`
Sleutel in systeemomgeving	`APPSIGNAL_OTP_APP`
Vereist	ja
Type	`Atom`
Standaardwaarde	nil (Standaard niet ingesteld)
Beschikbaar vanaf versie	`2.0.0`

Beschrijving

De OTP-app-naam van uw applicatie, die wordt gebruikt voor automatische configuratie van instrumentatie voor libraries zoals Ecto.

push_api_key

Veld	Waarde
Sleutel in configuratiebestand	`push_api_key`
Sleutel in systeemomgeving	`APPSIGNAL_PUSH_API_KEY`
Vereist	ja
Type	`String`
Standaardwaarde	nil (Standaard niet ingesteld)
Beschikbaar vanaf versie	`0.1.0`

Beschrijving

De authenticatiesleutel op organisatieniveau om te authenticeren met onze Push API. Lees meer over de AppSignal Push API-sleutel.

Opmerking: Wanneer de systeemomgevingsvariabele APPSIGNAL_PUSH_API_KEY is ingesteld, krijgt de optie active standaard de waarde true in plaats van false. Dit betekent dat AppSignal als actief wordt beschouwd voor de geladen omgeving, zelfs als active in het configuratiebestand op false staat. Zie voor meer informatie de optie active.

bind_address

Veld	Waarde
Configuratiebestand-sleutel	`bind_address`
Systeemomgevingsvariabele	`APPSIGNAL_BIND_ADDRESS`
Vereist	nee
Type	`String`
Standaardwaarde	`127.0.0.1`
Beschikbaar sinds versie	`2.7.7`

Beschrijving

Een geldig IPv4-adres dat de AppSignal-agent gebruikt als binding voor zijn TCP- en UDP-servers. Gebruik een specifiek adres als u wilt dat de agent alleen luistert naar verzoeken die naar dat adres worden gemaakt. Stel deze optie in op 0.0.0.0 om verzoeken te ontvangen van hosts met willekeurige IP-adressen. Standaard luistert de agent alleen naar verzoeken die op dezelfde host worden gemaakt. Deze optie wordt toegepast op alle agent-servers (StatsD, OpenTelemetry en NGINX).

ca_file_path

Veld	Waarde
Configuratiebestand-sleutel	`ca_file_path`
Systeemomgevingsvariabele	`APPSIGNAL_CA_FILE_PATH`
Vereist	nee
Type	`String`
Standaardwaarde	Pad naar het meegeleverde `cacert.pem`-bestand.
Beschikbaar sinds versie	`0.12.0`

Beschrijving

Configureer het pad van het SSL-certificaatbestand. Standaard verwijst dit naar het AppSignal meegeleverde cacert.pem-bestand in het pakket zelf. Gebruik deze optie om naar een ander certificaatbestand te verwijzen als er een probleem is met het verbinden met onze API.

Opmerking: Het opgegeven pad mag geen besturingssysteemspecifieke bestandssysteemabstracties bevatten, zoals het homedir-symbool ~ voor *NIX-systemen. Dit wordt gezien als een ongeldig pad.

cpu_count

Veld	Waarde
Configuratiebestand-sleutel	`cpu_count`
Systeemomgevingsvariabele	`APPSIGNAL_CPU_COUNT`
Vereist	nee
Type	`Float`
Standaardwaarde	`undefined`
Beschikbaar sinds versie	`2.9.1`

Beschrijving

De beschikbare CPU-capaciteit van de host, uitgedrukt in aantal CPU’s. Deze wordt gebruikt om het CPU-gebruikspercentage in de host-metrics te berekenen. Als deze niet is ingesteld, zal de agent dit automatisch proberen te detecteren via cgroups. Het aantal CPU’s kan een fractie zijn, bijvoorbeeld 0.5.

debug

Veld	Waarde
Configuratiebestand-sleutel	`debug`
Systeemomgevingsvariabele	`APPSIGNAL_DEBUG`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`false`
Beschikbaar sinds versie	`1.0.0`
	Verouderd sinds versie 2.2.8 ten gunste van de `log_level` configuratie-optie.

Beschrijving

Waarschuwing: Deze configuratie-optie is verouderd in Elixir-pakket 2.2.8. Gebruik in plaats daarvan de optie log_level voor Elixir-pakket 2.2.8 en nieuwer.

Schakel debug-logging in; dit is meestal alleen nodig op verzoek van support. Met deze optie ingeschakeld zal AppSignal veel meer informatie loggen over beslissingen die worden genomen tijdens het verzamelen van metrics en wanneer gegevens naar AppSignal.com-servers worden verzonden. Het inschakelen van debug-logging kan een lichte impact hebben op het schijfgebruik en de IO, vooral op sites met veel verkeer. De CPU-overhead is minimaal met de debugoptie ingeschakeld.

Deze optie stelt het ernstniveau in van AppSignal’s interne logger. Deze configuratie-optie heeft geen invloed op de logging-functie.

dns_servers

Veld	Waarde
Configuratiebestand-sleutel	`dns_servers`
Systeemomgevingsvariabele	`APPSIGNAL_DNS_SERVERS`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`[]`
Beschikbaar sinds versie	`1.3.0.beta.2`

Beschrijving

Configureer DNS-servers die de AppSignal-agent moet gebruiken.

# config/config.exs
config :appsignal, :config,
  dns_servers: ["8.8.8.8", "8.8.4.4"]

Als u last hebt van onze DNS-time-outs, probeer dan met deze optie handmatig een DNS-server in te stellen die niet meer dan 4 punten in de servernaam gebruikt.

Aanvaardbare waarden: 8.8.8.8, my.custom.local.server.
Niet aanvaardbare waarden: foo, my.awesome.custom.local.dns.server.

Als de DNS-server niet bereikbaar is, valt de agent terug op de DNS-configuratie van de host en geeft een bericht weer in het bestand appsignal.log: A problem occurred while setting DNS servers.

ecto_repos

Veld	Waarde
Configuratiebestand-sleutel	`ecto_repos`
Systeemomgevingsvariabele	`APPSIGNAL_ECTO_REPOS`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`nil`
Beschikbaar sinds versie	`2.0.0`

Beschrijving

Configureer welke Ecto-repos moeten worden geïnstrumenteerd voor queries. Indien niet ingesteld, zal AppSignal uw repos automatisch vinden via uw applicatieconfiguratie.

# config/config.exs
config :appsignal, :config,
  ecto_repos: [AppsignalPhoenixExample.Repo, AppsignalPhoenixExample.AnotherRepo]

enable_error_backend

Veld	Waarde
Configuratiebestand-sleutel	`enable_error_backend`
Systeemomgevingsvariabele	`APPSIGNAL_ENABLE_ERROR_BACKEND`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar sinds versie	`2.4.1`

Beschrijving

Schakelt de error backend in de Elixir-integratie in.

enable_host_metrics

Veld	Waarde
Configuratiebestand-sleutel	`enable_host_metrics`
Systeemomgevingsvariabele	`APPSIGNAL_ENABLE_HOST_METRICS`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	“true `/ gedetecteerd door systeem`

Beschrijving

Zet deze optie op false om het verzamelen van host-metrics uit te schakelen. Op Heroku en Dokku zijn host-metrics standaard uitgeschakeld. Dit komt doordat deze systemen onnauwkeurige metrics rapporteren vanuit de containers. Het verzamelen van host-metrics op deze systemen kan niet worden ingeschakeld. Gebruik voor Heroku in plaats daarvan de Heroku log drain.

enable_minutely_probes

Veld	Waarde
Configuratiebestand-sleutel	`enable_minutely_probes`
Systeemomgevingsvariabele	`APPSIGNAL_ENABLE_MINUTELY_PROBES`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar sinds versie	`1.10.1`

Beschrijving

Schakelt het systeem van minutely probes in.

enable_nginx_metrics

Veld	Waarde
Configuratiebestand-sleutel	`enable_nginx_metrics`
Systeemomgevingsvariabele	`APPSIGNAL_ENABLE_NGINX_METRICS`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`false`
Beschikbaar sinds versie	`2.5.2`

Beschrijving

Stel in op true om de NGINX-metricsserver in te schakelen. Zie de NGINX-metricsdocumentatie voor details. Indien ingeschakeld, luistert de AppSignal-agent naar een server gebonden aan localhost op poort 27649. Als u meerdere applicaties met AppSignal-instrumentatie op dezelfde server draait, kan deze configuratie-optie slechts in één daarvan worden ingeschakeld.

enable_statsd

Veld	Waarde
Configuratiebestand-sleutel	`enable_statsd`
Systeemomgevingsvariabele	`APPSIGNAL_ENABLE_STATSD`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`false`
Beschikbaar sinds versie	`2.2.6`

Beschrijving

Schakelt de StatsD-server in de AppSignal-agent in. Indien ingeschakeld, luistert de AppSignal-agent naar een server gebonden aan localhost op poort 8125. Als u meerdere applicaties met AppSignal-instrumentatie op dezelfde server draait, kan deze configuratie-optie slechts in één daarvan worden ingeschakeld.

endpoint

Veld	Waarde
Configuratiebestand-sleutel	`endpoint`
Systeemomgevingsvariabele	`APPSIGNAL_PUSH_API_ENDPOINT`
Vereist	nee
Type	`String`
Standaardwaarde	`https://push.appsignal.com`

Beschrijving

Configureer het endpoint om gegevens naar AppSignal te sturen. Deze instelling hoeft niet te worden gewijzigd.

files_world_accessible

Veld	Waarde
Configuratiebestand-sleutel	`files_world_accessible`
Systeemomgevingsvariabele	`APPSIGNAL_FILES_WORLD_ACCESSIBLE`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar sinds versie	`1.3.4`

Beschrijving

Als dit op true is ingesteld, is de aangemaakte AppSignal-werkdirectory toegankelijk voor alle gebruikers (Unix-rechten 0666). Dit is vaak noodzakelijk omdat processen voor dezelfde app onder een andere gebruiker draaien. Zet dit op false om dit gedrag uit te schakelen (Unix-rechten 0644).

filter_parameters

Veld	Waarde
Configuratiebestand-sleutel	`filter_parameters`
Systeemomgevingsvariabele	`APPSIGNAL_FILTER_PARAMETERS`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`[]`

Beschrijving

Lijst van parametersleutels die genegeerd moeten worden met behulp van AppSignal-filtering. Hun waarden worden vervangen door [FILTERED] wanneer ze naar AppSignal worden verzonden. U kunt dit configureren met een lijst van sleutels in het configuratiebestand.

Elixir

# config/appsignal.exs
config :appsignal, :config,
  filter_parameters: ["password", "secret"]

Lees meer over parameterfiltering.

filter_session_data

Veld	Waarde
Configuratiebestand-sleutel	`filter_session_data`
Systeemomgevingsvariabele	`APPSIGNAL_FILTER_SESSION_DATA`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`[]`
Beschikbaar sinds versie	`1.6.0`
	Een upgrade naar versie `1.6.3` of hoger wordt aanbevolen.

Beschrijving

Lijst van sessiedata-sleutels die genegeerd moeten worden met behulp van AppSignal-filtering. Hun waarden worden vervangen door [FILTERED] wanneer ze naar AppSignal worden verzonden. U kunt dit configureren met een lijst van sleutels in het configuratiebestand.

Elixir

# config/appsignal.exs
config :appsignal, :config,
  filter_session_data: ["name", "email", "api_token", "token"]

Lees meer over sessiedata-filtering.

host_role

Veld	Waarde
Configuratiebestand-sleutel	`host_role`
Systeemomgevingsvariabele	`APPSIGNAL_HOST_ROLE`
Vereist	nee
Type	`String`
Standaardwaarde	nil (standaard niet ingesteld)
Beschikbaar sinds versie	`2.7.7`

Beschrijving

Groepeer hosts op rol en genereer metrics op basis van deze rol. Een voorbeeld van zo’n metric is de tellermetric reporting_hosts. Een goede rol geeft aan wat de hoofdfunctie van de server is, zoals “webserver”, “processor”, “api”, “database”, “loadbalancer”, enzovoort.

hostname

Veld	Waarde
Configuratiebestand-sleutel	`hostname`
Systeemomgevingsvariabele	`APPSIGNAL_HOSTNAME`
Vereist	nee
Type	`String`
Standaardwaarde	gedetecteerd uit het systeem
Beschikbaar sinds versie	`0.12.0`

Beschrijving

Hiermee wordt de hostnaam van de server overschreven. Handig wanneer u geen aangepaste hostnaam kunt instellen of wanneer een nietszeggende id voor u wordt gegenereerd op hostingdiensten.

http_proxy

Veld	Waarde
Configuratiebestand-sleutel	`http_proxy`
Systeemomgevingsvariabele	`APPSIGNAL_HTTP_PROXY`
Vereist	nee
Type	`String`
Standaardwaarde	nil (standaard niet ingesteld)

Beschrijving

Als u wilt dat de agent via een proxy verbinding maakt met het internet, stel dan de volledige proxy-URL in deze configuratiesleutel in.

ignore_actions

Veld	Waarde
Configuratiebestand-sleutel	`ignore_actions`
Systeemomgevingsvariabele	`APPSIGNAL_IGNORE_ACTIONS`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`[]`

Beschrijving

Met deze configuratie-optie kunt u een lijst opgeven van acties die door AppSignal worden genegeerd. Alles wat gebeurt, inclusief exceptions, wordt niet naar AppSignal verzonden. Dit kan handig zijn om health-check-endpoints of andere acties die u niet wilt monitoren te negeren. Lees meer over acties negeren.

ignore_errors

Veld	Waarde
Configuratiebestand-sleutel	`ignore_errors`
Systeemomgevingsvariabele	`APPSIGNAL_IGNORE_ERRORS`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`[]`

Beschrijving

Lijst van error classes die worden genegeerd. Elke exception die met deze error class wordt opgeworpen, wordt niet naar AppSignal verzonden. Lees meer over fouten negeren.

ignore_logs

Veld	Waarde
Configuratiebestand-sleutel	`ignore_logs`
Systeemomgevingsvariabele	`APPSIGNAL_IGNORE_LOGS`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`[]`
Beschikbaar sinds versie	`2.10.0`

Beschrijving

Lijst van logberichten die worden genegeerd. Elk logbericht dat een van de elementen uit de lijst bevat, wordt niet naar AppSignal verzonden. Een kleine subset van regex-syntaxis wordt ondersteund; lees er meer over in onze gids Logs negeren.

ignore_namespaces

Veld	Waarde
Configuratiebestand-sleutel	`ignore_namespaces`
Systeemomgevingsvariabele	`APPSIGNAL_IGNORE_NAMESPACES`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`[]`
Beschikbaar sinds versie	`1.3.0`

Beschrijving

Lijst van namespaces die worden genegeerd. Elke opgeworpen fout of trage request die zich in deze namespace voordoet, wordt niet naar AppSignal verzonden. Lees meer over namespaces.

instrument_absinthe

Veld	Waarde
Configuratiebestand-sleutel	`instrument_absinthe`
Systeemomgevingsvariabele	`APPSIGNAL_INSTRUMENT_ABSINTHE`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar sinds versie	`2.7.0`

Beschrijving

Of Telemetry-events automatisch worden geïnstrumenteerd voor de Absinthe-pakketintegratie; kan true of false zijn.

instrument_ecto

Veld	Waarde
Configuratiebestand-sleutel	`instrument_ecto`
Systeemomgevingsvariabele	`APPSIGNAL_INSTRUMENT_ECTO`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar sinds versie	`2.5.1`

Beschrijving

Of Telemetry-events automatisch worden geïnstrumenteerd voor de Ecto-pakketintegratie; kan true of false zijn.

instrument_finch

Veld	Waarde
Configuratiebestand-sleutel	`instrument_finch`
Systeemomgevingsvariabele	`APPSIGNAL_INSTRUMENT_FINCH`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar sinds versie	`2.5.1`

Beschrijving

Of Telemetry-events automatisch worden geïnstrumenteerd voor de Finch-pakketintegratie; kan true of false zijn.

instrument_oban

Veld	Waarde
Configuratiebestand-sleutel	`instrument_oban`
Systeemomgevingsvariabele	`APPSIGNAL_INSTRUMENT_OBAN`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar sinds versie	`2.5.1`

Beschrijving

Of Telemetry-events automatisch worden geïnstrumenteerd voor de Oban-pakketintegratie; kan true of false zijn.

instrument_tesla

Veld	Waarde
Sleutel in configuratiebestand	`instrument_tesla`
Sleutel in systeemomgeving	`APPSIGNAL_INSTRUMENT_TESLA`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar vanaf versie	`2.7.3`

Beschrijving

Of Telemetry-events voor de Tesla-package-integratie automatisch worden geïnstrumenteerd; dit kan true of false zijn.

log

Veld	Waarde
Sleutel in configuratiebestand	`log`
Sleutel in systeemomgeving	`APPSIGNAL_LOG`
Vereist	nee
Type	`Atom`
Standaardwaarde	`:file`

Beschrijving

Deze optie configureert welke logger de interne logfunctionaliteit van AppSignal gebruikt en heeft geen invloed op de logfunctie.Opmerking: De AppSignal-agent, die door de integratie wordt gebruikt, schrijft altijd naar het bestand “appsignal.log”.

Kies welke logger de AppSignal-integratie gebruikt. Geaccepteerde waarden zijn file en stdout. Zie ook de configuratie log_path.

file (standaard)
- Schrijf alle AppSignal-logs naar het bestandssysteem.
stdout (standaard op Heroku)
- Print AppSignal-logs naar de STDOUT van het bovenliggende proces in plaats van naar een bestand. Handig bij hostingoplossingen zoals containersystemen en Heroku.

log_level

Veld	Waarde
Sleutel in configuratiebestand	`log_level`
Sleutel in systeemomgeving	`APPSIGNAL_LOG_LEVEL`
Vereist	nee
Type	`String`
Standaardwaarde	`info`
Beschikbaar vanaf versie	`2.2.8`

Beschrijving

Deze optie stelt het severity-niveau in van de interne logger van AppSignal en heeft geen invloed op de logfunctie.

Stel het severity-niveau in van de interne logger van AppSignal. Als deze is geconfigureerd op “info” worden alle error-, warning- en info-meldingen gelogd, maar geen debug-meldingen. Het instellen op “debug” of “trace” is meestal alleen nodig op verzoek van support. Het instellen van het niveau op “debug”/“trace” kan een lichte impact hebben op het schijfgebruik en de IO, vooral op websites met veel verkeer. De CPU-overhead is minimaal met de debug-optie ingeschakeld. Geaccepteerde waarden:

error
warning
info
debug
trace

log_path

Veld	Waarde
Sleutel in configuratiebestand	`log_path`
Sleutel in systeemomgeving	`APPSIGNAL_LOG_PATH`
Vereist	nee
Type	`String`
Standaardwaarde	`/tmp`
Beschikbaar vanaf versie	`1.0.0`
	`1.9.0`: Het standaard logpad is gewijzigd van `/tmp/appsignal/` naar `/tmp/`.

Beschrijving

Deze optie configureert de locatie van het interne logbestand van AppSignal en heeft geen invloed op de logfunctie.
Opmerking: Het opgegeven pad mag geen besturingssysteemspecifieke bestandssysteem- abstracties bevatten, zoals het homedir-symbool ~ voor *NIX-systemen. Dit wordt gezien als een ongeldig pad.

Overschrijf de locatie van het pad (de map) waar het bestand appsignal.log kan worden geschreven.

nginx_port

Veld	Waarde
Sleutel in configuratiebestand	`nginx_port`
Sleutel in systeemomgeving	`APPSIGNAL_NGINX_PORT`
Vereist	nee
Type	`Integer`
Standaardwaarde	`27649`
Beschikbaar vanaf versie	`2.15.8`

Beschrijving

Configureer de poort waarop de NGINX-metricsserver beschikbaar is. Wanneer AppSignal NGINX-metrics ontvangt, luistert het naar een server die aan localhost gebonden is, standaard op poort 27649. Als u meerdere applicaties met AppSignal-instrumentatie op dezelfde server draait met NGINX-metrics ingeschakeld, gebruik dan deze optie om elke applicatie op een andere poort te laten luisteren.

report_oban_errors

Veld	Waarde
Sleutel in configuratiebestand	`report_oban_errors`
Sleutel in systeemomgeving	`APPSIGNAL_REPORT_OBAN_ERRORS`
Vereist	nee
Type	`String`
Standaardwaarde	`all`
Beschikbaar vanaf versie	`2.5.1`

Beschrijving

Wanneer fouten gerapporteerd moeten worden die door de exception-event-handler van de Oban-package-integratie worden ontvangen tijdens het verwerken van een job. Mogelijke waarden zijn:

all: Rapporteer alle fouten voor elke uitvoering van jobs, inclusief retries.
discard: Rapporteer fouten wanneer de job wordt verworpen vanwege de fout. Gebruik deze optie om alleen fouten te rapporteren wanneer alle job-retries zijn uitgeput.
none: Rapporteer geen fouten voor jobs, inclusief retries.

request_headers

Veld	Waarde
Sleutel in configuratiebestand	`request_headers`
Sleutel in systeemomgeving	`APPSIGNAL_REQUEST_HEADERS`
Vereist	nee
Type	`list(String)`
Standaardwaarde	`["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "path-info", "range", "request-method", "request-uri", "server-name", "server-port", "server-protocol"]`
Beschikbaar vanaf versie	`1.6.0`
	Upgraden naar `1.6.3` of hoger wordt aanbevolen.

Beschrijving

De configuratieoptie request_headers bevat een lijst van HTTP-requestheaders die door het AppSignal Elixir-pakket worden gelezen en opgeslagen. Deze configuratieoptie request_headers is een allowlist, wat betekent dat alleen de headers worden meegenomen die in deze optie zijn opgegeven. Als deze configuratieoptie niet is ingesteld, wordt de AppSignal-standaard gebruikt. De volgende lijst is de standaard van het AppSignal-pakket.

Elixir

# config/appsignal.exs
config :appsignal, :config,
  request_headers: ~w(
    accept accept-charset accept-encoding accept-language cache-control
    connection content-length path-info range request-method
    request-uri server-name server-port server-protocol
  )

Om AppSignal zo te configureren dat er geen HTTP-requestheaders worden opgeslagen op AppSignal-transacties, configureert u de optie met een lege lijst.

Elixir

# config/appsignal.exs
config :appsignal, :config,
  request_headers: []

revision

Veld	Waarde
Sleutel in configuratiebestand	`revision`
Sleutel in systeemomgeving	`APP_REVISION`
Vereist	nee
Type	`String`
Standaardwaarde	nil (Standaard niet ingesteld)
Beschikbaar vanaf versie	`1.5.0`
	`1.10.12`: Automatische detectie voor Heroku-deploys met de Dyno Metadata labs-functie ingeschakeld. `2.7.6`: Automatische detectie voor Render-deploys. `3.4.7`: Automatische detectie voor Kamal-deploys.

Beschrijving

Stel de app-revisie in om de momenteel draaiende versie van uw app te rapporteren. AppSignal maakt een deploy marker aan wanneer deze waarde verandert en tagt alle binnenkomende data met de huidige revisie. Wanneer uw applicatie wordt gedeployed met Kamal, of naar Render, of naar Heroku met de Heroku Labs: Dyno Metadata-functie ingeschakeld, detecteert de AppSignal-integratie automatisch de Git-commit van de huidige deployment en gebruikt deze als revisie. U kunt de automatisch gedetecteerde revisies op Heroku, Render of Kamal overschrijven door de configuratieoptie revision handmatig in te stellen op een aangepaste waarde. Lees meer over deploy markers in het onderwerp deploy markers.

running_in_container

Veld	Waarde
Sleutel in configuratiebestand	`running_in_container`
Sleutel in systeemomgeving	`APPSIGNAL_RUNNING_IN_CONTAINER`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	gedetecteerd door agent

Beschrijving

AppSignal verwacht tussen verschillende deploys op dezelfde machine te draaien. Stel deze sleutel in op true als de applicatie in een container draait, zoals bij Docker. Nieuwere versies van de AppSignal-integratie detecteren de containeromgeving automatisch, dus handmatige configuratie is niet nodig. Als u problemen ondervindt met de automatische detectie, neem dan contact op met support. Deze optie wordt automatisch op true gezet op Heroku.

send_environment_metadata

Veld	Waarde
Sleutel in configuratiebestand	`send_environment_metadata`
Sleutel in systeemomgeving	`APPSIGNAL_SEND_ENVIRONMENT_METADATA`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar vanaf versie	`2.2.8`

Beschrijving

Verstuur omgevingsmetadata over de app. Lees voor meer informatie over omgevingsmetadata.

send_params

Veld	Waarde
Sleutel in configuratiebestand	`send_params`
Sleutel in systeemomgeving	`APPSIGNAL_SEND_PARAMS`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar vanaf versie	`1.10.0`

Beschrijving

Of het verzenden van requestparameters naar AppSignal moet worden overgeslagen. Lees voor meer informatie over send_params bij het filteren van requestparameters.

send_session_data

Veld	Waarde
Sleutel in configuratiebestand	`send_session_data`
Sleutel in systeemomgeving	`APPSIGNAL_SEND_SESSION_DATA`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`true`
Beschikbaar vanaf versie	`2.2.10`

Beschrijving

Stel deze optie in op false om geen sessiegegevens mee te sturen met exception-traces en performance issue-samples. Lees voor meer informatie over het filteren van request-sessiegegevens.

skip_session_data

Veld	Waarde
Sleutel in configuratiebestand	`skip_session_data`
Sleutel in systeemomgeving	`APPSIGNAL_SKIP_SESSION_DATA`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`false`

Beschrijving

Waarschuwing: Deze configuratieoptie is verouderd vanaf Elixir-pakket 2.2.10. Gebruik in plaats daarvan de optie send_session_data voor nieuwere versies van het Elixir-pakket.

statsd_port

Veld	Waarde
Sleutel in configuratiebestand	`statsd_port`
Sleutel in systeemomgeving	`APPSIGNAL_STATSD_PORT`
Vereist	nee
Type	`Integer`
Standaardwaarde	`8125`
Beschikbaar vanaf versie	`2.7.2`

Beschrijving

Stel deze optie in om de StatsD HTTP-serverpoort van het AppSignal-agentproces te configureren. Configureer deze poort als er al een ander proces op de machine draait dat ook deze poort gebruikt, om conflicten te voorkomen.

transaction_debug_mode

Veld	Waarde
Sleutel in configuratiebestand	`transaction_debug_mode`
Sleutel in systeemomgeving	`APPSIGNAL_TRANSACTION_DEBUG_MODE`
Vereist	nee
Type	Boolean (`true` / `false`)
Standaardwaarde	`false`
Beschikbaar vanaf versie	`1.11.4`
	Verouderd sinds versie 2.2.9 ten gunste van de configuratieoptie `log_level`.

Beschrijving

Waarschuwing: Deze configuratieoptie is verouderd in Elixir-pakket 2.2.9. Gebruik in plaats daarvan de optie log_level voor Elixir-pakket 2.2.9 en nieuwer.

Schakel transaction debug mode in. Dit zorgt voor zeer gedetailleerde logging van transacties en events, wat handig is bij het ontwikkelen van integraties of wanneer events niet worden gevolgd zoals verwacht. De log wordt alleen weggeschreven als ook de algemene debug-optie aanstaat.

Deze optie stelt het severity-niveau in van de interne logger van AppSignal en heeft geen invloed op de logfunctie.

working_dir_path

Veld	Waarde
Sleutel in configuratiebestand	`working_dir_path`
Sleutel in systeemomgeving	`APPSIGNAL_WORKING_DIR_PATH`
Vereist	nee
Type	`String`
Standaardwaarde	gedetecteerd door agent
Beschikbaar vanaf versie	`1.8.0`

Beschrijving

Waarschuwing: Deze configuratieoptie is verouderd in Elixir-pakket 1.8.0. Gebruik in plaats daarvan de optie working_directory_path voor Elixir-pakket 1.8.0 en nieuwer.

Overschrijf de locatie waar AppSignal voor Elixir tijdelijke bestanden kan opslaan. Gebruik deze optie als de standaardlocatie niet geschikt is. Zie onze pagina hoe AppSignal werkt voor meer informatie over het doel van deze werkmap. Als u meerdere applicaties met AppSignal op dezelfde server draait, gebruik dan deze configuratieoptie om verschillende werkmappen te kiezen voor elke AppSignal-instantie, anders kunnen de twee instanties met elkaar in conflict komen. Zie voor meer informatie over dit scenario onze documentatie over meerdere applicaties op één host draaien.

Elixir

# config/config.exs
config :appsignal, :config,
  working_dir_path: "/tmp/project_1/"

Opmerking: Het opgegeven pad mag geen besturingssysteemspecifieke bestandssysteem- abstracties bevatten, zoals het homedir-symbool ~ voor *NIX-systemen. Dit wordt gezien als een ongeldig pad.

working_directory_path

Veld	Waarde
Sleutel in configuratiebestand	`working_directory_path`
Sleutel in systeemomgeving	`APPSIGNAL_WORKING_DIRECTORY_PATH`
Vereist	nee
Type	`String`
Standaardwaarde	gedetecteerd door agent
Beschikbaar vanaf versie	`1.8.0`
	Gebruik in eerdere versies de optie `working_dir_path`.

Beschrijving

Elixir

# config/appsignal.exs
config :appsignal, :config,
  working_directory_path: "/tmp/project_1/"

Opmerking: Het opgegeven pad mag geen besturingssysteemspecifieke bestandssysteem- abstracties bevatten, zoals het homedir-symbool ~ voor *NIX-systemen. Dit wordt gezien als een ongeldig pad.

​Beschikbare opties

​active

​Beschrijving

​env

​Beschrijving

​name

​Beschrijving

​otp_app

​Beschrijving

​push_api_key

​Beschrijving

​bind_address

​Beschrijving

​ca_file_path

​Beschrijving

​cpu_count

​Beschrijving

​debug

​Beschrijving

​dns_servers

​Beschrijving

​ecto_repos

​Beschrijving

​enable_error_backend

​Beschrijving

​enable_host_metrics

​Beschrijving

​enable_minutely_probes

​Beschrijving

​enable_nginx_metrics

​Beschrijving

​enable_statsd

​Beschrijving

​endpoint

​Beschrijving

​files_world_accessible

​Beschrijving

​filter_parameters

​Beschrijving

​filter_session_data

​Beschrijving

​host_role

​Beschrijving

​hostname

​Beschrijving

​http_proxy

​Beschrijving

​ignore_actions

​Beschrijving

​ignore_errors

​Beschrijving

​ignore_logs

​Beschrijving

​ignore_namespaces

​Beschrijving

​instrument_absinthe

​Beschrijving

​instrument_ecto

​Beschrijving

​instrument_finch

​Beschrijving

​instrument_oban

​Beschrijving

​instrument_tesla

​Beschrijving

​log

​Beschrijving

​log_level

​Beschrijving

​log_path

​Beschrijving

​nginx_port

​Beschrijving

​report_oban_errors

​Beschrijving

​request_headers

​Beschrijving

​revision

​Beschrijving

​running_in_container

Beschikbare opties

active

Beschrijving

env

Beschrijving

name

Beschrijving

otp_app

Beschrijving

push_api_key

Beschrijving

bind_address

Beschrijving

ca_file_path

Beschrijving

cpu_count

Beschrijving

debug

Beschrijving

dns_servers

Beschrijving

ecto_repos

Beschrijving

enable_error_backend

Beschrijving

enable_host_metrics

Beschrijving

enable_minutely_probes

Beschrijving

enable_nginx_metrics

Beschrijving

enable_statsd

Beschrijving

endpoint

Beschrijving

files_world_accessible

Beschrijving

filter_parameters

Beschrijving

filter_session_data

Beschrijving

host_role

Beschrijving

hostname

Beschrijving

http_proxy

Beschrijving

ignore_actions

Beschrijving

ignore_errors

Beschrijving

ignore_logs

Beschrijving

ignore_namespaces

Beschrijving

instrument_absinthe

Beschrijving

instrument_ecto

Beschrijving

instrument_finch

Beschrijving

instrument_oban

Beschrijving

instrument_tesla

Beschrijving

log

Beschrijving

log_level

Beschrijving

log_path

Beschrijving

nginx_port

Beschrijving

report_oban_errors

Beschrijving

request_headers

Beschrijving

revision

Beschrijving

running_in_container