# logging

Python API: `depthai_nodes.logging`

## 类

### LogLevel

depthai-nodes 配置接受的日志级别名称。

#### 属性

##### CRITICAL

##### DEBUG

##### ERR

##### INFO

##### WARN

## 函数

### get_log_level

```python
def get_log_level(level_str: str | None) -> LogLevel | None:
```

解析不区分大小写的日志级别。

参数

 * `level_str` (`str | None`): 级别名称，或 `None`。DepthAI `OFF` 映射到 `WARN`，`TRACE` 映射到 `INFO`。

返回

 * `LogLevel | None`: 匹配的 `LogLevel`，或 `None`（如果省略级别）。

抛出

 * `ValueError`: 如果名称无法识别。

### get_logger

```python
def get_logger(name: str | None = None) -> logging.Logger:
```

获取包日志记录器或其子日志记录器之一。

参数

 * `name` (`str | None`): `depthai-nodes` 日志记录器下的可选子名称。

返回

 * `logging.Logger`: 如果未提供名称，则为包日志记录器，否则为其命名子日志记录器。

### setup_logging

```python
def setup_logging(level: str | None = None, file: str | None = None):
```

全局配置 depthai_nodes 包的日志记录。

参数

 * `level` (`str | None`): 日志级别。可以是 "CRITICAL"、"DEBUG"、"ERR"、"INFO" 和 "WARN" 之一。可以使用 "DEPTHAI_NODES_LEVEL" 环境变量更改。如果未设置，则默认为
   "DEPTHAI_LEVEL"（如果已设置）或 "WARN"。
 * `file` (`str | None`): 日志将保存到的文件路径。如果为 None，则不会保存日志。默认为 None。
