Skip to content

Commit 1007705

Browse files
committed
Fix and push event.
1 parent a95e92f commit 1007705

3 files changed

Lines changed: 32 additions & 4 deletions

File tree

  • content
    • blog/2026-04-30-mini-program-monitoring-with-skywalking
    • events/mini-program-monitor-joins-skywalking-ecosystem
    • zh/2026-04-30-mini-program-monitoring-with-skywalking

content/blog/2026-04-30-mini-program-monitoring-with-skywalking/index.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,6 @@ tags:
1111
- End User Monitoring
1212
---
1313

14-
# Monitoring WeChat and Alipay Mini Programs with SkyWalking
15-
1614
Mini programs are a major part of the mobile experience in China, but the open-source observability ecosystem has long focused on web browsers and native apps. SkyWalking already covers browser (client-js), iOS, and the server side; mini programs and Android were the remaining gaps. With [SkyAPM/mini-program-monitor](https://github.com/SkyAPM/mini-program-monitor) joining the SkyWalking ecosystem, the mini-program half of that gap is closed — one SDK supports both WeChat and Alipay, and the matching OAP-side component IDs, MAL rules, and UI templates are merged on `main` and will ship with 10.5.0.
1715

1816
This post is for teams that already run a SkyWalking backend and want to bring their mini programs into the same observability stack. The interesting parts aren't *that* the project exists — they are how the data flows from a mini program to a SkyWalking dashboard, how the two platforms coexist, and what design trade-offs you should know about before rolling this out.
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: Mini Program Monitor joins SkyWalking ecosystem
3+
date: 2026-04-30
4+
author: SkyWalking Team
5+
description: "SkyAPM/mini-program-monitor joins the SkyWalking ecosystem, providing WeChat & Alipay Mini Program monitoring for Apache SkyWalking via OTLP and SkyWalking native protocols."
6+
---
7+
8+
[SkyAPM/mini-program-monitor](https://github.com/SkyAPM/mini-program-monitor) has joined the SkyWalking ecosystem.
9+
10+
The project is a monitoring agent for WeChat (微信) and Alipay (支付宝) Mini Programs that reports telemetry to Apache SkyWalking via OTLP and SkyWalking native protocols. It extends SkyWalking's end-user experience monitoring to the mini program platforms, which are a major part of the mobile experience in China.
11+
12+
### Signals
13+
14+
- **Error tracking** — JS errors, unhandled promise rejections, and page-not-found events, reported as OTLP logs with OpenTelemetry semantic conventions (`exception.type`, `exception.stacktrace`).
15+
- **Performance metrics** — app launch, first render, first paint, route navigation, script execution, and sub-package load, reported as OTLP gauge metrics.
16+
- **Request metrics**`wx.request` / `my.request`, plus `downloadFile` / `uploadFile`, reported as an OTLP delta histogram bucketed per flush interval. Failed requests (4xx/5xx/timeout) also emit error logs.
17+
- **Distributed tracing** *(opt-in)*`sw8` header propagation across outgoing requests, reported as SkyWalking `SegmentObject` to `/v3/segments`.
18+
19+
### Platform-aware backend
20+
21+
Every signal carries `miniprogram.platform: wechat | alipay` (resource attribute on OTLP, span tag on segments), and each platform has its own SkyWalking component ID (WeChat = 10002, Alipay = 10003). Operators with one WeChat and one Alipay app against the same backend can slice by platform without forcing distinct `service.name`s.
22+
23+
### Compatibility
24+
25+
- WeChat base library ≥ 2.11
26+
- Alipay base library ≥ 2.0
27+
- Apache SkyWalking OAP ≥ 10.x with the OTLP HTTP receiver
28+
- Any other OTLP-compatible backend (OpenTelemetry Collector, Grafana, etc.)
29+
30+
OTLP wire format is protobuf by default, with JSON available for debugging. Unsent events are persisted to storage on app hide and restored on next launch. The package has no runtime dependencies.
31+
32+
See the [project README](https://github.com/SkyAPM/mini-program-monitor) for installation, configuration, and a `make preview` target that boots OAP, UI, and both platform simulators for a hands-on demo.

content/zh/2026-04-30-mini-program-monitoring-with-skywalking/index.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,6 @@ tags:
1111
- End User Monitoring
1212
---
1313

14-
# 用 SkyWalking 监控微信和支付宝小程序
15-
1614
小程序是国内移动端体验里绕不过去的一块,但开源监控生态长期偏向 Web 浏览器和原生 App。SkyWalking 自身已经覆盖了浏览器(client-js)、iOS、服务端,缺口主要在小程序和 Android。[SkyAPM/mini-program-monitor](https://github.com/SkyAPM/mini-program-monitor) 加入 SkyWalking 生态后,把这块缺口的小程序部分补上了 —— 一份 SDK 同时支持微信和支付宝,OAP 端的 component、MAL 规则、UI 模板已经合进 main 分支,会随 10.5.0 一起发布。
1715

1816
这篇博客面向已经跑着 SkyWalking 后端、希望把小程序也接进来的团队。重点不是"项目存在"这件事,而是数据从小程序到 SkyWalking dashboard 走的是哪条路、双平台是怎么共存的、以及上线之前需要知道哪些设计取舍。

0 commit comments

Comments
 (0)