Skip to main content

Options

An option passed to manifest() replaces its environment variable. The SDK starts once per process, so a new configuration needs a restart. In PHP, a second manifest() call does update the key, the address and the callback. The Hermes plugin reads MNFST_KEY and MNFST_URL. HERMES_TRACE_DIR sets the folder where the plugin writes its log.

The callback

The callback is a function of yours that the SDK runs after each recoverable request. It receives one event with six fields: url, status_code, heal_status, replay_status_code, heal_ms and operations. Node and PHP write the names in camelCase. With patched or unverified, a replay_status_code of None in Python or null in Node and PHP means the SDK could not send the retry. Your app then received the original error.

What leaves your app

For every request, the SDK sends the method, the URL without its query string, the status code, the latency and the date. The path of the URL is sent as it is, so an ID inside the path reaches Manifest. For a recoverable request, it also sends the headers, the body and the error. It masks keys, tokens and passwords in the query string and the headers. It removes top-level body fields named like a key, a token or a password, and puts them back for the retry. A secret in a nested field, and other personal data in the body, reach Manifest. Your app waits for the patch up to 60 seconds in Python and Node, 10 in PHP and 20 in Hermes, then receives the original error.