Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.
For operational telemetry, OpenTelemetry provides consistent schemas and
collectors to transport and store event data across languages and platforms.A MedLog semantic convention can be defined as a custom OpenTelemetry registry using
OpenTelemetry Weaver, reusing existing OpenTelemetry
attributes where their semantics match and defining medlog.* attributes for concepts specific to
medical AI.
Users and sessions can also be represented with existing
User and
Session semantic conventions
such as user.id and user.name.
Emitting and collecting records
MedLog records can then be emitted as OpenTelemetry telemetry, and an OpenTelemetry Collector can
receive, process, and export these records to observability platforms. This approach enables integration
of MedLog with existing tracing, logging, and monitoring infrastructure.
Derived OpenTelemetry attributes do not replace the canonical MedLog payload. Populate trace and
span identifiers only when genuine tracing context exists, and reuse an attribute only when its
semantics actually match the MedLog field.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MedLog","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"favicon":"https://mintcdn.com/ayushnoori/SI1z_uchvBg2GlB9/favicon.svg?fit=max\u0026auto=format\u0026n=SI1z_uchvBg2GlB9\u0026q=85\u0026s=40fe00e777ce3fcad972efc59aa7107a","appearance":{"default":"light","strict":false},"navbar":{"links":[{"href":"https://arxiv.org/abs/2510.04033","label":"Read paper"},{"icon":"github","href":"https://github.com/mims-harvard/medlog","label":""}],"primary":{"type":"button","label":"Get involved","href":"/get-involved"}},"footer":{"links":[{"header":"Affiliation","items":[{"label":"Zitnik Lab, Harvard Medical School","href":"https://zitniklab.hms.harvard.edu"}]}]},"seo":{"metatags":{"canonical":"https://medlogprotocol.ai/"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ayushnoori","hasAudioNarration":false,"actualSubdomain":"ayushnoori","customDomains":["medlogprotocol.ai"],"gitSource":{"type":"github","owner":"ayushnoori","repo":"medlog-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aab0440029dba9a8c7da672","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Specification","count":11},{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Documentation","count":6},{"language":"default","tag":"Interoperability","count":6},{"language":"default","tag":"Fields at invocation","count":5},{"language":"default","tag":"Endpoints","count":5},{"language":"default","tag":"Events","count":5},{"language":"default","tag":"Standards","count":4},{"language":"default","tag":"Fields appended later","count":4},{"language":"default","tag":"Overview","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#footer a{max-width:none;white-space:normal;overflow:visible;text-overflow:clip}#footer a[href=\"/\"] .nav-logo{display:none}#footer a[href=\"/\"]{pointer-events:none;cursor:default;text-decoration:none;font-weight:400;font-size:0.875rem;line-height:1.25rem;color:rgb(2 6 23 / 0.5)}#footer a[href=\"/\"]::after{content:\"An open science, academic research project.\"}.dark #footer a[href=\"/\"]{color:rgb(255 255 255 / 0.5)}#footer div:has(>a[href*=\"github.com\"]){display:none}#footer .md\\:justify-center{justify-content:flex-end!important}.team-grid{display:grid;gap:1.25rem;grid-template-columns:repeat(2, minmax(0, 1fr))}@media (min-width: 768px){.team-grid{grid-template-columns:repeat(3, minmax(0, 1fr))}}@media (min-width: 1024px){.team-grid{grid-template-columns:repeat(4, minmax(0, 1fr))}}.team-card{display:flex;flex-direction:column;align-items:center;padding:1rem;border-radius:0.75rem;border:1px solid rgb(229 231 235);background:white;text-align:center}.dark .team-card{border-color:rgb(31 41 55);background:rgb(17 24 39 / 0.5)}.team-card img{width:5rem;height:5rem;border-radius:9999px;object-fit:cover;margin-bottom:0.75rem;border:3px solid #E5E7EB;background:#F3F4F6}.dark .team-card img{border-color:#374151;background:#1F2937}.team-card-lead img{border-color:#2563EB}.team-card-second img{border-color:#F59E0B}.team-card-deployment img{border-color:#10B981}.team-card-corresponding img{border-color:#8B5CF6}.team-card-name{font-weight:600;font-size:0.875rem;line-height:1.25rem;margin-bottom:0.25rem}.team-card-affil{font-size:0.75rem;line-height:1rem;color:rgb(107 114 128)}.team-legend{display:flex;flex-wrap:wrap;gap:1rem 1.25rem;margin:0 0 1.5rem}.team-legend-item{display:inline-flex;align-items:center;gap:0.5rem;font-size:0.875rem}.team-legend-swatch{display:inline-block;width:0.875rem;height:0.875rem;border-radius:9999px;background:transparent;border:3px solid currentColor}.medlog-figure{display:block;width:100%;height:auto;margin:1.5rem 0 0.75rem}.figure-caption{font-size:0.875rem;line-height:1.4;color:rgb(107 114 128);background:rgb(249 250 251);border:1px solid rgb(229 231 235);border-radius:0.5rem;padding:0.75rem 1rem;margin-bottom:1.5rem}.dark .figure-caption{color:rgb(156 163 175);background:rgb(17 24 39 / 0.5);border-color:rgb(31 41 55)}.iop{--iop-line: rgb(203 213 225);--iop-border: rgb(229 231 235);--iop-surface: white;--iop-surface-2: rgb(249 250 251);--iop-muted: rgb(107 114 128);--iop-blue: #2563EB;--iop-blue-fg: white;--iop-spine: 1.25rem;margin:1.5rem 0 2rem}.dark .iop{--iop-line: rgb(55 65 81);--iop-border: rgb(31 41 55);--iop-surface: rgb(17 24 39 / 0.5);--iop-surface-2: rgb(17 24 39 / 0.7);--iop-muted: rgb(156 163 175);--iop-blue: #60A5FA;--iop-blue-fg: rgb(17 24 39)}.iop-radio{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;border:0}.iop-rail-label{font-size:0.6875rem;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;color:var(--iop-muted);margin:0 0 0.5rem}.iop-rail-label+.iop-rail{margin-bottom:1rem}.iop-rail{display:flex;flex-wrap:wrap;gap:0.5rem}.iop-node{display:inline-flex;align-items:center;cursor:pointer;user-select:none;font-size:0.8125rem;line-height:1.2;font-weight:500;padding:0.4rem 0.75rem;border-radius:9999px;border:1px solid var(--iop-border);background:var(--iop-surface);transition:background-color 0.15s ease, border-color 0.15s ease, color 0.15s ease}.iop-node:hover{border-color:var(--iop-blue);color:var(--iop-blue)}#iop-header:checked~.iop-railwrap label[for=\"iop-header\"],#iop-model-instance:checked~.iop-railwrap label[for=\"iop-model-instance\"],#iop-user-identity:checked~.iop-railwrap label[for=\"iop-user-identity\"],#iop-target-identity:checked~.iop-railwrap label[for=\"iop-target-identity\"],#iop-inputs:checked~.iop-railwrap label[for=\"iop-inputs\"],#iop-internal-artifacts:checked~.iop-railwrap label[for=\"iop-internal-artifacts\"],#iop-outputs:checked~.iop-railwrap label[for=\"iop-outputs\"],#iop-outcomes:checked~.iop-railwrap label[for=\"iop-outcomes\"],#iop-user-feedback:checked~.iop-railwrap label[for=\"iop-user-feedback\"]{background:var(--iop-blue);border-color:var(--iop-blue);color:var(--iop-blue-fg)}#iop-header:focus-visible~.iop-railwrap label[for=\"iop-header\"],#iop-model-instance:focus-visible~.iop-railwrap label[for=\"iop-model-instance\"],#iop-user-identity:focus-visible~.iop-railwrap label[for=\"iop-user-identity\"],#iop-target-identity:focus-visible~.iop-railwrap label[for=\"iop-target-identity\"],#iop-inputs:focus-visible~.iop-railwrap label[for=\"iop-inputs\"],#iop-internal-artifacts:focus-visible~.iop-railwrap label[for=\"iop-internal-artifacts\"],#iop-outputs:focus-visible~.iop-railwrap label[for=\"iop-outputs\"],#iop-outcomes:focus-visible~.iop-railwrap label[for=\"iop-outcomes\"],#iop-user-feedback:focus-visible~.iop-railwrap label[for=\"iop-user-feedback\"]{outline:2px solid var(--iop-blue);outline-offset:2px}.iop-card{display:none}#iop-header:checked~.iop-stage .iop-card[data-field=\"header\"],#iop-model-instance:checked~.iop-stage .iop-card[data-field=\"model-instance\"],#iop-user-identity:checked~.iop-stage .iop-card[data-field=\"user-identity\"],#iop-target-identity:checked~.iop-stage .iop-card[data-field=\"target-identity\"],#iop-inputs:checked~.iop-stage .iop-card[data-field=\"inputs\"],#iop-internal-artifacts:checked~.iop-stage .iop-card[data-field=\"internal-artifacts\"],#iop-outputs:checked~.iop-stage .iop-card[data-field=\"outputs\"],#iop-outcomes:checked~.iop-stage .iop-card[data-field=\"outcomes\"],#iop-user-feedback:checked~.iop-stage .iop-card[data-field=\"user-feedback\"]{display:block;animation:iop-fade 0.18s ease-out}@keyframes iop-fade{from{opacity:0;transform:translateY(2px)}to{opacity:1;transform:none}}@media (prefers-reduced-motion: reduce){.iop-card{animation:none!important}.iop-node{transition:none}}.iop-trunk{position:relative;height:1.125rem}.iop-trunk::before{content:\"\";position:absolute;top:0;bottom:0;left:var(--iop-spine);width:2px;background:var(--iop-line)}.iop-hub{border:1px solid var(--iop-border);border-left:3px solid var(--iop-blue);border-radius:0.625rem;background:var(--iop-surface-2);padding:0.875rem 1rem}.iop-hub-tag{font-size:0.6875rem;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;color:var(--iop-muted)}.iop-hub-title{font-size:1rem;font-weight:600;margin-top:0.125rem}.iop-hub-desc{font-size:0.8125rem;line-height:1.5;color:var(--iop-muted);margin-top:0.25rem}.iop-hub-link{display:inline-block;margin-top:0.5rem;font-size:0.75rem;font-weight:600;color:var(--iop-blue)!important;text-decoration:none!important}.iop-hub-link::after{content:\" \\2192\"}.iop-hub-link:hover{text-decoration:underline!important}.iop-branches{position:relative;padding-left:2.25rem;padding-top:0.875rem}.iop-branches::before{content:\"\";position:absolute;top:0;left:var(--iop-spine);width:2px;height:0.875rem;background:var(--iop-line)}.iop-branch{position:relative;padding-bottom:0.75rem}.iop-branch:last-child{padding-bottom:0}.iop-branch::before{content:\"\";position:absolute;top:0;bottom:0;left:-1rem;width:2px;background:var(--iop-line)}.iop-branch:last-child::before{bottom:auto;height:1.375rem}.iop-branch::after{content:\"\";position:absolute;top:1.375rem;left:-1rem;width:1rem;height:2px;background:var(--iop-c)}.iop-branch[data-std=\"uscdi\"]{--iop-c: #10B981;--iop-ct: #047857;--iop-cb: rgb(16 185 129 / 0.45);--iop-cbg: rgb(16 185 129 / 0.08)}.iop-branch[data-std=\"fhir\"]{--iop-c: #F59E0B;--iop-ct: #B45309;--iop-cb: rgb(245 158 11 / 0.5);--iop-cbg: rgb(245 158 11 / 0.1)}.iop-branch[data-std=\"otel\"]{--iop-c: #8B5CF6;--iop-ct: #6D28D9;--iop-cb: rgb(139 92 246 / 0.45);--iop-cbg: rgb(139 92 246 / 0.08)}.dark .iop-branch[data-std=\"uscdi\"]{--iop-ct: #6EE7B7}.dark .iop-branch[data-std=\"fhir\"]{--iop-ct: #FCD34D}.dark .iop-branch[data-std=\"otel\"]{--iop-ct: #C4B5FD}.iop-panel{border:1px solid var(--iop-border);border-left:3px solid var(--iop-c);border-radius:0.625rem;background:var(--iop-surface);padding:0.875rem}.iop-panel-head{display:flex;align-items:center;gap:0.5rem;font-size:0.6875rem;font-weight:700;letter-spacing:0.06em;text-transform:uppercase;color:var(--iop-ct);margin-bottom:0.625rem}.iop-swatch{display:inline-block;flex:none;width:0.5rem;height:0.5rem;border-radius:9999px;background:var(--iop-c)}.iop-chips{display:flex;flex-wrap:wrap;gap:0.375rem}.iop-chip{display:inline-block;font-family:ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace;font-size:0.75rem;line-height:1.35;padding:0.25rem 0.5rem;border-radius:0.375rem;border:1px solid var(--iop-cb);background:var(--iop-cbg);color:var(--iop-ct)!important;text-decoration:none!important;overflow-wrap:anywhere;transition:background-color 0.15s ease, border-color 0.15s ease}a.iop-chip::after{content:\" \\2197\";opacity:0.55}a.iop-chip:hover{border-color:var(--iop-c);background:var(--iop-cbg);text-decoration:underline!important}.iop-chip-medlog{--iop-ct: #1D4ED8;--iop-c: #2563EB;--iop-cb: rgb(37 99 235 / 0.45);--iop-cbg: rgb(37 99 235 / 0.08)}.dark .iop-chip-medlog{--iop-ct: #93C5FD}a.iop-chip-medlog::after{content:\"\"}.iop-chip-none{font-family:inherit;font-style:italic;border-style:dashed;border-color:var(--iop-border);background:transparent;color:var(--iop-muted)!important}.iop-note{font-size:0.8125rem;line-height:1.55;color:var(--iop-muted);margin-top:0.75rem}.iop-note code{font-size:0.75rem;overflow-wrap:anywhere}.iop-legend{display:flex;flex-wrap:wrap;gap:0.5rem 1.25rem;margin-top:1.25rem;padding-top:0.875rem;border-top:1px solid var(--iop-border);font-size:0.75rem;color:var(--iop-muted)}.iop-legend-item{display:inline-flex;align-items:center;gap:0.4rem}.iop-legend-uscdi{--iop-c: #10B981}.iop-legend-fhir{--iop-c: #F59E0B}.iop-legend-otel{--iop-c: #8B5CF6}.iop-legend-medlog{--iop-c: #2563EB}@media (max-width: 639px){.iop-branches{padding-left:1.5rem}.iop-branch::before{left:-0.75rem}.iop-branch::after{left:-0.75rem;width:0.75rem}.iop{--iop-spine: 0.75rem}}"}],"page":{"pagePath":"interoperability/telemetry","slug":"/interoperability/telemetry","pageMetadata":{"title":"Telemetry standards","sidebarTitle":"Telemetry standards","description":"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.","icon":"chart-line","href":"/interoperability/telemetry"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Frame,Heading,Mermaid,Table,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`For operational telemetry, `,_jsx(_components.a,{href:`https://opentelemetry.io/`,children:`OpenTelemetry`}),` provides consistent schemas and\ncollectors to transport and store event data across languages and platforms.`]}),`\n`,_jsxs(_components.p,{children:[`A MedLog `,_jsx(_components.strong,{children:`semantic convention`}),` can be defined as a custom OpenTelemetry registry using\n`,_jsx(_components.a,{href:`https://github.com/open-telemetry/weaver`,children:`OpenTelemetry Weaver`}),`, reusing existing OpenTelemetry\nattributes where their semantics match and defining `,_jsx(_components.code,{children:`medlog.*`}),` attributes for concepts specific to\nmedical AI.`]}),`\n`,_jsx(Heading,{level:`2`,id:`reusing-gen-ai-conventions`,children:`Reusing Gen AI conventions`}),`\n`,_jsxs(_components.p,{children:[`When logging generative AI models, existing OpenTelemetry\n`,_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/`,children:`Gen AI semantic conventions`}),`\ncan be reused.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`MedLog field`}),_jsx(_components.th,{children:`OpenTelemetry attribute`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`run_id`}),` in the `,_jsx(_components.a,{href:`/specification/header`,children:`Header`})]}),_jsx(_components.td,{children:_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/#gen-ai-conversation-id`,children:_jsx(_components.code,{children:`gen_ai.conversation.id`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/specification/model-instance`,children:`Model instance`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/#gen-ai-request-model`,children:_jsx(_components.code,{children:`gen_ai.request.model`})})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Prompts in `,_jsx(_components.a,{href:`/specification/inputs`,children:`Inputs`})]}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/#gen-ai-input-messages`,children:_jsx(_components.code,{children:`gen_ai.input.messages`})}),`, `,_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/#gen-ai-system-instructions`,children:_jsx(_components.code,{children:`gen_ai.system_instructions`})})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Responses in `,_jsx(_components.a,{href:`/specification/outputs`,children:`Outputs`})]}),_jsx(_components.td,{children:_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/#gen-ai-output-messages`,children:_jsx(_components.code,{children:`gen_ai.output.messages`})})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Tool and retrieval operations in `,_jsx(_components.a,{href:`/specification/internal-artifacts`,children:`Internal artifacts`})]}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/#gen-ai-tool-name`,children:_jsx(_components.code,{children:`gen_ai.tool.name`})}),`, `,_jsx(_components.code,{children:`gen_ai.retrieval.documents`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Evaluation of output in `,_jsx(_components.a,{href:`/specification/user-feedback`,children:`User feedback`})]}),_jsx(_components.td,{children:_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/#gen-ai-evaluation-name`,children:_jsx(_components.code,{children:`gen_ai.evaluation`})})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Users and sessions can also be represented with existing\n`,_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/user/`,children:`User`}),` and\n`,_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/registry/attributes/session/`,children:`Session`}),` semantic conventions\nsuch as `,_jsx(_components.code,{children:`user.id`}),` and `,_jsx(_components.code,{children:`user.name`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`emitting-and-collecting-records`,children:`Emitting and collecting records`}),`\n`,_jsxs(_components.p,{children:[`MedLog records can then be emitted as OpenTelemetry telemetry, and an `,_jsx(_components.strong,{children:`OpenTelemetry Collector`}),` can\nreceive, process, and export these records to observability platforms. This approach enables integration\nof MedLog with existing tracing, logging, and monitoring infrastructure.`]}),`\n`,_jsx(Frame,{children:_jsx(Mermaid,{chart:`flowchart LR\n APP[\"Instrumented model\u003cbr/>call or gateway\"] -- \"medlog.* + gen_ai.* attributes\" --> COL[\"OpenTelemetry\u003cbr/>Collector\"]\n COL --> OBS[\"Observability\u003cbr/>platform\"]\n COL --> STORE[\"MedLog record\u003cbr/>store\"]`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Derived OpenTelemetry attributes `,_jsx(_components.strong,{children:`do not replace`}),` the canonical MedLog payload. Populate trace and\nspan identifiers only when genuine tracing context exists, and reuse an attribute only when its\nsemantics actually match the MedLog field.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Telemetry standards","sidebarTitle":"Telemetry standards","description":"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.","icon":"chart-line","href":"/interoperability/telemetry"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Reusing Gen AI conventions","slug":"reusing-gen-ai-conventions","depth":2,"children":[]},{"title":"Emitting and collecting records","slug":"emitting-and-collecting-records","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"ayushnoori","siteName":"MedLog","title":"Telemetry standards - MedLog","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T21:05:10.089Z","originalFileLocation":"interoperability/telemetry.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MedLog\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Telemetry standards - MedLog\">\u003cmeta data-mint-head property=\"og:description\" content=\"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MedLog\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://medlogprotocol.ai//interoperability/telemetry\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ayushnoori.mintlify.site/_mintlify/api/og/v2?division=Standards\u0026amp;title=Telemetry+standards\u0026amp;description=Emitting+MedLog+records+as+OpenTelemetry+telemetry+with+a+MedLog+semantic+convention.\u0026amp;theme=f97803526d18f896a60ffe05\u0026amp;signature=1266f9717c9ddd037f7559f4be2a81a258e63e44eff32aa54b2a06b4f34ea2fd\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Telemetry standards - MedLog\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ayushnoori.mintlify.site/_mintlify/api/og/v2?division=Standards\u0026amp;title=Telemetry+standards\u0026amp;description=Emitting+MedLog+records+as+OpenTelemetry+telemetry+with+a+MedLog+semantic+convention.\u0026amp;theme=f97803526d18f896a60ffe05\u0026amp;signature=1266f9717c9ddd037f7559f4be2a81a258e63e44eff32aa54b2a06b4f34ea2fd\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ayushnoori/EzvMBmGWoMpC96b4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MedLog\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://medlogprotocol.ai//interoperability/telemetry\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/interoperability/telemetry.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://medlogprotocol.ai/#organization\",\"name\":\"MedLog\",\"url\":\"https://medlogprotocol.ai\"},{\"@type\":\"WebSite\",\"@id\":\"https://medlogprotocol.ai#website\",\"name\":\"MedLog\",\"url\":\"https://medlogprotocol.ai\",\"publisher\":{\"@id\":\"https://medlogprotocol.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://medlogprotocol.ai//interoperability/telemetry#webpage\",\"url\":\"https://medlogprotocol.ai//interoperability/telemetry\",\"name\":\"Telemetry standards\",\"description\":\"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.\",\"dateModified\":\"2026-09-16T21:05:10.089Z\",\"isPartOf\":{\"@id\":\"https://medlogprotocol.ai#website\"},\"breadcrumb\":{\"@id\":\"https://medlogprotocol.ai//interoperability/telemetry#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://medlogprotocol.ai//interoperability/telemetry#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Standards\",\"item\":\"https://medlogprotocol.ai/interoperability/provenance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Telemetry standards\",\"item\":\"https://medlogprotocol.ai//interoperability/telemetry\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://medlogprotocol.ai//interoperability/telemetry#article\",\"headline\":\"Telemetry standards\",\"name\":\"Telemetry standards\",\"description\":\"Emitting MedLog records as OpenTelemetry telemetry with a MedLog semantic convention.\",\"url\":\"https://medlogprotocol.ai//interoperability/telemetry\",\"mainEntityOfPage\":{\"@id\":\"https://medlogprotocol.ai//interoperability/telemetry#webpage\"},\"dateModified\":\"2026-09-16T21:05:10.089Z\",\"publisher\":{\"@id\":\"https://medlogprotocol.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://medlogprotocol.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MedLog\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MedLog\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/interoperability/telemetry.md","siteName":"MedLog","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Specification","pages":[{"title":"Specification","href":"/specification/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"Interoperability","groups":[{"group":"Overview","pages":[{"title":"Interoperability","sidebarTitle":"Overview","icon":"plug","href":"/interoperability/overview"},{"title":"Field mapping explorer","sidebarTitle":"Field mapping","icon":"share-nodes","href":"/interoperability/field-mapping"}]},{"group":"Standards","pages":[{"title":"Provenance and lineage tracking","sidebarTitle":"Provenance and lineage","icon":"diagram-project","href":"/interoperability/provenance"},{"title":"Health data elements","sidebarTitle":"Health data elements","description":"Reusing USCDI data classes and FHIR resources to anchor MedLog records to standardized clinical entities.","icon":"hospital","href":"/interoperability/health-data"},{"title":"Telemetry standards","sidebarTitle":"Telemetry standards","icon":"chart-line","href":"/interoperability/telemetry"},{"title":"Relationship to EHR audit logs","sidebarTitle":"EHR audit logs","description":"What a decade of EHR audit log research implies for real-world MedLog deployment.","icon":"clock-rotate-left","href":"/interoperability/audit-logs"}]}]},{"tab":"Team","pages":[{"title":"Team","href":"/team"}]},{"tab":"Citation","pages":[{"title":"Citation","href":"/citation"}]}]},"basePath":"","title":"Telemetry standards - MedLog","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["07c022d89b"],"chunks":["Frame-1H5zLJUq.js","DynamicMarkdown-RhjEuCHC.js"]}