Add Context

自定义上下文允许您将任意数据附加到事件。通常，此上下文在其生命周期中捕获的任何 issue 之间都是共享的。您无法搜索这些，但可以在 issue 页面上查看它们：

Structured Context

附加自定义 data 的最佳实践是通过结构化上下文。上下文必须始终是一个 dictionary 或 map，它的值可以是任意的。使用setContext 并给 context 一个唯一的名称：

import 'package:sentry/sentry.dart';

final person = {
  'name': 'Mighty Fighter',
  'age': '19',
};
Sentry.configureScope((scope) => scope.setContexts('person', person));

命名上下文或其字段没有任何限制。但是，对于通用上下文有一组约定。有关更多信息，请参阅 contexts interface developer documentation。

Size Limitations

发送上下文时，请考虑有效负载大小限制。 Sentry 不建议在上下文中发送整个应用程序状态和大数据 blob。如果超过最大有效负载大小，Sentry 将响应 413 Payload Too Large，并拒绝该事件。使用 keepalive: true 时，该请求可能会永远保持待处理状态。

Sentry SDK 将尽最大努力容纳您发送的数据并修剪大型上下文有效负载或将其完全截断。有关更多详细信息，请参阅 developer documentation on SDK data handling。

Additional Data

除了结构化上下文（structured contexts），Sentry 还支持通过 setExtra 添加非结构化 "Additional Data"。Additional Data 已经废弃，而应使用结构化上下文，并应尽可能避免使用。