Naar hoofdinhoud gaan
De volgende lijst bevat alle configuratieopties met de naam van de omgevingsvariabele en de naam van de sleutel in het configuratiebestand. Voor meer informatie over het configureren van de Standalone AppSignal Agent met een configuratiebestand of met omgevingsvariabelen, raadpleegt u onze configuratie-sectie.

​
Beschikbare opties

​
app_name

VeldWaarde
Configuratiebestand-sleutelapp_name
SysteemomgevingssleutelAPPSIGNAL_APP_NAME
Verplichtja
TypeString
Standaardwaardenil (Dit is standaard niet ingesteld)

​
Beschrijving

Naam van uw applicatie zoals deze op AppSignal.com moet worden weergegeven.
Let op: Het wijzigen van de naam of omgeving van een bestaande app zal een nieuwe app aanmaken op AppSignal.com.

​
environment

VeldWaarde
Configuratiebestand-sleutelenvironment
SysteemomgevingssleutelAPPSIGNAL_APP_ENV
Verplichtja
TypeString
Standaardwaardenil (Dit is standaard niet ingesteld)

​
Beschrijving

De omgeving van de app die aan AppSignal moet worden gerapporteerd.
Let op: Het wijzigen van de naam of omgeving van een bestaande app zal een nieuwe app aanmaken op AppSignal.com.

​
push_api_key

VeldWaarde
Configuratiebestand-sleutelpush_api_key
SysteemomgevingssleutelAPPSIGNAL_PUSH_API_KEY
Verplichtja
TypeString
Standaardwaardenil (Dit is standaard niet ingesteld)

​
Beschrijving

De authenticatiesleutel op organisatieniveau om te authenticeren bij onze Push API. Lees meer over de AppSignal Push API key.

​
bind_address

VeldWaarde
Configuratiebestand-sleutelbind_address
SysteemomgevingssleutelAPPSIGNAL_BIND_ADDRESS
Verplichtnee
TypeString
Standaardwaarde127.0.0.1
Beschikbaar vanaf versie0.0.24

​
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 requests die naar dat adres worden gestuurd. Stel deze optie in op 0.0.0.0 om requests van hosts met elk IP-adres te kunnen ontvangen. Standaard luistert hij alleen naar requests die op dezelfde host worden gedaan. Deze optie wordt toegepast op alle agentservers (StatsD, OpenTelemetry en NGINX).

​
ca_file_path

VeldWaarde
Configuratiebestand-sleutelca_file_path
SysteemomgevingssleutelAPPSIGNAL_CA_FILE_PATH
Verplichtnee
TypeString
StandaardwaardeStandaard de systeem-CA’s.

​
Beschrijving

  • Configureer het pad van het SSL-certificaatbestand.
Gebruik deze optie om naar een ander certificaatbestand te verwijzen als er een probleem is met het verbinden met onze API.
Let op: Het opgegeven pad mag geen besturingssysteem-specifieke abstracties voor het bestandssysteem bevatten, zoals het homedir-symbool ~ voor *NIX-systemen. Dit zal worden gezien als een ongeldig pad.

​
cpu_count

VeldWaarde
Configuratiebestand-sleutelcpu_count
SysteemomgevingssleutelAPPSIGNAL_CPU_COUNT
Verplichtnee
TypeFloat
Standaardwaardeundefined
Beschikbaar vanaf versie0.34.1

​
Beschrijving

De beschikbare CPU-capaciteit van de host, in aantal CPU’s. Dit wordt gebruikt om het CPU-gebruikspercentage in de host metrics te berekenen. Indien niet ingesteld, zal de agent proberen dit automatisch te detecteren via cgroups. Het aantal CPU’s mag een breukgetal zijn, bijv. 0.5.

​
dns_servers

VeldWaarde
Configuratiebestand-sleuteldns_servers
SysteemomgevingssleutelAPPSIGNAL_DNS_SERVERS
Verplichtnee
TypeString
Standaardwaardenil (Dit is standaard niet ingesteld)

​
Beschrijving

Configureer DNS-servers voor de AppSignal-agent om te gebruiken.
YAML
# /etc/appsignal-agent.conf
dns_servers = "8.8.8.8,8.8.4.4"
Als u last hebt van onze DNS-timeouts, probeer dan handmatig een DNS-server in te stellen via deze optie die niet meer dan 4 punten in de servernaam gebruikt.
  • Acceptabele waarden: 8.8.8.8, my.custom.local.server.
  • Niet acceptabele 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 wordt er een bericht weergegeven in het appsignal.log-bestand: A problem occurred while setting DNS servers.

​
enable_host_metrics

VeldWaarde
Configuratiebestand-sleutelenable_host_metrics
SysteemomgevingssleutelAPPSIGNAL_ENABLE_HOST_METRICS
Verplichtnee
TypeBoolean (true / false)
Standaardwaardetrue / gedetecteerd door systeem
Beschikbaar vanaf versie0.0.1
  • 0.0.26: Standaard uitgeschakeld in de appsignal/agent Docker-image.

​
Beschrijving

Stel deze optie in 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_http

VeldWaarde
Configuratiebestand-sleutelenable_http
Verplichtnee
TypeBoolean (true / false)
Standaardwaardefalse
Beschikbaar vanaf versie0.0.23

​
Beschrijving

Stel deze optie in op true om de OpenTelemetry HTTP-server in te schakelen. Indien ingeschakeld, luistert de AppSignal-agent naar een localhost-gebonden server op poort 8099. Als u meerdere AppSignal-geïnstrumenteerde applicaties op dezelfde server draait, kan deze configuratieoptie maar in één daarvan worden ingeschakeld. Dit is vereist voor apps die de OpenTelemetry HTTP-exporter gebruiken om gegevens naar AppSignal te rapporteren.

​
enable_nginx_metrics

VeldWaarde
Configuratiebestand-sleutelenable_nginx_metrics
SysteemomgevingssleutelAPPSIGNAL_ENABLE_NGINX_METRICS
Verplichtnee
TypeBoolean (true / false)
Standaardwaardefalse
Beschikbaar vanaf versie0.0.24
  • 0.0.26: Standaard ingeschakeld in de appsignal/agent Docker-image.

​
Beschrijving

Stel in op true om de NGINX metrics-server in te schakelen. Zie de NGINX metrics-documentatie voor details. Indien ingeschakeld, luistert de AppSignal-agent naar een localhost-gebonden server op poort 27649. Als u meerdere AppSignal-geïnstrumenteerde applicaties op dezelfde server draait, kan deze configuratieoptie maar in één daarvan worden ingeschakeld.

​
enable_opentelemetry_http

VeldWaarde
Configuratiebestand-sleutelenable_opentelemetry_http
SysteemomgevingssleutelAPPSIGNAL_ENABLE_OPENTELEMETRY_HTTP
Verplichtnee
TypeBoolean (true / false)
Standaardwaardefalse / gedetecteerd door systeem
Beschikbaar vanaf versie0.0.25
  • 0.0.26: Standaard ingeschakeld in de appsignal/agent Docker-image.

​
Beschrijving

Stel deze optie in op true om de OpenTelemetry HTTP-server in te schakelen. Indien ingeschakeld, luistert de AppSignal-agent naar een localhost-gebonden server op poort 8099. Als u meerdere AppSignal-geïnstrumenteerde applicaties op dezelfde server draait, kan deze configuratieoptie maar in één daarvan worden ingeschakeld. Dit is vereist voor apps die de OpenTelemetry HTTP-exporter gebruiken om gegevens naar AppSignal te rapporteren.

​
enable_statsd

VeldWaarde
Configuratiebestand-sleutelenable_statsd
SysteemomgevingssleutelAPPSIGNAL_ENABLE_STATSD
Verplichtnee
TypeBoolean (true / false)
Standaardwaardetrue
Beschikbaar vanaf versie0.0.24

​
Beschrijving

Schakelt de StatsD-server in de AppSignal-agent in. Indien ingeschakeld, luistert de AppSignal-agent naar een localhost-gebonden server op poort 8125. Als u meerdere AppSignal-geïnstrumenteerde applicaties op dezelfde server draait, kan deze configuratieoptie maar in één daarvan worden ingeschakeld.

​
filter_parameters

VeldWaarde
Configuratiebestand-sleutelfilter_parameters
SysteemomgevingssleutelAPPSIGNAL_FILTER_PARAMETERS
Verplichtnee
TypeArray<String>
Standaardwaarde[]
Beschikbaar vanaf versie0.0.23

​
Beschrijving

Lijst met parametersleutels die moeten worden genegeerd via AppSignal-filtering. Hun waarden worden vervangen door [FILTERED] wanneer ze naar AppSignal worden verzonden.
TOML
# appsignal.conf
filter_parameters = ["password", "confirm_password", "secret"]
Lees meer over parameter filtering.

​
filter_session_data

VeldWaarde
Configuratiebestand-sleutelfilter_session_data
SysteemomgevingssleutelAPPSIGNAL_FILTER_SESSION_DATA
Verplichtnee
TypeArray<String>
Standaardwaarde[]
Beschikbaar vanaf versie0.0.23

​
Beschrijving

Lijst met sessiegegevenssleutels die moeten worden genegeerd via AppSignal-filtering. Hun waarden worden vervangen door [FILTERED] wanneer ze naar AppSignal worden verzonden.
TOML
# appsignal.conf
filter_session_data = ["secret_token_one", "secret_token_two"]
Lees meer over session data filtering.

​
host_role

VeldWaarde
Configuratiebestand-sleutelhost_role
SysteemomgevingssleutelAPPSIGNAL_HOST_ROLE
Verplichtnee
TypeString
Standaardwaardenil (Dit is standaard niet ingesteld)
Beschikbaar vanaf versie0.0.28

​
Beschrijving

Groepeer hosts op rol en genereer metrics op basis van deze rol. Een dergelijke metric is de reporting_hosts counter metric. Een goede rol geeft aan wat de hoofdrol van de server is, zoals “webserver”, “processor”, “api”, “database”, “loadbalancer”, etc.

​
hostname

VeldWaarde
Configuratiebestand-sleutelhostname
SysteemomgevingssleutelAPPSIGNAL_HOSTNAME
Verplichtnee
TypeString
Standaardwaardegedetecteerd vanuit systeem

​
Beschrijving

Dit overschrijft de hostnaam van de server. Handig wanneer u geen aangepaste hostnaam kunt instellen of wanneer er een nietszeggend id voor u wordt gegenereerd op hostingdiensten.

​
http_proxy

VeldWaarde
Configuratiebestand-sleutelhttp_proxy
SysteemomgevingssleutelAPPSIGNAL_HTTP_PROXY
Verplichtnee
TypeString
Standaardwaardenil (Dit is standaard niet ingesteld)

​
Beschrijving

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

​
ignore_actions

VeldWaarde
Configuratiebestand-sleutelignore_actions
SysteemomgevingssleutelAPPSIGNAL_IGNORE_ACTIONS
Verplichtnee
TypeArray<String>
Standaardwaarde[]
Beschikbaar vanaf versie0.0.26

​
Beschrijving

Met deze configuratieoptie kunt u een lijst opgeven van acties die door AppSignal worden genegeerd. Alles wat er 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

VeldWaarde
Configuratiebestand-sleutelignore_errors
SysteemomgevingssleutelAPPSIGNAL_IGNORE_ERRORS
Verplichtnee
TypeArray<String>
Standaardwaarde[]
Beschikbaar vanaf versie0.0.26

​
Beschrijving

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

​
ignore_namespaces

VeldWaarde
Configuratiebestand-sleutelignore_namespaces
SysteemomgevingssleutelAPPSIGNAL_IGNORE_NAMESPACES
Verplichtnee
TypeArray<String>
Standaardwaarde[]
Beschikbaar vanaf versie0.0.26

​
Beschrijving

Lijst met namespaces die worden genegeerd. Elke error die wordt opgeworpen of trage request die in deze namespace optreedt, wordt niet naar AppSignal verzonden. Lees meer over namespaces.

​
log_level

VeldWaarde
Configuratiebestand-sleutellog_level
SysteemomgevingssleutelAPPSIGNAL_LOG_LEVEL
Verplichtnee
TypeString
Standaardwaardeinfo

​
Beschrijving

Deze optie stelt het severity level van de interne logger van AppSignal in en heeft geen invloed op de logging-functie.
Stel het severity level van de interne logger van AppSignal in. Als deze is geconfigureerd op “info”, worden alle error-, warning- en info-berichten gelogd, maar geen debug-berichten. Het instellen op de niveaus “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 sites met veel verkeer. De CPU-overhead is minimaal wanneer de debug-optie is ingeschakeld. Geaccepteerde waarden:
  • error
  • warning
  • info
  • debug
  • trace

​
nginx_port

VeldWaarde
Configuratiebestand-sleutelnginx_port
SysteemomgevingssleutelAPPSIGNAL_NGINX_PORT
Verplichtnee
TypeInteger
Standaardwaarde27649
Beschikbaar vanaf versie0.36.6

​
Beschrijving

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

​
opentelemetry_port

VeldWaarde
Configuratiebestand-sleutelopentelemetry_port
SysteemomgevingssleutelAPPSIGNAL_OPENTELEMETRY_PORT
Verplichtnee
TypeInteger
Standaardwaarde8099
Beschikbaar vanaf versie0.0.28

​
Beschrijving

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

​
push_api_endpoint

VeldWaarde
Configuratiebestand-sleutelpush_api_endpoint
SysteemomgevingssleutelAPPSIGNAL_PUSH_API_ENDPOINT
Verplichtnee
TypeString
Standaardwaardehttps://push.appsignal.com

​
Beschrijving

Configureer het endpoint waar gegevens naar AppSignal worden verzonden. Deze instelling hoeft niet te worden gewijzigd.

​
running_in_container

VeldWaarde
Configuratiebestand-sleutelrunning_in_container
SysteemomgevingssleutelAPPSIGNAL_RUNNING_IN_CONTAINER
Verplichtnee
TypeBoolean (true / false)
Standaardwaardegedetecteerd door agent
Beschikbaar vanaf versie0.0.27

​
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 met 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

VeldWaarde
Configuratiebestand-sleutelsend_environment_metadata
SysteemomgevingssleutelAPPSIGNAL_SEND_ENVIRONMENT_METADATA
Verplichtnee
TypeBoolean (true / false)
Standaardwaardetrue

​
Beschrijving

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

​
send_params

VeldWaarde
Configuratiebestand-sleutelsend_params
SysteemomgevingssleutelAPPSIGNAL_SEND_PARAMS
Verplichtnee
TypeBoolean (true / false)
Standaardwaardetrue
Beschikbaar vanaf versie0.0.24

​
Beschrijving

Bepaalt 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

VeldWaarde
Configuratiebestand-sleutelsend_session_data
SysteemomgevingssleutelAPPSIGNAL_SEND_SESSION_DATA
Verplichtnee
TypeBoolean (true / false)
Standaardwaardetrue
Beschikbaar vanaf versie0.0.24

​
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 session data.

​
statsd_port

VeldWaarde
Configuratiebestand-sleutelstatsd_port
SysteemomgevingssleutelAPPSIGNAL_STATSD_PORT
Verplichtnee
TypeInteger
Standaardwaarde8125
Beschikbaar vanaf versie0.0.28

​
Beschrijving

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

​
working_dir_path

VeldWaarde
Configuratiebestand-sleutelworking_dir_path
SysteemomgevingssleutelAPPSIGNAL_WORKING_DIRECTORY_PATH
Verplichtnee
TypeString
Standaardwaarde/var/lib/appsignal-agent

​
Beschrijving

Overschrijf de locatie waar de Standalone AppSignal Agent 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 werkdirectory.
Let op: Het opgegeven pad mag geen besturingssysteem-specifieke abstracties voor het bestandssysteem bevatten, zoals het homedir-symbool ~ voor *NIX-systemen. Dit zal worden gezien als een ongeldig pad.