# Span Knowledge Base


## Productivity Metrics

- [How to setup weekend exclusion for metrics](https://help.span.app/articles/4249279792-how-to-setup-weekend-exclusion-for-metrics)
- [Total PR Cycle Time (Average)](https://help.span.app/articles/2538681936-total-pr-cycle-time-average)
- [Focus Time](https://help.span.app/articles/9601115418-focus-time)
- [PR Review Cycles](https://help.span.app/articles/6856533778-pr-review-cycles)
- [Unique PRs Reviewed / Week ](https://help.span.app/articles/3516849214-unique-prs-reviewed-week)
- [Comments Authored / Week](https://help.span.app/articles/1603121805-comments-authored-week)
- [Comments Received / Week ](https://help.span.app/articles/4857357521-comments-received-week)
- [Weighted PRs/Week](https://help.span.app/articles/9987477466-weighted-prs-week)
- [Issue Completion Rate Report](https://help.span.app/articles/4446341433-issue-completion-rate-report)
- [Issue Throughput Report ](https://help.span.app/articles/5097021225-issue-throughput-report)
- [Estimate Completed / Week Report](https://help.span.app/articles/6230420958-estimate-completed-week-report)
- [PR Link Rate Report](https://help.span.app/articles/7107507125-pr-link-rate-report)
- [Commit Days / Week Report](https://help.span.app/articles/6451153298-commit-days-week-report)
- [PRs Reviewed / Week Report](https://help.span.app/articles/4839858246-prs-reviewed-week-report)
- [Review Response Time (Average)](https://help.span.app/articles/1164437253-review-response-time-average)
- [Total Story Points Completed Report](https://help.span.app/articles/7287649703-total-story-points-completed-report)
- [Story Points Completed Per Week Report](https://help.span.app/articles/6784894529-story-points-completed-per-week-report)
- [Total PRs Merged](https://help.span.app/articles/3187582377-total-prs-merged)
- [Lines of Code](https://help.span.app/articles/2952296618-lines-of-code)
- [Comments Received / PR Report](https://help.span.app/articles/4435000046-comments-received-pr-report)
- [% of PRs Merged with Tests](https://help.span.app/articles/9144248171-of-prs-merged-with-tests)
- [% of PRs Merged Without Review](https://help.span.app/articles/4405665959-of-prs-merged-without-review)
- [PR Link Rate Report](https://help.span.app/articles/6094799918-pr-link-rate-report)
- [Custom Reports Guide](https://help.span.app/articles/1444825973-custom-reports-guide)
- [Using the Cross Team toggle in the Review Response Time Report](https://help.span.app/articles/7313101698-using-the-cross-team-toggle-in-the-review-response-time-report)
- [Sprint Tracking Report](https://help.span.app/articles/9181343308-sprint-tracking-report)
- [Review Capacity Report](https://help.span.app/articles/5393571883-review-capacity-report)
- [Benchmarking in Span](https://help.span.app/articles/4416988789-benchmarking-in-span)
- [PR Cycle Time Threshold Filter](https://help.span.app/articles/8878290429-pr-cycle-time-threshold-filter)
- [How to read Span's "/ week" metrics](https://help.span.app/articles/3982663604-how-to-read-span-s-week-metrics)
- [How Span attributes metrics to teams](https://help.span.app/articles/2394921260-how-span-attributes-metrics-to-teams)

## AI Transformation

- [Comparison Report](https://help.span.app/articles/4532067293-ai-impact-report)
- [AI Tool Adoption Report](https://help.span.app/articles/3878990628-ai-tool-adoption-report)
- [How to use Span Claude/Cursor Skill to understand your engineering org](https://help.span.app/articles/3539036287-how-to-use-span-claude-skill-to-understand-your-engineering-org)
- [How are PRs considered qualified in the AI Impact report when using Span-detect-1?](https://help.span.app/articles/1435087089-how-are-prs-considered-qualified-in-the-ai-impact-report)
- [Understanding Accepted AI Lines vs. All Merged Lines in the AI Tool Adoption report](https://help.span.app/articles/9079141332-understanding-accepted-ai-lines-vs-all-merged-lines-in-ai-adoption-report)
- [Claude Code OTEL Integration Guide](https://help.span.app/articles/9569114692-claude-code-integration)
- [Cursor Integration Guide](https://help.span.app/articles/1340441409-cursor-integration)
- [GitHub Copilot Integration Guide](https://help.span.app/articles/5406292803-github-copilot-integration-guide)
- [Understanding Multi Tool Usage on the AI Tool Adoption Page](https://help.span.app/articles/1067920239-understanding-multi-tool-usage-on-the-ai-tool-adoption-page)
- [Codex CLI Configuration Guide](https://help.span.app/articles/7360742610-codex-cli-configuration-guide)
- [Estimated Bug Density Metric](https://help.span.app/articles/9450515141-estimated-bug-density-metric)
- [Span Coding Hooks: IT Admin User Guide for Mosyle](https://help.span.app/articles/6560578311-span-coding-hooks-it-admin-user-guide)
- [AI Tool Spend Report](https://help.span.app/articles/6537829495-ai-tool-spend-report)
- [Span Coding Hooks: IT Admin User Guide for IRU (MDM)](https://help.span.app/articles/8132188791-span-coding-hooks-it-admin-user-guide-for-iru-mdm)
- [Span Coding Hooks: IT Admin User Guide Jamf Pro (MDM)](https://help.span.app/articles/1434664158-span-coding-hooks-it-admin-user-guide-jamf-pro-mdm)
- [Self Install Span Coding Hooks on macOS](https://help.span.app/articles/2904250421-self-install-span-coding-hooks-on-macos)
- [Span Agent Trace Analytics: Security Overview](https://help.span.app/articles/8922907265-span-agent-trace-analytics-security-overview)
- [Understanding Agent Traces in Span (Legacy)](https://help.span.app/articles/5451555629-understanding-agent-traces-in-span)
- [Choosing the right Claude Code Integration](https://help.span.app/articles/5716769938-choosing-the-right-claude-code-integration)
- [Agent Traces - PII Scrubbing](https://help.span.app/articles/3324197755-coding-hooks-pii-scrubbing)
- [Self Install Span Coding Hooks on Windows](https://help.span.app/articles/9538089561-self-install-span-coding-hooks-on-windows)
- [Agent Traces: Suppressing macOS Background Notification](https://help.span.app/articles/5359180620-agent-traces-suppressing-macos-background-notification)
- [Span Coding Hooks: IT Admin User Guide for Workspace ONE](https://help.span.app/articles/4672173663-span-coding-hooks-it-admin-user-guide-for-workspace-one)
- [Span Coding Hooks: IT Admin User Guide for Microsoft Intune](https://help.span.app/articles/1035932730-span-coding-hooks-it-admin-user-guide-for-microsoft-intune)
- [Span Coding Hooks: IT Admin User Guide for Rippling](https://help.span.app/articles/4549014125-span-coding-hooks-it-admin-user-guide-for-rippling)
- [Understanding Agent Traces in Span (auspex)](https://help.span.app/articles/6558012257-auspex-understanding-agent-traces)
- [Span Agent Trace Analytics: Security Overview (auspex)](https://help.span.app/articles/8296737863-auspex-security-overview)
- [Self-Install auspex on macOS](https://help.span.app/articles/3395909000-auspex-self-install-macos)
- [auspex: IT Admin User Guide for Mosyle (macOS)](https://help.span.app/articles/8349941417-auspex-install-mosyle-macos)
- [auspex: IT Admin User Guide for Workspace ONE (macOS)](https://help.span.app/articles/6154098768-auspex-install-workspace-one-macos)
- [auspex: IT Admin User Guide for IRU (Kandji) (macOS)](https://help.span.app/articles/3346787438-auspex-install-iru-kandji-macos)
- [auspex: IT Admin User Guide for Jamf Pro (macOS)](https://help.span.app/articles/8216067501-auspex-install-jamf-macos)
- [auspex: IT Admin User Guide for Microsoft Intune (macOS)](https://help.span.app/articles/5183601301-auspex-install-intune-macos)
- [auspex: IT Admin User Guide for Rippling (macOS)](https://help.span.app/articles/7797014343-auspex-install-rippling-macos)
- [How are PRs considered qualified in the AI Impact report when using traces?](https://help.span.app/articles/2353844763-how-are-prs-considered-qualified-in-the-ai-impact-report-when-using-traces)
- [Self-Install auspex on Windows](https://help.span.app/articles/9963582578-auspex-self-install-windows)
- [auspex: IT Admin User Guide for Microsoft Intune (Windows)](https://help.span.app/articles/3576052337-auspex-install-intune-windows)
- [auspex: IT Admin User Guide for Rippling (Windows)](https://help.span.app/articles/9921080477-auspex-install-rippling-windows)
- [auspex: Retiring Span coding-hooks on Windows](https://help.span.app/articles/9385800296-auspex-retire-coding-hooks-windows)
- [AI Traces collection known Claude Code issues with remote settings](https://help.span.app/articles/5562773786-ai-traces-collection-known-claude-code-issues-with-remote-settings)
- [AI Investment Overview ](https://help.span.app/articles/6096369519-ai-investment-overview)
- [Capture Cursor Cloud Agents with auspex](https://help.span.app/articles/2407499066-auspex-cursor-cloud-agents)
- [Capture Claude Code Cloud Agents with auspex](https://help.span.app/articles/2134458291-auspex-claude-cloud-agents)
- [Self-Install auspex on Linux](https://help.span.app/articles/7379972065-auspex-self-install-linux)
- [Install auspex in a Container (Docker) on Linux](https://help.span.app/articles/9361784565-auspex-container-install-linux)
- [Agent Trace permissions](https://help.span.app/articles/1448949550-agent-trace-permissions)
- [How long before a trace shows up in Span?​](https://help.span.app/articles/9406729366-how-long-before-a-trace-shows-up-in-span)

## Getting Started

- [Setting Up SCIM Provisioning for Span via WorkOS](https://help.span.app/articles/9945474770-setting-up-scim-provisioning-for-span-via-workos)
- [Setting up SSO with Span ](https://help.span.app/articles/8449989940-setting-up-sso-with-span)
- [Using Directory Sync for Roster Management](https://help.span.app/articles/4135543225-using-directory-sync-for-roster-management)
- [Roles & Permissions in Span](https://help.span.app/articles/6767049562-roles-permissions-in-span)
- [Active Contributors Report](https://help.span.app/articles/6514322669-active-contributors-report)
- [How do working hours and timezones factor into Span metrics? ](https://help.span.app/articles/2274431104-how-do-working-hours-and-timezones-factor-into-span-metrics)
- [Creating a Team in Span](https://help.span.app/articles/1698166664-creating-a-team-in-span)
- [Connecting an OOO Data Source in Span](https://help.span.app/articles/5572919625-connecting-an-ooo-data-source-in-span)
- [Using a CSV to bulk update your roster data in Span](https://help.span.app/articles/9927910885-using-a-csv-to-bulk-update-your-roster-data-in-span)
- [Summary Notifications](https://help.span.app/articles/1201556983-summary-digest-notifications-from-span)
- [How to use the directory sync JSON file to import team hierarchy and membership into Span](https://help.span.app/articles/8654911778-how-to-use-the-directory-sync-json-file-to-import-team-hierarchy-and-membership-into-span)
- [How to Create a Span API Token](https://help.span.app/articles/3050775971-how-to-create-a-span-api-token)
- [Jira Integration](https://help.span.app/articles/3916337609-jira-integration)
- [Network Access Requirements](https://help.span.app/articles/2213692888-network-access-requirements)
- [What determines contributor status in Span user profiles?](https://help.span.app/articles/3556111514-what-determines-contributor-status-in-span-user-profiles)
- [Knowledge Graph API](https://help.span.app/articles/9321813047-knowledge-graph-api)

### Integrations

- [How does the Incident.io integration work? ](https://help.span.app/articles/2588227537-how-does-the-incident-io-integration-work)
- [Linear <> Span Integration](https://help.span.app/articles/5399709536-linear-span-integration)
- [How to create an Integrations Admin in Span](https://help.span.app/articles/8506558557-how-to-create-an-integrations-admin-in-span)
- [Workday HRIS Integration](https://help.span.app/articles/7707826491-workday-hris-integration)
- [GitLab Integration](https://help.span.app/articles/6929905722-gitlab-integration)
- [Connecting Okta as an HRIS Integration](https://help.span.app/articles/1357473799-connecting-okta-as-an-hris-integration)
- [Rootly Integration](https://help.span.app/articles/9010170010-rootly-integration)
- [Integrating GitHub with Span](https://help.span.app/articles/6368008109-integrating-github-with-span)
- [Troubleshooting GitHub Data Quality](https://help.span.app/articles/1753944002-troubleshooting-github-data-quality)
- [Ways to connect GitHub to Span](https://help.span.app/articles/5052179101-ways-to-connect-github-to-span)
- [GitHub Enterprise Cloud (with data residency)](https://help.span.app/articles/8953236465-github-enterprise-cloud-with-data-residency)

## Cost Capitalization

- [Introduction to Cost Capitalization](https://help.span.app/articles/5003224887-introduction-to-cost-capitalization)
- [How does OOO time impact Cost Capitalization? ](https://help.span.app/articles/7171969573-how-does-ooo-time-impact-cost-capitalization)

## DORA

- [Deployments / Week ](https://help.span.app/articles/7068765851-deployments-week)
- [Change Failure Rate Report](https://help.span.app/articles/9794904819-change-failure-rate-report)
- [Mean Time To Recover (MTTR) Report](https://help.span.app/articles/8806785403-mean-time-to-recover-mttr-report)
- [Lead Time to Production in Span](https://help.span.app/articles/2392724262-lead-time-to-production-in-span)

## Allocation

- [How is work classified in the Labeled Investment report?](https://help.span.app/articles/9692063723-how-is-work-classified-in-the-inferred-investment-report)
- [Workstreams: AI-Powered Allocation](https://help.span.app/articles/5826446460-workstreams-ai-powered-engineering-work-organization)
- [Allocation Guide: Refining Your Workstreams](https://help.span.app/articles/3943159382-allocation-guide)
- [Allocation overview](https://help.span.app/articles/3431566891-allocation-overview)
- [Understanding FTE Days in the Workstreams Report](https://help.span.app/articles/8181659864-understanding-fte-days-in-the-workstreams-report)
- [Setting Up Labeled Investment in Span](https://help.span.app/articles/8313562017-setting-up-labeled-investment-in-span)

## Sentiment

- [Span DX Surveys: Complete Guide](https://help.span.app/articles/1589852370-span-dx-surveys-complete-guide)
- [Agent Readiness Survey](https://help.span.app/articles/2204582620-agent-readiness-survey)

## SRC

- [Using Src to understand your engineering metrics](https://help.span.app/articles/1956995166-using-src-to-understand-your-engineering-metrics)


- [Using the "Group by" dimension to understand your metrics](https://help.span.app/articles/9784964251-using-the-group-by-dimension-to-understand-your-metrics)
- [Issue Lifecycle Report](https://help.span.app/articles/8083094834-issue-lifecycle-report)
- [December 2025 Navigation Update: What’s Changing](https://help.span.app/articles/7496426339-span-navigation-update-what-s-changing)
- [How does the Incident.io integration work?](https://help.span.app/articles/8309178859-how-does-the-incident-io-integration-work)
- [How to use the DORA API to send deployment activity to Span](https://help.span.app/articles/4804416078-how-to-use-the-dora-api-to-send-deployment-activity-to-span)
- [PR Lifecycle Metrics  ](https://help.span.app/articles/7031726678-pr-lifecycle-metrics)
- [Understanding the Mean Time to Recover (MTTR) Chart](https://help.span.app/articles/5663659164-understanding-the-mean-time-to-recover-mttr-chart)
- [FTE & FTE-d Calculation](https://help.span.app/articles/7766389934-fte-fte-d-calculation)
- [People Data & Roster Management](https://help.span.app/articles/1167228344-people-data-roster-management)
- [What is the definition of Accepted AI lines and why might it exceed 100%?](https://help.span.app/articles/8668715711-understanding-ai-lines-accepted-vs-all-lines-merged-metrics)
- [PRs Merged / Week](https://help.span.app/articles/9679873600-prs-merged-week)
- [Understanding differences between AI Impact (Comparison), Tool Utilization, and Agent Traces](https://help.span.app/articles/8341158094-understanding-differences-between-ai-impact-scorecard-and-ai-tool-adoption-reports)
- [Service Accounts](https://help.span.app/articles/5857231547-service-accounts)
- [Issues Completed / Week](https://help.span.app/articles/7915019583-issues-completed-week)
- [PR Size (p75)](https://help.span.app/articles/6242660402-pr-size-p75)
- [How does Span define allocation categories like new features and maintenance work?](https://help.span.app/articles/4499711830-how-does-span-define-new-features-vs-maintenance-work)
- [Src Slack Setup Guide](https://help.span.app/articles/6932319046-src-slack-setup-guide)
- [AI Tool Spend Report](https://help.span.app/articles/3009327773-ai-tool-spend-report)
- [Service Account API permissions and authorization](https://help.span.app/articles/9180924854-service-account-api-permissions-and-authorization)
- [Claude Code API Integration](https://help.span.app/articles/9467441826-claude-code-api-integration)
- [CSV Import of People + Team Data](https://help.span.app/articles/2589071224-csv-import-of-people-team-data)
- [Using Src Playbooks](https://help.span.app/articles/1630422990-using-src-playbooks)
- [Tracking Agents in Span](https://help.span.app/articles/2135673577-tracking-agents-in-span)
- [How do I add a new user to Span?](https://help.span.app/articles/2344888624-how-do-i-add-a-new-user-to-span)
- [How do I enable automatic directory sync in Span?](https://help.span.app/articles/2050942814-how-do-i-enable-automatic-directory-sync-in-span)
- [Span MCP Server](https://help.span.app/articles/3308377389-span-mcp-server)