[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PB822EE90C0DSR56VXWED4":3,"skill-same:01M6PB822EE90C0DSR56VXWED4":85},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":25,"publishedAt":46,"linkOnly":47,"markdownContent":48,"markdownBody":49,"frontMatter":50,"refName":33,"commitSha":60,"skillDirectory":61,"forksCount":13,"repositoryHtmlUrl":62,"repositoryHomepageUrl":6,"ownerHtmlUrl":63,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":64,"install":65,"resources":78},"01M6PB822EE90C0DSR56VXWED4","opentelemetry",null,"Instrument applications and infrastructure with OpenTelemetry for unified traces, metrics, and logs.","duc-duy-1612\u002FOnline-Delivery-Systems-Web","duc-duy-1612","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F192231384?v=4","01M6NSDKQQDKVTHZ8DZMZ1VYY6","01M6NSDKW8DDVTQHBT1HBDDJPT",0,"MIT","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fopentelemetry\u002FSKILL.md",[17,22],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发",[26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45],"OpenTelemetry","access","for","relevant","scripts","critical","platform","main","community","only","environment","security","devops-security","applications","kubectl","ci","logs","metrics","git","infrastructure","2026-11-10 10:12:30",false,"---\nname: opentelemetry\ndescription: Instrument applications and infrastructure with OpenTelemetry for unified\n  traces, metrics, and logs.\ncategory: devops\nrisk: critical\nsource: https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills\nsource_repo: BagelHole\u002FDevOps-Security-Agent-Skills\nsource_type: community\ndate_added: '2026-09-20'\nlicense: MIT\nlicense_source: https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills\u002Fblob\u002Fmain\u002FLICENSE\ncompatibility: Requires the relevant platform CLIs (kubectl, helm, terraform, git,\n  CI runners) and authorized access to the target environment. Docs-only; helper scripts\n  and templates not bundled.\nmetadata:\n  author: devops-skills\n  version: '1.0'\n---\n\n# OpenTelemetry\n\nAdopt vendor-neutral telemetry with consistent instrumentation across services.\n\n## Prerequisites\n\n- Application services running in containers or on VMs\n- Backend for traces (Jaeger, Tempo, Datadog, or any OTLP receiver)\n- Backend for metrics (Prometheus, Mimir, or OTLP receiver)\n- Kubernetes cluster (for collector deployment) or VM with systemd\n- Network access from services to collector, and collector to backends\n\n## Core Workflow\n\n1. Define semantic conventions for services, environments, and versions.\n2. Add SDK or auto-instrumentation in each service.\n3. Run an OpenTelemetry Collector to receive, transform, and export telemetry.\n4. Validate cardinality and sampling to control cost.\n5. Create golden signals dashboards and alerting from collected data.\n\n## Collector Production Configuration\n\n```yaml\n# otel-collector-config.yaml\nreceivers:\n  otlp:\n    protocols:\n      grpc:\n        endpoint: 0.0.0.0:4317\n      http:\n        endpoint: 0.0.0.0:4318\n\n  # Scrape Prometheus endpoints\n  prometheus:\n    config:\n      scrape_configs:\n        - job_name: \"kubernetes-pods\"\n          kubernetes_sd_configs:\n            - role: pod\n          relabel_configs:\n            - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]\n              action: keep\n              regex: \"true\"\n            - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_port]\n              action: replace\n              target_label: __address__\n              regex: (.+)\n              replacement: $$1\n\n  # Host metrics for infrastructure monitoring\n  hostmetrics:\n    collection_interval: 30s\n    scrapers:\n      cpu: {}\n      memory: {}\n      disk: {}\n      network: {}\n      load: {}\n\nprocessors:\n  batch:\n    send_batch_size: 1024\n    timeout: 5s\n\n  memory_limiter:\n    check_interval: 1s\n    limit_mib: 512\n    spike_limit_mib: 128\n\n  attributes:\n    actions:\n      - key: deployment.environment\n        value: production\n        action: upsert\n\n  # Drop high-cardinality attributes to control cost\n  filter\u002Fdrop-debug:\n    traces:\n      span:\n        - 'attributes[\"http.request.header.x-debug\"] == \"true\"'\n\n  # Reduce cardinality on URL paths\n  transform\u002Fnormalize-routes:\n    trace_statements:\n      - context: span\n        statements:\n          - replace_pattern(attributes[\"url.path\"], \"\u002Fusers\u002F[0-9]+\", \"\u002Fusers\u002F{id}\")\n          - replace_pattern(attributes[\"url.path\"], \"\u002Forders\u002F[0-9]+\", \"\u002Forders\u002F{id}\")\n\n  # Resource detection for cloud environments\n  resourcedetection:\n    detectors: [env, system, gcp, aws, azure]\n    timeout: 5s\n\nexporters:\n  # Send traces to Tempo\u002FJaeger\n  otlp\u002Ftraces:\n    endpoint: tempo:4317\n    tls:\n      insecure: true\n\n  # Send metrics to Prometheus via remote write\n  prometheusremotewrite:\n    endpoint: http:\u002F\u002Fmimir:9009\u002Fapi\u002Fv1\u002Fpush\n    tls:\n      insecure: true\n\n  # Send logs to Loki\n  otlp\u002Flogs:\n    endpoint: loki:4317\n    tls:\n      insecure: true\n\n  # Debug exporter for development\n  debug:\n    verbosity: basic\n\nservice:\n  telemetry:\n    logs:\n      level: info\n    metrics:\n      address: 0.0.0.0:8888\n\n  pipelines:\n    traces:\n      receivers: [otlp]\n      processors: [memory_limiter, resourcedetection, transform\u002Fnormalize-routes, batch, attributes]\n      exporters: [otlp\u002Ftraces]\n    metrics:\n      receivers: [otlp, prometheus, hostmetrics]\n      processors: [memory_limiter, resourcedetection, batch, attributes]\n      exporters: [prometheusremotewrite]\n    logs:\n      receivers: [otlp]\n      processors: [memory_limiter, resourcedetection, batch, attributes]\n      exporters: [otlp\u002Flogs]\n```\n\n## Collector Kubernetes Deployment\n\n```yaml\n# otel-collector-deployment.yaml\napiVersion: apps\u002Fv1\nkind: Deployment\nmetadata:\n  name: otel-collector\n  namespace: observability\nspec:\n  replicas: 2\n  selector:\n    matchLabels:\n      app: otel-collector\n  template:\n    metadata:\n      labels:\n        app: otel-collector\n    spec:\n      containers:\n        - name: collector\n          image: otel\u002Fopentelemetry-collector-contrib:0.98.0\n          args: [\"--config=\u002Fetc\u002Fotel\u002Fconfig.yaml\"]\n          ports:\n            - containerPort: 4317\n              name: otlp-grpc\n            - containerPort: 4318\n              name: otlp-http\n            - containerPort: 8888\n              name: metrics\n          resources:\n            requests:\n              cpu: 200m\n              memory: 256Mi\n            limits:\n              cpu: \"1\"\n              memory: 512Mi\n          volumeMounts:\n            - name: config\n              mountPath: \u002Fetc\u002Fotel\n          livenessProbe:\n            httpGet:\n              path: \u002F\n              port: 13133\n          readinessProbe:\n            httpGet:\n              path: \u002F\n              port: 13133\n      volumes:\n        - name: config\n          configMap:\n            name: otel-collector-config\n---\napiVersion: v1\nkind: Service\nmetadata:\n  name: otel-collector\n  namespace: observability\nspec:\n  selector:\n    app: otel-collector\n  ports:\n    - name: otlp-grpc\n      port: 4317\n      targetPort: 4317\n    - name: otlp-http\n      port: 4318\n      targetPort: 4318\n    - name: metrics\n      port: 8888\n      targetPort: 8888\n```\n\n## Python SDK Instrumentation\n\n```python\n# tracing_setup.py\n\"\"\"Initialize OpenTelemetry tracing and metrics for a Python service.\"\"\"\nfrom opentelemetry import trace, metrics\nfrom opentelemetry.sdk.trace import TracerProvider\nfrom opentelemetry.sdk.trace.export import BatchSpanProcessor\nfrom opentelemetry.sdk.metrics import MeterProvider\nfrom opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader\nfrom opentelemetry.sdk.resources import Resource\nfrom opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter\nfrom opentelemetry.exporter.otlp.proto.grpc.metric_exporter import OTLPMetricExporter\nfrom opentelemetry.instrumentation.requests import RequestsInstrumentor\nfrom opentelemetry.instrumentation.flask import FlaskInstrumentor\nfrom opentelemetry.instrumentation.sqlalchemy import SQLAlchemyInstrumentor\nimport os\n\ndef init_telemetry(service_name: str, service_version: str):\n    \"\"\"Initialize OTel SDK with traces and metrics.\"\"\"\n    resource = Resource.create({\n        \"service.name\": service_name,\n        \"service.version\": service_version,\n        \"deployment.environment\": os.getenv(\"DEPLOY_ENV\", \"development\"),\n    })\n\n    # Traces\n    trace_exporter = OTLPSpanExporter(\n        endpoint=os.getenv(\"OTEL_EXPORTER_OTLP_ENDPOINT\", \"http:\u002F\u002Fotel-collector:4317\"),\n        insecure=True,\n    )\n    tracer_provider = TracerProvider(resource=resource)\n    tracer_provider.add_span_processor(BatchSpanProcessor(trace_exporter))\n    trace.set_tracer_provider(tracer_provider)\n\n    # Metrics\n    metric_exporter = OTLPMetricExporter(\n        endpoint=os.getenv(\"OTEL_EXPORTER_OTLP_ENDPOINT\", \"http:\u002F\u002Fotel-collector:4317\"),\n        insecure=True,\n    )\n    metric_reader = PeriodicExportingMetricReader(metric_exporter, export_interval_millis=15000)\n    meter_provider = MeterProvider(resource=resource, metric_readers=[metric_reader])\n    metrics.set_meter_provider(meter_provider)\n\n    # Auto-instrument common libraries\n    RequestsInstrumentor().instrument()\n    SQLAlchemyInstrumentor().instrument()\n\n    return trace.get_tracer(service_name), metrics.get_meter(service_name)\n\n# Usage example\ntracer, meter = init_telemetry(\"order-service\", \"1.2.0\")\n\n# Custom span\nwith tracer.start_as_current_span(\"process_order\") as span:\n    span.set_attribute(\"order.id\", order_id)\n    span.set_attribute(\"order.total\", total)\n    # ... business logic ...\n\n# Custom metric\nrequest_counter = meter.create_counter(\n    \"app.requests\",\n    description=\"Total application requests\",\n)\nrequest_counter.add(1, {\"route\": \"\u002Fapi\u002Forders\", \"method\": \"POST\"})\n```\n\n## Node.js SDK Instrumentation\n\n```javascript\n\u002F\u002F tracing.js\n\u002F\u002F Initialize OpenTelemetry for a Node.js service.\n\u002F\u002F Load this file BEFORE any other imports: node -r .\u002Ftracing.js app.js\nconst { NodeSDK } = require(\"@opentelemetry\u002Fsdk-node\");\nconst { OTLPTraceExporter } = require(\"@opentelemetry\u002Fexporter-trace-otlp-grpc\");\nconst { OTLPMetricExporter } = require(\"@opentelemetry\u002Fexporter-metrics-otlp-grpc\");\nconst { PeriodicExportingMetricReader } = require(\"@opentelemetry\u002Fsdk-metrics\");\nconst { getNodeAutoInstrumentations } = require(\"@opentelemetry\u002Fauto-instrumentations-node\");\nconst { Resource } = require(\"@opentelemetry\u002Fresources\");\nconst { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } = require(\"@opentelemetry\u002Fsemantic-conventions\");\n\nconst resource = new Resource({\n  [ATTR_SERVICE_NAME]: process.env.SERVICE_NAME || \"node-service\",\n  [ATTR_SERVICE_VERSION]: process.env.SERVICE_VERSION || \"1.0.0\",\n  \"deployment.environment\": process.env.DEPLOY_ENV || \"development\",\n});\n\nconst sdk = new NodeSDK({\n  resource,\n  traceExporter: new OTLPTraceExporter({\n    url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || \"http:\u002F\u002Fotel-collector:4317\",\n  }),\n  metricReader: new PeriodicExportingMetricReader({\n    exporter: new OTLPMetricExporter({\n      url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || \"http:\u002F\u002Fotel-collector:4317\",\n    }),\n    exportIntervalMillis: 15000,\n  }),\n  instrumentations: [\n    getNodeAutoInstrumentations({\n      \"@opentelemetry\u002Finstrumentation-http\": {\n        ignoreIncomingPaths: [\"\u002Fhealth\", \"\u002Fready\"],\n      },\n      \"@opentelemetry\u002Finstrumentation-express\": { enabled: true },\n      \"@opentelemetry\u002Finstrumentation-pg\": { enabled: true },\n      \"@opentelemetry\u002Finstrumentation-redis\": { enabled: true },\n    }),\n  ],\n});\n\nsdk.start();\nprocess.on(\"SIGTERM\", () => sdk.shutdown());\n```\n\n## Auto-Instrumentation with Kubernetes Operator\n\n```yaml\n# otel-auto-instrumentation.yaml\n# Install the OTel Operator first:\n#   helm install opentelemetry-operator open-telemetry\u002Fopentelemetry-operator \\\n#     --namespace observability --create-namespace\n\n# Define instrumentation for Python services\napiVersion: opentelemetry.io\u002Fv1alpha1\nkind: Instrumentation\nmetadata:\n  name: python-instrumentation\n  namespace: default\nspec:\n  exporter:\n    endpoint: http:\u002F\u002Fotel-collector.observability:4317\n  propagators:\n    - tracecontext\n    - baggage\n  sampler:\n    type: parentbased_traceidratio\n    argument: \"0.25\"\n  python:\n    image: ghcr.io\u002Fopen-telemetry\u002Fopentelemetry-operator\u002Fautoinstrumentation-python:0.44b0\n    env:\n      - name: OTEL_PYTHON_LOG_CORRELATION\n        value: \"true\"\n---\n# Define instrumentation for Node.js services\napiVersion: opentelemetry.io\u002Fv1alpha1\nkind: Instrumentation\nmetadata:\n  name: nodejs-instrumentation\n  namespace: default\nspec:\n  exporter:\n    endpoint: http:\u002F\u002Fotel-collector.observability:4317\n  propagators:\n    - tracecontext\n    - baggage\n  sampler:\n    type: parentbased_traceidratio\n    argument: \"0.25\"\n  nodejs:\n    image: ghcr.io\u002Fopen-telemetry\u002Fopentelemetry-operator\u002Fautoinstrumentation-nodejs:0.49.1\n```\n\nTo instrument a pod, add the annotation:\n\n```yaml\n# For Python:\nmetadata:\n  annotations:\n    instrumentation.opentelemetry.io\u002Finject-python: \"true\"\n\n# For Node.js:\nmetadata:\n  annotations:\n    instrumentation.opentelemetry.io\u002Finject-nodejs: \"true\"\n```\n\n\n## Contents\n\n- [Sampling Strategies](references\u002Fdetails.md)\n- [Best Practices](references\u002Fdetails.md)\n- [Troubleshooting](references\u002Fdetails.md)\n- [Related Skills](references\u002Fdetails.md)\n\n## When to Use This Skill\n\n- Debugging latency across microservices\n- Standardizing observability data model and naming\n- Sending telemetry to Prometheus, Grafana, Datadog, or OTLP backends\n- Building SLO dashboards with trace-to-log correlation\n- Instrumenting Python or Node.js applications with tracing and metrics\n- Setting up auto-instrumentation for existing services without code changes\n\n## Limitations\n\n- Guidance executes against real environments: confirm target, blast radius, and rollback plan before applying anything.\n- Never deploy to production without explicit approval. Docs-only import: upstream scripts and templates not bundled.\n\n### Example\n\n```bash\ngit status && git diff --stat\nkubectl diff -f manifest.yaml\n```\n\n> Adapted from [BagelHole\u002FDevOps-Security-Agent-Skills](https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills) (MIT); frontmatter, When to Use\u002FLimitations, and safety boundaries added for upstream compliance. Docs-only import: helper scripts and templates not bundled.\n","# OpenTelemetry\n\nAdopt vendor-neutral telemetry with consistent instrumentation across services.\n\n## Prerequisites\n\n- Application services running in containers or on VMs\n- Backend for traces (Jaeger, Tempo, Datadog, or any OTLP receiver)\n- Backend for metrics (Prometheus, Mimir, or OTLP receiver)\n- Kubernetes cluster (for collector deployment) or VM with systemd\n- Network access from services to collector, and collector to backends\n\n## Core Workflow\n\n1. Define semantic conventions for services, environments, and versions.\n2. Add SDK or auto-instrumentation in each service.\n3. Run an OpenTelemetry Collector to receive, transform, and export telemetry.\n4. Validate cardinality and sampling to control cost.\n5. Create golden signals dashboards and alerting from collected data.\n\n## Collector Production Configuration\n\n```yaml\n# otel-collector-config.yaml\nreceivers:\n  otlp:\n    protocols:\n      grpc:\n        endpoint: 0.0.0.0:4317\n      http:\n        endpoint: 0.0.0.0:4318\n\n  # Scrape Prometheus endpoints\n  prometheus:\n    config:\n      scrape_configs:\n        - job_name: \"kubernetes-pods\"\n          kubernetes_sd_configs:\n            - role: pod\n          relabel_configs:\n            - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]\n              action: keep\n              regex: \"true\"\n            - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_port]\n              action: replace\n              target_label: __address__\n              regex: (.+)\n              replacement: $$1\n\n  # Host metrics for infrastructure monitoring\n  hostmetrics:\n    collection_interval: 30s\n    scrapers:\n      cpu: {}\n      memory: {}\n      disk: {}\n      network: {}\n      load: {}\n\nprocessors:\n  batch:\n    send_batch_size: 1024\n    timeout: 5s\n\n  memory_limiter:\n    check_interval: 1s\n    limit_mib: 512\n    spike_limit_mib: 128\n\n  attributes:\n    actions:\n      - key: deployment.environment\n        value: production\n        action: upsert\n\n  # Drop high-cardinality attributes to control cost\n  filter\u002Fdrop-debug:\n    traces:\n      span:\n        - 'attributes[\"http.request.header.x-debug\"] == \"true\"'\n\n  # Reduce cardinality on URL paths\n  transform\u002Fnormalize-routes:\n    trace_statements:\n      - context: span\n        statements:\n          - replace_pattern(attributes[\"url.path\"], \"\u002Fusers\u002F[0-9]+\", \"\u002Fusers\u002F{id}\")\n          - replace_pattern(attributes[\"url.path\"], \"\u002Forders\u002F[0-9]+\", \"\u002Forders\u002F{id}\")\n\n  # Resource detection for cloud environments\n  resourcedetection:\n    detectors: [env, system, gcp, aws, azure]\n    timeout: 5s\n\nexporters:\n  # Send traces to Tempo\u002FJaeger\n  otlp\u002Ftraces:\n    endpoint: tempo:4317\n    tls:\n      insecure: true\n\n  # Send metrics to Prometheus via remote write\n  prometheusremotewrite:\n    endpoint: http:\u002F\u002Fmimir:9009\u002Fapi\u002Fv1\u002Fpush\n    tls:\n      insecure: true\n\n  # Send logs to Loki\n  otlp\u002Flogs:\n    endpoint: loki:4317\n    tls:\n      insecure: true\n\n  # Debug exporter for development\n  debug:\n    verbosity: basic\n\nservice:\n  telemetry:\n    logs:\n      level: info\n    metrics:\n      address: 0.0.0.0:8888\n\n  pipelines:\n    traces:\n      receivers: [otlp]\n      processors: [memory_limiter, resourcedetection, transform\u002Fnormalize-routes, batch, attributes]\n      exporters: [otlp\u002Ftraces]\n    metrics:\n      receivers: [otlp, prometheus, hostmetrics]\n      processors: [memory_limiter, resourcedetection, batch, attributes]\n      exporters: [prometheusremotewrite]\n    logs:\n      receivers: [otlp]\n      processors: [memory_limiter, resourcedetection, batch, attributes]\n      exporters: [otlp\u002Flogs]\n```\n\n## Collector Kubernetes Deployment\n\n```yaml\n# otel-collector-deployment.yaml\napiVersion: apps\u002Fv1\nkind: Deployment\nmetadata:\n  name: otel-collector\n  namespace: observability\nspec:\n  replicas: 2\n  selector:\n    matchLabels:\n      app: otel-collector\n  template:\n    metadata:\n      labels:\n        app: otel-collector\n    spec:\n      containers:\n        - name: collector\n          image: otel\u002Fopentelemetry-collector-contrib:0.98.0\n          args: [\"--config=\u002Fetc\u002Fotel\u002Fconfig.yaml\"]\n          ports:\n            - containerPort: 4317\n              name: otlp-grpc\n            - containerPort: 4318\n              name: otlp-http\n            - containerPort: 8888\n              name: metrics\n          resources:\n            requests:\n              cpu: 200m\n              memory: 256Mi\n            limits:\n              cpu: \"1\"\n              memory: 512Mi\n          volumeMounts:\n            - name: config\n              mountPath: \u002Fetc\u002Fotel\n          livenessProbe:\n            httpGet:\n              path: \u002F\n              port: 13133\n          readinessProbe:\n            httpGet:\n              path: \u002F\n              port: 13133\n      volumes:\n        - name: config\n          configMap:\n            name: otel-collector-config\n---\napiVersion: v1\nkind: Service\nmetadata:\n  name: otel-collector\n  namespace: observability\nspec:\n  selector:\n    app: otel-collector\n  ports:\n    - name: otlp-grpc\n      port: 4317\n      targetPort: 4317\n    - name: otlp-http\n      port: 4318\n      targetPort: 4318\n    - name: metrics\n      port: 8888\n      targetPort: 8888\n```\n\n## Python SDK Instrumentation\n\n```python\n# tracing_setup.py\n\"\"\"Initialize OpenTelemetry tracing and metrics for a Python service.\"\"\"\nfrom opentelemetry import trace, metrics\nfrom opentelemetry.sdk.trace import TracerProvider\nfrom opentelemetry.sdk.trace.export import BatchSpanProcessor\nfrom opentelemetry.sdk.metrics import MeterProvider\nfrom opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader\nfrom opentelemetry.sdk.resources import Resource\nfrom opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter\nfrom opentelemetry.exporter.otlp.proto.grpc.metric_exporter import OTLPMetricExporter\nfrom opentelemetry.instrumentation.requests import RequestsInstrumentor\nfrom opentelemetry.instrumentation.flask import FlaskInstrumentor\nfrom opentelemetry.instrumentation.sqlalchemy import SQLAlchemyInstrumentor\nimport os\n\ndef init_telemetry(service_name: str, service_version: str):\n    \"\"\"Initialize OTel SDK with traces and metrics.\"\"\"\n    resource = Resource.create({\n        \"service.name\": service_name,\n        \"service.version\": service_version,\n        \"deployment.environment\": os.getenv(\"DEPLOY_ENV\", \"development\"),\n    })\n\n    # Traces\n    trace_exporter = OTLPSpanExporter(\n        endpoint=os.getenv(\"OTEL_EXPORTER_OTLP_ENDPOINT\", \"http:\u002F\u002Fotel-collector:4317\"),\n        insecure=True,\n    )\n    tracer_provider = TracerProvider(resource=resource)\n    tracer_provider.add_span_processor(BatchSpanProcessor(trace_exporter))\n    trace.set_tracer_provider(tracer_provider)\n\n    # Metrics\n    metric_exporter = OTLPMetricExporter(\n        endpoint=os.getenv(\"OTEL_EXPORTER_OTLP_ENDPOINT\", \"http:\u002F\u002Fotel-collector:4317\"),\n        insecure=True,\n    )\n    metric_reader = PeriodicExportingMetricReader(metric_exporter, export_interval_millis=15000)\n    meter_provider = MeterProvider(resource=resource, metric_readers=[metric_reader])\n    metrics.set_meter_provider(meter_provider)\n\n    # Auto-instrument common libraries\n    RequestsInstrumentor().instrument()\n    SQLAlchemyInstrumentor().instrument()\n\n    return trace.get_tracer(service_name), metrics.get_meter(service_name)\n\n# Usage example\ntracer, meter = init_telemetry(\"order-service\", \"1.2.0\")\n\n# Custom span\nwith tracer.start_as_current_span(\"process_order\") as span:\n    span.set_attribute(\"order.id\", order_id)\n    span.set_attribute(\"order.total\", total)\n    # ... business logic ...\n\n# Custom metric\nrequest_counter = meter.create_counter(\n    \"app.requests\",\n    description=\"Total application requests\",\n)\nrequest_counter.add(1, {\"route\": \"\u002Fapi\u002Forders\", \"method\": \"POST\"})\n```\n\n## Node.js SDK Instrumentation\n\n```javascript\n\u002F\u002F tracing.js\n\u002F\u002F Initialize OpenTelemetry for a Node.js service.\n\u002F\u002F Load this file BEFORE any other imports: node -r .\u002Ftracing.js app.js\nconst { NodeSDK } = require(\"@opentelemetry\u002Fsdk-node\");\nconst { OTLPTraceExporter } = require(\"@opentelemetry\u002Fexporter-trace-otlp-grpc\");\nconst { OTLPMetricExporter } = require(\"@opentelemetry\u002Fexporter-metrics-otlp-grpc\");\nconst { PeriodicExportingMetricReader } = require(\"@opentelemetry\u002Fsdk-metrics\");\nconst { getNodeAutoInstrumentations } = require(\"@opentelemetry\u002Fauto-instrumentations-node\");\nconst { Resource } = require(\"@opentelemetry\u002Fresources\");\nconst { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } = require(\"@opentelemetry\u002Fsemantic-conventions\");\n\nconst resource = new Resource({\n  [ATTR_SERVICE_NAME]: process.env.SERVICE_NAME || \"node-service\",\n  [ATTR_SERVICE_VERSION]: process.env.SERVICE_VERSION || \"1.0.0\",\n  \"deployment.environment\": process.env.DEPLOY_ENV || \"development\",\n});\n\nconst sdk = new NodeSDK({\n  resource,\n  traceExporter: new OTLPTraceExporter({\n    url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || \"http:\u002F\u002Fotel-collector:4317\",\n  }),\n  metricReader: new PeriodicExportingMetricReader({\n    exporter: new OTLPMetricExporter({\n      url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || \"http:\u002F\u002Fotel-collector:4317\",\n    }),\n    exportIntervalMillis: 15000,\n  }),\n  instrumentations: [\n    getNodeAutoInstrumentations({\n      \"@opentelemetry\u002Finstrumentation-http\": {\n        ignoreIncomingPaths: [\"\u002Fhealth\", \"\u002Fready\"],\n      },\n      \"@opentelemetry\u002Finstrumentation-express\": { enabled: true },\n      \"@opentelemetry\u002Finstrumentation-pg\": { enabled: true },\n      \"@opentelemetry\u002Finstrumentation-redis\": { enabled: true },\n    }),\n  ],\n});\n\nsdk.start();\nprocess.on(\"SIGTERM\", () => sdk.shutdown());\n```\n\n## Auto-Instrumentation with Kubernetes Operator\n\n```yaml\n# otel-auto-instrumentation.yaml\n# Install the OTel Operator first:\n#   helm install opentelemetry-operator open-telemetry\u002Fopentelemetry-operator \\\n#     --namespace observability --create-namespace\n\n# Define instrumentation for Python services\napiVersion: opentelemetry.io\u002Fv1alpha1\nkind: Instrumentation\nmetadata:\n  name: python-instrumentation\n  namespace: default\nspec:\n  exporter:\n    endpoint: http:\u002F\u002Fotel-collector.observability:4317\n  propagators:\n    - tracecontext\n    - baggage\n  sampler:\n    type: parentbased_traceidratio\n    argument: \"0.25\"\n  python:\n    image: ghcr.io\u002Fopen-telemetry\u002Fopentelemetry-operator\u002Fautoinstrumentation-python:0.44b0\n    env:\n      - name: OTEL_PYTHON_LOG_CORRELATION\n        value: \"true\"\n---\n# Define instrumentation for Node.js services\napiVersion: opentelemetry.io\u002Fv1alpha1\nkind: Instrumentation\nmetadata:\n  name: nodejs-instrumentation\n  namespace: default\nspec:\n  exporter:\n    endpoint: http:\u002F\u002Fotel-collector.observability:4317\n  propagators:\n    - tracecontext\n    - baggage\n  sampler:\n    type: parentbased_traceidratio\n    argument: \"0.25\"\n  nodejs:\n    image: ghcr.io\u002Fopen-telemetry\u002Fopentelemetry-operator\u002Fautoinstrumentation-nodejs:0.49.1\n```\n\nTo instrument a pod, add the annotation:\n\n```yaml\n# For Python:\nmetadata:\n  annotations:\n    instrumentation.opentelemetry.io\u002Finject-python: \"true\"\n\n# For Node.js:\nmetadata:\n  annotations:\n    instrumentation.opentelemetry.io\u002Finject-nodejs: \"true\"\n```\n\n\n## Contents\n\n- [Sampling Strategies](references\u002Fdetails.md)\n- [Best Practices](references\u002Fdetails.md)\n- [Troubleshooting](references\u002Fdetails.md)\n- [Related Skills](references\u002Fdetails.md)\n\n## When to Use This Skill\n\n- Debugging latency across microservices\n- Standardizing observability data model and naming\n- Sending telemetry to Prometheus, Grafana, Datadog, or OTLP backends\n- Building SLO dashboards with trace-to-log correlation\n- Instrumenting Python or Node.js applications with tracing and metrics\n- Setting up auto-instrumentation for existing services without code changes\n\n## Limitations\n\n- Guidance executes against real environments: confirm target, blast radius, and rollback plan before applying anything.\n- Never deploy to production without explicit approval. Docs-only import: upstream scripts and templates not bundled.\n\n### Example\n\n```bash\ngit status && git diff --stat\nkubectl diff -f manifest.yaml\n```\n\n> Adapted from [BagelHole\u002FDevOps-Security-Agent-Skills](https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills) (MIT); frontmatter, When to Use\u002FLimitations, and safety boundaries added for upstream compliance. Docs-only import: helper scripts and templates not bundled.\n",{"name":5,"risk":31,"source":51,"license":14,"category":52,"metadata":53,"date_added":56,"description":7,"source_repo":57,"source_type":34,"compatibility":58,"license_source":59},"https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills","devops",{"author":54,"version":55},"devops-skills","1.0","2026-09-20","BagelHole\u002FDevOps-Security-Agent-Skills","Requires the relevant platform CLIs (kubectl, helm, terraform, git, CI runners) and authorized access to the target environment. Docs-only; helper scripts and templates not bundled.","https:\u002F\u002Fgithub.com\u002FBagelHole\u002FDevOps-Security-Agent-Skills\u002Fblob\u002Fmain\u002FLICENSE","f3312ba749561b6159f477dbfc9313c875d40a56",".agents\u002Fskills_archive\u002Fopentelemetry","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612","2026-10-25 23:50:58",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill opentelemetry",{"tool":71,"command":72},"bunx","bunx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill opentelemetry",{"tool":74,"command":75},"pnpm","pnpm dlx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill opentelemetry","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fopentelemetry\u002FSKILL.md",true,[79],{"path":80,"resourceType":81,"resourceTypeDesc":82,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002Fdetails.md","REFERENCE","参考文档",2870,"https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fopentelemetry\u002Freferences\u002Fdetails.md",[86,105,129,154,182,206],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":93,"publishedAt":46},"01M6Q0FA5FZ410Z33Z3TFQ4DBA","zero-trust","Implement zero-trust network architecture. Configure identity-based access, micro-segmentation, and continuous verification. Use when implementing modern security architectures.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fzero-trust\u002FSKILL.md",[92],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[94,95,96,97,98,99,88,100,38,27,101,35,34,33,102,31,103,30,29,104],"ZeRO","trust","zero trust","architecture","assessment","verification","segmentation","configure","active","scope","implementing",{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":46},"01M6Q0F1YZJW3KX5FBKEVZ8CV4","zcode-delegate","Delegate coding tasks to the Z.AI ZCode CLI only when the user explicitly requests it, while the orchestrator retains review and landing responsibility.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fzcode-delegate\u002FSKILL.md",[],[112,113,114,115,116,117,118,119,120,121,122,123,124,35,125,34,126,127,31,128],"delegate","zcode","zcode delegate","review","cli","orchestration","tasks","run","Bash","model","node","read","orchestrator","files","desktop app","app","agent-orchestration",{"skillNo":130,"name":131,"nameZh":6,"description":132,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":46},"01M6Q0ETK41VGNMYEXW0T00AJN","youtube-transcript","Fetch YouTube transcripts through DeepAPI or local fallback tooling and save clean text output.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-transcript\u002FSKILL.md",[],[136,137,138,139,140,141,142,143,144,145,146,147,148,34,33,149,150,151,152,153],"transcript","youtube transcript","youtube","safe","github","codex","research","license","https","text","fetch","tooling","clean","local","output","deepapi","youtube transcripts","blob",{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":171,"publishedAt":46},"01M6Q0EPPH2PVMDW40017F8WX0","youtube-transcript-skills","Fetch YouTube video transcripts, search videos\u002Fchannels, browse channels, and extract playlists via the getyoutubetranscript.com API - free tier, no card required.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-transcript-skills\u002FSKILL.md",[160,163,166],{"categoryNo":161,"categoryName":162,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":164,"categoryName":165,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":167,"categoryName":168,"taxonomyType":169,"taxonomyTypeDesc":170},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[136,137,138,172,139,173,140,141,143,174,175,176,177,146,178,34,33,179,180,181],"youtube transcript skills","gemini","search","api","Video","browse","api-integration","free","card","channels",{"skillNo":183,"name":184,"nameZh":6,"description":185,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":186,"categories":187,"keywords":192,"publishedAt":46},"01M6Q0EAB96PX83W5PTE8A0R8D","youtube-notetaker","Turn YouTube talks into local study notes with slides, transcripts, editable annotations, and a markdown-backed viewer.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-notetaker\u002FSKILL.md",[188,191],{"categoryNo":189,"categoryName":190,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000003","演示文稿",{"categoryNo":164,"categoryName":165,"taxonomyType":20,"taxonomyTypeDesc":21},[138,193,194,116,139,195,196,197,198,143,176,199,200,201,202,33,203,149,204,205],"youtube notetaker","notetaker","workflow","official","notes","code","markdown","slides","annotations","README","study","dair-academy","viewer",{"skillNo":207,"name":208,"nameZh":6,"description":209,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":210,"categories":211,"keywords":213,"publishedAt":46},"01M6Q0E55F0GW5MX48V8HXS8B5","youtube-full","Fetch YouTube transcripts, search videos, browse channels, and extract playlists via TranscriptAPI — no yt-dlp, no Google API key, works from any cloud server.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-full\u002FSKILL.md",[212],{"categoryNo":161,"categoryName":162,"taxonomyType":20,"taxonomyTypeDesc":21},[214,138,215,216,139,173,174,217,218,175,176,177,146,219,178,34,33,179,220,152],"youtube full","full","google","server","dlp","credits","automatic"]