datadog-app

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Datadog Apps

Use this skill when a developer is building a Datadog Apps project with TypeScript, React, published packages, and the normal production Datadog site. If the user is modifying Datadog platform packages or testing package source changes, use a platform-engineer-oriented workflow instead.

当开发者使用 TypeScript、React、已发布的 packages 和正式 Datadog 站点构建 Datadog Apps 项目时，使用此 skill。如果用户正在修改 Datadog 平台 packages 或测试 package 源码变更，应改用面向平台工程师的工作流。

Overview

概览

Datadog Apps are locally developed web apps built with React and TypeScript or JavaScript. Use Apps when a project needs source control, code review, CI/CD, multi-engineer collaboration, AI-assisted local development, custom UI or logic, or backend code that integrates with services beyond low-code App Builder. Apps share App Builder's permissions model and can be embedded in Datadog surfaces such as dashboards and the Internal Developer Portal.

Datadog Apps 是使用 React 和 TypeScript 或 JavaScript 在本地开发的 Web 应用。当项目需要版本控制、代码审查、CI/CD、多工程师协作、AI 辅助的本地开发、自定义 UI 或逻辑，或者需要通过后端代码与低代码 App Builder 之外的服务集成时，可以使用 Apps。Apps 沿用 App Builder 的权限模型，并可嵌入 Datadog 的各类界面，例如 dashboard 和 Internal Developer Portal。

Reference Routing

参考资料路由

Read only the reference needed for the user's task:

User task	Read
Create, scaffold, configure prerequisites, or run locally	`references/getting-started.md`
Build, upload, publish, upload without publishing, add upload-no-publish script, configure Datadog site, or understand upload output	`references/build-upload-publish.md`
Add or update GitHub Actions deployment	`references/cicd.md`
Trigger or poll Workflow Automation from a backend function	`references/workflow-http-trigger.md`
Get started querying data from a Datadog App	`references/querying-data/getting-started.md`
Understand or configure Action Catalog connections	`references/querying-data/connections.md`
Query Datadog App datastores with DDSQL	`references/querying-data/ddsql/datastores.md`
Upgrade Datadog Apps dependencies or compare with a freshly scaffolded app	`references/upgrading.md`
Diagnose OAuth, API/application key auth, upload, Node, site, or backend function failures	`references/troubleshooting.md`

仅阅读用户任务所需的参考资料：

用户任务	阅读
创建脚手架、配置前置条件或在本地运行	`references/getting-started.md`
构建、上传、发布、不发布直接上传、添加 upload-no-publish 脚本、配置 Datadog 站点或了解上传输出	`references/build-upload-publish.md`
添加或更新 GitHub Actions 部署	`references/cicd.md`
从后端函数触发或轮询 Workflow Automation	`references/workflow-http-trigger.md`
开始查询 Datadog App 中的数据	`references/querying-data/getting-started.md`
了解或配置 Action Catalog 连接	`references/querying-data/connections.md`
使用 DDSQL 查询 Datadog App datastore	`references/querying-data/ddsql/datastores.md`
升级 Datadog Apps 依赖或与新创建的脚手架应用进行比较	`references/upgrading.md`
排查 OAuth、API/application key 身份验证、上传、Node、站点或后端函数故障	`references/troubleshooting.md`

Boundaries

边界

After scaffolding or when working inside an existing app, read the app project's
```
AGENTS.md
```
before making changes.
For backend function implementation details, rely on the generated app project's
```
AGENTS.md
```
; this skill only covers local development auth choices and troubleshooting.
Preserve the app project's existing package manager, scripts, Datadog site, and repository conventions.
Do not cover Datadog package/platform development in this skill.
Low-code App Builder to Datadog Apps migration guidance is future work. Do not invent a migration process yet.

完成脚手架创建后，或在现有 app 中工作时，在进行更改前先阅读 app 项目的
```
AGENTS.md
```
。
对于后端函数的具体实现，请以生成的 app 项目中的
```
AGENTS.md
```
为准；此 skill 仅涵盖本地开发身份验证选择和故障排查。
保留 app 项目现有的 package manager、scripts、Datadog 站点和 repository 约定。
此 skill 不涵盖 Datadog package 或平台开发。
从低代码 App Builder 迁移到 Datadog Apps 的指导属于未来工作。目前不要臆造迁移流程。