@arizeai/phoenix-config

中文文档
0.5.1发布于 2026/10/22Apache-2.0TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 27万

凤凰城中央配置

中文使用文档
文档目录10 节
  1. 安装
  2. 环境变量
  3. 证书文件发现( I) .env.phoenix (中文(简体) )
  4. 使用量
  5. 读取全部配置
  6. 解决工程名称
  7. 读取个人价值
  8. 使用常数
  9. 类型
  10. 社区

Arize Phoenix logo
@arizeai/凤凰-配置

NPM Version Documentation

共享配置解析全局使用的公用设施 @arizeai/phoenix-otel 财务报告和审定财务报表 @arizeai/phoenix-client。为阅读凤凰城环境变量提供输入的帮助.

安装

npm install @arizeai/phoenix-config

环境变量

变量常数说明
PHOENIX_ENDPOINTENV_PHOENIX_ENDPOINTAPI 访问的凤凰基地 URL
PHOENIX_HOSTENV_PHOENIX_HOSTPhoenix 服务器绑定主机; 仅读作 API 基础 URL 的后退
PHOENIX_API_KEYENV_PHOENIX_API_KEY凤凰城认证的 API 密钥
PHOENIX_CLIENT_HEADERSENV_PHOENIX_CLIENT_HEADERSJSON 客户端请求的自定义头
PHOENIX_COLLECTOR_ENDPOINTENV_PHOENIX_COLLECTOR_ENDPOINTOTel 收藏器端点 URL
PHOENIX_PORTENV_PHOENIX_PORTPhoenix HTTP 端口( 整数)
PHOENIX_GRPC_PORTENV_PHOENIX_GRPC_PORT凤凰GRPC 端口用于 OpenTeleometry (整数)
PHOENIX_PROJECTENV_PHOENIX_PROJECT项目范围操作的默认项目名称( canonical)
PHOENIX_PROJECT_NAMEENV_PHOENIX_PROJECT_NAME支持的别名 PHOENIX_PROJECT
PHOENIX_LOG_LEVELENV_PHOENIX_LOG_LEVEL日志动词 : debug, (中文(简体) ), info, (中文(简体) ), warn, (中文(简体) ), error,或 silent
PHOENIX_DISCOVER_CONFIGENV_PHOENIX_DISCOVER_CONFIG设定为 false 无法禁用 .env.phoenix 文件发现

证书文件发现( I).env.phoenix(中文(简体) )

当进程环境中没有设置凤凰城设置时, 帮助者会查看 (单位:千美元) .env.phoenix 当前工作目录中的文件——向上走 文件系统根并停止在第一次匹配中——并读取 PHOENIX_- 其前缀密钥( dotenv格式) :

添加 .env.phoenix 在存储证书之前忽略规则 在此文件中(凤凰城寄存器已忽略它) .

# .env.phoenix
PHOENIX_COLLECTOR_ENDPOINT=http://localhost:6006
PHOENIX_API_KEY=your-api-key

进程环境变量总是优先——文件从不覆盖 任何已设置的键 PHOENIX_ 前缀被忽略。 相关 设置按组解决:当任何证书时(PHOENIX_API_KEY, (中文(简体) ), PHOENIX_CLIENT_HEADERS) 设置在进程环境中,文件被忽略 用于整个证书组,所以程序和文件证书从来不是混合的. 设定 PHOENIX_DISCOVER_CONFIG=false 完全禁用发现.

一个终点从 .env.phoenix 仍可结合提供全权证书 明确或通过过程环境。 消费者发出一次性警告 指定证书来源、端点变量和已发现文件的大小写; 认证值从未被记录 。 了解来源的消费者应使用 getStrFromEnvironmentWithSource() 财务报告和审定财务报表 getCredentialsFromEnvironmentWithSource() 而不是重建 源层本身.

发现结果被缓存到每个工作目录中 进程(包括没有文件)。 创建长期运行的进程 第一个配置搜索后的文件可以调用 clearEnvFileCache() 改为 重新发现它.

使用量

读取全部配置

import { getEnvironmentConfig } from "@arizeai/phoenix-config";

const config = getEnvironmentConfig();
// Returns a typed object with all recognized Phoenix env vars:
// {
//   PHOENIX_HOST: "http://localhost:6006",
//   PHOENIX_API_KEY: "my-key",
//   PHOENIX_CLIENT_HEADERS: { "X-Custom": "value" },
//   PHOENIX_COLLECTOR_ENDPOINT: "http://localhost:6006",
//   PHOENIX_PORT: 6006,
//   PHOENIX_GRPC_PORT: 4317,
//   PHOENIX_LOG_LEVEL: "info",
//   PHOENIX_PROJECT: "my-project",
// }

解决工程名称

PHOENIX_PROJECT 是条形工程名称变量; PHOENIX_PROJECT_NAME 是一个支持的别名。 使用 getProjectFromEnvironment() 以 正确的优先级(PHOENIX_PROJECT 赢; 如果 两者被设定为相互冲突的价值观:

import { getProjectFromEnvironment } from "@arizeai/phoenix-config";

const project = getProjectFromEnvironment();
// Reads PHOENIX_PROJECT, then PHOENIX_PROJECT_NAME, or undefined if neither is set

读取个人价值

import {
  getStrFromEnvironment,
  getIntFromEnvironment,
  getHeadersFromEnvironment,
  ENV_PHOENIX_ENDPOINT,
  ENV_PHOENIX_PORT,
  ENV_PHOENIX_CLIENT_HEADERS,
} from "@arizeai/phoenix-config";

// Read a string environment variable
const endpoint = getStrFromEnvironment(ENV_PHOENIX_ENDPOINT);
// Returns "http://localhost:6006" or undefined

// Read an integer environment variable
const port = getIntFromEnvironment(ENV_PHOENIX_PORT);
// Returns 6006 or undefined

// Read and parse a JSON-encoded headers object
const headers = getHeadersFromEnvironment(ENV_PHOENIX_CLIENT_HEADERS);
// Returns { "Authorization": "Bearer token" } or undefined

使用常数

import {
  ENV_PHOENIX_ENDPOINT,
  ENV_PHOENIX_HOST,
  ENV_PHOENIX_API_KEY,
  ENV_PHOENIX_CLIENT_HEADERS,
  ENV_PHOENIX_COLLECTOR_ENDPOINT,
  ENV_PHOENIX_PORT,
  ENV_PHOENIX_GRPC_PORT,
  ENV_PHOENIX_PROJECT_NAME,
  ENV_PHOENIX_PROJECT,
  ENV_PHOENIX_LOG_LEVEL,
} from "@arizeai/phoenix-config";

// Use constants instead of raw strings to avoid typos
const apiKey = process.env[ENV_PHOENIX_API_KEY];

类型

import type { EnvironmentConfig } from "@arizeai/phoenix-config";
// Inferred return type of getEnvironmentConfig()

社区

加入我们的社区,与成千上万的人工智能建设者建立联系:

版本与发布记录

@arizeai/phoenix-config 共发布 11 个版本,首次发布于 2025/12/19;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.5.1latest2026/10/2217 天前
0.5.02026/08/082 个月前
0.4.02026/07/153 个月前
0.3.02026/07/113 个月前
0.2.02026/07/093 个月前
0.1.42026/05/046 个月前

关于 @arizeai/phoenix-config 的常见问题

@arizeai/phoenix-config 是什么?

凤凰城中央配置

如何安装 @arizeai/phoenix-config?

在项目目录运行 npm install @arizeai/phoenix-config,或使用 pnpm add / yarn add / bun add。

@arizeai/phoenix-config 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@arizeai/phoenix-config 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@arizeai/phoenix-config 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@arizeai/phoenix-config 可以商用吗?

@arizeai/phoenix-config 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@arizeai/phoenix-config 的下载量有多少?

根据 npm 官方下载统计,@arizeai/phoenix-config 在 2026/10/07 – 2026/11/05 这 30 天内被下载 269,697 次,日均约 8,990 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@arizeai/phoenix-config 还在维护吗?

最新版本 0.5.1 发布于 2026/10/22(17 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2025/12/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。