Formato de Métricas Bencher (BMF)

Los adaptadores de bancos de pruebas integrados convierten la salida de las pruebas de rendimiento al formato JSON de Métricas de Bencher (BMF, por sus siglas en inglés). Los bancos de pruebas personalizados deberían emitir sus resultados como JSON BMF y usar el adaptador json. Consulte cómo realizar seguimiento de pruebas de rendimiento personalizadas para obtener una visión general completa.

Ejemplo de formato de métrica de Bencher (BMF) en JSON

{
  "benchmark_name": {
    "latency": {
      "value": 88.0,
      "lower_value": 87.42,
      "upper_value": 88.88
    },
    "throughput": {
      "value": 5.55,
      "lower_value": 3.14,
      "upper_value": 6.30
    }
  },
  "/bin/sh -c ./my_build_script.sh": {
    "build-time": {
      "value": 87.0
    }
  },
  "my_binary": {
    "file-size": {
      "value": 42.0
    }
  }
}

En este ejemplo, hay tres referencias:

• Referencia benchmark_name con dos medidas:
  • Latencia (latency)
  • Rendimiento (throughput)
• Referencia /bin/sh -c ./my_build_script.sh con una medida para monitorear el tiempo de construcción (build-time)
• Referencia my_binary con una medida para monitorear el tamaño del archivo (file-size)

Orden de precedencia

El orden de precedencia para identificar un Benchmark es el siguiente:

1. UUID
2. Kebab case name con un sufijo -bencher-ignore que se elimina para suprimir alertas (longitud máxima 1024 caracteres)
3. slug (longitud máxima 64 caracteres)
4. name (longitud máxima 1024 caracteres)

El orden de precedencia para identificar una Medida es el siguiente:

1. UUID
2. slug (longitud máxima 64 caracteres)
3. name (longitud máxima 64 caracteres)

Esquema JSON de Bencher Metric Format (BMF)

Este es el esquema JSON para el JSON de Bencher Metric Format (BMF):

{
  "$id": "https://bencher.dev/bmf.json",
  "$schema": "http://json-schema.org/draft-07/schema",
  "type": "object",
  "patternProperties": {
    ".+": {
      "type": "object",
      "patternProperties": {
        ".+": {
          "type": "object",
          "properties": {
            "value": {
              "type": "number"
            },
            "lower_value": {
              "type": "number"
            },
            "upper_value": {
              "type": "number"
            }
          },
          "required": ["value"]
        }
      }
    }
  }
}

Versiones del esquema:

• Más reciente: https://bencher.dev/bmf.json
• v0 (más reciente): https://bencher.dev/v0/bmf.json