Analytics - magicbug/Cloudlog GitHub Wiki
This guide explains every section available under the Analytics menu in Cloudlog's top navigation bar.
The Analytics menu gives you fourteen different ways to explore and visualise your logbook data. Each section focuses on a different aspect of your operating activity.
What the Analytics Menu Contains
The Analytics dropdown includes:
- Statistics
- Monthly Report
- Gridmap
- Activated Gridsquares
- Gridsquare Activators
- Distances
- Days with QSOs
- Timeline
- Accumulated Statistics
- Timeplotter
- Most Worked Callsigns
- Custom Maps
- Continents
- EME Initials
Statistics
Statistics is the main overview page for your logbook activity.
When you open the page, a row of summary cards loads automatically showing key totals such as:
- Total QSOs logged
- Unique callsigns worked
- Countries (DXCC entities) worked
- Gridsquares worked
Below the summary cards, the page has tabs for different chart types:
- Years — a bar chart of QSOs logged per year
- Modes — a breakdown of QSOs by operating mode
- Bands — a breakdown of QSOs by band
If your log contains satellite QSOs, a Satellites tab also appears with satellite-specific breakdowns.
Date Range Filter
A Date Range Filter button at the top of the page lets you restrict all charts to a specific date range. Use this to analyse a particular period, such as a contest season or year.
Opening Statistics
Navigate to Analytics > Statistics from the top menu.
Monthly Report
Monthly Report generates a comprehensive summary of your operating activity for a specific calendar month.
How to Generate a Report
- Open
Analytics > Monthly Report. - Select a logbook.
- Choose a year and month.
- Click
Generate Report.
What the Report Shows
The report includes summary cards for:
- Total QSOs
- New countries (DXCC entities worked for the first time that month)
- New gridsquares worked for the first time that month
- Unique callsigns
It also shows breakdowns by band, mode, and special activity categories such as satellite and EME contacts.
Exporting the Report
After generating a report, two export buttons are available:
- Export as JSON (for AI) — exports a structured JSON file you can paste into an AI tool to generate a newsletter article or blog post automatically.
- Export as Text — exports a plain text version of the report.
New gridsquares in the export are split by category (HF, Satellite, EME) where applicable.
Gridmap
Gridmap shows an interactive map of all gridsquares you have worked (contacted), using the Maidenhead locator system.
What the Map Shows
Gridsquares are colour-coded to show:
- Worked but not confirmed — you have a QSO for the grid but no confirmation
- Confirmed — the contact is confirmed via QSL, LoTW, eQSL, or QRZ
The map displays gridsquares at three levels of precision:
- 2-character field (e.g.
IO) - 4-character square (e.g.
IO87) - 6-character subsquare (e.g.
IO87JP) — if 6-digit grids are enabled in config
Your home gridsquare is marked on the map.
Filters
The toolbar lets you filter by:
- Band
- Mode
- Confirmation type: QSL, LoTW, eQSL, QRZ
- Satellite contacts only
Use Cases
- Checking VUCC gridsquare progress
- Visualising the geographic spread of your QSOs
- Identifying gridsquares that still need confirmation
Activated Gridsquares
Activated Gridsquares shows a map of gridsquares you have transmitted from, rather than the gridsquares you have worked.
This is the complement of Gridmap. Instead of showing where you called, it shows where you operated from.
What it Shows
Each grid on the map is one you have logged as your operating location. Colour coding distinguishes grids where contacts have been confirmed from those that have not.
Filters
The same filters as Gridmap apply:
- Band
- Mode
- Confirmation type: QSL, LoTW, eQSL, QRZ
- Satellite contacts only
Use Cases
- Tracking which grids you have activated for VUCC
- Planning future portable or mobile operations to fill gaps
- Reviewing activation history after an expedition or SOTA activation
Gridsquare Activators
Gridsquare Activators shows a ranked table of callsigns in your log that have activated — transmitted from — multiple gridsquares.
This is particularly useful for VHF/UHF operators who track how many different grids specific portable operators have activated in contacts with you.
Filters
- Band — filter by a specific band or all bands
- Minimum count — set the minimum number of grids an activator must have to appear in the list (default is 2)
- LEO/GEO — when filtering satellite contacts, choose between LEO (Low Earth Orbit) satellites, GEO (Geostationary) satellites, or both
What the Table Shows
The table lists each callsign with:
- Number of gridsquares activated
- VUCC grids worked
- First QSO date
Drilling Down
Click a callsign to open a detail view of all the individual contacts in your log with that activator, filtered by the current band selection.
Distances
Distances shows a bar chart of the distances at which your QSOs were made, grouped into distance ranges.
Distances are calculated automatically from the gridsquares recorded in your QSOs. The unit (kilometres or miles) uses your account setting set in your profile.
Filters
- Band — including a
SATsatellite option - Satellite — specific satellite name when SAT band is selected
- Mode
- Propagation mode — filter by a specific propagation type (e.g., ES for Sporadic-E, EME, MS for Meteor Scatter, SAT, TR for Troposcatter, and others)
- Transmit power
Reading the Chart
The chart shows how many QSOs fall into each distance bucket. A summary line below the chart highlights how many contacts were plotted and which was the furthest.
Drilling Down
Click any bar on the chart to open a table of the individual QSOs that fall in that distance range.
Use Cases
- Identifying your typical and maximum working distances
- Comparing distance performance across bands
- Reviewing propagation-specific results (e.g., your furthest ES contacts)
Days with QSOs
Days with QSOs shows patterns in your operating activity over time.
The page has four tabs:
Yearly Tab
A table and bar chart showing the number of distinct days in each year that had at least one QSO logged. Useful for comparing activity levels across years.
Weekdays Tab
A chart showing which days of the week you operate most often. Useful for identifying your regular operating patterns.
Streaks Tab
Shows your longest consecutive operating streaks — sequences of days where you logged at least one QSO every day.
Displayed information:
- Your longest-ever streak (start date, end date, number of days)
- Your current active streak (if you have logged today or yesterday)
- Your "almost current" streak — the most recent completed streak, in case your current one is broken but you are close to matching it
Daily Tab
A day-by-day activity chart that shows specific activity for individual dates.
Timeline
Timeline shows the first time you worked each entity in a chosen award programme.
This answers the question: "When did I first work this country / state / island / zone / grid?"
Award Types
Select which award programme to view:
- DXCC — DX Century Club countries
- WAS — Worked All States (US states)
- IOTA — Islands On The Air
- WAZ — Worked All Zones (CQ Zones)
- VUCC — VHF / UHF Century Club gridsquares
Filters
- Band — filter to one band or show all bands
- Mode — filter to one mode or show all modes
- Confirmation checkboxes — QSL, LoTW, eQSL — checking one of these restricts the results to confirmed contacts only
What the Results Show
A table lists each entity in chronological order with:
- The entity name (country, state, island, zone, or grid)
- First worked date
- Callsign worked
- Band and mode
- Number of times worked
Drilling Down
Click a row to open a detail view showing all the contacts for that entity.
Accumulated Statistics
Accumulated Statistics shows how your cumulative totals for award programmes have grown over time.
Rather than showing totals at a point in time, this chart shows the running total — how many new entities you added each year or month.
Award Types
- DXCC — countries worked
- WAS — US states worked
- IOTA — islands worked
- WAZ — CQ zones worked
Filters
- Band
- Mode
- Period: Yearly or Monthly
What the Chart Shows
A line chart plots the cumulative number of entities worked over time. A table below the chart shows the underlying data.
This is useful for:
- Seeing how quickly you built up your DXCC total
- Comparing progress in different award programmes
- Reviewing the impact of a DX expedition year on your totals
Timeplotter
Timeplotter helps you find out what time of day contacts with a specific DXCC entity or CQ zone are typically made on a chosen band.
Filters
- Band — select a specific band or all bands
- DXCC — select a specific DXCC entity from the list, or use "All"
- CQ Zone — select a CQ zone number (1–40), or use "All"
Click Show to run the analysis.
What it Shows
The results are plotted as a chart showing the hours of the day at which QSOs were logged. This lets you identify the typical propagation windows for a particular path.
Use Cases
- Planning when to look for a specific country on a given band
- Reviewing your all-time data to find reliable propagation windows
- Comparing opening times across different seasons (looking at years where the pattern differs)
Most Worked Callsigns
Most Worked Callsigns shows which callsigns you have contacted most frequently in your logbook.
Filters
- Band — including a Satellites option
- Mode
- Satellite — specific satellite name
- From date / To date — optionally restrict to a date range
- Min QSOs — minimum number of contacts for a callsign to appear in the list (1, 2, 3, 5, 10, 20, or 50+)
What the Table Shows
Each row shows a callsign and the number of times you have worked them, along with other details depending on your data.
The number of matching callsigns is shown above the table.
Use Cases
- Identifying regular skeds or club members you work frequently
- Reviewing EME or satellite partner activity
- Spotting duplicate contact patterns in a contesting period
Custom Maps
Custom Maps plots your QSOs on an interactive Leaflet map, with callsign labels at each contact's gridsquare location.
Filters
The filter panel at the top of the map includes:
- Band — select one band or all bands
- Mode — select one mode or all modes
- Date From / Date To — restrict to a date range
- Propagation mode — filter by propagation type
Quick Date Filters
Buttons are provided for common date ranges:
- Today
- This week
- Other quick range shortcuts
What the Map Shows
Each QSO is plotted at the target station's gridsquare location. Callsign labels appear on the markers. Lines connecting your station to each contact can be shown depending on your configuration.
Use Cases
- Reviewing which contacts you made during a specific event or contest
- Visually checking the spread of contacts during a session
- Sharing a map view of an activation or portable operation
Continents
Continents shows a breakdown of your QSOs by continent.
What it Shows
A pie chart and table display the number of QSOs across each continent:
- NA — North America
- EU — Europe
- AS — Asia
- OC — Oceania
- SA — South America
- AF — Africa
- AN — Antarctica
Filters
- Band
- Mode
Click Search to apply filters, or Reset to clear them.
EME Initials
EME Initials tracks your first contacts via EME (Earth-Moon-Earth, or moonbounce) with each unique callsign.
An "initial" in EME refers to the first time you work a specific callsign via the moon. EME operators keep careful track of their initials count as a measure of experience and activity.
Filters
- Band
- Mode
What the Table Shows
For each callsign worked via EME:
- Sequential number (your initials count)
- Callsign
- Date of first QSO
- Gridsquare
- State (for US callsigns)
- Total number of times worked
Use Cases
- Tracking your EME initials milestone count
- Reviewing which callsigns you have first worked and when
- Identifying gridsquares first worked via EME
If you have no EME contacts logged, the page shows a message explaining what EME Initials tracks and how to start using it.
Tips
- Most analytics sections respect your active logbook selection. If you have multiple logbooks, switch to the relevant one before analysing data.
- The Distances unit (km or miles) is set in your user account settings, not on the page itself.
- Timeplotter and Timeline work best on large logs. The more QSOs you have, the more reliable the patterns.
- Monthly Report exports are designed to be fed into AI writing tools. The JSON format includes structured data suitable for generating newsletter articles or club bulletins.
- Gridmap and Activated Gridsquares are the two sides of the gridsquare picture: Gridmap shows where you called, Activated Gridsquares shows where you operated from.
- Gridsquare Activators is most useful on VHF and satellite logs where portable operations produce many different activated grids from one callsign.
- Days with QSOs streaks counts only days where a QSO was actually logged. Check your streak on the streaks tab to see if today counts.
Troubleshooting
A page shows no data
Check the following:
- Your active station logbook contains QSOs. Switch logbooks if needed via the logbook selector.
- You have not applied a band or mode filter that excludes all your data.
- For gridsquare-based features (Gridmap, Distances, Timeplotter), QSOs need a gridsquare recorded for the contact.
Distances shows nothing
The Distances chart requires that your QSOs have gridsquares logged for the contacted station. If gridsquares are missing from your log entries, no distances can be calculated.
EME Initials is empty
EME Initials only shows contacts that are recorded with an EME propagation mode or that match the EME filter logic in your data. If your EME QSOs were logged without the EME propagation field set, they may not appear.
Timeplotter returns no results
Check that you have QSOs matching the selected band and DXCC or CQ zone combination. Very specific combinations (e.g., a rarely worked DXCC on a single band) may return no results if your log contains no matching contacts.