> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://developers.fireblocks.com/feedback

```json
{
  "path": "/docs/ew-sdk-event-collection",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# EW SDK Event Collection

<Note>
  For Fireblocks' recommended embedded wallet solution, see [Dynamic Embedded Wallets](/docs/dynamic-embedded-wallets). The documentation below covers the legacy Embedded Wallet APIs and SDKs.
</Note>

# Overview

During day-to-day operations, end users are triggering countless actions within your application.

As part of your provided user experience, end users will generate keys, sign transactions and perform additional actions such as connecting their wallet to a dApp or export their private key material. Due to the complexity and variety of actions an end user may perform, different issues or errors may arise.

In order to proactively monitor and treat such problems that may appear, the EW SDK lets you toggle whether events and logs will be automatically sent to Fireblocks, through your backend.

Thus, Fireblocks may be able to proactively suggest and point onto issues or problems that your user base is facing, providing you with the ability to resolve it before any major impact.

It's important to note Fireblocks does not retrieve any PII regarding the end user. Please review the Shared Data section to validate the data that is shared with Fireblocks.

# Configuration

As part of the `FireblocksOptions` object, you will now have a new flag, `reporting`.

<CodeGroup>
  ```bash bash theme={"system"}
  // First you need to initialize the NCW SDK with an implementation of the looger 
  const logger: IndexedDBLogger = await IndexedDBLoggerFactory({ deviceId, logger: ConsoleLoggerFactory() });

  const fireblocksNCW = await FireblocksNCWFactory({
            env: ENV_CONFIG.NCW_SDK_ENV,
            logLevel: "INFO",
            deviceId,
            messagesHandler,
            eventsHandler,
            secureStorageProvider,
            logger,
  		      reporting = { enabled: true },
          });

  // Number of logs collected
  const numberOfLogs = await logger.count();

  // Collect 10 logs 
  const logs = await logger.collect(10);

  // Clears the oldest 10 logs
  await logger.clear(10);
  ```

  ```bash bash theme={"system"}
  var fireblocksOptions = FireblocksOptions(
    env: EnvironmentConstants.env,
    eventHandlerDelegate: self,
    logLevel: .info,
    logToConsole: true,
    reporting: ReportingOptions(enabled: true)
  )
  ```

  ```bash bash theme={"system"}
  val fireblocksOptions = FireblocksOptions.Builder()
    .setLogLevel(getNCWLogLevel())
    .setLogToConsole(true)
    .setReportingOptions(ReportingOptions(enabled = false))
    .setEventHandler(object : FireblocksEventHandler {
                     override fun onEvent(event: Event) {
    // handle events
  }
  })
    .setEnv(environment)
      .build()
  ```
</CodeGroup>

**By default,`reporting` is enabled**. If you do not want to share telemetry logs with Fireblocks, just set `reporting` to false.

# Shared Data

When reporting on errors, the SDK will collect a few fields:

* type
* message
* code
* level
* method
* logs

All of these are fields that are related to the EW SDK itself, and **do not expose** any personal identifiable information (**PII**) regarding the end user.

In addition, the below items are the only metadata fields regarding the device that are transferred to Fireblocks:

* navigator\_appCodeName (e.g. Mozilla)
* navigator\_appName
* navigator\_language
* navigator\_platform
* navigator\_product
* navigator\_userAgent
* navigator\_vendor
* timezoneOffset

You may find an example payload here:

<CodeGroup>
  ```bash bash theme={"system"}
  ```

  ```bash bash theme={"system"}
  completedMPC:true
  device:iPhone14,3
  deviceId:b0550946-3d70-4e6b-949d-247549bd775f
  environment:dev9
  hasCMPKey:true
  iosVersion:16.4
  onboardedRecovery:false
  timezone:GMT+3
  uptime:timeval(tv_sec: 1716876653, tv_usec: 488161)
  ```

  ```bash bash theme={"system"}
  VersionIncremental=S.17acc52_1-1, 
  completedMPC=false, 
  Uptime= 18h29m3.942s, 
  keyStatus=ERROR, 
  Device=OnePlus/OP516FL1/NE2213/NE2213, 
  SdkVersion=2.5.0_1, 
  keyId=0743117c-f737-4f38-b5bc-2c5a0cb17209, 
  AndroidVersion=34, 
  deviceId=3ac62b9b-5bb6-4756-96ef-85015ee5f345, 
  hasCMPKey=Yes, 
  environment=dev9, 
  TimeZone=GMT+03:00, 
  onboardedRecovery=null, 
  OSVersion=5.10.198-android12-9-o-g4b6fa3fb4a9f, 
  VersionRelease=14, 
  algorithm=MPC_EDDSA_ED25519
  ```
</CodeGroup>