facebook/sapling/edenfs-systemd-triage
Claude Code and agent skill by facebook/sapling
- community
Checking that the SKILL.md file is still in the repository.
Triage systemd-managed EdenFS issues on Linux devservers and OnDemands. Use when investigating EdenFS service failures, unexpected restarts, systemctl errors, edenfs_upgrade/edenfs_restarter problems, or when a user reports EdenFS is down on a systemd-enabled host. Also use when someone asks how systemd-managed EdenFS works, how to monitor it, or how to check its health. Use when asked to build a timeline of EdenFS lifecycle events, show edenfs restart history, or understand how edenfs reached its current state. Trigger on mentions of edenfs systemd, edenfs@ service, edenfs_upgrade timer, edenfs auto-restart, eden status --debug, systemctl edenfs, edenfs lifecycle management, edenfs timeline, edenfs restart history, or "what happened to edenfs".
Install
npx vskill@latest install facebook/sapling/edenfs-systemd-triageSKILL.md
The same SKILL.md was published earlier as facebook/sapling/edenfs-systemd-triage.
EdenFS Systemd Triage
This skill helps EdenFS team members understand, monitor, and triage systemd-managed EdenFS.
Quick Orientation
Systemd manages the EdenFS daemon lifecycle on Linux (devservers and OnDemands). When EdenFS exits unexpectedly (crash, OOM-kill), systemd automatically restarts it — no user intervention needed.
Two systemd components to know:
| Component | What it does | Scope | |
|---|---|---|---|
edenfs@.service | User-scoped service managing the edenfs daemon lifecycle (auto-restart on failure) | Per-user (systemctl --user) | |
edenfs_upgrade.timer | System-scoped hourly timer that runs edenfs_restarter to upgrade edenfs gracefully | System-wide (systemctl) |
Config gate: [experimental] systemd-managed-lifecycle = true in eden config.
How to Use This Skill
Read the reference file that matches your need:
| Need | Reference File | When to Read | |
|---|---|---|---|
| Understand the architecture | references/architecture.md | How systemd-managed EdenFS works, service unit file, lifecycle operations | |
| Check health & monitor | references/monitoring.md | Scuba queries, dashboards, success rate metrics, rollout monitoring | |
| Build a lifecycle timeline | references/timeline.md | Reconstruct chronological EdenFS events from Scuba + local logs + systemd properties to understand how the system reached its current state | |
| Triage a specific failure | references/triage-playbook.md | Step-by-step procedures for common failure scenarios | |
| Identify known failure patterns | references/common-failures.md | Error signatures, root causes, and fixes for known issues |
First-Response Checklist
When triaging an EdenFS systemd issue, start here:
- Is the user on systemd? Check:
eden config | grep systemd-managed - What's the service status? Check:
eden status --debug - What does Scuba say? Check systemctl action failures: https://fburl.com/scuba/edenfs_events/4tf01a9c
- What do the logs say? Check:
/var/facebook/logs/edenfs_upgrade.logand/var/log/messages
If you need to run commands on a user's machine via sush, you cannot use su — you must use:
Diagnostic Commands (Safe to Run Locally)
These are read-only and safe to execute automatically:
Hostname for Scuba Queries
CRITICAL: Scuba uses the short hostname (e.g., devvm21611.cco0), NOT the FQDN returned by hostname (e.g., devvm21611.cco0.facebook.com). Always strip the .facebook.com suffix:
Querying Scuba with the FQDN will silently return zero results.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingeden/.llms/skills/edenfs-systemd-triage/SKILL.md
Popularity
- Repository stars
- 6,877
- Repository forks
- 370
- 7-day trend score
- 44
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/facebook/sapling/edenfs-systemd-triage)