Skip to main content
Excon ist eine HTTP-Client-Bibliothek für Ruby. AppSignal instrumentiert Excon-Requests automatisch, wenn das Excon-gem beim Start erkannt wird. Es ist keine manuelle Einrichtung erforderlich.

​
Performance-Monitoring

Mit Excon ausgeführte Requests erscheinen in der Event-Timeline der Performance-Actions Ihrer Anwendung als request.excon-events, wobei die Request-Methode und der Host angezeigt werden. Sie erscheinen außerdem im Performance-Panel „Slow API requests”, in dem Sie die Requests überprüfen können, die Ihre Anwendung an andere Dienste stellt, sowie deren Auswirkungen auf die Performance. Requests, die über Faraday mit dessen Excon-Adapter gestellt werden, werden einmal als Faraday-event aufgezeichnet.

​
Was ein Event abdeckt

Wenn Excon einen Request wiederholt oder einer Weiterleitung folgt, zeichnet AppSignal ein Event auf, das jeden Versuch bzw. jeden Hop abdeckt. Frühere Versionen zeichneten einen Request als mehrere Events auf. Ein pipelined Request ist die Ausnahme. Excon kehrt davon zurück, bevor die Response gelesen wird, sodass dessen Event nur das Senden des Requests abdeckt.

​
Deaktivieren der Integration

Um die Excon-Integration zu deaktivieren, setzen Sie die Konfigurationsoption instrument_excon auf false.

​
Span-Attribute

Nur im Collector-Modus: Dies gilt, wenn AppSignal für Ruby im Collector-Modus läuft. Andernfalls hat es keine Auswirkung.
Der Span des Requests enthält:
  • http.request.method — die Request-Methode.
  • server.address und server.port — der aufgerufene Host.
  • url.full — die vollständige Request-URL.
  • http.response.status_code — der Status, mit dem der andere Dienst geantwortet hat.

​
Distributed tracing

Nur im Collector-Modus: Dies gilt, wenn AppSignal für Ruby im Collector-Modus läuft. Andernfalls hat es keine Auswirkung.
Anfragen, die mit dieser Bibliothek gestellt werden, tragen den aktuellen Trace über einen traceparent-Request-Header an den aufgerufenen Service weiter. Wenn dieser Service ebenfalls an AppSignal berichtet, wird seine Arbeit Teil desselben Trace. Sie können eine langsame ausgehende Anfrage öffnen und sehen, womit der andere Service seine Zeit verbracht hat. Die von AppSignal unterstützten HTTP-Server setzen den Trace fort. Jeder andere Service startet einen eigenen.