Skip to main content

Clinical Health Dashboard

Guidance on the Clinical Health Dashboard functionality.

C
Written by Connor Baeza
Updated over a week ago

What Is the Clinical Health Dashboard?

The Clinical Health Dashboard shows you the integration health of all your connected GP practices in one place. It monitors EMIS Web integrations for both GP Referral Management and Social Prescribing modules, helping you spot issues before they affect referral workflows.

What You Can See

  • Which GP practices have healthy integrations

  • When each practice's integration service last checked in

  • Whether data exchanges with EMIS Web are working

  • Which service version each practice is running

  • Colour-coded status for quick health checks


How to Access the Dashboard

  1. Log in to Access Elemental with your HCE Manager credentials.

  2. Go to Administration from the main menu.

  3. Click Clinical Health Dashboard.

⚠️Important: Don't see the dashboard? Contact your system administrator to check you have the HCE Manager role and that the dashboard is enabled.


Understanding What You See

The dashboard shows a table with one row per GP practice. Here's what each column means:

Column

What It Shows

Title

GP practice name

Last Service Heartbeat

When the integration service last checked in (should be within last few minutes)

Last Successful File-back

When data was last successfully exchanged with EMIS Web

Last Unsuccessful File-back

When a data exchange failed (if this is recent, there's a problem)

Service Version

Which version of the integration service is installed

Status

Colour-coded health indicator

What is a "Heartbeat"?

The integration service at each GP practice sends a signal every 60 seconds to say "I'm running and connected". This is the heartbeat. If the heartbeat stops, something is wrong.

What is "File-back"?

This is when the integration service exchanges data files with EMIS Web - bringing referral and social prescribing information in and out of the clinical system.


What Do the Status Colours Mean?

Status

What It Means

What to Do

βœ“ Healthy (No status shown)

Everything working normally

Nothing - just keep monitoring

🟠 Orange "With issues"

Service is running but having problems (e.g., file-back failures)

  1. Check when the last successful file-back was.

  2. Review error logs.

  3. Contact the practice IT team

πŸ”΄ Red "Service not installed"

Integration service hasn't been set up yet

  1. Check if installation is scheduled.

  2. Coordinate with implementation team.

  3. Arrange EMIS Web API access .

"No heartbeat registered"

Service has never connected or hasn't checked in for a long time

  1. Ask practice to check service is running.

  2. Check network/firewall settings.

  3. Review service logs for errors.

Quick Health Check

  • Healthy: Heartbeat within last 2 minutes, no "With issues" status

  • Needs attention: Orange status or heartbeat more than 5 minutes old

  • Critical: Red status or no heartbeat registered

How Often Should I Check?

  • Daily: Quick scan during business hours

  • Weekly: Detailed review including version checks

  • When onboarding: Check frequently until practice goes live


Common Scenarios

Scenario 1: New Practice Going Live

When a new GP practice is being connected, you'll see this progression:

  1. Before installation: Red "Service not installed" status.

  2. After installation: "No heartbeat registered" until service starts.

  3. First connection: Heartbeat appears and status updates.

  4. Fully operational: Healthy status or "With issues" if there are problems.

πŸ€“Tip: Check the dashboard several times during onboarding day to confirm each stage completes successfully.

Scenario 2: Practice Shows "With Issues"

Follow these steps to investigate:

  1. Check the Last Service Heartbeat - is it recent? If yes, the service is running but having problems.

  2. Look at Last Unsuccessful File-back - when did failures start?

  3. Note the Service Version - is it up to date?

  4. Contact the practice IT team with this information.

Scenario 3: Planning Service Upgrades

Use the Service Version column to identify practices that need upgrading:

  1. Scan the Service Version column for older versions.

  2. Prioritise practices with known issues in their current version.

  3. Schedule upgrades during maintenance windows.

  4. After upgrade, monitor dashboard for heartbeat to resume.

πŸ€“Tip: Keep all practices on similar versions to avoid compatibility issues.


Quick Troubleshooting

Problem: No heartbeat registered

What to check:

  1. Is the integration service running? (Check Windows Services)

  2. Can the server reach Access Elemental? (Test network connectivity)

  3. Are firewall ports open? (Outbound HTTPS port 443)

  4. Are configuration settings correct? (Server URLs, credentials)

Problem: Frequent file-back failures

What to check:

  1. Is EMIS Web available at the practice?

  2. Are EMIS Web API credentials valid and not expired?

  3. Check service logs for specific error messages.

  4. Test connectivity to EMIS Web API endpoints.

Problem: Heartbeats present but status "With issues"

What to check:

  1. Service is running but having operational problems.

  2. Review recent file-back timestamps.

  3. Check service logs for warnings or errors.

  4. Check service logs for warnings or errors.

  5. Verify EMIS Web integration is functioning.


When to Escalate

Contact Access Elemental support if:

  • Issues persist after checking the above.

  • Multiple practices show the same problem.

  • You need help interpreting service logs.

When Contacting Support, Provide:

  • Practice name.

  • Current status and timestamps from dashboard.

  • Service version number.

  • Steps you've already taken.


Quick Reference

Heartbeat Timing Guide

Last Heartbeat

Status

Action

Within 2 minutes

βœ“ Healthy

Continue monitoring.

2-5 minutes

⚠ Slight delay

Watch for continued delays.

Daily Monitoring Checklist

  1. Scan Status column for orange or red indicators.

  2. Check for heartbeats more than 5 minutes old.

  3. Review any recent unsuccessful file-backs.

  4. Note any practices needing version upgrades.

  5. Document and act on any issues found.


Key Terms

Term

Meaning

Heartbeat

Signal sent every 60 seconds to confirm service is running.

File-back

Data exchange process with EMIS Web.

Integration Service

Software installed at each GP practice that connects to EMIS Web.

Establishment

GP practice or healthcare facility.

Service

Web.


Need Help?

Contact Access Elemental support via the Customer Success Portal or reference work item #1948767.

Did this answer your question?