> ## 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. # Ondersteunde besturingssystemen De AppSignal-integraties voor Ruby, Elixir & Node.js bevatten native extensions en een apart lichtgewicht agentproces. Deze native extensions worden ondersteund op de meeste Linux-distributies, FreeBSD en macOS/OSX. Onze Go- en Python-integraties gebruiken alleen ons agentproces en vereisen geen aanvullende pakketten om geïnstalleerd te worden. Net als de andere integraties werken ze alleen op de ondersteunde besturingssystemen die vermeld staan in de [ondersteuningstabel](#support-table). Als een besturingssysteem dat u gebruikt niet wordt ondersteund, [neem dan contact op][support]. ## Ondersteuningstabel Tabel met verschillende combinaties van besturingssystemen en architecturen die we ondersteunen. Controleer de opmerkingen onder de tabel voor eventuele uitzonderingen en versievereisten. ### Integraties Onze integraties omvatten: [Ruby gem](/ruby), [Elixir-pakket](/elixir), [Node.js-pakket](/nodejs) en [Python-pakket](/python). |   | x86 32-bit | x86 64-bit | ARM 64-bit | | ------------------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ | --------------------------------------------------------------------- | | [macOS/OSX](#macos) 1 | |
|
| | [Linux](#linux) | | | | |    - [Alpine Linux](#alpine-linux) | |
|
   2
| |    - [CentOS](#centos) |
|
|
| |    - [Debian / Ubuntu](#debian-ubuntu) |
|
|
| |    - [Fedora](#fedora) |
|
|
| | [FreeBSD](#freebsd) 1 3 | |
?
| | | [Microsoft Windows](#microsoft-windows)4 | | | | |    - [Subsystem for Linux](#microsoft-windows-subsystem-for-linux) | |
? 4
| | * `1`: Ondersteunt geen [host metrics][host-metrics]. * `2`: Niet ondersteund voor onze Node.js-integratie. * `3`: Ondersteuningsniveau onduidelijk, zie [FreeBSD](#freeBSD). * `4`: Werkt niet native op [Windows](#microsoft-windows). AppSignal biedt geen officiële ondersteuning voor het [Windows Subsystem for Linux](#microsoft-windows-subsystem-for-linux). ### Componenten Aanvullende componenten omvatten: [Collector](/collector), [Standalone agent](/standalone-agent/installation/docker-image), [Wrap](/wrap). |   | x86 64-bit | ARM 64-bit | | ----------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | | macOS/OSX |
|
| | Linux | | | |    - Alpine Linux |
1
|
1
| |    - CentOS |
|
| |    - Debian / Ubuntu |
|
| | Microsoft Windows2 | | | |    - Subsystem for Linux |
? 2
|
? 2
| | Docker image |
3
|
3
| Er hoeven geen aanvullende dependencies te worden geïnstalleerd voor deze componenten, tenzij vermeld in hun installatiehandleidingen. * `1`: Alpine Linux wordt alleen ondersteund door [Wrap](/wrap). * `2`: Werkt niet native op [Windows](#microsoft-windows). AppSignal biedt geen officiële ondersteuning voor het [Windows Subsystem for Linux](#microsoft-windows-subsystem-for-linux). * `3`: [Wrap](/wrap) is niet beschikbaar als Docker image. ## Linux AppSignal probeert Linux zo goed mogelijk te ondersteunen, maar enkele wijzigingen in ons buildproces hebben problemen veroorzaakt bij het ondersteunen van bepaalde Linux-distributies en -versies. Onze agent en extension worden gecompileerd tegen libc, en op basis van welke versie van libc we compileren, ondersteunen we bepaalde oudere versies van Linux-distributies en sommige niet. ### Ondersteunde versies De AppSignal-ondersteuning voor versies van libc is in de afgelopen versies van de Ruby gem en het Elixir-pakket veranderd. Dit is de lijst met versies van libc/musl waartegen AppSignal is gecompileerd over de afgelopen versies van onze integraties: * AppSignal voor Ruby `v1.0.0` - `v2.0.x`
AppSignal voor Elixir `v0.0.x` - `v0.10.x` * libc `v2.5` * musl `N/A` * AppSignal voor Ruby `v2.1.x` - `v2.3.x`
AppSignal voor Elixir `v0.11.x` - `v1.3.x` * libc `N/A` - zie [bekend probleem met DNS-timeouts](/support/known-issues/dns-timeouts). * musl `v1.1.16` * AppSignal voor Ruby `v2.4.x` en hoger
AppSignal voor Elixir `v1.4.x` en hoger
AppSignal voor Node.js `v1.0.0` en hoger
AppSignal voor Python `v0.1.0` en hoger * libc `v2.15` * musl `v1.1.16` Als uw systeem een oudere libc-versie gebruikt dan de AppSignal-extension is gecompileerd tegen, zult u problemen ondervinden bij het installeren of uitvoeren van de AppSignal-agent. Als dit het geval is, kunt u in plaats daarvan [opt-in voor de musl-build](#musl-build-override), die dit probleem niet heeft. Dit zou geen probleem meer moeten zijn voor AppSignal Ruby gem `v2.4.1` & Elixir-pakket `v1.4.3` en hoger; in deze pakketten is automatische detectie voor oudere libc-versies toegevoegd en ze schakelen automatisch over naar de musl-build. **Waarschuwing voor JRuby**: JRuby-ondersteuning op Alpine Linux (musl-build) wordt ondersteund sinds Ruby gem `2.8.0`. Dit scenario vereist een dynamische build van de AppSignal-extension, die niet wordt ondersteund voor de musl-build voor oudere versies van de gem. U kunt zien welke versie van libc uw systeem gebruikt door het volgende commando uit te voeren: `ldd --version 2>&1` Voorbeeld van uitvoer op Ubuntu 12.04: ```bash Bash theme={null} $ ldd --version 2>&1 ldd (Ubuntu EGLIBC 2.15-0ubuntu10.18) 2.15 Copyright (C) 2012 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Written by Roland McGrath and Ulrich Drepper. ``` ### Musl-build override Om handmatig opt-in te kiezen voor de musl-build, voegt u de omgevingsvariabele `APPSIGNAL_BUILD_FOR_MUSL` toe aan uw systeemomgeving voordat u AppSignal installeert en uw applicatie compileert. Deze omgevingsvariabele is alleen nodig als onze automatische detectie de juiste architectuur niet detecteert. ```sh Shell theme={null} # For Ruby export APPSIGNAL_BUILD_FOR_MUSL=1 gem install appsignal # or with Bundler bundle install # For Elixir export APPSIGNAL_BUILD_FOR_MUSL=1 mix deps.get mix compile # For Node.js export APPSIGNAL_BUILD_FOR_MUSL=1 npm install # For Python # Not supported ``` ### Linux ARM build override De AppSignal-pakketten detecteren automatisch op ARM gebaseerde hosts en selecteren de agent en extension om te installeren voor ARM-systemen. Wanneer deze detectie niet werkt, kiest u handmatig voor de Linux ARM-build met de omgevingsvariabele `APPSIGNAL_BUILD_FOR_LINUX_ARM`. Voeg deze toe aan uw systeemomgeving voordat u AppSignal installeert en uw applicatie compileert. Deze omgevingsvariabele is alleen nodig als onze automatische detectie de juiste architectuur niet detecteert. Beschikbaar in deze pakketten: * Ruby gem 3.0.8 of nieuwer. * Elixir-pakket 2.1.8 of nieuwer. * Node.js-pakket 1.2.6 of nieuwer. Niet ondersteund in ons Python-pakket. ```sh Shell theme={null} # Set this environment variable # Note: How environment variables are set may be different for your Operating # System. export APPSIGNAL_BUILD_FOR_LINUX_ARM=1 # Run the install command, such as: bundle install, npm install, mix compile ``` ### Alpine Linux * Ruby: ondersteunt [Alpine Linux] sinds Ruby gem-versie `2.1.0`. (JRuby wordt niet ondersteund op Alpine Linux.) * Elixir: ondersteunt [Alpine Linux] sinds Elixir-pakketversie `0.11.0`. * Node.js: ondersteunt [Alpine Linux] sinds Node.js-pakketversie `3.0.2`. Niet ondersteund voor Node.js-versie `14`. In AppSignal voor Ruby versie `2.4.0` en AppSignal voor Elixir `1.4.0` zijn we begonnen met het leveren van een aparte build voor Alpine Linux. Als u heeft geüpgraded vanaf een eerdere versie en problemen heeft met het compileren van uw app, werkt onze detectie niet goed. De volgende systeemdependencies zijn vereist voor Alpine Linux: ```sh Shell theme={null} # Dependencies for the AppSignal Ruby gem apk add make gcc musl-dev musl-utils # Dependencies for the AppSignal Node.js package apk add python3 make g++ # Dependencies for the AppSignal for Elixir package version 1.7.0 and newer apk add make gcc musl-dev musl-utils # Dependencies for the AppSignal for Elixir package version 1.6.3 and older apk add make gcc musl-dev musl-utils curl ``` Voor alle integraties is de detectie gebaseerd op de uitvoer van `ldd --version`. Als uw app het programma `ldd` niet kan aanroepen of de detectie om een of andere reden niet klopt, kunt u de Alpine Linux-compatibele build forceren door een speciale omgevingsvariabele op te geven tijdens de installatie. ```sh Shell theme={null} # For Ruby export APPSIGNAL_BUILD_FOR_MUSL=1 gem install appsignal # or with Bundler bundle install # For Elixir export APPSIGNAL_BUILD_FOR_MUSL=1 mix deps.get mix compile # For Node.js export APPSIGNAL_BUILD_FOR_MUSL=1 npm install ``` #### Ruby {/* id: alpine-linux-ruby */} Voeg voor de Ruby gem dit toe aan uw `Gemfile`: ```ruby Ruby theme={null} gem "appsignal", ">= 2.1.0" # or a newer version ``` Voor de laatst beschikbare versie zie de volledige lijst op [RubyGems.org](https://rubygems.org/gems/appsignal/versions) en als u problemen ondervindt, [laat het ons weten][support]. #### Elixir {/* id: alpine-linux-elixir */} Als u het Elixir-pakket gebruikt, voeg dit dan toe aan de `deps`-sectie van uw `mix.exs`- bestand: ```elixir Elixir theme={null} {:appsignal, ">= 1.0.0"} # or a newer version ``` Voor de laatst beschikbare versie zie de volledige lijst op [Hex.pm](https://hex.pm/packages/appsignal) en als u problemen ondervindt, [laat het ons weten][support]. #### Node.js {/* id: alpine-linux-nodejs */} Als u het Node.js-pakket gebruikt, voeg dit dan toe aan de `dependencies`-sectie van uw `package.json`-bestand: ```text Text theme={null} "@appsignal/nodejs": "^3.0.2" ``` Voor de laatst beschikbare versie zie de volledige lijst op [NPM](https://www.npmjs.com/package/@appsignal/nodejs) en als u problemen ondervindt, [laat het ons weten][support]. ### CentOS CentOS wordt volledig ondersteund door de AppSignal-extension. Afhankelijk van uw CentOS-versie moet u mogelijk een ander buildtype selecteren voor AppSignal Ruby gem `v2.4.0` en AppSignal voor Elixir `v1.4.0` en hoger. De volgende systeemdependencies zijn vereist voor CentOS: ```sh Shell theme={null} # Dependencies for the AppSignal Ruby gem and Node.js package yum install gcc gcc-c++ make openssl-devel # Dependencies for the AppSignal for Elixir package version 1.7.0 and newer yum install gcc gcc-c++ make openssl-devel # Dependencies for the AppSignal for Elixir package version 1.6.3 and older yum install gcc gcc-c++ make openssl-devel curl # Dependencies for the AppSignal for Node.js package version 2.3.4 or newer, the supported Python versions are those between Python 3.7 and Python 3.10. # Dependencies for the AppSignal for Node.js package version 2.3.3 or below, the supported Python versions are those between Python 3.5 and Python 3.8. yum install python3 ``` Voor CentOS 7 en hoger is er geen probleem met het upgraden naar AppSignal voor Ruby `v2.4.0` en AppSignal voor Elixir `1.4.0` en hoger. Voor CentOS 6 en oudere versies moet u in plaats daarvan opt-in kiezen voor de musl-build voor AppSignal. Zie voor meer informatie het [Linux-gedeelte](#linux). ### Debian / Ubuntu {/* id: debian-ubuntu */} De volgende systeemdependencies zijn vereist voor Debian Linux-distributies: ```sh Shell theme={null} # Dependencies for the AppSignal Ruby gem and Node.js package apt-get update apt-get install build-essential ca-certificates # Dependencies for the AppSignal for Elixir package version 1.7.0 and newer apt-get update apt-get install build-essential ca-certificates # Dependencies for the AppSignal for Elixir package version 1.6.3 and older apt-get update apt-get install build-essential ca-certificates curl # Dependencies for the AppSignal for Node.js package version 2.3.4 or newer, the supported Python versions are those between Python 3.7 and Python 3.10. # Dependencies for the AppSignal for Node.js package version 2.3.3 or below, the supported Python versions are those between Python 3.5 and Python 3.8. apt-get install python3 ``` ### Fedora De volgende systeemdependencies zijn vereist voor Fedora Linux-distributies: ```sh Shell theme={null} # Dependencies for the AppSignal Ruby gem dnf install gcc gcc-c++ make openssl-devel # Dependencies for the AppSignal for Elixir package version 1.7.0 and newer dnf install gcc gcc-c++ make openssl-devel # Dependencies for the AppSignal for Elixir package version 1.6.3 and older dnf install gcc gcc-c++ make openssl-devel curl # Dependencies for the AppSignal for Node.js package version 2.3.4 or newer, the supported Python versions are those between Python 3.7 and Python 3.10. # Dependencies for the AppSignal for Node.js package version 2.3.3 or below, the supported Python versions are those between Python 3.5 and Python 3.8. dnf install python3 ``` ## FreeBSD Ons niveau van FreeBSD-ondersteuning is momenteel onduidelijk. Onze tests tonen aan dat het werkt op FreeBSD 11, maar we hebben het op FreeBSD 12 en nieuwer geen gegevens kunnen laten rapporteren. Ga ervan uit dat het op FreeBSD 12 en nieuwer geen gegevens zal rapporteren. Ondersteuning voor FreeBSD-systemen is toegevoegd in AppSignal voor Ruby gem `2.4.0` en AppSignal voor Elixir-pakket `1.4.0`. Het ondersteunt momenteel niet de [host metrics][host-metrics]-functie. De volgende systeemdependencies zijn vereist voor FreeBSD Linux-distributies: ```sh Shell theme={null} pkg install gcc gmake openssl-devel # Dependencies for the AppSignal for Node.js package version 2.3.4 or newer, the supported Python versions are those between Python 3.7 and Python 3.10. # Dependencies for the AppSignal for Node.js package version 2.3.3 or below, the supported Python versions are those between Python 3.5 and Python 3.8. pkg install python3 ``` ## macOS macOS (OS X) `10.14.x` en hoger wordt ondersteund door AppSignal voor Ruby, Elixir & Node.js. Het ondersteunt momenteel niet de [host metrics][host-metrics]-functie. Zorg ervoor dat Xcode is geïnstalleerd met de command line build tools. ```sh Shell theme={null} xcode-select --install # Dependencies for the AppSignal for Node.js package version 2.3.4 or newer, the supported Python versions are those between Python 3.7 and Python 3.10. # Dependencies for the AppSignal for Node.js package version 2.3.3 or below, the supported Python versions are those between Python 3.5 and Python 3.8. brew install python@3 ``` ## Microsoft Windows We hebben momenteel geen plannen om het besturingssysteem [Microsoft Windows](https://www.microsoft.com/en-us/windows/) te ondersteunen. We proberen wel om de AppSignal-bibliotheken installeerbaar te maken op Microsoft Windows zonder fouten of build-issues, zodat de app waarin deze is geïnstalleerd blijft functioneren. Als u Microsoft Windows gebruikt en wilt dat we het ondersteunen, [stuur ons dan een e-mail][support]. ### Ruby Om de AppSignal Ruby gem te installeren op Microsoft Windows, zorg ervoor dat u de [RubyInstaller](https://rubyinstaller.org/) DevKit heeft geïnstalleerd voordat u AppSignal installeert. Anders zal de volgende fout optreden tijdens de installatie van onze C-extension. We zullen de C-extension niet installeren op Microsoft Windows, maar de Ruby-installatie detecteert dat deze deel uitmaakt van de gem en zal niet doorgaan zonder de DevKit. ```sh Shell theme={null} $ gem install appsignal Fetching appsignal 2.2.1 Installing appsignal 2.2.1 with native extensions Gem::InstallError: The 'appsignal' native gem requires installed build tools. Please update your PATH to include build tools or download the DevKit from 'http://rubyinstaller.org/downloads' and follow the instructions at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit' ``` ### Microsoft Windows Subsystem for Linux We bieden geen ondersteuning voor het Microsoft Windows Subsystem for Linux. Het [Microsoft Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about) (WSL) is een laag tussen Microsoft Windows en een [Linux](#linux)-distributie. Dit maakt het mogelijk om bepaalde GNU/Linux-distributies, die beschikbaar zijn in de Microsoft Store, te draaien op uw Microsoft Windows-computer. Het draaien van een app op WSL met een AppSignal-integratie zal geen fouten of build-issues veroorzaken, zoals beschreven in het gedeelte [Microsoft Windows](#microsoft-windows). Het draaien van AppSignal op WSL werkt zo goed als WSL het ondersteunt. Volg de stappen voor uw [Linux-distributie](#linux) op deze pagina in de WSL-omgeving om de AppSignal-dependencies correct te installeren, voordat u AppSignal in uw app installeert. In onze tests met behulp van Ubuntu WSL hebben we ontdekt dat de meeste AppSignal-functies werken, maar we kunnen niet zeggen hoe nauwkeurig de daarmee verzamelde informatie is. Sommige kleine verschillen tussen de implementatie van WSL en onze Linux-testsetups kunnen vreemd gedrag of het onnauwkeurig rapporteren van metrics veroorzaken. We testen niet actief tegen WSL en kunnen de succesvolle werking ervan niet garanderen. We bieden geen ondersteuning voor AppSignal op de WSL. Niet alle AppSignal-functies werken op het WSL-systeem; in onze tests hebben we bevestigd dat [host metrics](/metrics/host-metrics) voor disks (gebruik en IO) niet werken. Gebruik het WSL-systeem om de integratie van AppSignal met uw app in een ontwikkelomgeving te testen, maar gebruik deze setup niet in een productieomgeving. Test uw app altijd eerst met AppSignal in een stagingomgeving met een vergelijkbare omgeving (besturingssysteem) als de productieomgeving van de app. [alpine linux]: https://alpinelinux.org/ [musl]: https://www.musl-libc.org/ [rust]: https://www.rust-lang.org/en-US/ [host-metrics]: /metrics/host-metrics.html [support]: mailto:support@appsignal.com