Question: Hook for ECONNRESETS

[somecho]

The afterResponse hook gets called when a VU receives a response. I want to emit a custom metric during ECONNRESET. In this case, afterResponse does not work since it does not get called. How do I get a hook called (to emit a custom metric or log a request body) after an ECONNRESET?

[hassy]

There's a scenario-level onError hook for use cases like this. It's not documented, but it's been in the codebase for a while now and is unlikely to be dropped in future (we try to stay backwards-compatible as much as possible). The relevant code is here: https://github.com/artilleryio/artillery/blob/main/packages/core/lib/engine_http.js#L1014

The signature is:

function myOnErrorHandler(error, requestParams, userContext, events, next) {
  events.emit('counter', `error.${error.name}`, 1);
  return next();
}

and it needs to be declared at scenario level:

scenarios:
  - name: my scenario
    onError: myOnErrorHandler
    flow:
      - get:
          url: "/"

[somecho]

Thank you! This works for me. I would be open to contributing documentation on this if there are any guidelines/instructions on how to contribute to Artillery.