granola-observability

用途

Granola Observability 用于监控 Granola 的使用情况、追踪团队会议模式，并构建分析仪表板。它面向需要衡量 Granola 采用率、会议效率与运营健康状况的组织，尤其是拥有 Granola Business 或 Enterprise 计划的管理员。

主要能力

内置分析（Enterprise）

在 Settings > Analytics（Enterprise 计划）访问分析仪表板，可查看以下指标：

捕获的会议总数：随时间变化的会议量
活跃用户：本周期内录制会议的用户
捕获时长：转录的会议总小时数
分享的笔记：笔记分发的频率
创建的行动项：组织内提取的行动项
采用率：活跃用户 / 总授权席位

关键指标定义

方案建议追踪以下指标：

采用类：激活率（目标 >80%，公式：有 1+ 次会议的用户 / 总席位）、周活跃用户（目标 >70%，公式：本周录制会议的用户 / 总席位）
质量类：捕获率（目标 >70%，公式：捕获的会议 / 日历会议总数）、分享率（目标 >50%，公式：分享的笔记 / 创建的笔记）
效率类：节省时间（目标 >10 分钟/会议，公式：调查：手动记笔记时间 - Granola 时间）、行动完成率（目标 >80%，公式：完成的行动 / 创建的行动）
健康类：处理成功率（目标 >99%，公式：成功增强 / 总尝试）、集成正常运行时间（目标 >99%，公式：成功同步 / 总同步尝试）

自定义分析管道

通过 Zapier 将会议元数据从 Granola 流式传输到数据仓库。示例管道为 Granola → BigQuery：

触发器：Granola — Note Added to Folder（"All Meetings"）
步骤 1：Code by Zapier 提取元数据（meeting_id、title、date、creator、attendee_count、has_action_items、action_item_count、has_decisions、word_count、is_external、workspace、captured_at）
步骤 2：BigQuery 插入行，数据集 meeting_analytics，表 granola_meetings

BigQuery 表结构：

CREATE TABLE meeting_analytics.granola_meetings (
  meeting_id STRING NOT NULL,
  title STRING,
  date TIMESTAMP,
  creator STRING,
  attendee_count INT64,
  has_action_items BOOL,
  action_item_count INT64,
  has_decisions BOOL,
  word_count INT64,
  is_external BOOL,
  workspace STRING,
  captured_at TIMESTAMP
);

分析查询

方案提供多类查询示例：

按工作区统计每周会议量（含行动项总数、平均参会人数）
采用率：每周活跃用户数
会议效率评分（有行动项 + 有决策 + 参会人数 ≤ 8 为 Efficient；满足其一为 Partially Efficient；否则为 Low Efficiency）
外部与内部会议比例

自动化报告

通过 Zapier Schedule 实现每周 Slack 摘要：

触发器：Schedule by Zapier — 每周五下午 5 点
步骤 1：BigQuery 运行查询（统计会议数、行动项、活跃用户）
步骤 2：Slack 发送消息到 #leadership

健康监控与告警

可配置的告警包括：

低采用率：周活跃用户 < 席位的 50%，发送到 Slack #it-alerts
处理失败：每日增强失败 >5%，发送到 PagerDuty
集成中断：每小时 Slack/Notion/CRM 同步失败 >3，发送到 Slack #it-alerts
零会议捕获：每日任何工作区无会议，发送邮件给工作区管理员

状态监控命令：

curl -s https://status.granola.ai/api/v2/status.json | python3 -c "
import json, sys
data = json.load(sys.stdin)
status = data.get('status', {}).get('description', 'Unknown')
print(f'Granola Status: {status}')
"

使用方式

查看内置分析并建立基线
构建自定义分析管道，将数据流式传输到数据仓库
创建仪表板，可视化采用率、效率与会议模式
向利益相关者发送自动化周报/月报
为运营问题配置健康监控告警

适用场景

追踪团队会议模式与采用率
衡量 Granola 对组织的影响
构建自定义分析仪表板
监控运营健康状况并设置告警

限制与前提

需要 Granola Business 或 Enterprise 计划
组织级分析需要管理员权限
自定义仪表板可选 BigQuery/Metabase，数据管道可选 Zapier
错误处理：管道数据缺失（检查 Zap 历史并重连）、BigQuery 重复条目（添加去重，如 MERGE 或 INSERT IGNORE）、仪表板数据陈旧（监控 Zapier 健康并重启暂停的 Zap）、低采用率告警误报（调整阈值，使用百分比而非绝对值）

示例

可用虚构会议事件测试告警，并记录 dashboard=meeting-r6; alert=delivery-lag; probe=pass; destination=restricted-ops; metrics=aggregate-only; retention=14d; rollback=alert-r5。可观测性证据中切勿包含转录、参会者或会议主题字段。

资源

Granola Updates
Enterprise API
Status Page

后续步骤

进入 granola-incident-runbook 了解事件响应流程。