# context

Python API: `luxonis_ml.telemetry.context`

## 函数

### base_context

```python
def base_context(*, library_name: str, library_version: str | None, session_id: str, source_component: str | None) -> dict[str, Any]:
```

为所有事件创建基本上下文。

> **注意**
> `$process_person_profile` 有意设置为 False。它使 PostHog 捕获匿名，因此 PostHog 不会创建人员配置文件。请勿将其更改为 True。

参数

 * `library_name` (`str`): 发送库的名称。
 * `library_version` (`str | None`): 库的版本字符串。
 * `session_id` (`str`): 随机会话 ID。它在
   [luxonis_ml.telemetry.Telemetry](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/client.md)
   实例的生命周期内保持不变，而不是在进程的生命周期内。PostHog 后端也将其用作默认的 `distinct_id`。
 * `source_component` (`str | None`): 发送器的可选组件名称。如果省略，则重用库名称。

返回

 * `dict[str, Any]`: 附加到事件的共享基本上下文。它包含 `$process_person_profile`、`$session_id`、`source_product`、`source_component` 和
   `sdk_version`。

### host_context

```python
def host_context() -> dict[str, Any]:
```

返回用于可选事件上下文的粗略主机元数据。

返回

 * `dict[str, Any]`: `os`、`os_version`、`arch` 和 `python_version` 的映射。

### host_context_provider

```python
def host_context_provider(_telemetry: object) -> dict[str, Any]:
```

公开粗略主机元数据的上下文提供程序。

### is_ci

```python
def is_ci() -> bool:
```

尽力检测 CI 环境。

### is_luxonis_cloud

```python
def is_luxonis_cloud() -> bool:
```

当遥测在 Luxonis 云中运行时返回 True。

### normalized_processor

```python
def normalized_processor() -> str:
```

返回用于遥测的粗略处理器系列。

原始的 `platform.processor`
字符串永远不会离开机器。[host_context](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/context.md)
仍然将 `platform.machine` 值作为 `arch` 发送。

返回

 * `str`: `"arm64"`、`"arm"`、`"x86_64"`、`"x86"`、`"powerpc"`、`"riscv"` 或 `"unknown"` 之一。

### system_context

```python
def system_context() -> dict[str, Any]:
```

返回用于可选事件上下文的扩展运行时元数据。

返回

 * `dict[str, Any]`:
   [host_context](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/context.md)
   的键，以及 `ci`、`is_luxonis_cloud`、`processor`（来自
   [normalized_processor](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/context.md)
   的粗略系列）、`cpu_count` 和 `is_docker`。

### system_context_provider

```python
def system_context_provider(_telemetry: object) -> dict[str, Any]:
```

公开扩展运行时元数据的上下文提供程序。

## 属性

### RESERVED_METADATA_KEYS
