OM 2.0: Should stateset be represented in a Complex/Composite format?
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Necesita aclaración
- Estado de actividad
- Tranquilo
- Área
- backend-api-design
Línea de trabajo
No se indican archivos ni pruebas; empieza por la discusión del pull request de documentación de Prometheus enlazado y compara los ejemplos de stateset de OM 1.0 con ambas formas compuestas propuestas. Revisa las notas sobre cardinalidad, análisis, intercalado, UX, PromQL y la representación de enteros frente a flotantes; el trabajo estará terminado cuando se haya resuelto la decisión sobre el formato y se haya documentado la justificación.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
See https://github.com/prometheus/docs/pull/2679/changes#r2627250204
We are debating if stateset, represented in OM 1.0 as:
# TYPE foo stateset
foo{entity="controller",foo="a"} 1.0
foo{entity="controller",foo="bb"} 0.0
foo{entity="controller",foo="ccc"} 0.0
foo{entity="replica",foo="a"} 1.0
foo{entity="replica",foo="bb"} 0.0
foo{entity="replica",foo="ccc"} 1.0
Should be composite as histograms and summaries in 2.0 e.g.
# TYPE foo stateset
foo{entity="controller"} {states:["a":1, "bb":0, "ccc":0]}
foo{entity="replica"} {states:["a":1, "bb":0, "ccc":1]}
or
# TYPE foo stateset
foo{entity="controller"} {true:["a"], false:["bb", "ccc"]}
foo{entity="replica"} {true:["a", "ccc"], false:["bb"]}
Discussion notes
- Otel does not have it, but some prev discussions happened to add statesets
- ENUM is subcase
- We don't know much about UX and usage to make clear decisions
- Ensure integer not float for composite
- for stateset ST not relevant/useful here as those are gauges
Pros & Cons for making it composite
Pros
- We make it efficiency/reliable to parse (label matching to realize if it's same "sample"). Efficiency of stateset is actually a blocker for using them instead of gauges. There's a potential to reduce cardinality for large number of states.
- Consistency with summaries and histograms
- We don't need to have an extra rule around interleaving.
Cons
- Readability maybe impaired (long lines) - but it's the same as histograms/summaries.
- What you see what you query is violated unless we plan to implement composite/native stateset eventually (and change PromQL). Even if we plan, we don't know how it will look like, so it's unlikely we will figure out the right format, unless we do UX research on potential PromQL functions like
state(metric, stateName)or true_states(metric)`
- Lenguaje dominante
- Go
- Estrellas
- 2.5k
- Forks
- 175
- Merge medio
- 1 d 22 h
- PR fusionados (30 d)
- 1
Preparar el entorno
Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de prometheus/OpenMetrics
-
Dificultad 4/5 3-5 días Aptitud para principiantes 45/100
prometheus/OpenMetrics#323 ·
-
OM 2.0
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
prometheus/OpenMetrics#312 · 13 comentarios ·
-
Dificultad 3/5 1-2 días Aptitud para principiantes 35/100
prometheus/OpenMetrics#304 · 1 comentario ·
-
RFC next stepsAbierto
Dificultad 5/5 Más de una semana Aptitud para principiantes 20/100
prometheus/OpenMetrics#301 ·
-
Add sustainable Go parser in prometheus/commonQuizá libre de nuevo @bwplotka la tomó hace 415 días y no hay ningún pull request abierto. Abiertotriage:accepted:PoC-needed
prometheus/OpenMetrics#300 · 4 comentarios · 1 reacción · 1 asignado ·
Todos los issues de prometheus/OpenMetrics
Issues similares
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 86/100
txn2/mcp-data-platform#2728 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
blinklabs-io/dingo#6504 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
SocialGouv/iterion#3413 ·
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
orion-belt-dev/orion-belt#181 ·
Los mantenedores suelen responder en 1 día
-
documentation good first issue
Dificultad 2/5 1-3 horas Aptitud para principiantes 79/100
kubesmarts/logic-operator#105 ·
Los mantenedores suelen responder en 1 día