Re: [PATCH v4 4/6] perf vendor events arm64: Update scale units and descriptions of common topdown metrics

[James Clark]

On 08/08/2023 09:46, John Garry wrote:
> On 07/08/2023 15:20, James Clark wrote:
>> Metrics will be published here [1] going forwards, but they have
>> slightly different scale units. To allow autogenerated metrics to be
>> added more easily, update the scale units to match.
>>
>> The more detailed descriptions have also been taken and added to the
>> common file.
> 
> It's unfortunate that we can't have a concise description - like which
> we have now - and a full description.
> 
>>
> 
> Anyway,
> Reviewed-by: John Garry <john.g.garry@xxxxxxxxxx>
> 

Yes unfortunately in the source data the metric short description
("title") pretty much just matches the metric name but without
underscores. For that reason we chose not to use it for Perf's short
description otherwise the list command showed a lot of duplication.

  "frontend_bound": {
    "title": "Frontend Bound",
    "description": "This metric is the percentage of...

The PMU events on the other hand do have a short description in the
title field rather than just repeating the name:

  ITLB_WALK": {
    "code": "0x0035",
    "title": "Instruction TLB access with at least one translation table
walk",
    "description": "Counts instruction memory translation table walks
caused by a miss in the L2...

I can raise this internally as it does seem to be a bit of an inconsistency.

James