[LUDOC-255] llstat files description is confusing, and some appear to be wrong

• Status: Open
• Project: Lustre Documentation
• Type: Bug
• Priority: Minor
• Reporter: Scott Nolin
• Assignee: Lustre Manual Triage
• Resolution: Unresolved
• Labels: stats

Environment

Lustre 2.4/2.5

• Severity: 4

Description

In Section 37.8.5. "Files"

There's a description of the files queried by llstat and where they're located.

Two of these I couldn't find anywhere:

/proc/fs/lustre/mdt/MDS/*/stats

• /proc/fs/lustre/mdt/MDS - does not exist
  /proc/fs/lustre/mds//exports//stats
• /proc/fs/lustre/mds/*/exports - does not exist

The rest it would be an imporvement to perhaps list if they exist on an MDS, OSS, client, or some combination.

Here's my attempt -

MDS:
/proc/fs/lustre/mds/MDS/*/stats

OSS:
/proc/fs/lustre/ost/OSS/*/stats
/proc/fs/lustre/obdfilter//exports//stats
/proc/fs/lustre/obdfilter/*/stats

MDS and OSS:
/proc/fs/lustre/ldlm/services/*/stats
/proc/fs/lustre/ldlm/namespaces/*/pool/stats

Client:
/proc/fs/lustre/llite/*/stats
/proc/fs/lustre/mdc/*/stats

UNSURE

MGS? (our MDS and MGS is same server, I assume MGS)
/proc/fs/lustre/mgs/MGS/exports/*/stats

/proc/fs/lustre/osc/*/stats
-is empty on oss
-has data on client

—

What would be really nice is if there was clear documentation on every lustre stat file, where and what it is, and if they'd follow some kind of standard format. For example if you look at jobstats vs other stats the layout is radically different. But that task is terrifying and depressing if you look at all the stats under proc. So I figured llstat and it's list was a place to start, maybe.

Scott