Document Analytics (Confluence)
Document Analytics helps teams monitor Confluence documentation health, freshness, activity, contributors, and space-level risks in Oobeya.
Document Analytics helps engineering leaders understand how Confluence documentation is created, updated, maintained, and used across connected spaces.
With this module, you can monitor documentation activity, identify stale content, review contributor activity, and understand the documentation health of each Confluence space.
Document Analytics is designed for teams that use Confluence as a knowledge base for engineering documentation, product documentation, operational guides, runbooks, onboarding pages, and team knowledge sharing.
Overview
Oobeya collects metadata from connected Confluence spaces and turns it into documentation health metrics, activity trends, contributor reports, and actionable insights.
Document Analytics helps answer questions such as:
Which Confluence spaces are actively maintained?
How many pages are outdated or stale?
Which teams or contributors are most active in documentation?
Which spaces require attention?
Which pages receive the most contributions?
Which Confluence spaces are related to Oobeya teams?
Accessing Document Analytics
To open Document Analytics:
Go to Analytics from the left menu.
Select Document Analytics.
Use the Overview and Spaces tabs to explore your Confluence documentation data.
The page includes:
Overview: Organization-level documentation metrics, trends, insights, and rankings.
Spaces: Space-level analysis with filters, sorting, and detailed space cards.
Space Details: Detailed analysis for a selected Confluence space.
Filters
Document Analytics supports filtering by team and time period.
Team filter
Use the Team filter to view documentation analytics for a specific Oobeya team.
If spaces are mapped to teams, Oobeya uses those mappings to display team-related documentation metrics.
Date range filter
Use the date range selector to analyze activity for a specific period, such as:
Last 7 Days
Last 30 Days
Last 90 Days
Custom date range, if enabled
The selected date range affects activity-based metrics such as:
New documents
Updated documents
Active contributors
Activity trends
Contributor rankings
Stale content is calculated based on the configured stale threshold, typically 90 days.
Overview Tab
The Overview tab provides a high-level summary of documentation health across all connected Confluence spaces.
Key Metrics
The Key Metrics section summarizes the documentation footprint for the selected filters.
Spaces
Number of connected Confluence spaces included in the analysis.
Pages
Total number of Confluence pages across the selected spaces.
Stale Pages
Pages that have not been updated within the stale threshold.
New Docs
Pages created during the selected date range.
Updated Docs
Pages updated during the selected date range.
Contributors
Total number of contributors detected in the connected spaces.
Active Contributors
Contributors who created or updated content during the selected date range.
Health Score
Overall documentation health score based on freshness, activity, and contribution signals.
Each metric card may also show a comparison against the previous period, helping you understand whether documentation activity is increasing or decreasing.
Documentation Insights
The Documentation Insights section highlights important findings from the selected period.
Insights are automatically generated from Confluence activity and freshness data.
Examples of insights include:
A high number of stale pages
Spaces with a high stale content ratio
Personal spaces with many outdated pages
Contributor concentration risk
Spaces with no recent activity
Each insight includes a severity level:
Info
General observation or healthy signal.
Warning
A potential documentation health issue.
Critical
A significant documentation risk that should be reviewed.
Use insights to quickly understand where attention is needed.
Activity Trends
The Activity Trends section shows daily documentation activity for the selected period.
Available charts include:
1. New Docs by Day
Shows how many new Confluence pages were created each day.
Use this chart to understand when new documentation is being produced.
2. Updated Docs by Day
Shows how many pages were updated each day.
Use this chart to detect documentation maintenance patterns and spikes in update activity.
3. Active Contributors by Day
Shows how many contributors were active on each day.
Use this chart to understand how broadly documentation work is distributed across contributors.
Rankings
The Ranking section highlights the most active spaces and contributors.
Top Spaces by Activity
Shows the most active Confluence spaces based on documentation activity.
The table may include:
Space
Activity count
New documents
Updated documents
Contributors
Last activity date
Use this table to identify the spaces where documentation work is most active.
Top Contributors
Shows the contributors with the highest documentation activity.
The table may include:
Contributor
Email or username
Contribution count
Pages contributed
Use this table to understand who is contributing most to documentation.
Spaces Tab
The Spaces tab provides a space-level view of Confluence documentation health.
Image: Document Analytics Spaces Tab
Each space card summarizes the documentation health and activity of a Confluence space.
Space Cards
Each space card includes:
Space name
Name of the Confluence space.
Space key
Short identifier of the Confluence space.
Space type
Global, personal, or archived space type, if available.
Pages
Total number of pages in the space.
Members / Contributors
Number of contributors detected for the space.
Stale Pages
Number and ratio of pages that are stale.
Active Contributors
Contributors active in the selected period.
Health Score
Documentation health score for the space.
The color of the card indicates the health status of the space:
Healthy
The space has good freshness and activity signals.
Needs Attention
The space has some outdated or low-activity content.
At Risk
The space has a high stale content ratio or weak documentation health.
Searching and Filtering Spaces
Use the search and filters to find specific Confluence spaces.
Available filters may include:
Space name or key
Team
Space status
Space type
Activity level
Health status
You can also sort spaces by:
Number of pages
Stale pages
Health score
Last activity
Activity count
Opening a Space Detail Page
Click a space card or a space row to open the Space Detail page.
The Space Detail page provides deeper analysis for a single Confluence space.
Space Detail Page
The Space Detail page provides a detailed view of one Confluence space.
Image: Document Analytics Space Detail Page
Use this page to review the space’s key metrics, insights, activity trends, contributors, content, attention areas, and related Oobeya teams.
Space Header
The top section shows the identity and current status of the selected space.
It includes:
Space name
Space key
Space type
Health status
Fresh content percentage
Health score
Related teams count
Date range selector
Team filter
Open in Confluence action, if available
Key Metrics
The Key Metrics section is always visible at the top of the Space Detail page.
It includes:
Total Pages
Total number of pages in the selected space.
Stale Pages
Pages that have not been updated within the stale threshold.
New Docs
Pages created in the selected date range.
Updated Docs
Pages updated in the selected date range.
Active Contributors
Contributors active in the selected period.
Health Score
Documentation health score for the selected space.
Last Activity
Most recent activity detected in the space.
Space Insights
The Space Insights panel appears next to the Key Metrics section.
It highlights important risks, patterns, or healthy signals for the selected space.
Examples:
High stale content risk
No recent activity
Low contributor activity
Contributor concentration
Healthy documentation freshness
Personal space content risk
Each insight includes:
Title
Message
Severity
Recommended action, if available
Space Detail Tabs
The lower section of the Space Detail page is organized into tabs.
Available tabs include:
Activity
Contributors
Content
Needs Attention
Teams
1. Activity Tab
The Activity tab shows documentation activity trends for the selected space.
It includes:
New Docs by Day
Shows the number of pages created each day.
Updated Docs by Day
Shows the number of pages updated each day.
Active Contributors by Day
Shows the number of contributors active each day.
Freshness Distribution
Shows how pages are distributed by freshness.
Typical freshness buckets include:
0–30 days
31–60 days
61–90 days
90+ days
Use this chart to understand how much of the space content is fresh or outdated.
Contribution by Person
Shows how documentation contribution is distributed across contributors.
Use this chart to identify whether documentation work is shared across the team or concentrated in a small group of people.
2. Contributors Tab
The Contributors tab shows person-level documentation metrics for the selected space.
The contributors table may include:
Contributor
Name of the contributor.
Email / Username
Contributor identifier from Confluence.
Contributions
Total contribution count in the selected period.
Pages
Number of pages the contributor worked on.
Created Docs
Number of pages created, if available.
Updated Docs
Number of pages updated, if available.
Comments
Number of comments, if available.
Last Activity
Most recent activity date.
Mapped Oobeya User
Matched Oobeya user, if available.
Mapped Team
Related Oobeya team, if available.
Use this tab to understand who maintains the space and whether documentation activity is distributed across contributors.
3. Content Tab
The Content tab shows page-level documentation activity.
It includes two views:
Most Contributed Content
Recently Updated Content
Most Contributed Content
Shows pages that received the most contribution or activity.
The table may include:
Page Title
Title of the Confluence page.
Created By
User who created the page.
Last Updated By
User who last updated the page.
Last Updated
Last update date.
Versions
Number of versions or updates.
Contributors
Number of contributors.
Comments
Number of comments, if available.
Open in Confluence
Opens the original page in Confluence.
Use this view to find the most actively maintained or frequently changed pages.
Recently Updated Content
Shows the most recently updated pages in the space.
Use this view to quickly review the latest documentation changes.
4. Needs Attention Tab
The Needs Attention tab highlights pages that may require review.
Pages may appear here for reasons such as:
Stale content
Not updated in 90+ days
Low quality score
Low collaboration
No recent activity
Personal space content risk
High historical activity but no recent updates
The table may include:
Page Title
Title of the Confluence page.
Reason
Why the page requires attention.
Created By
User who created the page.
Last Updated By
User who last updated the page.
Last Updated
Last update date.
Versions
Number of versions or updates.
Contributors
Number of contributors.
Quality Score
Page-level quality score, if available.
Open in Confluence
Opens the original page in Confluence.
Use this tab to prioritize documentation cleanup and maintenance.
5. Teams Tab
The Teams tab shows which Oobeya teams are related to the selected Confluence space.
Image: Related Teams Mapping
You can use this tab to manage the relationship between Confluence spaces and Oobeya teams.
Related Teams
Mapped teams are displayed as chips or cards.
If no teams are mapped, Oobeya shows:
No teams mapped to this space yet.
Add a Team Mapping
To add a related team:
Open the Teams tab.
Click Add Team.
Search for the Oobeya team.
Select the team.
Save the mapping.
After the mapping is added, the Confluence space is associated with the selected Oobeya team.
Remove a Team Mapping
To remove a team mapping:
Open the Teams tab.
Find the mapped team.
Click the remove action.
Confirm the change, if required.
Removing a mapping does not delete the team or Confluence space. It only removes the relationship between them.
Health Score
The Health Score represents the documentation health of a space or the overall documentation environment.
The score is based on signals such as:
Content freshness
Stale page ratio
Documentation activity
Contributor activity
Collaboration distribution
A higher score means the space is healthier and better maintained.
High
Healthy
Medium
Needs Attention
Low
At Risk
The exact score thresholds may vary depending on your Oobeya configuration.
Stale Pages
A stale page is a Confluence page that has not been updated within the configured stale threshold.
The default threshold is commonly 90 days.
For example, if the stale threshold is 90 days, a page last updated more than 90 days ago is counted as stale.
Stale pages are important because outdated documentation can create operational risk, onboarding friction, and knowledge gaps.
Fresh Content
Fresh content refers to pages updated within the configured freshness period.
The fresh content percentage shows how much of a space is considered current.
For example:
70% fresh content
means that 70% of the pages in the selected space are considered up to date based on the freshness threshold.
Contributor Metrics
Contributor metrics show how documentation work is distributed across people.
Oobeya can show:
Total contributors
Active contributors
Top contributors
Contribution count
Pages contributed
Last activity
Contributor concentration
Contributor concentration helps identify whether most documentation work is handled by a small number of people.
High concentration may indicate knowledge ownership risk.
Team Mapping
Team mapping connects Confluence spaces to Oobeya teams.
This helps Oobeya show documentation metrics in a team context.
For example, if the Platform Engineering team owns a Confluence space, you can map that space to the corresponding Oobeya team.
After mapping, team-based filters and reports can include the related documentation data.
Recommended mapping approach
Use space-to-team mapping when a Confluence space clearly belongs to a team, product, or engineering area.
A space can be related to more than one team if ownership is shared.
Common Use Cases
1. Identify outdated documentation
Use the Overview or Spaces tab to find spaces with a high stale page ratio.
Then open the Space Detail page and review the Needs Attention tab.
2. Review documentation activity
Use Activity Trends to see whether teams are creating and updating documentation regularly.
3. Find documentation owners and contributors
Use the Contributors tab to understand who maintains a space and how contributions are distributed.
4. Prioritize documentation cleanup
Use the Needs Attention tab to identify pages that should be reviewed, updated, archived, or reassigned.
5. Connect documentation to teams
Use the Teams tab to map Confluence spaces to Oobeya teams.
This helps engineering leaders analyze documentation health by team.
Best Practices
To get the most value from Document Analytics:
Map important Confluence spaces to Oobeya teams.
Review stale spaces regularly.
Use the Needs Attention tab to prioritize documentation updates.
Monitor contributor concentration to avoid knowledge silos.
Keep onboarding, runbook, architecture, and operational documents up to date.
Review personal spaces separately from team-owned spaces when possible.
Use the date range filter to compare documentation activity across periods.
Last updated