TM1 Fitness Rating Explained
TM1 Fitness Rating · how it works · criteria version 1

One letter that tells you how fit your TM1 instance is.

The TM1 Fitness Rating grades an IBM Planning Analytics (TM1) instance from A to G, the way an energy label grades a building. It is built from Pulse monitoring data and answers two questions: how well does the instance run, and how lean is the model behind it?

TM1 Fitness Rating

Select a letter to see what it means

instance in peak shape

instance in poor shape

The letter is the worse of two scores: runtime fitness and model fitness. A fast instance with a cluttered model cannot reach A.
A red flag, such as memory close to full or missing backups, caps the rating at E however good the rest is.

Two scales, one rating

100 points in total

An energy label shows both energy use and CO2 emissions. The fitness rating works the same way: one scale for how the instance behaves today, and one for how easy the model is to look after tomorrow.

Runtime fitness

60 points · criteria R1 to R6

How well the instance runs day to day. This is what your planners feel: is it up, is it fast, do the overnight loads finish, is the data protected.

  • Looks at the last 14 days of monitoring
  • Availability, memory, waits, process failures, CPU, backups

Model fitness

40 points · criteria M1 to M4

How lean and maintainable the model is. This is what your developers feel: how much dead code they step around, and how risky each change is.

  • Looks at the full object inventory and 30 days of process runs
  • Standard libraries, broken references, unused dimensions, idle code

Runtime carries more weight because it affects every user every day. Model fitness decides how quickly and safely the instance can change.

The ten criteria

10 points each

Each criterion is worth 10 points and is scored against fixed bands, so two instances measured the same way get the same score. R stands for Runtime fitness, M for Model fitness.

CriterionWhat it checks and why it mattersFull marks when

Some extra checks are already defined for a later version: a bonus for source control with migration packages and chained chores, and a penalty for patterns such as calling an external program once per row. They are not scored yet.

From points to a letter

four steps
  1. Score each scale as a percentage.

    Runtime points out of 60, model points out of 40. For example 24 of 60 is 40%.

  2. Give each scale its own letter.

    The same thresholds apply to both scales.

  3. Keep the worse of the two.

    A runtime C with a model E is rated E. The weakest side sets the rating, so it can't hide behind the stronger one.

  4. Apply the red-flag cap.

    If any red flag is active, the rating cannot be better than E.

Try it

Move the sliders to see how the two scores and a red flag combine into one letter.

Bruntime
Cmodel
Crating

Red flags

cap the rating at E

Some problems put the instance or its data at risk no matter how well everything else scores. Any one of these keeps the rating at E or below until it is fixed.

Memory nearly full

The server's daily memory peak reaches 95% of its RAM. One large load or a feeder change can then stop the instance.

Backups not confirmed

A night in the window has no recorded backup. Data entered that day could not be restored with certainty.

Availability under 99%

The instance was down for more than about 3.4 hours in 14 days. Planners notice that.

An example: a sample production instance

Workforce_and_FPM · rated E

This sample instance is fast and almost always up, yet it is rated E. Here is how the rating was reached.

Runtime fitness24 / 60

40%, a D on its own

Model fitness14 / 40

35%, an E on its own

Red flags2

Memory peak 95.1% of RAM, and 6 nights without a recorded backup

RatingE

The worse scale is E, and the red flags cap it at E as well

Where its 62 points were lost

Its strengths were 100% uptime (R1, full marks) and good use of standard libraries (M1, 7 of 10). Its rating page lists each fix with who does it and the effort, and shows that the two red flags plus a small clean-up of test processes would move it to D.

Moving up a letter

typical actions

Every instance has its own path, and its rating page lists the exact actions. Most instances follow a similar order: protect first, then stabilise, then tidy, then tune.

What you receive

one page per instance
The label

The A to G rating with both scale scores and any red flags, in the energy-label format.

Why this letter

The reasons behind the rating, each with the measured evidence.

Where points were lost

All ten criteria ranked by lost points, with the main cause of each.

Path to A

Actions grouped by letter, with the points each one adds, the effort, who does it and the smallest set of actions that unlocks each letter.

Questions

Does the rating read our planning data?

No. It uses Pulse monitoring information about the instance: performance figures, process runs, alerts and the object inventory. The rating reads TurboIntegrator (TI) process code and rules to find broken references, but no cube values. All checks are read-only and change nothing on the server.

What do we need to get a rating?

Pulse monitoring the instance, ideally with at least 14 days of history and source control enabled so the full object inventory is available.

Does a good rating mean our numbers are right?

No. The rating measures how healthy and maintainable the instance is. It does not test business logic, calculations or data quality.

How often should we re-rate?

The rating is a snapshot of a 14-day window. Re-rate after a round of fixes, after a major release, or every quarter to track progress.

Why can a fast instance still get a poor letter?

Speed is only one runtime criterion. Memory close to the limit, missing backups or a model full of broken references and dead code all carry real risk, even when users see quick response times today.

Can the criteria change?

This page describes criteria version 1. Each rating page states its criteria version, so ratings are only compared on the same version.