Change language on blackbox vs whitebox to closedbox vs openbox

512 views
Skip to first unread message

Frederic Branczyk

unread,
Jun 11, 2020, 5:29:53 AM6/11/20
to Prometheus Developers
Hi all,

I would like to propose to change all occurrences and namings within the Prometheus project of whitebox and blackbox monitoring. In itself the term Black box doesn't seem to come from a racist background, but I think it's problematic when the opposite is "white", in particular as this has a connotation in relation to whitelist/blacklist namings which are undoubtedly problematic. I would like to propose to replace them with open/closed box monitoring, which not only removes any potential of being offensive, it actually conveys much more clearly what is meant without having to explain.

The biggest impact this would have would be renaming of the blackbox_exporter to closedbox_exporter, all other occurrences of this language seem to be limited to documentation.

Best regards,
Frederic

Bartłomiej Płotka

unread,
Jun 11, 2020, 5:57:42 AM6/11/20
to Frederic Branczyk, Prometheus Developers
+1 to that. Really not big deal technically, but it might matter for the community.

Kind Regards,
Bartek

--
You received this message because you are subscribed to the Google Groups "Prometheus Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email to prometheus-devel...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/prometheus-developers/98b3d620-d0d6-4436-bf15-3d90915f7909o%40googlegroups.com.

Julius Volz

unread,
Jun 11, 2020, 6:03:43 AM6/11/20
to Frederic Branczyk, Prometheus Developers
Hi,

Good motivation, personally I think that kind of replacement is a good thing to do with blacklist/whitelist (as is happening with flag names in the Node Exporter). But I don't know how people feel about blackbox / whitebox yet, as it doesn't carry the same negative/positive association with colors. It would mean more invasive changes, like renaming the entire repository and related documentation web pages, and potential Google findability confusion (old blog posts etc. mentioning the old name).

I haven't heard blackbox/whitebox crop up in the same way as e.g. blacklist/whitelist yet, but would be interested to affected Black people's opinion on whether this seems troublesome as well. If this turns out to be offensive to affected people, that'd be a good argument for renaming it IMO.

Julius

--

Ben Kochie

unread,
Jun 11, 2020, 6:10:28 AM6/11/20
to Julius Volz, Frederic Branczyk, Prometheus Developers
I'm planning to do the flag name change to the node_exporter soon.

I also am not sure about blackbox/whitebox.

How about this proposal: replace "whitebox" with "internal". This better describes what we really mean, removes the black vs white connotations, and simplifies the change.

Julius Volz

unread,
Jun 11, 2020, 6:35:35 AM6/11/20
to Frederic Branczyk, Prometheus Developers
Btw. in case we do end up going for a rename, I think Probe Exporter or Prober Exporter would be a nice and descriptive name for what it's doing (active probing of things).

Bartłomiej Płotka

unread,
Jun 11, 2020, 7:11:12 AM6/11/20
to Julius Volz, Frederic Branczyk, Prometheus Developers
I think it's worth to mention the context of this conversation as well: https://github.com/coreos/prometheus-operator/pull/2832#pullrequestreview-332604611

Kind Regards,
Bartek

Ben Kochie

unread,
Jun 11, 2020, 12:49:03 PM6/11/20
to Julius Volz, Frederic Branczyk, Prometheus Developers
+1 for "prober". We could call it simply "prober". It more directly describes what it's doing.



Matthias Rampke

unread,
Sep 9, 2021, 4:10:42 PM9/9/21
to Ben Kochie, Marcelo Magallón, Julien Pivotto, suraj...@grafana.com, Julius Volz, Frederic Branczyk, Prometheus Developers
*resurrecting thread*

I agree that we should rename it. I wince every time I need to call it by name. I often just call it prober anyway and even unaffiliated people immediately know what I'm talking about.

More broadly, I think "blackbox" / "whitebox" monitoring is not very descriptive, and would propose using "probing" and "instrumentation" respectively.

It would take a bit of transition planning, maybe with one "double release" under both names.

What do the maintainers think?

/MR

Suraj Sidh

unread,
Sep 15, 2021, 9:17:25 AM9/15/21
to Matthias Rampke, Ben Kochie, Marcelo Magallón, Julien Pivotto, Julius Volz, Frederic Branczyk, Prometheus Developers
I am open to a rename if the name is potentially offensive.

I share the same concerns as Julius, and I believe  that we should consider the impact on searchability, and confusion among end users.

Cheers,
Suraj
Reply all
Reply to author
Forward
0 new messages