Add Mastodon blog post as a reference implementation by tiffany76 · Pull Request #9673 · open-telemetry/opentelemetry.io

tiffany76 · 2026-04-17T17:39:29Z

I have read and followed the Contributing docs, especially the "First-time contributing?" section.
This PR has content that I did not fully write myself.
- I used AI and I have read and followed the Generative AI Contribution Policy.
I have the experience and knowledge necessary to understand, review, and validate all content in this PR.¹

This PR copy/pastes the first DevEx SIG blog post on Mastodon to the new Reference Implementation section of the website. The technical content remains unchanged. The intro and conclusion have been rewritten to remove mentions of blogs and any calls to action.

cc: @danielgblanco

Yes, I can answer maintainer questions about the content of this PR, without using AI. ↩

tiffany76 · 2026-04-17T17:40:38Z

+cSpell:ignore: devex otelbin Sidekiq Sloughter Öjeling
+---
+
+Date: March 18, 2026


@danielgblanco We have the date in the front matter, but it doesn't appear on the page when rendered, I've added a line of text with the date. Let me know if you'd prefer to handle this some other way.

Ideally it'd be nice if it showed like it does on blog posts (see below) but I'm not sure it's possible to achieve that without the whole section being a "blog"...

Try adding: layout: blog to the front matter to see if that works. If not, I can look into this later (I won't have time this week). Can we leave the date in the main body in the meantime? And open an issue (assigned to me) if the layout trick doesn't work?

Sure, that works! I'll update the front matter tomorrow to see how it goes. Thanks, @chalin!

Or type: blog -- which I think is better thay the layout config -- but can't recall for sure. Let me know which one works, giving preference to type.

I tried both layout: blog and type: blog and neither worked on my local preview. I added the by-line to the main body to complete the pseudo-blog layout (see eb5ac96) and I've created a followup issue.

tiffany76 · 2026-04-17T17:50:45Z

One other thing we should decide is what order we want to present these pages in. Right now, there's no logical order.

Alphabetical? By date?

danielgblanco · 2026-04-27T14:12:10Z

Alphabetical? By date?

I'd vote for alphabetical, because the titles will always start with the company name, so that's what people would be looking for?

chalin · 2026-04-28T00:28:11Z

+A full production configuration is included below for reference (you can also
+view it on [otelbin][otelbin-mastodon]):
+
+```yaml


This is a lot of YAML. Put it inside a details element?

<details><summary>Some heading text here</summary> ```yaml ... lots of yaml ``` </details>

Sure, will do.

Done in eb5ac96!

chalin · 2026-04-28T00:30:30Z

+cSpell:ignore: devex otelbin Sidekiq Sloughter Öjeling
+---
+
+Date: March 18, 2026


Try adding: layout: blog to the front matter to see if that works. If not, I can look into this later (I won't have time this week). Can we leave the date in the main body in the meantime? And open an issue (assigned to me) if the layout trick doesn't work?

chalin · 2026-04-28T01:50:58Z

+operational burden.
+
+[otelbin-mastodon]:
+  https://www.otelbin.io/?#config=receivers%3A*N__otlp%3A*N____protocols%3A*N______grpc%3A*N________endpoint%3A_0.0.0.0%3A4317*N______http%3A*N________endpoint%3A_0.0.0.0%3A4318*N________cors%3A*N__________allowed*_origins%3A*N____________-_*%22http%3A%2F%2F***%22*N____________-_*%22https%3A%2F%2F***%22*N*Nprocessors%3A*N__batch%3A_%7B%7D*N__resource%3A*N____attributes%3A*N______-_key%3A_deployment.environment.name*N________value%3A_*%22production*%22*N________action%3A_upsert*N______-_key%3A_property*N________value%3A_*%22mastodon.social*%22*N________action%3A_upsert*N______-_key%3A_git.commit.sha*N________from*_attribute%3A_vcs.repository.ref.revision*N________action%3A_insert*N______-_key%3A_git.repository*_url*N________from*_attribute%3A_vcs.repository.url.full*N________action%3A_insert*N__k8sattributes%3A*N____auth*_type%3A_*%22serviceAccount*%22*N____passthrough%3A_false*N____extract%3A*N______metadata%3A*N________-_k8s.namespace.name*N________-_k8s.pod.name*N________-_k8s.pod.start*_time*N________-_k8s.pod.uid*N________-_k8s.deployment.name*N________-_k8s.node.name*N______labels%3A*N________-_tag*_name%3A_app.label.component*N__________key%3A_app.kubernetes.io%2Fcomponent*N__________from%3A_pod*N____pod*_association%3A*N______-_sources%3A*N__________-_from%3A_resource*_attribute*N____________name%3A_k8s.pod.ip*N______-_sources%3A*N__________-_from%3A_resource*_attribute*N____________name%3A_k8s.pod.uid*N______-_sources%3A*N__________-_from%3A_connection*N__resourcedetection%3A*N____detectors%3A_%5Bsystem%5D*N____system%3A*N______resource*_attributes%3A*N________os.description%3A*N__________enabled%3A_true*N________host.arch%3A*N__________enabled%3A_true*N________host.cpu.vendor.id%3A*N__________enabled%3A_true*N________host.cpu.family%3A*N__________enabled%3A_true*N________host.cpu.model.id%3A*N__________enabled%3A_true*N________host.cpu.model.name%3A*N__________enabled%3A_true*N________host.cpu.stepping%3A*N__________enabled%3A_true*N________host.cpu.cache.l2.size%3A*N__________enabled%3A_true*N__transform%3A*N____error*_mode%3A_ignore*N*N____*H_Proper_code_function_naming*N____trace*_statements%3A*N______-_context%3A_span*N________conditions%3A*N__________-_attributes%5B%22code.namespace%22%5D_%21*E_nil*N________statements%3A*N__________-_set*Cattributes%5B%22resource.name%22%5D%2C*N____________Concat*C%5Battributes%5B%22code.namespace%22%5D%2C*N____________attributes%5B%22code.function%22%5D%5D%2C_%22*H%22*D*D*N*N______*H_Proper_kubernetes_hostname*N______-_context%3A_resource*N________conditions%3A*N__________-_attributes%5B%22k8s.node.name%22%5D_%21*E_nil*N________statements%3A*N__________-_set_*Cattributes%5B%22k8s.node.name%22%5D%2C*N____________Concat*C%5Battributes%5B%22k8s.node.name%22%5D%2C_%22k8s-1%22%5D%2C_%22-%22*D*D*N____metric*_statements%3A*N______-_context%3A_resource*N________conditions%3A*N__________-_attributes%5B%22k8s.node.name%22%5D_%21*E_nil*N________statements%3A*N__________-_set_*Cattributes%5B%22k8s.node.name%22%5D%2C*N____________Concat*C%5Battributes%5B%22k8s.node.name%22%5D%2C_%22k8s-1%22%5D%2C_%22-%22*D*D*N____log*_statements%3A*N______-_context%3A_resource*N________conditions%3A*N__________-_attributes%5B%22k8s.node.name%22%5D_%21*E_nil*N________statements%3A*N__________-_set_*Cattributes%5B%22k8s.node.name%22%5D%2C*N____________Concat*C%5Battributes%5B%22k8s.node.name%22%5D%2C_%22k8s-1%22%5D%2C_%22-%22*D*D*N__attributes%2Fsidekiq%3A*N____include%3A*N______match*_type%3A_strict*N______attributes%3A*N________-_key%3A_messaging.sidekiq.job*_class*N____actions%3A*N______-_key%3A_resource.name*N________from*_attribute%3A_messaging.sidekiq.job*_class*N________action%3A_upsert*N__tail*_sampling%3A*N____policies%3A*N______%5B*N________%7B*N__________name%3A_errors-policy%2C*N__________type%3A_status*_code%2C*N__________status*_code%3A_%7B_status*_codes%3A_%5BERROR%5D_%7D%2C*N________%7D%2C*N________%7B*N__________name%3A_randomized-policy%2C*N__________type%3A_probabilistic%2C*N__________probabilistic%3A_%7B_sampling*_percentage%3A_0.1_%7D%2C*N________%7D%2C*N______%5D*N*Nconnectors%3A*N__datadog%2Fconnector%3A*N____traces%3A*N______compute*_stats*_by*_span*_kind%3A_true*N*Nexporters%3A*N__datadog%3A*N____api%3A*N______site%3A_*S%7BDD*_SITE%7D*N______key%3A_*S%7BDD*_API*_KEY%7D*N____traces%3A*N______compute*_stats*_by*_span*_kind%3A_true*N______trace*_buffer%3A_500*N*Nservice%3A*N__pipelines%3A*N____traces%2Fall%3A*N______receivers%3A_%5Botlp%5D*N______processors%3A*N________%5B*N__________resource%2C*N__________k8sattributes%2C*N__________resourcedetection%2C*N__________transform%2C*N__________attributes%2Fsidekiq%2C*N__________batch%2C*N________%5D*N______exporters%3A_%5Bdatadog%2Fconnector%5D*N____traces%2Fsample%3A*N______receivers%3A_%5Bdatadog%2Fconnector%5D*N______processors%3A_%5Btail*_sampling%2C_batch%5D*N______exporters%3A_%5Bdatadog%5D*N____metrics%3A*N______receivers%3A_%5Bdatadog%2Fconnector%2C_otlp%5D*N______processors%3A*N________%5Bresource%2C_k8sattributes%2C_resourcedetection%2C_transform%2C_batch%5D*N______exporters%3A_%5Bdatadog%5D*N____logs%3A*N______receivers%3A_%5Botlp%5D*N______processors%3A*N________%5B*N__________resource%2C*N__________k8sattributes%2C*N__________resourcedetection%2C*N__________transform%2C*N__________attributes%2Fsidekiq%2C*N__________batch%2C*N________%5D*N______exporters%3A_%5Bdatadog%5D%7E


This is a really long query arg string. Can it be trimmed, or does it have to be this long?

Short answer: otelbin doesn't offer a way. In the interest of time, I'm keeping this as is.

chalin · 2026-04-28T10:18:13Z

@tiffany76 - I think that if you merge or rebase it should resolve the CSPELL action blocker.

Signed-off-by: Tiffany Hrabusa <[email protected]>

tiffany76 · 2026-05-02T13:41:59Z

@danielgblanco - I'm merging this now. If you see anything you'd like to change, let me know and I'll create a followup PR. Thanks!

chalin · 2026-05-02T16:34:59Z

Rename this file to index.md, dropping the leading _, because this is a leaf page bundle, not a section. That is the intention, right?

Track via:

Fix Mastodon ref. impl. filename #9807

…9673) Signed-off-by: Tiffany Hrabusa <[email protected]> Signed-off-by: Tiffany Hrabusa <[email protected]>

tiffany76 requested a review from a team as a code owner April 17, 2026 17:39

github-project-automation Bot added this to SIG Comms: PRs & Issues Apr 17, 2026

otelbot-docs Bot added the missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer label Apr 17, 2026

tiffany76 commented Apr 17, 2026

View reviewed changes

tiffany76 requested a review from danielgblanco April 17, 2026 17:42

theletterf approved these changes Apr 20, 2026

View reviewed changes

otelbot-docs Bot removed the missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer label Apr 20, 2026

This was referenced Apr 27, 2026

Add Adobe reference implementation #9674

Merged

Add Skyscanner reference implementation #9675

Merged

chalin reviewed Apr 28, 2026

View reviewed changes

tiffany76 and others added 4 commits May 2, 2026 06:00

Remove coming soon from landing page

373ab83

Signed-off-by: Tiffany Hrabusa <[email protected]>

Add Mastodon ref implementation and images

f01c71b

Signed-off-by: Tiffany Hrabusa <[email protected]>

Fix cSpell

48b0666

Signed-off-by: Tiffany Hrabusa <[email protected]>

Add by-line and nest YAML in details tag

eb5ac96

Signed-off-by: Tiffany Hrabusa <[email protected]>

tiffany76 force-pushed the add-devex-blogs-to-ref-implementations branch from b995f97 to eb5ac96 Compare May 2, 2026 13:30

otelbot-docs Bot added the ready-to-be-merged This PR is ready to be merged by a maintainer label May 2, 2026

tiffany76 mentioned this pull request May 2, 2026

[Docs]: Find a way to apply by-line and date from front matter to regular docs pages #9806

Open

tiffany76 added this pull request to the merge queue May 2, 2026

Merged via the queue into open-telemetry:main with commit cddca0f May 2, 2026
27 checks passed

tiffany76 deleted the add-devex-blogs-to-ref-implementations branch May 2, 2026 13:48

github-project-automation Bot moved this to Done in SIG Comms: PRs & Issues May 2, 2026

chalin reviewed May 2, 2026

View reviewed changes

GRISONRF pushed a commit to GRISONRF/opentelemetry.io that referenced this pull request May 12, 2026

Add Mastodon blog post as a reference implementation (open-telemetry#…

e8e092b

…9673) Signed-off-by: Tiffany Hrabusa <[email protected]> Signed-off-by: Tiffany Hrabusa <[email protected]>

Conversation

tiffany76 commented Apr 17, 2026

Footnotes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tiffany76 commented Apr 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

danielgblanco commented Apr 27, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

chalin commented Apr 28, 2026

Uh oh!

tiffany76 commented May 2, 2026

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

tiffany76 commented Apr 17, 2026 •

edited

Loading