From b282d9d9b4a293cc28733774447b805c7eff8c23 Mon Sep 17 00:00:00 2001 From: "webops-guacbot[bot]" <214537265+webops-guacbot[bot]@users.noreply.github.com> Date: Mon, 21 Sep 2026 10:02:31 +0000 Subject: [PATCH 1/2] Deletes 4 translation(s) --- .../customer-contracts-management.md | 41 ------------------- .../customer-contracts-management.md | 40 ------------------ .../customer-contracts-management.md | 40 ------------------ .../customer-contracts-management.md | 40 ------------------ 4 files changed, 161 deletions(-) delete mode 100644 hugo/content/es/partners/multi_tenant_billing/customer-contracts-management.md delete mode 100644 hugo/content/fr/partners/multi_tenant_billing/customer-contracts-management.md delete mode 100644 hugo/content/ja/partners/multi_tenant_billing/customer-contracts-management.md delete mode 100644 hugo/content/ko/partners/multi_tenant_billing/customer-contracts-management.md diff --git a/hugo/content/es/partners/multi_tenant_billing/customer-contracts-management.md b/hugo/content/es/partners/multi_tenant_billing/customer-contracts-management.md deleted file mode 100644 index 1c6a45fdb34..00000000000 --- a/hugo/content/es/partners/multi_tenant_billing/customer-contracts-management.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -description: Administre la cartera de clientes del socio (clientes, contratos y facturas) - desde una Admin Org. -title: Contratos de cliente ---- -
-Contratos de cliente está en vista previa. -
- -## Descripción general {#overview} - -Contratos de cliente ofrece al socio un único lugar para administrar clientes, contratos y facturas de su cartera de clientes con Datadog. Los socios pueden consultar esta información directamente, en lugar de depender del equipo de cuenta del socio para consultas rutinarias. - -Vaya a {{< ui >}}Plan & Usage{{< /ui >}} > {{< ui >}}Customer Contracts{{< /ui >}} en el Admin Org; consulte [Solicitar un Admin Org][2] si aún no tiene uno configurado. - -{{< img src="partners/multi_tenant_billing/customer_contracts.png" alt="Pestaña Contratos de cliente en Plan & Usage dentro de un Admin Org, que enumera clientes y contratos." style="width:100%;" >}} - -**Nota**: Se requiere el permiso de Lectura de facturación para visualizar Contratos de cliente. - -## Qué incluye {#whats-included} - -- Todos los clientes conectados a una Admin Org, y sus contratos actuales e históricos, con recordatorios de renovación para los contratos próximos a vencer o que ya hayan pasado su fecha de renovación. -- MRR del contrato (CMRR), MRR de uso (UMRR), estado de influencia y fechas de inicio y fin del contrato, junto con las tarifas por producto y los PDF de los formularios de pedido. -- Para contratos de drawdown, el saldo restante, el exceso proyectado y la fecha de agotamiento proyectada en comparación con la fecha de finalización del contrato. -- Para contratos de MSP, qué clientes pertenecen a cada contrato. -- Visibilidad de descuentos y márgenes por contrato. -- Si [Customer Pricing][1] está habilitado para cada cliente, si aún no está configurado o si necesita una actualización después de un cambio de contrato. -- Contactos clave por cliente: el CSM de Datadog, el AE de Datadog, el equipo de cuenta del socio y el contacto de facturación que recibe las facturas. - -{{< img src="partners/multi_tenant_billing/customer_contracts_detail.png" alt="Panel de detalles de Contratos de cliente que muestra la descripción general del gasto, el agotamiento de drawdown, la información del contrato y los contactos de un cliente." style="width:100%;" >}} - -Las facturas se enumeran por cliente con fechas de emisión y vencimiento, monto y estado de pago, y se consolidan en conteos de vencidos y totales en la página principal de Contratos de cliente: - -{{< img src="partners/multi_tenant_billing/customer_contracts_invoices.png" alt="Pestaña de facturas de Contratos de cliente que enumera los números de factura, fechas, montos y estado para un cliente." style="width:100%;" >}} - -## Related docs {#related-docs} - -- [Solicitar un Admin Org][2] - -[1]: /es/account_management/plan_and_usage/partner_experience/customer_pricing/ -[2]: /es/partners/multi_tenant_billing/#requesting-an-admin-org \ No newline at end of file diff --git a/hugo/content/fr/partners/multi_tenant_billing/customer-contracts-management.md b/hugo/content/fr/partners/multi_tenant_billing/customer-contracts-management.md deleted file mode 100644 index fbe60051345..00000000000 --- a/hugo/content/fr/partners/multi_tenant_billing/customer-contracts-management.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: Gérez le portefeuille commercial du partenaire – clients, contrats et - factures – depuis une Admin Org. -title: Contrats Clients ---- -
-Customer Contracts est en Preview. -
- -## Présentation {#overview} - -Contrats Clients offre au partenaire un emplacement unique pour gérer les clients, les contrats et les factures de son portefeuille commercial avec Datadog. Les partenaires peuvent consulter ces informations directement, au lieu de dépendre de l'équipe de gestion de compte partenaire pour les recherches courantes. - -Accédez à {{< ui >}}Plan & Usage{{< /ui >}} > {{< ui >}}Customer Contracts{{< /ui >}} dans l'Admin Org ; consultez [Demander une Admin Org][2] si aucune n'est encore configurée. - -{{< img src="partners/multi_tenant_billing/customer_contracts.png" alt="Onglet Contrats Clients sous Plan & Usage dans une Admin Org, répertoriant les clients et les contrats." style="width:100%;" >}} - -**Remarque** : L'autorisation Lecture de la facturation est requise pour afficher les Contrats Clients. - -## Ce qui est inclus {#whats-included} - -- Tous les clients connectés à l'Admin Org, ainsi que leurs contrats actuels et historiques, avec des rappels de renouvellement pour les contrats arrivant à échéance ou dont la date de renouvellement est déjà passée. -- Contract MRR (CMRR), Usage MRR (UMRR), statut d'influence, dates de début et de fin du contrat, tarifs par produit et bon de commande au format PDF. -- Pour les contrats drawdown, le solde restant, le dépassement projeté et la date d'épuisement projetée par rapport à la date de fin du contrat. -- Pour les contrats MSP, quels clients appartiennent à chaque contrat. -- Visibilité des remises et des marges par contrat. -- Indique si Customer Pricing est activé pour chaque client, s'il n'est pas encore configuré ou s'il nécessite une mise à jour après une modification du contrat. -- Contacts clés par client : le CSM Datadog, l'AE Datadog, l'équipe de gestion des comptes partenaires et le contact de facturation recevant les factures. - -{{< img src="partners/multi_tenant_billing/customer_contracts_detail.png" alt="Panneau de détails des Contrats Clients affichant un aperçu des dépenses, l'épuisement du drawdown, les informations sur le contrat et les contacts pour un client." style="width:100%;" >}} - -Les factures sont répertoriées par client avec les dates d'émission et d'échéance, le montant et le statut de paiement, et sont regroupées en nombres et totaux en retard sur la page principale des Contrats Clients : - -{{< img src="partners/multi_tenant_billing/customer_contracts_invoices.png" alt="Onglet Factures des Contrats Clients répertoriant les numéros de facture, les dates, les montants et le statut pour un client." style="width:100%;" >}} - -## Documentation associée {#related-docs} - -- [Demander une Admin Org][2] - -[2]: /fr/partners/multi_tenant_billing/#requesting-an-admin-org \ No newline at end of file diff --git a/hugo/content/ja/partners/multi_tenant_billing/customer-contracts-management.md b/hugo/content/ja/partners/multi_tenant_billing/customer-contracts-management.md deleted file mode 100644 index 63f50dc84b8..00000000000 --- a/hugo/content/ja/partners/multi_tenant_billing/customer-contracts-management.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: 管理組織(Admin Org)から、パートナーの取引先(顧客、契約、請求書)を管理します。 -title: 顧客契約 ---- -
-「顧客契約」はプレビュー版です。 -
- -## 概要 {#overview} - -「顧客契約」を使用すると、パートナーはDatadogとの取引における顧客、契約、請求書を一元管理できます。パートナーは、日常的な確認のためにパートナーアカウントチームに頼る必要がなく、この情報を直接検索できます。 - -管理組織(Admin Org)の{{< ui >}}Plan & Usage{{< /ui >}} > {{< ui >}}Customer Contracts{{< /ui >}}に移動します。まだ設定されていない場合は、[管理組織(Admin Org)をリクエストする][2]を参照してください。 - -{{< img src="partners/multi_tenant_billing/customer_contracts.png" alt="管理組織(Admin Org)の「プランと使用量」の下にある「顧客契約」タブ。顧客と契約が一覧表示されます。" style="width:100%;" >}} - -**注**:「顧客契約」を表示するには、「請求の読み取り(Billing Read)」権限が必要です。 - -## 含まれるもの {#whats-included} - -- 管理組織(Admin Org)に接続されているすべての顧客、およびその現在および過去の契約。更新が近づいている、またはすでに更新日を過ぎている契約の更新リマインダーも含まれます。 -- 契約MRR(CMRR)、利用MRR(UMRR)、影響ステータス、契約開始日と終了日、製品ごとの料金、および注文書のPDF。 -- ドローダウン契約の場合、残高、予測超過分、および契約終了日と比較した予測枯渇日。 -- MSP契約の場合、各契約にどの顧客が属しているか。 -- 契約ごとの割引と利益率の可視化。 -- 各顧客に対して[顧客価格設定][1]が有効になっているか、まだ設定されていないか、または契約変更後に更新が必要か。 -- 顧客ごとの主要連絡先:DatadogのCSM、DatadogのAE、パートナーアカウントチーム、および請求書を受け取る請求担当者。 - -{{< img src="partners/multi_tenant_billing/customer_contracts_detail.png" alt="顧客の支出概要、ドローダウンの枯渇状況、契約情報、連絡先を表示する「顧客契約」詳細パネル。" style="width:100%;" >}} - -請求書は顧客ごとに発行日、支払期限、金額、支払状況とともに一覧表示され、メインの「顧客契約」ページで期限超過数と合計に集計されます。 - -{{< img src="partners/multi_tenant_billing/customer_contracts_invoices.png" alt="顧客の請求書番号、日付、金額、ステータスを一覧表示する「顧客契約」請求書タブ。" style="width:100%;" >}} - -## 関連ドキュメント {#related-docs} - -- [管理組織(Admin Org)をリクエストする][2] - -[1]: /ja/account_management/plan_and_usage/partner_experience/customer_pricing/ -[2]: /ja/partners/multi_tenant_billing/#requesting-an-admin-org \ No newline at end of file diff --git a/hugo/content/ko/partners/multi_tenant_billing/customer-contracts-management.md b/hugo/content/ko/partners/multi_tenant_billing/customer-contracts-management.md deleted file mode 100644 index 70ddfb00493..00000000000 --- a/hugo/content/ko/partners/multi_tenant_billing/customer-contracts-management.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -description: 관리자 조직(Admin Org)에서 파트너의 비즈니스 장부(고객, 계약 및 청구서)를 관리하십시오. -title: 고객 계약 ---- -
-고객 계약은 미리 보기(Preview) 상태입니다. -
- -## 개요 {#overview} - -고객 계약을 통해 파트너는 Datadog과의 비즈니스 장부에 대한 고객, 계약 및 청구서를 한 곳에서 관리할 수 있습니다. 파트너는 일상적인 조회를 위해 파트너 계정 팀에 의존하는 대신 이 정보를 직접 조회할 수 있습니다. - -관리자 조직에서 {{< ui >}}Plan & Usage{{< /ui >}} > {{< ui >}}Customer Contracts{{< /ui >}}(으)로 이동하십시오. 아직 설정되지 않은 경우 [관리자 조직 요청하기][2]를 참조하십시오. - -{{< img src="partners/multi_tenant_billing/customer_contracts.png" alt="관리자 조직의 Plan & Usage 아래에 있는 고객 계약 탭으로, 고객과 계약이 나열됩니다." style="width:100%;" >}} - -**참고**: 고객 계약을 조회하려면 Billing Read 권한이 필요합니다. - -## 포함된 내용 {#whats-included} - -- 관리자 조직에 연결된 모든 고객과 그들의 현재 및 과거 계약, 그리고 갱신이 다가오거나 갱신 날짜가 지난 계약에 대한 갱신 알림. -- 계약 MRR(CMRR), 사용량 MRR(UMRR), 영향 상태, 계약 시작 및 종료 날짜와 제품별 요금 및 주문 양식 PDF. -- 인출(drawdown) 계약의 경우, 계약 종료 날짜와 비교한 잔액, 예상 초과 사용량 및 예상 소진 날짜. -- MSP 계약의 경우, 각 계약에 속한 고객. -- 계약별 할인 및 마진 가시성. -- 각 고객에 대해 [고객 가격 책정][1]이 활성화되었는지, 아직 구성되지 않았는지, 또는 계약 변경 후 업데이트가 필요한지 여부. -- 고객별 주요 연락처: Datadog CSM, Datadog AE, 파트너 계정 팀 및 청구서를 수신하는 청구 담당자. - -{{< img src="partners/multi_tenant_billing/customer_contracts_detail.png" alt="고객의 지출 개요, 인출 소진, 계약 정보 및 연락처를 보여주는 고객 계약 세부 정보 패널." style="width:100%;" >}} - -청구서는 고객별로 발행일, 마감일, 금액 및 결제 상태와 함께 나열되며, 주요 고객 계약 페이지에서 연체 건수 및 총액으로 합산됩니다: - -{{< img src="partners/multi_tenant_billing/customer_contracts_invoices.png" alt="고객의 청구서 번호, 날짜, 금액 및 상태를 나열하는 고객 계약 청구서 탭." style="width:100%;" >}} - -## 관련 문서 {#related-docs} - -- [관리자 조직 요청하기][2] - -[1]: /ko/account_management/plan_and_usage/partner_experience/customer_pricing/ -[2]: /ko/partners/multi_tenant_billing/#requesting-an-admin-org \ No newline at end of file From 7470d7dc6d81f14d174294c623fc745441372cc9 Mon Sep 17 00:00:00 2001 From: "webops-guacbot[bot]" <214537265+webops-guacbot[bot]@users.noreply.github.com> Date: Mon, 21 Sep 2026 12:05:30 +0000 Subject: [PATCH 2/2] Updates 160 translation(s) --- .../partner_experience/customer_contracts.md | 108 + hugo/content/es/actions/datastores/create.md | 123 +- .../troubleshooting/windows_containers.md | 111 +- .../bits_ai/bits_code/slack_code_channels.md | 76 + .../bits_ai/bits_investigation/configure.md | 2 +- hugo/content/es/byoc-logs/operate/sizing.md | 195 ++ .../reporting/explorer.md | 181 +- .../es/containers/kubernetes/appsec.md | 523 ++++ .../continuous_integration/explorer/facets.md | 183 +- hugo/content/es/dashboards/widgets/table.md | 66 +- .../data_observability/jobs_monitoring/dbt.md | 172 ++ .../guide/public_artifact_vulnerabilities.md | 88 + hugo/content/es/data_streams/kafka/_index.md | 70 + hugo/content/es/disaster_recovery/_index.md | 90 +- hugo/content/es/experiments/_index.md | 10 +- .../es/experiments/defining_metrics/_index.md | 183 ++ .../content/es/experiments/reading_results.md | 124 + .../es/feature_flags/client/flutter.md | 492 ++++ .../es/getting_started/application/_index.md | 159 +- .../incident_management/_index.md | 258 +- .../es/getting_started/integrations/aws.md | 216 +- .../incident_management/_index.md | 171 ++ .../integrations/guide/aws-terraform-setup.md | 543 +++- .../es/integrations/guide/slack-actions.md | 99 + .../instrument/agentic/_index.md | 92 +- .../investigate/evaluations/_index.md | 2 +- .../es/logs/log_configuration/flex_logs.md | 247 +- .../logs/log_configuration/logs_to_metrics.md | 4 +- hugo/content/es/mcp_server/tools.md | 2403 ++++++++++++----- .../agent-filtering-for-custom-metrics.md | 400 +++ .../es/monitors/types/data_observability.md | 1 + .../cloud_network_monitoring/_index.md | 69 +- .../es/network_monitoring/netflow/_index.md | 19 +- .../getting_started/otel_demo_to_datadog.md | 403 +++ .../integrations/datadog_extension.md | 313 ++- .../integrations/kafka_metrics.md | 117 +- .../opentelemetry/setup/otlp_ingest/traces.md | 238 ++ .../browser/build_plugins/source_maps.md | 134 + .../guide/enable-rum-shopify-store.md | 73 +- ...ate-zendesk-tickets-with-session-replay.md | 44 +- .../guide/mobile-sdk-upgrade.md | 820 +++++- .../guide/session-replay-for-solutions.md | 75 + .../guide/upload-javascript-source-maps.md | 191 +- .../agentic_onboarding.md | 6 + .../api_posture/api_findings.md | 10 +- .../setup/aws/waf/_index.md | 8 +- .../vulnerabilities/_index.md | 5 +- .../detect_and_monitor/dynamic_severity.md | 64 + .../es/security/workload_protection/_index.md | 40 +- .../es/service_level_objectives/monitor.md | 127 +- .../guide/explore-rum-through-synthetics.md | 75 +- .../es/synthetics/guide/rum-to-synthetics.md | 39 +- .../platform/test_coverage/_index.md | 154 +- .../es/tests/test_parallelization/setup.md | 656 +++++ hugo/content/es/tracing/_index.md | 120 +- hugo/content/fr/bits_ai/_index.md | 55 +- .../bits_investigation/knowledge_sources.md | 119 + hugo/content/fr/byoc-logs/operate/sizing.md | 195 ++ .../reporting/explorer.md | 172 ++ hugo/content/fr/containers/guide/auto_conf.md | 128 +- .../containers/guide/aws-batch-ecs-fargate.md | 108 +- .../continuous_integration/explorer/facets.md | 197 +- hugo/content/fr/dashboards/widgets/table.md | 60 +- hugo/content/fr/data_observability/cicd.md | 151 ++ .../data_observability/jobs_monitoring/dbt.md | 172 ++ hugo/content/fr/deployment_gates/_index.md | 38 + hugo/content/fr/deployment_gates/explore.md | 25 + .../fr/error_tracking/frontend/browser.md | 237 ++ hugo/content/fr/experiments/_index.md | 12 +- .../fr/experiments/defining_metrics/_index.md | 183 ++ .../fr/getting_started/application/_index.md | 223 +- .../getting_started/code_security/_index.md | 163 ++ .../fr/getting_started/integrations/aws.md | 162 +- .../incident_management/_index.md | 171 ++ .../aws-integration-and-cloudwatch-faq.md | 107 +- .../integrations/guide/aws-terraform-setup.md | 1239 ++++++++- .../build_with_ai/mcp_server.md | 5 +- .../fr/llm_observability/instrument/sdk.md | 55 +- .../logs/log_configuration/logs_to_metrics.md | 4 +- hugo/content/fr/mcp_server/setup.md | 625 +++-- .../agent-filtering-for-custom-metrics.md | 400 +++ .../fr/monitors/guide/custom_schedules.md | 115 + .../cloud_network_monitoring/_index.md | 80 + .../fr/network_monitoring/netflow/_index.md | 13 +- .../getting_started/otel_demo_to_datadog.md | 403 +++ .../integrations/datadog_extension.md | 366 +++ .../integrations/kafka_metrics.md | 318 +++ .../integrations/trace_metrics.md | 39 + .../opentelemetry/setup/otlp_ingest/traces.md | 238 ++ .../content/fr/real_user_monitoring/_index.md | 14 +- .../application_monitoring/_index.md | 47 + .../browser/build_plugins/source_maps.md | 133 + .../browser/collecting_browser_errors.md | 308 +++ .../error_tracking/mobile/maui.md | 206 ++ .../guide/debug-symbols.md | 51 + .../guide/enable-rum-shopify-store.md | 55 +- .../guide/mobile-sdk-upgrade.md | 854 ++++-- .../guide/send-rum-custom-actions.md | 67 +- .../guide/session-replay-for-solutions.md | 75 + .../guide/session-replay-service-worker.md | 28 +- .../agentic_onboarding.md | 6 + .../api_posture/api_findings.md | 10 +- .../api_inventory/api_endpoints.md | 253 ++ .../how-it-works/threat-intelligence.md | 79 + .../setup/aws/waf/_index.md | 6 - .../compatibility/gcp-service-extensions.md | 39 + .../application_security/setup/envoy.md | 178 ++ .../setup/gcp/cloud-run/ruby.md | 124 + .../application_security/setup/haproxy.md | 171 ++ .../application_security/setup/java/linux.md | 119 + .../setup/nodejs/aws-fargate.md | 168 ++ .../setup/php/aws-fargate.md | 177 ++ .../setup/python/kubernetes.md | 125 + .../fr/security/application_security/terms.md | 145 + .../threat_protection/_index.md | 36 + .../policies/custom_rules.md | 120 + .../dev_tool_int/ide_plugins/_index.md | 32 + .../code_security/static_analysis/_index.md | 191 ++ .../fr/security/workload_protection/_index.md | 24 +- .../fr/serverless/guide/opentelemetry.md | 22 +- .../fr/synthetics/guide/rum-to-synthetics.md | 47 + .../platform/test_coverage/_index.md | 96 + .../fr/tests/test_parallelization/_index.md | 52 + hugo/content/fr/tracing/_index.md | 109 +- hugo/content/ja/actions/agents/_index.md | 3 + .../llm_as_a_judge_evaluations/_index.md | 2 +- hugo/content/ja/mcp_server/code_execution.md | 80 + .../agentic_onboarding.md | 5 + hugo/content/ko/actions/agents/_index.md | 3 + .../create-an-inbox-rule/index.md | 3 + .../delete-an-inbox-rule/index.md | 3 + .../disable-a-default-inbox-rule/index.md | 3 + .../enable-a-default-inbox-rule/index.md | 3 + .../get-a-default-inbox-rule/index.md | 3 + .../get-all-default-inbox-rules/index.md | 3 + .../get-all-inbox-rules/index.md | 3 + .../reorder-inbox-rules/index.md | 3 + .../update-an-inbox-rule/index.md | 3 + .../setup_postgres/rds/quick_install.md | 30 +- hugo/content/ko/deployment_gates/setup/jit.md | 133 +- .../deployment_gates/setup/preconfigured.md | 51 +- hugo/content/ko/gpu_monitoring/tracing.md | 100 + .../post_incident/_index.md | 69 + ...-agent-installation-technical-reference.md | 139 + .../guide/aws-agent-installation.md | 164 ++ .../llm_as_a_judge_evaluations/_index.md | 4 +- hugo/content/ko/logs/explorer/findings.md | 123 + .../ko/logs/log_configuration/indexes.md | 19 +- hugo/content/ko/mobile/_index.md | 84 +- .../ko/monitors/configuration/_index.md | 144 +- hugo/content/ko/monitors/notify/variables.md | 115 +- .../ko/opentelemetry/config/otlp_receiver.md | 203 ++ .../setup/collector_exporter/_index.md | 63 + .../azure_app_service/linux_code.md | 780 ++++++ hugo/content/ko/tests/containers.md | 514 ++-- .../tests/correlate_logs_and_tests/_index.md | 203 ++ .../trace_collection/dd_libraries/android.md | 1095 ++++++++ hugo/data/api/v2/translate_tags.fr.json | 116 +- .../connect_s3_to_datadog_log_archives.es.md | 30 +- .../connect_s3_to_datadog_log_archives.fr.md | 21 + 160 files changed, 22238 insertions(+), 4019 deletions(-) create mode 100644 hugo/content/es/account_management/plan_and_usage/partner_experience/customer_contracts.md create mode 100644 hugo/content/es/bits_ai/bits_code/slack_code_channels.md create mode 100644 hugo/content/es/byoc-logs/operate/sizing.md create mode 100644 hugo/content/es/containers/kubernetes/appsec.md create mode 100644 hugo/content/es/data_observability/jobs_monitoring/dbt.md create mode 100644 hugo/content/es/data_security/guide/public_artifact_vulnerabilities.md create mode 100644 hugo/content/es/data_streams/kafka/_index.md create mode 100644 hugo/content/es/experiments/defining_metrics/_index.md create mode 100644 hugo/content/es/experiments/reading_results.md create mode 100644 hugo/content/es/feature_flags/client/flutter.md create mode 100644 hugo/content/es/incident_response/incident_management/_index.md create mode 100644 hugo/content/es/integrations/guide/slack-actions.md create mode 100644 hugo/content/es/metrics/guide/agent-filtering-for-custom-metrics.md create mode 100644 hugo/content/es/opentelemetry/getting_started/otel_demo_to_datadog.md create mode 100644 hugo/content/es/opentelemetry/setup/otlp_ingest/traces.md create mode 100644 hugo/content/es/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md create mode 100644 hugo/content/es/real_user_monitoring/guide/session-replay-for-solutions.md create mode 100644 hugo/content/es/security/application_security/agentic_onboarding.md create mode 100644 hugo/content/es/security/cloud_siem/detect_and_monitor/dynamic_severity.md create mode 100644 hugo/content/es/tests/test_parallelization/setup.md create mode 100644 hugo/content/fr/bits_ai/bits_investigation/knowledge_sources.md create mode 100644 hugo/content/fr/byoc-logs/operate/sizing.md create mode 100644 hugo/content/fr/cloud_cost_management/reporting/explorer.md create mode 100644 hugo/content/fr/data_observability/cicd.md create mode 100644 hugo/content/fr/data_observability/jobs_monitoring/dbt.md create mode 100644 hugo/content/fr/deployment_gates/_index.md create mode 100644 hugo/content/fr/deployment_gates/explore.md create mode 100644 hugo/content/fr/error_tracking/frontend/browser.md create mode 100644 hugo/content/fr/experiments/defining_metrics/_index.md create mode 100644 hugo/content/fr/getting_started/code_security/_index.md create mode 100644 hugo/content/fr/incident_response/incident_management/_index.md create mode 100644 hugo/content/fr/metrics/guide/agent-filtering-for-custom-metrics.md create mode 100644 hugo/content/fr/monitors/guide/custom_schedules.md create mode 100644 hugo/content/fr/network_monitoring/cloud_network_monitoring/_index.md create mode 100644 hugo/content/fr/opentelemetry/getting_started/otel_demo_to_datadog.md create mode 100644 hugo/content/fr/opentelemetry/integrations/datadog_extension.md create mode 100644 hugo/content/fr/opentelemetry/integrations/kafka_metrics.md create mode 100644 hugo/content/fr/opentelemetry/integrations/trace_metrics.md create mode 100644 hugo/content/fr/opentelemetry/setup/otlp_ingest/traces.md create mode 100644 hugo/content/fr/real_user_monitoring/application_monitoring/_index.md create mode 100644 hugo/content/fr/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md create mode 100644 hugo/content/fr/real_user_monitoring/application_monitoring/browser/collecting_browser_errors.md create mode 100644 hugo/content/fr/real_user_monitoring/error_tracking/mobile/maui.md create mode 100644 hugo/content/fr/real_user_monitoring/guide/debug-symbols.md create mode 100644 hugo/content/fr/real_user_monitoring/guide/session-replay-for-solutions.md create mode 100644 hugo/content/fr/security/application_security/agentic_onboarding.md create mode 100644 hugo/content/fr/security/application_security/api_posture/api_inventory/api_endpoints.md create mode 100644 hugo/content/fr/security/application_security/how-it-works/threat-intelligence.md create mode 100644 hugo/content/fr/security/application_security/setup/compatibility/gcp-service-extensions.md create mode 100644 hugo/content/fr/security/application_security/setup/envoy.md create mode 100644 hugo/content/fr/security/application_security/setup/gcp/cloud-run/ruby.md create mode 100644 hugo/content/fr/security/application_security/setup/haproxy.md create mode 100644 hugo/content/fr/security/application_security/setup/java/linux.md create mode 100644 hugo/content/fr/security/application_security/setup/nodejs/aws-fargate.md create mode 100644 hugo/content/fr/security/application_security/setup/php/aws-fargate.md create mode 100644 hugo/content/fr/security/application_security/setup/python/kubernetes.md create mode 100644 hugo/content/fr/security/application_security/terms.md create mode 100644 hugo/content/fr/security/application_security/threat_protection/_index.md create mode 100644 hugo/content/fr/security/application_security/threat_protection/policies/custom_rules.md create mode 100644 hugo/content/fr/security/code_security/dev_tool_int/ide_plugins/_index.md create mode 100644 hugo/content/fr/security/code_security/static_analysis/_index.md create mode 100644 hugo/content/fr/synthetics/guide/rum-to-synthetics.md create mode 100644 hugo/content/fr/synthetics/platform/test_coverage/_index.md create mode 100644 hugo/content/fr/tests/test_parallelization/_index.md create mode 100644 hugo/content/ja/mcp_server/code_execution.md create mode 100644 hugo/content/ja/security/application_security/agentic_onboarding.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/create-an-inbox-rule/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/delete-an-inbox-rule/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/disable-a-default-inbox-rule/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/enable-a-default-inbox-rule/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/get-a-default-inbox-rule/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/get-all-default-inbox-rules/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/get-all-inbox-rules/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/reorder-inbox-rules/index.md create mode 100644 hugo/content/ko/api/latest/security-monitoring/update-an-inbox-rule/index.md create mode 100644 hugo/content/ko/gpu_monitoring/tracing.md create mode 100644 hugo/content/ko/incident_response/incident_management/post_incident/_index.md create mode 100644 hugo/content/ko/integrations/guide/aws-agent-installation-technical-reference.md create mode 100644 hugo/content/ko/integrations/guide/aws-agent-installation.md create mode 100644 hugo/content/ko/logs/explorer/findings.md create mode 100644 hugo/content/ko/opentelemetry/config/otlp_receiver.md create mode 100644 hugo/content/ko/opentelemetry/setup/collector_exporter/_index.md create mode 100644 hugo/content/ko/serverless/azure_app_service/linux_code.md create mode 100644 hugo/content/ko/tests/correlate_logs_and_tests/_index.md create mode 100644 hugo/content/ko/tracing/trace_collection/dd_libraries/android.md create mode 100644 hugo/layouts/shortcodes/observability_pipelines/configure_log_archive/amazon_s3/connect_s3_to_datadog_log_archives.fr.md diff --git a/hugo/content/es/account_management/plan_and_usage/partner_experience/customer_contracts.md b/hugo/content/es/account_management/plan_and_usage/partner_experience/customer_contracts.md new file mode 100644 index 00000000000..be139b31a1e --- /dev/null +++ b/hugo/content/es/account_management/plan_and_usage/partner_experience/customer_contracts.md @@ -0,0 +1,108 @@ +--- +description: Visualice su cartera de contratos de cliente final desde su organización + de administración de Datadog, incluidos los ingresos recurrentes, las fechas de + renovación, los saldos de reducción, las facturas y el estado de visibilidad de + costos. +further_reading: +- link: /account_management/plan_and_usage/partner_experience/customer_pricing/ + tag: Documentación + text: Customer Pricing +- link: /account_management/plan_and_usage/bill_overview/partner_purchased_cost_visibility/ + tag: Documentación + text: Visibilidad de costos para clientes que compran a través de un socio +- link: /account_management/plan_and_usage/partner_experience/ + tag: Documentación + text: Experiencia de Plan & Usage para partners +title: Customer Contracts +--- +La página [Customer Contracts][1] ofrece a los socios de Datadog una visualización única de su cartera de contratos de cliente final, incluidos los ingresos recurrentes, las fechas de renovación, las facturas y el estado de visibilidad de costos. Los mosaicos de resumen en la parte superior de la página muestran cuántos contratos están próximos a renovarse, cuántos clientes necesitan que se ingresen las tarifas antes de que puedan usar las funciones de visibilidad de costos, y la cantidad y el monto total de las facturas vencidas. + +{{< site-region region="gov,gov2" >}} +
Customer Contracts no está disponible para el sitio de Datadog ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}} + +{{< img src="account_management/plan_and_usage/customer-contracts-overview.png" alt="Página de Customer Contracts que muestra mosaicos de resumen para renovaciones, visibilidad de costos y facturas vencidas sobre una tabla de clientes." >}} + +**Nota**: Los datos en esta página se actualizan cada 30 minutos. + +## Requisitos previos {#prerequisites} + +Para usar Customer Contracts, necesita: + +- Una organización de administración de Datadog. Si no tiene una, comuníquese con su equipo de socios de Datadog. +- El permiso Billing Read (`billing_read`) en su organización de administración. Los usuarios con este permiso pueden visualizar toda la información en la página. Para obtener información sobre la administración de permisos, consulte [Role Based Access Control][4]. + +## Acceda a Customer Contracts {#access-customer-contracts} + +1. Inicie sesión en su organización administradora de Datadog. +2. Navegue a [{{< ui >}}Plan & Usage{{< /ui >}} > {{< ui >}}Customer Contracts{{< /ui >}}][1]. + +## Tabla de clientes {#customer-table} + +La tabla de clientes enumera a cada cliente bajo su organización de administración. Seleccione un cliente para abrir su panel de detalles de contrato. + +| Columna | Descripción | +|---|---| +| {{< ui >}}Customer{{< /ui >}} | Nombre del cliente final | +| {{< ui >}}CMRR{{< /ui >}} | Ingresos recurrentes mensuales del contrato | +| {{< ui >}}UMRR{{< /ui >}} | Ingresos recurrentes mensuales por uso, basados en el uso medido del cliente en lugar de su compromiso contractual | +| {{< ui >}}Overdue Balance{{< /ui >}} | Monto total de las facturas del cliente que han superado su fecha de vencimiento | +| {{< ui >}}Cost Visibility{{< /ui >}} | Si el cliente puede visualizar sus costos de Datadog. Verifique [estado de visibilidad de costos](#check-cost-visibility-status). | +| {{< ui >}}Contract Status{{< /ui >}} | Si el contrato está activo, acercándose a su fecha de renovación o vencido | + +Utilice el cuadro de búsqueda para encontrar un cliente específico o filtre la tabla por {{< ui >}}Cost Visibility{{< /ui >}} o {{< ui >}}Contract Status{{< /ui >}}. + +## Hacer un seguimiento de las renovaciones {#track-renewals} + +La tabla de clientes muestra el estado del contrato para cada cliente, para que pueda visualizar qué contratos se acercan a su fecha de renovación y cuáles ya la han superado. Ordene o filtre por {{< ui >}}Contract Status{{< /ui >}} para llevar los contratos más urgentes a la parte superior. + +{{< img src="account_management/plan_and_usage/customer-contracts-renewals.png" alt="Tabla de clientes ordenada por estado del contrato, que muestra los contratos vencidos y los que están por vencer." >}} + +## Revisar detalles del contrato {#review-contract-details} + +Seleccione un cliente para abrir su panel de detalles de contrato. La pestaña {{< ui >}}Current Contract{{< /ui >}} muestra: + +- {{< ui >}}Spend Overview{{< /ui >}}: CMRR del mes pasado, UMRR del mes pasado y utilización del contrato. +- {{< ui >}}Contract Info{{< /ui >}}: estado de influencia (Influenciado o No influenciado), fecha de inicio del contrato y fecha de finalización del contrato. +- {{< ui >}}Drawdown Depletion{{< /ui >}}: el compromiso total, el gasto hasta la fecha, los fondos restantes, el total proyectado, el exceso proyectado y la fecha de agotamiento proyectada en comparación con la fecha de finalización del contrato. Esta sección aparece solo para contratos de reducción de fondos, donde el uso del cliente reduce un fondo comprometido durante el plazo del contrato. + +{{< img src="account_management/plan_and_usage/customer-contracts-detail.png" alt="Panel de detalles del contrato para un cliente que muestra la descripción general del gasto, la barra de progreso de agotamiento de fondos y la barra lateral de información del contrato." >}} + +Puede establecer las tarifas de un cliente desde la pestaña {{< ui >}}Custom Pricing Configuration{{< /ui >}} de este panel en lugar de ir a la página de [Precios del cliente][2]. + +## Hacer un seguimiento de las facturas {#monitor-invoices} + +La pestaña {{< ui >}}Invoices{{< /ui >}} del panel de detalles del contrato enumera cada factura de ese cliente con su fecha de emisión, fecha de vencimiento, monto y estado de pago. Abra el PDF de cualquier factura desde esta pestaña. El saldo vencido de cada cliente también aparece en la tabla principal de clientes, y los mosaicos de resumen en la parte superior de la página muestran el recuento y el monto total de las facturas vencidas en toda su cartera. + +**Nota**: El estado de pago refleja si usted ha pagado su factura de Datadog por el uso de ese cliente. No realiza un seguimiento de si el cliente final le ha pagado a usted. + +{{< img src="account_management/plan_and_usage/customer-contracts-invoices.png" alt="Pestaña Facturas del panel de detalles del contrato que enumera las facturas con fecha de emisión, fecha de vencimiento, monto, estado de pago y un enlace para visualizar el PDF." >}} + +## Verifique el estado de visibilidad de costos {#check-cost-visibility-status} + +Sus clientes finales pueden visualizar sus propios costos estimados de Datadog del mes a la fecha e históricos en su organización de Datadog, calculados a partir de las tarifas que usted publica para ellos. La columna {{< ui >}}Cost Visibility{{< /ui >}} muestra la situación de cada cliente: + +- {{< ui >}}Enabled{{< /ui >}}: el cliente puede visualizar sus costos de Datadog en su propia organización. +- {{< ui >}}Not configured{{< /ui >}}: aún no ha publicado tarifas para este cliente. +- {{< ui >}}Update needed{{< /ui >}}: el contrato del cliente cambió, por lo que sus tarifas publicadas necesitan una actualización. + +El mosaico {{< ui >}}Cost Visibility Action Needed{{< /ui >}} en la parte superior de la página cuenta a los clientes en los estados {{< ui >}}Not configured{{< /ui >}} y {{< ui >}}Update needed{{< /ui >}}. + +Para publicar o actualizar tarifas, consulte [Precios para clientes][2]. Para explicar la función a su cliente, comparta [Visibilidad de costos para clientes que compran a través de un socio][3]. + +{{< img src="account_management/plan_and_usage/customer-contracts-cost-visibility.png" alt="Tabla de clientes con la columna Visibilidad de costos resaltada, que muestra a los clientes marcados como Habilitado o Actualización necesaria." >}} + +## Busque contactos de la cuenta {#find-account-contacts} + +La sección {{< ui >}}Contacts{{< /ui >}} del panel de detalles del contrato enumera al Gerente de éxito del cliente (CSM) de Datadog, al Ejecutivo de cuenta (AE) de Datadog y al Gerente de ventas para socios para preguntas específicas de la cuenta, junto con el contacto de facturación que recibe las facturas del cliente. + +{{< img src="account_management/plan_and_usage/customer-contracts-contacts.png" alt="Sección de contactos del panel de detalles del contrato que enumera al CSM de Datadog, al AE de Datadog, al contacto de facturación y al Gerente de ventas para socios." >}} + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/billing/customer-contracts +[2]: /es/account_management/plan_and_usage/partner_experience/customer_pricing/ +[3]: /es/account_management/plan_and_usage/bill_overview/partner_purchased_cost_visibility/ +[4]: /es/account_management/rbac/ \ No newline at end of file diff --git a/hugo/content/es/actions/datastores/create.md b/hugo/content/es/actions/datastores/create.md index 4f99e92023b..f9d34681338 100644 --- a/hugo/content/es/actions/datastores/create.md +++ b/hugo/content/es/actions/datastores/create.md @@ -1,101 +1,98 @@ --- aliases: - /es/actions/datastore/create -description: Crea almacenes de datos con claves primarias, siembra datos iniciales - y gestiona el contenido de los almacenes de datos mediante edición manual o carga - de archivos. +description: Cree Datastores con claves principales, inicialice datos y administre + el contenido del Datastore mediante edición manual o carga de archivos. disable_toc: false further_reading: -- link: service_management/app_builder/build +- link: actions/app_builder/build tag: Documentación text: Crear aplicaciones -- link: service_management/workflows/build +- link: actions/workflows/build tag: Documentación - text: Crear flujos de trabajo + text: Cree flujos de trabajo - link: https://www.datadoghq.com/blog/datadog-datastore/ tag: Blog - text: Mejorar tus aplicaciones y flujos de trabajo automatizados con almacenes de - datos -title: Crear y gestionar almacenes de datos + text: Mejore sus flujos de trabajo automatizados y aplicaciones automatizadas con + Datastore +title: Cree y administre Datastore --- +Puede crear y administrar Datastores desde la [página de Datastore][1]. -Puedes crear y gestionar almacenes de datos desde la [página de Datastore][1]. +## Cree un Datastore {#create-a-datastore} -## Crear un almacén de datos +Para crear un Datastore: -Para crear un almacén de datos: +1. Navegue a la [página de Datastore][1]. +1. Haga clic en {{< ui >}}\+ New Datastore{{< /ui >}}. +1. Ingrese un {{< ui >}}Name{{< /ui >}} para su Datastore. +1. Ingrese una {{< ui >}}Primary Key{{< /ui >}} o active la opción para {{< ui >}}Autogenerate a Primary Key{{< /ui >}} si una clave principal no es esencial para su caso de uso. + - Si elige ingresar una clave principal, la clave debe ser un nombre de columna en sus datos donde cada clave tenga un valor único. + - Elegir la generación automática de una clave elimina su capacidad de proporcionar sus propias claves para nuevos elementos en el Datastore, pero aún puede actualizar elementos existentes especificando sus claves. +1. Opcionalmente, ingrese una {{< ui >}}Description{{< /ui >}} para su Datastore. +1. _Opcionalmente_, puede inicializar su Datastore con datos iniciales desde un archivo JSON o CSV. Utilice uno de los siguientes métodos para cargar el contenido del archivo: + * Arrastre y suelte el archivo en la interfaz de usuario. + * Haga clic en {{< ui >}}browse files{{< /ui >}} para buscar y seleccionar un archivo desde su computadora. + * Copie un archivo CSV en su computadora y use Ctrl/Cmd + V para pegarlo. -1. Navega hasta la página de [Datastores][1] (Almacenes de datos). -1. Haz clic en **+ New Datastore** (+ Nuevo almacén de datos). -1. Introduce un **Name** (Nombre) para tu almacén de datos. -1. Introduce una **Primary Key** (Clave primaria) o activa la opción **Autogenerate a Primary Key** (Autogenerar una clave primaria) si una clave primaria no es esencial para tu caso de uso. - - Si eliges introducir una clave primaria, la clave debe ser un nombre de columna en tus datos donde cada clave tenga un valor único. - - Si eliges Autogenerar una clave, no podrás proporcionar tus propias claves para los nuevos elementos del almacén de datos, pero podrás actualizar los elementos existentes especificando sus claves. -1. Opcionalmente, puedes introducir una **Description** (Descripción) para tu almacén de datos. -1. Opcionalmente, puedes sembrar yu almacén de datos con los datos iniciales de un archivo JSON o CSV. Utiliza uno de los siguientes métodos para cargar el contenido del archivo: - * Arrastra y suelta el archivo en la interfaz de usuario. - * Haz clic en **browse files** (examinar archivos) para examinar y seleccionar un archivo de tu ordenador. - * Copia un archivo CSV en tu ordenador y utiliza Ctrl/Cmd + V para pegarlo. + El archivo CSV o JSON debe incluir una fila de encabezado con una columna que coincida con su clave principal. +1. Haga clic en {{< ui >}}Create{{< /ui >}}. Aparece una ventana emergente de confirmación con opciones para [crear un flujo de trabajo o una aplicación][2] desde su Datastore, o visualizar el Datastore. - El archivo CSV o JSON debe incluir una fila de encabezado con una columna que coincida con tu Clave principal. -1. Haz clic en **Create** (Crear). Aparecerá una ventana emergente de confirmación con opciones para [crear un proceso o un aplicación][2] desde tu almacén de datos, o ver el almacén de datos. +### Cree desde una aplicación o flujo de trabajo {#create-from-an-app-or-workflow} -### Crear desde una aplicación o proceso +Puede crear un Datastore desde una aplicación o flujo de trabajo haciendo clic en el botón {{< ui >}}Datastore ID{{< /ui >}} en una acción de Datastore y seleccionando {{< ui >}}New Datastore{{< /ui >}}. -Puedes crear un almacén de datos desde una aplicación o proceso haciendo clic en el botón **Datastore ID** (ID del almacén de datos) de una acción de almacén de datos y seleccionando **New Datastore** (Nuevo almacén de datos). +{{< img src="actions/datastore/datastore-create.png" alt="Cree un flujo de trabajo desde un flujo de trabajo haciendo clic en New Datastore" style="width:100%;" >}} -{{< img src="actions/datastore/datastore-create.png" alt="Crear un proceso desde un proceso al hacer clic en Nuevo almacén de datos" style="width:100%;" >}} +## Edite un Datastore {#edit-a-datastore} -## Editar un almacén de datos +### Edite sus datos manualmente {#manually-edit-your-data} -### Editar manualmente tus datos +Para editar manualmente una fila en su Datastore: +1. En la [página de Datastores][1], localice su Datastore y haga clic para abrirlo. +1. Pase el cursor sobre la fila que desea cambiar y haga clic en el {{< ui >}}Edit{{< /ui >}} {{< img src="icons/pencil.png" inline="true" style="width:14px;">}} icono. +1. Utilice las pestañas {{< ui >}}JSON{{< /ui >}} o {{< ui >}}Raw text{{< /ui >}} para editar las claves en la fila. -Para editar manualmente una fila de tu almacén de datos: -1. En la [página Datastores][1] (Almacenes de datos), localiza tu almacén de datos y haz clic para abrirlo. -1. Pasa el ratón por encima de la fila que desees modificar y haz clic en el icono **Edit** (Editar) {{< img src="icons/pencil.png" inline="true" style="width:14px;">}}. -1. Utiliza las pestañas **JSON** o **Texto sin formato** para editar las claves de la fila. +**Nota:** No puede editar manualmente la clave principal en una fila. Si necesita editar una clave principal, elimine la fila y vuelva a agregarla o vuelva a cargar los datos desde un archivo. -**Nota:** No puedes editar manualmente la clave primaria de una fila. Si necesitas editar una clave primaria, elimina la fila y vuelve a añadirla o vuelve a cargar los datos desde un archivo. +### Actualice mediante un archivo {#update-using-a-file} -### Actualizar mediante un archivo +Para actualizar un Datastore mediante un archivo: +1. En la [página de Datastores][1], localice su Datastore y haga clic para abrirlo. +1. Haga clic en {{< ui >}}Add Data{{< /ui >}}. +1. Seleccione una opción sobre cómo se deben manejar sus datos. + - {{< ui >}}Overwrite{{< /ui >}} reemplaza las filas existentes en su tabla con los datos de su archivo. + - {{< ui >}}Append{{< /ui >}} agrega las filas de su archivo al conjunto de datos existente. La opción de agregar no le permite añadir entradas duplicadas a su conjunto de datos. +1. Haga clic en {{< ui >}}Add{{< /ui >}}. -Para actualizar un almacén de datos mediante un archivo: -1. En la [página Datastores][1] (Almacenes de datos), localiza tu almacén de datos y haz clic para abrirlo. -1. Haz clic en **Add Data** (Añadir datos). -1. Selecciona una opción para el tratamiento de tus datos. - - **Sobrescribir** reemplaza las filas existentes en tu tabla con los datos de tu archivo. - - **Añadir** añade las filas de tu archivo al conjunto de datos existente. La opción añadir no permite añadir entradas duplicadas al conjunto de datos. -1. Haz clic en **Add** (Añadir). +## Visualizar un Datastore {#view-a-datastore} -## Ver un almacén de datos +Para visualizar un Datastore, localice su Datastore en la [página de Datastore][1] y haga clic para abrirlo. -Para ver un almacén de datos, localízalo en la [página Datastores][1] (Almacenes de datos) y haz clic para abrirlo. - -Después de abrir un almacén de datos, puedes: +Después de haber abierto un Datastore, puede: - Exportar el conjunto de datos a un archivo JSON o CSV. -- Haz clic en **Columns** (Columnas) para mostrar u ocultar las columnas de la tabla. -- Haz clic en **Create** (Crear) para [crear un proceso o aplicación][2] desde el almacén de datos. -- Haz clic en **Add data** (Añadir datos) para [añadir datos](#edit-a-datastore) desde un archivo CSV o JSON. +- Haga clic en {{< ui >}}Columns{{< /ui >}} para mostrar u ocultar las columnas de la tabla. +- Haga clic en {{< ui >}}Create{{< /ui >}} para [crear un flujo de trabajo o una aplicación][2] a partir del Datastore. +- Haga clic en {{< ui >}}Add data{{< /ui >}} para [agregar datos](#edit-a-datastore) desde un archivo CSV o JSON. -El botón **Table Options** (Opciones de tabla) te permite: -- Editar los [permisos del almacén de datos][3]. -- Copia el UUID del almacén de datos, lo que resulta útil para [aplicaciones con múltiples referencias a almacenes de datos][4]. -- Clonar el almacén de datos. -- Eliminar el almacén de datos. +El botón {{< ui >}}Table Options{{< /ui >}} le permite: +- Editar los [permisos de Datastore][3]. +- Copie el UUID de Datastore, lo cual es útil para [apps con múltiples referencias a Datastore][4]. +- Clone el Datastore. +- Elimine el Datastore. -## Limitaciones +## Limitaciones {#limitations} -Datastore tiene las siguientes limitaciones: +Los almacenes de datos tienen las siguientes limitaciones: -- Tu organización puede tener hasta 50 almacenes de datos. -- Un almacén de datos puede contener hasta 5.000 filas. -- Se requiere una columna de clave primaria de tipo `string` que identifique de forma única cada fila. +- Un Datastore puede contener hasta 100,000 filas. +- Se requiere una columna de clave principal de tipo `string` y debe identificar de forma única cada fila. - Cada fila puede tener un tamaño de hasta 100 KB. -- El valor de la clave primaria es inmutable, no puede modificarse una vez creada la fila. +- El valor de la clave principal es inmutable; no se puede cambiar después de que se crea la fila. -Si tienes un caso de uso que supera estos límites, ponte en contacto con el [servicio de asistencia][5]. +Comuníquese con [support][5] si tiene un caso de uso que exceda estos límites. -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/agent/troubleshooting/windows_containers.md b/hugo/content/es/agent/troubleshooting/windows_containers.md index ac84f43a627..02eaa1e77cb 100644 --- a/hugo/content/es/agent/troubleshooting/windows_containers.md +++ b/hugo/content/es/agent/troubleshooting/windows_containers.md @@ -8,47 +8,46 @@ further_reading: text: Kubernetes Agent - link: /agent/troubleshooting/ tag: Documentación - text: Solucionar problemas del Agent -title: Problemas de los contenedores de Windows + text: Agent Troubleshooting +title: Problemas de Containers de Windows --- +Esta página describe los problemas conocidos y abiertos para la supervisión de aplicaciones de Windows en contenedores. -En esta página se describen los problemas detectados y no resueltos de monitorización de aplicaciones contenerizadas de Windows. +## Problemas comunes {#common-issues} -## Problemas frecuentes +Containerized Windows Applications Monitoring requires Datadog Agent 7.19+. -La monitorización de aplicaciones contenedorizadas de Windows requiere el Datadog Agent v7.19 o posterior. - -Las versiones de sistemas operativos compatibles son: -- Windows Server 2019 (LTSC /1809) +Las versiones de SO compatibles son: +- Windows Server 2019 (LTSC / 1809) - Windows Server 2019 1909 (hasta el Agent 7.39, ya no es compatible con Microsoft) - Windows Server 2019 2004 o 20H1 (hasta el Agent 7.39, ya no es compatible con Microsoft) - Windows Server 2019 20H2 (Agent 7.33 a 7.39, ya no es compatible con Microsoft) -- Windows Server 2022 LTSC (Agent v7.34 o posterior) +- Windows Server 2022 LTSC (Agent >=7.34) -El modo de aislamiento Hyper-V no es compatible. +El modo de aislamiento de Hyper-V no es compatible. -Las métricas de host para disco, E/S y red están deshabilitadas. No son compatibles con Windows Server, por lo que los checks del Agent están deshabilitados de forma predeterminada. +Las métricas del servidor para disco, E/S y red están deshabilitadas. No son compatibles con Windows Server, por lo que las Agent Checks están deshabilitadas de forma predeterminada. -## Problemas con Docker +## Problemas de Docker {#docker-issues} -Los Live Processes no aparecen en los contenedores (excepto el Datadog Agent). +Live processes do not appear in containers (except for the Datadog Agent). -## Problemas con Kubernetes +## Problemas de Kubernetes {#kubernetes-issues} -Los Live Processes no aparecen en los contenedores (excepto el Datadog Agent). +Live processes do not appear in containers (except for the Datadog Agent). -### Clústeres mixtos (Linux + Windows) +### Clústeres mixtos (Linux + Windows) {#mixed-clusters-linux-windows} -El método recomendado para desplegar el Datadog Agent en un clúster mixto es realizar dos instalaciones del Helm chart con diferentes `targetSystem`. +La forma recomendada de implementar el Datadog Agent en un clúster mixto es realizar dos instalaciones del chart de Helm con diferentes `targetSystem`. -El Datadog Agent utiliza un `nodeSelector` para seleccionar automáticamente nodos Linux o Windows basados en `targetSystem`. +El Datadog Agent utiliza un `nodeSelector` para seleccionar automáticamente nodos Linux o Windows según `targetSystem`. -Sin embargo, este no es el caso de las métricas de Kube State (que se instala por defecto), lo que lleva a situaciones en las que las métricas de Kube State no se pueden programar en los nodos de Windows. +Sin embargo, este no es el caso de Kube State Metrics (que se instala de forma predeterminada), lo que genera situaciones en las que Kube State Metrics no se puede programar en nodos Windows. -Para evitar este problema existen tres posibilidades: +Hay tres opciones disponibles para evitar este problema: -* Usar la función taint en tus nodos Windows. En Windows, el Agent siempre permite el taint `node.kubernetes.io/os=windows:NoSchedule`. -* Definir el selector de nodo Kube State Metrics a través del Helm chart `values.yaml` de Datadog: +* Aplique un taint a sus nodos Windows. En Windows, el Agent siempre permite el `node.kubernetes.io/os=windows:NoSchedule` taint. +* Configure el selector de nodos de Kube State Metrics a través del `values.yaml` del chart de Helm de Datadog: ``` kube-state-metrics: @@ -57,17 +56,17 @@ Para evitar este problema existen tres posibilidades: kubernetes.io/os: linux // Kubernetes >= 1.14 ``` -* Desplegar Kube State Metrics por tu cuenta de forma independiente estableciendo `datadog.kubeStateMetricsEnabled` como `false`. +* Implemente Kube State Metrics usted mismo por separado configurando `datadog.kubeStateMetricsEnabled` en `false`. -**Nota**: Cuando se utilizan dos instalaciones de Datadog (una con `targetSystem: linux`, otra con `targetSystem: windows`), es necesario verificar que la segunda tiene `datadog.kubeStateMetricsEnabled` definido como `false` para evitar que se desplieguen dos instancias de Kube State Metrics. +**Nota**: Al utilizar dos instalaciones de Datadog (una con `targetSystem: linux`, otra con `targetSystem: windows`), asegúrese de que la segunda tenga `datadog.kubeStateMetricsEnabled` configurado en `false` para evitar implementar dos instancias de Kube State Metrics. -Algunas métricas no están disponibles para los despliegues de Windows. Consulta [métricas disponibles](#limited-metrics-for-windows-deployments). +Algunas métricas no están disponibles para implementaciones en Windows. Consulte las [métricas disponibles](#limited-metrics-for-windows-deployments). -#### Clústeres mixtos con el Datadog Cluster Agent +#### Clústeres mixtos con el Datadog Cluster Agent {#mixed-clusters-with-the-datadog-cluster-agent} -Con Cluster Agent v1.18 y posteriores, el Datadog Cluster Agent admite una configuración con clústeres mixtos. +Con el Cluster Agent v1.18+, el Datadog Cluster Agent admite una configuración con clústeres mixtos. -Para configurar la comunicación entre los Agents desplegados en nodos Windows y el Cluster Agent, utiliza el siguiente archivo `values.yaml`. +Utilice el siguiente archivo `values.yaml` para configurar la comunicación entre los Agent desplegados en nodos de Windows y el Cluster Agent. ```yaml targetSystem: windows @@ -85,52 +84,56 @@ datadog: kubeStateMetricsEnabled: false ``` -#### Opciones de configuración limitadas para las implementaciones de Windows +#### Opciones de configuración limitadas para implementaciones en Windows {#limited-configuration-options-for-windows-deployments} + +
Implementar el Agent en nodos de Windows con el DatadogAgent recurso por sí solo no es compatible.
+ +A partir de Datadog Operator v1.30.0, el soporte para nodos Windows está disponible para clústeres de nodos mixtos (Windows y Linux). Para usarlo, agregue un [DatadogAgentProfile](/containers/datadog_operator/datadog_agent_profiles) dirigido a Windows junto con su recurso `DatadogAgent`. Si no está utilizando un `DatadogAgentProfile`, utilice el [chart de Helm](/containers/kubernetes/installation/?tab=helm) para implementar el Agent en nodos de Windows. -Algunas opciones de configuración no están disponibles en Windows. A continuación se muestra una lista de opciones **no compatibles**: +Algunas opciones de configuración no están disponibles en Windows. La siguiente es una lista de opciones **no compatibles**: | Parámetro | Motivo | | --- | ----------- | | `datadog.dogstatsd.useHostPID` | El PID del host no es compatible con los contenedores de Windows | -| `datadog.dogstatsd.useSocketVolume` | Los sockets del Unix no son compatibles con Windows | -| `datadog.dogstatsd.socketPath` | Los sockets del Unix no son compatibles con Windows | -| `datadog.processAgent.processCollection` | No es posible acceder a los procesos del host/otros contenedores | -| `datadog.systemProbe.seccomp` | System probe no está disponible para Windows | -| `datadog.systemProbe.seccompRoot` | System probe no está disponible para Windows | -| `datadog.systemProbe.debugPort` | System probe no está disponible para Windows | -| `datadog.systemProbe.enableConntrack` | System probe no está disponible para Windows | -| `datadog.systemProbe.bpfDebug` | System probe no está disponible para Windows | -| `datadog.systemProbe.apparmor` | System probe no está disponible para Windows | -| `agents.useHostNetwork` | La red del host no es compatible con los contenedores de Windows | +| `datadog.dogstatsd.useSocketVolume` | Los sockets Unix no son compatibles con Windows | +| `datadog.dogstatsd.socketPath` | Los sockets Unix no son compatibles con Windows | +| `datadog.processAgent.processCollection` | No se puede acceder a los procesos del host/otros contenedores | +| `datadog.systemProbe.seccomp` | La sonda del sistema no está disponible para Windows | +| `datadog.systemProbe.seccompRoot` | La sonda del sistema no está disponible para Windows | +| `datadog.systemProbe.debugPort` | La sonda del sistema no está disponible para Windows | +| `datadog.systemProbe.enableConntrack` | La sonda del sistema no está disponible para Windows | +| `datadog.systemProbe.bpfDebug` | La sonda del sistema no está disponible para Windows | +| `datadog.systemProbe.apparmor` | La sonda del sistema no está disponible para Windows | +| `agents.useHostNetwork` | Host network not supported by Windows Containers | -### HostPort para el APM o DogStatsD +### HostPort para APM o DogStatsD {#hostport-for-apm-or-dogstatsd} -`HostPort` es compatible parcialmente con Kubernetes, dependiendo de la versión del sistema operativo subyacente y del plugin CNI. -Los requisitos para que funcione `HostPort` son los siguientes: +`HostPort` es parcialmente compatible con Kubernetes, dependiendo de la versión del sistema operativo subyacente y del complemento CNI. +Los requisitos para que `HostPort` funcione son los siguientes: -* Se requiere la versión de Windows Server 1909 o posterior -* El plugin CNI debe ser compatible con la función `portMappings` +* La versión de Windows Server debe ser >= 1909 +* El complemento CNI debe admitir la capacidad `portMappings` -Actualmente, al menos dos plugins CNI admiten esta función: +Actualmente, al menos dos complementos de CNI admiten esta capacidad: -* Plugin oficial `win-bridge` (versión 0.8.6 y posteriores), utilizado por GKE -* Plugin CNI de Azure, utilizado por AKS +* Complemento `win-bridge` oficial (versión >= 0.8.6) - utilizado por GKE +* Complemento de Azure CNI - utilizado por AKS -Si tu configuración no cumple estos requisitos, APM y DogStatsD solo funcionarán cuando esté configurada la red pod-to-pod entre el Tracer y el Agent. +Si su configuración no cumple con estos requisitos, APM y DogStatsD solo funcionarán cuando la red pod-to-pod esté configurada entre el Tracer y el Agent. -### Check de Kubelet +### Kubelet check {#kubelet-check} -Según la versión de Kubernetes, es posible que algunas métricas de Kubelet no estén disponibles (o que el check de Kubelet agote el tiempo de espera). -Para una experiencia óptima, utiliza cualquiera de las siguientes opciones con el Datadog Agent v7.19.2+: +Depending on your Kubernetes version, some Kubelet metrics might not be available (or that the Kubelet check times out). +Para una experiencia óptima, utilice cualquiera de los siguientes con Datadog Agent v7.19.2+: * Kubelet v1.16.13+ (v1.16.11+ en GKE) * Kubelet v1.17.9+ (v1.17.6+ en GKE) * Kubelet v1.18.6+ * Kubelet v1.19+ -### Métricas limitadas para despliegues de Windows +### Métricas limitadas para implementaciones de Windows {#limited-metrics-for-windows-deployments} -Las siguientes métricas de `kubernetes.*` están disponibles para los contenedores de Windows: +The following `kubernetes.*` metrics are available for Windows Containers: * `kubernetes.cpu.usage.total` * `kubernetes.containers.restarts` diff --git a/hugo/content/es/bits_ai/bits_code/slack_code_channels.md b/hugo/content/es/bits_ai/bits_code/slack_code_channels.md new file mode 100644 index 00000000000..eadf8c15cc3 --- /dev/null +++ b/hugo/content/es/bits_ai/bits_code/slack_code_channels.md @@ -0,0 +1,76 @@ +--- +description: Aprenda a crear y trabajar en canales de código temporales en Slack, + donde puede dirigir a Bits Code, visualizar diferencias de código y crear PRs. +further_reading: +- link: /bits_ai/bits_code/ + tag: Documentación + text: Bits Code +- link: /bits_ai/bits_chat/#slack + tag: Documentación + text: Bits Chat en Slack +- link: /integrations/slack/ + tag: Documentación + text: Integración de Slack +- link: https://slack.com/features/code-channels + tag: Documentación de Slack + text: Canales de código +title: Canales de código en Slack con Bits Code +--- +## Descripción general {#overview} + +Los canales de código son canales de Slack temporales y dedicados para trabajar con un agente de codificación en una tarea específica. Cuando le pide a [Bits Chat][1] en Slack que realice un cambio de código, [Bits Code][3] crea un canal de código para esa tarea. Usted y su equipo pueden seguir el trabajo, dirigirlo y revisar el resultado allí, sin saturar la conversación original. + +{{< img src="bits_ai/dev_agent/slack_code_channels/code_channel.png" alt="Un canal de código de Slack que muestra una conversación con Bits Code junto a una opción para visualizar los cambios de código propuestos." style="width:100%;" >}} + +Obtenga más información sobre los canales de código en la [documentación de Slack][6]. + +## Crear un canal de código {#create-a-code-channel} + +Después de [configurar Bits Code][4], cree un canal de código mencionando a `@Datadog` en Slack y describiendo un cambio de código que le gustaría realizar. Si Bits Chat determina que la solicitud requiere cambios de código, transfiere la tarea a Bits Code, que crea un canal de código. Bits publica un enlace al nuevo canal de código en la ubicación donde se solicitó originalmente. + +{{< img src="bits_ai/dev_agent/slack_code_channels/code_channel_creation.png" alt="Un mensaje de Slack mencionando a @Datadog, seguido de una tarjeta que muestra el canal de código resultante que se creó" style="width:100%;" >}} + +Bits Code nombra el canal de código automáticamente según su solicitud inicial. Encuentre sus canales de código en una sección {{< ui >}}Code channels{{< /ui >}} dedicada en su barra lateral de Slack. + +### Permisos y acceso {#permissions-and-access} + +Solo el usuario que solicitó a `@Datadog` se agrega automáticamente al nuevo canal de código. Los canales de código coinciden con la visibilidad del canal desde el cual se crean (es decir, si mencionó a `@Datadog` en un canal público, el canal de código resultante también es público). + +
Bits Code puede acceder a repositorios de código fuente con los permisos del usuario que lo solicitó @Datadog y creó el canal. Puede acceder a toda la telemetría de Datadog (con las restricciones de Access Control aplicadas) de todos los usuarios en el canal. Bits Code puede traer estos datos del repositorio y la telemetría al canal de código. Como creador de un canal de código, es su responsabilidad asegurarse de que cualquier persona que pueda visualizar un canal de código esté autorizada para visualizar su contenido, y que cualquier persona que pueda unirse a un canal de código esté autorizada para dirigir a Bits Code.
+ +Cualquier usuario que desee dirigir al agente debe tener una cuenta de Datadog conectada a Slack. (Si publica en un canal de código pero no tiene una cuenta de Datadog conectada, Bits ignora su mensaje.) + +## Trabaje en un canal de código {#work-in-a-code-channel} + +En otros canales de Slack, cuando desee una respuesta de Bits Chat, debe `@`-mencionarlo cada vez. Un canal de código funciona de manera diferente: Bits Code escucha cada mensaje publicado. No necesita mencionar a `@Datadog` nuevamente para seguir dirigiendo al agente. + +Mientras Bits Code trabaja, el canal de código muestra: + +- Una opción para visualizar los cambios propuestos en el código. +- Widgets de gráficos de Datadog, cuando sean relevantes para la tarea +- Un botón {{< ui >}}Create PR{{< /ui >}} para abrir una solicitud de extracción o de fusión a partir de los cambios, cuando esté listo + +Después de que Bits Code haya generado un diff de código, puede comentar en líneas específicas directamente en el canal de código. + +{{< img src="bits_ai/dev_agent/slack_code_channels/commenting_on_code.png" alt="Se redacta una pregunta para líneas de código específicas" style="width:100%;" >}} + +Bits Code no abre automáticamente una solicitud de extracción o de fusión desde un canal de código; haga clic en {{< ui >}}Create PR{{< /ui >}} cuando esté listo. El usuario que hace clic en {{< ui >}}Create PR{{< /ui >}} es el autor de la solicitud de extracción o de fusión resultante. + +El trabajo en cada canal de código también se refleja en una [sesión de Bits Code][2] en Datadog. Para verlo, en la esquina inferior derecha del canal de código, haga clic en {{< ui >}} Code session{{< /ui >}}. + +Obtenga más información sobre cómo trabajar en un canal de código en la [documentación de Slack][6]. + +## Limitaciones {#limitations} + +Las [limitaciones generales de Bits Code][5] también se aplican a los canales de código. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/bits_ai/bits_chat/#slack +[2]: /es/bits_ai/bits_code/#sessions +[3]: https://app.datadoghq.com/code +[4]: /es/bits_ai/bits_code/setup/ +[5]: /es/bits_ai/bits_code/#limitations +[6]: https://slack.com/help/articles/54310833022355-Build-with-AI-as-a-team-using-Slack-Code \ No newline at end of file diff --git a/hugo/content/es/bits_ai/bits_investigation/configure.md b/hugo/content/es/bits_ai/bits_investigation/configure.md index e1b1fd28666..f01fdd9392b 100644 --- a/hugo/content/es/bits_ai/bits_investigation/configure.md +++ b/hugo/content/es/bits_ai/bits_investigation/configure.md @@ -1,7 +1,7 @@ --- aliases: - /es/bits_ai/bits_ai_sre/configure/ -title: Configure Integrations y ajustes +title: Integrations y Settings --- Configure Integrations para ampliar las capacidades de Bits Investigation: - [Intégrese con plataformas de observabilidad y SCM de terceros](#integrate-with-third-party-observability-and-scm-platforms) para enriquecer las investigaciones con telemetría externa y contexto de código. diff --git a/hugo/content/es/byoc-logs/operate/sizing.md b/hugo/content/es/byoc-logs/operate/sizing.md new file mode 100644 index 00000000000..4d70497be92 --- /dev/null +++ b/hugo/content/es/byoc-logs/operate/sizing.md @@ -0,0 +1,195 @@ +--- +aliases: +- /es/cloudprem/configure/cluster_sizing/ +- /es/cloudprem/operate/sizing/ +description: Obtenga información sobre el dimensionamiento de clúster para BYOC Logs +further_reading: +- link: /byoc-logs/configure/ingress/ + tag: Documentación + text: Configure la ingesta de BYOC Logs +- link: /byoc-logs/configure/pipelines/ + tag: Documentación + text: Configure el procesamiento de BYOC Logs +- link: /byoc-logs/introduction/architecture/ + tag: Documentación + text: Obtenga más información sobre la arquitectura de BYOC Logs +title: Dimensionamiento del clúster +--- +{{< jqmath-vanilla >}} + +## Descripción general {#overview} + +Un dimensionamiento adecuado del clúster ayuda a garantizar un rendimiento óptimo, una eficiencia de costos y una confiabilidad para su implementación de BYOC Logs (Bring Your Own Cloud). Sus requisitos de dimensionamiento dependen de varios factores, incluidos el volumen de ingesta de registros, los patrones de consulta, el período de retención y la complejidad de sus datos de registros. + +Los [ejemplos de dimensionamiento](#sizing-examples) a continuación proporcionan configuraciones de punto de partida para volúmenes diarios de registros comunes. Para obtener una guía más detallada sobre cada componente, consulte las secciones que siguen. + +
+Utilice su volumen diario de registros esperado y las tasas máximas de ingesta como puntos de partida, luego hace un seguimiento del rendimiento de su clúster y ajuste el dimensionamiento según sea necesario. +
+ +## Ejemplos de dimensionamiento {#sizing-examples} + +La siguiente tabla proporciona configuraciones de referencia para volúmenes diarios de registros comunes. Estas recomendaciones están destinadas a ser puntos de partida y deben ajustarse según la utilización de recursos observada y el rendimiento de las consultas. + +Como punto de partida, planifique aproximadamente: + +- 2 vCPU de indexador por TB de registros ingeridos por día +- 1 vCPU de compactador por 2 TB de registros ingeridos por día + +La capacidad del buscador depende de la concurrencia de consultas, la complejidad de las consultas y la cantidad de datos escaneados. Por lo tanto, debe dimensionarse en función de la carga de trabajo de búsqueda esperada en lugar de solo el volumen de ingesta. Las cargas de trabajo con uso intensivo de análisis pueden requerir hasta el doble de la capacidad de búsqueda de referencia que se muestra a continuación. + +Estas recomendaciones asumen CPU x86 modernas, como las utilizadas en los tipos de instancia AWS M6, o CPU equivalentes de otros proveedores de nube. Las CPU basadas en ARM, como AWS Graviton, pueden ofrecer una mejor eficiencia de costos con un rendimiento comparable. + +La siguiente tabla muestra la capacidad total de vCPU para cada componente. + +| Volumen diario | Total de vCPU del indexador | Total de vCPU del compactador | Total de vCPU del buscador | +|---------------:|--------------------:|----------------------:|---------------------:| +| **1 TB/día** | 2 | 0.5 | 4 | +| **10 TB/día** | 20 | 5 | 40 | +| **100 TB/día** | 200 | 50 | 400 | + +Utilice las siguientes asignaciones de CPU y memoria por pod como punto de partida para distribuir la capacidad total entre los pods: + +| Volumen diario | Indexador por pod | Compactador por pod | Buscador por pod | +|-----------------|----------------:|------------------:|-----------------:| +| **Hasta 30 TB/día** | 4 vCPUs, 16 GB | 4 vCPUs, 16 GB | 16 vCPUs, 64 GB | +| **Más de 30 TB/día** | 8 vCPUs, 32 GB | 8 vCPUs, 32 GB | 64 vCPUs, 256 GB | + +
+Facturación frente a aprovisionamiento: Las vCPU aprovisionadas y las vCPU facturadas son diferentes. Un clúster de producción se aprovisiona intencionalmente en exceso para absorber los picos de ingesta y búsqueda. Comuníquese con su representante de Datadog para obtener orientación sobre la facturación. +
+ +## Indexadores {#indexers} + +Los indexadores reciben registros de los agentes de Datadog, luego los procesan, indexan y almacenan como archivos de índice (llamados _splits_) en el almacenamiento de objetos. El dimensionamiento adecuado es fundamental para mantener el rendimiento de la ingesta y garantizar que su clúster pueda manejar su volumen de registros. + +| Especificación | Recomendación | Notas | +|----------------------|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **Rendimiento** | 8 MB/s por vCPU | Rendimiento base para determinar el dimensionamiento inicial. El rendimiento real depende de las características del registro (tamaño, número de atributos, nivel de anidamiento) | +| **Memoria** | 4 GB de RAM por vCPU | | +| **Tamaño mínimo de Pod** | 2 vCPUs, 8 GB de RAM | Mínimo recomendado para pods de indexador | +| **Capacidad de almacenamiento** | Al menos 30 GB | Requerido para datos temporales mientras se crean y fusionan archivos de índice | +| **Tipo de almacenamiento** | Almacenamiento en bloque conectado a la red | Por ejemplo: Amazon EBS gp3, Azure Managed Disks o GCP Persistent Disk. Los datos se almacenan temporalmente en un registro de escritura anticipada (WAL) antes de cargarse en el almacenamiento de objetos. El WAL no se replica, por lo que el uso de SSD locales (efímeros) aumenta el riesgo de perder unos minutos de datos si el disco falla. El almacenamiento en bloque conectado a la red proporciona redundancia integrada. | +| **E/S de disco** | ~20 MB/s por vCPU | Equivalente a 320 IOPS por vCPU para Amazon EBS (asumiendo 64 KB por IOPS). Por ejemplo, el rendimiento predeterminado de 125 MiB/s de Amazon EBS gp3 es suficiente para un indexador de 4 vCPU. | + + +{{% collapse-content title="Ejemplo: Dimensionamiento para 100 TB de registros por día." level="h3" expanded=false %}} +Para indexar 100 TB de registros por día (~1,160 MB/s), siga estos pasos: + +1. **Calcule las vCPU:** `1,160 MB/s ÷ 8 MB/s per vCPU ≈ 145 vCPUs` +2. **Calcule la RAM:** `145 vCPUs × 4 GB RAM per vCPU ≈ 580 GB RAM` +3. **Agregue margen:** Comience con 50 pods de indexador, cada uno configurado con **4 vCPU, 16 GB de RAM y un disco de 30 GB**. Ajuste estos valores según el rendimiento observado y las necesidades de redundancia. +{{% /collapse-content %}} + +{{% collapse-content title="Dimensionamiento por recuento de eventos" level="h3" expanded=false %}} +Si conoce su recuento diario de eventos pero no su volumen en bytes, utilice esta fórmula para estimar: + +$$\\text\"Volumen diario (TB)\" = {\\text\"eventos por día\" × \\text\"tamaño promedio de evento (bytes)\"} / 10^\{12\}$$ + +Por ejemplo, con 1 mil millones de eventos/día con un tamaño promedio de 1 KB: + +`1,000,000,000 × 1,000 / 1,000,000,000,000 = 1 TB/day` + +Los tamaños típicos de los eventos de registro varían desde 500 bytes (syslog corto) hasta 2-3 KB (JSON con etiquetas de Kubernetes). Mida una muestra representativa de sus registros para obtener un promedio preciso. +{{% /collapse-content %}} + +## Compactadores {#compactors} + +El compactador fusiona divisiones de índice pequeñas en otras más grandes para reducir la fragmentación y mejorar la eficiencia de la búsqueda. También elimina las divisiones obsoletas para recuperar almacenamiento. + +| Especificación | Recomendación | Notas | +|------------------|---------------------|--------------------------------------------------------------| +| **Rendimiento** | 1 vCPU por 2 TB/día | Línea base para el dimensionamiento inicial | +| **Memoria** | 4 GB de RAM por vCPU | | +| **Tipo de almacenamiento** | SSD local | Se recomiendan instancias con SSD locales, como AWS M8gd | + +## Buscadores {#searchers} + +Los buscadores manejan las consultas de búsqueda desde la interfaz de usuario de Datadog, leyendo metadatos del Metastore y obteniendo datos del almacenamiento de objetos. + +Un punto de partida general es aprovisionar aproximadamente el doble del número total de vCPU asignadas a los indexadores. Consulte nuestros ejemplos de dimensionamiento. + +- **Rendimiento:** El rendimiento de la búsqueda depende en gran medida de la carga de trabajo (complejidad de la consulta, concurrencia, cantidad de datos escaneados). Por ejemplo, las consultas de términos (`status:error AND message:exception`) suelen ser computacionalmente menos costosas que las consultas de búsqueda con comodines o de eventos completos. +- **Memoria:** 4 GB de RAM por cada vCPU del buscador. Aprovisione más RAM si espera muchas solicitudes de agregación simultáneas. + + +## Otros servicios {#other-services} + +Asigne los siguientes recursos para estos componentes ligeros: + +| Servicio | vCPUs | RAM | Réplicas | +|---------|-------|-----|----------| +| **Plano de control** | 2 | 4 GB | 1 | +| **Metastore** | 2 | 4 GB | 2 | +| **Janitor** | 2 | 4 GB | 1 | + +## Estimación de almacenamiento de objetos {#object-storage-estimation} + +BYOC Logs comprime e indexa los datos de registro antes de almacenarlos en el almacenamiento de objetos. La relación de compresión depende del formato de registro, la estructura y la redundancia en sus datos. + +| Métrica | Rango típico | +|--------|---------------| +| **Relación de compresión** | 5x a 8x (entrada sin procesar a tamaño almacenado) | +| **Almacenamiento por TB/día ingerido** | 125-200 GB/día en almacenamiento de objetos | + +Para estimar sus requisitos de almacenamiento de objetos: + +$$\\text\"Datos almacenados por día\" = {\\text\"Volumen diario\"} / {\\text\"relación de compresión\"}$$ + +$$\\text\"Almacenamiento total\" = \\text\"Datos almacenados por día\" × \\text\"período de retención (días)\"$$ + +Los siguientes ejemplos asumen un período de retención de 30 días y una relación de compresión de 6x: + +| Volumen diario | Almacenamiento de objetos | +|---------------:|---------------:| +| **1 TB/día** | ~5 TB | +| **10 TB/día** | ~50 TB | +| **100 TB/día** | ~500 TB | + +{{% collapse-content title="Ejemplo: Almacenamiento para 10 TB/día con retención de 30 días" level="h3" expanded=false %}} +Suponiendo una relación de compresión de 6x: + +1. **Almacenado por día:** `10 TB / 6 ≈ 1.67 TB/day` +2. **Total por 30 días:** `1.67 TB × 30 ≈ 50 TB` + +Utilice almacenamiento de objetos de nivel estándar (por ejemplo, S3 Standard, GCS Standard) para datos activos. Los niveles de menor costo, como S3 Infrequent Access o GCS Nearline, no están validados para su uso con BYOC Logs. +{{% /collapse-content %}} + +## Base de datos PostgreSQL {#postgresql-database} + +- **Tamaño de la instancia:** Para la mayoría de los casos de uso, una instancia de PostgreSQL con 1 vCPU y 4 GB de RAM es suficiente +- **Recomendación de AWS RDS:** Si utiliza AWS RDS, el tipo de instancia `t4g.medium` es un punto de partida adecuado +- **Alta disponibilidad:** Habilite la implementación Multi-AZ con una réplica en espera para alta disponibilidad + +## Niveles de dimensionamiento del gráfico de Helm {#helm-chart-sizing-tiers} + +El gráfico de Helm de BYOC Logs proporciona niveles de recursos predefinidos a través de los parámetros `indexer.podSize` y `searcher.podSize`. `podSize` selecciona los requisitos de recursos del pod y los parámetros de ajuste de Quickwit relacionados. El `podSize` predeterminado es `xlarge` para ambos componentes. Cada ajuste preestablecido está diseñado para dejar espacio en un nodo coincidente para los componentes del sistema de Kubernetes, DaemonSets y complementos. + +Los ajustes preestablecidos tienen en cuenta los recursos reservados para los componentes del sistema de Kubernetes. Las cantidades de reserva se basan en el [cálculo de reserva de nodos de GKE](https://docs.cloud.google.com/kubernetes-engine/docs/concepts/plan-node-sizes#resource_reservations). Se reservan 250m de CPU y 512Mi de memoria adicionales por nodo para DaemonSets y complementos: + +```text +Actual CPU request = (nominal pod CPU - Kubernetes system CPU reservation - 250m), rounded down to the nearest 100m +Actual memory request/limit = (nominal pod memory - Kubernetes system memory reservation - 512Mi), rounded down to the nearest 100Mi +``` + +| `podSize` | Solicitud de CPU nominal | Solicitud de CPU real | Solicitud/límite de memoria nominal | Solicitud/límite de memoria real | +|---|---:|---:|---:|---:| +| `large` | 2 | 1600m | 8Gi | 5700Mi | +| `xlarge` | 4 | 3600m | 16Gi | 13100Mi | +| `2xlarge` | 8 | 7600m | 32Gi | 28500Mi | +| `4xlarge` | 16 | 15600m | 64Gi | 59300Mi | +| `6xlarge` | 24 | 23600m | 96Gi | 90100Mi | +| `8xlarge` | 32 | 31600m | 128Gi | 120900Mi | + +Los preajustes no establecen un límite de CPU, lo que permite que un pod utilice la CPU inactiva en su nodo sin ser limitado. Las solicitudes y los límites de memoria son iguales para mantener el uso de memoria dentro de la capacidad asignable del nodo. + +Los valores que definen los tamaños de la cola de ingesta y los tamaños de la caché de búsqueda se aplican automáticamente para el nivel seleccionado. Consulte el mapa de dimensionamiento del gráfico de Helm [1] para ver la configuración completa. Para obtener más detalles sobre cada parámetro, consulte la documentación de Quickwit para [parámetros del indexador][2], [parámetros de la API de ingesta][3] y [parámetros del buscador][4]. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://github.com/DataDog/helm-charts/blob/main/charts/cloudprem/sizing-map.yaml +[2]: https://quickwit.io/docs/configuration/node-config#indexer-configuration +[3]: https://quickwit.io/docs/configuration/node-config#ingest-api-configuration +[4]: https://quickwit.io/docs/configuration/node-config#searcher-configuration \ No newline at end of file diff --git a/hugo/content/es/cloud_cost_management/reporting/explorer.md b/hugo/content/es/cloud_cost_management/reporting/explorer.md index 7700077cb4c..4d1ebc738b2 100644 --- a/hugo/content/es/cloud_cost_management/reporting/explorer.md +++ b/hugo/content/es/cloud_cost_management/reporting/explorer.md @@ -1,164 +1,163 @@ --- -description: Consulta y analiza los costes de la nube en tiempo real con filtros y +description: Consulte y analice los costos de la nube en tiempo real con filtros y visualizaciones flexibles. further_reading: - link: /cloud_cost_management/reporting/ tag: Documentación - text: Crear y guardar informes de costes + text: Cree y guarde informes de costos - link: /cloud_cost_management/tags/multisource_querying tag: Documentación - text: Consulta de costes entre varios proveedores + text: Consulte los costos en múltiples proveedores - link: /monitors/types/cloud_cost/ tag: Documentación - text: Crear monitores de costes + text: Cree monitores de costos - link: /cloud_cost_management/ tag: Documentación - text: Más información sobre Cloud Cost Management + text: Obtenga información sobre Cloud Cost Management title: Cost Explorer --- +## Descripción general {#overview} -## Información general +El [Cloud Cost Explorer][1] proporciona una interfaz interactiva basada en consultas para analizar su gasto en la nube en [AWS][2], [Azure][3], [Google Cloud][4], [Oracle][5], [proveedores SaaS][6] y [costos de Datadog][7]. A diferencia de los informes guardados, el explorador le permite realizar análisis ad-hoc con consultas, filtros y visualizaciones flexibles para investigar tendencias de costos, identificar anomalías y responder preguntas específicas sobre su gasto en la nube. -[Cloud Cost Explorer][1] proporciona una interfaz interactiva basada en consultas para analizar tu gasto en la nube en [AWS][2], [Azure][3], [Google Cloud][4], [Oracle][5], [proveedores de SaaS][6] y [costes de Datadog][7]. A diferencia de los informes guardados, Explorer te permite realizar análisis ad hoc con consultas, filtros y visualizaciones flexibles para investigar tendencias de costes, identificar anomalías y responder a preguntas específicas sobre tu gasto en la nube. +Use el Cost Explorer para: +- Cree consultas personalizadas en múltiples proveedores usando etiquetas, servicios y filtros +- Investigue los cambios de costos a lo largo del tiempo con agrupaciones y desgloses flexibles +- Descargue datos, cree widgets de Dashboard o configure monitores de costos -Utiliza el Cost Explorer para: -- Crear consultas personalizadas en varios proveedores utilizando etiquetas, servicios y filtros. -- Investigar las variaciones de los costes a lo largo del tiempo con agrupaciones y desgloses flexibles. -- Descargar datos, crear widgets de dashboards o configurar monitores de costes. +## Consulte sus datos de costos {#query-your-cost-data} -## Consultar datos de tus costes +1. Navegue a [**Cloud Cost > Analyze > Explorer**][1] en Datadog. +2. Cree una consulta de búsqueda usando el editor de consultas o los filtros desplegables: + - Use el menú desplegable {{< ui >}}Provider{{< /ui >}} para seleccionar uno o más proveedores de nube + - Haga clic en {{< ui >}}\+ Filter{{< /ui >}} para agregar filtros para servicios, etiquetas, regiones, equipos y otros atributos + - Escriba directamente en la barra de búsqueda para consultas más avanzadas -1. Ve a [**Cloud Cost > Analyze > Explorer**][1] (Coste en la nube > Analizar > Explorer) en Datadog. -2. Construye una consulta de búsqueda utilizando el editor de consultas o los filtros desplegables: - - Utiliza el menú desplegable **Provider** (Proveedor) para seleccionar uno o varios proveedores de nube - - Haz clic en **+ Filter** (+ Filtro) para añadir filtros por servicios, etiquetas, regiones, equipos y otros atributos. - - Escribe directamente en la barra de búsqueda para consultas más avanzadas + {{< img src="cloud_cost/reporting/reporting-overview-1.png" alt="El generador de consultas de Cloud Cost Explorer que muestra la selección de proveedor, filtros de tipo de costo, búsqueda de etiquetas, filtros de servicio y opciones de agrupación." style="width:100%;" >}} - {{< img src="cloud_cost/reporting/reporting-overview-1.png" alt="El compilador de consultas de Cloud Cost Explorer que muestra la selección del proveedor, los filtros de tipo de coste, la búsqueda de etiquetas, los filtros de servicio y las opciones de agrupamiento" style="width:100%;" >}} - -3. Agrupa tus datos de costes haciendo clic en **Group by** (Agrupar por) y seleccionando dimensiones como: +3. Agrupe sus datos de costos haciendo clic en {{< ui >}}Group by{{< /ui >}} y seleccionando dimensiones como: - Nombre del proveedor - Nombre del servicio - Etiquetas de recursos (como `team`, `env`, `project`) - Región - ID de cuenta -4. Selecciona un intervalo de tiempo mediante el selector de tiempo para analizar los costes en distintos periodos (hora, día, semana, mes o intervalo personalizado). +4. Seleccione un rango de tiempo usando el selector de tiempo para analizar los costos durante diferentes períodos (hora, día, semana, mes o rango personalizado). -**Nota**: Cuando se consultan los costes de varios proveedores, las etiquetas a nivel de recurso no están disponibles. Para acceder a etiquetas específicas de recursos, filtra a un único proveedor en tu consulta. +**Nota**: Al consultar costos entre múltiples proveedores, las etiquetas a nivel de recurso no están disponibles. Para acceder a etiquetas específicas de recursos, filtre por un solo proveedor en su consulta. -## Panel lateral de resumen de cambios de costes +## Panel lateral de Resumen de cambios en los costos {#cost-change-summary-side-panel} -Haz clic en cualquier fila de la tabla en la parte inferior del Explorer para abrir el **panel Resumen de cambios de costes** para ese proveedor, servicio o recurso específico. El panel destaca qué y quién puede estar provocando cambios en los costes del periodo actual en comparación con el periodo anterior. +Haga clic en cualquier fila de la tabla en la parte inferior del Explorador para abrir el {{< ui >}}Cost Change Summary panel{{< /ui >}} para ese proveedor, servicio o recurso específico. El panel destaca qué y quién podría estar impulsando los cambios en los costos para el período actual en comparación con el período anterior. El panel contiene cuatro secciones generales: -- Resumen de cambios en los costes +- Resumen de cambios en los costos - Equipos asociados -- Cambiar detalles -- Seguir investigando - -{{< img src="cloud_cost/reporting/cost-change-sidepanel.png" alt="El panel Resumen de los cambios en los costes destaca qué o quién impulsa los cambios en los costes para el periodo actual frente al periodo anterior." style="width:100%;" >}} +- Detalles del cambio +- Investigue más a fondo -En la parte superior, puedes ver el **coste total** del periodo actual y el cambio de coste en dólares y porcentajes con respecto al periodo anterior (**qué ha pasado**). +{{< img src="cloud_cost/reporting/cost-change-sidepanel.png" alt="El panel de Resumen de cambios en los costos destaca qué y quién podría estar impulsando los cambios en los costos para el período actual en comparación con el período anterior." style="width:100%;" >}} -### Investigar el cambio +En la parte superior, puede ver el **costo total** para el período actual y el cambio de costo en dólares y porcentaje en comparación con el período anterior (**qué sucedió**). -Utiliza las secciones **Cambiar detalles** y **Seguir investigando** para: +### Investigue el cambio {#investigate-the-change} -- **Identificar al instante las anomalías en los costes**: las desviaciones inesperadas en los costes, calculadas con respecto a los datos históricos, se resaltan automáticamente en rojo, lo que te permite centrar tu investigación en las tendencias críticas. +Utilice las secciones {{< ui >}}Change Details{{< /ui >}} y {{< ui >}}Investigate Further{{< /ui >}} para: -- **Análisis de los factores de cambio**: determina fácilmente la causa de un cambio en los costes, es decir, si se debe a un cambio en el **uso** (el recuento de recursos) o a un cambio en el **precio unitario** (el coste por recurso). Por ejemplo, en la siguiente captura de pantalla, el cambio en los gastos se debe a un cambio en el precio unitario más que en el uso: el recuento de recursos se mantiene estable mientras que el coste por recurso aumenta y disminuye, lo que provoca el cambio en el coste global. +- **Identifique anomalías de costos al instante**: Las desviaciones inesperadas en los costos, calculadas con base en datos históricos, se resaltan automáticamente en rojo, lo que le permite centrar su investigación en tendencias críticas. + +- **Analice los impulsores del cambio**: determine fácilmente la causa de un cambio en el costo, ya sea que se deba a un cambio en el **uso** (la cantidad de recursos) o a un cambio en el **precio unitario** (el costo por recurso). Por ejemplo, en la captura de pantalla a continuación, el cambio en el gasto es impulsado por un cambio en el precio unitario en lugar del uso; la cantidad de recursos se mantiene estable mientras que el costo por recurso sube y baja, lo que provoca el cambio general en el costo. -{{< img src="cloud_cost/reporting/cloud-cost-spend-summary.png" alt="El cambio en el gasto es impulsado por un cambio en el precio de unidad en lugar del uso, el recuento de recursos se mantiene estático mientras el costo por recurso aumenta y disminuye, generando que el cambio general del costo cambie" style="width:100%;" >}} +{{< img src="cloud_cost/reporting/cloud-cost-spend-summary.png" alt="El cambio en el gasto es impulsado por un cambio en el precio unitario en lugar del uso; la cantidad de recursos se mantiene estable mientras que el costo por recurso sube y baja, lo que provoca el cambio general en el costo" style="width:100%;" >}} -### Colaborar y monitorizar +### Colabore y haga un seguimiento {#collaborate-and-monitor} -- **Contactar con el equipo responsable**: - - Revisa la sección **Equipo(s) asociado(s)** para identificar qué equipos poseen los recursos que impulsan el cambio de coste (deducido de etiquetas como `team:shopist`). Ponte en contacto con los equipos mencionados (por ejemplo, Shopist, Platform, Cloud-Networks) para conocer el contexto completo del cambio. - - Haz clic en **Send Notebook** (Enviar notebook) para compartir el contexto completo de la investigación de costes directamente con el equipo, permitiéndoles capturar hallazgos, añadir anotaciones y seguir el subproceso de la investigación. +- **Comuníquese con el equipo responsable**: + - Revise la sección {{< ui >}}Associated Team(s){{< /ui >}} para identificar qué equipos poseen los recursos que impulsan el cambio en el costo (inferido a partir de etiquetas como `team:shopist`). Haga un seguimiento con los equipos enumerados (por ejemplo, Shopist, Platform, Cloud-Networks) para obtener el contexto completo del cambio. + - Haga clic en {{< ui >}}Send Notebook{{< /ui >}} para compartir el contexto completo de la investigación de costos directamente con el equipo, permitiéndoles capturar hallazgos, agregar anotaciones y realizar un seguimiento del hilo de la investigación. - **Filtrar por etiquetas**: - - Utiliza **Etiquetas asociadas** para ver todas las etiquetas que contribuyen a la partida de gastos. - - Haz clic en cualquier valor de la etiqueta (como `account:demo` o una `aws_account` específica) para ajustar tu búsqueda y filtrar todo el Explorer para mostrar solo los recursos con esa etiqueta. + - Use {{< ui >}}Associated Tags{{< /ui >}} para ver todas las etiquetas que contribuyen a la partida de costo. + - Haga clic en cualquier valor de etiqueta (como `account:demo` o una `aws_account` específica) para refinar su búsqueda y filtrar todo el Explorador para mostrar solo los recursos con esa etiqueta. -- **Crear un monitor**: - - Configura un monitor de Cloud Cost para recibir una alerta la próxima vez que se produzca un cambio similar. Más información sobre [Monitores de Cloud Cost][8]. +- **Cree un Cloud Cost Monitor**: + - Configure un Cloud Cost Monitor para recibir alertas la próxima vez que ocurra un cambio similar. Obtenga más información sobre [Cloud Cost Monitors][8]. -## Ajustar los resultados +## Refinar sus resultados {#refine-your-results} -Haz clic en **Refine Results** (Ajustar resultados) para acceder a opciones de filtrado avanzadas que te ayudarán a centrarte en patrones de costes específicos. +Haga clic en {{< ui >}}Refine Results{{< /ui >}} para acceder a opciones de filtrado avanzadas que le ayudan a enfocarse en patrones de costos específicos. - {{< img src="cloud_cost/reporting/refine-results.png" alt="El panel Ajustar resultados muestra opciones de filtrado incluido Solo cargos de uso, Solo días completos, Costo total, Cambio de dólar y Cambio de porcentaje" style="width:100%;" >}} + {{< img src="cloud_cost/reporting/refine-results.png" alt="El panel Refinar resultados muestra opciones de filtrado que incluyen Solo cargos por uso, Solo días completos, Costo total, Cambio en dólares y Cambio porcentual" style="width:100%;" >}} -**Sólo días completos** -: excluye los dos últimos días de datos de costes, que pueden estar incompletos. Utiliza esta opción para un análisis histórico preciso. +{{< ui >}}Complete Days Only{{< /ui >}} +: Excluya los últimos dos días de datos de costos, que pueden estar incompletos. Utilice esta opción para un análisis histórico preciso. -**Coste total** -: filtra los datos para ver los costes dentro de un rango específico de dólares (por ejemplo, mostrar solo los recursos que cuestan más de 1000 dólares). +{{< ui >}}Total Cost{{< /ui >}} +: Filtre los datos para visualizar los costos dentro de un rango de dólares específico (por ejemplo, mostrar solo los recursos que cuestan más de $1,000). -**Cambio de dólares** -: muestra solo los cambios de coste dentro de un rango de cambio en dólares especificado (por ejemplo, mostrar los servicios con un aumento de más de 500 dólares). +{{< ui >}}Dollar Change{{< /ui >}} +: Muestre solo los cambios de costos dentro de un rango de cambio de dólares especificado (por ejemplo, mostrar servicios con un aumento de $500+). -**Cambio de porcentaje** -: muestra solo los cambios de coste dentro de un rango porcentual especificado (por ejemplo, mostrar los recursos con un incremento de coste superior al 20 %). +{{< ui >}}Percent Change{{< /ui >}} +: Muestre solo los cambios de costos dentro de un rango de porcentaje especificado (por ejemplo, mostrar recursos con un aumento de costos del 20%+). -## Cambiar las vistas de datos +## Cambie las vistas de datos {#change-data-views} -El Cost Explorer muestra los datos de costes como un gráfico de series temporales con una tabla desglosada. Puedes cambiar la forma en que el gráfico muestra los datos seleccionando una de las siguientes vistas: +El Explorador de costos muestra sus datos de costos como un gráfico de series temporales con un desglose en tabla. Puede cambiar la forma en que el gráfico muestra los datos seleccionando entre las siguientes vistas: -- **Costes ($)**: ver los costes totales en dólares a lo largo del tiempo -- **Tendencias de cambio (%)**: visualiza los cambios en los costes como aumentos o disminuciones porcentuales -- **Tendencias de cambio ($)**: ver las variaciones de costes en dólares +- {{< ui >}}Costs ($){{< /ui >}}: Visualizar los costos totales en dólares a lo largo del tiempo +- {{< ui >}}Change trends (%){{< /ui >}}: Visualizar los cambios de costos como aumentos o disminuciones porcentuales +- {{< ui >}}Change trends ($){{< /ui >}}: Visualizar los cambios de costos en montos en dólares -{{< img src="cloud_cost/reporting/change-view.png" alt="Menú desplegable que muestra tres opciones de vista: Costes en $, Tendencias de cambio en % y Tendencias de cambio en $" style="width:100%;" >}} +{{< img src="cloud_cost/reporting/change-view.png" alt="Menú desplegable que muestra tres opciones de vista: Costos en $, Tendencias de cambio en % y Tendencias de cambio en $" style="width:100%;" >}} -Cambia entre estas vistas para identificar si estás realizando un seguimiento de los costes absolutos o investigando las variaciones de los costes. +Cambie entre estas vistas para identificar si está realizando un seguimiento de los costos absolutos o investigando las variaciones de costos. -### Opciones de visualización de la tabla +### Opciones de visualización de tabla{#table-display-options} -Debajo del gráfico, la tabla muestra los costes desglosados por la agrupación seleccionada (como proveedor, nombre del servicio o etiquetas). Puedes personalizar la forma en que se muestran estos datos. +Debajo del gráfico, la tabla muestra los costos desglosados por la agrupación seleccionada (como proveedor, nombre del servicio o etiquetas). Puede personalizar cómo se muestran estos datos. -{{< img src="cloud_cost/reporting/table-display-options.png" alt="Opciones de visualización de tablas que muestra los modos de vista Resumen y Desglose, conmutadores de visibilidad de columnas y filtro Solo cambios principales" style="width:100%;" >}} +{{< img src="cloud_cost/reporting/table-display-options.png" alt="Opciones de visualización de tabla que muestran los modos de vista Resumen y Desglose, selectores de visibilidad de columnas y el filtro Solo cambios principales" style="width:100%;" >}} -**Modos de visualización** -- **Resumen**: ver los costes agregados en todos los periodos de tiempo para obtener una visión general. -- **Desglose**: ver los costes desglosados por periodo (diario, semanal o mensual, en función del intervalo de tiempo seleccionado). +**Modos de vista** +- {{< ui >}}Summary{{< /ui >}}: Visualizar los costos agregados en todos los períodos de tiempo para obtener una descripción general de alto nivel +- {{< ui >}}Breakdown{{< /ui >}}: Vea los costos desglosados por período de tiempo (diario, semanal o mensual, según el rango de tiempo seleccionado) **Filtros** -- **Solo los cambios más importantes**: activa esta casilla para filtrar la tabla y mostrar solo los recursos o servicios con los mayores aumentos o disminuciones de costes +- {{< ui >}}Top changes only{{< /ui >}}: Marque esta casilla para filtrar la tabla y mostrar solo los recursos o servicios con los mayores aumentos o disminuciones de costos -**Visibilidad de las columnas** +**Visibilidad de columnas** -Muestra u oculta columnas en la tabla para centrarte en las métricas que importan: -- **Total**: costes totales agregados para cada recurso o servicio -- **Tendencias de los cambios en dólares**: evolución de los costes en dólares a lo largo del tiempo -- **Tendencias de los cambios**: evolución porcentual de los costes a lo largo del tiempo +Muestre u oculte columnas en la tabla para enfocarse en las métricas que importan: +- {{< ui >}}Total{{< /ui >}}: Costos totales agregados para cada recurso o servicio +- {{< ui >}}Dollar change trends{{< /ui >}}: Cambios en los costos en montos en dólares a lo largo del tiempo +- {{< ui >}}Change trends{{< /ui >}}: Cambios en los costos basados en porcentajes a lo largo del tiempo -## Exportar y compartir +## Exportar y compartir {#export-and-share} -Tras analizar los costes en el Explorer, puedes: +Después de analizar los costos en el explorador, puede: -### Exportar a csv -Descargar tus datos de costes para analizarlos fuera de línea, elaborar informes o compartirlos con las partes interesadas. Haz clic en el botón **Export** (Exportar) y selecciona **Download as CSV** (Descargar como CSV). +### Exportar a csv {#export-to-csv} +Descargue sus datos de costos para análisis sin conexión, informes o para compartirlos con las partes interesadas. Haga clic en el botón {{< ui >}}Export{{< /ui >}} y seleccione {{< ui >}}Download as CSV{{< /ui >}}. -### Crear un widget de dashboard -Guarda tu consulta actual como un widget de dashboard para monitorizar costes junto con otras métricas: -1. Haz clic en **Export** y selecciona **Export to Dashboard** (Exportar a dashboard). -2. Elige un dashboard existente o crea uno. -3. Personaliza el título y la configuración del widget. +### Cree un widget de Dashboard {#create-a-dashboard-widget} +Guarde su consulta actual como un widget de Dashboard para hacer un seguimiento de los costos junto con otras métricas: +1. Haga clic en {{< ui >}}Export{{< /ui >}} y seleccione {{< ui >}}Export to Dashboard{{< /ui >}}. +2. Elija un dashboard existente o cree uno. +3. Personalice el título y la configuración del widget. -### Crear un monitor de costes -Configura alertas basadas en tu consulta actual para recibir notificaciones cuando los costes superen los umbrales o cambien inesperadamente: -1. Haz clic en **Export** (Exportar) y selecciona **Create Monitor** (Crear monitor). -2. Configura las condiciones de alerta (por ejemplo, cuando los costes superen los 10 000 dólares o aumenten un 20 %). -3. Establece canales de notificación (correo electrónico, Slack, PagerDuty). +### Cree un monitor de costos {#create-a-cost-monitor} +Configure alertas basadas en su consulta actual para recibir notificaciones cuando los costos excedan los umbrales o cambien inesperadamente: +1. Haga clic en {{< ui >}}Export{{< /ui >}} y seleccione {{< ui >}}Create Monitor{{< /ui >}}. +2. Configure las condiciones de alerta (por ejemplo, cuando los costos superen los $10,000 o aumenten un 20%). +3. Establezca los canales de notificación (correo electrónico, Slack, PagerDuty). -Más información sobre [Monitores de Cloud Cost][8]. +Obtenga más información sobre [Cloud Cost Monitors][8]. -### Compartir tu consulta -Copia la URL desde tu navegador para compartir tu consulta de costes actual con los miembros de tu equipo. La URL incluye todos los filtros, agrupaciones y ajustes de intervalo de tiempo. +### Comparta su consulta {#share-your-query} +Copie la URL de su navegador para compartir su consulta de costos actual con los miembros del equipo. La URL incluye todos los filtros, agrupaciones y configuraciones de rango de tiempo. -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/containers/kubernetes/appsec.md b/hugo/content/es/containers/kubernetes/appsec.md new file mode 100644 index 00000000000..e9849f76327 --- /dev/null +++ b/hugo/content/es/containers/kubernetes/appsec.md @@ -0,0 +1,523 @@ +--- +aliases: +- /es/agent/kubernetes/appsec +- /es/security/application_security/setup/kubernetes/appsec-injector +description: Habilite automáticamente App and API Protection para sus ingress proxies + y gateways de Kubernetes +further_reading: +- link: /containers/kubernetes/apm/ + tag: Documentación + text: Recopile las trazas de su aplicación +- link: /containers/kubernetes/log/ + tag: Documentación + text: Recopile los registros de su aplicación +- link: /security/application_security/setup/kubernetes/envoy-gateway + tag: Documentación + text: App and API Protection para Envoy Gateway +- link: /security/application_security/setup/kubernetes/istio + tag: Documentación + text: App and API Protection para Istio +- link: /security/application_security/setup/nginx/ingress-controller + tag: Documentación + text: App and API Protection para ingress-nginx +- link: /security/default_rules/?category=cat-application-security + tag: Documentación + text: Reglas de protección de aplicaciones y API listas para usar +- link: /security/application_security/troubleshooting + tag: Documentación + text: Solución de problemas de protección de aplicaciones y API +site_support_id: containers_kubernetes_appsec +title: App and API Protection para Kubernetes +--- +Esta página describe cómo configurar [App and API Protection][11] para Kubernetes a fin de configurar automáticamente los ingress proxies y gateways de Kubernetes compatibles para ejecutar el descubrimiento de API, la detección de amenazas y el bloqueo en línea en el borde de la infraestructura. + +## Descripción general {#overview} + +App and API Protection para Kubernetes configura automáticamente los ingress proxies y gateways compatibles en su clúster de Kubernetes para habilitar el monitoreo de seguridad de aplicaciones. Esto elimina la necesidad de una configuración manual del proxy y proporciona una cobertura de seguridad para toda la API sin modificar servicios individuales ni implementar rastreadores en toda su flota de aplicaciones. + +### ¿Qué realiza la configuración automática? {#what-performs-the-automatic-configuration} + +App and API Protection para Kubernetes utiliza un controlador de Kubernetes (que se ejecuta en el Datadog Cluster Agent) que: +- **Detecta automáticamente** los proxies compatibles en su clúster +- **Configura los proxies** para enrutar el tráfico a través de un procesador de seguridad de aplicaciones externo +- **Habilita la detección de amenazas** para todo el tráfico que pasa a través de su capa de entrada +- **Simplifica las operaciones** mediante la configuración centralizada con Helm + +### Proxies compatibles {#supported-proxies} + +Para obtener la lista de proxies compatibles y los pasos de configuración específicos para cada proxy, consulte la [página de configuración][10]. + +## Limitaciones {#limitations} + +### Modo sidecar {#sidecar-mode} +- Requiere Datadog Cluster Agent 7.80.2 o posterior +- Cada pod de gateway ejecuta su propia instancia de procesador, lo que aumenta el uso de recursos por pod + +### Modo externo {#external-mode} +- Requiere Datadog Cluster Agent 7.80.2 o posterior +- El procesador de seguridad debe implementarse y escalarse manualmente +- El servicio implementado puede requerir una política de red adecuada: + - Desde los pods de proxy en el puerto de servicio + - Hacia el Datadog Agent para trazas + +### Compatibilidad de proxy {#proxy-compatibility} +- Para conocer la compatibilidad de la versión del proxy, consulte la [documentación de compatibilidad][8]. + +## Requisitos previos {#prerequisites} + +Antes de habilitar App and API Protection para Kubernetes, verifique que tenga: + +- Un clúster de Kubernetes en ejecución (versión 1.20 o posterior) +- [Datadog Cluster Agent 7.80.2 o posterior][1] instalado y configurado en su clúster +- Uno o más [proxies compatibles][10] instalados +- [Remote Configuration][4] habilitado para permitir el bloqueo de atacantes a través de la interfaz de usuario de Datadog + +## Cómo funciona {#how-it-works} + +App and API Protection para Kubernetes admite dos modos de implementación: + +- **Modo sidecar** (predeterminado): El procesador de Application Security se ejecuta como un contenedor sidecar inyectado directamente en cada pod de gateway. No se necesita una implementación de procesador por separado, y el procesador se escala automáticamente con sus pods de gateway. +- **Modo externo**: Una única implementación centralizada del procesador de Application Security sirve a todo el tráfico de gateway en su clúster. Utilice este modo cuando desee administrar un procesador compartido para todo el clúster. + +Para configurar el modo sidecar predeterminado, consulte [Configurar el modo sidecar](#set-up-sidecar-mode). Para implementar un procesador centralizado en su lugar, consulte [Configurar el modo externo](#set-up-external-mode). + +## Configure el modo sidecar {#set-up-sidecar-mode} + +En el modo sidecar, el procesador de seguridad se ejecuta como un contenedor inyectado directamente en cada pod de gateway. El Datadog Cluster Agent maneja la inyección automáticamente, por lo que no necesita una implementación o servicio de procesador independiente. + +### Cuándo usar el modo sidecar {#when-to-use-sidecar-mode} + +- Prefiere no administrar un despliegue y servicio de procesador independiente +- Desea que el procesador esté ubicado junto con cada pod de gateway + +### Configuración {#setup} + +{{< tabs >}} +{{% tab "Helm" %}} + +Agregue lo siguiente a su `values.yaml`. No se necesitan valores `processor.service.*` porque el inyector maneja el despliegue del procesador automáticamente. + +```yaml +datadog: + appsec: + injector: + enabled: true + # mode defaults to "sidecar" when omitted +``` + +Instale o actualice el gráfico de Helm de Datadog (versión 3.153 o posterior): + +```bash +helm upgrade -i datadog-agent datadog/datadog -f values.yaml +``` + +{{% /tab %}} +{{% tab "Datadog Operator" %}} + +Esta opción requiere la versión 1.27.1 o posterior de Datadog Operator. + +Agregue anotaciones a su recurso `DatadogAgent`. El modo sidecar es el predeterminado, por lo que habilitar el inyector es suficiente: + +```yaml +apiVersion: datadoghq.com/v2alpha1 +kind: DatadogAgent +metadata: + name: datadog + annotations: + agent.datadoghq.com/appsec.injector.enabled: "true" +``` + +Aplique la configuración: + +```bash +kubectl apply -f datadog-agent.yaml +``` + +{{% /tab %}} +{{< /tabs >}} + +### Referencia de configuración de sidecar {#sidecar-configuration-reference} + +Todos los parámetros de sidecar están disponibles como valores de Helm anidados bajo `datadog.appsec.injector.sidecar`, o como anotaciones `DatadogAgent` (versión 1.27.1 o posterior de Datadog Operator): + +`sidecar.image` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.image` +: **Tipo**: Cadena +: **Predeterminado**: `ghcr.io/datadog/dd-trace-go/service-extensions-callout` +: **Descripción**: Imagen del contenedor sidecar + +`sidecar.imageTag` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.image_tag` +: **Tipo**: Cadena +: **Predeterminado**: `v2.6.0` +: **Descripción**: Etiqueta de imagen del contenedor sidecar + +`sidecar.port` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.port` +: **Tipo**: Entero +: **Predeterminado**: `8080` +: **Descripción**: Puerto de escucha gRPC para el procesador sidecar + +`sidecar.healthPort` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.health_port` +: **Tipo**: Entero +: **Predeterminado**: `8081` +: **Descripción**: Puerto de verificación de estado para el procesador sidecar + +`sidecar.bodyParsingSizeLimit` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.body_parsing_size_limit` +: **Tipo**: Entero +: **Predeterminado**: `0` +: **Descripción**: Tamaño máximo del cuerpo de la solicitud en bytes a procesar. `0` deshabilita el procesamiento del cuerpo. Use `-1` para deshabilitar el parseo del cuerpo por completo. + +`sidecar.resources.requests.cpu` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.resources.requests.cpu` +: **Tipo**: Cadena +: **Predeterminado**: `10m` +: **Descripción**: Solicitud de CPU para el contenedor sidecar + +`sidecar.resources.requests.memory` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.resources.requests.memory` +: **Tipo**: Cadena +: **Predeterminado**: `128Mi` +: **Descripción**: Solicitud de memoria para el contenedor sidecar + +`sidecar.resources.limits.cpu` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.resources.limits.cpu` +: **Tipo**: Cadena +: **Predeterminado**: `""` +: **Descripción**: Límite de CPU para el contenedor sidecar (opcional) + +`sidecar.resources.limits.memory` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.sidecar.resources.limits.memory` +: **Tipo**: Cadena +: **Predeterminado**: `""` +: **Descripción**: Límite de memoria para el contenedor sidecar (opcional) + +## Configure el modo externo {#set-up-external-mode} + +En el modo externo, usted implementa un procesador de Application Security único y centralizado que atiende todo el tráfico de gateway en su clúster. El Datadog Cluster Agent configura automáticamente sus proxies compatibles para dirigir el tráfico a este procesador. + +### Arquitectura {#architecture} + +- **Despliegue del procesador de Application Security**: Usted implementa un procesador de Application Security centralizado como un despliegue de Kubernetes con un servicio asociado. +- **Detección automática de proxies**: El controlador hace un seguimiento de los recursos de proxies compatibles en su clúster utilizando informers de Kubernetes. +- **Configuración automática**: Cuando se detectan proxies, el controlador crea la configuración de proxy necesaria para dirigir el tráfico al servicio del procesador de seguridad. +- **Procesamiento de tráfico**: Los gateways dirigen el tráfico al procesador de seguridad a través del servicio de Kubernetes para su análisis de seguridad. + +### Beneficios {#benefits} + +- **Eficiente en recursos**: Un único procesador compartido maneja el tráfico de todos los gateways +- **Gestión centralizada**: Una implementación para hacer un seguimiento, escalar y configurar +- **Infraestructura como código**: Gestione la configuración a través de valores de Helm +- **No invasivo**: No se requieren cambios en el código de la aplicación +- **Escalable**: Agregue nuevos gateways sin configuración adicional + +### Paso 1: Implemente el procesador de seguridad {#step-1-deploy-the-security-processor} + +Implemente el servicio del procesador de seguridad, el cual analiza el tráfico reenviado desde sus gateways. Para obtener detalles de implementación específicos del proxy, consulte la [documentación de configuración][10] de su proxy. + +Ejemplo de implementación: + +```yaml +apiVersion: apps/v1 +kind: Deployment +metadata: + name: datadog-aap-extproc-deployment + namespace: datadog +spec: + replicas: 2 + selector: + matchLabels: + app: datadog-aap-extproc + template: + metadata: + labels: + app: datadog-aap-extproc + spec: + containers: + - name: datadog-aap-extproc-container + image: ghcr.io/datadog/dd-trace-go/service-extensions-callout:v2.4.0 + ports: + - name: grpc + containerPort: 443 + - name: health + containerPort: 80 + env: + # Use the address of the datadog agent service in your cluster + - name: DD_AGENT_HOST + value: "datadog-agent.datadog.svc.cluster.local" + + - name: DD_SERVICE_EXTENSION_TLS + value: "false" + readinessProbe: + httpGet: + path: / + port: health + initialDelaySeconds: 5 + periodSeconds: 10 + livenessProbe: + httpGet: + path: / + port: health + initialDelaySeconds: 15 + periodSeconds: 20 +--- +apiVersion: v1 +kind: Service +metadata: + name: datadog-aap-extproc-service + namespace: datadog +spec: + ports: + - name: grpc + port: 443 + targetPort: grpc + selector: + app: datadog-aap-extproc + type: ClusterIP +``` + +Aplique el manifiesto: + +```bash +kubectl apply -f datadog-aap-extproc-service.yaml +``` + +### Paso 2: Habilite la configuración automática {#step-2-enable-automatic-configuration} + +Apunte el Datadog Cluster Agent a su servicio de procesador de seguridad usando Helm o el Datadog Operator. + +**Nota:** El nombre del servicio del procesador (`datadog-aap-extproc-service`) debe coincidir con el servicio que implementó en el Paso 1. + +{{< tabs >}} +{{% tab "Datadog Operator" %}} + +Esta opción requiere la versión 1.27.1 o posterior de Datadog Operator. + +Agregue anotaciones a su recurso `DatadogAgent`. La anotación del nombre del servicio es obligatoria y debe coincidir con su servicio de procesador de seguridad: + +```yaml +apiVersion: datadoghq.com/v2alpha1 +kind: DatadogAgent +metadata: + name: datadog + annotations: + agent.datadoghq.com/appsec.injector.enabled: "true" + agent.datadoghq.com/appsec.injector.mode: "external" + agent.datadoghq.com/appsec.injector.processor.service.name: "datadog-aap-extproc-service" # Required: must match your security processor service name + agent.datadoghq.com/appsec.injector.processor.service.namespace: "datadog" +``` + +Aplique la configuración: + +```bash +kubectl apply -f datadog-agent.yaml +``` + +{{% /tab %}} +{{% tab "Helm" %}} + +Configure App and API Protection para Kubernetes usando valores de Helm. Agregue lo siguiente a su `values.yaml`: + +```yaml +datadog: + appsec: + injector: + enabled: true + mode: "external" + processor: + service: + name: datadog-aap-extproc-service # Required: must match your security processor service name + namespace: datadog # Must match the namespace where the service is deployed +``` + +Instale o actualice el gráfico de Helm de Datadog (versión 3.153 o posterior): + +```bash +helm upgrade -i datadog-agent datadog/datadog -f values.yaml +``` + +{{% /tab %}} +{{< /tabs >}} + +### Paso 3: Verifique la instalación {#step-3-verify-the-installation} + +Verifique que el Cluster Agent haya detectado sus proxies: + +```bash +kubectl logs -n datadog deployment/datadog-cluster-agent | grep appsec +``` + +#### Verifique la configuración de proxy {#verify-proxy-configuration} + +Verifique que el controlador haya creado los recursos de configuración de proxy para su proxy. Para comandos de verificación específicos del proxy, consulte la [documentación de configuración][10] de su proxy. + +El Datadog Cluster Agent genera eventos para cada operación que resulta en fallo o éxito realizada en el clúster. + +#### Pruebe el procesamiento de tráfico {#test-traffic-processing} + +Envíe solicitudes a través de su puerta de enlace y verifique que aparezcan en la interfaz de usuario de [App and API Protection][5] de Datadog: + +1. Navegue a [Security > Application Security][5] en Datadog. +2. Busque señales de seguridad del tráfico de su puerta de enlace. +3. Verifique que la detección de amenazas esté activa. + +## Referencia de configuración {#configuration-reference} + +### Opciones de configuración automática {#automatic-configuration-options} + +`enabled` +: **Anotación del Datadog Operator**: `agent.datadoghq.com/appsec.injector.enabled` +: **Tipo**: Booleano +: **Predeterminado**: `false` +: **Descripción**: Habilitar o deshabilitar la integración + +`mode` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.injector.mode` +: **Tipo**: Cadena +: **Predeterminado**: `""`; cuando está vacío, el valor predeterminado es sidecar +: **Descripción**: Modo de inyección: `"sidecar"` o `"external"` + +`autoDetect` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.injector.autoDetect` +: **Tipo**: Booleano +: **Predeterminado**: `true` +: **Descripción**: Detectar y configurar automáticamente los proxies admitidos + +`proxies` +: **Anotación del Datadog Operator**: `agent.datadoghq.com/appsec.injector.proxies` +: **Tipo**: Matriz JSON +: **Predeterminado**: `[]` +: **Descripción**: Lista manual de tipos de proxy a configurar. Para obtener valores válidos, consulte la [página de configuración][10]. + +`processor.service.name` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.injector.processor.service.name` +: **Tipo**: Cadena +: **Predeterminado**: Ninguno +: **Descripción**: **Requerido.** Nombre del servicio de seguridad de Kubernetes + +`processor.service.namespace` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.injector.processor.service.namespace` +: **Tipo**: Cadena +: **Predeterminado**: De forma predeterminada, el espacio de nombres es aquel donde se ejecuta el Cluster Agent +: **Descripción**: Espacio de nombres donde se despliega el servicio del procesador de seguridad + +`processor.address` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.injector.processor.address` +: **Tipo**: Cadena +: **Predeterminado**: `{service.name}.{service.namespace}.svc` +: **Descripción**: Anulación de la dirección completa del servicio + +`processor.port` +: **Anotación de Datadog Operator**: `agent.datadoghq.com/appsec.injector.processor.port` +: **Tipo**: Entero +: **Predeterminado**: `443` +: **Descripción**: Puerto del servicio del procesador de seguridad + +### Actualización desde el modo externo {#upgrading-from-external-mode} + +Si está actualizando desde una versión anterior que utilizaba el modo externo, el modo predeterminado ha cambiado a sidecar. Para seguir usando el modo externo, configure explícitamente `mode: "external"` en sus valores de Helm: + +```yaml +datadog: + appsec: + injector: + enabled: true + mode: "external" + processor: + service: + name: datadog-aap-extproc-service + namespace: datadog +``` + +### Exclusión de recursos específicos {#opting-out-specific-resources} + +Puede excluir recursos específicos de Gateway o GatewayClass de la configuración automática agregando una etiqueta: + +```yaml +apiVersion: gateway.networking.k8s.io/v1 +kind: Gateway +metadata: + name: my-gateway + namespace: my-namespace + labels: + appsec.datadoghq.com/enabled: "false" # Exclude this gateway from automatic configuration +spec: + # ... gateway configuration +``` + +Los recursos con la etiqueta `appsec.datadoghq.com/enabled: "false"` son ignorados. Esto es útil cuando desea: +- Configurar manualmente gateways específicos +- Deshabilitar temporalmente la protección de aplicaciones y API para realizar pruebas +- Excluir ciertos gateways del monitoreo de seguridad + +**Nota**: De forma predeterminada, todos los recursos están incluidos. Solo se excluyen los recursos con la etiqueta establecida explícitamente en `"false"`. + +## Solución de problemas {#troubleshooting} + +Todos los errores se registran como eventos de Kubernetes. Busque eventos en el Gateway o GatewayClass que desea instrumentar. + +### La configuración automática no detecta proxies {#automatic-configuration-not-detecting-proxies} + +**Síntoma**: No se crean recursos de configuración de proxy. + +**Soluciones**: +- Verifique que `autoDetect` esté configurado en `true` o que los proxies estén especificados manualmente +- Verifique los registros del Cluster Agent para ver mensajes de detección de proxy +- Verifique que sus proxies estén instalados y tengan los recursos de Kubernetes esperados (Gateway, GatewayClass) +- Intente especificar manualmente los tipos de proxy usando el parámetro `proxies` + +### Configuración de proxy no creada {#proxy-configuration-not-created} + +**Síntoma**: El controlador está en ejecución pero faltan recursos de configuración. + +**Soluciones**: +- Verifique los registros del Agente de clúster en busca de errores de permisos RBAC +- Verifique que la cuenta de servicio del Agente de clúster tenga permisos para crear los recursos de configuración de proxy +- Verifique que el servicio del procesador exista y sea accesible +- Verifique si existen políticas o filtros conflictivos + +### Tráfico no procesado {#traffic-not-being-processed} + +**Síntoma**: No aparecen eventos de seguridad en la interfaz de usuario de Datadog. + +**Soluciones**: +- Verifique que la implementación del procesador de seguridad esté en ejecución: `kubectl get pods -n datadog -l app=datadog-aap-extproc` +- Busque registros de advertencia en sus proxies inversos relacionados con esta parte de la configuración. +- Verifique los registros del procesador en busca de errores de conexión: `kubectl logs -n datadog -l app=datadog-aap-extproc` +- Verifique que el servicio del procesador esté configurado correctamente y sea resoluble +- Pruebe la conectividad desde los pods de puerta de enlace al servicio del procesador +- Verifique que [Remote Configuration][4] esté habilitado en su Datadog Agent + +### Problemas de conexión del procesador de seguridad {#security-processor-connection-issues} + +**Síntoma**: Las puertas de enlace no pueden comunicarse con el procesador de seguridad. + +**Soluciones**: +- Verifique que el nombre del servicio del procesador y el espacio de nombres coincidan con su configuración +- Verifique si hay reglas de NetworkPolicy que bloqueen el tráfico entre espacios de nombres +- Pruebe la resolución de DNS desde los pods de gateway: `nslookup datadog-aap-extproc-service.datadog.svc.cluster.local` +- Verifique que la configuración del puerto del procesador coincida con la definición del servicio + +### Errores de permisos de RBAC {#rbac-permission-errors} + +**Síntoma**: Los registros del Agente de clúster muestran errores de permiso denegado. + +**Soluciones**: +- Verifique que el clúster Agent ClusterRole incluya permisos para: + - `gateway.networking.k8s.io/gateways` + - `gateway.networking.k8s.io/gatewayclasses` +- Verifique que el ClusterRoleBinding haga referencia a la cuenta de servicio correcta +- Asegúrese de estar utilizando la versión más reciente del Helm Chart o del Operador de Datadog. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/containers/kubernetes/installation/ +[4]: /es/agent/remote_config/?tab=helm#enabling-remote-configuration +[5]: https://app.datadoghq.com/security/appsec +[8]: /es/security/application_security/setup/compatibility/ +[10]: /es/security/application_security/setup/kubernetes/ +[11]: /es/security/application_security/ \ No newline at end of file diff --git a/hugo/content/es/continuous_integration/explorer/facets.md b/hugo/content/es/continuous_integration/explorer/facets.md index 4f2642e4d83..1cf211a09fb 100644 --- a/hugo/content/es/continuous_integration/explorer/facets.md +++ b/hugo/content/es/continuous_integration/explorer/facets.md @@ -1,154 +1,153 @@ --- -description: Conoce las facetas predeterminadas que puedes utilizar para buscar ejecuciones - de tus pipelines en el Explorador de CI Visibility. +description: Obtenga información sobre las facetas predeterminadas que puede usar + para buscar las ejecuciones de su pipeline en el CI Visibility Explorer. further_reading: - link: continuous_integration/search/ tag: Documentación - text: Más información sobre cómo buscar tus pipelines + text: Aprenda a buscar sus pipelines - link: continuous_integration/explorer/ tag: Documentación - text: Más información sobre el Explorador de CI Visibility -title: Facetas de ejecución de pipelines + text: Obtenga información sobre el CI Visibility Explorer +title: Facetas de ejecución de pipeline --- +## Descripción general {#overview} -## Información general +Las facetas son etiquetas y atributos definidos por el usuario de sus pipelines. Son útiles tanto para el análisis de datos [cualitativos](#qualitative-facets) como [cuantitativos](#quantitative-measures). Las facetas le permiten manipular sus pipelines en sus [monitores de pipeline de CI][1], y en consultas de búsqueda que aparecen en [paneles][2] y en [cuadernos][3]. -Las facetas son atributos y etiquetas (tags) definidos por el usuario a partir de tus pipelines. Son útiles para el análisis de datos [cualitativos](#qualitative-facets) y también [cuantitativos](#quantitative-measures). Las facetas te permiten manipular tus pipelines en tus [monitores de pipelines CI][1] y en las consultas de búsqueda que aparecen en [dashboards][2] y en [notebooks][3]. +[Crear facetas](#creating-facets) **no es necesario** para [buscar ejecuciones de pipeline][5]. Las capacidades de autocompletado usan facetas existentes, pero también se aplica cualquier entrada que coincida con las ejecuciones de pipeline entrantes. -No es **necesario** [crear facetas](#creating-facets) para [buscar ejecuciones de pipelines][5]. Las funciones de autocompletar utilizan facetas existentes, pero también se utiliza cualquier entrada que coincida con las ejecuciones de pipelines entrantes. +## Facetas comunes {#common-facets} -## Facetas frecuentes +Navegue a [**Software Delivery** > **CI Visibility** > **Ejecuciones**][7] para acceder a la lista de facetas a la izquierda de la lista de ejecuciones de pipeline. -Ve a [**Software Delivery** > **CI Visibility** > **Executions** (Entrega de software > CI Visibility > Ejecuciones)][7] para acceder a la lista de facetas a la izquierda de la lista de ejecuciones de pipelines. +{{< img src="/continuous_integration/facets-pipelines.png" text="Facets list on the Pipeline Executions page of the CI Visibility Explorer" style="width:100%" >}} -{{< img src="/continuous_integration/facets-pipelines.png" text="Lista de facetas en la página Ejecuciones de pipelines del Explorador de CI Visibility" style="width:100%" >}} - -El [Explorador de CI Visibility][4] incluye las siguientes facetas predefinidas: +El [Explorador CI Visibility][4] incluye las siguientes facetas listas para usar: | Faceta | Descripción | |---|---| -| Proveedor de CI | Nombre del proveedor de CI (GitHub, GitLab, etc.). | -| Nombre del pipeline | Nombre del pipeline CI. | -| Nombre del nodo | Nombre del nodo CI que ejecutó el pipeline, la etapa o el trabajo. | -| Etiquetas (labels) del nodo | Etiquetas (labels) asociadas con el nodo CI que ejecutó el pipeline, la etapa o el trabajo. | -| URL del pipeline | URL del proveedor para la ejecución de un pipeline. | +| Proveedor de CI | Nombre del proveedor de CI (GitHub, GitLab y más). | +| Nombre del pipeline | Nombre del pipeline de CI. | +| Nombre del nodo | Nombre del nodo de CI que ejecutó el pipeline, la etapa o el trabajo. | +| Etiquetas del nodo | Etiquetas asociadas con el nodo de CI que ejecutó el pipeline, la etapa o el trabajo. | +| URL del pipeline | URL del proveedor para una ejecución de pipeline. | | ID del pipeline | ID del pipeline. | -| Número del pipeline | Número de ejecución de un pipeline CI, proporcionado por el proveedor de CI. Aumenta cuando se reintenta parcialmente un pipeline. | -| URL del trabajo | URL del proveedor para la ejecución de un trabajo. | -| Nombre de la etapa | Nombre de la etapa CI. | -| Nombre del trabajo | Nombre del trabajo CI. | -| Espacio de nombres Kubernetes | Espacio de nombres Kubernetes en que se ejecuta el pod Kubernetes. | -| Nombre del pod Kubernetes | Nombre del pod Kubernetes. | -| Etiqueta (tag) de imagen | Etiqueta (tag) de la imagen del contenedor Kubernetes. | -| Nombre del contenedor | Etiqueta (tag) del nombre del contenedor Kubernetes. | -| Nombre de la imagen | Etiqueta (tag) del nombre de la imagen del contenedor Kubernetes. | -| ID del contenedor | ID del contenedor Kubernetes. | -| Nombre del contenedor Kubernetes | Nombre del contenedor Kubernetes. | -| Despliegue de Kubernetes | Despliegue de Kubernetes al que pertenece un pod. | -| StatefulSet Kubernetes | StatefulSet Kubernetes al que pertenece un pod. | +| Número de pipeline | Número de ejecución de un pipeline de CI, proporcionado por el proveedor de CI. Esto aumenta al reintentar parcialmente un pipeline. | +| URL del trabajo | URL del proveedor para una ejecución de trabajo. | +| Nombre de la etapa | Nombre de la etapa de CI. | +| Nombre del trabajo | Nombre del trabajo de CI. | +| Espacio de nombres de Kubernetes | El espacio de nombres en el que se está ejecutando el Pod de Kubernetes. | +| Nombre del Pod de Kubernetes | Nombre del Pod de Kubernetes. | +| Etiqueta de imagen | Etiqueta de imagen de contenedor de Kubernetes. | +| Nombre del contenedor | Etiqueta de nombre de contenedor de Kubernetes. | +| Nombre de la imagen | Etiqueta de nombre de imagen de contenedor de Kubernetes. | +| ID de contenedor | ID de contenedor de Kubernetes. | +| Nombre del contenedor de Kubernetes | Nombre del contenedor de Kubernetes. | +| Despliegue de Kubernetes | El despliegue de Kubernetes al que pertenece un pod. | +| StatefulSet de Kubernetes | El StatefulSet de Kubernetes al que pertenece un pod. | | URL del repositorio | URL del repositorio Git. | | ID del repositorio | ID que identifica de forma única un repositorio Git. | -| SHA de confirmación | SHA de confirmación Git. | -| Rama | Rama Git. | -| Etiqueta (Tag) | Etiqueta (tag) Git. | +| SHA de confirmación | SHA de confirmación de Git. | +| Rama | Rama de Git. | +| Etiqueta | Etiqueta de Git. | | Correo electrónico del autor | Correo electrónico del autor de Git. | -| Correo electrónico de quien confirma | Correo electrónico de quien confirma Git. | -| Fecha de quien confirma | Fecha de quien confirma Git. | -| Fecha del autor | Fecha del autor Git. | -| Entorno | Entorno en el que se está ejecutando el pipeline CI. | -| Recurso | Recurso utilizado por el pipeline CI.. | -| Nombre de la operación | Operación realizada en el pipeline CI. | +| Committer Email | Correo electrónico del Committer de Git. | +| Fecha del Committer | Fecha del Committer de Git. | +| Fecha de autor | Fecha de autor de Git. | +| Entorno | El entorno en el que se ejecuta el pipeline de CI. | +| Recurso | El recurso utilizado por el pipeline de CI. | +| Nombre de la operación | La operación realizada dentro del pipeline de CI. | | Tipo de error | Tipo de error encontrado durante la ejecución de CI. | -| Tipo | Tipo de ejecución o entidad CI. | -| Traza (trace) completa | Traza completa de la ejecución del pipeline CI. | -| Duración | Duración de la ejecución en segundos. | -| Versión | Versión del pipeline o la herramienta CI utilizados. | -| Es la rama por defecto | Indica si la ejecución se realizó en la rama por defecto del repositorio Git. | +| Tipo | Tipo de la ejecución o entidad de CI. | +| Traza completa | Traza completa de la ejecución del pipeline de CI. | +| Duración | La duración de la ejecución en segundos. | +| Versión | Versión del pipeline de CI o herramienta utilizada. | +| Es rama predeterminada | Indica si la ejecución se realizó en la rama predeterminada del repositorio de Git. | -En el Explorador de CI Visibility, puedes utilizar facetas para: +Puede usar facetas en el Explorador de CI Visibility para: -- [Buscar y filtrar ejecuciones de pipelines][5]. -- Realizar análisis de pipelines. -- Empezar a solucionar problemas una vez completados tus pipelines. +- [Buscar y filtrar ejecuciones de pipeline][5] +- Realice análisis de pipeline +- Comience la resolución de problemas una vez que sus pipelines se completen -### Facetas cualitativas +### Facetas cualitativas {#qualitative-facets} -Utiliza facetas cualitativas cuando necesites: +Utilice facetas cualitativas cuando necesite: -- **Obtener información relativa** de los valores. -- **Contar valores únicos**. -- **Filtrar** con frecuencia las ejecuciones de tus pipelines según determinados valores. Por ejemplo, crea una faceta en una etiqueta (tag) de entorno para delimitar la resolución de problemas a entornos de desarrollo, staging o producción.
+- **Obtenga información relativa** para los valores. +- **Cuente valores únicos**. +- Filtre**frecuentemente** sus ejecuciones de pipeline según valores particulares. Por ejemplo, cree una faceta en una etiqueta de entorno para contextualizar la resolución de problemas a entornos de desarrollo, staging o producción.
-**Nota:** Aunque las facetas no son necesarias para filtrar las etiquetas (tags), definir facetas para las etiquetas (tags) que utilizas a menudo durante las investigaciones te ayudará a reducir el tiempo de resolución. +**Nota:** Aunque las facetas no son necesarias para filtrar por etiquetas, definir facetas para las etiquetas que usa a menudo durante las investigaciones puede ayudar a reducir su tiempo de resolución. -### Medidas cuantitativas +### Medidas cuantitativas {#quantitative-measures} -Utiliza medidas cuantitativas cuando necesites: +Utilice medidas cuantitativas cuando necesite: -- **Agregar** valores de varias ejecuciones de pipelines. -- **Filtrar por rangos** tus ejecuciones de pipelines. -- **Ordenar** tus ejecuciones de pipelines según ese valor. +- **Agregue** valores de múltiples ejecuciones de pipeline. +- **Filtre por rango** sus ejecuciones de pipeline. +- **Ordene** sus ejecuciones de pipeline según ese valor. -#### Tipos +#### Tipos {#types} -Las medidas tienen un valor entero largo o doble para capacidades equivalentes. +Las medidas tienen un valor de entero largo o doble para capacidades equivalentes. -#### Unidades +#### Unidades {#units} -Las medidas admiten unidades (**tiempo** en segundos o **tamaño** en bytes) para controlar órdenes de magnitud en tiempo de consulta y visualización. La unidad es una propiedad de la propia medida, no del campo. +Las medidas admiten unidades (**tiempo** en segundos o **tamaño** en bytes) para el manejo de órdenes de magnitud al momento de la consulta y de la visualización. La unidad es una propiedad de la medida en sí, no del campo. -Por ejemplo, considera una medida de `duration` en nanosegundos. Supongamos que las ejecuciones de pipelines de `service:A` tienen `duration:10000000`, es decir `10 milliseconds`. Supongamos que las ejecuciones de pipelines de `service:B` tienen `duration:5000000`, es decir `5 milliseconds`. Utiliza `duration:>2ms` para consultar de forma consistente etiquetas (tags) de ejecución de pipelines de ambos servicios a la vez. Para obtener más información sobre las consultas de búsqueda, consulta la [sintaxis de búsqueda][6]. +Por ejemplo, considere una `duration` medida en nanosegundos. Suponga que las ejecuciones de pipeline de `service:A` tienen `duration:10000000`, lo que significa `10 milliseconds`. Suponga que las ejecuciones de pipeline de `service:B` tienen `duration:5000000`, lo que significa `5 milliseconds`. Utilice `duration:>2ms` para consultar de manera consistente las etiquetas de ejecución de pipeline de ambos servicios a la vez. Para obtener más información sobre las consultas de búsqueda, consulte [Sintaxis de búsqueda][6]. -## Panel de facetas +## Panel de facetas {#facet-panel} -El buscador ofrece el conjunto más completo de interacciones para filtrar y agrupar tus datos. Sin embargo, en muchos casos, el panel de facetas es una forma sencilla de navegar por tus datos. Abre una faceta para ver un resumen de su contenido en el contexto de la consulta actual. +La barra de búsqueda proporciona el conjunto de interacciones más completo para filtrar y agrupar sus datos. Sin embargo, para muchos casos, el panel de facetas es una forma sencilla de navegar por sus datos. Abra una faceta para ver un resumen de su contenido para el contexto de la consulta actual. -El buscador y la URL reflejan automáticamente las opciones seleccionadas del panel de facetas. +La barra de búsqueda y la URL reflejan automáticamente sus selecciones del panel de facetas. -- Las **facetas (cualitativas)** vienen con una lista de los principales valores únicos y un recuento de ejecuciones de pipelines que coinciden con cada uno de ellos. -- Las **medidas (cuantitativas)** incluyen un regulador que indica los valores mínimo y máximo. Utiliza este regulador o indica valores numéricos para ampliar el contexto de la consulta a diferentes límites. +- **Las facetas (cualitativas)** vienen con una lista principal de valores únicos y un conteo de ejecuciones de pipeline que coinciden con cada uno de ellos. +- **Las medidas (cuantitativas)** vienen con un control deslizante que indica los valores mínimos y máximos. Utilice el control deslizante, o ingrese valores numéricos, para definir el contexto de la consulta de búsqueda en diferentes rangos. -### Agrupar facetas +### Agrupación de facetas{#grouping-facets} -Las facetas se agrupan por temas significativos en la lista de facetas. Asignar o reasignar un grupo a una faceta solo afecta a la lista de facetas y no repercute en la búsqueda ni en los análisis. +Las facetas se agrupan en temas significativos en la lista de facetas. Asignar o reasignar un grupo para una faceta afecta solo a la lista de facetas y no tiene impacto en la búsqueda o el análisis. -### Filtrar facetas +### Filtrado de facetas{#filtering-facets} -Utiliza el cuadro de facetas de búsqueda del panel de facetas para ver toda la lista de facetas e ir a la faceta con la que necesitas interactuar. Para delimitar los resultados, las facetas de búsqueda utilizan el nombre de visualización de la faceta y el nombre del campo. +Utilice el cuadro de búsqueda de facetas en el panel de facetas para definir el contexto de toda la lista de facetas y navegar hasta la faceta con la que necesita interactuar. La búsqueda de facetas utiliza el nombre de visualización de la faceta y el nombre del campo para definir el contexto de los resultados. -## Crear facetas +## Creación de facetas{#creating-facets} -La creación de una faceta en un atributo o una etiqueta (tag) de ejecución de pipeline no es un paso obligatorio para buscar ejecuciones de pipelines. Las facetas son útiles si quieres añadir una descripción significativa a un atributo de ejecución de pipeline específico o si quieres que los valores del atributo aparezcan en la lista de facetas. +Crear una faceta en un atributo o etiqueta de ejecución de pipeline no es un paso obligatorio para buscar ejecuciones de pipeline. Las facetas son útiles si desea agregar una descripción significativa a un atributo de ejecución de pipeline específico, o si desea que los valores de los atributos aparezcan en la lista de Facetas. -### Creación de facetas desde el panel lateral de ejecuciones de pipelines +### Creación de facetas desde los paneles laterales de Ejecuciones de Pipeline{#creating-facets-from-the-pipeline-executions-side-panels} -La forma más sencilla de crear una faceta es añadirla desde el panel lateral de ejecuciones de pipelines, de modo que la mayoría de los detalles de la faceta ya estén rellenados. +La forma más sencilla de crear una faceta es agregarla desde el panel lateral de Ejecuciones de Pipeline para que la mayoría de los detalles de la faceta estén prellenados. -{{< img src="continuous_integration/create_facet.png" alt="Crear una faceta desde el panel lateral de ejecuciones de pipelines CI" style="width:100%;">}} +{{< img src="continuous_integration/create_facet.png" alt="Cree una faceta desde el panel lateral de ejecución de pipeline de CI" style="width:100%;">}} -1. Ve a una ejecución de pipeline de interés en el [Explorador de CI Visibility][4], que contenga el campo sobre el cual crear una faceta. -2. Abre el panel lateral de ejecuciones de pipelines seleccionando la ejecución de pipeline en la lista. -3. Haz clic en el campo deseado (en la pestaña **Información** de un tramo (span) de una ejecución de pipeline) y crea una faceta a partir de allí: +1. Navegue a una ejecución de pipeline de interés en el [CI Visibility Explorer][4] que contenga el campo sobre el cual crear una faceta. +2. Abra el panel lateral de Ejecuciones de Pipeline seleccionando la ejecución de pipeline de la lista. +3. Haga clic en el campo deseado (en la pestaña **Info** para el tramo de una ejecución de pipeline) y cree una faceta desde allí: - - Si el campo contiene un valor numérico, puedes crear una faceta o una medida. - - Si el campo contiene un valor de cadena, solo está disponible la creación de facetas. + - Si el campo tiene un valor numérico, puede crear una faceta o una medida. + - Si el campo tiene un valor de cadena, solo está disponible la creación de facetas. -### Crear facetas a partir de la lista de facetas +### Creación de facetas desde la lista de facetas {#creating-facets-from-the-facet-list} -Si no encuentras una ejecución de pipeline que contenga el campo deseado, crea una faceta directamente desde el panel de facetas haciendo clic en **+ Add** (+ Añadir). +Si no es una opción encontrar una ejecución de pipeline que tenga el campo deseado, cree una faceta directamente desde el panel de facetas haciendo clic en {{< ui >}}\+ Add{{< /ui >}}. -{{< img src="continuous_integration/add_facet.png" alt="Añadir una faceta desde el panel lateral de facetas" style="width:30%;">}} +{{< img src="continuous_integration/add_facet.png" alt="Agregue una faceta desde el panel lateral de facetas" style="width:30%;">}} -Define el nombre del campo subyacente (clave) de esta faceta: +Defina el nombre del campo subyacente (clave) para esta faceta: -- Utiliza el nombre de la clave de etiqueta (tag) para las etiquetas (tags) de infraestructura. -- Utiliza la ruta de atributos para atributos de ejecución de pipelines con el prefijo `@`. +- Use el nombre de la clave de etiqueta para las etiquetas de infraestructura. +- Use la ruta del atributo para los atributos de ejecución de pipeline, con el prefijo `@`. -La opción autocompletar basada en el contenido de las ejecuciones de pipelines de las vistas actuales te ayuda a definir el nombre de campo adecuado. Sin embargo, puedes utilizar prácticamente cualquier valor, específicamente en el caso de que Datadog aún no haya recibido ejecuciones de pipelines coincidentes. +El autocompletado basado en el contenido de las ejecuciones de pipeline de las vistas actuales le ayuda a definir el nombre de campo adecuado. Pero puede usar prácticamente cualquier valor aquí, específicamente en el caso de que aún no tenga ejecuciones de pipeline coincidentes recibidas por Datadog. -## Leer más +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/dashboards/widgets/table.md b/hugo/content/es/dashboards/widgets/table.md index fa72c57821b..e58926c7e22 100644 --- a/hugo/content/es/dashboards/widgets/table.md +++ b/hugo/content/es/dashboards/widgets/table.md @@ -1,69 +1,71 @@ --- aliases: - /es/graphing/widgets/table/ -description: Visualiza datos tabulares con columnas, filas y funciones de clasificación +description: Muestre datos tabulares con columnas, filas y capacidades de ordenamiento para un análisis detallado de métricas y eventos. further_reading: - link: /dashboards/graphing_json/ tag: Documentación - text: Creación de dashboards con JSON + text: Creación de tableros mediante JSON - link: /dashboards/querying/ tag: Documentación - text: Aprenda a crear una consulta para crear gráficas + text: Aprenda a crear una consulta de gráficos +- link: https://learn.datadoghq.com/courses/discovering-table-list-widgets + tag: Centro de aprendizaje + text: Descubrimiento de widgets de Table, listar, SLO y Architecture title: Widget de tabla widget_type: query_table --- +## Descripción general {#overview} -## Información general - -La visualización de tablas muestra columnas de datos agregados agrupados por clave de etiqueta (tag). Utiliza las tablas para comparar valores entre muchos grupos de datos y ver tendencias, cambios y outliers. +La visualización de tabla muestra columnas de datos agregados agrupados por clave de etiqueta. Use tablas para comparar valores entre muchos grupos de datos y ver tendencias, cambios y valores atípicos. {{< img src="/dashboards/widgets/table/table_conditional_formatting.png" alt="Widget de tabla con formato condicional" style="width:100%;">}} -## Configuración +## Configuración {#setup} -### Configuración +### Configuración {#configuration} -1. Elige los datos para los que crear gráficas: - * Métrica: consulta la [Documentación principal de crear gráficas][1] para configurar una consulta a la métrica. - * Fuentes de datos no métrica: consulta la [Documentación de búsqueda de log][2] para configurar una consulta de evento. +1. Elija los datos para graficar: + * Métrica: Consulte la [documentación principal de gráficos][1] para configurar una consulta de métrica. + * Fuentes de datos no métricas: Consulte la [documentación de búsqueda de registros][2] para configurar una consulta de evento. -2. Añade columnas adicionales a la tabla utilizando los botones **+ Add Query** (+ Añadir consulta) y **+ Add Formula** (+ Añadir fórmula). +2. Agregue columnas adicionales a la tabla usando los botones {{< ui >}}\+ Add Query{{< /ui >}} y {{< ui >}}\+ Add Formula{{< /ui >}}. -### Opciones +### Opciones {#options} -* Cambia el nombre de los encabezados de columna al establecer alias, haz clic en el botón **as...** (como...). -* Configura si se muestra o no la barra de búsqueda. **Auto** es el valor predeterminado y muestra la barra de búsqueda según el tamaño del widget, esto significa que si tu pantalla se hace demasiado pequeña, prioriza la visualización de los datos en el widget y oculta la barra de búsqueda, pero sigue estando disponible en el modo de pantalla completa. +* Cambie el nombre de los encabezados de columna estableciendo alias, haga clic en el botón {{< ui >}}as...{{< /ui >}}. +* Configure si se muestra o no la barra de búsqueda. {{< ui >}}Auto{{< /ui >}} es el valor predeterminado y muestra la barra de búsqueda dependiendo del tamaño del widget; esto significa que si su pantalla se vuelve demasiado pequeña, prioriza mostrar los datos en el widget y oculta la barra de búsqueda, pero sigue estando disponible en modo de pantalla completa. -#### Formato de columnas +#### Formato de columna {#column-formatting} -Personaliza la visualización de los valores de las celdas de cada columna con las Reglas de formato de columna. Crea códigos de color para tus datos para visualizar tendencias y cambios. -* Formato de umbral: resalta las celdas con colores cuando se cumplan determinados rangos de valores. -* Formato de rango: codifica por colores las celdas con un rango de valores. -* Formato de texto: sustituye las celdas por valores de texto de alias para mejorar la legibilidad. -* Información de tendencias: visualiza las consultas de métricas y eventos. +Personalice la visualización de los valores de las celdas para cada columna con Reglas de formato de columna. Cree códigos de color para sus datos a fin de visualizar tendencias y cambios. +* Formato de umbral: resalte las celdas con colores cuando se cumplan rangos de valores específicos. +* Formato de rango: codifique con colores las celdas con un rango de valores. +* Formato de texto: reemplace las celdas con valores de texto de alias para mejorar la legibilidad. +* Información de tendencias: visualice consultas de métricas y eventos. -{{< img src="/dashboards/widgets/table/conditional_formatting_trends.png" alt="Widget de tabla que muestra el formato condicional con indicadores de tendencia" style="width:100%;" >}} +{{< img src="/dashboards/widgets/table/conditional_formatting_trends.png" alt="Widget de tabla que muestra formato condicional con indicadores de tendencia" style="width:100%;" >}} -#### Enlaces contextuales +#### Enlaces de contexto {#context-links} -Los [enlaces contextuales][10] están activados por defecto y pueden activarse o desactivarse. Los enlaces contextuales sirven de puente entre widgets de dashboard con otras páginas de Datadog, o con aplicaciones de terceros. +Los [enlaces de contexto][10] están habilitados de forma predeterminada y se pueden activar o desactivar. Los enlaces de contexto conectan los widgets del dashboard con otras páginas en Datadog o aplicaciones de terceros. -## Valores N/A +## Valores N/A {#na-values} -Las columnas del widget de tabla se consultan independientemente unas de otras. Los grupos solapados con nombres coincidentes se unen en tiempo real para formar las filas de la tabla. Como resultado de dicho proceso, puede haber situaciones sin solapamiento total, por lo que se muestran celdas N/A. Para mitigar esto: - * Amplía el límite de consultas a números más altos, para maximizar el solapamiento entre columnas. - * Ordena las tablas según la columna que consideres que "impulsa" la información. +Las columnas en el widget de tabla se consultan independientemente unas de otras. Los grupos superpuestos con nombres coincidentes se unen en tiempo real para formar las filas de la tabla. Como resultado de ese proceso, puede haber situaciones sin superposición total, lo que muestra celdas N/A. Para mitigar esto: + * Amplíe el límite de consultas a números más altos para maximizar la superposición entre columnas + * Ordene las tablas según la columna que considere que "impulsa" la información -## API +## API {#api} -Este widget se puede utilizar con la **API de dashboards**. Consulta la [Documentación de la API de dashboards][8] para obtener referencias adicionales. +Este widget se puede utilizar con **Dashboards API**. Consulte la [documentación de Dashboards API][8] para obtener información adicional. -La [definición del esquema de widget JSON][9] dedicada al widget de la tabla es: +La [definición del esquema JSON del widget][9] dedicada para el widget de tabla es: {{< dashboards-widgets-api >}} -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/data_observability/jobs_monitoring/dbt.md b/hugo/content/es/data_observability/jobs_monitoring/dbt.md new file mode 100644 index 00000000000..e76d4c58e9d --- /dev/null +++ b/hugo/content/es/data_observability/jobs_monitoring/dbt.md @@ -0,0 +1,172 @@ +--- +aliases: +- /es/data_observability/jobs_monitoring/dbtcore +- /es/data_observability/jobs_monitoring/dbtcloud +description: Conecte dbt Cloud o dbt Core a Datadog para obtener metadatos de ejecución + de trabajos y linaje de modelos. +further_reading: +- link: /data_observability/ + tag: Documentación + text: Aprenda sobre Data Observability +- link: https://www.datadoghq.com/blog/understanding-dbt/ + tag: Blog + text: 'Comprender dbt: conceptos básicos y mejores prácticas' +title: dbt +--- +## Descripción general {#overview} + +Datadog puede acceder a los metadatos de su dbt Cloud o dbt Core para extraer información sobre las ejecuciones de trabajos, incluidas las duraciones de ejecución, los modelos generados por dbt y las relaciones de linaje entre modelos. Datadog compara la tabla de su almacén de datos con los modelos de dbt para determinar la causalidad y las consecuencias de un error en la tabla. + +{{< tabs >}} +{{% tab "dbt Cloud" %}} + +Siga los pasos a continuación para conectar dbt Cloud a Datadog. + +## Genere un token de API en dbt Cloud {#generate-an-api-token-in-dbt-cloud} + +Cree un token de servicio en dbt Cloud para que Datadog pueda acceder a los metadatos de su cuenta. + +1. En dbt Cloud, vaya a {{< ui >}}User Profile{{< /ui >}} > {{< ui >}}API Tokens{{< /ui >}} > {{< ui >}}Service Tokens{{< /ui >}}. +2. Haga clic en {{< ui >}}\+ Create Service Token{{< /ui >}}. +3. Proporcione un nombre para el token. +4. Establezca los permisos del token: + - Si crea el webhook en dbt Cloud usted mismo, utilice el conjunto de permisos {{< ui >}}Stakeholder/Read-Only{{< /ui >}} limitado a los proyectos de dbt Cloud relevantes. + - Si Datadog crea y administra el webhook, utilice permisos {{< ui >}}Developer{{< /ui >}} para el plan dbt Cloud Enterprise o permisos {{< ui >}}Account Admin{{< /ui >}} para el plan dbt Cloud Team. +5. Haga clic en {{< ui >}}Save{{< /ui >}} y copie el token de API generado. + +## Conecte su cuenta de dbt Cloud a Datadog {#connect-your-dbt-cloud-account-to-datadog} + +Utilice el token de API para configurar la integración en Data Observability. + +1. Navegue a [{{< ui >}}Datadog Data Observability{{< /ui >}} > {{< ui >}}Settings{{< /ui >}}][1]. +2. En la sección {{< ui >}}dbt Cloud{{< /ui >}}, haga clic en {{< ui >}}Configure{{< /ui >}}. +3. Si ya ha creado una cuenta de integración de dbt Cloud, asegúrese de haberla actualizado con el token de API con los permisos descritos anteriormente. +4. Si no, cree una cuenta. Complete las secciones {{< ui >}}Account Name{{< /ui >}}, {{< ui >}}Account Id{{< /ui >}}, {{< ui >}}Account Url{{< /ui >}} y {{< ui >}}API Token{{< /ui >}}. +5. Haga clic en {{< ui >}}Save{{< /ui >}} para guardar su configuración. + +## Configure webhooks {#configure-webhooks} + +En la configuración de Data Observability, expanda la cuenta de dbt Cloud y elija cómo Datadog recibe los eventos de ejecución de trabajos de dbt Cloud. + +### Cree el webhook en dbt Cloud usted mismo {#create-the-webhook-in-dbt-cloud-yourself} + +Utilice esta opción si desea usar un token de servicio {{< ui >}}Stakeholder/Read-Only{{< /ui >}} para la ingesta de artefactos. + +1. Seleccione {{< ui >}}I'll manage the webhook in dbt Cloud myself{{< /ui >}}. +2. Copie la URL del webhook de Datadog. +3. En dbt Cloud, vaya a {{< ui >}}Account Settings{{< /ui >}} > {{< ui >}}Webhooks{{< /ui >}} > {{< ui >}}Create New Webhook{{< /ui >}}. +4. Pegue la URL del webhook de Datadog en el campo de URL del webhook. +5. Habilite los eventos {{< ui >}}Job Run Started{{< /ui >}} y {{< ui >}}Job Run Completed{{< /ui >}}. Para contextualizar la ingesta a trabajos específicos, seleccione esos trabajos en la configuración del webhook de dbt Cloud. +6. Guarde el webhook en dbt Cloud. +7. Copie el secreto HMAC de dbt Cloud, péguelo en el campo {{< ui >}}HMAC secret from dbt Cloud{{< /ui >}} en Datadog y haga clic en {{< ui >}}Save{{< /ui >}}. + +**Nota**: Después de guardar, los webhooks que usted mismo cree pueden tardar hasta 5 minutos en comenzar a aceptar tráfico de dbt Cloud. + +Si elimina una configuración de webhook administrada por el usuario en Datadog más adelante, elimine el webhook de dbt Cloud manualmente. + +### Permita que Datadog administre el webhook {#let-datadog-manage-the-webhook} + +Utilice esta opción si desea que Datadog cree y mantenga el webhook en dbt Cloud. + +1. Seleccione {{< ui >}}Datadog-managed{{< /ui >}}. +2. Haga clic en {{< ui >}}Save{{< /ui >}}. + +Este modo requiere un token de dbt Cloud con permisos de {{< ui >}}Developer{{< /ui >}} para el plan dbt Cloud Enterprise o permisos de {{< ui >}}Account Admin{{< /ui >}} para el plan dbt Cloud Team. + +## ¿Qué sigue? {#whats-next} + +Después de su próxima ejecución de trabajo de dbt, debería comenzar a ver los datos de ejecución de trabajo y linaje en [Datadog Data Observability][2], como se muestra a continuación. + +{{< img src="data_observability/data-obs-dbt-cloud-final.png" alt="Descripción general de Data Observability que muestra las ejecuciones de trabajo de dbt como un gráfico de barras apiladas a lo largo del tiempo y una tabla de cuentas de dbt Cloud conectadas con su estado." style="width:100%;" >}} + +[1]: https://app.datadoghq.com/data-obs/settings/integrations +[2]: https://app.datadoghq.com/data-obs/catalog?integration=dbt + +{{% /tab %}} + +{{% tab "dbt Core" %}} + +Siga los pasos a continuación para conectar dbt Core a Datadog. + +**Nota**: Si ejecuta dbt Core con un orquestador externo (como Airflow) y desea correlacionar las tareas del orquestador con las ejecuciones de dbt, siga primero las [instrucciones de integración de Airflow][1]. + +## Obtenga su clave de Datadog API {#retrieve-your-datadog-api-key} + +1. [Siga estas instrucciones][2] para crear u obtener una clave de Datadog API. + +## Instale openlineage-dbt {#install-openlineage-dbt} + +1. Instale el paquete `openlineage-dbt`. Consulte [Uso de dbt con Amazon MWAA][3] para configurar este paquete en su entorno virtual. + + ```shell + pip3 install openlineage-dbt>=1.39.0 + ``` + +## Establezca las variables de entorno {#set-the-environment-variables} + +1. Establezca las siguientes variables de entorno. Reemplace `datadoghq.com` con el [sitio de Datadog][4] correspondiente para su organización. Para obtener más información sobre los sitios de Datadog predefinidos, consulte la [documentación de OpenLineage][5]. + + ```shell + export DD_SITE=datadoghq.com + export DD_API_KEY= + export OPENLINEAGE__TRANSPORT__TYPE=datadog + + # OPENLINEAGE_NAMESPACE determines the Datadog tag value for the environment (similar to how the service tag identifies the application). + # Typical values are dev, staging, or prod, but you can over ride it with any custom value. + export OPENLINEAGE_NAMESPACE= + + # Optional, for debugging purposes + export OPENLINEAGE_CLIENT_LOGGING=DEBUG + + # Required for CI/CD Drift Detection (requires openlineage-dbt >= 1.46.0). + # Attaches the sourceCodeLocation facet (repository URL, commit SHA, and pull + # request number) so Datadog can associate the dbt run with a pull request. + # Disabled by default; not required for job monitoring alone. + export OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__DISABLED=false + ``` + + Para las [verificaciones de CI/CD][8], el número de solicitud de extracción se detecta automáticamente cuando la ejecución expone `GITHUB_REF` (flujos de trabajo de GitHub Actions activados por una solicitud de extracción) o `CI_MERGE_REQUEST_IID` (canalizaciones de solicitud de fusión de GitLab). Si ninguna de las variables está presente, establezca el número de solicitud de extracción explícitamente: + + ```shell + export OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__PULL_REQUEST_NUMBER= + ``` + + Si su trabajo de CI se ejecuta dentro de un contenedor que no hereda el contexto git del runner (por ejemplo, un flujo de trabajo de GitHub Actions que inicia un contenedor), la URL del repositorio, el SHA del commit y el número de solicitud de extracción no se detectan automáticamente, por lo que debe pasar los tres explícitamente. Consulte [Ejecución de su trabajo de CI de dbt Core en un contenedor](/data_observability/cicd/#running-your-dbt-core-ci-job-in-a-container). + +## Actualice la invocación de dbt {#update-the-dbt-invocation} + +1. Cambie sus invocaciones de dbt para utilizar el wrapper de OpenLineage (`dbt-ol`) en lugar de llamar a `dbt` directamente. Esto se aplica a cualquier comando de dbt que desee rastrear en Datadog, como `run`, `build` y `test`. Para obtener la lista completa de comandos disponibles, consulte la [documentación de dbt][7]. +2. Agregue la marca `--consume-structured-logs` para visualizar los trabajos de dbt mientras el comando aún se está ejecutando. + + ```shell + # Run models + dbt-ol run --consume-structured-logs --openlineage-dbt-job-name + + # Run tests (required to see test failures in Datadog) + dbt-ol test --consume-structured-logs --openlineage-dbt-job-name + + # Run build (runs models, tests, seeds, and snapshots) + dbt-ol build --consume-structured-logs --openlineage-dbt-job-name + ``` + +## ¿Qué sigue? {#whats-next-1} + +Después de la siguiente ejecución de su trabajo de dbt, debería comenzar a ver los datos de ejecución del trabajo y de linaje en [Datadog Data Observability][6], como se muestra a continuación. + +{{< img src="data_observability/data-obs-dbt-cloud-final.png" alt="Descripción general de Data Observability que muestra las ejecuciones de trabajos de dbt y el linaje de modelos." style="width:100%;" >}} + +[1]: /es/data_jobs/airflow/?tab=kubernetes +[2]: /es/account_management/api-app-keys/#add-an-api-key-or-client-token +[3]: https://docs.aws.amazon.com/mwaa/latest/userguide/samples-dbt.html +[4]: /es/getting_started/site/#access-the-datadog-site +[5]: https://openlineage.io/docs/client/python/#predefined-datadog-sites +[6]: https://app.datadoghq.com/data-obs/catalog?integration=dbt +[7]: https://docs.getdbt.com/docs/running-a-dbt-project/run-your-dbt-projects +[8]: /es/data_observability/cicd/ + +{{% /tab %}} +{{< /tabs >}} + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/es/data_security/guide/public_artifact_vulnerabilities.md b/hugo/content/es/data_security/guide/public_artifact_vulnerabilities.md new file mode 100644 index 00000000000..da4b24a57c7 --- /dev/null +++ b/hugo/content/es/data_security/guide/public_artifact_vulnerabilities.md @@ -0,0 +1,88 @@ +--- +description: Busque información sobre CVE y vulnerabilidades de los artefactos disponibles + públicamente de Datadog. +further_reading: +- link: https://www.datadoghq.com/blog/datadog-public-artifact-vulnerabilities-openvex/ + tag: Blog + text: Reduzca el ruido de CVE con evaluaciones OpenVEX en Datadog +title: Vulnerabilidades de artefactos públicos +--- +La página de Vulnerabilidades de artefactos públicos le permite visualizar información sobre vulnerabilidades y respuestas de los artefactos y bibliotecas disponibles públicamente de Datadog. Úsela para buscar: + +- Qué vulnerabilidades afectan a un artefacto determinado (por imagen/versión) +- Qué artefactos se ven afectados por un CVE determinado +- Estado, justificación, impacto y declaraciones de acción para cada vulnerabilidad + +## Cómo acceder a {#how-to-access} + +La página de Vulnerabilidades de artefactos públicos es accesible a través de la página de Ayuda en {{< ui >}}Public Artifact Vulnerabilities{{< /ui >}}. + +## Uso de la página {#using-the-page} + +### Buscar por artefacto {#look-up-by-artifact} + +Utilice la opción de visualizar artefactos para consultar todas las vulnerabilidades de una familia, imagen y versión específicas (por ejemplo, la imagen del Datadog Agent versión 7.52.0). + +- {{< ui >}}Family{{< /ui >}}: Elija una categoría como {{< ui >}}Agent platform{{< /ui >}}, {{< ui >}}APM library injection{{< /ui >}}, {{< ui >}}Private action runners{{< /ui >}}, {{< ui >}}Telemetry collectors{{< /ui >}}, {{< ui >}}Serverless{{< /ui >}}, {{< ui >}}Private deployments{{< /ui >}} o {{< ui >}}Build & CI{{< /ui >}}. Su selección reduce el menú desplegable {{< ui >}}Image{{< /ui >}}. +- {{< ui >}}Image{{< /ui >}}: Elija una imagen de la familia seleccionada. La lista se crea a partir de los artefactos públicos disponibles. +- {{< ui >}}Version{{< /ui >}}: Elija una versión de la imagen seleccionada. Las versiones están ordenadas de la más reciente a la más antigua. + +La tabla se carga y muestra una fila por cada vulnerabilidad que afecta a esa imagen y versión. + +
Para filtrar sus resultados actuales, ingrese una palabra clave en el cuadro de búsqueda sin hacer clic en {{< ui >}}Find CVE in artifacts{{< /ui >}}.
+ +{{< img src="data_security/public_artifact_vulnerabilities/artifact-view.png" alt="Buscar por artefacto" style="width:100%;" >}} + +**Columnas de la tabla (por imagen/versión):** + +| Columna | Propósito | +|--------|---------| +| Gravedad | Gravedad de la vulnerabilidad (por ejemplo, Crítica, Alta, Media, Baja e Info). | +| Vulnerabilidad | CVE o identificador y nombre de la vulnerabilidad. | +| Plataforma | Plataformas aplicables. Pase el cursor sobre un valor de plataforma para ver las variantes específicas que cubre, incluidas las compilaciones FIPS y no FIPS. | +| Estado | Estado actual: por ejemplo, No afectado, Afectado, Corregido y En investigación. | +| Información adicional | Más información sobre el estado del CVE y la justificación del estado si es necesario. Por ejemplo, si el estado es component_not_present, esta columna explica por qué el CVE no afecta al artefacto y cómo se llegó a esa conclusión. Algunos estados, como En investigación, no tienen información adicional porque el impacto aún se está analizando. | + +### Buscar por CVE {#look-up-by-cve} + +Utilice la opción de visualizar CVE para encontrar qué artefactos y versiones están afectados por vulnerabilidades específicas, y el estado de cada uno. + +1. En el cuadro de búsqueda en la parte superior de la tabla, ingrese uno o más ID de CVE (por ejemplo, `CVE-2024-1234` o `CVE-2024-1234, CVE-2024-5678` para varios). +2. Haga clic en {{< ui >}}Find CVE in artifacts{{< /ui >}}. + +La tabla cambia al modo CVE y muestra una fila por cada combinación de CVE, artefacto y versión. + +
Para filtrar sus resultados actuales, ingrese una palabra clave en el cuadro de búsqueda sin hacer clic en {{< ui >}}Find CVE in artifacts{{< /ui >}}.
+ +{{< img src="data_security/public_artifact_vulnerabilities/cve-view.png" alt="Buscar por CVE" style="width:100%;" >}} + +**Columnas de la tabla (por CVE):** + +| Columna | Propósito | +|--------|---------| +| CVE | El ID de CVE. | +| Nombre del artefacto | Nombre del artefacto (por ejemplo, agente, nombre de la biblioteca). | +| Versión | Versión del artefacto. | +| Plataforma | Plataformas aplicables. Pase el cursor sobre un valor de plataforma para ver las variantes específicas que cubre, incluidas las compilaciones FIPS y no FIPS. | +| Estado | Estado para este CVE/artefacto/versión (por ejemplo, No afectado, Afectado, Corregido y En investigación). | +| Información adicional | Más información sobre el estado del CVE y la justificación del estado si es necesario. | + + +## Artefactos disponibles (imágenes) {#available-artifacts-images} + +El menú desplegable **Imagen** se completa a partir de la lista de artefactos públicos rastreados. Public Artifact Vulnerabilities admite las **10 versiones más recientes** de imágenes públicas rastreadas. Si falta un artefacto esperado, comuníquese con el [Soporte de Datadog][1] para solicitar que se agregue. + +## Opciones y acciones en la página {#options-and-actions-on-the-page} + +| Opción o acción | Descripción | +|------------------|-------------| +| {{< ui >}}Search / global filter{{< /ui >}} | Filtre las filas de la tabla por cualquier texto. En el modo "por imagen/versión", se utiliza el mismo cuadro de búsqueda antes de hacer clic en {{< ui >}}Find CVE in artifacts{{< /ui >}} para ejecutar una búsqueda de CVE. | +| {{< ui >}}Find CVE in artifacts{{< /ui >}} | Ejecuta una búsqueda de CVE utilizando el valor actual del cuadro de búsqueda (admite IDs de CVE separados por comas). Solo es relevante cuando desea realizar una búsqueda por CVE. | +| {{< ui >}}Pagination{{< /ui >}} | Utilice la paginación de la tabla para desplazarse por grandes conjuntos de resultados (por ejemplo, 50 filas por página). | +| {{< ui >}}Resizable columns{{< /ui >}} | Puede ajustar el ancho de las columnas para facilitar la lectura. | + +[1]: /es/help + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/es/data_streams/kafka/_index.md b/hugo/content/es/data_streams/kafka/_index.md new file mode 100644 index 00000000000..8d30cb1ce16 --- /dev/null +++ b/hugo/content/es/data_streams/kafka/_index.md @@ -0,0 +1,70 @@ +--- +aliases: +- /es/data_streams/live_messages +- /es/data_streams/messages +- /es/data_streams/kafka/messages +description: Haga un seguimiento del estado del clúster de Kafka, conecte servicios + a temas e inspeccione esquemas y mensajes con la Consola de Kafka. +further_reading: +- link: https://www.datadoghq.com/blog/kafka-console/ + tag: Blog + text: Solucione problemas de Kafka en cada capa de su stack con la Consola de Kafka. +title: Consola de Kafka +--- +Con la Kafka Console de Data Streams Monitoring, una verificación del Datadog Agent se conecta a su clúster de Kafka y comienza a recopilar métricas de salud y rendimiento. La Consola de Kafka le permite: + +- **Haga un seguimiento de la salud de Kafka**: Vea el estado del clúster, broker, tema y partición con métricas de rendimiento, retraso y replicación. +- **Identifique la causa raíz**: Correlacione los cambios de configuración y esquema con el retraso, el rendimiento y los errores, y rastree los problemas hasta el tema, la versión del esquema o el cambio de configuración exactos. +- **Conecte servicios a temas**: Vea qué productores y consumidores interactúan con cada tema, con propietarios vinculados, repositorios, rotaciones de guardia, trazas y registros de errores. +- **Inspeccione esquemas y mensajes de temas**: Vea esquemas, compare versiones y acceda a mensajes para depurar cargas útiles dañinas o explorar el tema. +- **Alerte y automatice respuestas**: Utilice [plantillas de monitor recomendadas][4] y active Workflow Automation o webhooks cuando se dispare una condición de Kafka. + +Para comenzar, consulte [Configuración de la Consola de Kafka][2]. + +## Flujos de trabajo {#workflows} + +### Haga un seguimiento del estado y el rendimiento del clúster {#monitor-cluster-health-and-performance} + +Las pestañas {{< ui >}}Clusters{{< /ui >}}, {{< ui >}}Topics{{< /ui >}} y {{< ui >}}Brokers{{< /ui >}} muestran el estado de salud en toda su infraestructura de Kafka. Para cada tema, puede ver el recuento de particiones, las particiones sub-replicadas y fuera de línea, el rendimiento de mensajes y el retraso del consumidor. + +{{< img src="data_streams/kafka_clusters_overview-2.png" alt="La vista de clústeres de la Consola de Kafka que muestra la lista de clústeres con recuentos de brokers, nombres de temas, estado de replicación y tasa de mensajes entrantes." >}} + +Haga clic en cualquier tema para ver un resumen detallado, que incluye la tasa de mensajes entrantes, el retraso máximo en todas las particiones y si el retraso actual se acerca al límite de retención. + +{{< img src="data_streams/kafka_topic_summary-2.png" alt="Página de resumen de detalles del tema que muestra una tasa de mensajes entrantes de 0.8 msg/seg, un retraso actual de 1.15 segundos y el estado de retraso frente a retención." >}} + +Desde cualquier métrica, puede crear Datadog monitors, SLOs y dashboards. + +### Correlacione los cambios de configuración y esquema con las métricas de salud {#correlate-configuration-and-schema-changes-with-health-metrics} + +Los eventos de cambio se superponen directamente en los gráficos de rendimiento y retraso, para que pueda ver si un cambio de configuración o esquema coincidió con una degradación. + +{{< img src="data_streams/kafka_topics_lag_change-2.png" alt="Vista de temas con una anotación de cambio de topic_config a las 17:02:42 superpuesta en el gráfico de retraso por tema, que muestra un pico correlacionado con el evento de cambio." >}} + +Para identificar exactamente qué cambió, haga clic en los cambios detectados en la superposición y seleccione {{< ui >}}View config change{{< /ui >}}. + +{{< img src="data_streams/lag-by-topic-overlay.png" alt="Vista de diferencia de configuración de tema que compara las versiones 625 y 626, con max.message.bytes cambiado de 1000012 a 1024 resaltado." >}} + +### Conecte los servicios de productor y consumidor a los temas {#connect-producer-and-consumer-services-to-topics} + +Las secciones {{< ui >}}Producers{{< /ui >}} y {{< ui >}}Consumers{{< /ui >}} de cada tema muestran qué servicios están leyendo y escribiendo en ese tema. Al pasar el cursor sobre un servicio, se muestra la información de propiedad del Service Catalog: equipo, repositorio de código, ingeniero de guardia y canal de Slack. + +{{< img src="data_streams/kafka_topic_service_ownership.png" alt="Vista de productores y consumidores de temas con un panel de servicio abierto que muestra el equipo propietario (Frameworks), el repositorio de código, el ingeniero de guardia, el canal de Slack y el estado de salud." >}} + +Utilice esta información para contactar al equipo correcto cuando un consumidor esté retrasado o un productor no funcione correctamente. + +### Inspeccione los esquemas y mensajes de los temas {#inspect-topic-schemas-and-messages} + +La sección {{< ui >}}Schema{{< /ui >}} muestra el esquema actual para la clave o el valor de un tema, con el historial de versiones. Utilice el selector de versiones para comparar esquemas entre versiones. + +La sección {{< ui >}}Messages{{< /ui >}} le permite recuperar mensajes por partición y desplazamiento para inspeccionar las cargas útiles directamente. Esto es útil para depurar cargas útiles dañinas o verificar la estructura de los mensajes después de un cambio de esquema. Consulte [Habilitar inspección de mensajes][3] para conocer los requisitos previos y permisos adicionales necesarios para recuperar mensajes. + +{{< img src="data_streams/kafka_schema_messages.png" alt="Vista de esquema y mensajes de tema que muestra una definición de esquema de Protobuf y una tabla de mensajes recientes con fecha, partición, desplazamiento y valor del mensaje." >}} + +[2]: /es/data_streams/kafka/setup/ +[3]: /es/data_streams/kafka/setup/#enable-message-inspection +[4]: /es/data_streams/kafka/monitors_and_automation/ + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/es/disaster_recovery/_index.md b/hugo/content/es/disaster_recovery/_index.md index a9527cb7e41..2cc87316a80 100644 --- a/hugo/content/es/disaster_recovery/_index.md +++ b/hugo/content/es/disaster_recovery/_index.md @@ -2,26 +2,21 @@ aliases: - /es/agent/guide/datadog-disaster-recovery/ further_reading: -- link: agent/remote_config/?tab=configurationyamlfile - tag: Documentación - text: Remote Configuration -- link: /getting_started/site/ - tag: Documentación - text: Introducción a Datadog Sites - link: https://www.datadoghq.com/blog/ddr-mitigates-cloud-provider-outages/ tag: Blog text: Datadog Disaster Recovery mitiga las interrupciones del proveedor de la nube site_support_id: datadog_disaster_recovery title: Datadog Disaster Recovery --- -## Descripción general {#overview} +Datadog Disaster Recovery (DDR) mantiene su observabilidad en funcionamiento cuando una región de proveedor de nube o los servicios de Datadog dentro de ella sufren interrupciones. Con DDR, usted configura una organización de Datadog secundaria en una región diferente con antelación y replica sus recursos en ella. Cuando realiza una conmutación por error, el sitio secundario ya cuenta con los dashboards, monitores y usuarios que su equipo necesita. -Datadog Disaster Recovery (DDR) le proporciona continuidad de observabilidad durante eventos que pueden afectar a una región de proveedor de servicios en la nube o a los servicios de Datadog que se ejecutan dentro de una región de proveedor de la nube. Con DDR, puede recuperar la observabilidad en vivo en un sitio de Datadog alternativo y funcional, lo que le permite cumplir con sus objetivos críticos de disponibilidad de observabilidad. +DDR utiliza un modelo activo-pasivo: su sitio secundario permanece sincronizado pero pasivo hasta que usted decida realizar la conmutación por error hacia él. La conmutación por error nunca es automática; usted elige cuándo realizar el cambio. -DDR también le permite realizar periódicamente simulacros de recuperación ante desastres no solo para probar su capacidad de recuperación ante eventos de interrupción, sino también para cumplir con sus necesidades comerciales y de cumplimiento normativo. +DDR también le permite realizar simulacros periódicos de recuperación ante desastres para probar su capacidad de recuperación ante interrupciones y cumplir con sus necesidades comerciales y de cumplimiento normativo. ## Requisitos previos {#prerequisites} -La versión mínima del Datadog Agent que necesita depende de los tipos de telemetría que necesite usar: + +La versión mínima del Datadog Agent que necesita depende de los productos que utilice: |Telemetría admitida |Productos admitidos |Versión de Agent requerida | |--------------------|----------------------------|-----------------------| @@ -29,33 +24,26 @@ La versión mínima del Datadog Agent que necesita depende de los tipos de telem |Métricas |Infrastructure Monitoring | v7.54+ | |Traces |APM | v7.68+ | - -
Datadog evalúa continuamente las solicitudes de los clientes para admitir DDR en productos adicionales. Comuníquese con el equipo de Disaster Recovery para obtener información sobre las próximas capacidades y sus necesidades específicas si no están cubiertas anteriormente.
-
## Configuración {#setup} -Para habilitar Datadog Disaster Recovery, siga estos pasos. Si tiene alguna pregunta sobre cualquiera de los pasos, comuníquese con su [Customer Success Manager][14] o con el [Datadog Support][15]. +Siga estos pasos para habilitar Datadog Disaster Recovery. Si tiene preguntas sobre cualquiera de los pasos, comuníquese con su [Customer Success Manager][14] o con el [Datadog Support][15]. ### 1. Cree una organización de DDR y vincúlela a su organización principal {#1-create-a-ddr-org-and-link-it-to-your-primary-org} {{% collapse-content title="Cree y comparta su organización de DDR" level="h4" %}} -
Si es necesario, Datadog puede configurar esto por usted.
+
Si lo prefiere, Datadog puede configurar esto por usted.
#### Cree su organización de DDR {#create-your-ddr-org} 1. Vaya a [Comience con Datadog][16]. Es posible que deba cerrar la sesión actual o usar el modo incógnito para acceder a esta página. -2. Elija un sitio de Datadog diferente al principal (por ejemplo, si está en `US1`, elija `EU` o `US5`). +2. Elija un sitio de Datadog diferente al principal (por ejemplo, si está en `US1`, elija `EU` o `US5`). Consulte la [lista de sitios de Datadog][17] para ver las opciones. Todos los sitios de Datadog están separados geográficamente. 3. Siga las instrucciones para crear una cuenta. -Todos los sitios de Datadog están separados geográficamente. Consulte la [Lista de sitios de Datadog][17] para ver las opciones. - -Si también está enviando telemetría a Datadog mediante integraciones de proveedores de nube, debe agregar sus cuentas de proveedor de nube en la organización de DDR. Datadog no utiliza proveedores de nube para recibir datos de telemetría mientras el sitio de DDR está en modo pasivo (no en conmutación por error). - #### Comparta la información de la organización de DDR con Datadog {#share-the-ddr-org-information-with-datadog} Envíe por correo electrónico el nombre de su nueva organización a su [Customer Success Manager][14]. Luego, su Customer Success Manager configurará esta nueva organización como su organización de DDR. @@ -64,31 +52,30 @@ Envíe por correo electrónico el nombre de su nueva organización a su [Custome {{% collapse-content title="Recupere los ID públicos y vincule su organización principal y la organización de DDR." level="h4" %}} -Por razones de seguridad, Datadog no puede vincular las organizaciones en su nombre. +
Por razones de seguridad, Datadog no puede vincular las organizaciones en su nombre.
-Después de que el equipo de Datadog haya configurado su organización de DDR, utilice el [punto de conexión de API pública][1] de Datadog para recuperar los ID públicos de la organización principal y de la de DDR. +Después de que Datadog designe su organización de DDR, vincule su organización de DDR a su organización principal: -Para vincular su organización de DDR a su organización principal: +1. Utilice el punto de conexión [List your managed organizations][1] para recuperar los ID públicos de sus organizaciones principal y de DDR. +1. Agregue el contexto `disaster_recovery_status_write` a su clave de aplicación en la organización principal. +1. Ejecute los siguientes comandos, reemplazando los marcadores de posición con los valores correspondientes. -- Agregue el contexto `disaster_recovery_status_write` a su clave de aplicación en la organización principal. -- Ejecute los siguientes comandos, reemplazando los marcadores de posición con los valores correspondientes. + ```shell + export PRIMARY_DD_API_KEY= + export PRIMARY_DD_APP_KEY= + export PRIMARY_DD_API_URL= -```shell -export PRIMARY_DD_API_KEY= -export PRIMARY_DD_APP_KEY= -export PRIMARY_DD_API_URL= - -export DDR_ORG_ID= -export PRIMARY_ORG_ID= -export USER_EMAIL= -export CONNECTION='{"data":{"id":"'${PRIMARY_ORG_ID}'","type":"hamr_org_connections","attributes":{"TargetOrgUuid":"'${DDR_ORG_ID}'","HamrStatus":1,"ModifiedBy":"'${USER_EMAIL}'", "IsPrimary":true}}}' - -curl -v -H "Content-Type: application/json" -H \ -"dd-api-key:${PRIMARY_DD_API_KEY}" -H \ -"dd-application-key:${PRIMARY_DD_APP_KEY}" --data "${CONNECTION}" --request POST ${PRIMARY_DD_API_URL}/api/v2/hamr -``` + export DDR_ORG_ID= + export PRIMARY_ORG_ID= + export USER_EMAIL= + export CONNECTION='{"data":{"id":"'${PRIMARY_ORG_ID}'","type":"hamr_org_connections","attributes":{"TargetOrgUuid":"'${DDR_ORG_ID}'","HamrStatus":1,"ModifiedBy":"'${USER_EMAIL}'", "IsPrimary":true}}}' -Después de vincular sus organizaciones, solo la organización de conmutación por error muestra este banner: + curl -v -H "Content-Type: application/json" -H \ + "dd-api-key:${PRIMARY_DD_API_KEY}" -H \ + "dd-application-key:${PRIMARY_DD_APP_KEY}" --data "${CONNECTION}" --request POST ${PRIMARY_DD_API_URL}/api/v2/hamr + ``` + +Después de vincular sus organizaciones, la organización de conmutación por error muestra este banner: {{< img src="agent/guide/ddr/ddr-banner.png" alt="El banner de DDR en la organización de DDR" >}} @@ -100,7 +87,7 @@ Después de vincular sus organizaciones, solo la organización de conmutación p **Datadog recomienda usar el inicio de sesión único (SSO)** para permitir que todos sus usuarios inicien sesión en su organización de DDR durante una interrupción. -Vaya a la [Configuración de la organización][2] en su organización de DDR para configurar [SAML][3] o {{< ui >}}Google Login{{< /ui >}} para sus usuarios. +Vaya a [Organization Settings][2] en su organización de DDR para configurar [SAML][3] o {{< ui >}}Google Login{{< /ui >}} para sus usuarios. La sincronización administrada replica las cuentas de usuario desde su organización principal a su organización de DDR. Datadog recomienda configurar el [aprovisionamiento Just-in-Time con SAML][4] para que los usuarios puedan acceder a la organización de DDR durante una conmutación por error sin necesidad de restablecer su contraseña. @@ -110,7 +97,7 @@ La sincronización administrada replica las cuentas de usuario desde su organiza Consulte las integraciones de [AWS][5], [Azure][6] y [Google Cloud][7] para conocer los pasos de configuración. -Sus integraciones en la nube deben configurarse tanto en la organización principal como en la de DDR, pero solo se ejecutan en una organización a la vez: de forma predeterminada en la organización principal y en la organización de DDR durante la conmutación por error. +Sus integraciones en la nube deben configurarse tanto en la organización principal como en la de DDR, pero solo se ejecutan en una organización a la vez: de forma predeterminada en la organización principal y durante la conmutación por error en la organización de DDR. Para obtener más información, consulte la sección [Conmutación por error de integraciones en la nube](#id-for-cloud). @@ -128,7 +115,7 @@ La sincronización administrada replica los recursos de su organización princip {{% /collapse-content %}} -{{% collapse-content title="Habilitar Remote Configuration [**RECOMMENDED]" level="h4" %}} +{{% collapse-content title="Habilitar Remote Configuration (RECOMMENDED)" level="h4" %}} [Remote Configuration (RC)][11] le permite configurar y cambiar de forma remota el comportamiento de los Datadog Agents implementados en su infraestructura. @@ -140,7 +127,6 @@ Datadog recomienda encarecidamente usar Remote Configuration para un mejor contr {{% collapse-content title="Envío dual de telemetría a la organización de DDR durante la conmutación por error o los simulacros" level="h4" %}} - Para habilitar el envío dual, Datadog recomienda usar [Fleet Automation][12] para la administración a escala. Alternativamente, puede configurarlo manualmente editando su archivo `datadog.yaml`. Comuníquese con su Customer Success Manager de Datadog para programar ventanas de tiempo dedicadas para las pruebas de conmutación por error a fin de medir el rendimiento y el Objetivo de Tiempo de Recuperación (RTO). @@ -148,13 +134,13 @@ Comuníquese con su Customer Success Manager de Datadog para programar ventanas {{< tabs >}} {{% tab "Uso de Fleet Automation (recomendado)" %}} -Desde la página [Fleet Automation][100] en su organización de conmutación por error, en la pestaña {{< ui >}}Configure Agents{{< /ui >}}, puede crear una política de conmutación por error o reutilizar una existente, y aplicarla a su flota de Datadog Agents. Poco después de habilitar la política, los Datadog Agents comienzan a realizar el envío dual de telemetría tanto al sitio de observabilidad principal como al de DDR (conmutación por error). +Vaya a [Fleet Automation][100] > {{< ui >}}Configure Agents{{< /ui >}} en su organización de DDR para crear una política de conmutación por error o reutilizar una existente, y aplíquela a su flota de Agents. Poco después de habilitar la política, los Datadog Agents comienzan a realizar el envío dual de telemetría tanto al sitio de observabilidad principal como al de DDR (conmutación por error). Para crear una política de conmutación por error, haga clic en {{< ui >}}Create Failover Policy{{< /ui >}}. {{< img src="/agent/guide/ddr/ddr-fa-policy.png" alt="Administrar políticas de DDR" style="width:80%;" >}} -Luego, siga las instrucciones para definir el alcance de los hosts y la telemetría (métricas, Logs, Traces) que necesita incluir en la conmutación por error. +Luego, siga las instrucciones para definir el contexto de los hosts y la telemetría (métricas, registros, trazas) que deben incluirse en la conmutación por error. {{< img src="/agent/guide/ddr/ddr-fa-policy-scope.png" alt="Definir el alcance de los hosts y la telemetría necesarios para la conmutación por error" style="width:80%;" >}} @@ -166,7 +152,7 @@ Luego, siga las instrucciones para definir el alcance de los hosts y la telemetr {{% tab "Manualmente" %}} -Durante una conmutación por error o ejercicios de conmutación por error, actualice el archivo de configuración `datadog.yaml` de su Datadog Agent como se muestra en el ejemplo a continuación y reinicie el Datadog Agent. +Durante una conmutación por error o ejercicios de conmutación por error, actualice el archivo de configuración `datadog.yaml` de su Datadog Agent como se muestra en el siguiente ejemplo y reinicie el Agent. - `enabled: true` permite que el Datadog Agent envíe {{< tooltip text="metadata" tooltip="Datos sobre el Datadog Agent y el servidor de infraestructura. Por ejemplo, `host name`, `host tags`, `Agent version`." >}} al sitio de Datadog DDR para que pueda visualizar los Agents y sus servidores de infraestructura en la organización DDR. Esto le permite ver sus Agents y servidores de infraestructura en la organización de conmutación por error. @@ -178,7 +164,7 @@ multi_region_failover: failover_metrics: false failover_logs: false failover_apm: false - site: # For example "site: us5.datadoghq.com" for a US5 site + site: # For example, "site: us5.datadoghq.com" for a US5 site api_key: ``` @@ -195,11 +181,11 @@ La conmutación por error basada en DNS es un enfoque complementario a la conmut #### Reciba su punto de conexión DNS personalizado {#receive-your-custom-dns-endpoint} -Si elige utilizar la conmutación por error basada en DNS, Datadog proporciona una URL de ingesta personalizada para su organización (por ejemplo, `.intake.datadoghq.com`). Configure todas sus fuentes de datos (Datadog Agents, remitentes de registros e instrumentación personalizada) para enviar telemetría a este punto de conexión en lugar de a la URL de ingesta predeterminada de Datadog. Este es un cambio de configuración único. +Si elige utilizar la conmutación por error basada en DNS, Datadog proporciona una URL de ingesta personalizada para su organización (por ejemplo, `.intake.datadoghq.com`). Configure todas sus fuentes de datos (como Agent, remitentes de registros e instrumentación personalizada) para enviar telemetría a este punto de conexión en lugar de a la URL de ingesta predeterminada de Datadog. Este es un cambio de configuración único. #### Active una conmutación por error de DNS {#trigger-a-dns-failover} -Para iniciar una conmutación por error de DNS, comuníquese con Datadog a través de su [Gerente de éxito del cliente][14] o [Soporte de Datadog][15]. Datadog actualiza el registro DNS para redirigir el tráfico de su sitio principal a su sitio de DDR. El objetivo de tiempo de recuperación (RTO) previsto desde el momento en que se inicia la conmutación por error es de 2 horas. +Comuníquese con su [Customer Success Manager][14] o [Datadog Support][15] para iniciar una conmutación por error de DNS. Datadog actualiza el registro DNS para redirigir el tráfico de su sitio principal a su sitio de DDR. El objetivo de tiempo de recuperación (RTO) previsto es de 2 horas desde el momento en que se inicia la conmutación por error.
Una forma controlada por el cliente para activar la conmutación por error de DNS directamente desde la organización de DDR se encuentra en vista previa. Comuníquese con su Gerente de éxito del cliente para obtener más información.
@@ -209,7 +195,7 @@ Para iniciar una conmutación por error de DNS, comuníquese con Datadog a trav {{% collapse-content title="Active y pruebe la conmutación por error de DDR en entornos basados en Agent." level="h4" %}} -Para activar una conmutación por error de sus Agents, puede hacer clic en una de las políticas en [Fleet Automation][13] en su organización de DDR y, luego, hacer clic en {{< ui >}}Enable{{< /ui >}}. El estado de cada servidor se actualiza a medida que ocurre la conmutación por error. +Para activar una conmutación por error de sus Agents, haga clic en una de las políticas en [Fleet Automation][13] en su organización de DDR y, luego, haga clic en {{< ui >}}Enable{{< /ui >}}. El estado de cada servidor se actualiza a medida que ocurre la conmutación por error. {{< img src="/agent/guide/ddr/ddr-fa-policy-enable3.png" alt="Habilite la política de conmutación por error en la organización de DDR" style="width:80%;" >}} @@ -298,7 +284,7 @@ Durante las pruebas, la telemetría de integración se distribuye entre ambas or [1]: /es/api/latest/organizations/#list-your-managed-organizations [2]: https://app.datadoghq.com/organization-settings/users -[3]: /es/account_management/saml/#overview +[3]: /es/account_management/saml/ [4]: /es/account_management/saml/#just-in-time-jit-provisioning [5]: /es/integrations/amazon-web-services/ [6]: /es/integrations/azure/ diff --git a/hugo/content/es/experiments/_index.md b/hugo/content/es/experiments/_index.md index 46cd7b6b389..ad02a80d117 100644 --- a/hugo/content/es/experiments/_index.md +++ b/hugo/content/es/experiments/_index.md @@ -20,9 +20,15 @@ further_reading: - link: https://www.datadoghq.com/blog/experiments tag: Blog text: Mida el impacto comercial de cada cambio de producto con Datadog Experiments +- link: https://www.datadoghq.com/blog/coordinate-product-launches-with-datadog/ + tag: Blog + text: Coordine los lanzamientos de productos con Datadog +- link: https://www.datadoghq.com/blog/chatgpt-datadog-experiments/ + tag: Blog + text: Analice sus experimentos en ChatGPT con el complemento Datadog Experiments title: Experimentos --- -## Resumen {#overview} +## Descripción general {#overview} Datadog Experiments es una plataforma componible para la experimentación de extremo a extremo. Un experimento en Datadog consta de dos componentes: @@ -77,7 +83,7 @@ Esta ruta funciona cuando la aleatorización se ejecuta a través de [Datadog Fe Datadog aplica análisis estadístico para comparar variantes y estimar el incremento. Cuando configure un experimento, elija un [método de análisis][11] (frecuentista secuencial, frecuentista de muestra fija o bayesiano) y, opcionalmente, ejecute un [cálculo de tamaño de muestra][8] para estimar cuánto tiempo debe ejecutarse el experimento. Una vez obtenidos los resultados, utilice [Global Lift][19] para comprender cómo se traduce un incremento de experimento dirigido en un impacto en el total de métricas de toda su empresa, y [Cumulative Impact][12] para agregar efectos ajustados por ruido en muchos experimentos sobre la misma métrica. -{{< img src="/product_analytics/experiment/overview_metrics_view-1.png" alt="La visualización de métricas de Experimentos que muestra métricas de negocio, de embudo y de rendimiento con valores de control y variante, además del incremento relativo para cada métrica. Se muestra un tooltip en la métrica Revenue que presenta los valores Non-CUPED para Revenue per User, Total Revenue y User Assignment Count en los grupos de control y variante." style="width:90%;" >}} +{{< img src="/product_analytics/experiment/overview_metrics_view-1.png" alt="La visualización de métricas de Experimentos que muestra métricas de negocio, de embudo y de rendimiento con valores de control y variante, además del incremento relativo para cada métrica. Se muestra información sobre la herramienta en la métrica Revenue que presenta los valores Non-CUPED para Revenue per User, Total Revenue y User Assignment Count en los grupos de control y variante." style="width:90%;" >}} ## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/experiments/defining_metrics/_index.md b/hugo/content/es/experiments/defining_metrics/_index.md new file mode 100644 index 00000000000..e2d199962c9 --- /dev/null +++ b/hugo/content/es/experiments/defining_metrics/_index.md @@ -0,0 +1,183 @@ +--- +aliases: +- /es/product_analytics/experimentation/defining_metrics/ +description: Cree las métricas que desea medir en sus experimentos. +further_reading: +- link: https://www.datadoghq.com/blog/datadog-product-analytics/ + tag: Blog + text: Tome decisiones de diseño basadas en datos con Product Analytics +- link: https://www.datadoghq.com/blog/how-we-built-datadog-experiments/ + tag: Blog + text: Cómo creamos Datadog Experiments +title: Crear métricas de experimento +--- +## Descripción general {#overview} + +Cree las métricas que desea medir en sus experimentos. Puede utilizar datos de Real User Monitoring (RUM), Product Analytics o su propio almacén de datos para crear métricas de Datadog Experiments. + +
Si su organización utiliza roles personalizados, debe tener los permisos de Product Analytics adecuados para crear métricas de experimento.
+ +## Crear una métrica {#create-a-metric} + +Seleccione su fuente de datos: + +{{< tabs >}} +{{% tab "Product Analytics o RUM" %}} + +### Requisitos previos {#prerequisites} + +Para crear una métrica a partir de datos de Product Analytics o RUM, debe tener instalado el [SDK del lado del cliente][3] de Datadog en su aplicación y estar capturando datos activamente. Si aún no ha configurado su SDK, seleccione su tipo de aplicación para comenzar: + +- [Android y Android TV][4] +- [iOS y tvOS][5] +- [Navegador (JavaScript)][6] +- [React Native][7] + +Product Analytics utiliza los mismos SDKs y configuración que Real User Monitoring (RUM). Después de configurar su SDK utilizando la documentación de configuración de RUM, cree su métrica en la interfaz de usuario de Product Analytics. + +### Crear una métrica utilizando datos de Product Analytics o RUM {#create-a-metric-using-product-analytics-or-rum-data} + +Para crear una métrica para su experimento: + +1. Navegue a la [página de métricas][1] en Datadog Product Analytics. +1. Seleccione la pestaña {{< ui >}}Metrics{{< /ui >}} y haga clic en {{< ui >}}Create Metric{{< /ui >}} en la esquina superior derecha. +1. Agregue un {{< ui >}}Metric name{{< /ui >}} y, opcionalmente, un {{< ui >}}Description{{< /ui >}}. +1. En la sección {{< ui >}}Metric definition{{< /ui >}}, haga clic en {{< ui >}}Select an event{{< /ui >}} para abrir el selector de eventos. El gráfico de la derecha se actualiza en tiempo real a medida que configura su métrica. + 1. Busque un evento específico o use el filtro {{< ui >}}By Type{{< /ui >}} para explorar por tipo de evento. +1. Seleccione un [método de agregación](#aggregation-methods) en el menú desplegable. El valor predeterminado es {{< ui >}}Count of events{{< /ui >}}. +1. Haga clic en {{< ui >}}Add Filter{{< /ui >}} para [filtrar su métrica](#add-filters) por propiedades adicionales. +1. (Opcional) En la sección {{< ui >}}Additional settings{{< /ui >}}: + 1. Active {{< ui >}}Mark as certified{{< /ui >}} para indicar que esta métrica está aprobada para la toma de decisiones importantes. Esto requiere el permiso de escritura de Métricas Certificadas de Product Analytics. + 1. Ajuste [{{< ui >}}Experiment settings{{< /ui >}}](#advanced-options) y {{< ui >}}Units{{< /ui >}} según sea necesario. Los valores predeterminados funcionan para la mayoría de los casos de uso. +1. Haga clic en {{< ui >}}Save{{< /ui >}}. + +{{< img src="/product_analytics/experiment/exp_create_new_metric.png" alt="La página Crear métrica con el nombre de la métrica establecido en 'Example metric', el evento 'click on ADD TO CART' seleccionado, el menú desplegable del método de agregación establecido en Recuento de eventos, la sección Configuración adicional, una vista previa de gráfico de barras a la derecha y el botón Guardar resaltado." style="width:90%;" >}} + +[1]: https://app.datadoghq.com/product-analytics/experimentation-metrics +[3]: /es/real_user_monitoring/#get-started +[4]: /es/real_user_monitoring/application_monitoring/android/setup/?tab=kotlin +[5]: /es/real_user_monitoring/application_monitoring/ios/setup/?tab=swift-package-manager--spm +[6]: /es/real_user_monitoring/application_monitoring/browser/setup/client/?tab=npm +[7]: /es/real_user_monitoring/application_monitoring/react_native/setup/?platform=react_native + +### Agregar filtros {#add-filters} + +Puede filtrar su métrica seleccionando un filtro {{< ui >}}Event properties{{< /ui >}}, como servicio, país o tipo de dispositivo. Utilice el filtro {{< ui >}}By Data Type{{< /ui >}} para limitar la lista de propiedades disponibles por tipo (por ejemplo, String o Boolean). + +Si no ve la propiedad que necesita, escriba el nombre de la propiedad en el campo {{< ui >}}Custom property{{< /ui >}} (por ejemplo, `@context.tracking`) y haga clic en {{< ui >}}Add{{< /ui >}}. + +{{< img src="/product_analytics/experiment/exp_filter_by_2.png" alt="El panel Filter by se abre dentro de la sección Metric definition, mostrando All Properties seleccionadas, Event properties como Application Id, Service, Browser Name y Country en el centro, un filtro By Data Type con opciones Numerical, String y Boolean a la izquierda, y una sección Custom property en la parte inferior con un campo de texto que muestra el marcador de posición 'e.g. @context.tracking' y un botón Add." style="width:90%;" >}} + +{{% /tab %}} +{{% tab "Almacén" %}} + +### Requisitos previos {#prerequisites-1} + +Para crear una métrica a partir de los datos de su almacén, debe [conectar su almacén a Datadog][8]. Datadog es compatible con BigQuery, Databricks, Redshift y Snowflake. + +Después de conectar su almacén, cree un modelo SQL para asignar sus datos a Datadog, luego use el modelo para crear una métrica. + +### Crear un modelo SQL {#create-a-sql-model} + +Escriba su consulta SQL para definir y obtener una vista previa de sus datos, luego configure su modelo para asignar los datos a Datadog. + +#### Escriba su SQL {#write-your-sql} + +Comience escribiendo una consulta para recuperar sus datos: + +1. Navegue a la [página de métricas][1] en Datadog Product Analytics. +1. Seleccione la pestaña {{< ui >}}Metric SQL Models{{< /ui >}} y haga clic en {{< ui >}}Create SQL Model{{< /ui >}}. +1. En la sección {{< ui >}}Write SQL{{< /ui >}}, ingrese una consulta SQL que devuelva los datos de su interés. El editor de SQL admite `SELECT * FROM` y sentencias SQL más avanzadas. +1. Haga clic en {{< ui >}}Run{{< /ui >}} para obtener una vista previa de sus datos. + +{{< img src="/product_analytics/experiment/exp_create_metric_sql_models_writesql_1.png" alt="La sección Write SQL de la página Create Metric SQL Model que muestra una consulta SELECT para user_id, revenue_timestamp y amount de una tabla de pedidos de ingresos, con una vista previa de consulta exitosa debajo que muestra las columnas USER_ID, REVENUE_TIMESTAMP y AMOUNT." style="width:80%;" >}} + +Para tablas grandes, utilice [variables de plantilla SQL][13] para aplicar los filtros de fecha de Datadog en su consulta y reducir la cantidad de datos que su almacén escanea en cada ejecución. + +#### Asigne sus datos de almacén a Datadog {#map-your-warehouse-data-to-datadog} + +Después de obtener una vista previa de sus datos, asígnelos a Datadog. En la sección {{< ui >}}Structure your model{{< /ui >}}: + +1. Agregue un {{< ui >}}Metric SQL Model Name{{< /ui >}} (por ejemplo, **Revenue Orders**). +1. (Opcional) Active {{< ui >}}Mark as certified{{< /ui >}} para indicar que este modelo SQL está aprobado para la toma de decisiones importantes. Esto requiere el permiso de escritura de Métricas Certificadas de Product Analytics. +1. Asigne las columnas de su tabla de almacén de datos a lo siguiente: + - {{< ui >}}Timestamp column{{< /ui >}} + - La columna que enumera la marca de tiempo asociada con el evento de métrica. + - El análisis solo incluye filas creadas después de que el sujeto se inscribe en el experimento. + - {{< ui >}}Subject Type{{< /ui >}} + - El atributo que Datadog utiliza para asignar grupos de experimento de forma aleatoria. + - Puede definir el tipo de sujeto y su columna de almacén predeterminada en la página [Subject Types][12]. Por ejemplo, puede usar `user_id` para un usuario individual o `org_id` para una cuenta de organización. + - {{< ui >}}Measures{{< /ui >}} (opcional) + - Las columnas numéricas de su tabla de almacén de datos que Datadog puede agregar en métricas (por ejemplo, una columna `revenue` o `amount`). + - Cada modelo SQL incluye automáticamente una medida {{< ui >}}each record{{< /ui >}}. Use esta medida para contar el número de filas relevantes en la tabla para un sujeto de experimento específico. +1. Haga clic en {{< ui >}}Create Metric SQL Model{{< /ui >}} para guardar su modelo SQL. + +{{< img src="/product_analytics/experiment/exp_create_metrics_sql_model_structure4.png" alt="El panel Structure your model con el campo Metric SQL Model Name configurado en 'Revenue Orders' y resaltado, un interruptor Mark as certified, la columna Timestamp configurada en REVENUE_TIMESTAMP, Subject Type configurado en User (@usr.id) con USER_ID seleccionado en el selector de columnas, un menú desplegable Measures que muestra 'Revenue Orders (each record)', y el botón Create Metric SQL Model resaltado." style="width:80%;" >}} + +### Cree una métrica usando su modelo SQL {#create-a-metric-using-your-sql-model} + +Después de crear su modelo SQL, úselo para crear una métrica: + +1. Navegue a la [página de métricas][1] en Datadog Product Analytics. +1. Seleccione la pestaña {{< ui >}}Metrics{{< /ui >}} y haga clic en {{< ui >}}Create Metric{{< /ui >}} en la esquina superior derecha. +1. Agregue un {{< ui >}}Metric name{{< /ui >}} y, opcionalmente, un {{< ui >}}Description{{< /ui >}}. +1. En la sección {{< ui >}}Metric definition{{< /ui >}}, haga clic en {{< ui >}}Select an event{{< /ui >}} para abrir el selector de eventos. El gráfico de la derecha se actualiza en tiempo real a medida que configura su métrica. + 1. Seleccione el modelo SQL relevante. Sus modelos SQL aparecen bajo su fuente de datos (por ejemplo, **Revenue Orders** bajo **Snowflake**). +1. Seleccione un [método de agregación](#aggregation-methods) en el menú desplegable. +1. (Opcional) En la sección {{< ui >}}Additional settings{{< /ui >}}: + 1. Active {{< ui >}}Mark as certified{{< /ui >}} para indicar que esta métrica está aprobada para la toma de decisiones importantes. Esto requiere el permiso de escritura de Métricas Certificadas de Product Analytics. + 1. Ajuste [{{< ui >}}Experiment settings{{< /ui >}}](#advanced-options) y {{< ui >}}Units{{< /ui >}} según sea necesario. Los valores predeterminados funcionan para la mayoría de los casos de uso. +1. Haga clic en {{< ui >}}Save{{< /ui >}}. + +{{< img src="/product_analytics/experiment/exp_create_metric_from_sqlmodel_2.png" alt="El selector de eventos Crear métrica muestra Todos los eventos seleccionados, con tipos de eventos que incluyen Snowflake, Acciones, Vistas, Sesiones, Errores y Tareas largas a la izquierda, y el modelo SQL Revenue Orders resaltado bajo Snowflake a la derecha, mostrando Medidas: cantidad y Dimensiones filtrables: N/A." style="width:80%;" >}} + +[1]: https://app.datadoghq.com/product-analytics/experimentation-metrics +[8]: /es/experiments/guide/connecting_a_data_warehouse/ +[12]: https://app.datadoghq.com/product-analytics/experiments/settings/subject-types +[13]: /es/experiments/concepts/sql_template_variables/ + +{{% /tab %}} +{{< /tabs >}} + +## Métodos de agregación {#aggregation-methods} + +Los métodos de agregación determinan cómo Datadog resume los datos para cada sujeto del experimento. Un sujeto de experimento es la unidad que Datadog aleatoriza para el experimento. Por lo general, es un usuario, pero también puede ser una organización, una cookie o un dispositivo, dependiendo de cómo configure su experimento. + +Datadog Experiments admite los siguientes métodos de agregación: + +- {{< ui >}}Count of events{{< /ui >}} (predeterminado) +- {{< ui >}}Count of unique users{{< /ui >}} (útil para métricas de conversión) +- {{< ui >}}Sum of{{< /ui >}} una propiedad de evento (útil para métricas de ingresos) +- {{< ui >}}Distinct values of{{< /ui >}} una propiedad de evento (útil para métricas de páginas únicas vistas) +- {{< ui >}}Percentile{{< /ui >}} de una propiedad de evento (útil para métricas de latencia) +- {{< ui >}}Average of{{< /ui >}} una propiedad de evento (útil para métricas de satisfacción) + +{{< img src="/product_analytics/experiment/exp_default_metric_agg_1.png" alt="El menú desplegable del método de agregación muestra Count of unique users (seleccionado) y Count of events en la parte superior, seguido de una sección SELECT A MEASURE con las opciones Sum of, Distinct values of, Percentile y Average of, con una descripción que dice 'El número de usuarios que realizaron el evento' a la derecha." style="width:90%;" >}} + +Datadog calcula métricas para cada sujeto del experimento. Por ejemplo, una {{< ui >}}Count of events{{< /ui >}} métrica en un experimento aleatorizado por usuario calcula el número total de eventos para todos los usuarios en la variante (grupo de experimento) dividido por el número de usuarios en esa variante. + +### Métricas de razón {#ratio-metrics} + +Haga clic en {{< ui >}}Create Ratio{{< /ui >}} para dividir la métrica por un valor distinto al número predeterminado de sujetos del experimento. El denominador puede utilizar cualquiera de los [métodos de agregación](#aggregation-methods). Por ejemplo, divida las compras por las visitas a la página del producto para medir la conversión en un paso específico del embudo, en lugar de hacerlo entre todos los usuarios inscritos. + +Datadog tiene en cuenta las correlaciones entre el numerador y el denominador utilizando el [delta method][2]. + +{{< img src="/product_analytics/experiment/exp_create_ratio_new_ui.png" alt="La sección de definición de métricas que muestra el evento 'click on ADD TO CART' con la agregación Count of events y una opción Add Filter, el botón Create Ratio resaltado abajo, y la sección Additional settings con el interruptor Mark as certified, Experiment settings y Units." style="width:90%;" >}} + +## Opciones avanzadas {#advanced-options} + +Datadog Experiments admite las siguientes opciones avanzadas. Estas se pueden modificar en {{< ui >}}Additional settings{{< /ui >}} > {{< ui >}}Experiment settings{{< /ui >}} al crear una métrica. + +Filtros de marco temporal +: De forma predeterminada, Datadog incluye todos los eventos entre la primera exposición de un usuario y el final del experimento. Utilice esta configuración para medir un valor limitado en el tiempo, como \"sesiones dentro de 7 días\". Si agrega un filtro de marco temporal, la métrica solo incluye eventos de la ventana de tiempo especificada, comenzando en el momento en que el experimento inscribe al usuario por primera vez. + +Dirección deseada de la métrica +: Datadog resalta los resultados estadísticamente significativos. Utilice esta configuración para especificar si desea que esta métrica aumente o disminuya. + +Manejo de valores anómalos +: Los datos del mundo real a menudo incluyen valores anómalos extremos que pueden afectar los resultados del experimento. Utilice esta configuración para establecer un umbral en el que Datadog trunca los datos. Por ejemplo, establezca un límite superior del 99% para truncar todos los resultados en el percentil 99 de la métrica. + +## Lecturas adicionales {#further-reading} +{{< partial name="whats-next/whats-next.html" >}} + +[2]: https://en.wikipedia.org/wiki/Delta_method \ No newline at end of file diff --git a/hugo/content/es/experiments/reading_results.md b/hugo/content/es/experiments/reading_results.md new file mode 100644 index 00000000000..63eb332f5e4 --- /dev/null +++ b/hugo/content/es/experiments/reading_results.md @@ -0,0 +1,124 @@ +--- +aliases: +- /es/product_analytics/experimentation/reading_results/ +description: Lea y comprenda los resultados de sus experimentos. +further_reading: +- link: /product_analytics/analytics_explorer/ + tag: Documentación + text: Explorador de Analytics +- link: /experiments/diagnostics/ + tag: Documentación + text: Diagnóstico de experimentos +- link: https://www.datadoghq.com/blog/datadog-product-analytics/ + tag: Blog + text: Tome decisiones de diseño basadas en datos con Product Analytics +title: Lectura de los resultados del experimento +--- +## Descripción general {#overview} + +Después de [lanzar un experimento][1], la página de resultados del experimento es el lugar central para analizarlo. Desde esta página, usted puede: + +- **Mida las métricas**: Revise los cuadros de mando que comparan el rendimiento del control y el tratamiento en sus métricas de decisión. +- **Analice los resultados más a fondo**: Desglose el aumento de la métrica por segmentos de usuario o grafique el aumento a lo largo del tiempo para comprender cómo funcionó su cambio en los diferentes grupos. +- **Inspeccione las repeticiones de sesión**: Abra las repeticiones de sesiones de usuarios individuales para ver cómo experimentó cada usuario cada variante. +- **Documente los aprendizajes**: Registre las conclusiones y los puntos clave para su equipo. + +Las siguientes secciones explican el cuadro de mando de métricas y cómo explorar los resultados. + +## Diagnóstico de experimentos {#experiment-diagnostics} + +Datadog ejecuta [diagnósticos de experimentos][9] con el análisis de experimentos para verificar los datos de exposición, los datos de métricas, la aleatorización y el estado del análisis. Revise las advertencias de diagnóstico antes de interpretar los resultados, especialmente cuando falte una métrica, sea inesperadamente cero o esté marcada con una advertencia. + +## Cuadro de mando de métricas {#metric-scorecard} + +La página de resultados del experimento muestra un cuadro de mando para cada métrica de decisión. Cada fila resume cómo se comparó una métrica entre las variantes de tratamiento y control. + +{{< img src="/product_analytics/experiment/exp_reading_exps_scorecard.png" alt="La descripción general de los resultados del experimento que muestra una tabla de métricas de decisión con valores de control y tratamiento, aumento relativo y barras de intervalo de confianza para tres métricas." style="width:90%;" >}} + +### Qué muestra el cuadro de mando {#what-the-scorecard-shows} + +Para cada métrica, el cuadro de mando muestra: + +- **Valores de control y tratamiento**: El valor promedio de la métrica por sujeto en cada variante. +- **Elevación relativa**: El cambio porcentual en ese promedio entre el tratamiento y el control. +- **Intervalo de confianza**: Un rango de valores de elevación consistentes con los datos observados, que se muestra como una barra centrada en la estimación de la elevación relativa. + +La amplitud y la interpretación del intervalo de confianza dependen del [método de análisis][2] configurado para el experimento. + +{{% collapse-content title="Cómo se calculan las métricas" level="h4" expanded=false id="how-metrics-are-calculated" %}} + +Datadog analiza los experimentos a nivel de **sujeto**: la unidad que configuró al establecer el experimento, generalmente un usuario. Datadog calcula un valor métrico para cada sujeto inscrito (por ejemplo, ingresos por usuario o si el usuario completó un registro). Estos valores por sujeto forman una distribución para cada variante. Luego, el motor estadístico de Datadog compara estas distribuciones entre el control y el tratamiento. + +**El lift relativo** mide cuánto cambió el tratamiento el valor métrico promedio por sujeto en comparación con el control: + +``` +Relative lift = (Treatment − Control) / Control +``` + +Un lift relativo del 10% significa que el valor promedio por sujeto del grupo de tratamiento es un 10% mayor que el promedio del grupo de control. Un lift negativo significa que el tratamiento tuvo un desempeño peor en promedio. + +{{% /collapse-content %}} + +### Intervalos de confianza{#confidence-intervals} + +El intervalo de confianza es un rango de valores de lift que son consistentes con los datos observados. El lift real podría caer fuera de este rango, pero los valores dentro del intervalo son más consistentes con lo que midió el experimento. + +- Si el **intervalo completo está por encima de cero**, el resultado es estadísticamente significativo en la dirección positiva. Es poco probable que ocurra una mejora al menos tan grande si no hay un efecto real. +- Si el **intervalo completo está por debajo de cero**, el resultado es estadísticamente significativo en la dirección negativa. Es probable que el tratamiento haya reducido la métrica. +- Si el **intervalo cruza el cero**, el resultado no es estadísticamente significativo. El resultado es consistente con un efecto real de cero. + +Utilice el ancho del intervalo como indicador de precisión: un intervalo más estrecho significa una estimación más precisa del lift; un intervalo más amplio significa mayor incertidumbre, a menudo porque la muestra es más pequeña o la métrica es ruidosa. + +Si la [corrección de pruebas múltiples][8] está habilitada, los intervalos de confianza son más amplios porque Datadog controla la tasa de error familiar en todas las comparaciones de métricas y variantes de tratamiento del experimento. + +### Lift global {#global-lift} + +Los experimentos generalmente inscriben solo a un subconjunto de usuarios elegibles. Cambie a la {{< ui >}}Global lift{{< /ui >}} pestaña en el cuadro de mando de métricas para estimar cómo afectaría a los totales generales de sus métricas el implementar el tratamiento a todos los usuarios elegibles. Consulte [Lift global][7] para conocer la metodología completa. + +{{< img src="/product_analytics/experiment/exp_reading_global_lift.png" alt="La pestaña de Lift global del cuadro de mando del experimento que muestra los valores promedio de las métricas de control y tratamiento, la cobertura y el lift global para cada métrica de decisión." style="width:90%;" >}} + +Para cada métrica, la {{< ui >}}Global lift{{< /ui >}} pestaña muestra: + +- **Valores de control y tratamiento**: El valor promedio de la métrica por sujeto en cada variante; los mismos valores que se muestran en la pestaña principal del cuadro de mando. +- **Cobertura**: La proporción estimada del total de su métrica global asociada con la población elegible del experimento (excluyendo el efecto del experimento). +- **Lift global**: El cambio estimado en los totales generales de sus métricas si el tratamiento se lanzara a todos los usuarios elegibles. Datadog calcula el lift global como el producto de la cobertura y el lift local (relativo) del experimento. + +## Exploración de resultados {#exploring-results} + +Desde el cuadro de mando de métricas, pase el cursor sobre el nombre de una métrica para visualizar las opciones de exploración. Las opciones disponibles dependen de la fuente de su métrica. + +### Gráfico {#chart} + +Haga clic en {{< ui >}}Chart{{< /ui >}} en cualquier métrica para abrir una visualización interactiva de cómo se desempeñó una métrica durante el experimento. Dentro del gráfico, usted puede: + +- **Dividir por propiedades de segmentación**: Compare el lift entre cohortes como el tipo de dispositivo o el nivel de usuario. Las propiedades reflejan los atributos del sujeto en el momento inicial de la exposición. +- **Evolución del lift a lo largo del tiempo**: Vea cómo evolucionan las tendencias del lift durante el experimento, graficadas por fecha de calendario o por días desde la primera exposición de cada sujeto al experimento. +- **Agregar filtros**: limite el gráfico a un subconjunto específico de sujetos. +- **Cambie tipos de lift**: Alterne entre lift relativo y lift absoluto (Tratamiento − Control). + +El siguiente ejemplo muestra un desglose a nivel de segmento por país. Utilice esta vista para comprender cuándo ciertos grupos reaccionaron de manera diferente a la nueva experiencia. + +{{< img src="/product_analytics/experiment/exp_segment_view.png" alt="Vista a nivel de segmento de una métrica dividida por código ISO de país, que muestra un gráfico de barras de lift relativo y una tabla con valores de control y tratamiento por país." style="width:90%;" >}} + +### Copiar SQL {#copy-sql} + +Para [métricas nativas de almacén][3], haga clic en {{< ui >}}Copy SQL{{< /ui >}} para copiar una versión simplificada de la lógica de canalización que Datadog utilizó para calcular el resultado. Pegue la consulta en su almacén para auditar el resultado o realizar un análisis de seguimiento. + +{{< img src="/product_analytics/experiment/exposure-sql/copy-sql.png" alt="La página de resultados del experimento con el botón Copiar SQL resaltado en una métrica de almacén." style="width:90%;" >}} + +### Reproducciones{#replays} + +Para métricas basadas en datos de [RUM][4] o [Product Analytics][5], haga clic en {{< ui >}}Replays{{< /ui >}} para ver las [reproducciones de sesión][6] de los usuarios inscritos en el experimento. Revise cómo los sujetos de cada variante experimentaron el producto. + +## Lecturas adicionales {#further-reading} +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/experiments/plan_and_launch_experiments +[2]: /es/experiments/statistics/analysis_methods +[3]: /es/experiments/guide/connecting_a_data_warehouse/ +[4]: /es/real_user_monitoring/ +[5]: /es/product_analytics/ +[6]: /es/session_replay/ +[7]: /es/experiments/global_lift/ +[8]: /es/experiments/statistics/multiple_testing_correction +[9]: /es/experiments/diagnostics/ \ No newline at end of file diff --git a/hugo/content/es/feature_flags/client/flutter.md b/hugo/content/es/feature_flags/client/flutter.md new file mode 100644 index 00000000000..6dabedba780 --- /dev/null +++ b/hugo/content/es/feature_flags/client/flutter.md @@ -0,0 +1,492 @@ +--- +description: Configure Datadog Feature Flags para aplicaciones Dart y Flutter. +further_reading: +- link: /feature_flags/client/ + tag: Documentación + text: Feature Flags del lado del cliente +- link: /real_user_monitoring/application_monitoring/flutter/ + tag: Documentación + text: Monitoreo de Flutter +- link: https://github.com/DataDog/dd-sdk-flutter/tree/develop/packages/datadog_flags + tag: Código fuente + text: código fuente de datadog_flags +- link: https://github.com/DataDog/dd-sdk-flutter/tree/develop/packages/datadog_flags_flutter + tag: Código fuente + text: código fuente de datadog_flags_flutter +title: Feature Flags para Dart y Flutter +--- +## Descripción general {#overview} + +Esta página describe cómo instrumentar aplicaciones Dart y Flutter con el SDK de Feature Flags de Datadog. Los Feature Flags de Datadog proporcionan una forma unificada de controlar de forma remota la disponibilidad de funciones en su aplicación y experimentar de forma segura. + +El SDK de Feature Flags de Datadog para Dart es un paquete nativo de Dart. Obtiene asignaciones precalculadas de Datadog, evalúa localmente los valores tipados de los Feature Flags, e informa la telemetría de evaluación de los Feature Flags a Datadog. Las aplicaciones Flutter pueden usar el paquete Dart independiente directamente o instalar `datadog_flags_flutter` para derivar la configuración de `datadog_flutter_plugin` y agregar evaluaciones exitosas a RUM. + +
Este paquete proporciona una API compatible con OpenFeature para Dart y Flutter, pero no está construido sobre el SDK de OpenFeature para Dart. Utilice las API de esta página directamente. Datadog está desarrollando una integración basada en proveedores de OpenFeature para Dart y Flutter.
+ +## Instalación {#installation} + +Para una aplicación Flutter que ya utiliza el SDK de Flutter de Datadog, instale `datadog_flags_flutter`: + +{{< code-block lang="bash" >}} +flutter pub add datadog_flags_flutter +{{< /code-block >}} + +`datadog_flags_flutter` depende de `datadog_flutter_plugin` 3.4.0 o posterior. + +Para uso independiente en Dart, instale `datadog_flags`: + +{{< tabs >}} +{{% tab "Dart" %}} +{{< code-block lang="bash" >}} +dart pub add datadog_flags +{{< /code-block >}} +{{% /tab %}} + +{{% tab "Flutter" %}} +{{< code-block lang="bash" >}} +flutter pub add datadog_flags +{{< /code-block >}} +{{% /tab %}} +{{< /tabs >}} + +Luego importe la API pública: + +{{< tabs >}} +{{% tab "Dart" %}} +{{< code-block lang="dart" >}} +import 'package:datadog_flags/datadog_flags.dart'; +{{< /code-block >}} +{{% /tab %}} + +{{% tab "Integración con Flutter" %}} +{{< code-block lang="dart" >}} +import 'package:datadog_flags_flutter/datadog_flags_flutter.dart'; +import 'package:datadog_flutter_plugin/datadog_flutter_plugin.dart'; +{{< /code-block >}} +{{% /tab %}} +{{< /tabs >}} + +## Configuración integrada con Flutter {#flutter-integrated-setup} + +Utilice esta configuración cuando su aplicación Flutter ya inicialice `datadog_flutter_plugin`. Agregue `DatadogFlagsPluginConfiguration` a su `DatadogConfiguration` existente antes de inicializar el SDK de Datadog. El plugin deriva el token de cliente, el entorno, el sitio, el servicio, la versión y el ID de la aplicación RUM de la configuración del SDK de Flutter. Para crear un token de cliente, consulte [Client tokens][1]. + +{{< site-region region="gov,gov2" >}}
Los Flutter Feature Flags no son compatibles con el sitio de Datadog seleccionado ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} + +{{< code-block lang="dart" >}} +import 'package:datadog_flags_flutter/datadog_flags_flutter.dart'; +import 'package:datadog_flutter_plugin/datadog_flutter_plugin.dart'; + +final configuration = DatadogConfiguration( + clientToken: '', + env: '', + site: DatadogSite.{{< region-param key="dd_site_name" code="true" >}}, + service: '', + version: '', + rumConfiguration: DatadogRumConfiguration( + applicationId: '', + ), +)..addPlugin( + const DatadogFlagsPluginConfiguration( + flagsConfiguration: DatadogFlagsConfiguration( + initializationTimeout: Duration(seconds: 2), + ), + ), + ); + +await DatadogSdk.instance.initialize(configuration, TrackingConsent.granted); +{{< /code-block >}} + +Después de la inicialización, recupere un cliente de Feature Flags del plugin e inicialícelo con el contexto de evaluación para el sujeto actual: + +{{< code-block lang="dart" >}} +final flags = DatadogSdk.instance.flags; +if (flags == null) { + return; +} + +final flagsClient = flags.sharedClient(); +try { + await flagsClient.initialize( + const FlagsEvaluationContext( + targetingKey: 'user-123', + attributes: { + 'companyId': 'company-456', + 'plan': 'enterprise', + }, + ), + ); +} on FlagsInitializationTimeoutException { + // Continue startup with stored assignments or evaluation defaults. +} +{{< /code-block >}} + +Las evaluaciones exitosas se envían a través de la canalización de telemetría de Datadog Feature Flags. Con la configuración integrada de Flutter, las evaluaciones exitosas que devuelven una variante también se agregan al visualizar RUM activo como evaluaciones de Feature Flags. + +## Configuración independiente de Dart {#standalone-dart-setup} + +Utilice esta configuración cuando no esté utilizando `datadog_flutter_plugin`, o cuando desee gestionar los Feature Flags independientemente de la inicialización del SDK de Flutter. + +Habilite Datadog Feature Flags temprano en el inicio de su aplicación. Para la configuración en vivo de los Feature Flags, se requieren `clientToken`, `env` y `site`. Para crear un token de cliente, consulte [Client tokens][1]. + +{{< site-region region="gov,gov2" >}}
Los Dart and Flutter Feature Flags no son compatibles con el sitio de Datadog seleccionado ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} + +{{< code-block lang="dart" >}} +final datadogFlags = DatadogFlags.instance; + +await datadogFlags.enable( + configuration: DatadogFlagsConfiguration( + initializationTimeout: const Duration(seconds: 2), + datadogConfig: const DatadogFlagsConfig( + clientToken: '', + env: '', + site: DatadogFlagsSite.{{< region-param key="dd_datacenter_lowercase" code="true" >}}, + applicationId: '', + service: '', + version: '', + ), + ), +); +{{< /code-block >}} + +`applicationId`, `service` y `version` son opcionales. Cuando están presentes, el SDK los incluye en el contexto de telemetría de los Feature Flags. + +Utilice el valor `DatadogFlagsSite` que coincida con su organización de Datadog. + +## Crear y recuperar un cliente {#create-and-retrieve-a-client} + +Cree o recupere un cliente compartido una vez durante el inicio de la aplicación: + +{{< code-block lang="dart" >}} +final flagsClient = DatadogFlags.instance.sharedClient(); +{{< /code-block >}} + +También puede crear múltiples clientes con nombre para contextos de evaluación independientes: + +{{< code-block lang="dart" >}} +final orgFlags = DatadogFlags.instance.sharedClient(name: 'org'); +final userFlags = DatadogFlags.instance.sharedClient(name: 'user'); +{{< /code-block >}} + +Los clientes son locales al aislamiento de Dart donde se crean. Los aislamientos en segundo plano no comparten el estado de `DatadogFlags` ni las cachés de asignación con el aislamiento principal. Si un aislamiento en segundo plano necesita evaluar Feature Flags, llame a `DatadogFlags.instance.enable()`, cree los clientes que necesite e inicialícelos de forma independiente. + +## Establezca el contexto de evaluación {#set-the-evaluation-context} + +Defina a quién o a qué se aplica la evaluación del Feature Flag mediante `FlagsEvaluationContext`. El contexto de evaluación incluye información del usuario, la organización, la sesión o el dispositivo utilizada para determinar qué variaciones de los Feature Flags deben devolverse. Llame a `initialize()` antes de evaluar los Feature Flags para que el cliente pueda obtener las asignaciones para el contexto. + +
Datadog Feature Flags requiere que los atributos del contexto de evaluación sean valores primitivos planos: cadenas, números y booleanos. No pase objetos o arreglos anidados; no son compatibles y pueden causar que los datos de exposición se descarten.
+ +{{< code-block lang="dart" >}} +await flagsClient.initialize( + const FlagsEvaluationContext( + targetingKey: 'user-123', + attributes: { + 'companyId': 'company-456', + 'plan': 'enterprise', + 'loggedIn': true, + }, + ), +); +{{< /code-block >}} + +El `targetingKey` es el sujeto de aleatorización para los despliegues porcentuales. Los usuarios con la misma clave de segmentación siempre reciben la misma variante para un Feature Flag dado. + +`targetingKey` es opcional. Si inicializa un contexto antes de que se conozca un ID de usuario u organización, el SDK envía una cadena vacía para la solicitud de asignación de precomputación. + +Utilice clientes con nombre independientes para sujetos de evaluación separados, como usuarios que han cerrado sesión y usuarios que han iniciado sesión, o segmentación a nivel de organización y a nivel de usuario: + +{{< code-block lang="dart" >}} +await orgFlags.initialize( + const FlagsEvaluationContext(targetingKey: 'org-123'), +); + +await userFlags.initialize( + const FlagsEvaluationContext(targetingKey: 'user-456'), +); +{{< /code-block >}} + +## Evalúe marcadores {#evaluate-flags} + +Después de inicializar un cliente, puede leer los valores de los Feature Flags en toda su aplicación. La evaluación de Feature Flags es _local e instantánea_ porque el SDK utiliza datos de asignación almacenados en caché localmente. No se produce ninguna solicitud de red durante una evaluación tipada. + +Cada método de evaluación requiere un valor predeterminado proporcionado por el llamador. Los métodos de evaluación no generan errores por la preparación del proveedor, por la ausencia de Feature Flags o discrepancias de tipo. Devuelven un valor `FlagDetails` con el valor evaluado, los metadatos de asignación y un error programático cuando el SDK devuelve el valor predeterminado. + +### Marcadores booleanos {#boolean-flags} + +Utilice `getBooleanDetails()` para Feature Flags que representen condiciones de encendido/apagado o verdadero/falso: + +{{< code-block lang="dart" >}} +final details = flagsClient.getBooleanDetails( + key: 'checkout.enabled', + defaultValue: false, +); + +if (details.error == null && details.value) { + showNewCheckoutFlow(); +} else { + showLegacyCheckout(); +} +{{< /code-block >}} + +### Marcadores de cadena {#string-flags} + +Utilice `getStringDetails()` para Feature Flags que seleccionen entre múltiples variantes o cadenas de configuración: + +{{< code-block lang="dart" >}} +final details = flagsClient.getStringDetails( + key: 'ui.theme', + defaultValue: 'light', +); + +if (details.value == 'dark') { + setDarkTheme(); +} else { + setLightTheme(); +} +{{< /code-block >}} + +### Marcadores de tipo entero y doble{#integer-and-double-flags} + +Utilice `getIntegerDetails()` o `getDoubleDetails()` para Feature Flags numéricos, como límites, porcentajes o multiplicadores: + +{{< code-block lang="dart" >}} +final maxItems = flagsClient.getIntegerDetails( + key: 'cart.items.max', + defaultValue: 20, +); + +final priceMultiplier = flagsClient.getDoubleDetails( + key: 'pricing.multiplier', + defaultValue: 1.0, +); +{{< /code-block >}} + +### Marcadores de objeto {#object-flags} + +Utilice `getObjectDetails()` para una configuración estructurada compatible con JSON: + +{{< code-block lang="dart" >}} +final config = flagsClient.getObjectDetails( + key: 'ui.config', + defaultValue: const { + 'color': '#00A3FF', + 'fontSize': 14, + }, +); +{{< /code-block >}} + +### Detalles de evaluación de marcadores {#flag-evaluation-details} + +Utilice las API de detalles cuando necesite el valor evaluado, la variante, el motivo o el error de evaluación: + +{{< code-block lang="dart" >}} +final details = flagsClient.getStringDetails( + key: 'checkout.copy', + defaultValue: 'Continue', +); + +print(details.value); +print(details.variant); +print(details.reason); +print(details.error?.code); +{{< /code-block >}} + +`FlagDetails.error` se establece cuando el SDK devuelve el valor predeterminado porque el proveedor no está listo, el Feature Flag no se encuentra o el valor de asignación no coincide con el método de evaluación tipado. Los detalles exitosos incluyen el valor evaluado más los metadatos de asignación, como `variant` y `reason`, cuando Datadog los devolvió. + +## Configuración avanzada {#advanced-configuration} + +`DatadogFlagsConfiguration` controla el comportamiento del SDK: + +{{< code-block lang="dart" >}} +DatadogFlagsConfiguration( + datadogConfig: datadogConfig, + initializationTimeout: const Duration(seconds: 2), + trackExposures: true, + trackEvaluations: true, + evaluationFlushInterval: const Duration(seconds: 10), + store: myStore, +); +{{< /code-block >}} + +`trackExposures` +: Cuando `true` (predeterminado), el SDK registra eventos de exposición para evaluaciones exitosas cuyas asignaciones están marcadas para registro. Establezca en `false` para deshabilitar el seguimiento de exposición. + +`trackEvaluations` +: Cuando `true` (predeterminado), el SDK registra la telemetría de evaluación de Feature Flags agregada. Establezca en `false` para deshabilitar el seguimiento de evaluación. + +`initializationTimeout` +: Tiempo máximo de espera para que el primer contexto de evaluación esté listo. El tiempo de espera utiliza un presupuesto de reloj de pared para la operación de inicialización completa. Cubre la carga de asignaciones almacenadas, la codificación de la solicitud, la obtención de asignaciones, la lectura del cuerpo de la respuesta, la decodificación de JSON, la publicación de asignaciones y el almacenamiento de asignaciones. No cambia el tiempo de espera del cliente HTTP. + +
El tiempo de espera se aplica solo a la primera llamada `initialize()` para cada cliente. La primera llamada consume el tiempo de espera incluso si la operación falla o es reemplazada. Las llamadas posteriores no tienen temporizador de inicialización. El valor predeterminado es 5 segundos. Establezca el valor en `null`, cero o una duración negativa para desactivar el tiempo de espera. + + Cuando el tiempo de espera expira, `initialize()` lanza `FlagsInitializationTimeoutException`. La operación de asignación continúa y puede publicar un resultado exitoso tardío. Las asignaciones almacenadas coincidentes permanecen disponibles. Las evaluaciones sin asignaciones devuelven el valor predeterminado proporcionado por el llamador con `FlagEvaluationError.providerNotReady`. + + Dart ejecuta el temporizador de tiempo de espera en el mismo aislado que el trabajo de inicialización sincrónica. Por lo tanto, el trabajo sincrónico puede hacer que la espera observada sea más larga que el tiempo de espera configurado. + +
initializationTimeout está disponible en datadog_flags y datadog_flags_flutter 1.1.0 y versiones posteriores.
+ +`evaluationFlushInterval` +: El intervalo en el que se envía la telemetría de evaluación de Feature Flags agregada a Datadog. Los valores aceptados están entre 1 y 60 segundos. El valor predeterminado es 10 segundos. + +`store` +: Almacenamiento opcional de la última asignación conocida. El SDK puede usar asignaciones almacenadas coincidentes mientras una solicitud de red nueva está en curso o no está disponible. + +`httpClient`, `customFlagsEndpoint`, `customExposureEndpoint`, y `customEvaluationEndpoint` +: Anulaciones avanzadas para pruebas, proxies o enrutamiento personalizado. + +
Si se llama a `enable()` sin un `datadogConfig`, el SDK no crea un proveedor activo. Las evaluaciones devuelven el valor predeterminado proporcionado por el llamador con `FlagEvaluationError.providerNotReady`. + + Para una configuración integrada con Flutter, pase estas opciones a través de `DatadogFlagsPluginConfiguration`: + + {{< code-block lang="dart" >}} + final configuration = DatadogConfiguration( + clientToken: '', + env: '', + site: DatadogSite.{{< region-param key="dd_site_name" code="true" >}}, + rumConfiguration: DatadogRumConfiguration( + applicationId: '', + ), + )..addPlugin( + const DatadogFlagsPluginConfiguration( + flagsConfiguration: DatadogFlagsConfiguration( + initializationTimeout: Duration(seconds: 2), + trackExposures: true, + trackEvaluations: true, + ), + rumIntegrationEnabled: true, + ), + ); + {{< /code-block >}} + +`rumIntegrationEnabled` +: Cuando `true` (predeterminado), las evaluaciones exitosas que devuelven una variante se agregan al visualizar RUM activo como evaluaciones de Feature Flags. Si su aplicación no utiliza RUM, esta opción no tiene efecto. + +## Almacenamiento de la última asignación conocida {#last-known-assignment-storage} + +El SDK mantiene las asignaciones en memoria después de que `initialize()` tenga éxito. Para restaurar las últimas asignaciones conocidas entre instancias del SDK, proporcione un `DatadogFlagsStore`: + +{{< code-block lang="dart" >}} +class MyFlagsStore implements DatadogFlagsStore { + @override + Future read(String clientName) async { + // Read and decode persisted FlagsData for this client name. + return null; + } + + @override + Future write(String clientName, FlagsData data) async { + // Encode and persist successful assignments for this client name. + } + + @override + Future delete(String clientName) async { + // Delete persisted assignments for this client name. + } +} +{{< /code-block >}} + +Las asignaciones almacenadas se utilizan solo cuando su contexto de evaluación coincide con el contexto activo. Una obtención exitosa en vivo siempre mueve al cliente al estado de asignación más reciente y escribe ese estado de nuevo en el almacenamiento. + +El paquete Dart no elige una ubicación en disco ni incluye un almacenamiento en disco específico para Flutter. Las aplicaciones de Flutter pueden implementar `DatadogFlagsStore` con su mecanismo de almacenamiento de aplicaciones preferido. + +## Apagado {#shutdown} + +Llame a `shutdown()` cuando ya no necesite un cliente. Esto vacía las cargas pendientes de exposición y evaluación de flags antes de borrar las asignaciones en memoria del cliente. + +{{< code-block lang="dart" >}} +await flagsClient.shutdown(); +{{< /code-block >}} + +Llame a `DatadogFlags.instance.disable()` cuando la aplicación esté cerrando el SDK de flags: + +{{< code-block lang="dart" >}} +await DatadogFlags.instance.disable(); +{{< /code-block >}} + +## Ejemplo completo {#complete-example} + +El siguiente ejemplo habilita el SDK, inicializa un cliente con un contexto de evaluación y evalúa un flag booleano: + +{{< code-block lang="dart" >}} +import 'package:datadog_flags/datadog_flags.dart'; + +Future initializeFlags() async { + final datadogFlags = DatadogFlags.instance; + + await datadogFlags.enable( + configuration: DatadogFlagsConfiguration( + initializationTimeout: const Duration(seconds: 2), + datadogConfig: const DatadogFlagsConfig( + clientToken: '', + env: '', + site: DatadogFlagsSite.{{< region-param key="dd_datacenter_lowercase" code="true" >}}, + applicationId: '', + service: '', + version: '', + ), + ), + ); + + final flagsClient = datadogFlags.sharedClient(); + try { + await flagsClient.initialize( + const FlagsEvaluationContext( + targetingKey: 'user-123', + attributes: { + 'companyId': 'company-456', + 'plan': 'enterprise', + }, + ), + ); + } on FlagsInitializationTimeoutException { + // Continue startup with stored assignments or evaluation defaults. + } + + final details = flagsClient.getBooleanDetails( + key: 'checkout.enabled', + defaultValue: false, + ); + + if (details.error == null && details.value) { + showNewCheckoutFlow(); + } +} +{{< /code-block >}} + +## Pruebas {#testing} + +Puede realizar pruebas en un entorno de prueba dedicado de Datadog con el `DatadogFlagsClient` real, o aislar el código de la aplicación detrás de una interfaz pequeña y sustituir una implementación falsa en las pruebas unitarias. Esta sección muestra el enfoque simulado, que mantiene las pruebas autocontenidas y sin conexión. + +{{< code-block lang="dart" >}} +abstract interface class CheckoutFlags { + bool newCheckoutEnabled(); +} + +final class DatadogCheckoutFlags implements CheckoutFlags { + final DatadogFlagsClient client; + + DatadogCheckoutFlags(this.client); + + @override + bool newCheckoutEnabled() { + return client + .getBooleanDetails( + key: 'checkout.enabled', + defaultValue: false, + ) + .value; + } +} + +final class TestCheckoutFlags implements CheckoutFlags { + @override + bool newCheckoutEnabled() => true; +} +{{< /code-block >}} + +Luego, inyecte `TestCheckoutFlags` en las pruebas unitarias y `DatadogCheckoutFlags` en producción. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/account_management/api-app-keys/#client-tokens \ No newline at end of file diff --git a/hugo/content/es/getting_started/application/_index.md b/hugo/content/es/getting_started/application/_index.md index 19b6d8c97b3..30594b70e10 100644 --- a/hugo/content/es/getting_started/application/_index.md +++ b/hugo/content/es/getting_started/application/_index.md @@ -1,155 +1,154 @@ --- -description: Información general de la navegación por la interfaz de usuario de Datadog, - características clave como dashboards, monitores, integraciones y capacidades básicas - de la plataforma. +description: Descripción general de la navegación de la interfaz de usuario de Datadog, + características clave que incluyen tableros, monitores, integraciones y capacidades + principales de la plataforma. further_reading: - link: https://learn.datadoghq.com/bundles/frontend-engineer-learning-path tag: Centro de aprendizaje - text: Ruta de aprendizaje del ingeniero de frontend + text: Ruta de aprendizaje para ingenieros frontend - link: https://learn.datadoghq.com/bundles/backend-engineer-learning-path tag: Centro de aprendizaje - text: Trayectoria de aprendizaje del ingeniero de backend + text: Ruta de aprendizaje para ingenieros backend - link: https://learn.datadoghq.com/bundles/site-reliability-engineer-learning-path tag: Centro de aprendizaje - text: Ruta de aprendizaje del ingeniero de fiabilidad del sitio + text: Ruta de aprendizaje para ingenieros de confiabilidad de sitios (SRE) - link: https://dtdg.co/fe - tag: Habilitación de los fundamentos - text: Participa en una sesión interactiva para construir una base sólida de Datadog + tag: Foundation Enablement + text: Únase a una sesión interactiva para construir una base sólida de Datadog - link: https://www.datadoghq.com/blog/datadog-quick-nav-menu/ tag: Blog text: Introducción al menú de navegación rápida de Datadog -title: Empezando en Datadog +title: Primeros pasos en Datadog --- - -{{< learning-center-callout header="Prueba Datadog Core Skills en el centro de aprendizaje" btn_title="Inscríbete ahora" btn_url="https://learn.datadoghq.com/bundles/core-skills-learning-path">}} - Aprende sin coste alguno con capacidad real de computación en la nube y una cuenta de prueba de Datadog. Inicia estos laboratorios prácticos para ponerte al día con el etiquetado, las métricas, los monitores y los dashboards. +{{< learning-center-callout header="Pruebe las habilidades principales de Datadog en el Centro de aprendizaje" btn_title="Inscríbase ahora" btn_url="https://learn.datadoghq.com/bundles/core-skills-learning-path">}} + Aprenda sin costo en capacidad de cómputo en la nube real y una cuenta de prueba de Datadog. Inicie estos laboratorios prácticos para ponerse al día con el etiquetado, las métricas, los monitores y los tableros. {{< /learning-center-callout >}} -## Información general +## Descripción general {#overview} -Esta página ofrece información general de alto nivel sobre las funciones disponibles en el [sitio de Datadog][1]. +Esta página proporciona una descripción general de alto nivel de las capacidades disponibles en el [sitio de Datadog][1].
- La navegación del sitio de Datadog varía según el ancho de tu navegador. Puedes tener hasta tres tipos de navegación. Para cambiar el tipo de navegación, ajusta el ancho de tu navegador. + La navegación del sitio de Datadog varía según el ancho de su navegador. Puede tener hasta tres tipos de navegación. Para cambiar el tipo de navegación, ajuste el ancho de su navegador.

- Puedes presionar Cmd/Ctrl + K para buscar páginas y entidades, como dashboards y monitores, en todo Datadog. + Puede presionar Cmd/Ctrl + K para buscar páginas y entidades, como tableros y monitores, en todo Datadog.
-## infraestructura +## Infraestructura {#infrastructure} -La [lista de infraestructura][2] sirve como vista central de todos tus recursos de infraestructura (hosts, contenedores, procesos, etc.) y sus metadatos asociados. +La [lista de infraestructura][2] sirve como una vista central de todos sus recursos de infraestructura (servidores, contenedores, procesos, etc.) y sus metadatos asociados. **Capacidades clave:** -- Investiga el rendimiento de las infraestructuras. -- Ordena, filtra y visualiza hosts en función de etiquetas y métricas. -- Inspecciona los hosts para revisar sus etiquetas, rendimiento, estado, etc. +- Investigue el rendimiento de la infraestructura. +- Organice, filtre y visualice servidores según etiquetas y métricas. +- Inspeccione los servidores para revisar sus etiquetas, rendimiento, estado y más. -Ve a [**Infrastructure > Hosts**][3] (Infraestructura > Hosts) en la aplicación para empezar. Para obtener más información, lee la [documentación de la Lista de infraestructuras][2]. +Navegue a [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Hosts{{< /ui >}}][3] en la aplicación para comenzar. Para obtener más información, lea la [documentación de la Lista de infraestructura][2]. -## Mapas de hosts y contenedores +## Mapas de servidores y contenedores {#host-and-container-maps} -{{< img src="getting_started/application/host_map_2025.png" alt="Información general del mapa de hosts agrupada por zona de disponibilidad." >}} +{{< img src="getting_started/application/host_map_2025.png" alt="Descripción general del mapa de servidores agrupados por zona de disponibilidad." >}} -Los [mapas de hosts y contenedores][4] te ofrecen una visión general de todos tus hosts y contenedores, codificados por colores según métricas clave como el uso de la CPU, para que puedas detectar los problemas. +Los [Mapas de servidores y contenedores][4] le brindan una descripción general visual de todos sus servidores y contenedores, codificándolos por colores según métricas clave como el uso de CPU para que pueda detectar problemas. **Capacidades clave**: -- Ve toda tu infraestructura a la vez en un mapa visual. -- Codifica por colores según diversas métricas para detectar problemas de rendimiento, y filtra y agrupa por etiquetas y metadatos. -- Analiza en detalle hosts o contenedores individuales para solucionar problemas. +- Visualice toda su infraestructura a la vez como un mapa visual. +- Codifique por colores mediante una variedad de métricas para ayudarle a detectar problemas de rendimiento, y filtre y agrupe por etiquetas y metadatos. +- Profundice en servidores o contenedores individuales para solucionar problemas. -Ve a [**Infrastructure > Host Map**][5] (Infraestructura > Mapa de hosts) en la aplicación para empezar. Para obtener más información, lee la [documentación de Mapas de hosts y contenedores][4]. +Navegue a [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Host Map{{< /ui >}}][5] en la aplicación para comenzar. Para obtener más información, lea la [documentación de Mapas de servidores y contenedores][4]. -## Gestión de Logs +## Log Management {#log-management} -[Datadog Log Management][6] te permite enviar y procesar cada log producido por tus aplicaciones e infraestructura. Puedes observar tus logs en tiempo real utilizando [Live Tail][7], sin indexarlos. +[Datadog Log Management][6] le permite enviar y procesar cada registro producido por sus aplicaciones e infraestructura. Puede observar sus registros en tiempo real utilizando [Live Tail][7], sin indexarlos. **Capacidades clave**: -- Recopila automáticamente logs de todos los servicios, aplicaciones y plataformas. -- Ve y busca logs en tiempo real y filtra por elementos como servicio, host y tipo de error. -- Elige qué logs conservar y durante cuánto tiempo, reduciendo así los costes de almacenamiento. +- Recopile automáticamente registros de todos los servicios, aplicaciones y plataformas. +- Visualice y busque registros en tiempo real y filtre por elementos como servicio, servidor y tipo de error. +- Elija qué registros conservar y por cuánto tiempo, reduciendo los costos de almacenamiento. -Navega hasta [Logs][8] en la aplicación para empezar. Para obtener más información, consulta la [documentación de Log Management][6]. +Navegue a [{{< ui >}}Logs{{< /ui >}}][8] en la aplicación para comenzar. Para obtener más información, lea la [documentación de Log Management][6]. -## APM +## APM {#apm} -[Datadog Application Performance Monitoring][9] (APM o rastreo) te proporciona una visión profunda del rendimiento de tu aplicación junto con tus logs y la monitorización de la infraestructura. +[Datadog Application Performance Monitoring][9] (APM o trazas) le brinda una visión profunda del rendimiento de su aplicación junto con sus registros y seguimiento de infraestructura. **Capacidades clave**: -- Rastrea las solicitudes a una aplicación de extremo a extremo a través de un sistema distribuido. -- Ve los cuellos de botella de rendimiento visualizando el tiempo empleado en cada paso de la solicitud. -- Visualiza las dependencias de los servicios y los flujos de datos con el mapa de servicios. -- Correlaciona las trazas con los correspondientes logs, métricas y sesiones de usuario para obtener un contexto completo. +- Rastree las solicitudes a una aplicación de principio a fin a través de un sistema distribuido. +- Vea los cuellos de botella de rendimiento visualizando el tiempo dedicado a cada paso de la solicitud. +- Visualice las dependencias del servicio y los flujos de datos con el Service Map. +- Correlacione las trazas con los registros, métricas y sesiones de usuario correspondientes para obtener contexto de pila completa. -Navega hasta [APM][10] en la aplicación para empezar. Para obtener más información, lee la [documentación de APM][9]. +Navegue a [{{< ui >}}APM{{< /ui >}}][10] en la aplicación para comenzar. Para obtener más información, lea la [documentación de APM][9]. -## RUM y Session Replay +## RUM y Session Replay {#rum-session-replay} -Datadog [Real User Monitoring][11] (RUM) te permite visualizar y analizar en tiempo real las actividades y experiencias de los usuarios en aplicaciones web y móviles. Con [Session Replay][12], puedes capturar y visualizar sesiones de usuario para comprender mejor su comportamiento. +[Real User Monitoring][11] (RUM) de Datadog le permite visualizar y analizar las actividades y experiencias de los usuarios en tiempo real en aplicaciones web y móviles. Con [Session Replay][12], puede capturar y visualizar las sesiones de los usuarios para comprender mejor su comportamiento. **Capacidades clave**: -- Monitoriza el rendimiento de los navegadores web y plataformas móviles (iOS, Android, React Native, Flutter, etc.) con Core Web Vitals y Mobile Vitals. -- Realiza un seguimiento de los errores y resuélvelos con agrupaciones automatizadas, informes de fallos e identificación de confirmaciones sospechosas. -- Detecta señales de frustración del usuario, como clics repetidos y clics de error, para identificar problemas de UX. -- Monitoriza el rendimiento y adopción de los indicadores de características. -- Correlaciona los problemas del frontend con las trazas de backend, logs y las métricas de infraestructura para obtener una visibilidad completa. +- Haga un seguimiento del rendimiento en navegadores web y plataformas móviles (iOS, Android, React Native, Flutter y más) con Core Web Vitals y Mobile Vitals. +- Haga un seguimiento y solucione errores con agrupación automatizada, informes de fallos e identificación de confirmaciones sospechosas. +- Detecte señales de frustración del usuario, como clics de enojo y clics de error, para identificar problemas de UX. +- Haga un seguimiento del rendimiento y la adopción de los indicadores de funciones (feature flags). +- Correlacione problemas de frontend con trazas de backend, registros y métricas de infraestructura para obtener visibilidad de toda la pila. -Navega hasta el [RUM Explorer][13] en la aplicación para empezar. Para obtener más información, lee la [documentación de RUM][11]. +Navegue a [{{< ui >}}RUM explorer{{< /ui >}}][13] en la aplicación para comenzar. Para obtener más información, lea la [documentación de RUM][11]. -## Synthetic Monitoring +## Synthetic Monitoring {#synthetic-monitoring} -Datadog [Synthetic Monitoring][14] te permite crear y ejecutar tests de API, navegador, móvil y Network Path que monitorizan de forma proactiva solicitudes y acciones simuladas de todo el mundo. Estos tests monitorizan tus aplicaciones y APIs para detectar problemas de rendimiento y tiempos de inactividad antes de que afecten a los usuarios. +Datadog [Synthetic Monitoring][14] le permite crear y ejecutar pruebas de API, navegador, móviles y de Network Path que hacen un seguimiento de forma proactiva de solicitudes y acciones simuladas desde todo el mundo. Estas pruebas hacen un seguimiento de sus aplicaciones y APIs para detectar problemas de rendimiento y tiempo de inactividad antes de que afecten a los usuarios. **Capacidades clave**: -- Testea endpoints de la API críticos para la empresa y recorridos del usuario. -- Detecta errores, identifica regresiones y automatiza las reversiones para evitar que surjan problemas en la producción. -- Detecta problemas de rendimiento de los usuarios en distintas ubicaciones y alerta sobre ellos. +- Pruebe puntos de conexión de API y recorridos de usuario críticos para el negocio. +- Detecte errores, identifique regresiones y automatice reversiones para evitar que los problemas surjan en producción. +- Encuentre y alerte sobre problemas de rendimiento para usuarios en diversas ubicaciones. -Ve a [Synthetic Monitoring & Testing][15] (Synthetic Monitoring y Tests) en la aplicación para empezar. Para obtener más información, lee la [documentación de Synthetic Monitoring][14]. +Navegue a [{{< ui >}}Synthetic Monitoring & Testing{{< /ui >}}][15] en la aplicación para comenzar. Para obtener más información, lea la [documentación de Synthetic Monitoring][14]. -## Integraciones +## Integrations {#integrations} -Utiliza las {{< translate key="integration_count" >}} [integraciones][16] de Datadog para reunir todas las métricas y logs de tu infraestructura y obtener información sobre todo tu sistema de observabilidad. +Utilice las integraciones de Datadog {{< translate key="integration_count" >}} [integrations][16] para reunir todas las métricas y registros de su infraestructura y obtener información sobre todo su sistema de observabilidad. -{{< img src="getting_started/application/integrations-2025.png" alt="Integraciones" >}} +{{< img src="getting_started/application/integrations-2025.png" alt="Integrations" >}} **Capacidades clave**: -- Las integraciones disponibles abarcan tecnologías en la nube, respuesta a incidentes, capas de datos, seguridad, IA y mucho más. -- Una vez configuradas las integraciones, todos los datos reciben el mismo tratamiento en Datadog, tanto si se encuentran en un centro de datos como en un servicio en línea. -- Construye tu propia integración utilizando la [documentación para desarrolladores][17]. +- Las integraciones disponibles cubren tecnologías en la nube, respuesta a incidentes, capas de datos, seguridad, IA y más. +- Una vez configuradas las integraciones, todos los datos se tratan de la misma manera en todo Datadog, ya sea que residan en un centro de datos o en un servicio en línea. +- Cree su propia integración utilizando la [documentación para desarrolladores][17]. -Ve a [Integraciones][18] en la aplicación para empezar, o consulta la lista de integraciones en la [documentación][19]. +Navegue a [{{< ui >}}Integrations{{< /ui >}}][18] en la aplicación para comenzar, o explore la lista de integraciones en la [documentación][19]. -## Dashboards +## Dashboards {#dashboards} -Los [dashboards][20] contienen gráficos con métricas de rendimiento en tiempo real, de manera que unifica tu visión de los datos a través de métricas, logs, trazas y más. +Los [Dashboards][20] contienen gráficos con métricas de rendimiento en tiempo real, lo que unifica su vista de datos a través de métricas, registros, trazas y más. **Capacidades clave**: -- Empieza con los dashboards predefinidos o crea los tuyos propios para adaptarlos a tus preguntas específicas. -- Personaliza los dashboards con widgets de arrastrar y soltar, consultas personalizadas y diseños flexibles. -- Combina varios tipos de datos (incluidas métricas, logs, APM y RUM) en un solo lugar y visualiza los datos en tiempo real. -- Anota tus gráficos con comentarios o eventos para el contexto de tu equipo. +- Comience con Dashboards preconfigurados o cree los suyos propios para responder a sus preguntas específicas. +- Personalice los Dashboards con widgets de arrastrar y soltar, consultas personalizadas y diseños flexibles. +- Combine varios tipos de datos (incluyendo métricas, registros, APM y RUM) en un solo lugar y visualice los datos en tiempo real. +- Anote sus gráficos con comentarios o eventos para proporcionar contexto a su equipo. -Navega hasta [Dashboard List][21] (Listas de dashboards) en la aplicación para empezar. Para obtener más información, lee la [Documentación sobre dashboards][20]. +Navegue a [{{< ui >}}Dashboard List{{< /ui >}}][21] en la aplicación para comenzar. Para obtener más información, lea la [documentación de Dashboards][20]. -## Monitores +## Monitores {#monitors} -Los [monitores][22] proporcionan alertas y notificaciones basadas en umbrales de métricas, disponibilidad de integración, endpoints de red, etc. +Los [Monitores][22] proporcionan alertas y notificaciones basadas en umbrales de métricas, disponibilidad de integración, puntos finales de red y más. -- Crea monitores utilizando cualquier métrica que informe a Datadog. -- Construye lógicas de alerta complejas utilizando múltiples condiciones de activación. -- Envía alertas a Slack, correo electrónico, PagerDuty y más, añadiendo`@` en los mensajes de alerta para dirigir las notificaciones a las personas adecuadas. -- Programa un horario de tiempos de inactividad para suprimir las notificaciones de caídas del sistema, mantenimiento fuera de línea, etc. +- Cree monitores utilizando cualquier métrica que se reporte a Datadog. +- Cree lógica de alertas compleja utilizando múltiples condiciones de activación. +- Envíe alertas a Slack, correo electrónico, PagerDuty y más, añadiendo `@` en los mensajes de alerta para dirigir las notificaciones a las personas adecuadas. +- Programe tiempos de inactividad para suprimir las notificaciones de apagados del sistema, mantenimiento sin conexión y más. -Navega hasta la [Monitors List][23] (Lista de monitores) de la aplicación para empezar. Para obtener más información, consulta la [documentación de monitores][22]. +Navegue a [{{< ui >}}Monitors List{{< /ui >}}][23] en la aplicación para comenzar. Para obtener más información, lea la [documentación de Monitors][22]. -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: https://app.datadoghq.com @@ -163,12 +162,12 @@ Navega hasta la [Monitors List][23] (Lista de monitores) de la aplicación para [9]: /es/tracing/ [10]: https://app.datadoghq.com/apm/home [11]: /es/real_user_monitoring/ -[12]: /es/real_user_monitoring/session_replay/browser/ +[12]: /es/session_replay/ [13]: https://app.datadoghq.com/rum/sessions [14]: /es/synthetics/ [15]: https://app.datadoghq.com/synthetics/tests [16]: https://www.datadoghq.com/product/platform/integrations/ -[17]: /es/developers/integrations/ +[17]: /es/extend/integrations/ [18]: https://app.datadoghq.com/integrations [19]: /es/integrations/ [20]: /es/dashboards/ diff --git a/hugo/content/es/getting_started/incident_management/_index.md b/hugo/content/es/getting_started/incident_management/_index.md index 4c52e791980..dd280815d41 100644 --- a/hugo/content/es/getting_started/incident_management/_index.md +++ b/hugo/content/es/getting_started/incident_management/_index.md @@ -1,206 +1,206 @@ --- +description: Realice un seguimiento y comunique los problemas desde la declaración + hasta la resolución con flujos de trabajo colaborativos, cronogramas y análisis + post mortem. further_reading: -- link: https://learn.datadoghq.com/courses/intro-to-incident-management +- link: https://learn.datadoghq.com/courses/getting-started-incident-management tag: Centro de aprendizaje - text: Introducción a la gestión de incidencias -- link: /service_management/incident_management/datadog_clipboard - tag: Documentación - text: Portapapeles de Datadog + text: Introducción a Incident Management - link: https://www.youtube.com/watch?v=QIambwILy_M - tag: Vídeo - text: Gestión de incidencias con Datadog + tag: Video + text: Datadog sobre Incident Management - link: /monitors/incident_management tag: Documentación - text: Gestión de incidencias + text: Incident Management - link: https://dtdg.co/fe - tag: Habilitación de los fundamentos - text: Participa en una sesión interactiva para mejorar su gestión de incidencias + tag: Foundation Enablement + text: Únase a una sesión interactiva para mejorar su Incident Management - link: https://www.datadoghq.com/blog/incident-response-with-datadog/ tag: Blog - text: Gestión de incidencias con Datadog -- link: /service_management/incident_management/incident_settings + text: Incident Management con Datadog +- link: /incident_response/incident_management/incident_settings tag: Documentación text: Reglas de notificación - link: /integrations/slack/?tab=slackapplicationus#using-datadog-incidents tag: Documentación - text: Integración de Slack en las incidencias + text: Integración de Slack con incidentes +- link: https://www.datadoghq.com/blog/mobile-incident-management-datadog/ + tag: Blog + text: Gestione y resuelva incidentes sobre la marcha con la aplicación móvil de + Datadog - link: https://www.datadoghq.com/blog/incident-postmortem-process-best-practices/ tag: Blog - text: Prácticas recomendadas para redactar informes retrospectivos de incidencias + text: Mejores prácticas para redactar análisis post mortem de incidentes - link: https://www.datadoghq.com/blog/how-datadog-manages-incidents/ tag: Blog - text: Cómo gestionamos las incidencias en Datadog -title: Empezando con la gestión de incidencias + text: Cómo gestionamos los incidentes en Datadog +title: Introducción a Incident Management --- +## Descripción general {#overview} -{{% site-region region="gov" %}} -
La gestión de incidencias no está disponible para el sitio de Datadog que has seleccionado ({{< region-param key="dd_site_name" >}}).
-{{% /site-region %}} - -## Información general +Datadog Incident Management sirve para realizar un seguimiento y comunicarse sobre un problema que ha identificado con sus métricas, trazas o registros. -La herramienta de gestión de incidencias de Datadog permite rastrear y establecer comunicaciones sobre cualquier problema que hayas identificado con tus métricas, trazas (traces) o logs. +Esta guía lo lleva a través del uso del sitio de Datadog para declarar un incidente, actualizar el incidente a medida que avanza la investigación y la remediación, y generar un análisis post mortem cuando el incidente se haya resuelto. El ejemplo asume que la [integración de Slack][1] está habilitada. -En esta guía, te enseñaremos a utilizar el sitio de Datadog para declarar una incidencia, actualizarla durante el proceso de investigación y solución, y generar un informe retrospectivo una vez resuelta. Ten en cuenta que el siguiente ejemplo presupone que se ha habilitado la [integración de Slack][1]. +## Recorrido de un incidente desde la detección del problema hasta la resolución {#walking-through-an-incident-from-issue-detection-to-resolution} -## Fases de una incidencia desde la detección del problema hasta su resolución +### Declaración de un incidente {#declaring-an-incident} -### Declarar una incidencia +**Escenario:** Un monitor está alertando sobre una gran cantidad de errores que pueden estar ralentizando varios servicios. No está claro si los clientes se están viendo afectados. -**Situación:** Un monitor alerta de un número elevado de errores que pueden estar ralentizando varios servicios. No está claro si esto afecta a los clientes. +Esta guía describe el uso del [Portapapeles de Datadog][2] para declarar un incidente. Al usar el Portapapeles, puede recopilar información de diferentes fuentes, como gráficos, monitores, paneles completos o [notebook][3]. Esto le ayuda a proporcionar la mayor cantidad de información posible al declarar un incidente. -Esta guía explica cómo utilizar el [Clipboard de Datadog][2] para declarar una incidencia. El Clipboard permite recopilar información de distintas fuentes, como gráficos, monitores, dashboards completos o [notebooks][3]. De este modo, podrás aportar la máxima información posible al declarar una incidencia. - -1. En Datadog, navega hasta [**Dashboard List**][15] (Lista de dashboards) y selecciona **System - Metrics** (Sistema - Métricas). -2. Pasa el cursor sobre uno de los gráficos y cópialo en el Clipboard con uno de los siguientes comandos: - - **Ctrl**/**Cmd** + **C** - - Haz clic en el icono **Export** (Exportar) del gráfico y selecciona **Copy** (Copiar). -3. En el menú Datadog de la izquierda, ve a [**Monitors** > **Monitors List**][16] (Monitores > Lista de monitores) y selecciona **[Auto] Clock in sync with NTP** (Autorreloj sincronizado con NTP). -4. Abre el Clipboard: **Ctrl**/**Cmd** + **Shift** + **K**. -5. En el Clipboard, haz clic en **Add current page** (Añadir la página actual) para añadir el monitor al Clipboard. -{{< img src="getting_started/incident_management/copy_to_clipboard.png" alt="Copiar en el Clipboard" responsive="true" style="width:100%;">}} -6. Haz clic en **Select All** (Seleccionar todo) y, después, en **Export items to…** (Exportar los elementos a…). -7. Selecciona **Declare Incident** (Declarar incidencia). -8. Describe el problema: +1. En Datadog, navegue a [{{< ui >}}Dashboard List{{< /ui >}}][15] y seleccione {{< ui >}}System - Metrics{{< /ui >}}. +2. Pase el cursor sobre uno de los gráficos y cópielo al Portapapeles con uno de los siguientes comandos: + - {{< ui >}}Ctrl{{< /ui >}}/{{< ui >}}Cmd{{< /ui >}} + {{< ui >}}C{{< /ui >}} + - Haga clic en el icono {{< ui >}}Export{{< /ui >}} en el gráfico y seleccione {{< ui >}}Copy{{< /ui >}}. +3. En el menú de Datadog a la izquierda, vaya a [{{< ui >}}Monitors{{< /ui >}} > {{< ui >}}Monitors List{{< /ui >}}][16] y seleccione {{< ui >}}[Auto] Clock in sync with NTP{{< /ui >}}. +4. Abra el portapapeles: {{< ui >}}Ctrl{{< /ui >}}/{{< ui >}}Cmd{{< /ui >}} + {{< ui >}}Shift{{< /ui >}} + {{< ui >}}K{{< /ui >}}. +5. En el portapapeles, haga clic en {{< ui >}}Add current page{{< /ui >}} para agregar el monitor al portapapeles. +{{< img src="getting_started/incident_management/copy_to_clipboard.png" alt="Copiar al portapapeles" responsive="true" style="width:100%;">}} +6. Haga clic en {{< ui >}}Select All{{< /ui >}} y luego en {{< ui >}}Export items to…{{< /ui >}} +7. Seleccione {{< ui >}}Declare Incident{{< /ui >}}. +8. Describa lo que está sucediendo: | | | |--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Título | Utiliza las convenciones de nomenclatura que tu equipo estime oportunas para los títulos de las incidencias. Dado que no se trata de una incidencia real, puedes incluir la palabra `TEST` para dejar en claro que es una prueba. Ejemplo: `[TEST] My incident test` | -| Gravedad | Selecciona la opción **Unknown** (Desconocida), ya que no está claro si esto afecta a los clientes ni cuál está siendo el impacto en los servicios relacionados. Consulta el significado de cada nivel de gravedad en la descripción de la aplicación y sigue las directrices de tu equipo. | -| Responsable de la incidencia | Déjala asignada a tu nombre. Si se tratara de una incidencia real, se asignaría a la persona a cargo de su investigación. Según avance la investigación de la incidencia, otras personas o tú podréis actualizar quién es su responsable. | -9. Haz clic en **Declare Incident** (Declarar incidencia) para crear la incidencia. - Además, se puede declarar una incidencia desde un [gráfico][4], un [monitor][5] o la [API de incidencias][6]. En el caso de los usuarios de APM, basta con hacer clic en el icono de incidencias de cualquier gráfico de APM para declarar una incidencia. -Gracias a la integración de Slack, también puedes utilizar el atajo `/datadog incident` para declarar una incidencia y establecer el título, la gravedad y el impacto causado al cliente. -10. Haz clic en **Slack Channel** (Canal de Slack), en la página de la incidencia, para acceder a su canal de Slack. - -Con cada nueva incidencia, se creará automáticamente un nuevo canal de Slack específico para simplificar las comunicaciones con el equipo y comenzar a solucionar los problemas. Si la integración de Slack de tu organización está configurada para actualizar la incidencia en un canal general, este se actualizará con la nueva incidencia. +| {{< ui >}}Title{{< /ui >}} | Siga cualquier convención de nomenclatura que su equipo desee utilizar para los títulos de incidentes. Debido a que este no es un incidente real, incluya la palabra `TEST` para dejar claro que se trata de un incidente de prueba. Un ejemplo de título: `[TEST] My incident test` | +| {{< ui >}}Severity Level{{< /ui >}} | Establezca en {{< ui >}}Unknown{{< /ui >}} ya que no está claro si los clientes están siendo afectados y cómo están siendo afectados los servicios relacionados. Consulte la descripción en la aplicación de lo que significa cada nivel de gravedad y siga las pautas de su equipo. | +| {{< ui >}}Incident Commander{{< /ui >}} | Déjelo asignado a usted. En un incidente real, esto se asignaría al líder de la investigación del incidente. Usted u otros pueden actualizar quién es el comandante del incidente a medida que avanza la investigación del incidente. | +9. Haga clic en {{< ui >}}Declare Incident{{< /ui >}} para crear el incidente. + También puede declarar un incidente desde un [graph][4], [monitor][5] o la [incidents API][6]. Para los usuarios de APM, puede hacer clic en el icono de incidentes en cualquier gráfico de APM para declarar un incidente. +Como parte de la integración con Slack, también puede usar el atajo `/datadog incident` para declarar un incidente y establecer el título, la gravedad y el impacto en el cliente. +10. Haga clic en {{< ui >}}Slack Channel{{< /ui >}} en la página del incidente para ir al canal de Slack del incidente. + +Se crea automáticamente un nuevo canal de Slack dedicado al incidente para cualquier incidente nuevo, de modo que pueda consolidar la comunicación con su equipo y comenzar a solucionar problemas. Si la integración de Slack de su organización está configurada para actualizar un canal de incidentes global, entonces el canal se actualiza con el nuevo incidente. -Si no has activado la integración de Slack, haz clic en **Add Chat** (Añadir chat) para añadir el enlace al servicio de chat que estés utilizando para abordar la incidencia. +Si no tiene habilitada la integración con Slack, haga clic en {{< ui >}}Add Chat{{< /ui >}} para agregar el enlace al servicio de chat que está utilizando para discutir el incidente. -Haz clic en **Add Video Call** (Añadir videollamada) para añadir un enlace a la llamada en la que se está tratando la incidencia. +Haga clic en {{< ui >}}Add Video Call{{< /ui >}} para agregar un enlace a la llamada donde se están llevando a cabo las discusiones sobre el incidente. -### Solucionar problemas y actualizar la incidencia +### Solución de problemas y actualización del incidente {#troubleshooting-and-updating-the-incident} -La página de la incidencia tiene cuatro secciones principales: _Overview_ (Información general), _Timeline_ (Cronología), _Remediation_ (Solución) y _Notifications_ (Notificaciones). Recuerda actualizar estas secciones a medida que avance la investigación de la incidencia para mantener a todo el mundo al tanto de su estado actual. +La página de Incidentes tiene cuatro secciones principales: {{< ui >}}Overview{{< /ui >}}, {{< ui >}}Timeline{{< /ui >}}, {{< ui >}}Post-Incident{{< /ui >}} y {{< ui >}}Notifications{{< /ui >}}. Actualice estas secciones a medida que avance el incidente para mantener a todos informados sobre el estado actual. -#### Información general +#### Descripción general {#overview-1} -**Situación:** Tras investigar un poco, descubres que la causa principal es un host que se está quedando sin memoria. Además, te informan de que esto afecta a un pequeño subconjunto de clientes y observas que las páginas se cargan con lentitud. La primera notificación de un cliente llegó hace 15 minutos. Se trata de una incidencia SEV-3 (nivel de gravedad: 3). +**Escenario:** Después de investigar un poco, descubre que la causa raíz es un servidor que se quedó sin memoria. También le informaron que un pequeño subconjunto de clientes se está viendo afectado y experimenta una carga lenta de las páginas. El primer informe de cliente llegó hace 15 minutos. Es un incidente SEV-3. -En la sección _Overview_ (Información general), puedes actualizar los campos de la incidencia y el impacto en el cliente a medida que avanza la investigación. +En la sección {{< ui >}}Overview{{< /ui >}}, puede actualizar los campos del incidente y el impacto en el cliente a medida que continúa la investigación. -Para actualizar el nivel de gravedad y la causa principal: -1. Haz clic en el menú desplegable _Severity_ (Gravedad) y selecciona **SEV-3**. -2. En _What happened_ (Qué ocurrió), selecciona **Monitor** en el menú desplegable _Detection Method_ (Método de detección), ya que la primera alerta que recibiste sobre el problema provenía de un monitor. -1. Indica que el host que se está quedando sin memoria en el campo _Why it happened_ (Por qué ocurrió). Ejemplo: `TEST: Host is running out of memory.` -4. Haz clic en **Save** (Guardar) para actualizar las propiedades. - Desde Slack, también puedes actualizar el título, la gravedad o el estado de una incidencia en curso utilizando el comando `/datadog incident update`. +Para actualizar el nivel de gravedad y la causa raíz: +1. Haga clic en el {{< ui >}}Severity{{< /ui >}} desplegable y seleccione {{< ui >}}SEV-3{{< /ui >}}. +2. En {{< ui >}}What happened{{< /ui >}}, seleccione {{< ui >}}Monitor{{< /ui >}} en el {{< ui >}}Detection Method{{< /ui >}} desplegable (está seleccionado Unknown), porque fue alertado primero por un monitor sobre el problema. +1. Agregue al campo {{< ui >}}Why it happened{{< /ui >}}: `TEST: Host is running out of memory.` +4. Haga clic en {{< ui >}}Save{{< /ui >}} para actualizar las propiedades. + Desde Slack, también puede actualizar el título, la gravedad o el estado de un incidente en curso mediante el comando `/datadog incident update`. -Para añadir la información sobre cómo ha afectado el problema al cliente: -1. Haz clic en **+ Add** (Añadir), en la sección _Impact_ (Impacto). -2. Cambia la marca de tiempo a 15 minutos antes, dado que fue en ese momento cuando llegó la primera notificación de un cliente. -3. Indica la información que te han dado los clientes en el campo de descripción. Ejemplo: `TEST: Some customers seeing pages loading slowly.` -4. Haz clic en **Save** (Guardar) para actualizar los campos. Puedes consultar durante cuánto tiempo esta situación afectó al cliente en la sección _Impact_ (Impacto). Todos los cambios realizados en la página _Overview_ (Información general) se añaden a _Timeline_ (Cronología). +Para agregar el impacto al cliente: +1. Haga clic en {{< ui >}}\+ Add{{< /ui >}} en la sección {{< ui >}}Impact{{< /ui >}}. +2. Cambie la marca de tiempo a 15 minutos antes, porque fue cuando llegó el primer informe del cliente. +3. Agregue al campo de descripciones: `TEST: Some customers seeing pages loading slowly.` +4. Haga clic en {{< ui >}}Save{{< /ui >}} para actualizar los campos. La sección {{< ui >}}Impact{{< /ui >}} se actualiza para mostrar cuánto tiempo ha estado ocurriendo el impacto al cliente. Todos los cambios realizados en la página {{< ui >}}Overview{{< /ui >}} se agregan a la {{< ui >}}Timeline{{< /ui >}}. -#### Cronología +#### Línea de tiempo {#timeline} -La sección _Timeline_ (Cronología) muestra en orden cronológico las adiciones y modificaciones de campos e información sobre la incidencia. +La {{< ui >}}Timeline{{< /ui >}} muestra las adiciones y los cambios en los campos de incidentes y la información en orden cronológico. -{{< img src="getting_started/incident_management/flag_event.png" alt="Evento con bandera" responsive="true" style="width:50%;">}} +{{< img src="getting_started/incident_management/flag_event.png" alt="Marcar evento" responsive="true" style="width:50%;">}} -1. Haz clic en la pestaña **Timeline**. -2. Busca el evento _Impact added_ (Impacto añadido) y haz clic en el icono de la bandera para marcarlo como _importante_. -3. Añade una nota a la cronología para dejar constancia de que has encontrado el host que causa el problema. Ejemplo: `I found the host causing the issue.` -4. Pasa el cursor por encima del evento de la nota y haz clic en el icono del lápiz para cambiar la marca de tiempo, ya que en realidad encontraste el host causante del problema hace 10 minutos. -5. Marca la nota como **importante** con una bandera. -6. Haz clic en **Slack Channel** (Canal de Slack) para volver al canal de Slack de la incidencia. -7. Publica un mensaje en el canal para informar de que estás buscando una solución. Ejemplo: `I am working on a fix.` -8. Haz clic en el icono del comando de acciones del mensaje (al pasar el cursor por encima de un mensaje, aparecen tres puntos a la derecha). -9. Selecciona **Add to Incident** (Añadir a la incidencia) para enviar el mensaje a la cronología. +1. Haga clic en la pestaña {{< ui >}}Timeline{{< /ui >}}. +2. Busque el evento {{< ui >}}Impact added{{< /ui >}} y márquelo como {{< ui >}}Important{{< /ui >}} haciendo clic en el icono de bandera. +3. Agregue una nota a la línea de tiempo: `I found the host causing the issue.` +4. Pase el cursor sobre el evento de la nota y haga clic en el icono de lápiz para cambiar la marca de tiempo de la nota, ya que en realidad encontró el servidor que causó el problema hace 10 minutos. +5. Marque la nota como {{< ui >}}Important{{< /ui >}}. +6. Haga clic en {{< ui >}}Slack Channel{{< /ui >}} para volver al canal de Slack del incidente. +7. Publique un mensaje en el canal diciendo `I am working on a fix.` +8. Haga clic en el icono de comandos de acciones del mensaje (tres puntos a la derecha después de pasar el cursor sobre un mensaje). +9. Seleccione {{< ui >}}Add to Incident{{< /ui >}} para enviar el mensaje a la línea de tiempo. -{{< img src="getting_started/incident_management/add_from_slack.png" alt="Añadir desde Slack" responsive="true" style="width:40%;">}} +{{< img src="getting_started/incident_management/add_from_slack.png" alt="Agregar desde Slack" responsive="true" style="width:40%;">}} -Para poder unificar las comunicaciones importantes relacionadas con la investigación y la mitigación de la incidencia, puedes añadir cualquier comentario del canal de Slack sobre la incidencia a la cronología. +Puede agregar cualquier comentario de Slack en el canal de incidentes a la línea de tiempo para que pueda consolidar las comunicaciones importantes relacionadas con la investigación y mitigación del incidente. -#### Corrección +#### Post-incidente {#post-incident} -**Situación**: Hay un notebook sobre cómo tratar este tipo de problemas, donde se recogen las tareas que hay que realizar para solucionarlos. +**Escenario:** Hay un notebook sobre cómo manejar este tipo de problema, que incluye tareas que deben realizarse para solucionarlo. - En la sección _Remediation_ (Solución), se puede hacer un seguimiento de las tareas y documentos relacionados con la investigación de la incidencia o con las medidas correctivas posteriores. + En la sección {{< ui >}}Post-Incident{{< /ui >}}, puede realizar un seguimiento de los documentos y tareas para investigar el problema o para tareas de remediación post-incidente. -1. Haz clic en la pestaña **Remediation** (Solución). -2. Haz clic en el icono `+` en el cuadro _Documents_ (Documentos) y añade un enlace a un [notebook de Datadog][7]. Todas las actualizaciones de la sección _Documents_ se añaden a la línea de tiempo como un tipo de _Incident Update_ (Actualización de incidencia). -3. Para añadir una tarea, basta con introducir su descripción en el recuadro _Incident Tasks_ (Tareas de la incidencia). Ejemplo: `Run the steps in the notebook.` -4. Haz clic en **Create Task** (Crear tarea). -5. Haz clic en **Assign To** (Asignar a) y asígnatela a ti. -6. Haz clic en *Set Due Date** (Configurar fecha de vencimiento) y pon la fecha de hoy. - Todas las adiciones y modificaciones de tareas se registrarán en _Timeline_ (Cronología). - También puedes añadir tareas posteriores a la incidencia en la sección _Remediation_ (Solución) para llevar un seguimiento. +1. Haga clic en la pestaña {{< ui >}}Post-Incident{{< /ui >}}. +2. Haga clic en el icono de más `+` en el cuadro {{< ui >}}Documents{{< /ui >}} y agregue un enlace a un [Datadog notebook][7]. Todas las actualizaciones en la sección {{< ui >}}Documents{{< /ui >}} se agregan a la línea de tiempo como un tipo de {{< ui >}}Incident Update{{< /ui >}}. +3. Agregue una tarea añadiendo una descripción de la tarea en el cuadro {{< ui >}}Incident Tasks{{< /ui >}}, por ejemplo: `Run the steps in the notebook.` +4. Haga clic en {{< ui >}}Create Task{{< /ui >}}. +5. Haga clic en {{< ui >}}Assign To{{< /ui >}} y asígnese la tarea. +6. Haga clic en {{< ui >}}Set Due Date{{< /ui >}} y establezca la fecha para hoy. + Todas las adiciones y cambios de tareas se registran en el {{< ui >}}Timeline{{< /ui >}}. + También puede agregar tareas de post-incidente en la sección {{< ui >}}Post-Incident{{< /ui >}} para realizar un seguimiento de ellas. -#### Notificaciones +#### Notifications {#notifications} -**Situación**: El problema se ha mitigado, y el equipo está monitorizando la situación. El estado de la incidencia es estable. +**Escenario:** El problema ha sido mitigado y el equipo está monitoreando la situación. El estado del incidente es estable. -En la sección _Notifications_ (Notificaciones), puedes enviar una notificación para actualizar el estado de la incidencia. +En la sección {{< ui >}}Notifications{{< /ui >}}, puede enviar una notificación actualizando el estado del incidente. -1. Vuelve a la sección _Overview_ (Información general). -2. En el menú desplegable, cambia el estado de _ACTIVE_ (Activo) a _STABLE_ (Estable). -4. Dirígete a la pestaña _Notificaciones_. -5. Haz clic en **New Notification** (Nueva notificación). - El mensaje predeterminado tiene el título de la incidencia en el asunto y la información sobre su estado actual en el cuerpo del mensaje. - En una incidencia real, tendrías que enviar actualizaciones a las personas implicadas en la incidencia. Para este ejemplo, envía una notificación que solo te llegue a ti. -6. Añádete a ti mismo en el campo _Recipients_ (Destinatarios). -7. Haz clic en **Send** (Enviar). - Deberías recibir un correo electrónico con el mensaje. - Puedes crear [plantillas de mensajes][8] personalizadas. Las plantillas se pueden agrupar mediante el campo _Category_ (Categoría). +1. Regrese a la sección {{< ui >}}Overview{{< /ui >}}. +2. Cambie el estado en el menú desplegable de {{< ui >}}ACTIVE{{< /ui >}} a {{< ui >}}STABLE{{< /ui >}}. +4. Vaya a la pestaña {{< ui >}}Notifications{{< /ui >}}. +5. Haga clic en {{< ui >}}New Notification{{< /ui >}}. + El mensaje predeterminado tiene el título del incidente en el asunto y información sobre el estado actual del incidente en el cuerpo. + En un incidente real, usted enviaría actualizaciones a las personas involucradas en el incidente. Para este ejemplo, envíe una notificación solo a usted mismo. +6. Agréguese al campo {{< ui >}}Recipients{{< /ui >}}. +7. Haga clic en {{< ui >}}Send{{< /ui >}}. + Debería recibir un correo electrónico con el mensaje. + Puede crear [plantillas de mensaje][8] personalizadas. Agrupe las plantillas utilizando el campo {{< ui >}}Category{{< /ui >}}. -### Resolución e informe retrospectivo +### Resolución y postmortem {#resolution-and-postmortem} -**Situación:** Se confirma que el problema ya no afecta a los clientes y que has resuelto la incidencia. El equipo quiere un informe retrospectivo para ver qué ha fallado. +**Escenario:** Se ha confirmado que el problema ya no afecta a los clientes y que usted lo ha resuelto. El equipo desea un postmortem para analizar qué salió mal. -1. Dirígete a la sección _Overview_ (Información general). -3. Cambia el estado de _STABLE_ (Estable) a _RESOLVED_ (Resuelto) para que la incidencia deje de estar activa. También puedes modificar la fecha y la hora si la incidencia dejó de afectar a los clientes antes de resolverse. -7. El botón _Generate Postmortem_ (Generar informe retrospectivo) aparecerá en la parte superior de la página cuando el estado de una incidencia se haya configurado como resuelto. -8. Desde la sección de cronología, selecciona **Marked as Important** (Marcado como importante) para que solo se añadan al informe retrospectivo los eventos _importantes_. -9. Haz clic en **Generate** (Generar). +1. Vaya a la sección {{< ui >}}Overview{{< /ui >}}. +3. Cambie el estado de {{< ui >}}STABLE{{< /ui >}} a {{< ui >}}RESOLVED{{< /ui >}} para que ya no esté activo. También puede cambiar la fecha y la hora en que finalizó el impacto en el cliente si ocurrió antes. +7. Cuando el estado de un incidente se establece como resuelto, aparece un botón {{< ui >}}Generate Postmortem{{< /ui >}} en la parte superior. Haga clic en {{< ui >}}Generate Postmortem{{< /ui >}}. +8. Para la sección de cronología, seleccione {{< ui >}}Marked as Important{{< /ui >}} de modo que solo se agreguen los eventos {{< ui >}}Important{{< /ui >}} al postmortem. +9. Haga clic en {{< ui >}}Generate{{< /ui >}}. -El análisis retrospectivo se genera como un notebook de Datadog o una página de Confluence, e incluye los eventos de cronología y los recursos a los que se hizo referencia durante la investigación y la corrección. Esto facilita la revisión y la documentación de las causas del problema y la forma de evitarlo en el futuro. +El postmortem incluye los eventos de la cronología y los recursos referenciados durante la investigación y la remediación. Esto facilita la revisión y la documentación adicional de lo que causó el problema y cómo evitarlo en el futuro. Para obtener más información, consulte [Incident Postmortems][17]. -Si es necesario hacer tareas de seguimiento para garantizar que el problema no se repita, añádelas para tenerlas bajo control en la sección _Incident Tasks_ (Tareas de la incidencia) de la sección Remediation (Solución). +Si hay tareas de seguimiento que usted y su equipo deben completar para garantizar que el problema no vuelva a ocurrir, agréguelas y haga seguimiento de ellas en la sección {{< ui >}}Incident Tasks{{< /ui >}} del Post-incidente. -{{< img src="getting_started/incident_management/generate_postmortem.png" alt="Generate Postmortem (Generar informe retrospectivo)" responsive="true" style="width:80%;">}} -## Personalizar el flujo de trabajo de la gestión de incidencias +{{< img src="getting_started/incident_management/generate_postmortem.png" alt="Generar postmortem" responsive="true" style="width:80%;">}} +## Personalización de su flujo de trabajo de gestión de incidentes {#customizing-your-incident-management-workflow} -Según las necesidades de tu organización, la gestión de incidencias de Datadog puede personalizarse con diferentes niveles de gravedad y estado, e incluye información adicional, como los servicios de APM y los equipos relacionados con la incidencia. Para obtener más información, consulta esta [sección][9] de la página de Gestión de incidencias. +Datadog Incident Management se puede personalizar con diferentes niveles de gravedad y estado, según las necesidades de su organización, y también incluir información adicional, como servicios de APM y equipos relacionados con el incidente. Para obtener más información, consulte esta [sección][9] de la página de Incident Management. -También puedes configurar reglas de notificación para avisar automáticamente a personas o servicios concretos según el nivel de gravedad de una incidencia. Para obtener más información, consulta la documentación [Configuración de incidencias][10]. +También puede configurar reglas de notificación para notificar automáticamente a personas o servicios específicos según el nivel de gravedad de un incidente. Para obtener más información, consulte la documentación de [Incident Settings][10]. -Para personalizar la gestión de incidencias, visita la [página de configuración de incidencias][11]. En el menú de Datadog de la izquierda, dirígete a **Monitors** > **Incidents** (Monitores > Incidencias); si aparece una pantalla de bienvenida a la gestión de incidencias, haz clic en **Get Started** (Comenzar). A continuación, en la parte superior, haz clic en **Settings** (Configuración). +Para personalizar Incident Management, vaya a la [Incident Settings page][11]. Desde el menú de Datadog en el lado izquierdo, vaya a {{< ui >}}Monitors{{< /ui >}} > {{< ui >}}Incidents{{< /ui >}} (si aparece una pantalla de bienvenida de Incident Management, haga clic en {{< ui >}}Get Started{{< /ui >}}). Luego, en la parte superior, haga clic en {{< ui >}}Settings{{< /ui >}}. -## Crear y gestionar incidencias desde un dispositivo móvil +## Crear y gestionar incidentes en dispositivos móviles {#create-and-manage-incidents-on-mobile} -La [aplicación móvil de Datadog][12], disponible en el [App Store de Apple][13] y en [Google Play][14], permite a los usuarios crear, ver, buscar y filtrar todas las incidencias a las que tienes acceso en la aplicación con tu cuenta de Datadog. La finalidad es garantizar una respuesta y resolución rápidas sin necesidad de abrir el portátil. +La [aplicación móvil de Datadog][12], disponible en [Apple App Store][13] y [Google Play Store][14], permite a los usuarios crear, visualizar, buscar y filtrar todos los incidentes a los que tiene acceso en su cuenta de Datadog desde la aplicación móvil de Datadog para garantizar una respuesta y resolución rápidas sin abrir su computadora portátil. -Asimismo, puedes declarar y editar incidencias y comunicarte rápidamente con tus equipos gracias a las integraciones con Slack, Zoom y muchas otras herramientas. +También puede declarar y editar incidentes, y comunicarse rápidamente con sus equipos a través de integraciones con Slack, Zoom y muchas más. -{{< img src="incident_response/incident_management/iOS_Incident_V2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Dos vistas en la aplicación móvil de Datadog: una que muestra una lista de incidentes con detalles muy claros sobre cada incidente y una que muestra un panel detallado para un incidente único">}} +{{< img src="incident_response/incident_management/iOS_Incident_V2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Dos vistas en la aplicación móvil de Datadog: una que muestra una lista de incidentes con detalles de alto nivel sobre cada incidente, y otra que muestra un panel detallado para un solo incidente">}} -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: /es/integrations/slack/ -[2]: /es/service_management/incident_management/datadog_clipboard +[2]: /es/dashboards/guide/datadog_clipboard [3]: /es/notebooks/#overview -[4]: /es/service_management/incident_management/#from-a-graph -[5]: /es/service_management/incident_management/#from-a-monitor +[4]: /es/incident_response/incident_management/#from-a-graph +[5]: /es/incident_response/incident_management/#from-a-monitor [6]: /es/api/latest/incidents/#create-an-incident [7]: https://app.datadoghq.com/notebook/list [8]: https://app.datadoghq.com/incidents/settings#Messages -[9]: /es/service_management/incident_management/#status-levels -[10]: /es/service_management/incident_management/incident_settings +[9]: /es/incident_response/incident_management/#status-levels +[10]: /es/incident_response/incident_management/incident_settings [11]: https://app.datadoghq.com/incidents/settings [12]: /es/mobile/ [13]: https://apps.apple.com/app/datadog/id1391380318 [14]: https://play.google.com/store/apps/details?id=com.datadog.app [15]: https://app.datadoghq.com/dashboard/lists -[16]: https://app.datadoghq.com/monitors/manage \ No newline at end of file +[16]: https://app.datadoghq.com/monitors/manage +[17]: /es/incident_response/incident_management/post_incident/postmortems \ No newline at end of file diff --git a/hugo/content/es/getting_started/integrations/aws.md b/hugo/content/es/getting_started/integrations/aws.md index 8c95f6b7a61..9138409b825 100644 --- a/hugo/content/es/getting_started/integrations/aws.md +++ b/hugo/content/es/getting_started/integrations/aws.md @@ -1,46 +1,52 @@ --- -description: Integra tu cuenta de Amazon Web Services con Datadog utilizando CloudFormation. - Configura roles de IAM, habilita integraciones de servicios y configura el reenvío +description: Integre su cuenta de Amazon Web Services con Datadog mediante CloudFormation. + Configure roles de IAM, habilite integraciones de servicios y configure el reenvío de registros. further_reading: +- link: https://www.datadoghq.com/architecture/a-guide-to-integrating-100-aws-accounts-with-datadog/ + tag: Centro de arquitectura + text: Una guía para integrar más de 100 cuentas de AWS con Datadog - link: https://www.datadoghq.com/blog/aws-monitoring/ tag: Blog - text: Métricas clave para el seguimiento de AWS + text: Métricas clave para hacer un seguimiento de AWS - link: https://www.datadoghq.com/blog/aws-1-click-integration/ tag: Blog - text: Presentamos nuestra integración de un clic con AWS + text: Presentamos nuestra integración de AWS con 1 clic - link: https://www.datadoghq.com/blog/deploying-datadog-with-cloudformation/ tag: Blog - text: Desplegando y configurando Datadog con CloudFormation + text: Implementación y configuración de Datadog con CloudFormation - link: https://www.datadoghq.com/blog/monitoring-as-code-with-datadog-and-cloudformation/ tag: Blog - text: Implementa el seguimiento como código con Datadog y el Registro de CloudFormation + text: Implemente el seguimiento como código con Datadog y CloudFormation Registry - link: https://www.datadoghq.com/blog/datadog-serverless-view/ tag: Blog - text: Monitorea toda tu pila serverless en la vista Serverless + text: Haga un seguimiento de toda su pila Serverless en la vista Serverless - link: https://www.datadoghq.com/blog/monitor-aws-fargate/ tag: Blog - text: Monitorea aplicaciones ECS en AWS Fargate con Datadog + text: Haga un seguimiento de aplicaciones de ECS en AWS Fargate con Datadog - link: https://www.datadoghq.com/blog/amazon-ecs-anywhere-monitoring/ tag: Blog - text: Monitorea Amazon ECS Anywhere con Datadog + text: Haga un seguimiento de Amazon ECS Anywhere con Datadog - link: /integrations/guide/aws-cloudwatch-metric-streams-with-kinesis-data-firehose/?tab=cloudformation tag: Documentación - text: Flujos de métricas de AWS CloudWatch con Amazon Data Firehose + text: AWS CloudWatch Metric Streams con Amazon Data Firehose - link: https://www.datadoghq.com/blog/monitor-aws-graviton3-with-datadog/ tag: Blog - text: Monitorea tus instancias de EC2 impulsadas por Graviton3 con Datadog. -title: Introducción a AWS + text: Haga un seguimiento de sus instancias EC2 con tecnología Graviton3 con Datadog +- link: https://learn.datadoghq.com/courses/getting-started-with-the-datadog-aws-integration + tag: Centro de aprendizaje + text: Primeros pasos con la integración de AWS de Datadog +title: Primeros pasos con AWS --- -## Resumen {#overview} +## Descripción general {#overview} -Esta guía le muestra cómo integrar una cuenta de Amazon Web Services (AWS) con Datadog utilizando la plantilla de CloudFormation de Datadog. Después de completar la configuración, puede habilitar integraciones individuales de servicios de AWS, instalar el Datadog Agent en instancias de EC2 para obtener mayor visibilidad y configurar el reenvío de registros. +Esta guía lo orienta sobre cómo integrar una cuenta de Amazon Web Services (AWS) con Datadog mediante la plantilla de CloudFormation de Datadog. Después de completar la configuración, puede habilitar integraciones de servicios de AWS individuales, instalar el Datadog Agent en instancias EC2 para obtener una visibilidad más profunda y configurar el reenvío de registros. ## Requisitos previos {#prerequisites} -Antes de comenzar, asegúrese de tener una cuenta de [AWS][7]. La plantilla de CloudFormation crea un rol de IAM y una política asociada, permitiendo que la cuenta de AWS de Datadog realice llamadas a la API a su cuenta de AWS para recopilar y enviar datos. Su usuario de AWS debe tener los siguientes permisos de IAM para ejecutar la plantilla: +Antes de comenzar, asegúrese de tener una cuenta de [AWS][7]. La plantilla de CloudFormation crea un rol de IAM y una política asociada, lo que permite que la cuenta de AWS de Datadog realice llamadas a la API a su cuenta de AWS para recopilar y enviar datos. Su usuario de AWS debe tener los siguientes permisos de IAM para ejecutar la plantilla: -{{% collapse-content title="Permisos de IAM requeridos" level="h4" expanded=false id="iam-permissions" %}} +{{% collapse-content title="Permisos de IAM requeridos" level="h3" expanded=false id="iam-permissions" %}} - cloudformation:CreateStack - cloudformation:CreateUploadBucket - cloudformation:DeleteStack @@ -65,7 +71,7 @@ Antes de comenzar, asegúrese de tener una cuenta de [AWS][7]. La plantilla de C - iam:PutRolePolicy - iam:TagRole - iam:UpdateAssumeRolePolicy -- kms:Descifrar +- kms:Decrypt - lambda:AddPermission - lambda:CreateFunction - lambda:DeleteFunction @@ -77,161 +83,178 @@ Antes de comenzar, asegúrese de tener una cuenta de [AWS][7]. La plantilla de C - lambda:PutFunctionConcurrency - lambda:RemovePermission - lambda:TagResource -- logs:CrearGrupoDeRegistros -- logs:EliminarGrupoDeRegistros -- logs:DescribirGruposDeRegistros -- logs:EstablecerPolíticaDeRetención -- oam:ListarSumideros -- oam:ListarEnlacesAdjuntos -- s3:CrearBucket -- s3:EliminarBucket -- s3:EliminarPolíticaDeBucket -- s3:ObtenerConfiguraciónDeEncriptación -- s3:ObtenerObjeto -- s3:ObtenerVersiónDeObjeto -- s3:EstablecerPolíticaDeBucket -- s3:EstablecerBloqueoDeAccesoPúblicoDeBucket -- s3:EstablecerConfiguraciónDeEncriptación -- s3:EstablecerConfiguraciónDeCicloDeVida -- secretsmanager:CrearSecreto -- secretsmanager:EliminarSecreto -- secretsmanager:ObtenerValorDeSecreto -- secretsmanager:EstablecerValorDeSecreto -- serverlessrepo:CrearPlantillaDeCloudFormation +- logs:CreateLogGroup +- logs:DeleteLogGroup +- logs:DescribeLogGroups +- logs:PutRetentionPolicy +- oam:ListSinks +- oam:ListAttachedLinks +- s3:CreateBucket +- s3:DeleteBucket +- s3:DeleteBucketPolicy +- s3:GetEncryptionConfiguration +- s3:GetObject +- s3:GetObjectVersion +- s3:PutBucketPolicy +- s3:PutBucketPublicAccessBlock +- s3:PutEncryptionConfiguration +- s3:PutLifecycleConfiguration +- secretsmanager:CreateSecret +- secretsmanager:DeleteSecret +- secretsmanager:GetSecretValue +- secretsmanager:PutSecretValue +- serverlessrepo:CreateCloudFormationTemplate {{% /collapse-content %}} -## Configurar {#setup} +## Configuración {#setup} 1. Vaya a la [página de configuración de integración de AWS][8] en Datadog y haga clic en {{< ui >}}Add AWS Account{{< /ui >}}. 1. Configure los ajustes de la integración en la opción {{< ui >}}Automatically using CloudFormation{{< /ui >}}. - 1. Seleccione las regiones de AWS con las que desea integrar. + 1. Seleccione las regiones de AWS con las que desea integrarse. 1. Agregue su [clave de API de Datadog][9]. 1. Opcionalmente, envíe registros y otros datos a Datadog con el [Datadog Forwarder Lambda][1]. - 1. Opcionalmente, habilite [Cloud Security Misconfigurations][54] para escanear su entorno en la nube, hosts y contenedores en busca de configuraciones incorrectas y riesgos de seguridad. -1. Haga clic en {{< ui >}}Launch CloudFormation Template{{< /ui >}}. Esto abre la Consola de AWS y carga la pila de CloudFormation. Todos los parámetros se completan según sus selecciones en el formulario previo de Datadog, por lo que no necesita editarlos a menos que lo desee. -**Nota:** El parámetro `DatadogAppKey` permite que la pila de CloudFormation realice llamadas API a Datadog para agregar y editar la configuración de Datadog para esta cuenta de AWS. La clave se genera automáticamente y se vincula a su cuenta de Datadog. + 1. Opcionalmente, habilite [Cloud Security Misconfigurations][54] para analizar su entorno de nube, hosts y contenedores en busca de configuraciones incorrectas y riesgos de seguridad. +1. Haga clic en {{< ui >}}Launch CloudFormation Template{{< /ui >}}. Esto abre la consola de AWS y carga la pila de CloudFormation. Todos los parámetros se completan según sus selecciones en el formulario anterior de Datadog, por lo que no necesita editarlos a menos que lo desee. +**Nota:** El parámetro `DatadogAppKey` permite que la pila de CloudFormation realice llamadas a la API de Datadog para agregar y editar la configuración de Datadog para esta cuenta de AWS. La clave se genera automáticamente y está vinculada a su cuenta de Datadog. 1. Marque las casillas requeridas de AWS y haga clic en {{< ui >}}Create stack{{< /ui >}}. Esto inicia el proceso de creación de la pila de Datadog junto con tres pilas anidadas. Esto podría tardar varios minutos. Asegúrese de que la pila se haya creado correctamente antes de continuar. -1. Después de que se crea la pila, regrese al mosaico de integración de AWS en Datadog y haga clic en {{< ui >}}Ready!{{< /ui >}}. -1. Espere hasta 10 minutos para que los datos comiencen a ser recolectados, y luego visualice el [tablero de visión general de AWS][12] para ver las métricas enviadas por sus servicios e infraestructura de AWS: -{{< img src="getting_started/integrations/aws-dashboard.png" alt="El tablero de visión general de AWS en la cuenta de Datadog. A la izquierda está el logo de AWS y un gráfico de eventos de AWS que muestra 'No se encontraron entradas coincidentes'. En el centro hay gráficos relacionados con volúmenes de EBS con datos numéricos mostrados y un mapa de calor que muestra datos consistentes. A la derecha hay gráficos relacionados con ELBs que muestran datos numéricos, además de un gráfico de series temporales que muestra datos con picos provenientes de tres fuentes.">}} +1. Después de crear la pila, regrese al tile de integración de AWS en Datadog y haga clic en {{< ui >}}Ready!{{< /ui >}} +1. Espere hasta 10 minutos para que los datos comiencen a recopilarse y, luego, visualice el [panel de descripción general de AWS][12] predeterminado para ver las métricas enviadas por sus servicios e infraestructura de AWS: +{{< img src="getting_started/integrations/aws-dashboard.png" alt="El panel de descripción general de AWS en la cuenta de Datadog. A la izquierda se encuentra el logotipo de AWS y un gráfico de eventos de AWS que muestra \"No matching entries found\". En el centro hay gráficos relacionados con volúmenes de EBS con datos numéricos mostrados y un mapa de calor que muestra datos consistentes. A la derecha hay gráficos relacionados con ELBs que muestran datos numéricos, así como un gráfico de series temporales que muestra datos con picos de tres fuentes.">}} -Para configurar múltiples cuentas a la vez, utilice la [API][3], [AWS CLI][4] o [Terraform][5]. Para más información, consulte la [guía de Datadog-Amazon CloudFormation][6]. +Para configurar varias cuentas a la vez, utilice la [API][3], la [AWS CLI][4] o [Terraform][5]. Para obtener más información, consulte la [guía de Datadog-Amazon CloudFormation][6]. -**Nota**: La plantilla de CloudFormation de Datadog solo admite la creación y eliminación de sus recursos definidos. Consulte [Actualiza tu plantilla de pila][59] para obtener orientación sobre cómo aplicar actualizaciones a su pila. +**Nota**: La plantilla de CloudFormation de Datadog solo admite la creación y eliminación de sus recursos definidos. Consulte [Actualizar su plantilla de stack][59] para obtener orientación sobre cómo aplicar actualizaciones a su pila. ### Qué esperar después de la configuración {#what-to-expect-after-setup} -Después de que la integración se configure correctamente, los datos comienzan a aparecer en Datadog en la siguiente línea de tiempo: +Una vez que la integración se configura correctamente, los datos comienzan a aparecer en Datadog en el siguiente cronograma: -- **Métricas**: Aparecen dentro de aproximadamente 10 minutos con sondeo de API, o 2-3 minutos con [CloudWatch Metric Streams][60]. No todos los servicios informan con la misma cadencia, por lo que un tablero parcialmente poblado durante la primera hora es normal. -- **Etiquetas**: Las etiquetas de recursos de AWS pueden tardar tiempo adicional en propagarse. Los cambios en las etiquetas en AWS pueden tardar entre 15 minutos y varias horas en reflejarse en Datadog. -- **Recursos**: Descubiertos durante el próximo ciclo de rastreo de recursos después de la configuración. -- **Registros**: Requieren configuración separada. Consulte [Enviar registros](#send-logs) para instrucciones de configuración. +- **Métricas**: Aparecen en aproximadamente 10 minutos con el sondeo de API, o de 2 a 3 minutos con [CloudWatch Metric Streams][60]. No todos los servicios informan con la misma frecuencia, por lo que es normal que el panel esté parcialmente poblado durante la primera hora. +- **Etiquetas**: Las etiquetas de recursos de AWS pueden tardar más tiempo en propagarse. Los cambios en las etiquetas de AWS pueden tardar desde 15 minutos hasta varias horas en reflejarse en Datadog. +- **Recursos**: Se descubren durante el siguiente ciclo de rastreo de recursos después de la configuración. +- **Logs**: Requieren una configuración por separado. Consulte [Enviar logs](#send-logs) para obtener instrucciones de configuración.
-Datadog no completa los datos históricos de métricas anteriores a que se habilitara la integración. Las métricas comienzan a fluir desde el momento en que la integración se configura correctamente. +Datadog no completa métricas históricas anteriores a la activación de la integración. Las métricas comienzan a fluir desde el momento en que la integración se configura correctamente.
## Configuración {#configuration} -### Habilitar integraciones para servicios individuales de AWS {#enable-integrations-for-individual-aws-services} +### Habilitar Integrations para servicios individuales de AWS {#enable-integrations-for-individual-aws-services} -Consulte la [página de Integraciones][13] para obtener una lista completa de las subintegraciones disponibles. Muchas de estas integraciones se instalan por defecto cuando Datadog reconoce datos provenientes de su cuenta de AWS. +Consulte la [página de Integrations][13] para obtener una lista completa de las subintegraciones disponibles. Muchas de estas Integrations se instalan de forma predeterminada cuando Datadog reconoce datos provenientes de su cuenta de AWS. Utilice la pestaña {{< ui >}}Metric Collection{{< /ui >}} en la [página de integración de AWS][8] para configurar de qué servicios recopila métricas la integración de Datadog. -### Agregue regiones {#add-regions} +### Filtrar métricas por nombre de métrica {#filter-metrics-by-metric-name} -En la pestaña {{< ui >}}General{{< /ui >}} de la [página de integración de AWS][8], puede controlar las regiones de AWS donde Datadog recopila métricas, eventos de CloudWatch y recursos. +Utilice la pestaña {{< ui >}}Metric Collection{{< /ui >}} en la [página de integración de AWS][8] para filtrar las métricas de CloudWatch por espacio de nombres. Expanda un espacio de nombres en la tabla de recolección de métricas de CloudWatch y elija un filtro de **Incluir** o **Excluir**: -## Enviar registros {#send-logs} +- **Incluir**: Recopile solo los nombres de métricas de Datadog que coincidan con los patrones configurados para ese espacio de nombres. +- **Excluir**: Recopile todos los nombres de métricas de Datadog para ese espacio de nombres, excepto aquellos que coincidan con los patrones configurados. -Hay dos formas de enviar registros de servicios de AWS a Datadog: +Cada espacio de nombres puede usar un modo de filtro a la vez. Los patrones de filtro admiten letras minúsculas, números, `.`, `_` y `*`. Por ejemplo, `aws.ec2.network_*` coincide con las métricas de red de EC2. La tabla muestra una vista previa de cuántas métricas coinciden con cada patrón antes de que guarde los cambios. -- [Destino de Amazon Data Firehose][10]: Recomendado para registros de CloudWatch de alto volumen. -- [Función Lambda de reenvío][11]: Requerido para trazas, métricas mejoradas o métricas personalizadas de funciones Lambda. También se recomienda para registros de S3 u otros recursos que no pueden transmitir directamente a Amazon Data Firehose. +Los filtros de nombres de métricas se aplican por espacio de nombres y se evalúan después de que el espacio de nombres se habilita para la recolección de métricas. -Consulte [Habilitar el registro para su servicio de AWS][14] para obtener instrucciones de configuración. +
+Los filtros de nombres de métricas no pueden eliminar aws.ec2.cpuutilization o aws.lambda.invocations. Datadog siempre recopila estas métricas requeridas. +
-### Validación {#validation} +Para administrar los filtros de nombres de métricas mediante programación, consulte [Configurar filtros de nombres de métricas de AWS con la API][61]. -Una vez que haya habilitado los registros, encuéntrelos en el [Explorador de Registros][15] utilizando las facetas `source` o `service` del panel de facetas, como este ejemplo de S3: -{{< img src="getting_started/integrations/logs-explorer.png" alt="La página del Explorador de Registros de la cuenta de Datadog. A la izquierda, la imagen muestra las facetas de Fuente y Servicio, ambas marcadas con 's3'. A la derecha, algunas entradas de registro se muestran en un formato de lista.">}} +### Agregar regiones {#add-regions} -## Obtenga más de la plataforma Datadog {#get-more-from-the-datadog-platform} +En la pestaña {{< ui >}}General{{< /ui >}} de la [AWS integration page][8], puede controlar las regiones de AWS donde Datadog recopila métricas, eventos de CloudWatch y recursos. -### Visibilidad más profunda con el Agente de Datadog en EC2 {#deeper-visibility-with-the-datadog-agent-on-ec2} +## Enviar registros {#send-logs} -Por defecto, la integración de Datadog AWS rastrea la API de CloudWatch para métricas proporcionadas por AWS, pero puede obtener una visibilidad aún más profunda de sus instancias de EC2 con el [Agente de Datadog][16]. El Agente es un demonio ligero que informa métricas y eventos, y también se puede configurar para registros y trazas. La sección de [Instalación del Agente][17] de la aplicación Datadog proporciona instrucciones para instalar el Agente en una amplia variedad de sistemas operativos. Muchos sistemas operativos (por ejemplo, Amazon Linux) tienen comandos de instalación de un solo paso que puedes ejecutar desde la terminal de la instancia para instalar el Agente: -{{< img src="getting_started/integrations/integrations-agent-installation.png" alt="La sección 'Agente' de la pestaña 'Integraciones' en Datadog. A la izquierda se muestra una lista de sistemas operativos compatibles con el Agente de Datadog. 'Amazon Linux' está resaltado en esta lista. A la derecha se muestra 'Usa nuestra fácil instalación de un solo paso'. El comando para instalar el Agente se muestra debajo de esto, con la sección DD_API_KEY ofuscada.">}} +Existen dos formas de enviar registros de servicios de AWS a Datadog: -Una vez que el Agente está instalado, se representa gráficamente dentro de la [Lista de Infraestructura][18] con un ícono de hueso: -{{< img src="getting_started/integrations/infrastructure-list.png" alt="La lista de infraestructura muestra dos servidores en un formato de lista. Ambos servidores muestran el ícono de AWS para la integración de AWS y 'aws' se muestra en un cuadro azul para indicar que están asociados con la integración de AWS. Un servidor también muestra un ícono de hueso de perro y cuadros azules para 'NTP' y 'system'.">}} +- [Destino de Amazon Data Firehose][10]: Recomendado para registros de CloudWatch de alto volumen. +- [Forwarder Lambda function][11]: Requerido para trazas, métricas mejoradas o métricas personalizadas de funciones Lambda. También se recomienda para registros de S3 u otros recursos que no pueden transmitirse directamente a Amazon Data Firehose. -La captura de pantalla anterior muestra el servidor con el Agente de Datadog reportando datos de las verificaciones de [System][19] y [NTP][20]. La verificación de System proporciona métricas sobre CPU, memoria, sistema de archivos y E/S, proporcionando información adicional sobre el servidor. Puedes habilitar integraciones adicionales [integraciones][21] para adaptarlo al entorno y a los casos de uso, o usar [DogStatsD][22] para enviar métricas personalizadas directamente a Datadog. +Consulte [Habilitar el registro para su servicio de AWS][14] para obtener instrucciones de configuración. +### Validación {#validation} + +Una vez que haya habilitado los registros, búsquelos en el [Explorador de registros][15] utilizando las facetas `source` o `service` del panel de facetas, como en este ejemplo de S3: +{{< img src="getting_started/integrations/logs-explorer.png" alt="La página del Explorador de registros de la cuenta de Datadog. A lo largo de la izquierda, la imagen muestra las facetas Fuente y Servicio, ambas marcadas con 's3'. A lo largo de la derecha, algunas entradas de registro se muestran en formato de lista.">}} + +## Obtenga más de la plataforma Datadog {#get-more-from-the-datadog-platform} +### Mayor visibilidad con el Datadog Agent en EC2 {#deeper-visibility-with-the-datadog-agent-on-ec2} -### Usando el Agente de Datadog con los Servicios de Contenedores de Amazon {#using-the-datadog-agent-with-amazon-container-services} +De forma predeterminada, la integración de AWS de Datadog rastrea la API de CloudWatch para obtener métricas proporcionadas por AWS, pero puede obtener una visibilidad aún mayor de sus instancias EC2 con el [Datadog Agent][16]. El Agent es un demonio ligero que reporta métricas y eventos, y también se puede configurar para registros y trazas. La sección [Agent Installation][17] de la aplicación Datadog proporciona instrucciones para instalar el Agent en una amplia variedad de sistemas operativos. Muchos sistemas operativos (por ejemplo, Amazon Linux) tienen comandos de instalación de un solo paso que puede ejecutar desde la terminal de la instancia para instalar el Agent: +{{< img src="getting_started/integrations/integrations-agent-installation.png" alt="La sección 'Agent' de la pestaña 'Integrations' en Datadog. A la izquierda se muestra una lista de los sistemas operativos compatibles con el Datadog Agent. 'Amazon Linux' está resaltado en esta lista. A la derecha se muestra 'Use our easy one-step install'. El comando para instalar el Agent se muestra debajo de esto, con la sección DD_API_KEY ofuscada.">}} -Para entornos basados en contenedores, puedes usar el Agente de Datadog, ya sea que estés gestionando tus instancias o utilizando [Fargate][24] para un entorno sin servidor. +Una vez instalado el Agent, se representa gráficamente dentro de la [Lista de infraestructura][18] con un icono de hueso: +{{< img src="getting_started/integrations/infrastructure-list.png" alt="La lista de infraestructura que muestra dos servidores en formato de lista. Ambos servidores muestran el icono de AWS para la integración de AWS y 'aws' en un cuadro azul para indicar que están asociados con la integración de AWS. Un servidor también muestra un icono de hueso de perro y cuadros azules para 'ntp' y 'system'.">}} +La captura de pantalla anterior muestra el servidor con el Datadog Agent reportando datos de las verificaciones de [System][19] y [NTP][20]. La verificación System proporciona métricas sobre CPU, memoria, sistema de archivos y E/S, brindando información adicional sobre el servidor. Puede habilitar [integraciones][21] adicionales para adaptarse al entorno y a la incidencia, o bien utilizar [DogStatsD][22] para enviar métricas personalizadas directamente a Datadog. +Consulte las [preguntas frecuentes sobre por qué debería instalar el Datadog Agent en sus instancias en la nube][23] para obtener más información sobre los beneficios de este enfoque. -Usa la [documentación de Amazon ECS][25] para ejecutar el [Agente Docker de Datadog][26] en las instancias EC2 de tu clúster ECS. +### Uso del Datadog Agent con Amazon Container Services {#using-the-datadog-agent-with-amazon-container-services} +Para entornos en contenedores, puede utilizar el Datadog Agent, ya sea que administre sus instancias o utilice [Fargate][24] para un entorno sin servidor. +#### ECS con tipo de lanzamiento EC2 {#ecs-with-ec2-launch-type} -Utiliza la [documentación de Amazon ECS en AWS Fargate][28] para ejecutar el Agente como un contenedor en la misma definición de tarea que tu aplicación. +Utilice la [documentación de Amazon ECS][25] para ejecutar el [Datadog Docker Agent][26] en las instancias EC2 de su clúster de ECS. Revise la [documentación de recopilación de datos de Amazon ECS][27] para ver las métricas y eventos reportados a su cuenta de Datadog. +#### ECS con tipo de lanzamiento Fargate {#ecs-with-fargate-launch-type} +Utilice la [documentación de Amazon ECS en AWS Fargate][28] para ejecutar el Agent como un contenedor en la misma definición de tarea que su aplicación. **Nota**: Se necesita la versión 6.1.1 o superior del Datadog Agent para aprovechar al máximo la integración con Fargate. -Utiliza la [documentación de Amazon ECS en AWS Fargate para AWS Batch][58] para ejecutar el Agente como un contenedor en la misma definición de trabajo de AWS Batch que tu aplicación. +#### AWS Batch con tipo de orquestación Fargate {#aws-batch-with-fargate-orchestration-type} +Utilice la [documentación de Amazon ECS en AWS Fargate para AWS Batch][58] para ejecutar el Agent como un contenedor en la misma definición de trabajo de AWS Batch que su aplicación. **Nota**: Se necesita la versión 6.1.1 o superior del Datadog Agent para aprovechar al máximo la integración con Fargate. +#### EKS {#eks} -No necesitas ninguna configuración específica para Amazon Elastic Kubernetes Service (EKS), como se menciona en la [documentación de Distribuciones de Kubernetes][29]. Utiliza la [documentación de Kubernetes dedicada][30] para desplegar el Agente en tu clúster de EKS. +No necesita ninguna configuración específica para Amazon Elastic Kubernetes Service (EKS), como se menciona en la [documentación de distribuciones de Kubernetes][29]. Utilice la [documentación dedicada de Kubernetes][30] para implementar el Agent en su clúster de EKS. #### EKS con Fargate {#eks-with-fargate} -Debido a que los pods de Fargate son gestionados por AWS, excluyen las verificaciones del sistema basadas en el host, como CPU y memoria. Para recopilar datos de sus pods de AWS Fargate, utilice la [documentación de Amazon EKS en AWS Fargate][31] para ejecutar el Agente como un sidecar de su pod de aplicación con control de acceso basado en roles (RBAC) personalizado. **Nota**: Esto requiere la versión 7.17 o superior del Agente de Datadog. +Debido a que los pods de Fargate son administrados por AWS, excluyen las verificaciones del sistema basadas en el servidor, como la CPU y la memoria. Para recopilar datos de sus pods de AWS Fargate, utilice la [documentación de Amazon EKS en AWS Fargate][31] para ejecutar el Agent como sidecar de su pod de aplicación con control de acceso basado en roles (RBAC) personalizado. **Nota**: Esto requiere la versión 7.17 o superior del Datadog Agent. #### EKS Anywhere {#eks-anywhere} -Utilice la [documentación de EKS Anywhere][32] para clústeres de Kubernetes en las instalaciones. +Utilice la [documentación EKS Anywhere][32] para clústeres de Kubernetes locales. ### Crear recursos adicionales de Datadog {#create-additional-datadog-resources} -Además de utilizar la interfaz de usuario de Datadog o [API][33], puede crear muchos [recursos de Datadog][34] con el [Registro de CloudFormation][35]. Para visibilidad y solución de problemas, utilice [tableros][36] para mostrar datos clave, aplicar [Funciones][37] y encontrar [Correlaciones de Métricas][38]. +Además de usar la interfaz de usuario de Datadog o la [API][33], puede crear muchos [Datadog resources][34] con el [CloudFormation Registry][35]. Para obtener visibilidad y solucionar problemas, use [dashboards][36] para mostrar datos clave, aplicar [Functions][37] y encontrar [Metric Correlations][38]. -Para recibir notificaciones de cualquier comportamiento no deseado o inesperado en su cuenta, cree [monitores][39]. Los monitores evalúan constantemente los datos reportados a su cuenta y envían [Notificaciones][40] para asegurar que la información correcta llegue a los miembros del equipo adecuados. Revisa la [Lista de Integraciones de Notificación][41] para conocer todas las formas de notificar a tu equipo. +Para recibir notificaciones sobre cualquier comportamiento no deseado o inesperado en su cuenta, cree [monitors][39]. Los monitores evalúan constantemente los datos reportados a su cuenta y envían [Notifications][40] para garantizar que la información correcta llegue a los miembros del equipo adecuados. Revise la [Lista de Integrations de notificación][41] para conocer todas las formas de notificar a su equipo. -## Explora productos relacionados {#explore-related-products} +## Explorar productos relacionados {#explore-related-products} -### Sin servidor {#serverless} +### Serverless {#serverless} -Para monitorear funciones de AWS Lambda con Datadog, consulta [Serverless][42] para obtener instrucciones sobre cómo instrumentar tu aplicación, instalar [Serverless Libraries and Integrations][43], implementar [trazado distribuido con aplicaciones serverless][44] o [resolver problemas de aplicaciones serverless][45]. +Para hacer un seguimiento de funciones de AWS Lambda con Datadog, consulte [Serverless][42] para obtener instrucciones sobre cómo instrumentar su aplicación, instalar [Bibliotecas Serverless y Integrations][43], implementar [Aplicaciones Serverless de trazo distribuido][44] o [Problemas Serverless de solución de problemas][45]. ### APM {#apm} -Para recopilar trazas distribuidas de tus aplicaciones y servicios de AWS, utiliza el Agente de Datadog con [APM][47]. Para funciones de AWS Lambda, instrumenta con la [Extensión de Lambda de Datadog][44]. Consulta la [documentación de APM][48] para obtener detalles sobre el análisis de datos de rendimiento de la aplicación. +Para recopilar trazas distribuidas de sus aplicaciones y servicios de AWS, utilice el Datadog Agent con [APM][47]. Para funciones de AWS Lambda, instrumente con la [Datadog Lambda Extension][44]. Consulte la [documentación de APM][48] para obtener detalles sobre el análisis de datos de rendimiento de aplicaciones. -También puedes usar [Watchdog][49], una función algorítmica para métricas de rendimiento de APM e infraestructura, para detectar automáticamente y recibir notificaciones sobre posibles problemas de la aplicación. +También puede utilizar [Watchdog][49], una función algorítmica para las métricas de rendimiento de APM y de infraestructura, para detectar automáticamente y recibir notificaciones sobre posibles problemas en la aplicación. -### Seguridad {#security} +### Security {#security} #### Cloud SIEM {#cloud-siem} -Consulta [Introducción a Cloud SIEM][50] para evaluar tus registros contra las [Reglas de Detección de Registros][51] predeterminadas. Estas reglas son personalizables, y cuando se detectan amenazas, generan señales de seguridad accesibles en el [Explorador de señales][52]. Utiliza [Reglas de Notificación][53] para configurar preferencias de notificación en múltiples reglas. +Consulte [Getting Started with Cloud SIEM][50] para evaluar sus registros con las [reglas de detección de registros][51] preconfiguradas. Estas reglas son personalizables y, cuando se detectan amenazas, generan señales de seguridad accesibles en el [Security Signals Explorer][52]. Utilice [Notification Rules][53] para configurar las preferencias de notificación en varias reglas. -#### Errores de configuración de Cloud Security {#cloud-security-misconfigurations} +#### Cloud Security Misconfigurations {#cloud-security-misconfigurations} -Utiliza la guía [Errores de configuración de Cloud Security][54] para detectar y evaluar errores de configuración en tu entorno en la nube. Los datos de configuración de recursos se evalúan contra las reglas de cumplimiento [Cloud][55] y [Infrastructure][56] predeterminadas para señalar técnicas de ataque y posibles errores de configuración. +Utilice la guía [Setting Up Cloud Security Misconfigurations][54] para detectar y evaluar configuraciones erróneas en su entorno de nube. Los datos de configuración de recursos se evalúan con respecto a las reglas de cumplimiento predeterminadas de [Cloud][55] y [infraestructura][56] para identificar técnicas de ataque y posibles configuraciones erróneas. -### Resolución de Problemas {#troubleshooting} +### Solución de problemas {#troubleshooting} -Si encuentra el error `Datadog is not authorized to perform sts:AssumeRole`, consulte la [página de resolución de problemas][2] dedicada. Para cualquier otro problema, consulte la [guía de resolución de problemas de integración de AWS][57]. +Si encuentra el error `Datadog is not authorized to perform sts:AssumeRole`, consulte su [página de solución de problemas][2] dedicada. Para cualquier otro problema, consulte la [guía de solución de problemas de integración de AWS][57]. -## Lectura adicional {#further-reading} +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} @@ -294,4 +317,5 @@ Si encuentra el error `Datadog is not authorized to perform sts:AssumeRole`, con [57]: /es/integrations/guide/aws-integration-troubleshooting/ [58]: /es/integrations/ecs_fargate/?tab=webui#installation-for-aws-batch [59]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-get-template.html -[60]: /es/integrations/guide/aws-cloudwatch-metric-streams-with-kinesis-data-firehose/ \ No newline at end of file +[60]: /es/integrations/guide/aws-cloudwatch-metric-streams-with-kinesis-data-firehose/ +[61]: /es/integrations/guide/aws-metric-name-filters/ \ No newline at end of file diff --git a/hugo/content/es/incident_response/incident_management/_index.md b/hugo/content/es/incident_response/incident_management/_index.md new file mode 100644 index 00000000000..4a5f1ed0f6c --- /dev/null +++ b/hugo/content/es/incident_response/incident_management/_index.md @@ -0,0 +1,171 @@ +--- +aliases: +- /es/monitors/incident_management/ +- /es/service_management/incident_management/ +description: Cree y gestione incidentes +further_reading: +- link: dashboards/querying/#incident-management-analytics + tag: Documentación + text: Análisis de Incident Management +- link: https://learn.datadoghq.com/courses/getting-started-incident-management + tag: Centro de aprendizaje + text: Introducción a Incident Management +- link: https://dtdg.co/fe + tag: Foundation Enablement + text: Únase a una sesión interactiva para mejorar su Incident Management +- link: https://www.datadoghq.com/blog/mobile-incident-management-datadog/ + tag: Blog + text: Gestione y resuelva incidentes sobre la marcha con la aplicación móvil de + Datadog +- link: https://www.datadoghq.com/blog/incident-postmortem-process-best-practices/ + tag: Blog + text: Mejores prácticas para redactar análisis post mortem de incidentes +- link: https://www.datadoghq.com/blog/incident-response-with-datadog/ + tag: Blog + text: Incident Management con Datadog +- link: https://www.datadoghq.com/blog/datadog-service-management/ + tag: Blog + text: Garantice una alta disponibilidad del servicio con Datadog Service Management +- link: https://www.datadoghq.com/blog/how-datadog-manages-incidents/ + tag: Blog + text: Cómo gestionamos incidentes en Datadog +- link: https://www.datadoghq.com/blog/incidents-ai-workbench-status-page/ + tag: Blog + text: Unifique la remediación y la comunicación con Datadog Incident Response +- link: https://www.datadoghq.com/blog/servicenow-datadog-incident-response + tag: Blog + text: Integre ServiceNow ITSM con Datadog para acelerar Incident Response +- link: https://app.datadoghq.com/release-notes?category=Incident%20Management + tag: Notas de la versión + text: ¡Eche un vistazo a las últimas versiones de Incident Management! (Se requiere + inicio de sesión en la aplicación). +title: Incident Management +--- +{{< learning-center-callout header="Únase a una sesión de seminario web de habilitación" hide_image="true" btn_title="Registrarse" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=Incidents">}} + Explore y regístrese en las sesiones de Foundation Enablement. Aprenda cómo Datadog Incident Management permite a los equipos de DevOps y SRE gestionar de manera más efectiva sus flujos de trabajo de respuesta a incidentes de principio a fin, ahorrando tiempo y reduciendo la frustración cuando más importa. +{{< /learning-center-callout >}} + +Datadog Incident Management ayuda a los miembros de su equipo a identificar, mitigar y analizar interrupciones y amenazas a los servicios de su organización. Con Incident Management, puede diseñar un proceso de respuesta mejorado con automatización que ayuda a sus equipos a reunirse en torno a un marco y un conjunto de herramientas compartidos. También puede utilizar el análisis de incidentes para evaluar la eficacia de su proceso de respuesta a incidentes. + +Los incidentes residen en Datadog junto con sus métricas, trazas y registros. Sus equipos pueden declarar incidentes a partir de alertas de seguimiento, señales de seguridad, eventos, casos y más. También puede configurar seguimientos para [declarar incidentes automáticamente][30]. + +## Comience {#get-started} + +Incident Management no requiere instalación. Comience realizando un curso del Learning Center, leyendo nuestra guía paso a paso o declarando un incidente. + +{{< whatsnext desc="Obtenga más información sobre Incident Management:">}} + {{< nextlink href="https://learn.datadoghq.com/courses/intro-to-incident-management" >}}Aprenda sobre Datadog Incident Management mediante ejemplos prácticos{{< /nextlink >}} + {{< nextlink href="https://docs.datadoghq.com/getting_started/incident_management/" >}}Tutorial guiado de un flujo de trabajo de incidentes{{< /nextlink >}} + {{< nextlink href="/incident_response/incident_management/investigate/declare" >}}Declarar un incidente{{< /nextlink >}} +{{< /whatsnext >}} + +## Facturación {#billing} + +Incident Management es un SKU basado en puestos. Para obtener más información sobre cómo se factura Incident Management y cómo administrar los puestos dentro de Datadog, visite nuestra [página de precios][31] y la [documentación de facturación de Incident Response][32]. + +## Visualizar y buscar incidentes {#view-and-search-for-incidents} + +Para visualizar sus incidentes, vaya a la página [Incidents][1] para ver un feed de todos los incidentes en curso. Puede filtrar sus incidentes a través de las propiedades enumeradas a la izquierda, exportar sus resultados de búsqueda y configurar campos adicionales que aparecen para todos los incidentes en [Incident Settings][2]. + +### Ejemplos de búsqueda {#search-examples} + +La búsqueda de incidentes utiliza la misma [sintaxis de búsqueda][33] basada en eventos que Logs y Event Management. Combine pares de `key:value` con operadores booleanos (`AND`, `OR`, `-`) para filtrar incidentes. + +| Consulta | Descripción | +|-------|-------------| +| `severity:SEV-1` | Mostrar todos los incidentes SEV-1 | +| `severity:(SEV-1 OR SEV-2) state:active` | Mostrar todos los incidentes SEV-1 o SEV-2 activos | +| `services:checkout AND -state:resolved` | Mostrar incidentes no resueltos que afectan al servicio de pago | +| `teams:platform` | Mostrar incidentes asignados al equipo de plataforma | +| `services:web*` | Mostrar incidentes que afectan a servicios que comienzan con "web" | +| `Root\ Cause\ Category:Bug ` | Mostrar incidentes con un atributo de causa raíz específico | +| `responder:john.smith@datadoghq.com ` | Mostrar incidentes donde John Smith sea un respondedor | + +### Filtrar y exportar {#filter-and-export} + +- **Filtrar por propiedades**: Utilice el panel de facetas a la izquierda para filtrar por Estado, Gravedad, Tiempo de reparación (horas) y otras propiedades configuradas. +- **Exportar resultados de búsqueda**: Exporte sus resultados de búsqueda utilizando el botón Exportar en la parte superior de la lista de incidentes. +- **Guardar vistas**: Guarde sus consultas de búsqueda y filtros utilizados con frecuencia para un acceso rápido. + +### Acceso móvil {#mobile-access} + +También puede visualizar su lista de Incidents desde la pantalla de inicio de su dispositivo móvil y gestionar/crear incidentes descargando la [aplicación móvil de Datadog][3], disponible en la [Apple App Store][4] y [Google Play Store][5]. + +{{< img src="incident_response/incident_management/iOS_Incident_V2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Dos vistas en la aplicación móvil de Datadog: una que muestra una lista de incidentes con detalles de alto nivel sobre cada incidente, y otra que muestra un panel detallado para un solo incidente.">}} + +## Describir el incidente {#describing-the-incident} + +Al declarar un incidente, es fundamental proporcionar una descripción completa, detallando qué sucedió, por qué ocurrió y los atributos relacionados para garantizar que todas las partes interesadas en el proceso de gestión de incidentes estén completamente informadas. Los elementos esenciales de una declaración de incidente incluyen un título, nivel de gravedad y comandantes de incidente. La documentación eficaz de Incident Management incluye: +- Actualizar los detalles del incidente, incluyendo su estado, impacto, causa raíz, métodos de detección e impactos en el servicio. +- Formar y gestionar un equipo de respuesta, utilizando roles de respondedor personalizados y aprovechando los atributos de metadatos para una evaluación detallada del incidente. +- Configurar notificaciones para mantener a todas las partes interesadas informadas durante todo el proceso de resolución del incidente. + +Para obtener más información, consulte la documentación [Describe an Incident][20]. + +## Evaluar datos de incidentes {#evaluate-incident-data} + +Incident Analytics proporciona información sobre la eficiencia y el rendimiento de su proceso de respuesta a incidentes al permitirle agregar y analizar estadísticas de incidentes pasados. Las métricas clave, como el tiempo de resolución y el impacto en el cliente, se pueden rastrear a lo largo del tiempo. Puede consultar estos análisis utilizando widgets de gráficos en Dashboards y Notebooks. Datadog ofrece plantillas personalizables, como el Incident Management Overview Dashboard y un Notebook Incident Report, para ayudarle a empezar. + +Para obtener más detalles sobre las métricas recopiladas y las configuraciones de gráficos paso a paso para visualizar sus datos, consulte [Incident Management Analytics][10]. + +## Integrations {#integrations} + +Incident Management se integra estrechamente con otros productos de Datadog, incluidos: + +- [Datadog Status Pages][26] para crear páginas de estado públicas o privadas y conectarlas a incidentes. +- [Datadog On-Call][27] para escalar avisos a incidentes y avisar a los equipos de forma manual o automática desde un incidente. +- [Datadog Notebooks][28] para redactar y revisar [postmortems][34]. +- [Datadog Workflow Automation][29] para crear y ejecutar automatizaciones. + +### Integraciones de terceros {#third-party-integrations} + +Incident Management se integra con aplicaciones de terceros, incluidas: + +- [Atlassian Statuspage][25] para crear y actualizar incidentes de Statuspage. +- [Confluence][22] para generar [postmortems][34] de incidentes. +- [CoTerm][21] para seguir las actividades de remediación de incidentes basadas en terminal en tiempo real. +- [Jira][15] para crear un ticket de Jira para un incidente. +- [Microsoft Teams][23] para crear canales y reuniones de video para incidentes. +- [PagerDuty][12] y [OpsGenie][13] para avisar a sus ingenieros de guardia y resolver automáticamente los avisos tras la resolución del incidente. +- [ServiceNow][19] para crear tickets de ServiceNow para incidentes. +- [Slack][11] para crear canales para incidentes. +- [Webhooks][16] para enviar notificaciones de incidentes mediante webhooks (por ejemplo, [enviar SMS a Twilio][17]). +- [Zoom][24] para iniciar videollamadas para incidentes. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/incidents +[2]: https://app.datadoghq.com/incidents/settings +[3]: /es/mobile +[4]: https://apps.apple.com/app/datadog/id1391380318 +[5]: https://play.google.com/store/apps/details?id=com.datadog.app +[6]: /es/incident_response/incident_management/investigate/declare +[7]: /es/account_management/teams/ +[8]: /es/getting_started/tagging/assigning_tags?tab=noncontainerizedenvironments#overview +[9]: /es/tracing/#2-instrument-your-application +[10]: /es/incident_response/incident_management/analytics_and_reporting/ +[11]: /es/integrations/slack/?tab=slackapplicationbeta#using-the-slack-app +[12]: /es/integrations/pagerduty/ +[13]: /es/integrations/opsgenie/ +[15]: /es/integrations/jira/ +[16]: /es/integrations/webhooks/ +[17]: /es/integrations/webhooks/#sending-sms-through-twilio +[18]: /es/integrations/statuspage/ +[19]: /es/integrations/servicenow/ +[20]: /es/incident_response/incident_management/investigate/describe +[21]: /es/coterm +[22]: /es/integrations/confluence/ +[23]: /es/integrations/microsoft-teams/?tab=datadogapprecommended#datadog-incident-management-in-microsoft-teams +[24]: /es/integrations/zoom-incident-management/ +[25]: /es/integrations/statuspage/ +[26]: /es/incident_response/status_pages/ +[27]: /es/incident_response/on-call/ +[28]: /es/notebooks/ +[29]: /es/actions/workflows/ +[30]: /es/incident_response/incident_management/investigate/declare#from-a-monitor +[31]: https://www.datadoghq.com/pricing/?product=incident-response#products +[32]: /es/account_management/billing/incident_response/ +[33]: /es/getting_started/search/#event-based-queries +[34]: /es/incident_response/incident_management/post_incident/postmortems \ No newline at end of file diff --git a/hugo/content/es/integrations/guide/aws-terraform-setup.md b/hugo/content/es/integrations/guide/aws-terraform-setup.md index 0cf7400dcbf..57adba2d2fe 100644 --- a/hugo/content/es/integrations/guide/aws-terraform-setup.md +++ b/hugo/content/es/integrations/guide/aws-terraform-setup.md @@ -1,25 +1,32 @@ --- aliases: - /es/integrations/faq/aws-integration-with-terraform/ +description: Configure la integración de Datadog-AWS con Terraform, incluyendo el + rol de IAM y el recurso de integración. disable_toc: true further_reading: +- link: https://www.datadoghq.com/architecture/a-guide-to-integrating-100-aws-accounts-with-datadog/ + tag: Centro de arquitectura + text: Una guía para integrar más de 100 cuentas de AWS con Datadog - link: https://www.datadoghq.com/blog/managing-datadog-with-terraform/ tag: Blog - text: Gestión de Datadog con Terraform + text: Administrar Datadog con Terraform +- link: https://learn.datadoghq.com/courses/visibility-aws-lambda + tag: Centro de aprendizaje + text: Configurar AWS Lambda para Serverless Monitoring con Datadog title: La integración de AWS con Terraform --- +Usando [Terraform][1], puede crear el rol de IAM de Datadog, el documento de política y la integración de Datadog-AWS con un solo `terraform apply` comando. -Mediante el uso de [Terraform][1], puedes crear el rol IAM de Datadog, el documento de política y la integración Datadog-AWS con un único comando `terraform apply`. - -1. Configura el proveedor de Terraform en Datadog][2] para interactuar con la API de Datadog a través de una configuración de Terraform. - * Si aún no lo has hecho, configura `api_url` con la URL de la API de tu sitio Datadog. - * **Nota**: El recurso `datadog_integration_aws_account` sustituyó al recurso `datadog_integration_aws` en la versión `3.50.0` del proveedor de Datadog Terraform. Para actualizar desde el recurso `datadog_integration_aws`, consulta [Actualización desde recursos de datadog_integration_aws][3]. +1. Configure el [proveedor de Terraform de Datadog][2] para interactuar con la Datadog API a través de una configuración de Terraform. + * Si aún no lo ha hecho, configure `api_url` con la URL de la Datadog API de su sitio. + * **Nota**: El recurso `datadog_integration_aws_account` reemplazó al recurso `datadog_integration_aws` en la versión `3.50.0` del proveedor de Terraform de Datadog. Para actualizar desde el recurso `datadog_integration_aws`, consulte [Actualización desde recursos datadog_integration_aws][3]. {{< site-region region="us,us3,us5,eu" >}} -2. Configura tu archivo de ajustes de Terraform utilizando el siguiente ejemplo como plantilla base. Asegúrate de actualizar los siguientes parámetros antes de aplicar los cambios: - * `AWS_ACCOUNT_ID`: El ID de tu cuenta de AWS. +2. Configure su archivo de configuración de Terraform utilizando el ejemplo a continuación como plantilla base. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios: + * `AWS_ACCOUNT_ID`: Su ID de cuenta de AWS. -Consulta el [registro de Terraform][2] para obtener más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. +Consulte el [Terraform Registry][2] para ver más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. ```hcl data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { @@ -131,17 +138,139 @@ resource "datadog_integration_aws_account" "datadog_integration" { } ``` -
Por defecto, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establece cloud_security_posture_management_collection = true.
+
De forma predeterminada, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establezca cloud_security_posture_management_collection = true.
+ +[1]: /es/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws_account +{{< /site-region >}} + +{{< site-region region="uk1" >}} +2. Configure su archivo de configuración de Terraform utilizando el ejemplo a continuación como plantilla base. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios: + * `AWS_ACCOUNT_ID`: Su ID de cuenta de AWS. + +Consulte el [Terraform Registry][2] para ver más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::117348461845:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +
De forma predeterminada, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establezca cloud_security_posture_management_collection = true.
[1]: /es/integrations/amazon_web_services/?tab=manual#aws-iam-permissions [2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws_account {{< /site-region >}} {{< site-region region="ap1" >}} -2. Configura tu archivo de ajustes de Terraform utilizando el siguiente ejemplo como plantilla base. Asegúrate de actualizar los siguientes parámetros antes de aplicar los cambios: - * `AWS_ACCOUNT_ID`: El ID de tu cuenta de AWS. +2. Configure su archivo de configuración de Terraform utilizando el ejemplo a continuación como plantilla base. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios: + * `AWS_ACCOUNT_ID`: Su ID de cuenta de AWS. -Consulta el [registro de Terraform][2] para obtener más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. +Consulte el [Terraform Registry][2] para ver más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. ```hcl data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { @@ -259,17 +388,17 @@ resource "datadog_integration_aws_account" "datadog_integration" { } ``` -
Por defecto, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establece cloud_security_posture_management_collection = true.
+
De forma predeterminada, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establezca cloud_security_posture_management_collection = true.
[1]: /es/integrations/amazon_web_services/?tab=manual#aws-iam-permissions [2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws {{< /site-region >}} {{< site-region region="ap2" >}} -2. Configura tu archivo de ajustes de Terraform utilizando el siguiente ejemplo como plantilla base. Asegúrate de actualizar los siguientes parámetros antes de aplicar los cambios: - * `AWS_ACCOUNT_ID`: El ID de tu cuenta de AWS. +2. Configure su archivo de configuración de Terraform utilizando el ejemplo a continuación como plantilla base. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios: + * `AWS_ACCOUNT_ID`: Su ID de cuenta de AWS. -Consulta el [registro de Terraform][2] para obtener más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. +Consulte el [Terraform Registry][2] para ver más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. ```hcl data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { @@ -381,15 +510,137 @@ resource "datadog_integration_aws_account" "datadog_integration" { } ``` -
Por defecto, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establece cloud_security_posture_management_collection = true.
+
De forma predeterminada, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establezca cloud_security_posture_management_collection = true.
+ +[1]: /es/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws +{{< /site-region >}} + +{{< site-region region="uk1" >}} +2. Configure su archivo de configuración de Terraform utilizando el ejemplo a continuación como plantilla base. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios: + * `AWS_ACCOUNT_ID`: Su ID de cuenta de AWS. + +Consulte el [Terraform Registry][2] para ver más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::117348461845:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +
De forma predeterminada, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establezca cloud_security_posture_management_collection = true.
[1]: /es/integrations/amazon_web_services/?tab=manual#aws-iam-permissions [2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws {{< /site-region >}} {{< site-region region="gov" >}} -2. Selecciona la pestaña correspondiente a tu tipo de cuenta de AWS y, a continuación, utiliza el ejemplo siguiente como plantilla base para configurar tu archivo de configuración de Terraform. Asegúrate de actualizar los siguientes parámetros antes de aplicar los cambios: - * `AWS_ACCOUNT_ID`: El ID de tu cuenta de AWS. +2. Seleccione la pestaña para su tipo de cuenta de AWS y, luego, utilice el ejemplo a continuación como plantilla base para configurar su archivo de configuración de Terraform. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios: + * `AWS_ACCOUNT_ID`: Su ID de cuenta de AWS. {{< tabs >}} @@ -623,15 +874,261 @@ resource "datadog_integration_aws_account" "datadog_integration" { {{< /tabs >}} -Consulta el [registro de Terraform][2] para obtener más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. +Consulte el [Terraform Registry][2] para ver más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. -
Por defecto, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establece cloud_security_posture_management_collection = true.
+
De forma predeterminada, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establezca cloud_security_posture_management_collection = true.
[1]: /es/integrations/amazon_web_services/?tab=manual#aws-iam-permissions [2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws {{< /site-region >}} -3. Ejecuta `terraform apply`. Espera hasta 10 minutos para que los datos comiencen a recopilarse y, a continuación, consulta el [dashboard de información general de AWS][4] para ver métricas enviadas por tus servicios e infraestructura de AWS. +{{< site-region region="gov2" >}} +2. Seleccione la pestaña para su tipo de cuenta de AWS y, luego, utilice el ejemplo a continuación como plantilla base para configurar su archivo de configuración de Terraform. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios: + * `AWS_ACCOUNT_ID`: Su ID de cuenta de AWS. + +{{< tabs >}} + +{{% tab "AWS Commercial Cloud" %}} + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::382742775718:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +{{% /tab %}} + +{{% tab "AWS GovCloud" %}} + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws-us-gov:iam::486737091498:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws-us-gov:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws-us-gov" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +{{% /tab %}} + +{{< /tabs >}} + +Consulte el [Terraform Registry][2] para ver más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog. + +
De forma predeterminada, la configuración anterior no incluye Cloud Security. Para habilitar Cloud Security, en resources_config, establezca cloud_security_posture_management_collection = true.
+ +[1]: /es/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws +{{< /site-region >}} + +3. Ejecute `terraform apply`. Espere hasta 10 minutos para que los datos comiencen a recopilarse y, a continuación, visualice el [panel de información general de AWS][4] listo para usar para ver las métricas enviadas por sus servicios e infraestructura de AWS. + +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/integrations/guide/slack-actions.md b/hugo/content/es/integrations/guide/slack-actions.md new file mode 100644 index 00000000000..84a5050ca8a --- /dev/null +++ b/hugo/content/es/integrations/guide/slack-actions.md @@ -0,0 +1,99 @@ +--- +description: Utilice las acciones de Slack para gestionar incidentes, On-Call, monitores, + Dashboard, flujos de trabajo, formularios y cuentas directamente desde un espacio + de trabajo de Slack con la aplicación de Datadog instalada. +further_reading: +- link: /integrations/slack/?tab=datadogforslack + tag: Documentación + text: Integración de Slack +title: Acciones de Slack +--- +## Descripción general {#overview} + +Las acciones de Slack están disponibles en cualquier espacio de trabajo de Slack que tenga instalada la aplicación de Datadog. Escriba `/dd` en el espacio de trabajo para abrir una bandeja de acciones que enumera todas las acciones disponibles. Alternativamente, escriba el comando completo directamente. + +## Incidentes {#incidents} +Utilice los siguientes comandos para la navegación de incidentes. Todos los comandos pueden usar `/dd in` como alias para `/dd incident`. Para obtener más detalles, consulte [Integrate Slack with Datadog Incident Management][2]. + +| Comando | Descripción| +| ------------------ | ---------- | +| `/dd in` o `/dd incident` | Declarar un incidente.| +| `/dd in test` | Declarar un incidente de prueba.| +| `/dd in update` o `/dd in edit`| Actualizar el título, el estado, la gravedad y los atributos del incidente.| +| `/dd in responders`| Gestionar el equipo de respuesta del incidente.| +| `/dd in investigate` | Activar Bits Investigation. | +| `/dd in summary` | Generar el resumen del incidente con IA. No disponible en las regiones Gov y Gov2.| +| `/dd in notify` | Notificar a los @-handles sobre el incidente. | +| `/dd in list` | Listar incidentes abiertos.| +| `/dd in private`| Archive el canal actual, cree un canal privado y agregue a todos los respondedores existentes.| +| `/dd in public` | Haga que el incidente y su cronología sean visibles para cualquier persona con permisos de lectura de incidentes. | +| `/dd followup` | Cree un nuevo seguimiento.| +| `/dd followup list` | Listar seguimientos de incidentes.| +| `/dd task` | Cree una tarea de incidente.| +| `/dd task list` | Listar tareas de incidente.| +| `/dd shortcuts` | Visualice las acciones de incidente.| + +## On-Call {#on-call} +Utilice los siguientes comandos para On-Call. Para obtener más detalles, consulte [Páginas de On-Call][3]. + +| Comando | Descripción| +| ------------------ | ---------- | +| `/dd page` | Envíe una notificación a un equipo On-Call.| +| `/dd shifts`| Vea sus próximos turnos On-Call.| +| `/dd override`| Solicite a alguien que cubra un turno On-Call. | + +## Seguimientos {#monitors} +Utilice los siguientes comandos para Monitors. Para obtener más información sobre cómo agregar Slack a Monitors, consulte [Monitor Notifications][4]. + +| Comando | Descripción| +| ------------------ | ---------- | +| `/dd monitors` | Listar Monitors que están actualmente en alerta.| + + +## Dashboard {#dashboard} +Utilice los siguientes comandos para [Dashboards][5]. + +| Comando | Descripción| +| ------------------ | ---------- | +| `/dd dashboard` | Comparta un widget de Dashboard en este canal.| + + +## Flujos de trabajo {#workflows} +Utilice los siguientes comandos para Workflows. Para obtener más información sobre el uso de Slack en Workflows, consulte [Trigger a workflow][6]. + +| Comando | Descripción| +| ------------------ | ---------- | +| `/dd workflow` | Ejecute un flujo de trabajo de automatización.| + + +## Forms {#forms} + +{{% site-region region="gov,gov2" %}} +
+La acción de Slack Share a Form no es compatible en el {{< region-param key="dd_site_name" >}} sitio. +
+{{% /site-region %}} + +Utilice los siguientes comandos para Forms. Para obtener más información, consulte [Forms][8]. + +| Comando | Descripción| +| ------------------ | ---------- | +| `/dd`, luego seleccione **Share a Form** | Busque un formulario de Datadog y compártalo en este canal, donde los destinatarios pueden completarlo en Slack o abrirlo en Datadog. | + + +## Accounts {#accounts} +Utilice los siguientes comandos para [gestión de cuentas][7]. + +| Comando | Descripción| +| ------------------ | ---------- | +| `/dd accounts` | Administre sus cuentas de Datadog vinculadas. | + + +[1]: /es/integrations/slack/?tab=datadogforslack +[2]: /es/incident_response/incident_management/setup_and_configuration/integrations/slack/#slack-commands +[3]: /es/incident_response/on-call/pages/#through-slack +[4]: /es/monitors/notify/#notification-recipients +[5]: /es/dashboards/ +[6]: /es/actions/workflows/trigger/#slack-triggers +[7]: /es/account_management/ +[8]: /es/actions/forms/ \ No newline at end of file diff --git a/hugo/content/es/llm_observability/instrument/agentic/_index.md b/hugo/content/es/llm_observability/instrument/agentic/_index.md index eb8c7cb8a9b..fbbd15704d8 100644 --- a/hugo/content/es/llm_observability/instrument/agentic/_index.md +++ b/hugo/content/es/llm_observability/instrument/agentic/_index.md @@ -13,7 +13,7 @@ title: Instrumentación agéntica ## Requisitos previos {#pre-requisites} -1. Se requiere una Datadog API Key para enviar datos de Agent Observability a Datadog. Sin una clave de API, el usuario no recibirá datos de Agent Observability, por lo que este es un **requisito obligatorio**. Si el usuario aún no ha proporcionado una y no desea hacerlo, continúe instrumentando su aplicación, asegurándose de indicar explícitamente al final que debe configurarla y señálele dónde puede hacerlo. +1. Se requiere una clave de API de Datadog para enviar datos de Agent Observability a Datadog. Sin una clave de API, el usuario no recibirá datos de Agent Observability, por lo que este es un **requisito obligatorio**. Si el usuario aún no ha proporcionado una y no desea hacerlo, continúe instrumentando su aplicación, asegurándose de indicar explícitamente al final que debe configurarla y señálele dónde puede hacerlo. 2. Determine el lenguaje de programación y el framework que se utilizan en la aplicación para instrumentar. Esto es importante para instrumentar correctamente la aplicación. ## Variables de entorno {#environment-variables} @@ -69,6 +69,94 @@ Siga las instrucciones para el lenguaje detectado: | Java | [Instrumentación agéntica de aplicaciones Java](/llm_observability/instrument/agentic/java.md) | | OpenTelemetry | [Instrumentación de OpenTelemetry](/llm_observability/instrument/otel_instrumentation.md) | +{{< agent-only >}} +## Compartir contexto del agente para recomendaciones de verificación {#share-agent-context-for-check-recommendations} + +Complete este paso solo cuando el aviso de incorporación inicial de Datadog incluya una URL de carga de contexto del agente, un token de carga y una versión de esquema. + +Después de la instrumentación: + +1. Inspeccione solo los archivos del repositorio necesarios para comprender el propósito, las herramientas, las reglas de comportamiento explícitas y las condiciones de transferencia del agente. +2. Incluya solo las expectativas respaldadas directamente por un aviso, instrucción, política o prueba citada. Registre un comportamiento atómico por expectativa, expréselo en términos observables en la entrada o salida del agente, el contexto de traza, las llamadas a herramientas, los resultados de las herramientas o su orden, y omita las reglas ambiguas o contradictorias en lugar de adivinar. +3. Cree un resumen JSON delimitado utilizando la versión de esquema del aviso de incorporación y esta forma exacta: + + ```json + { + "schema_version": "", + "context": { + "agent_summary": "A short description of the agent", + "capabilities": [ + { + "name": "...", + "description": "...", + "source_reference_ids": ["source-1"] + } + ], + "tools": [ + { + "name": "...", + "purpose": "...", + "source_reference_ids": ["source-1"] + } + ], + "behavioral_expectations": [ + { + "id": "expectation-1", + "behavior": "...", + "applicability": "...", + "failure": "...", + "observable_signals": ["agent_input", "agent_output"], + "source_reference_ids": ["source-1"] + } + ], + "handoff_conditions": [ + { + "id": "handoff-1", + "condition": "...", + "destination": "...", + "observable_signals": ["agent_input", "agent_output"], + "source_reference_ids": ["source-1"] + } + ], + "source_references": [ + { + "id": "source-1", + "source_kind": "prompt", + "path": "relative/path", + "line_start": 1, + "line_end": 10, + "description": "Why this source supports the summary" + } + ] + } + } + ``` + + Mantenga el objeto `context` codificado en 64 KiB o menos y utilice estos límites de recolección: + + - Hasta 20 capacidades y 30 herramientas. + - Entre 1 y 30 expectativas de comportamiento. + - Hasta 20 condiciones de transferencia. + - Entre 1 y 60 referencias de fuente. + + Utilice entre 1 y 10 ID de referencia de fuente únicos para cada capacidad, herramienta, expectativa de comportamiento y condición de transferencia. Cada expectativa de comportamiento y condición de transferencia debe citar al menos una fuente `prompt`, `instruction`, `policy` o `test` e incluir entre 1 y 6 señales observables únicas. + + Mantenga `agent_summary` entre 1 y 1,000 caracteres. Mantenga los nombres y destinos de transferencia entre 1 y 120 caracteres. Mantenga las descripciones, propósitos, comportamientos, declaraciones de aplicabilidad, fallas, condiciones de transferencia y rutas de fuente entre 1 y 500 caracteres. Mantenga las descripciones de referencia de fuente entre 1 y 300 caracteres. + + Asigne a cada referencia de fuente, expectativa de comportamiento y condición de transferencia un ID de entre 1 y 64 caracteres que contenga solo letras, números, guiones o guiones bajos. Los ID de referencia de fuente deben ser únicos dentro de `source_references`. Los ID de expectativa de comportamiento y condición de transferencia deben ser únicos en ambas colecciones. Los ID son locales para esta carga y permiten que cada verificación recomendada cite su evidencia. + + Utilice `source_kind` solo desde `prompt`, `instruction`, `policy`, `test`, `tool_definition` o `implementation`. Utilice `observable_signals` solo desde `agent_input`, `agent_output`, `trace_context`, `tool_call`, `tool_result` o `tool_order`. Si incluye `line_end`, incluya también un `line_start` positivo y haga que `line_end` sea mayor o igual que `line_start`. + +4. Envíe el JSON una vez a la URL de carga desde el aviso de incorporación. Utilice `POST`, configure `Content-Type: application/json` y pase el token de carga solo en el encabezado `Authorization: Bearer `. + +Siga estos requisitos de seguridad: + +- Trate el token de carga como un secreto de un solo uso. No lo escriba en archivos de fuente, configuración, historial de shell, resultados o registros. +- Cargue solo el resumen estructurado. No cargue código fuente sin procesar, prompts completos, secretos, credenciales, variables de entorno, datos de clientes, contenidos de rastreo o metadatos arbitrarios. +- Utilice rutas de fuente POSIX relativas al repositorio normalizadas y los rangos de líneas útiles más pequeños. No utilice rutas absolutas, barras invertidas, dos puntos, separadores no normalizados ni segmentos de ruta `.` o `..`. Las referencias de fuente identifican la evidencia; no deben copiar su contenido. +- Si la carga falla, continúe con la instrumentación e informe al usuario que Datadog no recibió el contexto opcional. No vuelva a intentarlo con datos más amplios. + +{{< /agent-only >}} ## Instrumente los prompts y ofrezca Prompt Management {#instrument-prompts-and-offer-prompt-management} Prompt Tracking es parte de la instrumentación predeterminada de Agent Observability. Identifique el límite de construcción del prompt para cada llamada de LLM seleccionada y conserve la plantilla del prompt por separado de sus variables dinámicas. @@ -84,7 +172,7 @@ Cuando Prompt Management reemplace un prompt local, utilice el seguimiento autom Informe al usuario que puede acceder a su aplicación y visualizar los datos en Datadog. -**Obligatorio**: proporcione un enlace permanente donde el usuario pueda ver los datos asociados con esta aplicación. Esto tomará la forma de +**Obligatorio**: proporcione un enlace permanente donde el usuario pueda visualizar los datos asociados con esta aplicación. Esto tomará la forma de ``` https://app.{dd_site}/llm/applications?query=@ml_app:{application_name} diff --git a/hugo/content/es/llm_observability/investigate/evaluations/_index.md b/hugo/content/es/llm_observability/investigate/evaluations/_index.md index c78b5af722c..16cce71b682 100644 --- a/hugo/content/es/llm_observability/investigate/evaluations/_index.md +++ b/hugo/content/es/llm_observability/investigate/evaluations/_index.md @@ -14,7 +14,7 @@ title: Evaluaciones --- ## Descripción general {#overview} -Agent Observability ofrece varias formas de admitir evaluaciones. Se pueden configurar navegando a [{{< ui >}}AI Observability{{< /ui >}} > {{< ui >}}Evaluations{{< /ui >}}][8]. +Agent Observability ofrece varias formas de admitir evaluaciones. Se pueden configurar navegando a [{{< ui >}}Agent Observability{{< /ui >}} > {{< ui >}}Evaluations{{< /ui >}}][8]. ### Evaluaciones personalizadas de LLM-as-a-judge {#custom-llm-as-a-judge-evaluations} diff --git a/hugo/content/es/logs/log_configuration/flex_logs.md b/hugo/content/es/logs/log_configuration/flex_logs.md index 8ae1ef08662..6b9adbf3743 100644 --- a/hugo/content/es/logs/log_configuration/flex_logs.md +++ b/hugo/content/es/logs/log_configuration/flex_logs.md @@ -1,223 +1,243 @@ --- aliases: - /es/logs/log_configuration/flex_log/ -description: Capacidades de consulta en directo rentables para la conservación de - logs a largo plazo +description: Capacidades de consulta en vivo rentables sobre la retención a largo + plazo de registros further_reading: - link: https://www.datadoghq.com/blog/flex-logging tag: Blog - text: Almacenamiento y análisis de grandes volúmenes de logs de forma eficaz con - Flex Logs + text: Almacene y analice registros de gran volumen de manera eficiente con Flex + Logs - link: https://www.datadoghq.com/blog/monitor-dns-logs-for-network-and-security-datadog/ tag: Blog - text: Monitorización de logs DNS para la red y los análisis de seguridad + text: Haga un seguimiento de los registros DNS para análisis de red y seguridad +- link: https://www.datadoghq.com/blog/cloud-siem-flex-logs/ + tag: Blog + text: 'Cloud SIEM y Flex Logs: información de seguridad mejorada para la nube' +- link: /logs/guide/flex_compute + tag: Documentación + text: Haga un seguimiento del uso de Flex Compute - link: /logs/log_configuration/indexes tag: Documentación - text: Índices de logs + text: Índices de registros - link: /logs/log_configuration/archives tag: Documentación - text: Archivos de logs + text: Archivos de registros - link: /logs/guide/reduce_data_transfer_fees - tag: Documentation - text: Cómo enviar logs a Datadog y reducir al mismo tiempo los costes de transferencia + tag: Documentación + text: Cómo enviar registros a Datadog mientras reduce las tarifas de transferencia de datos +- link: https://www.datadoghq.com/blog/optimize-high-volume-logs/ + tag: blog + text: Cómo optimizar datos de registro de alto volumen sin comprometer la visibilidad +- link: https://www.datadoghq.com/blog/monitor-flex-compute-usage/ + tag: Blog + text: Haga un seguimiento y optimice el uso de cómputo de sus Flex Logs +- link: https://www.datadoghq.com/blog/flex-logs/ + tag: Blog + text: Almacene y analice registros de gran volumen de manera eficiente con Flex + Logs +- link: https://learn.datadoghq.com/courses/log-indexes + tag: Centro de aprendizaje + text: Administrar y hacer un seguimiento de volúmenes de logs indexados title: Flex Logs --- +## Descripción general {#overview} -## Información general - -A medida que tu organización crece, también lo hace el volumen de logs recopilado de tu infraestructura y tus aplicaciones. Los casos de uso de logs también aumentan en complejidad. Por ejemplo, puede que estés recopilando logs de tu infraestructura, tus aplicaciones, tus herramientas de seguridad, tu red, y así sucesivamente. Todos estos casos de uso tienen distintas necesidades de conservación y consulta. +A medida que su organización crece, el volumen de registros recopilados de su infraestructura y aplicaciones aumenta junto con ella. Los casos de uso para sus registros también aumentan en complejidad. Por ejemplo, es posible que esté recopilando registros de su infraestructura, aplicaciones, herramientas de seguridad, red, etcétera. Todos estos casos de uso tienen necesidades variables de retención y consulta. -Con Flex Logs, sus equipos pueden determinar la capacidad de consulta que necesitan para satisfacer su caso de uso, ya sea un incidente en el que el tiempo es un factor crítico, una investigación de seguridad o una auditoría de conformidad. Al desvincular el almacenamiento de los costes informáticos, Flex Logs proporciona una conservación rentable y a largo plazo de tus logs. +Con Flex Logs, sus equipos pueden determinar la capacidad de consulta que necesitan para cumplir con su caso de uso, ya sea un incidente crítico en cuanto al tiempo, una investigación de seguridad o una auditoría de cumplimiento. Al desacoplar el almacenamiento de los costos de cómputo, Flex Logs proporciona una retención rentable y a largo plazo de sus registros. -Algunos ejemplos de uso del almacenamiento Flex son +Algunos ejemplos de casos de uso para el almacenamiento Flex incluyen: -- Conservación de logs para auditorías a largo plazo. -- Conservación de logs por motivos legales y de cumplimiento normativo. -- Necesidad de disponer de todos los logs para investigaciones de seguridad. -- Necesidad de consultar logs para informes y análisis de datos de elevada cardinalidad durante largos periodos de tiempo. +- Retención de registros para auditorías a largo plazo. +- Retención de registros por motivos de cumplimiento y legales. +- Necesidad de todos los registros para investigaciones de seguridad. +- Necesidad de consultar registros para informes y análisis de datos de alta cardinalidad durante largos períodos de tiempo. -## Cuándo utilizar Flex Logs +## Cuándo usar Flex Logs {#when-to-use-flex-logs} Datadog Log Management ofrece las siguientes soluciones: -- Indexación estándar de logs que deben consultarse con frecuencia y conservarse a corto plazo, como los logs de aplicaciones. -- Flex Logs para logs que deben conservarse a largo plazo, pero que a veces deben consultarse con urgencia, como los logs de seguridad, de transacciones y de red. -- Archivado de los logs que se consultan con poca frecuencia y deben almacenarse a largo plazo, como los logs de auditoría y configuración. +- Indexación Estándar para registros que necesitan consultarse con frecuencia y retenerse a corto plazo, como los registros de aplicaciones. +- Flex Logs para registros que necesitan retenerse a largo plazo, pero que a veces requieren consultas urgentes, como registros de seguridad, transacciones y red. +- Archivado para registros que se consultan con poca frecuencia y necesitan almacenarse a largo plazo, como registros de auditoría y configuración. -Utiliza el espectro de tipos de logs que se muestra en la siguiente imagen para determinar cuándo utilizar el nivel Flex Logs. Cualquier fuente de logs de gran volumen, de acceso poco frecuente o de conservación a largo plazo es una buena candidata. También puedes conservar primero logs en Standard Indexing y luego ampliarlos utilizando Flex Logs. Esta es una solución perfecta para los logs de aplicaciones que necesitas conservar durante más tiempo. Para obtener más información, consulta las [fuentes potenciales para enviar directamente al nivel Flex Logs](#potential-sources-for-sending-directly-to-flex-logs). +Utilice el espectro de tipos de registros que se muestra en la imagen a continuación para determinar cuándo usar el nivel Flex Logs. Cualquier fuente de registros de alto volumen, acceso poco frecuente o retención a largo plazo es una buena candidata. También puede retener registros en Indexación Estándar primero y luego extenderlos usando Flex Logs; esta es una solución perfecta para registros de aplicaciones que necesita retener por más tiempo. Consulte [Fuentes potenciales para enviar directamente al nivel Flex Logs](#potential-sources-for-sending-directly-to-flex-logs) para obtener más información. -{{< img src="logs/log_configuration/flex_logging/logs-spectrum.png" alt="Gráfico del espectro de indexado y la frecuencia de acceso de logs" style="width:100%;" >}} +{{< img src="logs/log_configuration/flex_logging/logs-spectrum.png" alt="Gráfico del espectro de indexación y frecuencia de acceso a registros" style="width:100%;" >}} **Notas**: - Los monitores no son compatibles con Flex Logs. - Watchdog no es compatible con Flex Logs. -- Los dashboards son compatibles con Flex Logs, pero asegúrate de tener en cuenta estas consultas de dashboard cuando elijas el tamaño del cálculo. +- Los tableros son compatibles con Flex Logs; sin embargo, asegúrese de considerar estas consultas de tablero al elegir su tamaño de cómputo. -## Tamaños de cálculos +## Tamaños de cómputo {#compute-sizes} -El cálculo es la capacidad de consulta para ejecutar consultas para Flex Logs. Se utiliza cuando se consultan logs en el nivel Flex Logs. No se utiliza para la ingesta ni cuando sólo se realizan búsquedas en logs de Standard Indexing. Los niveles de cálculo disponibles son: +El cómputo es la capacidad de consulta para ejecutar consultas en Flex Logs. Se utiliza al consultar registros en el nivel de Flex Logs. No se utiliza para la ingesta ni cuando solo se buscan registros de Indexación Estándar. Los niveles de cómputo disponibles son: -
Los tamaños de cálculos disponibles para US3, US5, AP1, US1-FED son Starter, XS y S.
+
Los tamaños de cómputo disponibles para US3, US5, AP1, AP2, US1-FED y US2-FED son Starter, XS y S.
- Starter - Extra pequeño (XS) +- Extra pequeño plus (XS+) - Pequeño (S) -- Medio (M) -- Grande (L) +- Medium (M) +- Large (L) -Cada nivel de cálculo duplica aproximadamente el rendimiento y la capacidad de consulta del nivel anterior. El tamaño del cálculo está limitado por la CPU, el número de consultas simultáneas y el número máximo de logs que se pueden analizar por consulta. +Cada nivel de cómputo tiene aproximadamente el doble del rendimiento de consulta y la capacidad del nivel anterior. El tamaño de cómputo está limitado por la cantidad de consultas simultáneas y el límite máximo de cuántos registros se pueden escanear por consulta. -### Determinar el tamaño de cálculo que necesitas +### Determine el tamaño de cómputo que necesita {#determine-the-compute-size-that-you-need} -El rendimiento de consulta de un nivel de cálculo depende de varios factores: +El rendimiento de consulta de un nivel de cómputo depende de varios factores: - Volumen: La cantidad de datos almacenados en el nivel Flex. -- Periodo de tiempo: El periodo de tiempo de la consulta, por ejemplo un periodo de 15 minutos comparado un periodo de 1 mes de logs. -- Complejidad: El tipo de consulta que ejecutas, por ejemplo, si realiza varios niveles de agregación, si utiliza varios filtros, etc. -- Concurrencia: El número de usuarios que consultan simultáneamente Flex Logs. +- Ventana de tiempo: El espacio temporal de la consulta, por ejemplo, una ventana de 15 minutos en comparación con una ventana de 1 mes de registros. +- Complejidad: El tipo de consulta que ejecuta, por ejemplo, si realiza múltiples niveles de agregación, utiliza múltiples filtros, etcétera. +- Concurrencia: La cantidad de usuarios que consultan Flex Logs de forma simultánea. -Ten en cuenta los siguientes factores a la hora de decidirte por un nivel de cálculo: +Considere los siguientes factores al decidir un nivel de cómputo: -- Tu volumen diario de logs y el número de logs almacenados en el nivel Flex. -- El número de usuarios que consultan regularmente logs del nivel Flex. -- La frecuencia y los tipos de consultas que realizas. Por ejemplo, el periodo de tiempo de consulta que sueles utilizar para consultar tus logs. +- Su volumen diario de registros y la cantidad de registros almacenados en el nivel Flex. +- La cantidad de usuarios que consultan regularmente los registros del nivel Flex. +- La frecuencia y los tipos de consultas que ejecuta. Por ejemplo, las ventanas de tiempo de consulta que utiliza habitualmente para consultar sus registros. -El número de logs almacenados en el nivel Flex es el que más influye en el tamaño que necesitas para consultar los datos de forma eficaz. Datadog recomienda los siguientes tamaños de cálculo basados en el volumen de los logs: -| Tamaño | Volumen (eventos almacenados) | -| ----------------------------------------- | --------------------------- | -| Starter | < 10 mil millones | -| Extra pequeño (XS) | 10 a 50 mil millones | -| Pequeño (S) | 50 a 200 mil millones | -| Mediano (M) | 200 a 500 mil millones | -| Grande (L) | 500 mil millones a 1 billón | -| Ponte en contacto con tu [asesor de clientes][7]| 1T+ | | +La cantidad de registros almacenados en el nivel Flex tiene el mayor impacto en el tamaño necesario para consultar los datos de manera eficiente. Datadog recomienda los siguientes tamaños de cómputo según el volumen de registros: +| Tamaño | Volumen (eventos acumulados almacenados) | +| ----------------------------------------- | ------------------------ | +| Starter | < 10 mil millones | +| Extra Small (XS) | 10 - 50 mil millones | +| Extra Small Plus (XS+) | 50 - 100 mil millones | +| Small (S) | 100 - 200 mil millones | +| Medium (M) | 200 - 500 mil millones | +| Large (L) | 500 mil millones - 1 billón | +| Comuníquese con su [Gerente de éxito del cliente][7]| 1T+ | -Los niveles de cálculo escalables (XS, S, M, L) se facturan a una tarifa fija. El nivel Starter de Flex Logs se factura a una tarifa combinada de almacenamiento+cálculo. Consulte la [página de precios][6] para obtener más información. +Los niveles de cómputo escalables (XS, XS+, S, M, L) se facturan a una tarifa plana. Flex Logs Starter se factura a una tarifa combinada de almacenamiento y cómputo. Consulte la [página de precios][6] para obtener más información. -## Activar y desactivar Flex Logs +## Habilitar y deshabilitar Flex Logs {#enable-and-disable-flex-logs} -Puedes activar o desactivar Flex Logs a nivel de la organización. Para ello, debes disponer del permiso `flex_logs_config_write`. +Puede habilitar o deshabilitar Flex Logs a nivel de organización. Debe tener el permiso [`flex_logs_config_write`][8]. -Si Flex Logs está incluido en tu contrato, las opciones de cálculo disponibles en tu contrato se muestran en la interfaz de usuario. +Si Flex Logs es parte de su contrato, las opciones de cómputo disponibles en su contrato se muestran en la interfaz de usuario. -Si Flex Logs no está incluido en tu contrato, puedes activar el nivel Starter de Flex Logs a través de la opción de incorporación por autoservicio. +Si Flex Logs no está en su contrato, puede habilitar Flex Logs Starter a través de la opción de incorporación de autoservicio. -Para activar Flex Logs: -1. Ve a la página de [control de Flex Logs][5]. -1. Selecciona **Tipo de cálculo**. - - Datadog recomienda el tamaño de cálculo **Starter ** para organizaciones con menos de 10B de logs almacenados. - - Datadog recomienda las opciones de cálculo escalable (por ejemplo, XS, S, M y L) para organizaciones con más de 10B (o 2 a 3B al mes) de logs almacenados. -1. Selecciona el tamaño de cálculo deseado. Para obtener más información, consulta [Determinar el tamaño de cálculo que necesitas](#determine-the-compute-size-that-you-need). -1. Haz clic en **Enable Flex Logs** (Activar Flex Logs). +Para habilitar Flex Logs: +1. Navegue a la página [Flex Logs Control][5]. +1. Seleccione {{< ui >}}Compute Type{{< /ui >}}. + - Datadog recomienda el tamaño de cómputo {{< ui >}}Starter{{< /ui >}} para organizaciones con menos de 10B de registros almacenados. + - Datadog recomienda las opciones de cómputo escalable (por ejemplo, XS, XS+, S, M y L) para organizaciones con más de 10B (o 2-3B por mes) de registros almacenados. +1. Seleccione el tamaño de cómputo que desee. Consulte [Determine el tamaño de cómputo que necesita](#determine-the-compute-size-that-you-need) para obtener más información. +1. Haga clic en {{< ui >}}Enable Flex Logs{{< /ui >}}. -### Offboard de Flex Logs por autoservicio +### Desactivar Flex Logs de autoservicio {#offboard-from-self-serve-flex-logs} -Para desactivar Flex Logs: +Para deshabilitar Flex Logs: -1. Elimina Flex Storage de cada índice en el que esté activado Flex Logs. -1. Vuelve a la página de [control de Flex Logs][5]. -1. Haz clic en el icono de engranaje y selecciona **Disable Flex Logs** (Desactivar Flex Logs). +1. Elimine Flex Storage de cada índice donde Flex Logs esté habilitado. +1. Regrese a la página [Flex Logs Control][5]. +1. Haga clic en el icono de engranaje y seleccione {{< ui >}}Disable Flex Logs{{< /ui >}}. -## Aumentar y reducir los tañamos de cálculo en Flex Logs +## Actualizar y degradar el cómputo de Flex Logs {#upgrade-and-downgrade-flex-logs-compute} -Si seleccionas una de las opciones de cálculo escalable para Flex Logs (por ejemplo, XS, S, M o L), puedes aumentar o reducir el tamaño de tu cálculo en la página de [control de Flex Logs][5]. +Si selecciona una de las opciones de cómputo escalable para Flex Logs (por ejemplo, XS, XS+, S, M o L), puede actualizar o degradar su tamaño de cómputo en la página [Flex Logs Control][5]. **Notas**: -- Sólo están disponibles las opciones de cálculo de tu contrato. -- Una instancia de cálculo puede actualizarse en cualquier momento. -- Una instancia de cálculo puede reducirse una vez cada 15 días. +- Solo se ponen a disposición las opciones de cómputo incluidas en su contrato. La actualización de Flex Starter a una opción de cómputo escalable no aplica el cambio automáticamente. Para habilitar el nuevo tamaño, vaya a la página [Flex Logs Controls][5], seleccione la opción de cómputo deseada y luego haga clic en {{< ui >}}Save{{< /ui >}}. +- Una instancia de cómputo se puede actualizar en cualquier momento. +- Una instancia de cómputo se puede degradar una vez cada 15 días. -## Configurar niveles de almacenamiento +## Configurar niveles de almacenamiento {#configure-storage-tiers} -Flex Logs se configura dentro de las configuraciones de índice de logs. Los [filtros de índice][1] que se aplican a ese índice también se aplican a Flex Logs. Con el nivel Starter de Flex Logs, puedes almacenar logs durante 6, 12 o 15 meses. Con una opción de cálculo escalable, puedes almacenar logs durante 30 a 450 días. +Flex Logs se configura dentro de las configuraciones de índice de registros. Los [filtros de índice][1] que se aplican a ese índice también se aplican a Flex Logs. Con Flex Logs Starter, puede almacenar registros durante 3, 6, 12 o 15 meses. Con una opción de cómputo escalable, puede almacenar registros durante 30-450 días. -Configura el nivel Flex en la página [Configuración de índices de logs][2]: +Configure el nivel Flex en la página [Flex Logs Controls][5]: -1. Ve a la página [Índices][2]. -2. Edita el índice que quieres activar con Flex Logs o crea un nuevo índice. -3. Selecciona **Flex Tier** (Nivel Flex) y configura la opción de conservación en *Configure Storage Tier and Retention* (Configurar el nivel de almacenamiento y la opción de conservación). +1. Haga clic en [Indexes Configuration][2]. +2. Edite el índice que desea habilitar con Flex Logs o cree un índice nuevo. +3. Seleccione {{< ui >}}Flex Tier{{< /ui >}} y establezca la retención en {{< ui >}}Configure Storage Tier and Retention{{< /ui >}}. -{{< img src="logs/log_configuration/flex_logging/flex_configuration.png" alt="Opciones de almacenamiento de nivel Flex en la configuración de índices" style="width:100%;" >}} +{{< img src="logs/log_configuration/flex_logging/flex_configuration.png" alt="Opciones para el almacenamiento del nivel Flex dentro de la configuración del índice" style="width:100%;" >}} -**Nota**: Si se seleccionan ambos niveles, los logs se almacenan en el nivel Estándar hasta el final del período de conservación configurado, antes de almacenarse en el nivel Flex. Por ejemplo, si seleccionas el nivel Estándar con una conservación de 3 días y el nivel Flex con una conservación de 90 días, los logs en ese índice se almacenan primero en el el nivel Estándar durante 3 días y luego en el nivel Flex durante los 87 días restantes. +**Nota**: Si se seleccionan ambos niveles, los registros se almacenan en el Nivel estándar hasta el final del período de retención configurado, antes de almacenarse en el Nivel Flex. Por ejemplo, si selecciona el Nivel estándar con una retención de 3 días y el Nivel Flex con una retención de 90 días: los registros en ese índice se almacenan primero en el Nivel estándar durante 3 días y luego se almacenan en el Nivel Flex durante los 87 días restantes. -La siguiente tabla explica el impacto de añadir o eliminar diferentes niveles de almacenamiento en un índice. +La siguiente tabla explica el impacto de agregar o eliminar diferentes niveles de almacenamiento en un índice. - + - + - - - - + + + + - - - - + + + + - - - - + + + +
Configuración de índices existenteConfiguración de índice existente Acción Resultado
Nivel EstándarNivel estándar Nivel Flex
ActivadoDesactivadoActivar nivel Flex.Se extiende el periodo de conservación de logs preexistentes y nuevos.HabilitadoDeshabilitadoHabilitar el nivel Flex.La retención tanto para los registros preexistentes como para los nuevos se extiende.
DesactivadoActivadoActivar nivel Estándar.Los logs preexistentes en el nivel Flex no cambian. Se conservan los nuevos logs de los niveles Estándar y Flex.DeshabilitadoHabilitadoHabilitar el nivel estándar.Los registros preexistentes en el nivel Flex no se modifican. Los registros nuevos se conservan en el Nivel estándar y en el Nivel Flex.
ActivadoDesactivadoActivar el nivel Flex y eliminar el nivel Estándar.Los logs ya no pueden consultarse en monitores o en Watchdog Insights.HabilitadoDeshabilitadoHabilitar el nivel Flex y eliminar el Nivel estándar.Los registros ya no se pueden consultar en monitors ni en Watchdog Insights.
-## Buscar logs del nivel Flex +## Buscar en el nivel Flex Logs {#search-flex-logs-tier} -{{< img src="logs/log_configuration/flex_logging/flex_toggle_explorer.png" alt="Habilitar la generación de logs Flexen la página del Explorador de logs activando la opción correspondiente" style="width:100%;" >}} +{{< img src="logs/log_configuration/flex_logging/flex_toggle_explorer.png" alt="Habilite Flex Logs en la página del Log Explorer activando la opción" style="width:100%;" >}} -En el Explorador de logs, activa la opción **Incluir Flex Logs** para incluir logs del nivel Flex en los resultados de tu consulta de búsqueda. Encuentra esta opción junto al selector de tiempo. +En el Log Explorer, active la opción {{< ui >}}Include Flex Logs{{< /ui >}} para incluir los registros del Nivel Flex en los resultados de su consulta de búsqueda. Encuentre esta opción junto al selector de tiempo. -[Realiza tu búsqueda][3] escribiendo las consultas en la barra de búsqueda o seleccionando la faceta correspondiente en el panel de facetas. +[Buscar][3] escribiendo consultas en la barra de búsqueda o seleccionando la faceta relevante en el panel de facetas. -Puedes añadir consultas de logs Flex a dashboards, pero asegúrate de tener en cuenta estas consultas de dashboard cuando elijas el tamaño del cálculo. +Puede agregar consultas de Flex Logs a los paneles, pero asegúrese de considerar estas consultas de panel al elegir su tamaño de cómputo. **Nota**: Las consultas de monitor no son compatibles con Flex Logs. -## Información adicional +## Información adicional {#additional-information} -### Posibles fuentes para enviar directamente a Flex Logs +### Fuentes potenciales para enviar directamente a Flex Logs {#potential-sources-for-sending-directly-to-flex-logs} -La siguiente lista es un ejemplo de fuentes de logs que son buenas candidatas para enviar logs directamente al nivel Flex, sin almacenarlos primero en Standard Indexing. No se trata de una lista exhaustiva, sino un ejemplo para que tengas una idea de los tipos de logs adecuados para esta configuración. Otras fuentes de logs (por ejemplo, logs de aplicación) pueden enviarse al nivel Flex después de pasar primero por Standard Indexing, para casos de resolución de problemas, alertas y depuración en directo. Tus casos de uso para estas fuentes podrían variar, algo que es importante tener en cuenta a la hora de tomar la decisión de omitir Standard Indexing. +La siguiente lista es un ejemplo de fuentes de registro que son buenas candidatas para enviar registros directamente al Nivel Flex, sin almacenarlos primero en la indexación estándar. Esta no es una lista exhaustiva y tiene como objetivo darle una idea sobre los tipos de registros que son adecuados para esta configuración. Otras fuentes de registro (por ejemplo, registros de aplicaciones) aún pueden enviarse al Nivel Flex después de pasar primero por la indexación estándar para casos de uso de solución de problemas en vivo, alertas y depuración. Sus casos de uso para estas fuentes podrían variar, lo cual es importante considerar al tomar la decisión de omitir la indexación estándar. -**Nota**: Estos ejemplos son una muestra para cada categoría. Hay muchas más categorías, servicios, herramientas y tecnologías que puedes enviar directamente al nivel Flex. +**Nota**: Estos ejemplos son una muestra para cada categoría. Hay muchas más categorías, servicios, herramientas y tecnologías que quizás desee enviar directamente al Nivel Flex. | Tecnología | Ejemplos | |-----------------------|--------------------------------------------------------------------------------------------| | Gestión de artefactos | JFrog Artifactory, Archiva, Sonatype Nexus | -| Logs de auditoría | Logs de auditoría Amazon Cloudtrail, Kubernetes, auditoría Microsoft 365 | +| Registros de auditoría | Amazon Cloudtrail, registros de auditoría de Kubernetes, auditoría de Microsoft 365 | | Servicios CDN | Akamai, Cloudflare, Fastly, CloudFront | | Servicios CI/CD | GitLab, GitHub Actions, Argo CD, Jenkins, CircleCI, TeamCity | | Servicios DNS | Route53, Cloudflare, Akamai (Edge), NS1 | -| Servicios de identidad | Cisco ISE, Okta, OneLogin, Workday User Activity Logs | -| Balanceadores de carga | AWS ELB, ALB, NLB (opciones GCP and Azure), F5, NGINX | +| Servicios de identidad | Cisco ISE, Okta, OneLogin, registros de actividad de usuario de Workday | +| Balanceadores de carga | AWS ELB, ALB, NLB (versiones de GCP y Azure), F5, NGINX | | Dispositivos de red | Cisco, Meraki, Juniper, Arbua, HPE, Palo Alto, Barracuda | | Servicios de red | WAF, Amazon VPC Flow Logs, AWS ELB, pfSense, Tailscale | | Mallas de servicios | Anthos, Istio, proxyv2, consul, Linkerd, Kong | -### Flex Logs para cuentas de varias organizaciones +### Flex Logs para cuentas de múltiples organizaciones {#flex-logs-for-multiple-organization-accounts} -Para cada organización en la que quieras Flex Logs, debes habilitar un tamaño de cálculo por organización. Sólo se puede utilizar un cálculo por organización y los tamaños de cálculo no se pueden compartir entre organizaciones. En una organización no se pueden utilizar simultáneamente el cálculo Starter y el escalable. +
Cada organización solo puede usar un tamaño de cómputo a la vez. Los tamaños de cómputo no se pueden compartir entre organizaciones, y el cómputo starter y scalable no se pueden usar simultáneamente dentro de la misma organización.
-Datadog suele recomendar los tamaños de cálculo escalables de Flex Logs (XS, S, M y L) para organizaciones con grandes volúmenes de logs. En una configuración de varias organizaciones, suele haber muchas organizaciones con volúmenes de logs inferiores, por lo que para estas organizaciones, Datadog recomienda el tamaño de cálculo Starter de Flex Logs. +Para cada organización en la que desee usar Flex Logs, debe habilitar un tamaño de cómputo. Datadog recomienda los tamaños de cómputo scalable de Flex Logs (XS, XS+, S, M y L) para organizaciones con grandes volúmenes de registros. En una configuración de múltiples organizaciones, a menudo hay muchas organizaciones con volúmenes de registros más bajos, por lo que para estas organizaciones, Datadog recomienda el tamaño de cómputo Starter para Flex Logs. -### Cuando se alcanza el límite de cálculo +### Cuando se alcanza el límite de cómputo {#when-the-compute-limit-is-reached} -Cuando tu organización alcanza el límite de cálculo en términos de consultas concurrentes, puedes experimentar consultas más lentas, ya que las consultas continúan reintentándose hasta que la capacidad esté disponible. Si una consulta se reintenta varias veces, es posible que no se ejecute. En tales situaciones, aparece un mensaje de error que indica que la capacidad de cálculo de Flex Logs es limitada y que debes ponerte en contacto con tu administrador. +Cuando su organización alcanza el límite de cómputo en términos de consultas simultáneas, es posible que experimente consultas más lentas porque las consultas siguen reintentándose hasta que haya capacidad disponible. Si una consulta se reintenta varias veces, es posible que no se ejecute. En tales situaciones, aparece un mensaje de error que indica que la capacidad de cómputo de Flex Logs está limitada y que debe comunicarse con su administrador. -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} @@ -227,4 +247,5 @@ Cuando tu organización alcanza el límite de cálculo en términos de consultas [4]: https://jfrog.com/help/r/jfrog-platform-administration-documentation/monitoring-and-logging [5]: https://app.datadoghq.com/logs/pipelines/flex-logs-controls [6]: https://www.datadoghq.com/pricing/?product=log-management#products -[7]: mailto:success@datadoghq.com \ No newline at end of file +[7]: mailto:success@datadoghq.com +[8]: https://docs.datadoghq.com/es/account_management/rbac/permissions/#log-management \ No newline at end of file diff --git a/hugo/content/es/logs/log_configuration/logs_to_metrics.md b/hugo/content/es/logs/log_configuration/logs_to_metrics.md index 4f7f9067903..4f70456a0b6 100644 --- a/hugo/content/es/logs/log_configuration/logs_to_metrics.md +++ b/hugo/content/es/logs/log_configuration/logs_to_metrics.md @@ -38,7 +38,7 @@ Para generar una nueva métrica basada en registros: 1. Navegue a la página [Generate Metrics][5]. 1. Seleccione la pestaña {{< ui >}}Generate Metrics{{< /ui >}}. -1. Haga clic en {{< ui >}}+New Metric{{< /ui >}}. +1. Haga clic en {{< ui >}}\+ New Metric{{< /ui >}}. También puede crear métricas desde una búsqueda de Analytics seleccionando la opción {{< ui >}}Generate new metric{{< /ui >}} del menú {{< ui >}}Export{{< /ui >}}. @@ -48,7 +48,7 @@ También puede crear métricas desde una búsqueda de Analytics seleccionando la {{< img src="logs/processing/logs_to_metrics/create_custom_metrics2.png" alt="Crear una métrica a partir de registros" style="width:80%;">}} -1. {{< ui >}}Input a query to filter the log stream{{< /ui >}}: Escriba la consulta utilizando la [Log Explorer search syntax][6]. Datadog evalúa la consulta de filtro de flujo contra el flujo de registros en el momento de la ingesta, no contra los registros indexados. El filtro no admite todas las funciones de búsqueda de Log Explorer, incluida la [búsqueda de texto completo][12] (`*:search_term`). Una consulta que devuelve resultados en Log Explorer aún puede no coincidir con ningún registro aquí. La agregación solo considera los registros ingeridos con una marca de tiempo dentro de los últimos 20 minutos. Excluya el índice de la consulta. +1. {{< ui >}}Input a query to filter the log stream{{< /ui >}}: Escriba la consulta utilizando la [sintaxis de búsqueda de Log Explorer][6]. Datadog evalúa la consulta de filtro de flujo contra el flujo de registros en el momento de la ingesta, no contra los registros indexados. El filtro no admite todas las funciones de búsqueda de Log Explorer, incluida la [búsqueda de texto completo][12] (`*:search_term`). Una consulta que devuelve resultados en Log Explorer aún puede no coincidir con ningún registro aquí. La agregación solo considera los registros ingeridos con una marca de tiempo dentro de los últimos 20 minutos. Excluya el índice de la consulta. Después de guardar la métrica, confirme que produce puntos de datos en el [Metrics Explorer][13] antes de confiar en ella. Si la consulta coincide con registros en Log Explorer pero la métrica permanece vacía, reescriba el término como una frase entre comillas; por ejemplo, `message:"Database operation failed."`. 2. {{< ui >}}Select the field you would like to track{{< /ui >}}: Seleccione `*` para generar un conteo de todos los registros que coincidan con su consulta o ingrese un atributo de registro (por ejemplo, `@network.bytes_written`) para agregar un valor numérico y crear sus correspondientes métricas agregadas `count`, `min`, `max`, `sum` y `avg`. Si la faceta del atributo de registro es una [medida][7], el valor de la métrica es el valor del atributo de registro. diff --git a/hugo/content/es/mcp_server/tools.md b/hugo/content/es/mcp_server/tools.md index a85898997c5..ebb1e0d3241 100644 --- a/hugo/content/es/mcp_server/tools.md +++ b/hugo/content/es/mcp_server/tools.md @@ -8,220 +8,226 @@ algolia: - tools aliases: - /es/bits_ai/mcp_server/tools/ -description: Navega por todas las herramientas disponibles en el Servidor MCP de Datadog, - organizadas por conjunto de herramientas, con ejemplos de indicaciones. +description: Explore todas las herramientas disponibles en Datadog MCP Server, organizadas + por toolset, con ejemplos de prompts. further_reading: - link: mcp_server tag: Documentación - text: Servidor MCP de Datadog + text: Datadog MCP Server - link: mcp_server/setup tag: Documentación - text: Configura el Servidor MCP de Datadog -title: Herramientas del Servidor MCP de Datadog + text: Configure el Datadog MCP Server +- link: https://www.datadoghq.com/blog/datadog-mcp-apps/ + tag: Blog + text: 'Datadog MCP Apps: experiencias interactivas en flujos de trabajo de AI' +title: Herramientas del Datadog MCP Server --- -Las siguientes herramientas están disponibles en el Servidor MCP de Datadog. Cada entrada incluye el conjunto de herramientas requerido, permisos y ejemplos de indicaciones. Las herramientas están agrupadas por [conjuntos de herramientas][1], lo que te permite usar solo las herramientas que necesitas, ahorrando valioso espacio en la ventana de contexto. +Las siguientes herramientas están disponibles en Datadog MCP Server. Cada entrada incluye el conjunto de herramientas requerido, los permisos y ejemplos de prompts. Las herramientas están agrupadas por [conjuntos de herramientas][1], lo que le permite usar solo las herramientas que necesita, ahorrando un valioso espacio en la ventana de contexto. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Para habilitar herramientas específicas del producto, incluye el parámetro de consulta `toolsets` al final de la URL del endpoint que utilizas para conectarte al Servidor MCP de Datadog. Por ejemplo, según el [sitio de Datadog][2] que seleccionaste ({{< region-param key="dd_site_name" >}}), esta URL habilita _solo_ herramientas de APM y Observabilidad del Agente: +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Para habilitar herramientas específicas del producto, incluya el parámetro de consulta `toolsets` al final de la URL del punto de conexión que utiliza para conectarse a Datadog MCP Server. Por ejemplo, según su [sitio de Datadog][2] seleccionado ({{< region-param key="dd_site_name" >}}), esta URL habilita _solo_ las herramientas de APM y Agent Observability:
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-También puedes excluir herramientas específicas con el parámetro de consulta `omit_tools`. +También puede excluir herramientas específicas con el parámetro de consulta `omit_tools`. [2]: /es/getting_started/site/ {{< /site-region >}} -Consulta [Configura el Servidor MCP de Datadog][1] para obtener más información sobre cómo conectarte al Servidor MCP, habilitar conjuntos de herramientas y omitir herramientas específicas. +Consulte [Configurar Datadog MCP Server][1] para obtener más información sobre cómo conectarse a Datadog MCP Server, habilitar conjuntos de herramientas y omitir herramientas específicas. -
Las herramientas del Servidor MCP de Datadog están en un desarrollo significativo y están sujetas a cambios. Utiliza este formulario de retroalimentación para compartir cualquier comentario, casos de uso o problemas encontrados con tus indicaciones y consultas.
+
Las herramientas de Datadog MCP Server están en desarrollo significativo y están sujetas a cambios. Utilice este formulario de comentarios para compartir cualquier comentario, caso de uso o problema encontrado con sus prompts y consultas.
## Herramientas principales {#core-tools} -El conjunto de herramientas predeterminado para registros, métricas, trazas, tableros, seguimientos, incidentes, servidores, servicios, eventos y notebooks. +El conjunto de herramientas predeterminado para registros, métricas, trazas, tableros, monitores, incidentes, hosts, servicios, eventos y cuadernos. ### `search_datadog_events` {#search-datadog-events} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Events` y `Timeseries`*\ -Busca eventos como alertas de seguimiento, notificaciones de despliegue, cambios en la infraestructura, hallazgos de seguridad y cambios en el estado del servicio. +Busca eventos como alertas de monitores, notificaciones de despliegue, cambios en la infraestructura, hallazgos de seguridad y cambios en el estado del servicio. -- Muéstrame todos los eventos de despliegue de las últimas 24 horas. -- Encuentra eventos relacionados con nuestro entorno de producción con estado de error. -- Obtén eventos etiquetados con `service:api` de la última hora. +- Muéstreme todos los eventos de despliegue de las últimas 24 horas. +- Busque eventos relacionados con nuestro entorno de producción con estado de error. +- Obtenga los eventos etiquetados con `service:api` de la última hora. -**Nota**: Consulta la [API de Gestión de Eventos][15] para más detalles. +**Nota**: Consulte el [Event Management API][15] para obtener más detalles. ### `get_datadog_incident` {#get-datadog-incident} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Incidents Read`*\ Recupera información detallada sobre un incidente. -- Obtén detalles del incidente ABC123. +- Obtenga los detalles del incidente ABC123. - ¿Cuál es el estado del incidente ABC123? -- Recupera toda la información sobre el incidente de Redis de ayer. +- Recupere la información completa sobre el incidente de Redis de ayer. **Nota**: La herramienta está operativa, pero no incluye datos de la línea de tiempo del incidente. ### `get_datadog_metric` {#get-datadog-metric} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Cloud Cost Management Read` o `Metrics` o `Timeseries`*\ -Consulta y analiza datos métricos históricos o en tiempo real, apoyando consultas personalizadas y agregaciones. +Consulta y analiza datos de métricas históricos o en tiempo real, admitiendo consultas y agregaciones personalizadas. -- Muéstrame las métricas de utilización de CPU para todos los hosts en las últimas 4 horas. -- Obtén métricas de latencia de Redis para el entorno de producción. -- ¿Cuánto cambiaron mis costos en la nube de enero a febrero? +- Muéstreme las métricas de utilización de CPU para todos los hosts en las últimas 4 horas. +- Obtenga las métricas de latencia de Redis para el entorno de producción. +- ¿Cuánto cambiaron mis costos de la nube de enero a febrero? ### `get_datadog_metric_context` {#get-datadog-metric-context} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Cloud Cost Management Read` o `Metrics`*\ -Recupera información detallada sobre una métrica, incluyendo metadatos, etiquetas disponibles y valores de etiquetas para filtrar y agrupar. +Recupera información detallada sobre una métrica, incluyendo metadatos, etiquetas disponibles y valores de etiqueta para filtrar y agrupar. - ¿Qué etiquetas están disponibles para la métrica `system.cpu.user`? -- Muéstrame todos los valores posibles para la etiqueta `env` en `redis.info.latency_ms`. -- Obtén metadatos y dimensiones para la métrica `requests.count`. +- Muéstreme todos los valores posibles para la etiqueta `env` en `redis.info.latency_ms`. +- Obtenga metadatos y dimensiones para la métrica `requests.count`. ### `search_datadog_monitors` {#search-datadog-monitors} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Monitors Read`*\ Recupera información sobre los monitores de Datadog, incluyendo sus estados, umbrales y condiciones de alerta. -- Lista todos los monitores que están actualmente alertando. -- Muéstrame los monitores relacionados con nuestro servicio de pagos. -- Encuentra monitores etiquetados con `team:infrastructure`. +- Enumere todos los monitores que están enviando alertas actualmente. +- Muéstreme los monitores relacionados con nuestro servicio de pago. +- Busque monitores etiquetados con `team:infrastructure`. ### `get_datadog_trace` {#get-datadog-trace} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `APM Read`*\ Obtiene una traza completa de Datadog APM usando un ID de traza. -- Obtén la traza completa para el ID 7d5d747be160e280504c099d984bcfe0. -- Muéstrame todos los tramos para la traza abc123 con información de tiempo. -- Recupera detalles de la traza incluyendo consultas a la base de datos para el ID xyz789. +- Obtenga la traza completa para el ID 7d5d747be160e280504c099d984bcfe0. +- Muéstreme todos los spans para la traza abc123 con información de tiempo. +- Recupere los detalles de la traza, incluidas las consultas a la base de datos, para el ID xyz789. -**Nota**: Las trazas grandes con miles de tramos pueden ser truncadas (y se indicará como tal) sin una forma de recuperar todos los tramos. +**Nota**: Las trazas grandes con miles de spans pueden truncarse (y indicarse como tales) sin forma de recuperar todos los spans. ### `search_datadog_dashboards` {#search-datadog-dashboards} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Dashboards Read` y `User Access Read`*\ -Lista de tableros de Datadog disponibles y detalles clave. +Enumera los tableros de Datadog disponibles y sus detalles clave. -- Muéstrame todos los tableros disponibles en nuestra cuenta. -- Lista de tableros relacionados con la monitorización de infraestructura. -- Encuentra tableros compartidos para el equipo de ingeniería. +- Muéstreme todos los tableros disponibles en nuestra cuenta. +- Enumere los tableros relacionados con el monitoreo de infraestructura. +- Busque tableros compartidos para el equipo de ingeniería. -**Nota**: Esta herramienta enumera tableros relevantes, pero proporciona detalles limitados sobre su contenido. Usa `get_datadog_dashboard` para recuperar definiciones completas de widgets. +**Nota**: Esta herramienta enumera los tableros relevantes pero proporciona detalles limitados sobre su contenido. Usa `get_datadog_dashboard` para recuperar las definiciones completas de los widgets. ### `get_datadog_notebook` {#get-datadog-notebook} *Conjunto de herramientas: **core***\ *Permisos requeridos: `Notebooks Read`*\ Recupera información detallada sobre un notebook específico por ID, incluyendo nombre, estado y autor. -- Obtén detalles del notebook abc-123-def. -- Muéstrame el contenido del notebook de depuración de ayer. +- Obtenga los detalles del notebook abc-123-def. +- Muéstreme el contenido del notebook de depuración de ayer. ### `search_datadog_notebooks` {#search-datadog-notebooks} *Conjunto de herramientas: **core***\ *Permisos requeridos: `Notebooks Read`*\ -Lista y busca notebooks de Datadog con filtrado por autor, etiquetas y contenido. +Enumera y busca notebooks de Datadog con filtrado por autor, etiquetas y contenido. -- Muéstrame todos los notebooks creados por el equipo de plataforma. -- Encuentra notebooks relacionados con la investigación de rendimiento. -- Lista los notebooks etiquetados con `incident-response`. +- Muéstreme todos los notebooks creados por el equipo de plataforma. +- Busque notebooks relacionados con la investigación de rendimiento. +- Enumere los notebooks etiquetados con `incident-response`. ### `search_datadog_hosts` {#search-datadog-hosts} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Hosts Read` y `Timeseries`*\ -Lista y proporciona información sobre los servidores monitoreados, soportando filtrado y búsqueda. +Enumera y proporciona información sobre los hosts monitoreados, permitiendo el filtrado y la búsqueda. -- Muéstrame todos los servidores en nuestro entorno de producción. -- Lista los servidores no saludables que no han reportado en la última hora. -- Obtén todos los servidores etiquetados con `role:database`. +- Muéstreme todos los hosts en nuestro entorno de producción. +- Enumere los hosts en mal estado que no han reportado en la última hora. +- Obtenga todos los hosts etiquetados con `role:database`. ### `search_datadog_incidents` {#search-datadog-incidents} *Conjunto de herramientas: **core***\ *Permisos requeridos: `Incidents Read`*\ -Recupera una lista de incidentes de Datadog, incluyendo su estado, severidad y metadatos. +Recupera una lista de incidentes de Datadog, incluyendo su estado, gravedad y metadatos. -- Muéstrame todos los incidentes activos por severidad. -- Lista los incidentes resueltos de la última semana. -- Encuentra incidentes que impactan a los clientes. +- Muéstreme todos los incidentes activos por gravedad. +- Enumere los incidentes resueltos de la última semana. +- Busque incidentes que afecten al cliente. ### `search_datadog_metrics` {#search-datadog-metrics} *Conjunto de herramientas: **core***\ *Permisos requeridos: `Metrics`*\ -Lista las métricas disponibles, con opciones para filtrar y metadatos. +Enumera las métricas disponibles, con opciones de filtrado y metadatos. -- Muéstrame todas las métricas de Redis disponibles. -- Lista las métricas relacionadas con la CPU para nuestra infraestructura. -- Encuentra métricas etiquetadas con `service:api`. +- Muéstreme todas las métricas de Redis disponibles. +- Enumere las métricas relacionadas con la CPU para nuestra infraestructura. +- Busque métricas etiquetadas con `service:api`. -### `search_datadog_services` {#search-datadog-services} +### `search_datadog_entities` {#search-datadog-entities} *Conjunto de herramientas: **core***\ *Permisos requeridos: `Service Catalog Read`*\ -Lista los servicios en el Catálogo de Datadog con detalles e información del equipo. +Busca en el catálogo de Datadog la identidad del servicio, la propiedad y las dependencias ascendentes y descendentes. -- Muéstrame todos los servicios en nuestra arquitectura de microservicios. -- Lista los servicios propiedad del equipo de plataforma. -- Encuentra servicios relacionados con el procesamiento de pagos. - -### `search_datadog_service_dependencies` {#search-datadog-service-dependencies} -*Conjunto de herramientas: **core***\ -*Permisos requeridos: `APM Read` y `Service Catalog Read` y `Teams Read`*\ -Recupera las dependencias de servicio (ascendentes/descendentes) y los servicios propiedad de un equipo. +- Busque servicios relacionados con el procesamiento de pagos. +- Enumere los servicios propiedad del equipo de la plataforma. +- Muéstreme todos los servicios upstream que llaman al checkout service. +- ¿De qué servicios downstream depende del pago API? -- Muéstreme todos los servicios ascendentes que llaman al servicio de checkout. -- ¿De qué servicios descendentes depende la API de pagos? -- Liste todos los servicios que pertenecen al equipo de plataforma. +
search_datadog_services y search_datadog_service_dependencies Las herramientas están obsoletas, utilice search_datadog_entities en su lugar.
### `search_datadog_spans` {#search-datadog-spans} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `APM Read`*\ -Recupera los tramos de las trazas de APM con filtros como servicio, tiempo, recurso, etc. +Recupera spans de trazas de APM con filtros como servicio, tiempo, recurso, etcétera. -- Muéstreme los tramos con errores del servicio de checkout. -- Encuentra consultas lentas a la base de datos en los últimos 30 minutos. -- Obtén tramos para solicitudes de API fallidas a nuestro servicio de pago. +- Muéstreme los spans con errores del servicio de pago. +- Encuentre consultas de base de datos lentas en los últimos 30 minutos. +- Obtenga los spans de las solicitudes de API fallidas a nuestro servicio de pago. ### `analyze_datadog_logs` {#analyze-datadog-logs} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Logs Read Data` y `Logs Read Index Data` y `Timeseries`*\ -Analiza los registros de Datadog utilizando consultas SQL para conteo, agregaciones y análisis numérico. Utiliza esto para análisis estadístico. +Analiza los Datadog Logs usando consultas SQL para conteos, agregaciones y análisis numérico. Úselo para análisis estadístico. -- Cuenta los registros de errores por servicio en la última hora. -- Muéstrame los 10 códigos de estado HTTP principales con sus conteos. -- ¿Qué servicios estaban registrando más durante ese período de tiempo? +- Cuente los registros de errores por servicio en la última hora. +- Muéstreme los 10 códigos de estado HTTP principales con sus conteos. +- ¿Qué servicios registraban la mayor cantidad de registros durante ese período de tiempo? ### `search_datadog_logs` {#search-datadog-logs} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Logs Read Data` y `Logs Read Index Data`*\ -Busca registros con filtros (tiempo, consulta, servicio, host, nivel de almacenamiento, etc.) y devuelve los detalles del registro. Renombrado de `get_logs`. +Busque registros con filtros (tiempo, consulta, servicio, host, nivel de almacenamiento, etcétera) y devuelva detalles de registro. Renombrado desde `get_logs`. -- Muéstrame los registros de errores del servicio nginx en la última hora. -- Encuentra registros que contengan 'tiempo de conexión agotado' de nuestro servicio de API. -- Obtén todos los registros de código de estado 500 de producción. +- Muéstreme los registros de error del servicio nginx en la última hora. +- Encuentre registros que contengan 'connection timeout' de nuestro servicio de API. +- Obtenga todos los registros con código de estado 500 de producción. ### `search_datadog_rum_events` {#search-datadog-rum-events} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core**, **rum***\ +*Permisos requeridos: `RUM Apps Read`*\ +Busque eventos de Datadog RUM usando sintaxis de consulta avanzada. + +- Muestre errores de JavaScript y advertencias de consola en RUM. +- Encuentre páginas que se cargan lentamente (más de 3 segundos). +- Muestre interacciones recientes de usuario en páginas de detalles de productos. + +### `aggregate_rum_events` {#aggregate-rum-events} +*Conjunto de herramientas: **core**, **rum***\ *Permisos requeridos: `RUM Apps Read`*\ -Busca eventos de RUM de Datadog utilizando sintaxis de consulta avanzada. +Agrega eventos de RUM para calcular conteos, sumas, promedios, mínimos, máximos, cardinalidad y percentiles, con soporte para agrupación. Úselo para análisis estadístico y datos de tendencias, no para inspeccionar eventos individuales. -- Muestra errores de JavaScript y advertencias de consola en RUM. -- Encuentra páginas que se están cargando lentamente (más de 3 segundos). -- Muestra interacciones recientes de usuarios en las páginas de detalles del producto. +- Cuenta los errores de JavaScript por página en las últimas 24 horas. +- Muéstrame el tiempo de carga p95 agrupado por país para mi aplicación RUM principal. +- ¿Cuántas sesiones tuvieron un fallo de Core Web Vitals esta semana? ### `create_datadog_notebook` {#create-datadog-notebook} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Notebooks Read` y `Notebooks Write`*\ Crea un nuevo notebook de Datadog. -- Cree un notebook para documentar la investigación sobre el aumento de latencia del servicio de checkout. -- Crea un nuevo notebook para nuestra revisión de rendimiento semanal. +- Cree un notebook para documentar la investigación sobre el pico de latencia del servicio de pago. +- Cree un nuevo notebook para nuestra revisión de rendimiento semanal. ### `edit_datadog_notebook` {#edit-datadog-notebook} -*Conjunto de herramientas: **núcleo***\ +*Conjunto de herramientas: **core***\ *Permisos requeridos: `Notebooks Read` y `Notebooks Write`*\ -Edite un notebook existente de Datadog. +Edita un notebook de Datadog existente. -- Agregue una sección al notebook abc-123-def con los últimos resultados del análisis de registros. +- Agregue una sección al notebook abc-123-def con los resultados del análisis de registros más recientes. - Actualice el notebook de respuesta a incidentes con los hallazgos de hoy. ## Alerting {#alerting} @@ -231,15 +237,15 @@ Herramientas para validar monitores, buscar grupos de monitores y recuperar plan ### `validate_datadog_monitor` {#validate-datadog-monitor} *Conjunto de herramientas: **Alerting***\ *Permisos requeridos: `Monitors Read`*\ -Valide una definición de monitor para verificar su corrección antes de crearla o actualizarla. +Valida una definición de monitor para verificar su exactitud antes de crearla o actualizarla. -- Valide esta definición de monitor antes de que la cree. +- Valida esta definición de monitor antes de que la cree. - Verifique si la sintaxis de mi consulta de monitor es correcta. ### `get_datadog_monitor_templates` {#get-datadog-monitor-templates} *Conjunto de herramientas: **Alerting***\ *Permisos requeridos: `Monitors Read`*\ -Recupera las plantillas de monitor disponibles para ayudarte a crear monitores. +Recupera las plantillas de monitor disponibles para ayudarle a crear monitores. - Muéstreme las plantillas de monitor disponibles. - ¿Qué plantillas puedo usar para crear un nuevo monitor? @@ -247,81 +253,81 @@ Recupera las plantillas de monitor disponibles para ayudarte a crear monitores. ### `search_datadog_monitor_groups` {#search-datadog-monitor-groups} *Conjunto de herramientas: **Alerting***\ *Permisos requeridos: `Monitors Read`*\ -Busque grupos de monitoreo por nombre o criterios. +Busque grupos de monitores por nombre o criterios. -- Muéstreme todos los grupos de monitoreo en un estado de alerta. -- Encuentre grupos de monitoreo relacionados con el servicio de checkout. +- Muéstreme todos los grupos de monitores en estado de alerta. +- Encuentre grupos de monitores relacionados con el servicio de pago. ### `search_datadog_slos` {#search-datadog-slos} *Conjunto de herramientas: **Alerting***\ *Permisos requeridos: `SLOs Read`*\ -Las búsquedas de SLOs de Datadog se realizan por nombre, etiquetas o tipo. Soporta la sintaxis de consulta para filtrar por servicio, equipo u otros atributos. +Busque SLOs de Datadog por nombre, etiquetas o tipo. Admite sintaxis de consulta para filtrar por servicio, equipo u otros atributos. -- Busca SLOs relacionados con `service:checkout`. -- Lista todos los SLOs etiquetados con `team:backend`. -- Lista SLOs para el servicio de pagos. +- Busque SLOs relacionados con `service:checkout`. +- Enumere todos los SLO etiquetados con `team:backend`. +- Enumere los SLO para el servicio de pago. ### `create_datadog_monitor` {#create-datadog-monitor} -*Conjunto de herramientas: **alerta***\ +*Conjunto de herramientas: **Alerting***\ *Permisos requeridos: `Monitors Write`*\ -Cree un monitor de Datadog en modo borrador. Los monitores creados con esta herramienta no envían notificaciones y están configurados en prioridad 5 (baja). Utilice `validate_datadog_monitor` para verificar la definición antes de crear y `get_datadog_monitor_templates` para ejemplos de sintaxis de consulta. Después de la creación, publique el monitor en la interfaz de usuario de Datadog. +Crea un monitor de Datadog en modo borrador. Los monitores creados con esta herramienta no envían notificaciones y se establecen con prioridad 5 (baja). Utilice `validate_datadog_monitor` para verificar la definición antes de crear y `get_datadog_monitor_templates` para ver ejemplos de sintaxis de consulta. Después de la creación, publique el monitor en la interfaz de usuario de Datadog. -- Cree un monitor de alerta de métrica para el alto uso de CPU en el servicio web. -- Configure un monitor de alerta de registro para picos de errores en el servicio de pagos. -- Cree un monitor para rastrear la latencia p95 para el punto de conexión de checkout. +- Cree un monitor de alerta de métricas para el uso elevado de CPU en el servicio web. +- Configure un monitor de alerta de registros para picos de error en el servicio de pago. +- Cree un monitor para realizar un seguimiento de la latencia p95 para el punto de conexión final de pago. ### `get_monitor_coverage` {#get-monitor-coverage} *Conjunto de herramientas: **Alerting***\ *Permisos requeridos: `Monitors Read`*\ -Encuentre brechas y cobertura de monitoreo para servicios o hosts. Devuelve qué señales (como tasa de errores, latencia y tasa de solicitudes) están cubiertas por monitores existentes y cuáles están faltando. Utilice `create_datadog_monitor` para llenar brechas. +Encuentra brechas en el monitoreo y cobertura para servicios o servidores. Devuelve qué señales (como la tasa de error, la latencia y la tasa de solicitudes) están cubiertas por los monitores existentes y cuáles faltan. Úselo con `create_datadog_monitor` para cubrir las brechas. - Obtenga cobertura de monitoreo para `service:checkout`. - ¿Qué brechas de monitoreo existen para `host:web-01`? -- Encuentre servicios que carecen de monitores de tasa de errores. +- Encuentre servicios a los que les falten monitores de tasa de error. ## APM {#apm} -Herramientas para análisis de trazas [APM][50], búsqueda de spans, información de Watchdog e investigación de rendimiento. +Herramientas para el análisis detallado de traza [APM][50], búsqueda de span, información de Watchdog e investigación de rendimiento. -
El apm El conjunto de herramientas está en vista previa. Regístrese para acceder.
+
El apm El conjunto de herramientas está en versión preliminar. Regístrese para obtener acceso.
### `apm_search_spans` {#apm-search-spans} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Busque tramos utilizando la sintaxis de consulta APM, con soporte para paginación y filtrado de etiquetas. +Busca span mediante la sintaxis de consulta de APM, con compatibilidad para paginación y filtrado por etiquetas. -- Muéstreme tramos con errores del servicio de checkout en la última hora. -- Encuentre consultas lentas a la base de datos que tomen más de 2 segundos. -- Busque tramos con `service:payments` y `status:error`. +- Muéstrame los spans con errores del servicio de pago en la última hora. +- Busque consultas de base de datos lentas que tarden más de 2 segundos. +- Busque spans con `service:payments` y `status:error`. ### `apm_query_trace` {#apm-query-trace} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Consulta los datos de tramo de una traza para filtrar, agregar o clasificar tramos, como encontrar los tramos con mayor tiempo propio o rastrear un error hasta su servicio de origen. +Consulta los datos de span de una traza para filtrar, agregar o clasificar spans, como encontrar los spans con mayor tiempo propio o rastrear un error hasta su servicio de origen. -- Encuentre los 5 tramos principales por tiempo propio en la traza `abc123`. +- Encuentre los 5 spans principales por tiempo propio en la traza `abc123`. - Muestre todos los mensajes de error y sus servicios de origen en la traza `abc123`. -- ¿Qué llamadas a la base de datos en esta traza tomaron más de 500 ms? +- ¿Qué llamadas a la base de datos en esta traza tardaron más de 500ms? ### `apm_discover_span_tags` {#apm-discover-span-tags} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Descubra las claves de etiqueta disponibles en los tramos dentro de un rango de tiempo. +Descubre las claves de etiqueta disponibles en los spans dentro de un rango de tiempo. -- ¿Qué etiquetas están disponibles en los tramos para `service:checkout`? -- Muéstreme las claves de etiqueta por las que puedo filtrar en APM. +- ¿Qué etiquetas están disponibles en los spans para `service:checkout`? +- Muéstrame las claves de etiqueta por las que puedo filtrar en APM. ### `apm_get_primary_tag_keys` {#apm-get-primary-tag-keys} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Recupera las claves de etiqueta primarias configuradas para la organización. +Recupera las claves de etiqueta principales configuradas para la organización. -- ¿Cuáles son las claves principales de etiqueta de mi organización? +- ¿Cuáles son las claves de etiqueta principales de mi organización? ### `apm_search_watchdog_stories` {#apm-search-watchdog-stories} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Busca historias de detección de anomalías de Watchdog para un servicio dentro de un rango de tiempo, proporcionando información impulsada por IA sobre latencia, tasa de errores y anomalías de tráfico. +Busca historias de detección de anomalías de Watchdog para un servicio dentro de un rango de tiempo, proporcionando información basada en IA sobre anomalías de latencia, tasa de errores y tráfico. - Muéstrame las anomalías de Watchdog para el servicio de checkout en las últimas 24 horas. - ¿Se han detectado anomalías de latencia para mi servicio de API? @@ -329,290 +335,539 @@ Busca historias de detección de anomalías de Watchdog para un servicio dentro ### `apm_get_watchdog_story` {#apm-get-watchdog-story} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Recupera información detallada sobre una historia específica de Watchdog por su ID. +Recupera información detallada sobre una historia específica de Watchdog mediante su ID. -- Obtén los detalles de la historia de Watchdog `abc123`. +- Obtenga los detalles de la historia de Watchdog `abc123`. ### `apm_latency_bottleneck_summary` {#apm-latency-bottleneck-summary} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Analiza los cuellos de botella de latencia a través de trazas en un período de anomalía utilizando cálculos de tiempo propio. Identifica qué combinaciones de servicios y recursos consumen más tiempo propio, detecta patrones de llamadas en cascada y revela las causas raíz de los picos de latencia. +Analiza los cuellos de botella de latencia en las trazas durante un período de anomalía utilizando cálculos de tiempo propio. Identifica qué combinaciones de servicio y recurso consumen la mayor cantidad de tiempo propio, detecta patrones de llamadas en cascada y revela las causas raíz de los picos de latencia. -- Resume los cuellos de botella de latencia para el servicio de checkout entre las 2 p.m. y las 3 p.m. de hoy. -- ¿Qué está consumiendo más tiempo propio en el servicio de pagos durante este pico de latencia? -- Identifica cuáles son los puntos de conexión que son los principales cuellos de botella para `service:api` entre las 10:00 y las 10:30. +- Resuma los cuellos de botella de latencia para el servicio de checkout entre las 2 p. m. y las 3 p. m. de hoy. +- ¿Qué está consumiendo la mayor cantidad de tiempo propio en el servicio de pagos durante este pico de latencia? +- Identifique qué puntos de conexión son los principales cuellos de botella para `service:api` entre las 10:00 y las 10:30. ### `get_change_stories` {#get-change-stories} *Conjunto de herramientas: **apm***\ -Recupera historias de cambios de la API de Seguimiento de Cambios para servicios APM. Utiliza esto para identificar qué cambió (despliegues, banderas de características, actualizaciones de configuración y eventos de infraestructura) durante un rango de tiempo y correlacionar cambios con problemas de rendimiento o incidentes. +Recupera historias de cambios de la API de seguimiento de cambios para servicios de APM. Úselo para identificar qué cambió (implementaciones, flags de funciones, actualizaciones de configuración y eventos de infraestructura) durante un intervalo de tiempo y correlacionar los cambios con problemas de rendimiento o incidentes. -- Muéstrame los despliegues y cambios recientes para el servicio de pagos. +- Muéstreme las implementaciones y cambios recientes para el servicio de pagos. - ¿Qué cambios de infraestructura ocurrieron alrededor del momento de este pico de latencia? -- Encuentra cambios en banderas de características y configuraciones para el servicio de checkout en la última hora. +- Busque cambios en los flags de funciones y la configuración para el servicio de checkout en la última hora. ### `semantic_search_change_stories` {#semantic-search-change-stories} *Conjunto de herramientas: **apm***\ -Busca historias de cambios utilizando lenguaje natural y búsqueda semántica impulsada por IA. Utilice esto para encontrar cambios en banderas de características o despliegues relacionados con un comportamiento, un problema reportado por un usuario, o una parte del producto que está investigando. +Busca historias de cambios utilizando lenguaje natural y búsqueda semántica basada en IA. Úselo para encontrar cambios en flags de funciones o implementaciones relacionados con un comportamiento, un problema reportado por el usuario o una parte del producto que esté investigando. -- ¿Qué cambió recientemente que podría afectar la carga del tablero para usuarios en prueba? -- ¿Qué banderas podrían impactar la autenticación en la página de configuración de facturación? -- Encuentra cambios relacionados con datos de telemetría faltantes en la última semana. +- ¿Qué cambió recientemente que podría afectar la carga del tablero para los usuarios de prueba? +- ¿Qué flags podrían afectar la autenticación en la página de configuración de facturación? +- Busque cambios relacionados con la falta de datos de telemetría en la última semana. ### `apm_search_recommendations` {#apm-search-recommendations} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Busca recomendaciones de APM de Datadog. +Busque recomendaciones de APM de Datadog. -- Muéstrame recomendaciones de APM para mis servicios. +- Muéstreme las recomendaciones de APM para mis servicios. - ¿Hay alguna sugerencia de optimización para mi aplicación? ### `apm_get_recommendation` {#apm-get-recommendation} *Conjunto de herramientas: **apm***\ *Permisos requeridos: `APM Read`*\ -Recupera detalles completos de una recomendación específica de APM por ID. +Recupera los detalles completos de una recomendación de APM específica por ID. + +- Obtenga los detalles de la recomendación `abc123`. -- Obtén los detalles de la recomendación `abc123`. +## Asistente {#assistant} -## Casos {#cases} +Herramientas para interactuar con [Bits Chat][75], el compañero con tecnología de IA que le ayuda a buscar y actuar en Datadog mediante lenguaje natural. -Herramientas para [Case Management][38], incluyendo la creación, búsqueda y actualización de casos; gestión de proyectos; y vinculación de problemas de Jira. +**Nota**: El conjunto de herramientas `assistant` no admite acciones de mutación, como crear, editar o eliminar recursos de Datadog. Para realizar esas acciones, utilice el conjunto de herramientas del producto específico, por ejemplo `dashboards` o `alerting`. + +### `send_message_to_assistant` {#send-message-to-assistant} +*Conjunto de herramientas: **assistant***\ +*Permisos requeridos: `Bits Chat Access`*\ +Envía un mensaje al asistente de Datadog y devuelve su respuesta. Opcionalmente, continúa una conversación existente proporcionando un `conversation_id`. + +- Pregúntele al asistente qué está causando el pico de latencia en el servicio de checkout. +- Continúe la conversación `abc-123-def` y pregúntele al asistente por los siguientes pasos. +- Pídale al asistente que resuma los incidentes P1 abiertos, con el modo de depuración habilitado. + +### `get_assistant_conversation_history` {#get-assistant-conversation-history} +*Conjunto de herramientas: **assistant***\ +*Permisos requeridos: `Bits Chat Access`*\ +Recupera el historial completo de la conversación para una conversación específica del asistente mediante su ID. + +- Obtenga el historial completo de la conversación para la conversación `abc-123-def`. +- Muéstreme todo lo que dijo el asistente en mi última conversación sobre la interrupción de pagos. + +### `list_assistant_conversations` {#list-assistant-conversations} +*Conjunto de herramientas: **assistant***\ +*Permisos requeridos: `Bits Chat Access`*\ +Enumere todas las conversaciones del Asistente de Datadog para el usuario actual. + +- Enumere todas mis conversaciones pasadas con el Asistente de Datadog. +- Muéstreme mis conversaciones más recientes con el asistente. + +## Audit Trail {#audit-trail} + +Herramientas para [Audit Trail][71], que incluyen la búsqueda y recuperación de eventos de Audit Trail y la creación de consultas de búsqueda de Audit Trail. + +### `search_audit_events` {#search-audit-events} +*Conjunto de herramientas: **audit-trail***\ +*Permisos requeridos: `Audit Trail Read`*\ +Busque eventos de Audit Trail utilizando la sintaxis de consulta de Datadog con soporte para paginación. Úselo cuando necesite encontrar y filtrar eventos por atributos específicos. Devuelve eventos de Audit Trail sin metadatos ni valores de activos anteriores o nuevos, a menos que se solicite. + +- ¿Quién eliminó el monitor `abc123`? +- ¿Ha habido intentos fallidos de inicio de sesión en Datadog durante la última semana? +- Busque en Audit Trail para ver si hubo notificaciones de filtración de clave de API este mes. + +### `list_audit_events` {#list-audit-events} +*Conjunto de herramientas: **audit-trail***\ +*Permisos requeridos: `Audit Trail Read`*\ +Enumere los eventos de Audit Trail durante un intervalo de tiempo con soporte para paginación y una consulta opcional. Úselo para escanear eventos recientes de Audit Trail. Devuelve eventos de Audit Trail sin metadatos ni valores de activos anteriores o nuevos, a menos que se solicite. + +- Muéstreme los eventos de Audit Trail de la última hora. + +### `build_audit_trail_query` {#build-audit-trail-query} +*Conjunto de herramientas: **audit-trail***\ +*Permisos requeridos: `Audit Trail Read`*\ +Traduce una descripción en lenguaje natural a una cadena de consulta de Audit Trail. Si no está seguro de la sintaxis de consulta al buscar eventos de Audit Trail, utilice esta herramienta primero con una descripción de los eventos que desea recuperar, luego pase la consulta devuelta y las marcas de tiempo directamente a `search_audit_events`. + +- Proporcione una consulta de Audit Trail para ver quién creó nuevos monitores en las últimas 2 semanas. +- Cree una consulta de Audit Trail para mostrar cuándo se eliminó el tablero `abc123`. +- Genere una consulta de Audit Trail para verificar qué acciones se ejecutaron a través del servidor Datadog MCP. + +## Casos (Work Management) {#cases-work-management} + +Herramientas para [Case Management][38], que incluyen la creación, búsqueda y actualización de casos; la gestión de proyectos; y la vinculación de incidencias de Jira. + +
El cases El conjunto de herramientas no está habilitado de forma predeterminada. Consulte Set Up the Datadog MCP Server para obtener instrucciones sobre cómo habilitar los conjuntos de herramientas.
### `search_datadog_cases` {#search-datadog-cases} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Read`*\ -Busca casos de [Case Management][38] con filtros que incluyen estado, prioridad, proyecto y asignado. Soporta filtrado por rango de tiempo y paginación. +Busque casos de [Case Management][38] con filtros que incluyen estado, prioridad, proyecto y asignado. Admite filtrado por rango de tiempo y paginación. -- Muéstrame todos los casos abiertos asignados a mí. -- ¿Hay algún caso P1 abierto en el proyecto Security Reviews? -- Muéstrame todos los casos abiertos esta semana relacionados con el servicio de pago. +- Muéstreme todas las incidencias abiertas asignadas a mí. +- ¿Hay alguna incidencia P1 abierta en el proyecto Security Reviews? +- Muéstreme todas las incidencias abiertas esta semana relacionadas con el servicio de pago. ### `get_datadog_case` {#get-datadog-case} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Read`*\ -Recupera información detallada sobre un caso específico por ID o clave, incluyendo título, estado, prioridad, asignado y marcas de tiempo. Opcionalmente incluye actividad de la línea de tiempo (comentarios y cambios de estado) y atributos personalizados. +Recupera información detallada sobre una incidencia específica por ID o clave, incluyendo título, estado, prioridad, asignado y marcas de tiempo. Incluye opcionalmente la actividad de la línea de tiempo (comentarios y cambios de estado) y atributos personalizados. - ¿Cuál es la última actualización sobre CASE-1234? Muéstrame la línea de tiempo completa. - ¿Quién está trabajando en este caso y qué progreso se ha hecho hasta ahora? -- Muestra los detalles y todos los comentarios para el caso de migración de base de datos. +- Muestre los detalles y todos los comentarios para la incidencia de migración de base de datos. ### `create_datadog_case` {#create-datadog-case} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Write`*\ -Crea un nuevo caso de [Case Management][38] con un título, proyecto y campos opcionales como descripción, prioridad y asignado. +Crea una nueva incidencia de [Case Management][38] con un título, proyecto y campos opcionales como descripción, prioridad y asignado. -- Estoy viendo un aumento de latencia en el servicio de checkout. Crea un caso P2 para rastrear la investigación. -- Abre un caso de Security Review para la actividad de inicio de sesión sospechosa que encontramos en los registros. +- Estoy viendo un pico de latencia en el servicio de pago. Cree una incidencia P2 para realizar el seguimiento de la investigación. +- Abra una incidencia de Security Review para la actividad de inicio de sesión sospechosa que encontramos en los registros. ### `update_datadog_case` {#update-datadog-case} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Write`*\ -Actualiza los campos de un caso existente, como estado, prioridad, título, descripción, asignado, fecha de vencimiento y atributos personalizados. Solo se actualizan los campos que proporciones. +Actualiza los campos de una incidencia existente, como el estado, la prioridad, el título, la descripción, el asignado, la fecha de vencimiento y los atributos personalizados. Solo se actualizan los campos que usted proporcione. -- Este problema ahora afecta al cliente. Escala el caso CASE-1234 a P1. -- Marca el caso de migración de base de datos como resuelto. -- Establece una fecha de vencimiento para el final de la semana en el caso CASE-1234. +- Este problema ahora afecta al cliente. Escale CASE-1234 a P1. +- Marque la incidencia de migración de base de datos como resuelta. +- Establezca una fecha de vencimiento para el final de la semana en CASE-1234. ### `add_comment_to_datadog_case` {#add-comment-to-datadog-case} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Write`*\ -Agrega un comentario a la línea de tiempo de un caso. Los comentarios admiten formato markdown. +Agregue un comentario a la línea de tiempo de una incidencia. Los comentarios admiten formato markdown. -- Agrega una nota al caso resumiendo lo que encontramos en los registros y trazas. -- Publica una actualización de que el hotfix ha sido implementado y estamos haciendo seguimiento. -- Documenta los hallazgos del análisis de la causa raíz en este caso. +- Agregue una nota a la incidencia resumiendo lo que encontramos en los registros y trazas. +- Publique una actualización indicando que el hotfix se ha implementado y que estamos haciendo un seguimiento. +- Documente los hallazgos del análisis de causa raíz en esta incidencia. ### `link_jira_issue_to_datadog_case` {#link-jira-issue-to-datadog-case} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Write`* -- Vincula el ticket de Jira para la migración de infraestructura a este caso para que podamos rastrear ambos juntos. -- Conecta PROJ-456 al caso de Datadog para que el equipo de ingeniería tenga visibilidad. +- Vincule el ticket de Jira para la migración de infraestructura a esta incidencia para que podamos realizar el seguimiento de ambos juntos. +- Conecte PROJ-456 a la incidencia de Datadog para que el equipo de ingeniería tenga visibilidad. ### `list_datadog_case_projects` {#list-datadog-case-projects} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Read`*\ -Lista los proyectos disponibles de [Case Management][38] con filtrado opcional por nombre o clave. +Enumera los proyectos disponibles en [Case Management][38] con filtrado opcional por nombre o clave. - ¿Qué proyectos están disponibles en Case Management? -- ¿Hay un proyecto relacionado con la seguridad en Case Management? +- ¿Hay algún proyecto relacionado con Security en Case Management? ### `get_datadog_case_project` {#get-datadog-case-project} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `Cases Read`*\ -Recupera detalles de un proyecto de Case Management específico por ID. +Recupera los detalles de un proyecto de incidencia específico por ID. -- ¿De qué proyecto forma parte este caso? +- ¿De qué proyecto forma parte esta incidencia? ### `search_datadog_users` {#search-datadog-users} -*Conjunto de herramientas: **casos***\ +*Conjunto de herramientas: **cases***\ *Permisos requeridos: `User Access Read`*\ -Busca usuarios de Datadog por correo electrónico, nombre o identificador. Útil para encontrar a la persona adecuada a la que asignar un caso. +Busca usuarios de Datadog por correo electrónico, nombre o identificador. Útil para encontrar a la persona adecuada a quien asignar una incidencia. Útil para encontrar a la persona adecuada a quien asignar una incidencia. -- Encuentra la cuenta de usuario de Datadog para jane.doe@example.com. +- Busque la cuenta de usuario de Datadog para jane.doe@example.com. -## Ejecución de código {#code-execution} +## Cloud Cost Management {#cloud-cost-management} -Una única herramienta que ejecuta TypeScript escrito por agentes en un entorno controlado por Datadog con acceso directo a las APIs de Datadog, para investigaciones de múltiples señales y exploración de datos ad-hoc en una sola llamada. +Herramientas para [Cloud Cost Management][64], que incluyen una lista de recomendaciones para ahorrar costos clasificadas por el ahorro diario potencial estimado. -
El code-exec El conjunto de herramientas está en vista previa. Regístrese para la vista previa o contacte a Datadog support para solicitar acceso.
+### `cost_recommendations` {#cost-recommendations} +*Conjunto de herramientas: **cost***\ +*Permisos requeridos: `Cloud Cost Management Read`*\ +Enumera las recomendaciones de ahorro de costos de Cloud Cost Management de una organización, clasificadas por el ahorro diario potencial estimado (primero el más alto). Admite filtrado facetado por proveedor de nube, tipo de recomendación, estado, umbral de ahorro y etiquetas de recursos, junto con paginación y un resumen del recuento total y el ahorro diario potencial total. -El código ejecutado por este conjunto de herramientas se ejecuta contra sus APIs de Datadog utilizando su propia identidad de usuario. El entorno aplica sus [permisos de rol existentes][56] a cada llamada a la API, por lo que un agente solo puede leer o modificar datos a los que ya puede acceder en Datadog. +#### Ejemplos de consultas: {#examples-of-queries} + +- ¿Cuáles son mis principales recomendaciones para ahorrar costos en la nube? +- ¿Cuánto podría ahorrar por día y cuántas recomendaciones abiertas tengo? +- ¿Cuál de nuestras optimizaciones de clúster de Kubernetes ya tiene el equipo en marcha? + +## Ejecución de código {#code-execution} + +Una herramienta única que ejecuta TypeScript creado por agentes en un entorno aislado administrado por Datadog con acceso directo a las API de Datadog, para la investigación de múltiples señales y la exploración de datos ad-hoc en una sola llamada. + +El código ejecutado por este conjunto de herramientas se ejecuta contra sus API de Datadog utilizando su propia identidad de usuario. El entorno aislado aplica sus [permisos de rol][56] existentes a cada llamada a la API, por lo que un agente solo puede leer o modificar datos a los que usted ya puede acceder en Datadog. ### `execute_code` {#execute-code} -*Conjunto de herramientas: **ejecución-de-código***\ +*Conjunto de herramientas: **code-exec***\ *Permisos requeridos: Cualquier permiso de rol específico del producto necesario para acceder a los recursos subyacentes de Datadog con los que interactúa el código ejecutado (por ejemplo, `Logs Read` para leer registros).*\ -Ejecuta TypeScript escrito por agentes de IA en un sandbox gestionado por Datadog. El código recibe un `dd.*` espacio de nombres con herramientas para consultar registros, métricas, trazas, servicios, eventos de cambio, incidentes, monitores, Dashboards y otras APIs de Datadog, y devuelve un valor estructurado al agente. Esto puede reducir la cantidad de viajes de ida y vuelta necesarios para investigaciones de múltiples señales y exploración de datos ad-hoc. +Ejecuta TypeScript creado por agentes de IA en un entorno aislado administrado por Datadog. El código recibe un espacio de nombres `dd.*` con asistentes para consultar registros, métricas, trazas, servicios, eventos de cambio, incidentes, monitores, tableros y otras API de Datadog, y devuelve un valor estructurado al agente. Esto puede reducir la cantidad de viajes de ida y vuelta necesarios para investigaciones de múltiples señales y exploración de datos ad-hoc. -- Para el `checkout-api` servicio en las últimas dos horas, extraiga registros de errores, métricas de latencia y despliegues recientes y indíqueme qué despliegue coincide con el pico de errores. -- Compare los conteos de tramos de error, alertas de Monitors y cambios de configuración para el `payments` servicio durante el último día, e identifique cualquier elemento que se haya movido al mismo tiempo. -- Para `auth-service`, correlacione los principales patrones de error en los registros con las métricas de CPU y memoria de la última hora para determinar si los errores se deben a la presión de recursos. +- Para el servicio `checkout-api` en las últimas dos horas, reúna los registros de errores, las métricas de latencia y las implementaciones recientes, y dígame qué implementación coincide con el pico de errores. +- Compare los recuentos de tramos de error, las alertas de monitor y los cambios de configuración para el servicio `payments` durante el último día, e identifique cualquier cosa que se haya movido al mismo tiempo. +- Para `auth-service`, correlacione los principales patrones de error en los registros con las métricas de CPU y memoria de la última hora para ver si los errores siguen la presión de los recursos. ## Dashboards {#dashboards} Herramientas para recuperar, crear, actualizar y eliminar [dashboards][46], además de referencia y validación del esquema de widgets. ### `get_datadog_dashboard` {#get-datadog-dashboard} -*Conjunto de herramientas: **core**, **Dashboards***\ +*Conjunto de herramientas: **core**, **dashboards***\ *Permisos requeridos: `Dashboards Read` y `User Access Read`*\ -Recupera un [dashboard][46] de Datadog por ID, devolviendo su título, descripción, etiquetas y widgets. Utilice `search_datadog_dashboards` primero para encontrar los IDs de los Dashboards. +Recupera un [dashboard][46] de Datadog por ID, devolviendo su título, descripción, etiquetas y widgets. Use `search_datadog_dashboards` primero para encontrar los ID de los tableros. -- Obtenga los detalles completos del Dashboard `ps7-mn3-kwf`. -- Muéstreme los widgets y el diseño del Dashboard de visión general de infraestructura. -- Recupere las variables de plantilla configuradas en este Dashboard. +- Obtenga los detalles completos del tablero `ps7-mn3-kwf`. +- Muéstrame los widgets y el diseño del tablero general de infraestructura. +- Recupera las variables de plantilla configuradas en este tablero. ### `upsert_datadog_dashboard` {#upsert-datadog-dashboard} -*Conjunto de herramientas: **core**, **Dashboards***\ +*Conjunto de herramientas: **core**, **dashboards***\ *Permisos requeridos: `Dashboards Read` y `Dashboards Write`*\ -Crea o actualiza un [dashboard][46] de Datadog. Para actualizar un Dashboard existente, proporcione el ID del Dashboard; omítalo para crear uno nuevo. Llame a `get_widget_reference` para los esquemas de widgets antes de construir widgets. +Crea o actualiza un tablero de Datadog. Para actualizar un dashboard existente, proporcione el ID del dashboard; omítalo para crear uno nuevo. Llame a `get_widget_reference` para obtener los esquemas de los widgets antes de crearlos. -- Cree un Dashboard que muestre el uso de CPU y memoria en todos los hosts. -- Agregue un widget de series temporales para la tasa de errores al Dashboard `abc-123-def`. -- Actualice el título y la descripción de mi Dashboard de visión general de servicio. +- Crear un dashboard que muestre el uso de CPU y memoria en todos los hosts. +- Agregar un widget de series temporales para la tasa de errores al dashboard `abc-123-def`. +- Actualizar el título y la descripción de mi dashboard de resumen de servicio. ### `delete_datadog_dashboard` {#delete-datadog-dashboard} -*Conjunto de herramientas: **Dashboards***\ +*Conjunto de herramientas: **dashboards***\ *Permisos requeridos: `Dashboards Read` y `Dashboards Write`*\ -Elimine permanentemente un [dashboard][46] de Datadog por ID. Esta acción no se puede deshacer. Utilice `search_datadog_dashboards` primero para encontrar los IDs de los Dashboards. +Elimina permanentemente un [dashboard][46] de Datadog por ID. Esta acción no se puede deshacer. Use `search_datadog_dashboards` primero para encontrar los ID de los tableros. -- Elimine el Dashboard `ps7-mn3-kwf`. -- Elimine el antiguo Dashboard del entorno de staging. +- Eliminar el dashboard `ps7-mn3-kwf`. +- Eliminar el dashboard del entorno de staging antiguo. ### `get_widget_reference` {#get-widget-reference} -*Conjunto de herramientas: **Dashboards***\ +*Conjunto de herramientas: **dashboards***\ *Permisos requeridos: `Dashboards Read` o `Dashboards Write` o `Notebooks Read`*\ -Devuelve esquemas e instrucciones de construcción para los tipos de widgets de Dashboard. Las definiciones de widgets son objetos JSON; esta herramienta devuelve definiciones de tipo TypeScript que representan sus esquemas junto con instrucciones de construcción que cubren patrones de consulta, sintaxis de fórmulas y errores comunes. Llame a esto antes de generar widgets con `upsert_datadog_dashboard`. +Devuelve esquemas e instrucciones de creación para los tipos de widgets de dashboard. Las definiciones de widgets son objetos JSON; esta herramienta devuelve definiciones de tipo TypeScript que representan sus esquemas junto con instrucciones de creación que cubren patrones de consulta, sintaxis de fórmulas y errores comunes. Llame a esto antes de generar widgets con `upsert_datadog_dashboard`. - Obtenga el esquema para un widget de series temporales. -- Muéstreme cómo construir un widget de lista de los mejores y un widget de tabla de consulta. -- ¿Cuál es el esquema para el widget de diagrama de dispersión? +- Muéstreme cómo crear un widget de lista superior (toplist) y uno de tabla de consultas. +- ¿Cuál es el esquema para el widget de gráfico de dispersión? ### `validate_dashboard_widget` {#validate-dashboard-widget} -*Conjunto de herramientas: **tableros***\ +*Conjunto de herramientas: **dashboards***\ *Permisos requeridos: `Dashboards Read` o `Dashboards Write` o `Notebooks Read`*\ -Valida una definición de widget contra el esquema del tablero. Utiliza esto para verificar el JSON del widget antes de pasarlo a `upsert_datadog_dashboard`. +Valida una definición de widget contra el esquema del dashboard. Utilice esto para verificar el JSON del widget antes de pasarlo a `upsert_datadog_dashboard`. -- Valida mi definición de widget de series temporales antes de crear el tablero. -- Verifica si el JSON de este widget de tabla de consulta es correcto. +- Valide la definición de mi widget de series temporales antes de crear el dashboard. +- Verifique si este JSON del widget de tabla de consultas es correcto. ### `ask_widget_expert` {#ask-widget-expert} -*Conjunto de herramientas: **tableros***\ +*Conjunto de herramientas: **dashboards***\ *Permisos requeridos: `Dashboards Read` o `Dashboards Write` o `Notebooks Read`*\ -Hazle una pregunta a un experto en widgets de Datadog sobre la configuración de widgets, esquemas, sintaxis de consultas, uso de campos, depuración o problemas comunes. Mejor para preguntas específicas: búsquedas de esquemas, aclaraciones de campos, depuración de una definición de widget existente o comprensión de cómo funciona un tipo específico de widget. +Pregúntele a un experto en widgets de Datadog sobre la configuración de widgets, esquemas, sintaxis de consultas, uso de campos, depuración o errores comunes. Ideal para preguntas específicas: consultas de esquemas, aclaraciones de campos, depuración de una definición de widget existente o comprensión de cómo funciona un tipo de widget específico. -- ¿Qué formato de respuesta debo usar para una lista de los mejores? -- ¿Cuál es el esquema para el widget de diagrama de dispersión? +- ¿Qué response_format debo usar para una lista? +- ¿Cuál es el esquema para el widget de gráfico de dispersión? - Ayúdeme a depurar por qué este widget muestra valores fraccionarios cuando debería ser un conteo. -- ¿Cómo se configura una serie temporal para mostrar tanto barras como líneas? +- ¿Cómo configuro un widget de series temporales para mostrar tanto barras como líneas? + +## Data Observability {#data-observability} + +Herramientas para [Data Observability][70], que incluyen búsqueda en el catálogo de datos, análisis de linaje, monitoreo de calidad de datos y recomendaciones de costo y rendimiento para almacenes de datos y trabajos de Spark. + +### `search_data_entities` {#search-data-entities} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` o `APM Read`*\ +Busca entidades de datos en el catálogo de datos por nombre, búsqueda de texto completo o filtros (plataforma, esquema, base de datos, cuenta). + +- Encuentra tablas llamadas "orders" en Snowflake. +- Listar todos los modelos de dbt que comienzan con `stg_`. +- ¿Qué esquemas existen en mi proyecto de BigQuery? + +### `get_data_catalog_schema` {#get-data-catalog-schema} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` o `APM Read`*\ +Devuelve el esquema de tipo de entidad para cada plataforma con datos en el catálogo: tipos de entidad, jerarquía de contención, atributos filtrables y métricas predeterminadas. + +- ¿Qué plataformas están conectadas a Data Observability? +- ¿Qué tipos de entidad existen para Databricks? +- ¿Qué métricas están disponibles para una entidad de tabla? + +### `get_data_entity_details` {#get-data-entity-details} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` o `APM Read`*\ +Obtiene los detalles y atributos completos (propietario, etiquetas, atributos personalizados, plataforma, esquema, base de datos, cuenta) para una o más entidades de datos por ID. + +- Obtenga los atributos completos para esta entidad de tabla. +- ¿Quién es el propietario de este conjunto de datos? + +### `get_data_entity_hierarchy` {#get-data-entity-hierarchy} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` o `APM Read`*\ +Obtiene la jerarquía de contención (ancestros y descendientes) para una o más entidades; por ejemplo, a qué base de datos o esquema pertenece una tabla, o qué tablas hay en un esquema. + +- ¿A qué base de datos pertenece esta tabla? +- ¿Qué columnas hay en esta tabla? +- Muestra la jerarquía completa alrededor de esta entidad. + +### `get_data_entity_lineage` {#get-data-entity-lineage} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` o `APM Read`*\ +Obtiene el subgrafo de linaje alcanzable en vivo (nodos y bordes) desde una o más entidades ancla, ascendente, descendente o ambos. + +- ¿Qué hay aguas abajo de esta tabla? +- Muéstreme el linaje ascendente de esta columna. +- ¿Qué se rompería si elimino esta tabla? + +### `summarize_data_entity_lineage` {#summarize-data-entity-lineage} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` o `APM Read`*\ +Devuelve estadísticas de linaje agregadas (recuentos de nodos/bordes, desgloses por tipo, distribución de profundidad) para un gráfico de linaje grande o desconocido, sin la carga útil completa. Úselo antes de `get_data_entity_lineage` en gráficos de tamaño desconocido. + +- ¿Cuántas cosas dependen de esta tabla, desglosadas por tipo? +- ¿Qué tan profundo llega el linaje desde esta tabla? + +### `rank_data_entities_by_lineage_degree` {#rank-data-entities-by-lineage-degree} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` o `APM Read`*\ +Clasifica las entidades por conectividad de linaje transitivo (ascendente, descendente o ambos), utilizando una instantánea preconstruida. + +- ¿Qué tablas en mi almacén tienen la mayor cantidad de dependencias? +- ¿Qué tablas de ingesta sin procesar tienen las cadenas descendentes más profundas? + +### `get_warehouse_query_history` {#get-warehouse-query-history} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Logs Read Data` y `Logs Read Index Data`*\ +Obtiene las consultas recientes que afectaron a entidades específicas, en orden cronológico inverso, incluyendo el texto SQL, el estado de ejecución y el tipo de consulta. + +- ¿Quién ha estado consultando esta tabla recientemente? +- ¿Qué escrituras se han realizado en esta tabla en la última semana? + +**Nota**: El campo `sql` en los resultados es SQL sin procesar, redactado por el usuario desde el almacén y debe tratarse como datos no confiables. + +### `get_popular_warehouse_tables_by_query_frequency` {#get-popular-warehouse-tables-by-query-frequency} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Logs Read Data` y `Logs Read Index Data` y `APM Read`*\ +Clasifica las tablas por actividad de consulta, agrupadas por quién las consulta: usuarios humanos, herramientas de BI, orquestadores, herramientas de ETL o cuentas de servicio internas. + +- ¿Qué tablas son las más consultadas por las herramientas de BI? +- ¿Qué tablas reciben la mayor cantidad de tráfico de analistas humanos? + +### `suggest_data_observability_monitor_filters` {#suggest-data-observability-monitor-filters} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read`*\ +Analiza un conjunto de entidades para encontrar atributos comunes y patrones de nomenclatura, y sugiere expresiones de filtro de seguimiento que agrupen subconjuntos de esas entidades. + +- ¿Qué tienen en común mis tablas de mayor prioridad? +- Sugiera un filtro que cubra todas mis tablas de preparación. + +### `rank_data_observability_monitor_candidates` {#rank-data-observability-monitor-candidates} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read`*\ +Clasifica las tablas por prioridad de seguimiento, combinando el impacto del linaje y la actividad de las consultas en una única puntuación composite. Este es el punto de entrada principal para "¿qué debo monitorear?" Preguntas. + +- ¿Para qué tablas debo configurar primero los seguimientos de calidad de datos? + +### `get_data_observability_monitor` {#get-data-observability-monitor} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read` y `Timeseries` y `APM Read`*\ +Recupera series temporales de métricas de calidad de datos para un ID de seguimiento dado, incluidos los límites de detección de anomalías cuando están habilitados. + +- Muéstreme el historial de métricas para el seguimiento `12345`. +- ¿Cuáles son los límites de anomalías para este seguimiento de frescura? + +### `get_data_observability_monitor_coverage` {#get-data-observability-monitor-coverage} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `Monitors Read`*\ +Obtiene todos los seguimientos de calidad de datos para la organización y resuelve el filtro de cada seguimiento para las entidades que cubre. Utilice esto para ver qué tablas no tienen ningún tipo de seguimiento. + +- ¿Cuáles de mis tablas no están cubiertas por ningún seguimiento de calidad de datos? + +### `get_data_observability_monitor_group_statuses` {#get-data-observability-monitor-group-statuses} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read`*\ +Consulta el estado actual de alerta y advertencia de los grupos de seguimientos de calidad de datos. + +- ¿Qué tablas están fallando actualmente en sus verificaciones de calidad de datos? -## DBM {#database-monitoring} +### `get_entity_tags` / `update_entity_tags` {#get-entity-tags-update-entity-tags} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read` o `Monitors Read` (obtener); `Data Observability Catalog Write` (actualizar)*\ +Obtiene o establece etiquetas personalizadas definidas por el usuario en entidades de datos. -Herramientas para interactuar con [DBM][26]. +- ¿Qué etiquetas tiene esta tabla? +- Etiquete esta tabla con `owner:data-platform-team`. + +### `get_entity_descriptions` / `update_entity_description` {#get-entity-descriptions-update-entity-description} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read` o `Monitors Read` (obtener); `Data Observability Catalog Write` (actualizar)*\ +Obtiene o establece descripciones personalizadas definidas por el usuario en entidades de datos. + +- ¿Cuál es la descripción de esta tabla? +- Establezca una descripción que explique para qué se utiliza esta tabla. + +### `get_spark_job_health` {#get-spark-job-health} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read`*\ +Recupera métricas de salud detalladas (duración, tiempo de CPU del ejecutor, shuffle, spill, etapas más lentas) para una sola ejecución de trabajo de Spark o Databricks. + +- ¿Por qué esta ejecución de trabajo de Spark fue lenta? +- Muéstreme las etapas más lentas para la ejecución más reciente de este trabajo. + +### `get_spark_sql_plan` {#get-spark-sql-plan} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read`*\ +Recupera el plan de ejecución física de Spark SQL para una etapa, incluyendo estrategias de unión, información de shuffle y métricas por nodo. + +- Muéstrame el plan de ejecución para esta etapa de Spark. + +### `list_data_observability_recommendations` {#list-data-observability-recommendations} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read`*\ +Enumera recomendaciones de optimización de costos y rendimiento para trabajos y consultas de datos (Spark, Databricks, Snowflake, BigQuery), con ahorros estimados en costos y duración. Devuelve resúmenes ligeros con paginación de cursor. + +- ¿Qué recomendaciones de ahorro de costos tengo para mis trabajos de Databricks? +- ¿Hay alguna recomendación para reducir el sesgo de datos en mis trabajos de Spark? + +### `get_data_observability_recommendation` {#get-data-observability-recommendation} +*Conjunto de herramientas: **data-observability***\ +*Permisos requeridos: `APM Read`*\ +Recupera los detalles completos de una recomendación específica de Data Observability por ID, incluyendo su cuerpo estructurado que describe el problema, la evidencia y el cambio propuesto. + +- Obtenga los detalles de la recomendación `abc123`. + +## Database Monitoring {#database-monitoring} + +Herramientas para interactuar con [Database Monitoring][26]. ### `find_datadog_database_instances` {#find-datadog-database-instances} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Descubre y clasifica instancias de base de datos para la investigación de DBM. Llama a esto antes de otras herramientas de DBM que requieran un parámetro `database_instance`. Acepta un ID de traza o un ID de tramo de APM, etiquetas, o ambos para encontrar instancias coincidentes, luego evalúa y clasifica su salud. +Detecta y clasifica instancias de base de datos para la investigación de DBM. Llame a esto antes que otras herramientas de DBM que requieran un parámetro `database_instance`. Acepta un ID de traza o ID de tramo de APM, etiquetas, o ambos para encontrar instancias coincidentes, luego evalúa y clasifica su estado. - Encuentre instancias de base de datos correlacionadas con la traza `abc123` de hace una hora. - ¿Qué instancias de PostgreSQL coinciden con `cluster_name:payments-prod`? -- Clasifique instancias de base de datos para el servicio `checkout-api` según su salud. +- Clasifique las instancias de base de datos para el servicio `checkout-api` por estado. ### `get_datadog_database_calling_services` {#get-datadog-database-calling-services} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Identifica los servicios y recursos de APM ascendentes que realizan consultas a la base de datos. Correlaciona la actividad de la base de datos con las trazas de la aplicación para el análisis de causa raíz a través de la frontera entre APM y la base de datos. +Identifica servicios y recursos de APM ascendentes que llaman a consultas de base de datos. Correlaciona la actividad de la base de datos con las trazas de la aplicación para el análisis de causa raíz a través del límite entre APM y la base de datos. - ¿Qué servicios están llamando a las consultas más lentas en `db-prod-1`? -- Encuentre al principal llamador de la firma de consulta `abc123def`. -- Muéstreme los recursos de APM que generan carga en la base de datos de pagos. +- Encuentre al llamador principal de la firma de consulta `abc123def`. +- Muéstrame los recursos de APM que generan carga en la base de datos de pagos. ### `get_datadog_database_explain_plans` {#get-datadog-database-explain-plans} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Recupera planes de explicación de PostgreSQL para una firma de consulta dentro de un marco de tiempo. Devuelve estructuras de plan simplificadas con árboles de operadores, uso de índices y costos estimados, ordenados por costo. +Recupera planes de ejecución de PostgreSQL para una firma de consulta dentro de un marco temporal. Devuelve estructuras de plan simplificadas con árboles de operadores, uso de índices y costos estimados, ordenados por costo. -- Obtenga planes de explicación para la firma de consulta `abc123def` en `db-prod-1`. +- Obtenga planes de ejecución para la firma de consulta `abc123def` en `db-prod-1`. - Muéstreme los planes de ejecución más costosos para esta consulta lenta. -- ¿Qué variaciones de plan tiene la firma de consulta `xyz789` en el último día? +- ¿Qué variaciones de plan tiene la firma de consulta `xyz789` durante el último día? ### `get_datadog_database_health_signals` {#get-datadog-database-health-signals} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Ejecuta verificaciones de salud para detectar posibles problemas de PostgreSQL, como saturación de CPU, reinicios, latencia de consultas y bloqueos. Compara un marco de tiempo de regresión contra un período base. +Ejecuta verificaciones de estado para detectar posibles problemas de PostgreSQL, como saturación de CPU, reinicios, latencia de consultas y bloqueos. Compara un marco de tiempo de regresión con un período de referencia. -- Ejecuta verificaciones de salud en `db-prod-1` durante la última hora en comparación con la hora anterior. -- Verifica la salud de la base de datos alrededor del marco de tiempo del incidente. +- Ejecute comprobaciones de estado en `db-prod-1` para la última hora en comparación con la hora anterior. +- Verifique el estado de la base de datos alrededor del marco de tiempo del incidente. - ¿Qué señales explican la regresión en la base de datos de pagos? +### `get_datadog_database_instance_settings` {#get-datadog-database-instance-settings} +*Conjunto de herramientas: **dbm***\ +*Permisos requeridos: `Database Monitoring Read`*\ +Recupera los ajustes de configuración de PostgreSQL recopilados para una instancia de Database Monitoring, los mismos valores que se muestran en la pestaña Configuración. Devuelve los parámetros que afectan el rendimiento y el comportamiento, incluyendo memoria (`shared_buffers`, `work_mem`), conexión (`max_connections`), autovacuum, registro, WAL y configuraciones del planificador de consultas. Filtre por nombre de configuración para limitar los resultados. + +- Muestre las configuraciones de autovacuum para `db-prod-1`. +- ¿Qué configuraciones de registro están habilitadas en la instancia de PostgreSQL de pagos? +- ¿En qué está configurado `shared_buffers` en `db-prod-1`? + ### `get_datadog_database_query_performance` {#get-datadog-database-query-performance} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Analiza el rendimiento de una consulta específica de PostgreSQL. Devuelve el rendimiento, la latencia promedio, el tiempo de ejecución, las filas por ejecución, la tasa de aciertos en caché, las estadísticas de I/O, la actividad de conexión, los eventos de espera y la duración de la transacción, con estadísticas generales y análisis por intervalos de tiempo. +Analiza el rendimiento de una consulta específica de PostgreSQL. Devuelve el rendimiento, la latencia promedio, el tiempo de ejecución, las filas por ejecución, la tasa de aciertos de caché, las estadísticas de E/S, la actividad de conexión, los eventos de espera y la duración de la transacción, con estadísticas generales y análisis por intervalos de tiempo. -- Analiza el rendimiento de la firma de consulta `abc123def` durante la última hora. -- ¿Por qué es lenta esta consulta en la instancia de PostgreSQL de producción? -- Muestra los eventos de espera y la tasa de aciertos en caché para la firma de consulta `xyz789`. +- Analice el rendimiento de la firma de consulta `abc123def` durante la última hora. +- ¿Por qué esta consulta es lenta en la instancia de PostgreSQL de producción? +- Muéstreme los eventos de espera y la tasa de aciertos de caché para la firma de consulta `xyz789`. ### `get_datadog_database_query_statement` {#get-datadog-database-query-statement} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Recupera el texto de la declaración SQL para una firma de consulta dada. Utilice esto para mapear los hashes de firma de vuelta al SQL concreto para investigación e informes. +Recupera el texto de la sentencia SQL para una firma de consulta determinada. Utilice esto para asignar hashes de firma de nuevo al SQL concreto para investigación e informes. - Obtenga el SQL para la firma de consulta `abc123def`. -- Muéstrame la declaración detrás de este hash de consulta en `db-prod-1`. +- Muéstreme la sentencia detrás de este hash de consulta en `db-prod-1`. - ¿A qué consulta corresponde la firma `xyz789`? ### `get_datadog_database_recommendations` {#get-datadog-database-recommendations} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Recupera recomendaciones de base de datos en vivo para una base de datos, consulta, tabla, host o índice. Devuelve las recomendaciones coincidentes con estado, severidad y un bloque de contexto normalizado que resalta instancias afectadas, firmas de consulta, tablas, índices, servicios, planes e identificadores de infraestructura. +Recupera recomendaciones de base de datos en tiempo real para una base de datos, consulta, tabla, servidor o índice. Devuelve las recomendaciones coincidentes con estado, gravedad y un bloque de contexto normalizado que destaca las instancias, firmas de consulta, tablas, índices, servicios, planes e identificadores de infraestructura afectados. - Muestre las recomendaciones de base de datos abiertas para `db-prod-1`. -- Enumere las recomendaciones de índice faltantes en la base de datos de pagos. -- Obtenga recomendaciones de alta severidad para la firma de consulta `abc123def`. +- Liste recomendaciones de índices faltantes en la base de datos de pagos. +- Obtenga recomendaciones de alta gravedad para la firma de consulta `abc123def`. ### `get_datadog_database_schemas` {#get-datadog-database-schemas} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Recupera definiciones de esquema (columnas, índices, claves foráneas, particiones) para uno o más objetos de base de datos. Acepta nombres de tabla con calificadores opcionales de esquema, base de datos e instancia. +Obtiene definiciones de esquema (columnas, índices, claves foráneas, particiones) para uno o más objetos de base de datos. Acepta nombres de tabla con calificadores opcionales de esquema, base de datos e instancia. -- Muéstrame el esquema de la tabla `orders`. +- Muéstreme el esquema para la tabla `orders`. - Obtenga columnas e índices para `public.users` en `db-prod-1`. -- Obtenga claves foráneas para la `payments` tabla. +- Obtenga las claves foráneas para la tabla `payments`. ### `optimize_datadog_database_query` {#optimize-datadog-database-query} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Analiza una consulta de PostgreSQL en busca de oportunidades de optimización utilizando reglas determinísticas. Devuelve reescrituras de consultas, detección de anti-patrones (`SELECT *`, `OFFSET` sin `ORDER BY`, `ORDER BY` sin `LIMIT`), sugerencias de índices faltantes y análisis del impacto de inactividad en transacciones. Acepta texto SQL o una firma de consulta. +Analiza una consulta de PostgreSQL en busca de oportunidades de optimización mediante reglas deterministas. Devuelve reescrituras de consultas, detección de antipatrones (`SELECT *`, `OFFSET` sin `ORDER BY`, `ORDER BY` sin `LIMIT`), sugerencias de índices faltantes y análisis de impacto de transacciones inactivas. Acepta texto SQL o una firma de consulta. - Optimice la firma de consulta `abc123def` en la base de datos de pagos. -- Verifique este SQL en busca de índices faltantes y anti-patrones. +- Verifique este SQL en busca de índices faltantes y antipatrones. - Sugiera reescrituras para la consulta más lenta en `db-prod-1`. ### `search_datadog_database_plans` {#search-datadog-database-plans} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Busca planes de ejecución de consultas [Monitoreo de Base de Datos][26], que muestran cómo el motor de base de datos ejecuta consultas, incluyendo el uso de índices, estrategias de unión y estimaciones de costos. Utilice esto para analizar el rendimiento de las consultas e identificar oportunidades de optimización. +Busca planes de ejecución de consultas en [Database Monitoring][26], los cuales muestran cómo el motor de base de datos ejecuta las consultas, incluyendo el uso de índices, estrategias de unión y estimaciones de costos. Utilice esto para analizar el rendimiento de las consultas e identificar oportunidades de optimización. - Muéstreme los planes de ejecución para consultas lentas en `host:db-prod-1` de la última hora. - Encuentre planes de consulta con `@db.plan.type:explain_analyze` para la base de datos de producción. @@ -621,27 +876,27 @@ Busca planes de ejecución de consultas [Monitoreo de Base de Datos][26], que mu ### `search_datadog_database_samples` {#search-datadog-database-samples} *Conjunto de herramientas: **dbm***\ *Permisos requeridos: `Database Monitoring Read`*\ -Busca [Monitoreo de Base de Datos][26] muestras de consultas, que representan ejecuciones individuales de consultas con métricas de rendimiento. Utilice esto para analizar patrones de actividad en la base de datos, identificar consultas lentas e investigar problemas de rendimiento de la base de datos. +Busca muestras de consultas en [Database Monitoring][26], las cuales representan ejecuciones de consultas individuales con métricas de rendimiento. Utilice esto para analizar patrones de actividad de la base de datos, identificar consultas lentas e investigar problemas de rendimiento de la base de datos. - Muéstreme muestras de consultas con `@duration:>1000000000` (duración mayor a 1 segundo) de `db:mydb`. - Encuentre consultas lentas en `host:db-prod-1` filtradas por `@db.user:app_user`. -- Obtenga muestras recientes de consultas para `@db.query_signature:abc123def` y analice patrones de rendimiento. +- Obtenga muestras de consultas recientes para `@db.query_signature:abc123def` y analice los patrones de rendimiento. ## DDSQL {#ddsql} -Herramientas para consultar datos de Datadog usando [DDSQL][41], un dialecto SQL con soporte para recursos de infraestructura, registros, métricas, RUM, spans y otras fuentes de datos de Datadog. +Herramientas para consultar datos de Datadog mediante [DDSQL][41], un dialecto de SQL con soporte para recursos de infraestructura, registros, métricas, RUM, tramos y otras fuentes de datos de Datadog. ### `ddsql_get_spec` {#ddsql-get-spec} *Conjunto de herramientas: **ddsql***\ -Obtiene una especificación compacta de capacidades de DDSQL, incluyendo funciones SQL soportadas, palabras clave SQL y diferencias específicas de DDSQL con respecto a PostgreSQL estándar. Llame a esta herramienta antes de componer consultas para entender la sintaxis soportada. +Obtiene una especificación compacta de capacidades de DDSQL, incluyendo funciones SQL compatibles, palabras clave SQL y diferencias específicas de DDSQL respecto al PostgreSQL estándar. Llame a esta herramienta antes de redactar consultas para comprender la sintaxis compatible. -- ¿Qué funciones SQL son soportadas en DDSQL? -- Muéstreme las reglas de sintaxis de consultas de DDSQL y las diferencias con PostgreSQL. -- ¿Qué funciones de agregación puedo usar en DDSQL? +- ¿Qué funciones SQL son compatibles en DDSQL? +- Muéstreme las reglas de sintaxis de consulta de DDSQL y las diferencias con PostgreSQL. +- ¿Qué funciones de agregado puedo usar en DDSQL? ### `ddsql_schema_search_tables` {#ddsql-schema-search-tables} *Conjunto de herramientas: **ddsql***\ -Busca conjuntos de datos de DDSQL y devuelve tablas (fuentes de datos públicas y tablas de referencia) y métricas disponibles. +Busca conjuntos de datos de DDSQL y devuelve tablas (fuentes de datos públicas y tablas de referencia) y las métricas disponibles. - ¿Qué tablas están disponibles para consultar en DDSQL? - Busque tablas de DDSQL relacionadas con Kubernetes. @@ -656,904 +911,1663 @@ Obtiene columnas SQL estáticas para una tabla de DDSQL a partir de los metadato ### `ddsql_schema_search_unstructured_fields` {#ddsql-schema-search-unstructured-fields} *Conjunto de herramientas: **ddsql***\ -Busque y clasifique campos para fuentes no estructuradas de DDSQL, como registros, RUM y spans, ordenados por frecuencia. Utilice esta herramienta para el descubrimiento de esquemas en fuentes buscables antes de recurrir a `ddsql_schema_get_table_columns`. +Busca y clasifica campos para fuentes DDSQL no estructuradas, como registros, RUM y tramos, ordenados por frecuencia. Utilice esta herramienta para el descubrimiento de esquemas en fuentes buscables antes de recurrir a `ddsql_schema_get_table_columns`. - ¿Qué campos están disponibles en los registros de DDSQL? -- Encuentre campos relacionados con `service` en mis datos de RUM. -- Muéstreme los campos más comunes en mis datos de span. +- Encuentra campos relacionados con `service` en mis datos de RUM. +- Muéstrame los campos más comunes en mis datos de tramo. ### `ddsql_run_query` {#ddsql-run-query} *Conjunto de herramientas: **ddsql***\ -Ejecuta una consulta DDSQL y devuelve los resultados. Soporta el uso de sintaxis SQL para consultar recursos de infraestructura, registros, métricas, RUM, spans y otras fuentes de datos de Datadog. Consulte el [DDSQL Reference][42] para detalles de sintaxis. +Ejecuta una consulta DDSQL y devuelve resultados. Admite el uso de sintaxis SQL para consultar recursos de infraestructura, registros, métricas, RUM, tramos y otras fuentes de datos de Datadog. Consulte la [Referencia de DDSQL][42] para obtener detalles sobre la sintaxis. -- ¿Cuántas instancias de EC2 están en ejecución en cada región de AWS? -- Muéstreme los 10 principales servicios por conteo de registros de error en la última hora. -- Consulta el uso promedio de CPU agrupado por host en las últimas 24 horas. +- ¿Cuántas instancias de EC2 se están ejecutando en cada región de AWS? +- Muéstreme los 10 servicios principales por recuento de registros de error en la última hora. +- Consulte el uso promedio de CPU agrupado por servidor durante las últimas 24 horas. ### `ddsql_create_link` {#ddsql-create-link} *Conjunto de herramientas: **ddsql***\ -Genera un enlace de interfaz de usuario de Datadog al [Editor de DDSQL][41] con una consulta dada pre-poblada. +Genera un enlace de la interfaz de usuario de Datadog al [DDSQL Editor][41] con una consulta determinada precargada. -- Genere un enlace al [DDSQL Editor] para esta consulta. -- Cree un enlace compartible al [DDSQL Editor] con mi consulta de infraestructura. +- Genere un enlace al DDSQL Editor para esta consulta. +- Cree un enlace compartible al DDSQL Editor con mi consulta de infraestructura. ## Error Tracking {#error-tracking} Herramientas para interactuar con Datadog [Error Tracking][49]. ### `search_datadog_error_tracking_issues` {#search-datadog-error-tracking-issues} -*Conjunto de herramientas: **Error Tracking***\ +*Conjunto de herramientas: **error-tracking***\ *Permisos requeridos: `Error Tracking Read`*\ -Busca incidencias de Error Tracking a través de fuentes de datos (RUM, registros, trazas). +Busca incidencias de Error Tracking en todas las fuentes de datos (RUM, registros, trazas). -- Muéstrame todas las incidencias de Error Tracking en el servicio de pago de las últimas 24 horas. +- Muéstreme todas las incidencias de Error Tracking en el servicio de pago de las últimas 24 horas. - ¿Cuáles son los errores más comunes en mi aplicación durante la última semana? -- Encuentra incidencias de Error Tracking en el entorno de producción con `service:api`. +- Busque incidencias de Error Tracking en el entorno de producción con `service:api`. ### `get_datadog_error_tracking_issue` {#get-datadog-error-tracking-issue} -*Conjunto de herramientas: **Error Tracking***\ +*Conjunto de herramientas: **error-tracking***\ *Permisos requeridos: `Cases Read` y `Error Tracking Read`*\ -Recupera información detallada sobre una incidencia específica de Error Tracking de Datadog. +Recupera información detallada sobre una incidencia de Error Tracking específica de Datadog. -- Ayúdame a resolver la incidencia de Error Tracking `550e8400-e29b-41d4-a716-446655440000`. +- Ayúdeme a resolver la incidencia de Error Tracking `550e8400-e29b-41d4-a716-446655440000`. - ¿Cuál es el impacto de la incidencia de Error Tracking `a3c8f5d2-1b4e-4c9a-8f7d-2e6b9a1c3d5f`? -- Crea un caso de prueba para reproducir la incidencia de Error Tracking `7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f`. +- Cree un caso de prueba para reproducir la incidencia de Error Tracking `7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f`. ### `analyze_datadog_error_tracking_errors` {#analyze-datadog-error-tracking-errors} -*Conjunto de herramientas: **seguimiento de errores***\ +*Conjunto de herramientas: **error-tracking***\ *Permisos requeridos: `Error Tracking Read` y `Timeseries`*\ -Analiza los errores de Error Tracking de Datadog utilizando consultas SQL para conteo, agregaciones y análisis numérico. Opera sobre muestras individuales de errores, no sobre incidencias (grupos de errores). +Analiza errores de Datadog Error Tracking mediante consultas SQL para conteo, agregaciones y análisis numérico. Opera sobre muestras de errores individuales, no sobre incidencias (grupos de errores). -- Cuenta los errores por servicio en la última hora. -- Muéstrame los principales tipos de errores en el servicio de pago durante la última semana. -- Desglosa los errores por versión para identificar qué despliegue introdujo una incidencia. +- Cuente errores por servicio en la última hora. +- Muéstreme los principales tipos de error en el servicio de pago durante la última semana. +- Desglose errores por versión para identificar qué despliegue introdujo una incidencia. ### `update_datadog_error_tracking_issue` {#update-datadog-error-tracking-issue} -*Conjunto de herramientas: **seguimiento de errores***\ +*Conjunto de herramientas: **error-tracking***\ *Permisos requeridos: `Cases Read`, `Cases Write`, `Error Tracking Read` y `Error Tracking Write`*\ -Actualiza el estado o el asignado de una incidencia de Error Tracking en Datadog. +Actualiza el estado o el responsable de una incidencia de Error Tracking en Datadog. + +- Marque la incidencia de Error Tracking `550e8400-e29b-41d4-a716-446655440000` como resuelta. +- Asígneme la incidencia de Error Tracking `a3c8f5d2-1b4e-4c9a-8f7d-2e6b9a1c3d5f`. +- Establezca el estado de la incidencia de Error Tracking `7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f` como ignorada. + +### `manage_datadog_error_tracking_issue_comments` {#manage-datadog-error-tracking-issue-comments} +*Conjunto de herramientas: **error-tracking***\ +*Permisos requeridos: `Cases Read`, `Cases Write`, `Error Tracking Read` y `Error Tracking Write`*\ +Agrega, actualiza o elimina un comentario en una incidencia de Datadog Error Tracking. + +- Agregue un comentario a la incidencia de Error Tracking `550e8400-e29b-41d4-a716-446655440000` que diga \"Investigando esto ahora\". +- Actualice el comentario que acabamos de agregar para que diga \"Corregido en la versión 2.3.1\". +- Elimine el comentario que acabamos de agregar de esa incidencia. + +### `manage_datadog_error_tracking_issue_links` {#manage-datadog-error-tracking-issue-links} +*Conjunto de herramientas: **error-tracking***\ +*Permisos requeridos: `Cases Read`, `Cases Write`, `Error Tracking Read` y `Error Tracking Write`*\ +Cree, vincule o desvincule un ticket de Jira, un ticket de Linear o una incidencia de Datadog para una incidencia de Error Tracking. + +- Cree un ticket de Jira para la incidencia de Error Tracking `550e8400-e29b-41d4-a716-446655440000`. +- Vincule la incidencia de Error Tracking `a3c8f5d2-1b4e-4c9a-8f7d-2e6b9a1c3d5f` a la incidencia `CTS-203`. +- Desvincule el ticket de Linear de la incidencia de Error Tracking `7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f`. + +## Experimentos {#experiments} + +Herramientas para gestionar y analizar [Experimentos][62], lo que incluye crear y concluir experimentos, ejecutar diagnósticos e investigar movimientos de métricas. + +
El experiments El conjunto de herramientas no está habilitado de forma predeterminada. Consulte Set Up the Datadog MCP Server para obtener instrucciones sobre cómo habilitar los conjuntos de herramientas.
+ +### `list_experiments` {#list-experiments} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`*\ +Enumera los experimentos de la organización, con búsqueda opcional por nombre, límite y desplazamiento para la paginación. + +- Muéstreme todos los experimentos en ejecución. +- Busque experimentos con "checkout" en el nombre. + +### `get_experiment` {#get-experiment} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`*\ +Obtiene un solo experimento mediante su ID, incluyendo el estado, la feature flag vinculada, el tipo de sujeto, la métrica principal, las fechas de asignación y la decisión. + +- Obtenga los detalles del experimento `abc123`. +- ¿Cuál es el estado actual y la feature flag vinculada para el experimento `abc123`? + +### `create_experiment` {#create-experiment} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Write`*\ +Cree un nuevo experimento con un nombre, hipótesis, tipo de sujeto y métrica principal. + +- Crea un experimento llamado "New Checkout Flow" para probar si el rediseño mejora la tasa de conversión. + +### `link_feature_flag_to_experiment` {#link-feature-flag-to-experiment} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Write`*\ +Vincule una feature flag a un experimento. + +- Vincule la feature flag `new-checkout-flow` al experimento `abc123`. + +### `start_experiment` {#start-experiment} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read` y `Product Analytics Experiments Write`*\ +Inicie un experimento estándar desde su configuración guardada utilizando feature flags de Datadog o asignación nativa de almacén. La herramienta verifica la preparación antes de comenzar. Si la configuración está incompleta, devuelve cada bloqueador detectado con una acción para resolverlo y no cambia el experimento. Para experimentos nativos de almacén, configure las variantes y las fechas de ejecución antes de usar esta herramienta, ya que solo acepta el ID del experimento. + +- Inicie el experimento `abc123`. -- Marca la incidencia de Error Tracking `550e8400-e29b-41d4-a716-446655440000` como resuelta. -- Asigna la incidencia de Error Tracking `a3c8f5d2-1b4e-4c9a-8f7d-2e6b9a1c3d5f` a mí. -- Establece el estado de la incidencia de Error Tracking `7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f` como ignorada. +### `conclude_experiment` {#conclude-experiment} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Write`*\ +Finaliza un experimento en ejecución con una decisión permanente de variante ganadora. + +- Finalice el experimento `abc123` con la variante de tratamiento como ganadora. + +### `cancel_experiment` {#cancel-experiment} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Write`*\ +Cancele un experimento en ejecución con un motivo obligatorio. + +- Cancele el experimento `abc123` porque se detectó un problema de SRM. + +### `get_experiment_diagnostics` {#get-experiment-diagnostics} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`*\ +Devuelve un resumen del estado de un experimento antes de interpretar los resultados: estado de discrepancia en la proporción de la muestra (SRM), total de sujetos, recuentos y fracciones de exposición por variante, y estado de salud por métrica, incluidas las métricas poco fiables y con datos nulos. Llame a esto antes de `get_experiment_results`; si `srm.has_warning` es verdadero, las comparaciones a nivel de variante no son seguras de interpretar. + +- Ejecute diagnósticos en el experimento `abc123` antes de que vea los resultados. +- ¿Existe una discrepancia en la proporción de la muestra en el experimento `abc123`? + +### `get_experiment_results` {#get-experiment-results} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`*\ +Devuelve los resultados calculados por variante y por métrica. El campo `verdict` (`better`, `worse`, `inconclusive` o `unreliable`) es definitivo; no vuelva a calcular la significancia a partir de valores p sin procesar o intervalos de confianza. + +- Muéstreme los resultados del experimento `abc123`. +- ¿Cuál es el veredicto sobre la métrica principal para el experimento `abc123`? + +### `explore_experiment_results` {#explore-experiment-results} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`, `Product Analytics Metrics Read`*\ +Segmenta los resultados por una propiedad de asignación (tipo de dispositivo, país, nivel de plan, etcétera) o a lo largo del tiempo. Úselo después de `get_experiment_results` para un análisis más profundo. + +- Desglose los resultados del experimento `abc123` por tipo de dispositivo. +- ¿Cómo fue la tendencia del incremento para el experimento `abc123` durante las últimas dos semanas? + +### `list_experiment_segmentation_properties` {#list-experiment-segmentation-properties} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`, `Product Analytics Metrics Read`*\ +Enumera las propiedades de asignación por las que se puede dividir un experimento. Llame a esto antes de `explore_experiment_results` para obtener ID de propiedad válidos; no los adivine. + +- ¿Qué propiedades de segmentación puedo usar para desglosar el experimento `abc123`? + +### `get_experiment_segmentation_property_values` {#get-experiment-segmentation-property-values} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`, `Product Analytics Metrics Read`*\ +Devuelve los valores concretos para una propiedad de segmentación (por ejemplo, `["mobile", "desktop", "tablet"]` para el tipo de dispositivo). Úselo antes de filtrar en `explore_experiment_results` para evitar cadenas de filtro no válidas. + +- ¿Qué valores están disponibles para la propiedad de tipo de dispositivo en el experimento `abc123`? + +### `get_metric_definition` {#get-metric-definition} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Metrics Read`*\ +Devuelve la definición de una métrica de experimento: la consulta de eventos subyacente, la fuente de datos y la herramienta Datadog MCP recomendada para investigar por qué cambió la métrica. Para las métricas con origen en `datadog`, la respuesta incluye un campo `recommended_tool_call` con los parámetros estructurados necesarios para consultar los datos de eventos sin procesar. No son para métricas de infraestructura de Datadog o APM; utilice `get_datadog_metric` para ellas. + +- ¿Cuál es la consulta de evento detrás de la métrica principal para el experimento `abc123`? +- ¿Qué herramienta Datadog MCP debo usar para investigar por qué cambió esta métrica? + +### `diagnose_experiment_run_failure` {#diagnose-experiment-run-failure} +*Conjunto de herramientas: **experimentos***\ +*Permisos requeridos: `Product Analytics Experiments Read`*\ +Diagnostica por qué falló la ejecución más reciente (o una específica) de la pipeline de análisis de un experimento. Devuelve la tarea de causa raíz, una explicación categorizada del fallo y los siguientes pasos procesables. Use `get_experiment_diagnostics` para problemas de calidad de resultados y SRM en su lugar. + +- ¿Por qué falló la última ejecución de análisis para el experimento `abc123`? +- Diagnostique el fallo de la pipeline para el experimento `abc123`. ## Feature Flags {#feature-flags} -Herramientas para gestionar [Feature Flags][51], incluyendo la creación, listado y actualización de Feature Flags y sus entornos. +Herramientas para administrar [Feature Flags][51], que permiten crear, listar y actualizar flags y sus entornos. ### `list_datadog_feature_flags` {#list-datadog-feature-flags} -*Conjunto de herramientas: **banderas-de-características***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Environment Read` y `Feature Flag Read`*\ -Lista las Feature Flags con soporte de paginación. +Enumere las Feature Flags con soporte de paginación. -- Muéstrame todas las Feature Flags en mi organización. -- Lista las Feature Flags para el servicio de pago. +- Muéstreme todas las Feature Flags en mi organización. +- Enumere las Feature Flags para el servicio de checkout. ### `get_datadog_feature_flag` {#get-datadog-feature-flag} -*Conjunto de herramientas: **banderas de características***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Environment Read` y `Feature Flag Read`*\ -Recupera detalles sobre una Feature Flag específica. +Recupere detalles sobre una Feature Flag específica. -- Obtén detalles para la Feature Flag `dark-mode-enabled`. -- ¿Cuáles son las configuraciones actuales para la Feature Flag `new-checkout-flow`? +- Obtenga detalles de la Feature Flag `dark-mode-enabled`. +- ¿Cuáles son los ajustes actuales de la Feature Flag `new-checkout-flow`? ### `create_datadog_feature_flag` {#create-datadog-feature-flag} -*Conjunto de herramientas: **Feature Flags***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Environment Read` y `Feature Flag Write`*\ -Crea una nueva Feature Flag. +Cree una nueva Feature Flag. -- Crea una Feature Flag llamada `enable-new-dashboard` para un despliegue gradual. -- Configura una nueva Feature Flag booleana para la característica beta. +- Cree una Feature Flag llamada `enable-new-dashboard` para un despliegue gradual. +- Configure una nueva Feature Flag booleana para la función beta. ### `list_datadog_feature_flag_environments` {#list-datadog-feature-flag-environments} -*Conjunto de herramientas: **flags de características***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Environment Read`*\ -Lista los entornos configurados para Feature Flags. +Enumere los entornos configurados para las Feature Flags. -- Muéstrame los entornos de Feature Flags disponibles. +- Muéstreme los entornos de las Feature Flags disponibles. - ¿A qué entornos puedo dirigir las Feature Flags? ### `list_datadog_feature_flag_allocations` {#list-datadog-feature-flag-allocations} -*Conjunto de herramientas: **Feature Flags***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Environment Read` y `Feature Flag Read`*\ -Lista las asignaciones para una Feature Flag en un entorno específico. +Enumere las asignaciones para una Feature Flag en un entorno específico. -- Muéstrame las reglas de asignación para el flag `new-checkout-flow` en producción. +- Muéstreme las reglas de asignación para la Feature Flag `new-checkout-flow` en producción. ### `update_datadog_feature_flag_environment` {#update-datadog-feature-flag-environment} -*Conjunto de herramientas: **Feature Flags***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Environment Read` y `Feature Flag Write`*\ -Actualiza la configuración de un flag de características en un entorno específico. +Actualice la configuración de una Feature Flag en un entorno específico. -- Habilita la Feature Flag `dark-mode` en el entorno de pruebas. -- Despliega la Feature Flag `new-checkout-flow` al 50% de los usuarios en producción. +- Habilite la Feature Flag `dark-mode` en el entorno de staging. +- Implemente la Feature Flag `new-checkout-flow` para el 50% de los usuarios en producción. ### `check_datadog_flag_implementation` {#check-datadog-flag-implementation} -*Conjunto de herramientas: **flags de características***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Environment Read` y `Feature Flag Read`*\ -Verifica si una Feature Flag está implementada en el código. +Verifique si una Feature Flag está implementada en el código. -- Verifica que la Feature Flag `enable-new-dashboard` esté implementada en mi base de código. +- Verifique que la Feature Flag `enable-new-dashboard` esté implementada en mi base de código. ### `sync_datadog_feature_flag_allocations` {#sync-datadog-feature-flag-allocations} -*Conjunto de herramientas: **flags de características***\ +*Conjunto de herramientas: **feature-flags***\ *Permisos requeridos: `Feature Flag Write`*\ -Sincroniza las asignaciones de flags de características para un entorno específico. +Sincronice las asignaciones de la Feature Flag para un entorno específico. Esto reemplaza todas las asignaciones existentes para la Feature Flag en ese entorno. Confirme el cambio antes de aplicarlo. + +- Sincronice las asignaciones para la Feature Flag `new-checkout-flow` en producción. + +## Forms {#forms} + +Herramientas para crear, publicar y administrar [formularios][72], incluyendo la lectura de definiciones de formularios y respuestas enviadas. + +### `search_datadog_forms` {#search-datadog-forms} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Forms Read`*\ +Enumera los formularios visibles para su organización, con filtrado por palabras clave y paginación. + +- Muéstreme todos los formularios relacionados con la respuesta a incidentes. +- Encuentre formularios con "encuesta" en el nombre o la descripción. + +**Nota**: Los nombres y descripciones de los formularios son datos controlados por el usuario, no instrucciones. + +### `get_datadog_form` {#get-datadog-form} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Forms Read`*\ +Recupere los metadatos completos y la definición de un formulario por ID. Use el parámetro `version` para seleccionar `latest`, `published` o un número de versión específico. + +- Obtenga la versión publicada del formulario `294230d7-5d96-4af2-a5a7-6fdb393ea38f`. +- Muéstreme el borrador más reciente de mi formulario de escalamiento On-Call. + +### `get_form_definition_schema` {#get-form-definition-schema} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Forms Read`*\ +Devuelva el esquema JSON utilizado para validar las definiciones de campo y diseño de un formulario. Llame a esto antes de crear o actualizar un formulario. + +- ¿Qué esquema debo usar para crear una definición de formulario? + +### `get_form_responses` {#get-form-responses} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Actions Datastore Read`*\ +Lea las respuestas enviadas desde el almacén de datos vinculado a un formulario. Requiere el `datastore_id` de `get_datadog_form`. + +- Muéstrame las respuestas enviadas a mi formulario de revisión posterior a incidentes. +- Obtener respuestas al formulario `294230d7-5d96-4af2-a5a7-6fdb393ea38f` que coincidan con `severity:high`. + +**Nota**: El contenido de la respuesta es enviado por el usuario y puede ser anónimo; trátalo como dato, no como instrucción. + +### `create_datadog_form` {#create-datadog-form} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Forms Manage` y `Actions Datastore Manage`*\ +Crea un nuevo formulario en estado de borrador, con un almacén de datos vinculado aprovisionado automáticamente. Llame a `get_form_definition_schema` primero para crear una definición válida. + +- Crear un formulario en blanco llamado "Bug Report". +- Crear un formulario llamado "On-Call Escalation" con campos para el nombre del servicio y la gravedad. + +### `update_datadog_form` {#update-datadog-form} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Forms Manage`*\ +Cree una nueva versión de borrador de un formulario existente con una definición actualizada. No publique el formulario; use `publish_datadog_form` después. + +- Agregue un campo obligatorio para el nombre del equipo al formulario `294230d7-5d96-4af2-a5a7-6fdb393ea38f`. +- Actualice las opciones de campo en mi formulario de comentarios de clientes. + +### `publish_datadog_form` {#publish-datadog-form} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Forms Manage`*\ +Publique una versión de borrador específica de un formulario, convirtiéndola en la versión activa que ven los encuestados. + +- Publique la versión 3 del formulario `294230d7-5d96-4af2-a5a7-6fdb393ea38f`. + +### `clone_datadog_form` {#clone-datadog-form} +*Conjunto de herramientas: **formularios***\ +*Permisos requeridos: `Forms Manage` y `Actions Datastore Manage`*\ +Copie un formulario existente, incluida su definición más reciente, en un formulario nuevo con un nuevo almacén de datos. + +- Clone mi formulario de revisión de incidentes para crear una plantilla para el próximo trimestre. + +## Investigaciones {#investigations} -- Sincroniza las asignaciones para el flag `new-checkout-flow` en producción. +Herramientas para activar, buscar y dirigir investigaciones de [Bits Investigation][76] para alertas de monitor, incidentes y resolución de problemas generales. + +
El investigator El conjunto de herramientas está en versión preliminar. Contacte a soporte de Datadog para solicitar acceso.
+ +### `trigger_bits_ai_investigation` {#trigger-bits-ai-investigation} +*Conjunto de herramientas: **investigator***\ +*Permisos requeridos: `Bits Investigations Write`*\ +Active una Bits Investigation para una alerta de monitor. Esto inicia una investigación automatizada que analiza el contexto de la alerta y proporciona hallazgos y conclusiones. Use `get_bits_ai_investigation` para recuperar resultados. + +- Investigue por qué el monitor `12345` se activó en el evento `abc123`. +- Inicie una Bits Investigation para la alerta de CPU en el servicio de checkout. + +### `trigger_general_investigation` {#trigger-general-investigation} +*Conjunto de herramientas: **investigator***\ +*Permisos requeridos: `Bits Investigations Write`*\ +Activa una Bits Investigation a partir de una descripción de texto. Para obtener mejores resultados, contextualice la investigación con una etiqueta `service:` o `host:`. Use `get_bits_ai_investigation` para consultar los resultados después de activar. + +- Investigue el pico de latencia en `service:checkout` desde las 2 p. m. de hoy. +- Inicie una investigación sobre las elevadas tasas de error en `host:web-01`. + +### `trigger_incident_investigation` {#trigger-incident-investigation} +*Conjunto de herramientas: **investigator***\ +*Permisos requeridos: `Bits Investigations Write`*\ +Active una Bits Investigation limitada a un incidente de Datadog. La investigación analiza la línea de tiempo y el contexto del incidente para proporcionar hallazgos y conclusiones. Utilice `get_investigations_from_incident_id` para verificar primero si existen investigaciones. + +- Active una investigación para el incidente `1234` para ayudar a encontrar la causa raíz. +- Inicie una Bits Investigation limitada al incidente de checkout en curso. + +### `search_investigations` {#search-investigations} +*Conjunto de herramientas: **investigator***\ +*Permisos requeridos: `Bits Investigations Read`*\ +Busque investigaciones de Bits AI por palabra clave o consulta. Devuelve las investigaciones coincidentes con sus ID, estado y resúmenes. + +- Encuentre investigaciones relacionadas con el servicio de checkout. +- Muéstreme todas las investigaciones completadas de esta semana. + +### `get_investigations_from_incident_id` {#get-investigations-from-incident-id} +*Conjunto de herramientas: **investigator***\ +*Permisos requeridos: `Bits Investigations Read`*\ +Recupera las investigaciones de Bits AI vinculadas a un incidente específico de Datadog. + +- ¿Qué investigaciones se han activado para el incidente `1234`? +- Enumere los ID de investigación vinculados al incidente de pagos. + +### `get_bits_ai_investigation` {#get-bits-ai-investigation} +*Conjunto de herramientas: **investigator***\ +*Permisos requeridos: `Bits Investigations Read`*\ +Recupera el estado, los hallazgos y las conclusiones de una investigación de Bits AI. + +- Obtenga los hallazgos de la investigación `abc-123-def`. +- ¿A qué conclusión llegó la investigación sobre la interrupción? + +### `steer_bits_ai_investigation` {#steer-bits-ai-investigation} +*Conjunto de herramientas: **investigator***\ +*Permisos requeridos: `Bits Investigations Write`*\ +Envía un mensaje de dirección a una investigación de Bits AI en curso para corregir, redirigir o añadir contexto. `get_bits_ai_investigation`Utilice primero para confirmar que la investigación sigue activa. + +- Indíquele a la investigación en curso que se centre en la capa de base de datos en su lugar. +- Redirija la investigación `abc-123-def` para que también verifique las implementaciones recientes. ## Kubernetes {#kubernetes} -Herramientas para buscar y describir recursos de [Kubernetes][55] y recuperar manifiestos en todos los clústeres. +Herramientas para buscar y describir recursos de [Kubernetes][55], recuperar manifiestos y analizar despliegues en todos los clústeres. ### `search_datadog_k8s_resources` {#search-datadog-k8s-resources} -*Conjunto de herramientas: **Kubernetes***\ +*Conjunto de herramientas: **kubernetes***\ *Permisos requeridos: `Hosts Read` y `Teams Read`*\ -Busca recursos de [Kubernetes][55] en todos los clústeres. Utiliza esta herramienta en lugar de `kubectl` para determinar el estado de los recursos de Kubernetes, como implementaciones, pods, nodos, etc. Esta herramienta no requiere acceso al clúster local, funciona en todos los clústeres y devuelve datos enriquecidos con etiquetas. Puedes incluir claves de etiqueta específicas en cada resultado e incluir nombres de recursos padres para investigar relaciones entre recursos (por ejemplo, la implementación a la que pertenece un pod). +Busque recursos de [Kubernetes][55] en todos los clústeres. Utilice esta herramienta en lugar de `kubectl` para determinar el estado de los recursos de Kubernetes, como implementaciones, pods, nodos, etc. Esta herramienta no requiere acceso al clúster local, funciona en todos los clústeres y devuelve datos enriquecidos con etiquetas. Puede incluir claves de etiqueta específicas en cada resultado e incluir nombres de recursos principales para investigar las relaciones entre los recursos (por ejemplo, la implementación a la que pertenece un pod). - Muéstrame todos los pods en el espacio de nombres `production` con estado `CrashLoopBackOff`. -- Encuentra despliegues con rollout en curso en el clúster `general2`. -- Lista todos los nodos en mi clúster ordenados por uso de CPU. -- Agrupa los despliegues por `service` y `env` para ver cómo se distribuyen mis servicios entre los entornos. +- Busque implementaciones con despliegues en curso en el clúster `general2`. +- Liste todos los nodos en mi clúster ordenados por uso de CPU. +- Agrupe las implementaciones por `service` y `env` para ver cómo se distribuyen mis servicios entre los entornos. + +### `analyse_datadog_k8s_rollout` {#analyse-datadog-k8s-rollout} +*Conjunto de herramientas: **kubernetes***\ +*Permisos requeridos: `Hosts Read` y `Timeseries` y `Logs Read Data` y `APM Read`*\ +Ensamble un despliegue de [Kubernetes][55] en una sola llamada: estado y progreso del despliegue, tiempo (tiempo estimado mientras el despliegue está en curso, duración después de que finaliza), la división de ReplicaSet nuevo, anterior y antiguo por revisión, y series de impacto antes/después (RED, utilización de recursos y recuentos de registro). Identifique la implementación por su UID de una búsqueda anterior o proporcionando identificadores de recursos (clúster, espacio de nombres y nombre del recurso). Utilice esta herramienta para preguntas sobre despliegues en lugar de combinar `search_datadog_k8s_resources` y `describe_datadog_k8s_resource`. + +- Analice el despliegue de la implementación `checkout-api` en el clúster `prod`, espacio de nombres `default`. +- ¿Cuál es el ETA del despliegue en curso de la implementación `api-server` en el clúster `staging`? +- ¿El último despliegue de la implementación `payments` afectó las tasas de error, el tráfico o la utilización de recursos? + +**Nota**: La herramienta solo informa sobre implementaciones cuyo `kube_rollout_status` es `inprogress`, `recentlycompleted` o `recentlyfailed`. Para otros despliegues, devuelve los campos de la implementación junto con una advertencia de que no hay un despliegue reciente que analizar. ### `describe_datadog_k8s_resource` {#describe-datadog-k8s-resource} *Conjunto de herramientas: **kubernetes***\ *Permisos requeridos: `Hosts Read`*\ -Obtiene información detallada sobre un recurso específico de [Kubernetes][55], incluyendo detalles específicos del recurso como solicitudes y límites de CPU y memoria, y opcionalmente etiquetas, anotaciones, historial de manifiestos, recursos padres y un enlace profundo al [Kubernetes Explorer][55]. Utiliza esta herramienta en lugar de `kubectl describe`. Identifica un recurso por su UID de una búsqueda anterior o proporcionando identificadores de recurso (clúster, espacio de nombres y nombre del recurso). Para el manifiesto completo en bruto, utiliza `get_datadog_k8s_manifest`. +Obtiene información detallada sobre un recurso específico de [Kubernetes][55], incluidos detalles específicos del recurso como solicitudes y límites de CPU y memoria, y opcionalmente etiquetas, labels, annotations, historial de manifiestos, recursos principales y un enlace directo al [Explorer de Kubernetes][55]. Utilice esta herramienta en lugar de `kubectl describe`. Identifique un recurso por su UID de una búsqueda anterior o proporcionando identificadores de recurso (clúster, espacio de nombres y nombre del recurso). Para el manifiesto sin procesar completo, utilice `get_datadog_k8s_manifest`. -- Describe el pod `my-app` en el clúster `prod`, espacio de nombres `default`. -- Obtén detalles para el despliegue `api-server` en el espacio de nombres `default`, clúster `staging`. -- Muéstrame las etiquetas y anotaciones para este recurso de Kubernetes. +- Describa el pod `my-app` en el clúster `prod`, espacio de nombres `default`. +- Obtenga los detalles de la implementación `api-server` en el espacio de nombres `default`, clúster `staging`. +- Muéstreme las etiquetas y anotaciones de este recurso de Kubernetes. ### `get_datadog_k8s_manifest` {#get-datadog-k8s-manifest} *Conjunto de herramientas: **kubernetes***\ *Permisos requeridos: `Hosts Read`*\ -Recupera el manifiesto YAML para un recurso específico de [Kubernetes][55]. Utiliza esta herramienta en lugar de `kubectl get -o yaml`. Soporta la extracción de subárboles específicos con una expresión `kubectl` JSONPath y un modo conciso que omite `status` y `managedFields` para reducir el tamaño de la respuesta. +Recupera el manifiesto YAML para un recurso específico de [Kubernetes][55]. Usa esta herramienta en lugar de `kubectl get -o yaml`. Admite la extracción de subárboles específicos con una expresión JSONPath `kubectl` y un modo conciso que omite `status` y `managedFields` para reducir el tamaño de la respuesta. -- Obtén el manifiesto para el pod `my-app` en el clúster `prod`, espacio de nombres `default`. -- Muéstrame los puertos de contenedor para el despliegue `api-server` en el espacio de nombres `default`, clúster `staging`. -- Obtén las imágenes de contenedor del manifiesto del pod `my-app`. +- Obtenga el manifiesto para el pod `my-app` en el clúster `prod`, espacio de nombres `default`. +- Muéstreme los puertos de contenedor para el despliegue `api-server` en el espacio de nombres `default`, clúster `staging`. +- Obtenga las imágenes de contenedor del manifiesto del pod `my-app`. ## Redes {#networks} Herramientas para el análisis de [Cloud Network Monitoring][31] y [Network Device Monitoring][32]. ### `analyze_cloud_network_monitoring` {#analyze-cloud-network-monitoring} -*Conjunto de herramientas: **redes***\ +*Conjunto de herramientas: **networks***\ *Permisos requeridos: `Network Connections Read`*\ -Investiga problemas a nivel de red utilizando datos de [Cloud Network Monitoring][31], analizando datos de flujo de red para detectar anomalías como tasas de retransmisión elevadas. +Investiga problemas a nivel de red utilizando datos de [Cloud Network Monitoring][31], analizando los datos de flujo de red para detectar anomalías como tasas de retransmisión elevadas. -- Analiza el tráfico de red entre mis servidores web y el clúster de bases de datos. +- Analice el tráfico de red entre mis servidores web y el clúster de base de datos. - ¿Existen problemas de retransmisión entre `service:api` y `service:payments`? -- Investiga los datos de flujo de red en busca de anomalías en el entorno de producción. +- Investigue los datos de flujo de red en busca de anomalías en el entorno de producción. ### `search_ndm_devices` {#search-ndm-devices} -*Conjunto de herramientas: **redes***\ +*Conjunto de herramientas: **networks***\ *Permisos requeridos: `NDM Read`*\ -Busca dispositivos de red (enrutadores, conmutadores, cortafuegos) monitoreados por Datadog [Network Device Monitoring][32]. +Busque dispositivos de red (routers, switches, firewalls) monitoreados por Datadog [Network Device Monitoring][32]. -- Muéstrame todos los dispositivos de red en el centro de datos `us-east-1`. -- Encuentra cortafuegos que están reportando errores. -- Lista todos los conmutadores monitoreados y sus estados. +- Muéstreme todos los dispositivos de red en el centro de datos `us-east-1`. +- Busque firewalls que estén reportando errores. +- Liste todos los switches monitoreados y sus estados. ### `get_ndm_device` {#get-ndm-device} -*Conjunto de herramientas: **redes***\ +*Conjunto de herramientas: **networks***\ *Permisos requeridos: `NDM Read`*\ -Recupera información detallada sobre un dispositivo de red específico por su ID de dispositivo. +Recupera información detallada sobre un dispositivo de red específico mediante su ID de dispositivo. -- Obtén detalles del dispositivo de red `device:abc123`. -- Muéstrame la configuración y el estado de este enrutador. +- Obtenga los detalles del dispositivo de red `device:abc123`. +- Muéstreme la configuración y el estado de este router. ### `search_ndm_interfaces` {#search-ndm-interfaces} -*Conjunto de herramientas: **redes***\ +*Conjunto de herramientas: **networks***\ *Permisos requeridos: `NDM Read`*\ -Recupera todas las interfaces de red para un dispositivo específico. +Recupera todas las interfaces de red de un dispositivo específico. -- Muéstrame todas las interfaces en el dispositivo `device:abc123`. -- Lista los estados de las interfaces de mi enrutador principal. +- Muéstreme todas las interfaces del dispositivo `device:abc123`. +- Liste los estados de las interfaces de mi router principal. -## Integración {#onboarding} +## Incorporación {#onboarding} -Herramientas de incorporación para la configuración y puesta en marcha guiada de Datadog. +Herramientas de onboarding agentic para la configuración y ajuste guiados de Datadog. ### `browser_onboarding` {#browser-onboarding} -*Conjunto de herramientas: **integración***\ +*Conjunto de herramientas: **incorporación***\ *Permisos requeridos: `RUM Apps Read`*\ -Te guía a través de la incorporación de Browser RUM a Datadog. +Le guía a través de la incorporación de Browser RUM a Datadog. -- Ayúdame a configurar la monitorización de Browser RUM para mi aplicación web. +- Ayúdeme a configurar la supervisión de Browser RUM para mi aplicación web. ### `devices_onboarding` {#devices-onboarding} *Conjunto de herramientas: **incorporación***\ *Permisos requeridos: `RUM Apps Read`*\ -Te guía a través de la incorporación de dispositivos a la monitorización de Datadog. +Lo guía a través de la incorporación de dispositivos para hacer un seguimiento en Datadog. -- Ayúdame a configurar la monitorización de dispositivos en Datadog. +- Ayúdeme a configurar el seguimiento de dispositivos en Datadog. ### `kubernetes_onboarding` {#kubernetes-onboarding} -*Conjunto de herramientas: **integración***\ +*Conjunto de herramientas: **incorporación***\ *Permisos requeridos: Ninguno*\ -Te guía a través de la incorporación de clústeres de Kubernetes a Datadog. +Lo guía a través de la incorporación de clústeres de Kubernetes a Datadog. -- Ayúdame a configurar la monitorización de Datadog para mi clúster de Kubernetes. +- Ayúdeme a configurar la supervisión de Datadog para mi clúster de Kubernetes. ### `llm_observability_onboarding` {#llm-observability-onboarding} *Conjunto de herramientas: **incorporación***\ -Te guía a través de la incorporación de la Observabilidad del Agente en Datadog. +Le guía a través de la incorporación de Agent Observability en Datadog. -- Ayúdame a configurar la Observabilidad del Agente para mi aplicación de IA. +- Ayúdeme a configurar Agent Observability para mi aplicación de IA. ### `test_optimization_onboarding` {#test-optimization-onboarding} *Conjunto de herramientas: **incorporación***\ *Permisos requeridos: Ninguno*\ -Te guía a través de la incorporación de la Optimización de Pruebas en Datadog. +Le guía a través de la incorporación de Test Optimization en Datadog. -- Ayúdame a configurar la Optimización de Pruebas para mi pipeline de CI. +- Ayúdeme a configurar Test Optimization para mi pipeline de CI. ### `serverless_onboarding` {#serverless-onboarding} *Conjunto de herramientas: **incorporación***\ *Permisos requeridos: Ninguno*\ -Te guía a través de la incorporación de aplicaciones sin servidor a Datadog, incluyendo funciones de AWS Lambda y servicios de GCP Cloud Run y funciones de Cloud Run (Gen 2). +Le guía a través de la incorporación de aplicaciones sin servidor a Datadog, incluyendo funciones de AWS Lambda y GCP Cloud Run y funciones de Cloud Run (Gen 2). -- Ayúdame a monitorear mis funciones de AWS Lambda con Datadog. -- Ayúdame a monitorear mis servicios de GCP Cloud Run con Datadog. -- Ayúdame a monitorear mis funciones de GCP Cloud Run con Datadog. +- Ayúdeme a hacer un seguimiento de mis funciones de AWS Lambda con Datadog. +- Ayúdeme a hacer un seguimiento de mis servicios de GCP Cloud Run con Datadog. +- Ayúdeme a hacer un seguimiento de mis funciones de GCP Cloud Run con Datadog. ### `source_map_uploads` {#source-map-uploads} *Conjunto de herramientas: **incorporación***\ -Te guía a través de la carga de mapas del código fuente para el mapeo de errores de RUM. +Le guía a través de la carga de mapas de fuentes para el mapeo de errores de RUM. + +- Ayúdeme a cargar mapas de fuentes para que mis errores de RUM muestren el código fuente original. + +## Product Analytics {#product-analytics} + +Herramientas para consultar datos de [Product Analytics][68], incluyendo búsqueda de vocabulario de la organización, búsqueda semántica, agregaciones, recorridos, rutas y retención. + +
El product-analytics El conjunto de herramientas no está habilitado de forma predeterminada. Consulte Set Up the Datadog MCP Server para obtener instrucciones sobre cómo habilitar los conjuntos de herramientas.
+ +### `search_product_analytics_events` {#search-product-analytics-events} +*Conjunto de herramientas: **product-analytics***\ +*Permisos requeridos: `RUM Apps Read`*\ +Encuentra las visualizaciones y acciones de Product Analytics que coincidan con una descripción en lenguaje natural mediante búsqueda semántica, incluidas las acciones etiquetadas seleccionadas por la organización. + +- Encuentre la visualización y la acción para agregar un artículo al carrito. +- ¿Cuál es el evento para completar el proceso de pago? + +### `search_product_analytics_org_entities` {#search-product-analytics-org-entities} +*Conjunto de herramientas: **product-analytics***\ +*Permisos requeridos: `RUM Apps Read`*\ +Busca entidades de Product Analytics específicas de la organización por nombre o palabra clave (indicadores de funciones, claves de atributos de contexto, gráficos guardados y segmentos). + +- Encuentre el segmento para "usuarios avanzados". +- ¿Qué indicadores de funciones (feature flags) están disponibles para filtrar los datos de Product Analytics? + +**Nota**: Utilice la expresión de filtro de segmento devuelta por esta herramienta tal cual, en lugar de construir una manualmente. + +### `get_product_analytics_saved_chart` {#get-product-analytics-saved-chart} +*Conjunto de herramientas: **product-analytics***\ +*Permisos requeridos: `RUM Apps Read` y `Product Analytics Saved Widgets Read`*\ +Recupera la definición completa de un gráfico guardado de Product Analytics por ID, incluidos sus parámetros de consulta, filtros e intervalo de tiempo. Utilice `search_product_analytics_org_entities` primero para encontrar el ID del gráfico. + +- Cargue el gráfico guardado `abc-123-def` y muéstreme sus parámetros de consulta. +- Reproduzca el gráfico guardado "retención semanal" con un rango de tiempo actualizado. -- Ayúdame a cargar mapas del código fuente para que mis errores de RUM muestren el código fuente original. +### `aggregate_product_analytics_events` {#aggregate-product-analytics-events} +*Conjunto de herramientas: **product-analytics***\ +*Permisos requeridos: `RUM Apps Read`*\ +Agrega datos de eventos de Product Analytics como un escalar o series temporales, admitiendo cálculos de conteo, cardinalidad, promedio, suma, mínimo, máximo y percentil con agrupación opcional. + +- ¿Cuántas sesiones tuvimos hoy? +- Muéstreme los usuarios activos diarios durante los últimos 30 días. -## Perfilado {#profiling} -Herramientas de solo lectura para descubrir, explorar y analizar datos de [Continuous Profiler][62] a través de servicios, entornos de ejecución y trazas. +### `run_product_analytics_journey` {#run-product-analytics-journey} +*Conjunto de herramientas: **product-analytics***\ +*Permisos requeridos: `RUM Apps Read`*\ +Ejecuta consultas de embudo, series temporales, escalares, lista y abandonos a través de un recorrido de usuario de varios pasos, rastreado a nivel de usuario, sesión o cuenta. + +- ¿Cuál es la tasa de conversión desde la visualización de un producto hasta completar la compra? +- Muéstreme los usuarios que abandonaron entre agregar al carrito y la compra. + +### `run_product_analytics_pathway` {#run-product-analytics-pathway} +*Conjunto de herramientas: **product-analytics***\ +*Permisos requeridos: `RUM Apps Read`*\ +Ejecuta un análisis de Sankey (ruta) que muestra cómo navegan los usuarios entre vistas, comenzando desde una vista de origen o conduciendo a una vista de destino. + +- ¿Cuáles son las rutas más comunes que toman los usuarios después de llegar a la página de inicio? +- Muéstreme las rutas que conducen a la página de pago. + +### `run_product_analytics_retention` {#run-product-analytics-retention} +*Conjunto de herramientas: **product-analytics***\ +*Permisos requeridos: `RUM Apps Read`*\ +Ejecuta consultas de retención en los datos de Product Analytics como una cuadrícula de cohorte, curva de retención, series temporales o valor escalar, rastreados a nivel de usuario o cuenta. + +- Muéstreme la cuadrícula de retención semanal para los usuarios que se registraron en el último trimestre. +- ¿Cuál es la tasa de retención del día 7 para los usuarios que se unieron en enero? + +## Profiling {#profiling} +Herramientas de solo lectura para descubrir, explorar y analizar datos de [Continuous Profiler][62] en servicios, tiempos de ejecución y trazas. ### `get_profiling_profile_types` {#get-profiling-profile-types} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve los tipos de perfil y familias disponibles para un contexto de consulta determinado (cadena de consulta y rango de tiempo) o para un contexto de traza o tramo. Utiliza esto primero para descubrir qué es consultable. +Devuelve los tipos y familias de perfiles disponibles para un contexto de consulta determinado (cadena de consulta y rango de tiempo) o un contexto de traza/tramo. Utilice esto primero para descubrir qué se puede consultar. -- Muéstrame qué tipos de perfil están disponibles para `service:checkout-api` en la última hora. -- ¿Qué familias de perfil están disponibles para la traza `7d5d747be160e280504c099d984bcfe0`? -- Lista los tipos de perfil disponibles en mi entorno de producción. +- Muéstreme qué tipos de perfil están disponibles para `service:checkout-api` en la última hora. +- ¿Qué familias de perfiles están disponibles para la traza `7d5d747be160e280504c099d984bcfe0`? +- Enumere los tipos de perfil disponibles en mi entorno de producción. ### `get_profiling_services` {#get-profiling-services} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Lista los servicios perfilados y sus familias de perfil en contexto. Los resultados no están ordenados y no implican importancia o nivel de actividad. +Enumera los servicios perfilados y sus familias de perfilado en el contexto. Los resultados no están ordenados y no implican importancia ni nivel de actividad. -- Lista todos los servicios con perfilado habilitado en producción. -- Muéstrame qué servicios tienen datos de perfilado de JVM. +- Enumere todos los servicios con perfilado habilitado en producción. +- Muéstreme qué servicios tienen datos de perfilado de JVM. - ¿Qué servicios están perfilados en el entorno del equipo de pagos? ### `get_profiling_runtime_ids` {#get-profiling-runtime-ids} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve los identificadores de tiempo de ejecución perfilados individuales (procesos o contenedores) en contexto. Por defecto, se establece en el top-1 por CPU; el parámetro de límite controla cuántos. +Devuelve los ID de tiempo de ejecución perfilados individuales (procesos o contenedores) en el ámbito. El valor predeterminado es el top 1 por CPU; el parámetro de límite controla cuántos. -- Muéstrame los 10 principales identificadores de tiempo de ejecución por CPU para `service:checkout-api`. -- Obtén el tiempo de ejecución con mayor CPU para mi servicio de Go. -- Lista los identificadores de tiempo de ejecución perfilados para el servicio de pagos en la última hora. +- Muéstreme los 10 principales ID de tiempo de ejecución por CPU para `service:checkout-api`. +- Obtenga el tiempo de ejecución con mayor uso de CPU para mi servicio Go. +- Enumere los ID de tiempo de ejecución perfilados para el servicio de pagos en la última hora. ### `get_profiling_service_insights` {#get-profiling-service-insights} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve información de servicio precomputada, incluyendo un resumen de alto nivel, señales contextuales (métodos afectados, paquetes, procesos) y pasos recomendados a seguir. +Devuelve información sobre el servicio precalculada, que incluye un resumen de alto nivel, señales contextuales (métodos, paquetes y procesos afectados) y los siguientes pasos recomendados. -- Muéstrame las percepciones de perfilado para `service:checkout-api`. -- ¿Qué problemas de rendimiento están señalados en el servicio de pagos? -- Obtén recomendaciones de perfilado para mi servicio de Java. +- Muéstreme la información de perfilado para `service:checkout-api`. +- ¿Qué problemas de rendimiento están marcados en el servicio de pagos? +- Obtén recomendaciones de perfilado para mi servicio Java. ### `explore_profiling_flame_graph` {#explore-profiling-flame-graph} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve las trazas de pila top-N por contribución de valor para un tipo de perfil determinado. Soporta filtrado por marco, punto de conexión o expresión regular de atributo. Servicio único. Acepta ya sea `service:family` o un traceContext. +Devuelve los N principales seguimientos de pila por contribución de valor para un tipo de perfil determinado. Admite filtrado por marco, punto de conexión o expresión regular de atributo. Servicio único. Acepta `service:family` o un traceContext. -- Muéstrame el gráfico de llamas de la CPU para `service:checkout-api` en la última hora. +- Muéstreme el gráfico de llama de CPU para `service:checkout-api` durante la última hora. - Encuentra los principales puntos críticos de asignación para el servicio de pagos. -- Explora el gráfico de llamas para la traza `7d5d747be160e280504c099d984bcfe0`. +- Explora el gráfico de llama para la traza `7d5d747be160e280504c099d984bcfe0`. ### `explore_profiling_call_graph` {#explore-profiling-call-graph} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve una vista del gráfico de llamadas (bordes de llamador a llamado) de funciones críticas para un tipo de perfil dado. Por defecto, muestra los 20 nodos principales, un corte del 5% y 5 bordes por nodo. Servicio único. +Devuelve una vista de gráfico de llamadas (bordes de llamador a llamado) de funciones críticas para un tipo de perfil determinado. El valor predeterminado es de los 20 nodos principales, un límite del 5% y 5 bordes por nodo. Servicio único. -- Muéstrame el gráfico de llamadas para funciones críticas de CPU en `service:checkout-api`. -- ¿Qué funciones llaman a los caminos más lentos en mi servicio de Go? +- Muéstrame el gráfico de llamadas para las funciones de CPU activas en `service:checkout-api`. +- ¿Qué funciones llaman a las rutas más lentas en mi servicio de Go? - Obtén el gráfico de llamadas de asignación para el servicio de pagos. ### `explore_profiling_timeline` {#explore-profiling-timeline} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve una línea de tiempo de grupos de carriles (hilos, recolección de basura, etc.) con actividad de CPU y E/S. Soporta un modo de camino crítico (solo Go; requiere traceContext) para identificar cuellos de botella de latencia dentro de un tramo. +Devuelve una línea de tiempo de grupos de carriles (hilos, recolección de basura, etcétera) con actividad de CPU y E/S. Admite un modo de ruta crítica (solo para Go; requiere traceContext) para identificar cuellos de botella de latencia dentro de un tramo. -- Muéstrame la línea de tiempo de hilos para `service:checkout-api` en los últimos 15 minutos. +- Muéstreme la línea de tiempo de hilos para `service:checkout-api` durante los últimos 15 minutos. - Encuentra la ruta crítica para la traza `abc123` en mi servicio de Go. -- Explora la recolección de basura y la actividad de la CPU alrededor del pico de latencia. +- Explora la recolección de basura y la actividad de CPU alrededor del pico de latencia. ### `get_profiling_timeseries` {#get-profiling-timeseries} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve datos de perfilado agregados como series temporales (métricas de tasa). Mejor para tendencias, comparación entre servicios y detección de regresiones. Soporta groupBy en campos de marco, contextos y etiquetas. +Devuelve datos de perfilado agregados como series temporales (métricas de tasa). Ideal para tendencias, comparación entre servicios y detección de regresiones. Admite groupBy en campos de marco, contextos y etiquetas. -- Muéstrame las series temporales del perfil de CPU para `service:checkout-api` en las últimas 24 horas. -- Compara las tasas de asignación entre mis servicios de Java agrupados por versión. -- Detecta regresiones de perfil en la última semana agrupadas por despliegue. +- Muéstrame las series temporales del perfil de CPU para `service:checkout-api` durante las últimas 24 horas. +- Compara las tasas de asignación entre mis servicios Java agrupados por versión. +- Detecta regresiones de perfil durante la última semana agrupadas por despliegue. ### `get_profiling_tag_names` {#get-profiling-tag-names} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Descubre los nombres de etiquetas disponibles (como servicio, host, env, versión, familia, runtime-id, kube_*) para filtrar datos de perfilado. Devuelve hasta 50 resultados, ordenados por relevancia. +Descubre los nombres de etiquetas disponibles (como service, host, env, version, family, runtime-id, kube_*) para filtrar datos de perfil. Devuelve hasta 50 resultados, ordenados por relevancia. -- ¿Qué nombres de etiquetas están disponibles para filtrar datos de perfilado en producción? -- Lista los nombres de etiquetas de perfilado para `service:checkout-api`. +- ¿Qué nombres de etiquetas están disponibles para filtrar datos de perfil en producción? +- Liste los nombres de etiquetas de perfil para `service:checkout-api`. ### `get_profiling_tag_values` {#get-profiling-tag-values} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve valores para una etiqueta de perfilado específica (por ejemplo, todos los valores de la etiqueta de servicio). Devuelve hasta 50 resultados, ordenados por frecuencia. +Devuelve valores para una etiqueta de perfil específica (por ejemplo, todos los valores de la etiqueta service). Devuelve hasta 50 resultados, ordenados por frecuencia. -- ¿Qué versiones del servicio de pagos tenemos datos de perfilado en la última hora? -- ¿Cuáles son los dos centros de datos con más datos de perfilado disponibles para `service:checkout-api`? +- ¿De qué versiones del servicio de pagos tenemos datos de perfil en la última hora? +- ¿Cuáles son los dos centros de datos con más datos de perfil disponibles para `service:checkout-api`? ### `get_profiling_fields` {#get-profiling-fields} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Descubre campos de facetas de marco y contexto (como `@stack.function` y `@labels.trace_endpoint`) utilizables en `get_profiling_timeseries` parámetros groupBy y filter. Limitado por sampleType. +Descubre campos de faceta de marco y contexto (como `@stack.function` y `@labels.trace_endpoint`) utilizables en los parámetros `get_profiling_timeseries` groupBy y filter. Delimitado por sampleType. - ¿Qué campos de marco puedo agrupar para perfiles de CPU? -- Muéstrame los campos de facetas disponibles para perfiles de asignación. -- Lista los campos de contexto por los que puedo filtrar series temporales para `service:checkout-api`. +- Muéstrame los campos de faceta disponibles para perfiles de asignación. +- Liste los campos de contexto por los que puedo filtrar series temporales para `service:checkout-api`. ### `get_profiling_field_values` {#get-profiling-field-values} -*Conjunto de herramientas: **perfilado***\ +*Conjunto de herramientas: **profiling***\ *Permisos requeridos: `Continuous Profiler Read`*\ -Devuelve valores para un marco específico o campo de contexto descubierto con `get_profiling_fields`. Ordenado por frecuencia. +Devuelve valores para un campo de marco o contexto específico descubierto con `get_profiling_fields`. Ordenado por frecuencia. -- Muéstrame los valores principales para `@stack.function` en mis perfiles de CPU. -- Obtén los valores principales de los puntos de conexión de `@labels.trace_endpoint`. -- Lista los valores para el campo de paquete en los perfiles de asignación. +- Muéstreme los valores principales para `@stack.function` en mis perfiles de CPU. +- Obtén los valores principales de punto de conexión de `@labels.trace_endpoint`. +- Enumera los valores para el campo de paquete en perfiles de asignación. ## Tablas de referencia {#reference-tables} -Herramientas para gestionar [tablas de referencia][45], incluyendo listar tablas, leer filas, agregar filas y crear tablas desde el almacenamiento en la nube. +Herramientas para administrar [Tablas de referencia][45], que incluyen enumerar tablas, leer filas, insertar o actualizar filas, y crear tablas sincronizadas desde archivos de almacenamiento en la nube o como tablas vacías que usted completa directamente. ### `list_reference_tables` {#list-reference-tables} -*Conjunto de herramientas: **tablas de referencia***\ -Lista y busca [tablas de referencia][45] en la organización, con filtrado opcional por nombre y ordenamiento. +*Conjunto de herramientas: **tablas-de-referencia***\ +Listar y buscar [Tablas de referencia][45] en la organización, con filtrado opcional por nombre y ordenamiento. + +- Listar todas las tablas de referencia en mi organización. +- Encuentre tablas de referencia con `customer` en el nombre. +- Muéstreme las tablas de referencia ordenadas por hora de última actualización. + +### `list_reference_table_rows` {#list-reference-table-rows} +*Conjunto de herramientas: **tablas-de-referencia***\ +Enumera todas las filas en una tabla de referencia con filtrado y paginación opcionales. Utilice `list_reference_tables` primero para encontrar el ID y el esquema de la tabla. -- Lista todas las tablas de referencia en mi organización. -- Encuentra tablas de referencia con `customer` en el nombre. -- Muéstrame las tablas de referencia ordenadas por la última fecha de actualización. +- Listar todas las filas en la tabla de referencia `ip_allowlist`. +- Muéstreme las primeras 50 filas de la tabla `customer_tiers`. ### `get_reference_table_rows` {#get-reference-table-rows} -*Conjunto de herramientas: **tablas de referencia***\ -Recupera filas específicas de una tabla de referencia por sus valores de clave primaria. Usa `list_reference_tables` primero para encontrar el ID de la tabla y el esquema. +*Conjunto de herramientas: **tablas-de-referencia***\ +Recupera filas específicas de una tabla de referencia mediante sus valores de clave principal. Utilice `list_reference_tables` primero para encontrar el ID y el esquema de la tabla. -- Obtén las filas con las claves primarias `user001` y `user002` de la tabla de referencia de usuarios. -- Busca la entrada para el ID de cuenta `acct-123` en la tabla de cuentas. +- Obtenga las filas con las claves principales `user001` y `user002` de la tabla de referencia de usuarios. +- Busque la entrada para el ID de cuenta `acct-123` en la tabla de cuentas. ### `append_reference_table_rows` {#append-reference-table-rows} -*Conjunto de herramientas: **tablas de referencia***\ -Agrega nuevas filas a una tabla de referencia existente. Esta operación solo agrega filas y no modifica ni elimina datos existentes. Cada fila debe incluir todos los campos requeridos del esquema de la tabla, incluyendo el campo de clave primaria. +*Conjunto de herramientas: **tablas-de-referencia***\ +Agrega nuevas filas a una tabla de referencia existente. Esta operación solo agrega filas y no modifica ni elimina los datos existentes. Cada fila debe incluir todos los campos requeridos del esquema de la tabla, incluido el campo de clave principal. Si es posible que ya existan filas, utilice `upsert_reference_table_rows` en su lugar. + +- Agregue una fila nueva para el usuario `user003` con el nombre `Carol` y la edad `28` a la tabla de usuarios. +- Agregue estas cinco entradas de cuenta nuevas a la tabla de referencia de cuentas. + +### `upsert_reference_table_rows` {#upsert-reference-table-rows} +*Conjunto de herramientas: **tablas-de-referencia***\ +Inserta filas nuevas o actualiza filas existentes en una tabla de referencia. Si ya existe una fila con la misma clave principal, sus valores se sobrescriben. Utilícelo en lugar de `append_reference_table_rows` cuando las filas ya puedan existir. -- Agrega una nueva fila para el usuario `user003` con nombre `Carol` y edad `28` a la tabla de usuarios. -- Agrega estas cinco nuevas entradas de cuenta a la tabla de referencia de cuentas. +- Actualice el nivel de la cuenta `acct-123` en la tabla `customer_tiers`. +- Agregue o actualice estas diez entradas de servicio en la tabla de referencia `service_catalog`. ### `create_reference_table` {#create-reference-table} -*Conjunto de herramientas: **tablas de referencia***\ -Crea una nueva tabla de referencia respaldada por un archivo CSV en Amazon S3, Google Cloud Storage o Azure Blob Storage. Solo se admiten los tipos de campo `INT32` y `STRING`. +*Conjunto de herramientas: **tablas-de-referencia***\ +Crea una tabla de referencia nueva. Admite dos modos: `LOCAL_FILE` crea una tabla vacía que puede completar con `append_reference_table_rows` o `upsert_reference_table_rows`. Los modos respaldados por la nube (`S3`, `GCS`, `AZURE`) se sincronizan desde un archivo CSV en Amazon S3, Google Cloud Storage o Azure Blob Storage. Solo se admiten los tipos de campo `INT32` y `STRING`. -- Crea una tabla de referencia llamada `ip_allowlist` desde el archivo `allowlist.csv` en mi bucket S3 `my-data-bucket`. -- Configura una nueva tabla de referencia respaldada por GCS llamada `customer_tiers` con sincronización automática habilitada. +- Cree una tabla de referencia vacía llamada `service_catalog` con campos para el nombre del servicio, el equipo propietario y el nivel. +- Cree una tabla de referencia llamada `ip_allowlist` a partir del archivo `allowlist.csv` en mi depósito de S3 `my-data-bucket`. +- Configure una tabla de referencia nueva respaldada por GCS llamada `customer_tiers` con la sincronización automática habilitada. -## Acciones Remotas {#remote-actions} +## Acciones remotas {#remote-actions} -
El remote-actions el conjunto de herramientas está en vista previa. Regístrese para obtener acceso.
+
El remote-actions El conjunto de herramientas está en versión preliminar. Regístrese para obtener acceso.
-Herramientas para ejecutar diagnósticos de solo lectura en hosts instrumentados con el Agente de Datadog. Los comandos llegan al host a través del Ejecutador de Acción Privada (PAR) utilizando un [intérprete de shell restringido][63]. Todos los comandos se ejecutan como funciones seguras de Go sin acceso de escritura, sin ejecución de binarios externos y sin salida de red. La lista de comandos permitidos se controla por versión del Agente desde el backend de Datadog. +Herramientas para ejecutar diagnósticos de solo lectura en servidores instrumentados con el Datadog Agent. Los comandos llegan al servidor a través del Private Action Runner (PAR) utilizando un [intérprete de shell restringido][63]. Todos los comandos se ejecutan como funciones integradas seguras de Go sin acceso de escritura, sin ejecución de binarios externos y sin salida de red. La lista de comandos permitidos se controla por versión del Agent desde el backend de Datadog. ### `datadog_remote_action_restricted_shell_run_command` {#datadog-remote-action-restricted-shell-run-command} -*Conjunto de herramientas: **acciones remotas***\ +*Conjunto de herramientas: **remote-actions***\ *Permisos requeridos: `Connections Resolve` y `Private Action Runner Contribute`*\ -Ejecuta un comando de shell de solo lectura en un host especificado. Los comandos soportados incluyen: `cat`, `ls`, `head`, `tail`, `find`, `grep`, `sed`, `cut`, `sort`, `uniq`, `wc`, `ping`, `ss` y `ip`. Soporta tuberías, bucles, condicionales, asignación de variables y globbing. +Ejecute un comando de shell de solo lectura en un servidor especificado. Los comandos admitidos incluyen: `cat`, `ls`, `head`, `tail`, `find`, `grep`, `sed`, `cut`, `sort`, `uniq`, `wc`, `ping`, `ss` y `ip`. Admite tuberías, bucles, condicionales, asignación de variables y globbing. -- Muéstrame las últimas 100 líneas del registro del Agente de Datadog en el host `prod-web-01`. -- Encuentra todas las entradas de ERROR en `/var/log/app/` en el host `db-replica-3` de la última hora. -- Obtén el contenido de `/etc/datadog-agent/datadog.yaml` en el host `prod-worker-07`. +- Muéstrame las últimas 100 líneas del registro del Datadog Agent en el servidor `prod-web-01`. +- Busque todas las entradas ERROR en `/var/log/app/` en el servidor `db-replica-3` de la última hora. +- Obtenga el contenido de `/etc/datadog-agent/datadog.yaml` en el servidor `prod-worker-07`. ## RUM {#rum} -Herramientas para [Real User Monitoring][58], incluyendo la resolución de aplicaciones, el resumen del rendimiento, la presentación de información agregada para vistas, la exploración de métricas y la inspección de la configuración de la aplicación. - -
El rum el conjunto de herramientas está en Vista Previa. Contacte a soporte de Datadog para solicitar acceso.
+Herramientas para [Real User Monitoring][58], que incluyen la resolución de aplicaciones, el resumen del rendimiento, la presentación de información agregada para vistas, el monitoreo y la gestión de [operaciones][73], la exploración de métricas, la inspección de la configuración de la aplicación, la gestión de filtros de retención y la gestión de métricas RUM personalizadas. ### `search_rum_applications` {#search-rum-applications} -*Conjunto de herramientas: **RUM***\ +*Conjunto de herramientas: **rum***\ *Permisos requeridos: `RUM Apps Read`*\ -Lista sus aplicaciones RUM y resuelve el `application_id` a utilizar para las llamadas posteriores a la herramienta RUM. +Enumere sus aplicaciones RUM y resuelva el `application_id` que se utilizará para llamadas posteriores a la herramienta RUM. - Encuentre la aplicación RUM llamada "checkout-web" y devuelva su ID de aplicación. -- Liste todas sus aplicaciones RUM. +- Enumere todas sus aplicaciones RUM. ### `get_rum_summary` {#get-rum-summary} -*Conjunto de herramientas: **RUM***\ +*Conjunto de herramientas: **rum***\ *Permisos requeridos: `RUM Apps Read` y `Timeseries`*\ -Devuelve un resumen de métricas vitales para una aplicación RUM, con diferencias de período a período. +Devuelve un resumen de las métricas vitales para una aplicación RUM, con diferencias periodo a periodo. - Resuma el rendimiento de la aplicación RUM "checkout-web" durante las últimas 24 horas. -- ¿Cómo cambiaron los Core Web Vitals en su aplicación RUM principal de semana a semana? +- ¿Cómo cambiaron las Core Web Vitals en su aplicación RUM principal semana a semana? ### `get_rum_insight` {#get-rum-insight} -*Conjunto de herramientas: **RUM***\ +*Conjunto de herramientas: **rum***\ *Permisos requeridos: `RUM Apps Read`*\ -Devuelve información agregada para Vistas RUM: cascada, tareas largas, distribuciones vitales y análisis de etiquetas. +Devuelve información agregada para vistas de RUM: cascada, tareas largas, distribuciones vitales y análisis de etiquetas. -- Para la vista `/checkout` en la aplicación "shop", muéstreme la cascada de recursos agregada durante la última hora. +- Para la vista `/checkout` en la aplicación "shop", muestre la cascada de recursos agregada durante la última hora. - Desglose la distribución de INP por tipo de dispositivo para la página de inicio. +### `get_rum_view_waterfall` {#get-rum-view-waterfall} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read`*\ +Reconstruye la línea de tiempo de carga cronológica para una sola ocurrencia de una vista de RUM en web o móvil. Devuelve cada recurso, tarea larga, error e interacción del usuario durante esa vista, ordenados por hora de inicio. Utilice esto para investigar una carga de página o pantalla concreta. Para la vista agregada entre sesiones, utilice `get_rum_insight`. + +- Muestre la cascada completa para la vista RUM con ID `AwAAc3dhcmV`. +- ¿Por qué la página de pago con vista UUID `d64b1e7c-8f2a-4c3b-9e1d-5a6b7c8d9e0f` tardó 12 segundos en cargarse? + +### `search_rum_operations` {#search-rum-operations} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read` o `Timeseries`*\ +Enumera las [operaciones][73] en su organización, incluidas las operaciones instrumentadas por SDK y las configuradas por interfaz de usuario, y resuelve un nombre de operación a su `operation_id` y `application_id`. Las operaciones observadas solo a través del SDK no tienen ID. + +- Liste las operaciones de RUM en la aplicación \"checkout-web\". +- Busque el ID de operación para la operación \"checkout-flow\". + +### `get_rum_operation_summary` {#get-rum-operation-summary} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read` o `Timeseries` o `SLOs Read` o `Monitors Read`*\ +Devuelve un resumen de salud para una sola operación: volumen, tasa de éxito, desglose de fallas por motivo, percentiles de latencia, una tendencia de éxito y falla por depósito, y SLO y monitores relacionados. + +- ¿La operación \"checkout-flow\" es saludable en las últimas 24 horas? +- Muestre la línea base y la tendencia de latencia p95 para la operación de pago. + +### `get_rum_operation_insights` {#get-rum-operation-insights} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read` o `Timeseries`*\ +Investiga por qué una operación está fallando, es lenta o fue abandonada. El modo `failures` devuelve los principales puntos finales con errores, atributos de contexto personalizados en ejecuciones fallidas y errores de bloqueo correlacionados. El modo `latency` compara cohortes lentas y rápidas y devuelve los principales recursos lentos. El modo `abandonment` muestra con qué frecuencia los usuarios se rinden en lugar de completar, qué vistas y recursos en curso están involucrados, y a dónde navegan los usuarios después. + +- ¿Por qué la operación \"checkout-flow\" es lenta en las últimas cuatro horas? +- Los usuarios están abandonando el proceso de pago sin ningún error. Muéstrele información sobre el abandono. + +### `create_rum_operation` {#create-rum-operation} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Write`*\ +Crea una operación configurada mediante la interfaz de usuario que rastrea el recorrido de un usuario entre un evento de inicio y un evento de éxito, fallo o abandono, coincidente mediante consultas de búsqueda en eventos RUM. Esta herramienta no crea operaciones instrumentadas por SDK, las cuales se definen en el código de la aplicación. Confirme el nombre de la operación, las consultas y los tipos de evento antes de aplicar. + +- Cree una operación en "checkout-web" que comience en la vista `/checkout` y tenga éxito en `/checkout/complete`. +- Configure una operación para el flujo de registro que falle cuando ocurra un error de validación. + +### `update_rum_operation` {#update-rum-operation} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read` y `RUM Apps Write`*\ +Actualiza una operación configurada mediante la interfaz de usuario en el lugar. Solo se cambian los campos que proporcione, y el resto mantiene sus valores actuales. Esta herramienta no puede cambiar el nombre de una operación y no afecta a las operaciones instrumentadas por SDK. Confirme el cambio antes de aplicarlo. + +- Cambie la consulta de fallo en la operación "checkout" para que coincida con los pagos rechazados. +- Agregue el seguimiento de abandono a la operación de registro. + +### `delete_rum_operation` {#delete-rum-operation} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read` y `RUM Apps Write`*\ +Elimina permanentemente una operación configurada mediante la interfaz de usuario por ID o nombre. La respuesta enumera los SLO y monitores que aún están etiquetados para la operación, los cuales no se eliminan con ella. Confirme la eliminación antes de aplicar. Esta herramienta no afecta las operaciones instrumentadas por SDK. + +- Elimine la operación "legacy-checkout" de "checkout-web". +- Elimine la operación con ID `abc-123-def`. + ### `search_rum_metrics` {#search-rum-metrics} -*Conjunto de herramientas: **RUM***\ +*Conjunto de herramientas: **rum***\ *Permisos requeridos: `RUM Apps Read`*\ -Explora las métricas de RUM para una aplicación, incluyendo métricas predeterminadas y métricas personalizadas. +Explora las métricas de RUM para una aplicación, incluidas las métricas predeterminadas y las métricas personalizadas. + +- Liste las métricas de RUM personalizadas definidas en la aplicación "checkout-web". +- Muéstreme las métricas de RUM disponibles relacionadas con el tiempo de carga de la página en mi aplicación principal. + +### `upsert_rum_metric` {#upsert-rum-metric} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read` y `RUM Generate Metrics`*\ +Crea o actualiza una métrica de RUM personalizada. Verifica los campos inmutables antes de actualizar una métrica existente. Esta operación es idempotente. + +- Cree una métrica de distribución `rum.view.lcp_by_country` que rastree el LCP p95 para eventos de vista, agrupados por país. +- Actualice el filtro en `rum.error.checkout_errors` para excluir el tráfico de prueba Synthetic. + +### `delete_rum_metric` {#delete-rum-metric} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Apps Read` y `RUM Generate Metrics`*\ +Elimina permanentemente una métrica RUM personalizada por ID. Esta operación es idempotente. -- Liste las métricas personalizadas de RUM definidas en la aplicación "checkout-web". -- Muéstreme las métricas de RUM disponibles relacionadas con el tiempo de carga de página en mi aplicación principal. +- Elimine la métrica RUM personalizada `rum.view.my_custom_metric`. +- Elimine la métrica RUM `rum.view.legacy_page_views` de mi organización. ### `search_rum_retention_filters` {#search-rum-retention-filters} -*Conjunto de herramientas: **RUM***\ +*Conjunto de herramientas: **rum***\ *Permisos requeridos: `RUM Retention Filters Read`*\ -Liste los filtros de retención configurados en una aplicación de RUM. Solo lectura; disponible para clientes de [RUM without Limits][59]. +Enumera los filtros de retención configurados en una aplicación RUM. Solo lectura; disponible para clientes de [RUM without Limits][59]. - Liste los filtros de retención configurados en la aplicación "checkout-web". -- ¿Qué filtros de retención tengo en mi aplicación principal de RUM? +- ¿Qué filtros de retención tengo en mi aplicación RUM principal? -## Seguridad {#security} +### `append_new_rum_retention_filter` {#append-new-rum-retention-filter} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Retention Filters Write` o `Product Analytics Apps Write`*\ +Crea un filtro de retención de RUM, que se añade al final del orden de evaluación. Los filtros de retención controlan qué eventos de RUM se indexan y retienen, lo cual afecta la facturación. Confirme el cambio antes de aplicarlo. -Herramientas para escaneo de seguridad de código, analizando, buscando y clasificando [señales de seguridad][53], gestionando [reglas de detección][60] y [supresiones][61], y analizando [hallazgos de seguridad][54]. +- Cree un filtro de retención en "checkout-web" que retenga el 100% de los eventos de error. +- Agregue un filtro a mi aplicación RUM principal que mantenga todas las sesiones que coincidan con `@view.url_path:/checkout`. + +### `update_rum_retention_filter` {#update-rum-retention-filter} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Retention Filters Write` o `Product Analytics Apps Write`*\ +Actualiza los atributos de un filtro de retención de RUM existente, como su nombre, tipo de evento, consulta, tasa de muestreo o estado de habilitación. Confirme el cambio antes de aplicarlo. + +- Aumente la tasa de muestreo en el filtro de retención "checkout errors" al 100%. +- Desactive el filtro de retención "long tasks" en mi aplicación RUM principal. + +### `reorder_rum_retention_filters` {#reorder-rum-retention-filters} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Retention Filters Write` o `Product Analytics Apps Write`*\ +Establezca el orden de evaluación completo de los filtros de retención de una aplicación RUM. Los filtros se evalúan de arriba hacia abajo y cada evento se detiene en la primera coincidencia, por lo que el orden determina qué tasa de muestreo se aplica. Confirme el nuevo orden antes de aplicarlo. + +- Mueva el filtro de retención "checkout errors" por encima del filtro general en "checkout-web". +- Reordene mis filtros de retención para que los filtros específicos se evalúen antes que los generales. + +### `delete_rum_retention_filter` {#delete-rum-retention-filter} +*Conjunto de herramientas: **rum***\ +*Permisos requeridos: `RUM Retention Filters Write` o `Product Analytics Apps Write`*\ +Elimine permanentemente un filtro de retención de RUM por ID. Confirme la eliminación antes de aplicar. Esta operación es idempotente. + +- Elimine el filtro de retención \"legacy sessions\" de \"checkout-web\". +- Elimine el filtro de retención con ID `abc-123-def` de mi aplicación RUM principal. + +## Security {#security} + +Herramientas para el escaneo, análisis, búsqueda y clasificación de seguridad de código [señales de seguridad][53], investigación de indicadores de [IoC Explorer][67], gestión de [reglas de detección][60] y [supresiones][61], y análisis de [hallazgos de seguridad][54]. ### `datadog_secrets_scan` {#datadog-secrets-scan} -*Conjunto de herramientas: **seguridad***\ -Escanea el código en busca de secretos y credenciales codificados, detectando claves de AWS, claves de API, contraseñas, tokens, claves privadas y credenciales de base de datos. +*Conjunto de herramientas: **Security***\ +Analiza el código en busca de secretos y credenciales codificados, detectando claves de AWS, claves de API, contraseñas, tokens, claves privadas y credenciales de bases de datos. -- Escanee mi código en busca de secretos codificados. -- Verifique si hay claves de API o contraseñas incluidas en este archivo. +- Analice mi código en busca de secretos codificados. +- Compruebe si hay claves de API o contraseñas incluidas en este archivo. ### `get_datadog_security_signals_schema` {#get-datadog-security-signals-schema} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Signals Read`*\ -Devuelve los campos disponibles y sus tipos para señales de seguridad. Los tipos de señales se mapean a `@workflow.rule.type` valores como `Log Detection`, `Application Security` y `Workload Security`. +Devuelve los campos disponibles y sus tipos para las señales de seguridad. Los tipos de señal se asignan a valores de `@workflow.rule.type` como `Log Detection`, `Application Security` y `Workload Security`. - ¿Qué campos puedo usar para filtrar señales de seguridad? -- Muéstreme los campos disponibles para señales de Cloud SIEM. +- Muéstreme los campos disponibles para las señales de Cloud SIEM. - ¿Qué valores de enumeración son válidos para el campo de tipo de regla de señal? ### `search_datadog_security_signals` {#search-datadog-security-signals} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Signals Read`*\ -Busque y recupere señales de seguridad de Datadog Security Monitoring, incluyendo señales de Cloud SIEM, señales de App & API Protection y señales de Workload Protection. +Busca y recupera señales de seguridad de Datadog Security Monitoring, incluidas las señales de Cloud SIEM, las señales de App & API Protection y las señales de Workload Protection. -- Muéstreme señales de seguridad de las últimas 24 horas. -- Encuentre señales de seguridad de alta severidad relacionadas con mi entorno de producción. +- Muéstreme las señales de seguridad de las últimas 24 horas. +- Busque señales de seguridad de alta gravedad relacionadas con mi entorno de producción. - Liste señales de Cloud SIEM activadas por intentos de inicio de sesión sospechosos. ### `analyze_datadog_security_signals` {#analyze-datadog-security-signals} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Signals Read` y `Timeseries`*\ -Analiza señales de seguridad utilizando consultas SQL para agregaciones, agrupaciones y análisis de tendencias. Utilícelo para conteos, top-N y desgloses a lo largo del tiempo. Para listar o recuperar señales específicas, utilice `search_datadog_security_signals` o `get_datadog_security_signal`. +Analiza señales de seguridad mediante consultas SQL para agregaciones, agrupaciones y análisis de tendencias. Utilícelo para conteos, top-N y desgloses a lo largo del tiempo. Para enumerar o recuperar señales específicas, utilice `search_datadog_security_signals` o `get_datadog_security_signal`. -- Muéstreme las 10 principales reglas de SIEM por conteo de señales en los últimos 7 días. -- Cuente señales de seguridad altas y críticas agrupadas por severidad. +- Muéstreme las 10 reglas de SIEM principales por conteo de señales en los últimos 7 días. +- Cuente las señales de seguridad altas y críticas agrupadas por gravedad. - ¿Cuántas señales de App & API Protection se activaron por servicio ayer? ### `get_datadog_security_signal` {#get-datadog-security-signal} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Signals Read`*\ -Recupera los detalles completos de una única señal de seguridad por ID, incluyendo atributos, información de reglas, estado de triage, etiquetas y correlaciones de incidencias. +Recupera los detalles completos de una única señal de seguridad por ID, incluidos los atributos, la información de la regla, el estado de clasificación, las etiquetas y las correlaciones de incidencias. - Obtenga los detalles completos de la señal de seguridad `AwAAAZ27F1BUjY4rPQAAABhBWjI3RjFCVWpZNHJBQUFBSGFNQVZBQUFBR1Bu`. -- Muéstreme la regla, el estado de triage y las incidencias vinculadas para esta señal. +- Muéstreme la regla, el estado de clasificación y las incidencias vinculadas para esta señal. ### `update_datadog_security_signals_triage` {#update-datadog-security-signals-triage} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Signals Write`*\ +Actualiza el estado de clasificación o el responsable de una o más señales de seguridad de forma masiva (hasta 500 señales). Acepta una lista de ID de señales o una consulta de filtro que coincida con todas las señales que se van a actualizar. + +- Archivar todas las señales de la regla "Brute Force Login" en las últimas 24 horas. +- Establecer todas las señales abiertas para `service:checkout` como en revisión y asignármelas. +- Marcar la señal `AwAAAZ27F1BUjY4rPQAAABhBWjI3RjFCVWpZNHJBQUFBSGFNQVZBQUFBR1Bu` como archivada con el motivo "testing". + +### `search_datadog_security_ioc_indicators` {#search-datadog-security-ioc-indicators} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Signals Read`*\ +Enumere los indicadores de [IoC Explorer][67] (IP, dominios, URL, hashes de archivos) que coincidan con las fuentes de inteligencia de amenazas. Empareje con `get_datadog_security_ioc_indicator` para obtener detalles completos y con `update_datadog_security_ioc_indicator_triage` para marcar como revisado. + +- Muéstreme los indicadores de IP maliciosas con la puntuación más alta. +- Liste los indicadores de IoC en la categoría `residential_proxy` con una puntuación media o superior. +- Muéstreme los indicadores de amenazas que aún no se han revisado. + +### `get_datadog_security_ioc_indicator` {#get-datadog-security-ioc-indicator} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Signals Read`*\ +Recupere los detalles completos de un indicador de [IoC Explorer][67] por valor (puntuación, categoría, información de AS, GeoIP, fuentes de registro, recuentos de señales). + +- Obtenga detalles del indicador de amenazas `192.0.2.1`. +- Muéstreme todo lo que sabemos sobre `malicious.example.com`. + +### `update_datadog_security_ioc_indicator_triage` {#update-datadog-security-ioc-indicator-triage} +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Signals Write`*\ -Actualiza el estado de triage o el asignatario de una o más señales de seguridad en bloque (hasta 500 señales). Acepta una lista de IDs de señales o una consulta de filtro que coincida con todas las señales a actualizar. +Establezca el estado de triaje de un indicador de [IoC Explorer][67]. + +- Marque el indicador `192.0.2.1` como revisado. +- Establezca `evil-domain.example.com` de nuevo como no revisado. + +### `get_datadog_security_ioc_schema` {#get-datadog-security-ioc-schema} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Signals Read`*\ +Descubra los campos filtrables y sus valores para [IoC Explorer][67]. Omita `filter` para listar los campos disponibles; proporcione `filter` para obtener `[{value, count}]` para ese campo. Utilice `query` para delimitar el contexto de los conteos a un subconjunto de indicadores. -- Archive todas las señales de la regla "Brute Force Login" en las últimas 24 horas. -- Establezca todas las señales abiertas para `service:checkout` como en revisión y asígnelas a mí. -- Marque la señal `AwAAAZ27F1BUjY4rPQAAABhBWjI3RjFCVWpZNHJBQUFBSGFNQVZBQUFBR1Bu` como archivada con la razón "testing". +- ¿Qué campos están disponibles para los filtros de indicadores de IoC? +- Muéstreme los tipos de indicadores disponibles y cuántos existen de cada uno. +- Obtenga los valores para el filtro `categories` en el contexto de indicadores con alta puntuación. ### `get_datadog_security_detection_rules_schema` {#get-datadog-security-detection-rules-schema} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Rules Read`*\ -Devuelve la referencia de autoría y el esquema para las reglas de detección. Cubre los tipos de reglas soportadas, métodos de detección, sintaxis de consulta, convenciones de etiquetas y facetas de búsqueda válidas. Utilícelo antes de autorizar o consultar reglas de detección. Tipos de reglas actualmente soportados: detección de registros, seguridad de API y AppSec. +Devuelve la referencia de creación y el esquema para las reglas de detección. Cubre los tipos de reglas admitidos, los métodos de detección, la sintaxis de consulta, las convenciones de etiqueta y las facetas de búsqueda válidas. Utilícelo antes de crear o consultar reglas de detección. Tipos de reglas admitidos actualmente: detección de registro, seguridad de API y AppSec. - ¿Qué campos y opciones están disponibles al crear una regla de detección de umbral? -- Muéstreme el esquema para las reglas de detección de secuencias. -- ¿Qué convenciones de etiquetas y sintaxis de consulta utiliza la API de reglas de detección? +- Muéstreme el esquema para las reglas de detección de secuencia. +- ¿Qué convenciones de etiqueta y sintaxis de consulta utiliza la API de reglas de detección? -### `list_datadog_security_detection_rules` {#list-datadog-security-detection-rules} -*Conjunto de herramientas: **seguridad***\ +### `get_datadog_security_detection_rules` {#get-datadog-security-detection-rules} +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Rules Read`*\ -Liste las reglas de detección para la organización. Las reglas de detección definen las condiciones bajo las cuales se generan señales de seguridad. Acepta una consulta de texto libre opcional para filtrar resultados del lado del servidor. Utilícelo (`get_datadog_security_detection_rule`) para obtener la definición completa de una regla específica. +Recupera reglas de detección de seguridad. Admite dos modos: proporcione `rule_id` para obtener la definición completa de una sola regla por ID, u omita `rule_id` para listar las reglas (opcionalmente filtradas con `query` y limitadas por token con `max_tokens`). Los dos modos son mutuamente excluyentes. - Liste todas las reglas de detección de Cloud SIEM habilitadas. - Muéstreme las reglas de detección etiquetadas con `source:cloudtrail`. -- ¿Qué reglas están configuradas para la detección de viajes imposibles? - -### `get_datadog_security_detection_rule` {#get-datadog-security-detection-rule} -*Conjunto de herramientas: **seguridad***\ -*Permisos requeridos: `Security Monitoring Rules Read`*\ -Recupera la definición completa de una única regla de detección por ID, incluyendo consultas, casos, opciones, filtros y metadatos. Utilícelo (`list_datadog_security_detection_rules`) para encontrar los IDs de las reglas. - - Obtenga la definición completa de la regla de detección `abc-123-def`. -- Muéstreme las consultas y las incidencias para la regla que genera esta señal. - ¿Qué umbrales y campos de agrupación utiliza esta regla de detección? +### `create_datadog_security_detection_rule` {#create-datadog-security-detection-rule} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Monitoring Rules Write`*\ +Crea una nueva regla de detección. Llame primero a `get_datadog_security_detection_rules_schema` para obtener la gramática de la carga útil y, a continuación, proporcione una carga útil de regla completa. Si la operación se realiza correctamente, devuelve la regla completa, incluido su ID asignado por el servidor. + +- Cree una regla de detección de umbral que se active cuando se produzcan más de 10 inicios de sesión fallidos desde la misma IP en 5 minutos. +- Cree una nueva regla de detección de registro para CloudTrail que alerte sobre la escalada de privilegios de IAM. +- Cree una regla de detección para `source:nginx` que genere una señal cuando la tasa de error supere las 100 por minuto. + +### `update_datadog_security_detection_rule` {#update-datadog-security-detection-rule} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Monitoring Rules Write`*\ +Actualiza una regla de detección personalizada existente reemplazándola por completo. Llame a `get_datadog_security_detection_rules` primero para obtener el cuerpo de la regla actual, modifique los campos que necesite y envíe el objeto actualizado completo. No se pueden actualizar las reglas predeterminadas proporcionadas por Datadog. + +- Habilite la regla de detección `abc-123-def`. +- Deshabilite la regla de detección de fuerza bruta. +- Actualice el umbral en mi regla de detección de fuerza bruta de 10 a 20 inicios de sesión fallidos. +- Agregue una nueva incidencia a la regla de detección `abc-123-def` que se active con gravedad crítica. +- Cambie el campo de agrupación en esta regla de `@usr.ip` a `@network.client.ip`. + +### `delete_datadog_security_detection_rules` {#delete-datadog-security-detection-rules} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Monitoring Rules Write`*\ +Elimina una o más reglas de detección personalizadas por ID. Solo se pueden eliminar las reglas personalizadas (no predeterminadas). Las reglas predeterminadas devuelven 403. Cada regla se autoriza individualmente; los errores aparecen en `failed_rules` sin abortar el lote. + +- Elimine la regla de detección `abc-123-def`. +- Elimine estas tres reglas de detección de prueba que creé anteriormente. + ### `get_datadog_security_suppressions` {#get-datadog-security-suppressions} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Suppressions Read`*\ -Recupera las supresiones de seguimiento de seguridad. Soporta tres modos: listar todas las supresiones, obtener una sola supresión por ID, o obtener supresiones que afectan a una regla de detección específica. Las supresiones evitan que las reglas de detección generen señales para condiciones coincidentes. +Recupera supresiones de monitoreo de seguridad. Admite tres modos: listar todas las supresiones, obtener una sola supresión por ID u obtener supresiones que afecten a una regla de detección específica. Las supresiones evitan que las reglas de detección generen señales para condiciones coincidentes. -- Liste todas las supresiones activas. -- Muéstreme las supresiones para la regla de detección `abc-123-def`. -- Obtenga los detalles completos de la supresión `sup-456-xyz`. +- Listar todas las supresiones activas. +- Mostrarme las supresiones para la regla de detección `abc-123-def`. +- Obtener los detalles completos de la supresión `sup-456-xyz`. ### `create_datadog_security_suppression` {#create-datadog-security-suppression} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Suppressions Write`*\ -Crea una nueva regla de supresión que evita que una regla de detección genere señales para condiciones específicas. Al menos uno de `suppression_query` o `data_exclusion_query` debe ser proporcionado. +Crea una nueva regla de supresión que evita que una regla de detección genere señales para condiciones específicas. Se debe proporcionar al menos uno de `suppression_query` o `data_exclusion_query`. -- Suprima señales de la regla de fuerza bruta para la IP `10.0.0.1`. -- Cree una supresión para la regla de detección de anomalías que ignore el entorno `staging`. -- Suprima señales de la regla `abc-123-def` donde `@usr.email` coincide con nuestras cuentas de prueba. +- Suprima las señales de la regla de fuerza bruta para la IP `10.0.0.1`. +- Cree una supresión para la regla de detección de anomalía que ignore el entorno `staging`. +- Suprima las señales de la regla `abc-123-def` donde `@usr.email` coincida con nuestras cuentas de prueba. ### `update_datadog_security_suppression` {#update-datadog-security-suppression} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Suppressions Write`*\ -Actualiza una regla de supresión existente. Solo cambia los campos proporcionados. Proporcionar `version` habilita el control de concurrencia optimista para evitar sobrescribir ediciones concurrentes. +Actualiza una regla de supresión existente. Solo cambia los campos proporcionados. Proporcionar `version` habilita el control de concurrencia optimista para evitar sobrescribir ediciones simultáneas. -- Actualice la supresión para la regla de fuerza bruta para también excluir `10.0.0.2`. -- Cambie la fecha de expiración de la supresión `sup-456-xyz` al próximo trimestre. -- Desactive la supresión para la regla de detección de anomalías sin eliminarla. +- Actualice la supresión para la regla de fuerza bruta para excluir también `10.0.0.2`. +- Cambie la fecha de vencimiento de la supresión `sup-456-xyz` al próximo trimestre. +- Deshabilite la supresión para la regla de detección de anomalía sin eliminarla. ### `delete_datadog_security_suppression` {#delete-datadog-security-suppression} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Suppressions Write`*\ Elimina una regla de supresión. -- Elimina la supresión `sup-456-xyz`. -- Elimina la supresión que estaba silenciando la regla de detección de fuerza bruta. +- Elimine la supresión `sup-456-xyz`. +- Elimine la supresión que silenciaba la regla de detección de fuerza bruta. ### `get_datadog_security_findings_schema` {#get-datadog-security-findings-schema} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Read`*\ -Devuelve el esquema (campos disponibles y sus tipos) para hallazgos de seguridad. Llama a esto primero antes de usar `analyze_datadog_security_findings` para descubrir campos consultables. Soporta filtrado por tipo de hallazgo y controla el tamaño de la respuesta. +Devuelve el esquema (campos disponibles y sus tipos) para los hallazgos de seguridad. Llame a esto primero antes de usar `analyze_datadog_security_findings` para descubrir los campos consultables. Admite el filtrado por tipo de hallazgo y el control del tamaño de la respuesta. - ¿Qué campos están disponibles para los hallazgos de seguridad? -- Muéstrame el esquema para los hallazgos de vulnerabilidad de la biblioteca. -- Obtén el esquema completo incluyendo descripciones para los hallazgos de mala configuración. +- Muéstreme el esquema para los hallazgos de vulnerabilidades de biblioteca. +- Obtenga el esquema completo, incluidas las descripciones para los hallazgos de configuración incorrecta. ### `analyze_datadog_security_findings` {#analyze-datadog-security-findings} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Read` y `Timeseries`*\ -Herramienta principal para analizar hallazgos de seguridad utilizando consultas SQL. Consulta datos en vivo de las últimas 24 horas con agregaciones SQL flexibles, filtrado y agrupamiento. Llama a `get_datadog_security_findings_schema` primero para descubrir los campos disponibles, luego usa esta herramienta para consultar. +Herramienta principal para analizar hallazgos de seguridad mediante consultas SQL. Consulta datos en tiempo real de las últimas 24 horas con agregaciones, filtrado y agrupación SQL flexibles. Llame a `get_datadog_security_findings_schema` primero para descubrir los campos disponibles, luego use esta herramienta para consultar. -- Muéstrame las 10 reglas con los hallazgos más críticos. -- Cuenta los hallazgos abiertos agrupados por severidad y tipo de hallazgo. -- Encuentra vulnerabilidades de biblioteca con exploits disponibles, agrupados por recurso. +- Muéstrame las 10 reglas principales con los hallazgos más críticos. +- Cuenta los hallazgos abiertos agrupados por gravedad y tipo de hallazgo. +- Busca vulnerabilidades de biblioteca con exploits disponibles, agrupadas por recurso. ### `search_datadog_security_findings` {#search-datadog-security-findings} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Read`*\ -Herramienta de respaldo para recuperar detalles completos de hallazgos de seguridad. Prefiere `analyze_datadog_security_findings` para la mayoría de las tareas de análisis. Utiliza esta herramienta solo cuando necesites encontrar objetos completos o cuando las consultas SQL sean insuficientes. +Herramienta de respaldo para recuperar detalles completos de hallazgos de seguridad. Prefiera `analyze_datadog_security_findings` para la mayoría de las tareas de análisis. Use esta herramienta solo cuando necesite objetos de hallazgo completos o cuando las consultas SQL sean insuficientes. -- Obtén detalles completos sobre hallazgos críticos en mi entorno de AWS. -- Recupera objetos de hallazgos completos para una regla específica. -- Lista todos los hallazgos de riesgo de identidad abiertos con metadatos completos. +- Obtenga detalles completos de los hallazgos críticos en mi entorno de AWS. +- Recupere objetos de hallazgo completos para una regla específica. +- Liste todos los hallazgos de riesgo de identidad abiertos con metadatos completos. ### `get_datadog_security_findings_ticket_suggestions` {#get-datadog-security-findings-ticket-suggestions} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Read`, `Cases Read`*\ -Devuelve sugerencias de proyectos clasificadas para la gestión de incidencias de hallazgos de seguridad. Muestra los proyectos disponibles de Case Management, Jira y ServiceNow con datos de uso de 30 días. Llama a esto antes de `create_datadog_security_findings_ticket` para descubrir qué proyecto utilizar. +Devuelve sugerencias de proyecto clasificadas para hallazgos de seguridad de tickets. Muestra los proyectos disponibles de Case Management, Jira, Linear y ServiceNow con datos de uso de 30 días. Llame a esto antes de `create_datadog_security_findings_ticket` para descubrir qué proyecto usar. - ¿Qué proyectos de Jira puedo usar para crear tickets para hallazgos de seguridad? -- Muéstrame los proyectos disponibles de ServiceNow para tickets. -- ¿Cuáles son los proyectos de Case Management más utilizados para hallazgos? +- Muéstrame los proyectos de ServiceNow disponibles para tickets. +- ¿A qué proyectos de Linear puedo enviar hallazgos? +- ¿Qué proyectos de Case Management son los más utilizados para hallazgos? ### `create_datadog_security_findings_ticket` {#create-datadog-security-findings-ticket} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Write`, `Cases Read`, `Cases Write`*\ -Crea un caso de Case Management, una incidencia de Jira o un ticket de ServiceNow para hallazgos de seguridad. Requiere ID de hallazgos específicos y un ID de proyecto. Usa `get_datadog_security_findings_ticket_suggestions` primero para descubrir los proyectos disponibles. +Cree una incidencia de Case Management, un issue de Jira, un issue de Linear o un ticket de ServiceNow para los hallazgos de seguridad. Requiere IDs de hallazgo específicos y un ID de proyecto. Use `get_datadog_security_findings_ticket_suggestions` primero para descubrir los proyectos disponibles. -- Crea un ticket de Jira para estos hallazgos críticos en el proyecto SECURITY. -- Abre un caso de Case Management para los hallazgos de esta regla. -- Crea un ticket de ServiceNow para estas vulnerabilidades de la biblioteca. +- Cree un ticket de Jira para estos hallazgos críticos en el proyecto SECURITY. +- Abra una incidencia de Case Management para los hallazgos de esta regla. +- Cree un issue de Linear para estos hallazgos de alta gravedad. +- Cree un ticket de ServiceNow para estas vulnerabilidades de biblioteca. ### `detach_datadog_security_findings_ticket` {#detach-datadog-security-findings-ticket} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Write`, `Cases Write`*\ -Desvincula los hallazgos de seguridad de su caso o ticket asociado. Dado que los tickets de Jira y ServiceNow están vinculados a través de la gestión de casos, desvincular el caso también desvincula cualquier ticket posterior. +Desvincule los hallazgos de seguridad de su incidencia o ticket vinculado. Dado que los tickets de Jira y ServiceNow están vinculados a través de Case Management, desvincular la incidencia también desvincula cualquier ticket relacionado. -- Desvincula estos hallazgos de su ticket de Jira asociado. -- Elimina la asociación del caso para estos hallazgos. +- Desvincule estos hallazgos de su ticket de Jira vinculado. +- Elimine la asociación de incidencia para estos hallazgos. ### `mute_datadog_security_findings` {#mute-datadog-security-findings} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Write`*\ -Silencia o reanuda los hallazgos de seguridad para suprimirlos de alertas y tableros. Requiere un motivo de silencio (`PENDING_FIX`, `FALSE_POSITIVE`, `ACCEPTED_RISK` o `OTHER`) y admite una descripción opcional y una fecha de expiración. +Silencia o reactiva los hallazgos de seguridad para suprimirlos de las alertas y los paneles. Requiere un motivo de silencio (`PENDING_FIX`, `FALSE_POSITIVE`, `ACCEPTED_RISK` o `OTHER`) y admite una descripción y una fecha de vencimiento opcionales. -- Silencia estos hallazgos como falsos positivos. -- Silencia esta mala configuración como riesgo aceptado con una expiración de 90 días. -- Reanuda los hallazgos que fueron marcados previamente como pendientes de solución. +- Silencie estos hallazgos como falsos positivos. +- Silencie esta configuración incorrecta como riesgo aceptado con una expiración de 90 días. +- Desilencie los hallazgos que fueron marcados previamente como pendientes de corrección. ### `assign_datadog_security_findings` {#assign-datadog-security-findings} -*Conjunto de herramientas: **seguridad***\ +*Conjunto de herramientas: **Security***\ *Permisos requeridos: `Security Monitoring Findings Write`*\ -Asigna o desasigna hallazgos de seguridad a un usuario. La asignación se propaga a cualquier caso vinculado. Omitir el ID del asignado para desasignar. +Asigna o cancela la asignación de hallazgos de seguridad a un usuario. La asignación se propaga a cualquier incidencia vinculada. Omita el ID del asignado para cancelar la asignación. + +- Asignar estos hallazgos críticos al líder del equipo de seguridad. +- Cancelar la asignación de hallazgos que ya no son relevantes. +- Asignarme todos los hallazgos de esta regla. + +### `list_datadog_security_findings_automation_rules` {#list-datadog-security-findings-automation-rules} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Pipelines Read`*\ +Liste las reglas de automatización de hallazgos de seguridad de un tipo determinado (`mute`, `due_date`, `ticket_creation` o `severity_modifier`). + +- Liste todas las reglas de automatización para silenciar hallazgos de seguridad. +- Muéstrame las reglas de creación de tickets. +- ¿Qué reglas de automatización de fecha de vencimiento están configuradas? + +### `create_datadog_security_findings_automation_rule` {#create-datadog-security-findings-automation-rule} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Pipelines Write` y `Security Monitoring Findings Read`*\ +Crea una regla de automatización de hallazgos de seguridad. Elija un `rule_type`: `mute` (suprimir hallazgos), `due_date` (establecer fechas límite de remediación), `severity_modifier` (ajustar la gravedad del hallazgo) o `ticket_creation` (crear automáticamente tickets de Jira o de Case Management). + +- Cree una regla para silenciar automáticamente los hallazgos de configuración incorrecta de falsos positivos en staging. +- Establezca fechas de vencimiento de remediación de 30 días para vulnerabilidades de biblioteca de alta gravedad. +- Cree automáticamente tickets de Jira para hallazgos críticos en el proyecto SECURITY. + +### `update_datadog_security_findings_automation_rule` {#update-datadog-security-findings-automation-rule} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Pipelines Write`*\ +Actualiza una regla de automatización existente. Admite actualizaciones parciales, por lo que solo se cambian los campos proporcionados. Úselo para habilitar o deshabilitar reglas, cambiarles el nombre, ajustar filtros o cambiar parámetros de acción. + +- Habilite la regla de automatización que silencia los hallazgos de staging. +- Cambie la regla de fecha de vencimiento para dar a los hallazgos críticos 14 días en lugar de 30. +- Actualice la regla de creación de tickets para apuntar a un proyecto de Jira diferente. + +### `delete_datadog_security_findings_automation_rule` {#delete-datadog-security-findings-automation-rule} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Pipelines Write`*\ +Elimine permanentemente una regla de automatización de hallazgos de seguridad por ID. + +- Elimine la regla de modificador de gravedad `abc-123-def`. +- Elimine la regla de silencio que ya no es necesaria. + +### `reorder_datadog_security_findings_automation_rules` {#reorder-datadog-security-findings-automation-rules} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Security Pipelines Write`*\ +Mueva una regla de automatización hacia arriba o hacia abajo en la lista. Las reglas se aplican en orden, por lo que la posición de una regla establece su prioridad. + +- Mueva la regla de silencio `abc-123-def` a la parte superior de la lista. +- Reduzca la prioridad de esta regla de fecha de vencimiento en dos posiciones. + +### `get_datadog_security_trace_passlist` {#get-datadog-security-trace-passlist} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Read`*\ +Devuelve todas las entradas del filtro de exclusión (lista de permitidos) de WAF para que la organización revise las supresiones existentes. + +- Liste todas las entradas de la lista de permitidos de App & API Protection. +- Muéstreme los filtros de exclusión de WAF activos. +- Verifique las supresiones de la lista de permitidos existentes antes de agregar una nueva. + +### `upsert_datadog_security_trace_passlist` {#upsert-datadog-security-trace-passlist} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Write`*\ +Crea o actualiza una entrada de filtro de exclusión de WAF (lista de permitidos) para suprimir reglas ruidosas en un servicio o punto de conexión específico. + +- Agregue una entrada de lista de permitidos de WAF para el servicio "checkout-service" en el punto de conexión "/api/pay" para ignorar la regla "sqli-detection". +- Actualice el filtro de exclusión para suprimir la regla \"xss-rule\" para el servicio \"auth-api\". +- Cree una entrada de lista de permitidos de AppSec que coincida con el ID de regla \"lfi-attack\" en \"/v1/users\". + +### `delete_datadog_security_trace_passlist` {#delete-datadog-security-trace-passlist} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Write`*\ +Elimine una entrada de filtro de exclusión de WAF (lista de permitidos) existente. + +- Elimine el filtro de exclusión de WAF "passlist-abc-123". +- Elimine la entrada de la lista de permitidos que coincide con la regla "sqli-detection" en "/api/pay". + +### `get_datadog_security_aap_denylist` {#get-datadog-security-aap-denylist} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Read`*\ +Enumera las IP, los usuarios y los agentes de usuario bloqueados (entradas de lista de denegación), con filtrado opcional. + +- Enumere todas las entidades bloqueadas en la lista de denegación de AppSec. +- Muéstreme las direcciones IP bloqueadas de ayer. +- Compruebe si la IP "198.51.100.42" está en la lista de denegación de seguridad. + +### `upsert_datadog_security_aap_denylist` {#upsert-datadog-security-aap-denylist} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Write`*\ +Agrega o actualiza un bloqueo de lista de denegación para una IP, un usuario o un agente de usuario con una fecha de vencimiento. + +- Bloquee la IP "198.51.100.42" en la lista de denegación durante 24 horas. +- Agregue al usuario "attacker_user_99" a la lista de denegación de entidades bloqueadas. +- Cree una entrada en la lista de denegación para el agente de usuario "MaliciousScanner/1.0" con una fecha de vencimiento establecida para la próxima semana. + +### `unblock_datadog_security_aap_denylist` {#unblock-datadog-security-aap-denylist} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Write`*\ +Desbloquea una entidad previamente incluida en la lista de denegación estableciendo su fecha de vencimiento en el pasado. + +- Desbloquee la IP "198.51.100.42" en la lista de denegación. +- Eliminar al usuario "attacker_user_99" de la lista de denegación de entidades bloqueadas. + +### `get_datadog_security_aap_custom_rules` {#get-datadog-security-aap-custom-rules} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Read`*\ +Recupera una regla WAF personalizada de App & API Protection (AAP) por ID o lista reglas personalizadas. Admite filtrado por categoría, estado, servicio y entorno. + +- Enumere las reglas personalizadas de WAF que se aplican al servicio "checkout-service" en producción. +- Obtenga la regla personalizada de AAP "rule-xyz-123". + +### `upsert_datadog_security_aap_custom_rule` {#upsert-datadog-security-aap-custom-rule} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Write`*\ +Crea o actualiza una regla WAF personalizada de AAP en la categoría de intento de ataque o lógica de negocio. Las reglas nuevas no pueden bloquear el tráfico: cree la regla en modo de monitoreo, luego actualícela al modo de bloqueo después de confirmar sus coincidencias. + +- Cree una regla WAF personalizada de monitoreo para las solicitudes a la ruta "/admin". +- Actualice la regla personalizada de AAP "rule-xyz-123" para bloquear el tráfico coincidente. +- Deshabilite la regla personalizada "rule-xyz-123" sin eliminarla. + +### `delete_datadog_security_aap_custom_rule` {#delete-datadog-security-aap-custom-rule} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Write`*\ +Elimine permanentemente una regla WAF personalizada de AAP por ID. -- Asigna estos hallazgos críticos al líder del equipo de seguridad. -- Desasigna hallazgos que ya no son relevantes. -- Asigna todos los hallazgos de esta regla a mí. +- Elimine la regla WAF personalizada "rule-xyz-123". +- Elimine la regla personalizada de AAP que monitorea las solicitudes a "/admin". + +### `get_datadog_security_aap_blocking_config` {#get-datadog-security-aap-blocking-config} +*Conjunto de herramientas: **Security***\ +*Permisos requeridos: `Application Security Management Protect Read`*\ +Recupera la configuración de aplicación de bloqueo y lista de denegación de AAP para toda la organización. -## Entrega de software {#software-delivery} +- ¿Está habilitado el bloqueo de AAP para la organización? +- ¿Se aplica la lista de denegación de AAP? +- Muéstreme la configuración de bloqueo de AAP. -Herramientas para interactuar con Software Delivery ([CI Visibility][48] y [Test Optimization][24]). +## Session Replay {#session-replay} + +Herramientas para buscar grabaciones de [Session Replay][69] y resumir la actividad de la sesión. + +### `search_replays` {#search-replays} +*Conjunto de herramientas: **session-replay***\ +*Permisos requeridos: `RUM Apps Read`*\ +Busca grabaciones de Session Replay y devuelve las sesiones coincidentes. Admite el filtrado por identidad de usuario, dispositivo, recuento de errores o cualquier faceta de RUM, y la búsqueda de recorridos para sesiones que siguieron una secuencia específica de vistas o acciones. + +- Encuentra reproducciones de sesiones con más de 2 errores en las últimas 24 horas. +- Muéstreme las reproducciones de los usuarios que siguieron el proceso de pago pero no lo completaron. + +### `get_replay_summary` {#get-replay-summary} +*Conjunto de herramientas: **session-replay***\ +*Permisos requeridos : `RUM Apps Read` y `RUM Session Replay Read`*\ +Genera una narración cronológica basada en IA de lo que hizo un usuario durante una reproducción de sesión específica: páginas visitadas, acciones realizadas y momentos clave, organizados en capítulos. Normalmente se llama después de `search_replays` para profundizar en una sesión de interés. + +- Resuma lo que sucedió en la sesión `abc-123-def`. +- Deme una narración paso a paso de la reproducción para el usuario que informó un error en el proceso de pago. + +## Software Delivery {#software-delivery} + +Herramientas para interactuar con la Software Delivery ([CI Visibility][48], [Test Optimization][24], [Code Coverage][65] y [DORA metrics][66]). ### `search_datadog_ci_pipeline_events` {#search-datadog-ci-pipeline-events} -*Conjunto de herramientas: **entrega-de-software***\ +*Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `CI Visibility Read`*\ Busca eventos de CI con filtros y devuelve detalles sobre ellos. -- Muéstrame todos los pipelines para mi commit `58b1488`. -- Muéstrame la última falla del pipeline en la rama `my-branch`. -- Propón una solución para el trabajo `integration-test` que falla cada vez en mi rama `my-branch`. +- Muéstreme todas las canalizaciones para mi commit `58b1488`. +- Muéstrame el fallo de canalización más reciente en la rama `my-branch`. +- Proponga una solución para el trabajo `integration-test` que falla cada vez en mi rama `my-branch`. ### `aggregate_datadog_ci_pipeline_events` {#aggregate-datadog-ci-pipeline-events} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `CI Visibility Read`*\ -Agrega eventos de pipeline de CI para producir estadísticas, métricas y análisis agrupados. +Agrega eventos de canalización de CI para generar estadísticas, métricas y análisis agrupados. - ¿Cuál es la duración promedio de los trabajos en los últimos 7 días? -- ¿Cuántos pipelines fallidos ha habido en las últimas 2 semanas? -- Muéstrame el percentil 95 de la duración de los pipelines, agrupados por nombre de pipeline. +- ¿Cuántas canalizaciones fallidas ha habido en las últimas 2 semanas? +- Muéstreme el percentil 95 de la duración de la canalización agrupado por nombre de canalización. ### `get_datadog_flaky_tests` {#get-datadog-flaky-tests} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Test Optimization Read`*\ -Busca en Datadog [Test Optimization][24] pruebas inestables y devuelve detalles de triaje (tasa de fallos, categoría, propietarios, historial, impacto en CI), con paginación y ordenamiento. +Busca en Datadog [Test Optimization][24] pruebas inestables y devuelve detalles de clasificación (tasa de fallos, categoría, propietarios, historial, impacto en CI), con paginación y ordenamiento. -- Encuentra pruebas inestables activas para el servicio de pago propiedad de `@team-abc`, ordenadas por tasa de fallos. -- Muestra pruebas inestables en la rama `main` para el repositorio `github.com/org/repo`, más recientes primero. -- Lista pruebas inestables en la categoría `timeout` con alta tasa de fallos (50%+) para que pueda priorizar las correcciones. +- Encuentre pruebas inestables activas para el checkout service propiedad de `@team-abc`, ordenadas por tasa de fallos. +- Muéstreme las pruebas inestables en la rama `main` para el repositorio `github.com/org/repo`, de la más reciente a la más antigua. +- Enumere las pruebas inestables en la categoría `timeout` con una tasa de fallos alta (50%+) para que pueda priorizar las correcciones. ### `update_datadog_flaky_test_states` {#update-datadog-flaky-test-states} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Test Optimization Write`*\ -Establece el estado de una o más pruebas inestables a `quarantined` (suprimir fallos), `disabled` (saltar prueba), `fixed` (marcar como resuelto) o `active` (restaurar). Esta es una operación de escritura que requiere aprobación explícita del usuario. Todos los cambios de estado son reversibles. +Establezca el estado de una o más pruebas inestables en `quarantined` (suprimir fallos), `disabled` (omitir prueba), `fixed` (marcar como resuelto) o `active` (restaurar). Esta es una operación de escritura que requiere la aprobación explícita del usuario. Todos los cambios de estado son reversibles. -- Cuarentena todas las pruebas inestables activas en el repositorio `checkout-service`. -- Marca la prueba inestable `AuthServiceTest::testLogin` como corregida. -- Desactiva las pruebas inestables propiedad de `@team-payments` con una tasa de fallos superior al 50%. +- Ponga en cuarentena todas las pruebas inestables activas en el repositorio `checkout-service`. +- Marque la prueba inestable `AuthServiceTest::testLogin` como corregida. +- Deshabilite las pruebas inestables que pertenecen a `@team-payments` con una tasa de fallos superior al 50%. ### `aggregate_datadog_test_events` {#aggregate-datadog-test-events} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Test Optimization Read`*\ -Agrega eventos de Test Optimization de Datadog para cuantificar la confiabilidad y las tendencias de rendimiento con funciones de agregación, métricas opcionales, facetas de agrupamiento y niveles de prueba configurables. +Agrega eventos de Datadog Test Optimization para cuantificar las tendencias de confiabilidad y rendimiento con funciones de agregación, métricas opcionales, facetas de agrupación y niveles de prueba configurables. -- Cuenta el número de pruebas fallidas en la última semana, agrupadas por rama. -- Muéstrame la duración del percentil 95 para cada conjunto de pruebas para identificar las más lentas. -- Cuenta todas las pruebas aprobadas y fallidas, agrupadas por propietarios de código. +- Cuente el número de pruebas fallidas durante la última semana, agrupadas por rama. +- Muéstreme la duración del percentil 95 para cada conjunto de pruebas para identificar las más lentas. +- Cuenta todas las pruebas aprobadas y fallidas, agrupadas por propietarios del código. ### `search_datadog_test_events` {#search-datadog-test-events} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Test Optimization Read`*\ -Busca eventos de prueba [Test Optimization][24] con filtros y devuelve detalles sobre ellos. +Busca eventos de prueba en [Test Optimization][24] con filtros y devuelve detalles sobre ellos. -- Muéstrame las pruebas fallidas en la rama `main` de las últimas 24 horas. -- Obtén las ejecuciones de prueba para el commit `abc123` para ver cuáles pasaron y cuáles fallaron. -- Muéstrame todas las ejecuciones de prueba inestables para el servicio de checkout. -- Encuentra las pruebas a cargo de `@team-name` que están fallando. +- Muéstreme las pruebas fallidas en la rama `main` de las últimas 24 horas. +- Obtenga las ejecuciones de prueba para el commit `abc123` para ver qué pasó y qué falló. +- Muéstreme todas las ejecución de prueba inestables para el servicio de checkout. +- Encuentra las pruebas que pertenecen a `@team-name` que están fallando. ### `get_datadog_code_coverage_branch_summary` {#get-datadog-code-coverage-branch-summary} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Code Coverage read`*\ -Obtiene métricas agregadas del resumen de cobertura de código para una rama de repositorio, incluyendo cobertura total, cobertura de parches y desgloses de servicio/propietario de código. +Obtiene métricas resumidas de cobertura de código agregadas para una rama de repositorio, incluyendo la cobertura total, la cobertura de parches y los desgloses por servicio/propietario del código. - ¿Cuál es la cobertura de código en la rama `main` para `github.com/my-org/my-repo`? -- Muéstrame el resumen de cobertura para la rama `release/1.x` de `github.com/my-org/my-repo`. +- Muéstreme el resumen de cobertura para la rama `release/1.x` de `github.com/my-org/my-repo`. ### `get_datadog_code_coverage_commit_summary` {#get-datadog-code-coverage-commit-summary} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Code Coverage read`*\ -Obtiene métricas agregadas del resumen de cobertura de código para un commit de repositorio, incluyendo cobertura total, cobertura de parches y desgloses de servicio/propietario de código. +Obtiene métricas resumidas de cobertura de código agregadas para un commit de repositorio, incluyendo la cobertura total, la cobertura de parches y los desgloses por servicio/propietario del código. - Muéstrame la cobertura de código para el commit `abc123abc123abc123abc123abc123abc123abcd` en `github.com/my-org/my-repo`. - ¿Cuál es la cobertura de parches para el último commit en mi rama? +### `get_datadog_code_coverage_pr_summary` {#get-datadog-code-coverage-pr-summary} +*Conjunto de herramientas: **software-delivery***\ +*Permisos requeridos: `Code Coverage read`*\ +Obtiene métricas resumidas de Code Coverage agregadas para una solicitud de extracción, incluyendo la cobertura total, la cobertura de parches y los desgloses por servicio o propietario del código. + +- Muéstreme el Code Coverage para la PR #123 en `github.com/my-org/my-repo`. +- ¿Cuál es el Code Coverage de parches para la solicitud de extracción #456 en `github.com/my-org/my-repo`? + +### `get_datadog_code_coverage_files` {#get-datadog-code-coverage-files} +*Conjunto de herramientas: **software-delivery***\ +*Permisos requeridos: `Code Coverage read`*\ +Obtiene datos de líneas de cobertura de código por archivo para un commit, rama o solicitud de extracción de repositorio. Devuelve las líneas ejecutables, las líneas cubiertas y las líneas añadidas para cada archivo. Se debe proporcionar exactamente uno de `commit_sha`, `branch` o `pr_number`. Se puede proporcionar como máximo uno de `service`, `codeowner` o `flag` para filtrar los resultados. + +- Muéstreme el Code Coverage por archivo para la PR #123 en `github.com/my-org/my-repo`. +- Obtenga el Code Coverage de archivos modificados para el commit `abc123abc123abc123abc123abc123abc123abcd` en `github.com/my-org/my-repo`. +- Muestre el Code Coverage para la rama `main` de `github.com/my-org/my-repo`, filtrada por el propietario del código `@my-org/my-team`. + ### `get_datadog_test_optimization_settings` {#get-datadog-test-optimization-settings} *Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Test Optimization Read`*\ -Recupera las características de Test Optimization que están habilitadas para un servicio, incluyendo Test Impact Analysis (ITR), Early Flake Detection (EFD), Auto Test Retries (ATR), Failed Test Replay, Code Coverage collection y PR Comments. +Recupera las funciones de Test Optimization que están habilitadas para un servicio, incluyendo el Test Impact Analysis (ITR), la Detección Temprana de Inestabilidad (EFD), los Reintentos Automáticos de Pruebas (ATR), la Reproducción de Pruebas Fallidas, la recopilación de Code Coverage y los Comentarios de PR. -- ¿Qué características de Test Optimization están habilitadas para el `auth-service`? -- Muéstrame la configuración de Test Optimization para mi servicio de checkout. +- ¿Qué funciones de Test Optimization están habilitadas para `auth-service`? +- Muéstreme la configuración de Test Optimization para mi servicio de checkout. ### `get_datadog_flaky_tests_management_policies` {#get-datadog-flaky-tests-management-policies} -*Conjunto de herramientas: **entrega de software***\ -*Permisos Requeridos: `Test Optimization Read`*\ -Recupera las políticas de Flaky Tests Management configuradas para un repositorio, incluyendo auto-quarantine windows, branch rules, failure rate thresholds, disable policies y retry settings. +*Conjunto de herramientas: **software-delivery***\ +*Permisos requeridos: `Test Optimization Read`*\ +Recupera las políticas de gestión de pruebas inestables configuradas para un repositorio, incluyendo ventanas de cuarentena automática, reglas de rama, umbrales de tasa de fallos, políticas de desactivación y configuraciones de reintento. -- Muéstrame las políticas de Flaky Tests Management para `github.com/my-org/my-repo`. -- ¿Qué reglas de auto-cuarentena están configuradas para el repositorio del servicio de checkout? +- Muéstreme las políticas de gestión de pruebas inestables para `github.com/my-org/my-repo`. +- ¿Qué reglas de cuarentena automática están configuradas para el repositorio del servicio de checkout? ### `search_dora_deployments` {#search-dora-deployments} -*Conjunto de herramientas: **entrega de software***\ -*Permisos Requeridos: `DORA Metrics Read`*\ -Busca eventos de despliegue DORA con filtros, o recupera detalles completos para un solo despliegue por ID. +*Conjunto de herramientas: **software-delivery***\ +*Permisos requeridos: `DORA Metrics Read`*\ +Busque eventos de despliegue DORA con filtros, u obtenga detalles completos de un solo despliegue por ID. -- Muéstrame los despliegues para el servicio `checkout` en los últimos 7 días. -- Obtén detalles para el despliegue DORA `abc123`. -- Encuentra despliegues fallidos en el entorno de producción este mes. +- Muéstreme los despliegues para el servicio `checkout` en los últimos 7 días. +- Obtenga detalles sobre el despliegue DORA `abc123`. +- Encuentre los despliegues fallidos en el entorno de producción este mes. ### `aggregate_dora_deployments` {#aggregate-dora-deployments} -*Conjunto de herramientas: **entrega de software***\ +*Conjunto de herramientas: **software-delivery***\ *Permisos requeridos: `Timeseries`*\ -Devuelve métricas DORA (frecuencia de despliegue, tiempo de entrega de cambios, tasa de fallos de cambios, tiempo de recuperación) para un servicio, equipo o repositorio, como valores escalares o series temporales. Utilice para preguntas sobre el rendimiento de entrega de software durante un período de tiempo. +Devuelve métricas DORA (frecuencia de implementación, tiempo de entrega de cambios, tasa de fallos en cambios, tiempo de recuperación) para un servicio, equipo o repositorio, como valores escalares o series temporales. Úselo para preguntas sobre el rendimiento de la entrega de software durante un periodo de tiempo. -- ¿Cuál es la frecuencia de despliegue y la tasa de fallos de cambios para el servicio `checkout` en los últimos 30 días? -- Muéstrame la tendencia del tiempo de entrega de cambios para el servicio `payments` en el último trimestre. -- Obtén las cuatro métricas DORA para el equipo `auth-service`. +- ¿Cuál es la frecuencia de despliegue y la tasa de fallos en cambios para el servicio `checkout` en los últimos 30 días? +- Muéstreme la tendencia del tiempo de entrega de cambios para el servicio `payments` durante el último trimestre. +- Obtenga las cuatro métricas DORA para el equipo `auth-service`. -## Synthetics {#synthetics} +## Sintéticos {#synthetics} -Herramientas para interactuar con Datadog [Synthetic tests][47]. +Herramientas para interactuar con [pruebas Synthetic][47] de Datadog. ### `get_synthetics_tests` {#get-synthetics-tests} -*Conjunto de herramientas: **Synthetics***\ +*Conjunto de herramientas: **synthetics***\ *Permisos requeridos: `Synthetics Read`*\ -Busca Datadog Synthetic HTTP API tests. +Busque pruebas sintéticas de API HTTP de Datadog. -- Ayúdame a entender por qué la prueba Synthetic en el punto de conexión `/v1/my/tested/endpoint` está fallando. -- Hay una interrupción; encuentre todos los Synthetic tests que están fallando en el dominio `api.mycompany.com`. -- ¿Los Synthetic tests en mi sitio web `api.mycompany.com` siguen funcionando en la última hora? +- Ayúdeme a entender por qué está fallando la prueba Synthetic en el punto de conexión `/v1/my/tested/endpoint`. +- Hay una interrupción; encuentre todas las pruebas Synthetic fallidas en el dominio `api.mycompany.com`. +- ¿Las pruebas Synthetic en mi sitio web `api.mycompany.com` siguen funcionando en la última hora? ### `edit_synthetics_tests` {#edit-synthetics-tests} -*Conjunto de herramientas: **sintéticos***\ +*Conjunto de herramientas: **synthetics***\ *Permisos requeridos: `Synthetics Global Variable Read` y `Synthetics Read` y `Synthetics Write`*\ -Edita los Datadog Synthetic HTTP API tests. +Edite pruebas Synthetic de API HTTP de Datadog. -- Mejora las afirmaciones de la prueba Synthetic definida en el punto de conexión `/v1/my/tested/endpoint`. -- Pausa la prueba `aaa-bbb-ccc` y establece las ubicaciones solo en ubicaciones europeas. -- Agrega la etiqueta de mi equipo a la prueba `aaa-bbb-ccc`. +- Mejore las aserciones de la prueba Synthetic definida en mi punto de conexión `/v1/my/tested/endpoint`. +- Pause la prueba Synthetic `aaa-bbb-ccc` y establezca las ubicaciones solo en ubicaciones europeas. +- Agregue mi etiqueta de equipo a la prueba Synthetic `aaa-bbb-ccc`. ### `synthetics_test_wizard` {#synthetics-test-wizard} -*Conjunto de herramientas: **sintéticos***\ +*Conjunto de herramientas: **synthetics***\ *Permisos requeridos: `Synthetics Global Variable Read` y `Synthetics Read` y `Synthetics Write`*\ -Previsualiza y crea Datadog Synthetic HTTP API Tests. +Obtenga una vista previa y cree pruebas Synthetic de API HTTP de Datadog Synthetics. -- Crea Datadog Synthetic tests en cada punto de conexión definido en este archivo de código. -- Crea una prueba Synthetic en `/path/to/endpoint`. -- Crea una prueba Synthetic que verifique si mi dominio `mycompany.com` permanece activo. +- Cree pruebas Synthetic en cada punto de conexión definido en este archivo de código. +- Cree una prueba Synthetic en `/path/to/endpoint`. +- Cree una prueba Synthetic que verifique si mi dominio `mycompany.com` permanece activo. ## Widgets {#widgets} -Herramientas para la visualización, validación y conversión de tipo de widgets de [Dashboard][46] y [notebook][57]. +Herramientas para la visualización, validación y conversión de tipos de widgets de [dashboard][46] y [notebook][57]. ### `get_widget` {#get-widget} *Conjunto de herramientas: **widgets***\ *Permisos requeridos: `Dashboards Read` o `Timeseries` o `Monitors Read` o `APM Read` o `RUM Apps Read`*\ -Recupera y visualiza métricas, trazas, registros y otros datos de Datadog como gráficos interactivos. Soporta tres modos: búsqueda de panel, definición directa o resolución de URL. - -- Muestra la serie temporal de uso de CPU para `service:api` en la última hora. -- Obtén los datos del widget `2228368921512806` en el Dashboard `abc-123-def`. -- Visualiza los datos de este enlace de compartición de Datadog. - -### `get_widget_reference_compressed` {#get-widget-reference-compressed} -*Conjunto de herramientas: **widgets***\ -*Permisos requeridos: `Dashboards Read` o `Dashboards Write` o `Notebooks Read` o `Notebooks Write`*\ -Devuelve esquemas de TypeScript comprimidos e instrucciones de construcción para tipos de widgets. Llama antes de generar el JSON del widget. Al construir widgets de grupo, incluye tanto `group` como cualquier tipo de widget hijo previsto en una sola llamada para evitar duplicados. +Recupera y visualiza métricas, trazas, registros y otros datos de Datadog como gráficos interactivos. Admite tres modos: búsqueda en dashboard, definición directa o resolución de URL. -- Obtén el esquema comprimido para un widget de series temporales. -- Muestra las instrucciones de construcción para widgets de lista principal y tabla de consulta. +- Muéstreme las series temporales de uso de CPU para `service:api` durante la última hora. +- Obtenga los datos del widget para el widget `2228368921512806` en el dashboard `abc-123-def`. +- Visualice los datos de este enlace compartido de Datadog. ### `search_datadog_widgets` {#search-datadog-widgets} *Conjunto de herramientas: **widgets***\ *Permisos requeridos: `Dashboards Read` o `Dashboards Write` o `Notebooks Read` o `Notebooks Write`*\ -Busca y recupera información sobre widgets en los Dashboards de Datadog, incluyendo sus IDs, títulos y consultas subyacentes. +Busque y recupere información sobre widgets en los dashboards de Datadog, incluidos sus ID, títulos y consultas subyacentes. -- Encuentra todos los widgets de series temporales que consultan la métrica `system.cpu.user`. -- Busca widgets relacionados con las tasas de error en todos los Dashboards. +- Busque todos los widgets de series temporales que consultan la métrica `system.cpu.user`. +- Busque widgets relacionados con tasas de error en todos los dashboards. ### `swap_widget_type` {#swap-widget-type} *Conjunto de herramientas: **widgets***\ *Permisos requeridos: `Dashboards Read` o `Dashboards Write` o `Notebooks Read` o `Notebooks Write`*\ -Convierte una definición de widget de un tipo de visualización a otro mientras preserva las consultas. Soporta tipos de widgets basados en solicitudes de fórmulas: series temporales, valor de consulta, lista principal, tabla de consulta, treemap, sunburst, distribución, mapa de calor, geomapa y lista de flujo. +Convierta una definición de widget de un tipo de visualización a otro mientras conserva las consultas. Admite tipos de widget basados en solicitudes de fórmula: series temporales, query_value, lista principal, query_table, treemap, sunburst, distribution, heatmap, geomap y list_stream. -- Convierte este widget de series temporales a una lista principal. -- Cambia el widget de tabla de consulta a una visualización de treemap. +- Convierta este widget de series temporales en una lista principal. +- Cambie el widget de tabla de consulta a una visualización de treemap. ### `validate_notebook_cell` {#validate-notebook-cell} *Conjunto de herramientas: **widgets***\ *Permisos requeridos: `Timeseries`*\ -Valida las definiciones de widgets de celdas de notebook, incluyendo la corrección SQL para celdas de análisis_sql. Al validar una celda de análisis_sql, incluya sus widgets de fuente de datos aguas arriba para que el punto de conexión pueda verificar las expresiones SQL contra sus esquemas. +Valida las definiciones de widget de celda de notebook, incluida la exactitud de SQL para celdas analysis_sql. Al validar una celda analysis_sql, incluya sus widgets de fuente de datos ascendentes para que el punto final pueda verificar las expresiones SQL con sus esquemas. -- Valide estas definiciones de celdas de notebook antes de guardar. -- Verifique si la celda de análisis SQL hace referencia a columnas válidas del widget aguas arriba. +- Valide estas definiciones de celda de notebook antes de guardar. +- Compruebe si la celda de SQL de análisis hace referencia a columnas válidas del widget ascendente. ### `validate_notebook_cells` {#validate-notebook-cells} *Conjunto de herramientas: **widgets***\ *Permisos requeridos: `Timeseries`*\ -Valida múltiples definiciones de widgets de celdas de notebook en una sola llamada, incluyendo la corrección SQL para las celdas de análisis_sql. +Valida múltiples definiciones de widget de celda de notebook en una sola llamada, incluida la exactitud de SQL para celdas analysis_sql. -- Valide todas las celdas en este notebook antes de publicar. -- Verifique estas tres celdas de análisis en busca de errores SQL. +- Valide todas las celdas de este notebook antes de publicar. +- Compruebe estas tres celdas de análisis en busca de errores de SQL. ### `verify_widget_data` {#verify-widget-data} *Conjunto de herramientas: **widgets***\ *Permisos requeridos: `Dashboards Read` o `Timeseries` o `Monitors Read` o `APM Read` o `RUM Apps Read`*\ -Verifica si las definiciones de widgets devuelven datos para la última hora. Llame después de agregar widgets a un dashboard para confirmar que las consultas devuelven datos reales. Devuelve un resultado por cada widget que indica si se encontraron datos, proporcionando un motivo en caso negativo. +Verifica si las definiciones de los widgets devuelven datos de la última hora. Llame después de agregar widgets a un dashboard para confirmar que las consultas devuelvan datos reales. Devuelve un resultado por widget indicando si se encontraron datos, con una razón en caso contrario. -- Verifique si estas definiciones de widgets devuelven datos. +- Compruebe si estas definiciones de widgets devuelven datos. - Verifique que los widgets agregados al dashboard muestren métricas reales. ### `visualize_tabular_data` {#visualize-tabular-data} *Conjunto de herramientas: **widgets***\ *Permisos requeridos: No se requieren permisos específicos.*\ -Representa datos tabulares como una visualización interactiva (sunburst, treemap o lista principal). Utilice después de agregar datos de consultas para visualizar relaciones jerárquicas o clasificaciones. +Representa datos tabulares como una visualización interactiva (sunburst, treemap o lista principal). Úselo después de agregar datos de consultas para visualizar relaciones jerárquicas o clasificaciones. -- Visualice estos datos métricos agrupados como un gráfico de sunburst. -- Muestre estos datos agregados como un desglose en treemap. +- Visualice estos datos de métricas agrupados como un gráfico sunburst. +- Muestre estos datos agregados como un desglose de treemap. ## Flujos de trabajo {#workflows} -Herramientas para [Workflow Automation][39], que incluyen listar, inspeccionar, ejecutar y configurar flujos de trabajo para uso de agentes. +Herramientas para [Workflow Automation][39], que incluyen la creación y gestión de flujos de trabajo, la activación e inspección de ejecuciones, la depuración de pasos individuales y la búsqueda de acciones. ### `list_datadog_workflows` {#list-datadog-workflows} -*Conjunto de herramientas: **flujos de trabajo***\ +*Conjunto de herramientas: **workflows***\ *Permisos requeridos: `Workflows Read`*\ -Lista y busca flujos de trabajo de [Workflow Automation][39]. Soporta filtrado por nombre, etiquetas, propietario, identificador y tipo de activador (como `monitor`, `schedule`, `api` o `incident`). Los resultados pueden ser ordenados por campos como `name` o `updatedAt`. +Enumera y busca flujos de trabajo de [Workflow Automation][39] por nombre, creador, identificador, etiqueta o tipo de activador. Los resultados incluyen metadatos de forma predeterminada y pueden incluir opcionalmente las especificaciones completas del flujo de trabajo. -- Muéstreme todos los flujos de trabajo publicados etiquetados con `team:platform`. -- Liste los flujos de trabajo que tengan un disparador de agente configurado. -- Encuentre todos los flujos de trabajo relacionados con la respuesta a incidentes que sean propiedad de Alice Smith. +- Muéstreme los flujos de trabajo publicados etiquetados con `team:platform`. +- Enumere los flujos de trabajo que tienen configurado un activador de agente. +- Busque los flujos de trabajo creados por Alice Smith. ### `get_datadog_workflow` {#get-datadog-workflow} -*Conjunto de herramientas: **flujos de trabajo***\ +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Read`*\ +Recupera un flujo de trabajo por ID, incluyendo sus metadatos y especificación completa. Devuelve un borrador guardado cuando existe uno; de lo contrario, devuelve la especificación base. + +- Obtenga los detalles completos del flujo de trabajo `00000000-0000-0000-0000-000000000000`. +- Muéstreme los parámetros de entrada y los pasos para el flujo de trabajo `00000000-0000-0000-0000-000000000000`. +- ¿Qué activadores están configurados para este flujo de trabajo? + +### `search_datadog_workflow_actions` {#search-datadog-workflow-actions} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Read`*\ +Busque en el catálogo de acciones de Workflow Automation con una consulta de texto libre y clasifique las acciones coincidentes por relevancia. Cada resultado incluye un ID de acción; utilice `get_datadog_workflow_action` para recuperar su contrato antes de agregarlo a una especificación de flujo de trabajo. + +- Encuentre acciones de flujo de trabajo para enviar y reaccionar a mensajes de Slack. +- Busque una acción que liste los depósitos de Amazon S3. +- Encuentre acciones de control de flujo para condiciones y ramas. + +### `get_datadog_workflow_action` {#get-datadog-workflow-action} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Read`*\ +Recupera la definición de una acción de Workflow Automation por ID de acción. La definición incluye esquemas de entrada y salida resueltos e instrucciones específicas de la acción para construir un paso de flujo de trabajo. + +- Obtenga la definición de la acción `com.datadoghq.http.request`. +- Enumere las entradas requeridas para esta acción de flujo de trabajo. +- ¿Qué salidas devuelve esta acción? + +### `get_datadog_workflow_spec_schema` {#get-datadog-workflow-spec-schema} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Read`*\ +Recupera el esquema JSON para una especificación completa de Workflow Automation, incluida la estructura requerida para activadores, pasos y conexiones. Utilice esta herramienta antes de construir una especificación para crear, validar o actualizar un flujo de trabajo. + +- Obtenga el esquema JSON necesario para crear un flujo de trabajo. +- ¿Qué campos necesita un activador de horario en la especificación? + +### `validate_datadog_workflow` {#validate-datadog-workflow} +*Conjunto de herramientas: **workflows***\ *Permisos requeridos: `Workflows Read`*\ -Recupera información detallada sobre un flujo de trabajo específico, incluyendo sus disparadores, pasos, conexiones y esquema de entrada. +Verifica una especificación de flujo de trabajo completa sin crear ni modificar un flujo de trabajo. Devuelve un resultado `isValid` y cualquier error de validación. La validación no verifica credenciales externas, permisos ni el comportamiento de tiempo de ejecución de terceros. + +- Valide esta especificación de flujo de trabajo antes de crearla. +- Explique por qué esta especificación de flujo de trabajo actualizada no supera la validación. + +### `create_datadog_workflow` {#create-datadog-workflow} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Write`*\ +Cree un flujo de trabajo [Workflow Automation][39] no publicado a partir de una especificación completa. -- Obtenga los detalles completos para el flujo de trabajo `00000000-0000-0000-0000-000000000000`. -- Muéstreme los parámetros de entrada y pasos para el flujo de trabajo de reversión de implementación. -- ¿Qué disparadores están configurados para este flujo de trabajo? +- Cree un flujo de trabajo que publique un mensaje de Slack cuando sea activado por un agente. +- Cree un flujo de trabajo con un activador de horario que se ejecute todos los días a las 9 a. m. +- Deje este flujo de trabajo de escalada de incidente sin publicar para su revisión. + +### `update_datadog_workflow` {#update-datadog-workflow} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Write`*\ +Actualiza un flujo de trabajo de [Workflow Automation][39] por ID. Las especificaciones y listas de etiquetas proporcionadas reemplazan los valores existentes, mientras que los campos omitidos permanecen sin cambios. Las actualizaciones de especificaciones se guardan como borradores. + +- Obtenga el flujo de trabajo de reversión de implementación, agregue un activador de agente a su especificación completa y luego publique el borrador guardado. +- Obtenga el flujo de trabajo de escalada de incidentes y agregue un paso de notificación mientras conserva el resto de su especificación. +- Obtenga las etiquetas existentes de este flujo de trabajo y luego reemplácelas con la lista completa que incluye `team:platform`. + +### `publish_datadog_workflow` {#publish-datadog-workflow} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Write`*\ +Publica un flujo de trabajo por ID. Si existe un borrador guardado, este reemplaza la especificación base y se elimina. De lo contrario, se publica la especificación base existente no publicada. + +- Publique el borrador guardado del flujo de trabajo de reversión de implementación. +- Publique el flujo de trabajo de escalada de incidentes recién creado. + +### `unpublish_datadog_workflow` {#unpublish-datadog-workflow} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Write`*\ +Despublica un flujo de trabajo por ID para detener nuevas ejecuciones automáticas mientras conserva su especificación base y cualquier borrador guardado. Esto no cancela las ejecuciones que ya están en curso; utilice `cancel_datadog_workflow_instance` para ellas. + +- Despublique el flujo de trabajo de implementación mientras se revisan los cambios. +- Detenga las nuevas ejecuciones programadas del flujo de trabajo de escalada de incidentes sin cancelar su instancia en ejecución. + +### `delete_datadog_workflow` {#delete-datadog-workflow} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Write`*\ +Elimina permanentemente un flujo de trabajo por ID. Esta herramienta requiere la confirmación explícita del usuario y `confirm: true` antes de eliminar el flujo de trabajo. + +- Elimine el flujo de trabajo de escalada de incidentes reemplazado. +- Eliminar permanentemente el flujo de trabajo `00000000-0000-0000-0000-000000000000`. ### `execute_datadog_workflow` {#execute-datadog-workflow} -*Conjunto de herramientas: **flujos de trabajo***\ +*Conjunto de herramientas: **workflows***\ *Permisos requeridos: `Workflows Run`*\ -Ejecute un flujo de trabajo publicado que tenga un disparador de agente, con parámetros de entrada opcionales que coincidan con el esquema de entrada del flujo de trabajo. +Inicia una nueva ejecución de un flujo de trabajo que tiene un activador de agente. Ejecuta el borrador guardado cuando existe uno; de lo contrario, ejecuta la especificación base. -- Ejecute el flujo de trabajo de escalamiento de incidentes para el servicio `checkout-api` con severidad `high`. +- Ejecute el flujo de trabajo de escalamiento de incidentes con `service` establecido en `checkout-api` y `severity` establecido en `high`. - Ejecute el flujo de trabajo de reversión de implementación para el servicio de pagos. -- Dispare el flujo de trabajo de notificación On-Call con el contexto de esta investigación. +- Active el flujo de trabajo de notificación On-Call con el contexto de invocación `Investigating a checkout-api deployment failure`. -**Nota**: El flujo de trabajo debe estar publicado y tener un disparador de agente configurado. Utilice `update_datadog_workflow_with_agent_trigger` para agregar uno si es necesario. +### `list_datadog_workflow_instances` {#list-datadog-workflow-instances} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Read`*\ +Enumera el historial de ejecución de un flujo de trabajo, con filtros para el estado de ejecución. Use `get_datadog_workflow_instance` para obtener detalles. + +- Enumere las ejecuciones más recientes de este flujo de trabajo. +- Enumere todas las instancias fallidas del flujo de trabajo de implementación. +- Encuentre la última ejecución exitosa y su ID de instancia. ### `get_datadog_workflow_instance` {#get-datadog-workflow-instance} -*Conjunto de herramientas: **flujos de trabajo***\ +*Conjunto de herramientas: **workflows***\ *Permisos requeridos: `Workflows Read`*\ -Recupera el estado y los detalles de una instancia de ejecución de flujo de trabajo, incluidos los resultados de los pasos y las salidas. +Recupera un resumen ligero de una instancia de ejecución de flujo de trabajo, con una opción para incluir el registro de ejecución detallado. Use `get_datadog_workflow_step_data` para inspeccionar un paso. -- ¿Cuál es el estado de la ejecución del flujo de trabajo que disparó? -- ¿Se completó con éxito el flujo de trabajo de escalamiento de incidentes? -- Muéstreme las salidas detalladas de la instancia de flujo de trabajo `00000000-0000-0000-0000-000000000000`. +- ¿Cuál es el estado de la ejecución del flujo de trabajo que activé? +- ¿Se completó correctamente el flujo de trabajo de escalada de incidentes? +- Mostrar el registro detallado de la instancia de flujo de trabajo `00000000-0000-0000-0000-000000000000`. -### `update_datadog_workflow_with_agent_trigger` {#update-datadog-workflow-with-agent-trigger} -*Conjunto de herramientas: **flujos de trabajo***\ -*Permisos requeridos: `Workflows Write`*\ -Agrega un disparador de agente a un flujo de trabajo y lo publica, permitiendo que el flujo de trabajo sea ejecutado por agentes de IA. +### `get_datadog_workflow_step_data` {#get-datadog-workflow-step-data} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Read`*\ +Recupera datos de ejecución para un paso de flujo de trabajo, con contexto de ejecución opcional. + +- Depura el canal de Slack utilizado por el paso `send-slack-message` en esta ejecución de flujo de trabajo. +- Inspecciona la iteración basada en cero `3` (la cuarta iteración) del paso de bucle while `retry-until-complete`. +- Inspecciona el paso `notify-on-call` dentro de la iteración con base cero `3` de su bucle contenedor. +- Incluye el contexto de ejecución para el paso de implementación que falló. + +### `cancel_datadog_workflow_instance` {#cancel-datadog-workflow-instance} +*Conjunto de herramientas: **workflows***\ +*Permisos requeridos: `Workflows Run`*\ +Cancela una instancia de ejecución de un flujo de trabajo en curso. Utilice esta herramienta solo cuando el usuario desee detener la ejecución. Una ejecución cancelada no se puede reanudar, pero `execute_datadog_workflow` puede iniciar una nueva ejecución. -- Agregue un disparador de agente al flujo de trabajo de reversión de implementación para que pueda ejecutarlo desde aquí. -- Configure el flujo de trabajo de respuesta a incidentes para que pueda ser activado por un agente. +- Cancela la ejecución de flujo de trabajo más reciente porque su entrada es incorrecta. +- Detenga la instancia de flujo de trabajo `00000000-0000-0000-0000-000000000000`. [1]: /es/mcp_server/setup#toolsets [15]: /es/api/latest/events/ @@ -1582,4 +2596,21 @@ Agrega un disparador de agente a un flujo de trabajo y lo publica, permitiendo q [57]: /es/notebooks/ [58]: /es/real_user_monitoring/ [59]: /es/real_user_monitoring/rum_without_limits/ -[63]: /es/agent/guide/rshell/ \ No newline at end of file +[62]: /es/experiments/ +[63]: /es/agent/guide/rshell/ +[64]: /es/cloud_cost_management/ +[65]: /es/code_coverage/ +[66]: /es/delivery_performance/dora_metrics/ +[67]: /es/security/cloud_siem/triage_and_investigate/ioc_explorer/ +[68]: /es/product_analytics/ +[69]: /es/session_replay/ +[70]: /es/data_observability/ +[71]: /es/account_management/audit_trail/ +[72]: /es/actions/forms/ +[73]: /es/real_user_monitoring/operations_monitoring/ +[75]: /es/bits_ai/bits_chat/ +[76]: /es/bits_ai/bits_investigation/ + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/es/metrics/guide/agent-filtering-for-custom-metrics.md b/hugo/content/es/metrics/guide/agent-filtering-for-custom-metrics.md new file mode 100644 index 00000000000..d7ab29b0e33 --- /dev/null +++ b/hugo/content/es/metrics/guide/agent-filtering-for-custom-metrics.md @@ -0,0 +1,400 @@ +--- +aliases: +- /es/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics/ +description: Filtre las Custom Metrics que no se utilicen en el Datadog Agent para + reducir el volumen de métricas ingeridas e indexadas. +further_reading: +- link: /metrics/custom_metrics/ + tag: Documentación + text: Más información sobre Custom Metrics +- link: /account_management/billing/custom_metrics/?tab=countrate + tag: Documentación + text: Facturación de Custom Metrics +- link: /metrics/metrics-without-limits/ + tag: Documentación + text: Metrics without Limits™ +- link: /metrics/volume/ + tag: Documentación + text: Gestión del volumen de métricas +- link: https://www.datadoghq.com/blog/custom-metrics-governance/ + tag: Blog + text: Prácticas recomendadas para la gobernanza integral de Custom Metrics +title: Filtrado del Agent para Custom Metrics +--- +{{< callout url="https://www.datadoghq.com/product-preview/agent-side-filtering-for-custom/" >}} El filtrado del Agent para Custom Metrics está en versión preliminar. Si le interesa esta función, complete este formulario. {{< /callout >}} + +## Descripción general {#overview} + +El filtrado del Agent le permite filtrar Custom Metrics no utilizadas o no deseadas (tanto de DogStatsD como de integraciones del Agent) directamente en el Datadog Agent, antes de enviarlas a Datadog. Esto puede reducir significativamente el volumen de Custom Metrics tanto indexadas como ingeridas. + +El filtrado se realiza a nivel del Agent, pero se gestiona de forma centralizada a través de la interfaz de usuario de Datadog, lo que brinda a los equipos visibilidad y control totales. Puede crear, actualizar y gestionar políticas de filtrado en Datadog, lo que agiliza la gobernanza de métricas mientras mantiene la transparencia. + +La creación y actualización de políticas de filtrado requiere el permiso de RBAC [`metric_tags_write`][1]. Todos los usuarios pueden visualizar las políticas de filtrado. + +## Requisitos previos {#prerequisites} + +- Actualice a Datadog Agent v7.67.0 o superior. + - Se recomienda usar la v7.70.0 o superior para filtrar métricas de DogStatsD. + - Se requiere usar la v7.74.0 o superior para las métricas de integraciones del Agent. +- Con los permisos [`org_management`][2], habilite [Remote Configuration][3] para su organización. +- Con los permisos [`api_keys_write`][4], habilite [capacidad de Remote Configuration en las claves de API][5] que utilizan sus Agents. Después de habilitar Remote Configuration en una clave de API, reinicie sus Agents para que el cambio surta efecto. + +{{Botón Habilitar propiedades de clave de API con capacidad de Remote Configuration.}} + +## Crear una política de filtrado de métricas {#create-a-metric-filtering-policy} + +Puede crear una política de filtrado de métricas desde la [página Configuración de métricas][7] o la [página Metrics Summary][6]. + +Las políticas de filtrado de métricas se aplican a todos los Agents v7.67.0+ (v7.74.0+ para métricas de Agent Integration) con Remote Configuration habilitado. Las versiones de Agent más antiguas, o los Agents con Remote Configuration deshabilitado, no aplican políticas de filtrado. + +Las actualizaciones de políticas se implementan en los Agents en 1-2 minutos. + +### Desde la página Configuración de métricas {#from-the-metrics-settings-page} + +1. Haga clic en {{< ui >}}\+ Create Policy{{< /ui >}}. +2. Haga clic en {{< ui >}}Filter metrics{{< /ui >}}. +3. Proporcione una descripción para la nueva política. +4. Seleccione las métricas para filtrar desde el menú desplegable {{< ui >}}Metrics to Filter{{< /ui >}}, o haga clic en {{< ui >}}Upload CSV{{< /ui >}}. + - Si elige cargar un CSV, seleccione el archivo y haga clic en {{< ui >}}Open{{< /ui >}}. Puede usar varios archivos CSV para crear la política. +5. Cuando esté satisfecho con la lista de métricas para filtrar, haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +### Desde la página Metrics Summary {#from-the-metrics-summary-page} + +Cree una política de filtrado de métricas desde la página Metrics Summary usando cualquiera de los siguientes métodos: + +{{< tabs >}} +{{% tab "Desde una consulta de métricas" %}} + +1. Ingrese una consulta de métricas en la barra de búsqueda. +2. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla. +3. Haga clic en {{< ui >}}Filter metrics{{< /ui >}}. +4. En el menú desplegable {{< ui >}}Choose policy{{< /ui >}}, haga clic en {{< ui >}}New Policy{{< /ui >}}. Proporcione una descripción para la política. +5. Revise {{< ui >}}Metrics to Filter{{< /ui >}}. Haga clic en `X` en el lado derecho de cualquier fila para eliminar una métrica de la lista, o haga clic en {{< ui >}}\+ Include More Metrics{{< /ui >}} para agregar métricas a la lista. +6. Haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/create_policy_from_metric_query.mp4" alt="Creación de una política de filtrado de métricas a partir de una consulta de métrica" video="true" >}} + +{{% /tab %}} +{{% tab "Desde el editor de políticas" %}} + +1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla. +2. Haga clic en {{< ui >}}Filter metrics{{< /ui >}}. +3. En el menú desplegable {{< ui >}}Choose policy{{< /ui >}}, haga clic en {{< ui >}}New Policy{{< /ui >}}. Proporcione una descripción para la política. +4. Ingrese una consulta de métrica en el campo {{< ui >}}Metrics to Filter{{< /ui >}}, o seleccione métricas individualmente desde el menú desplegable. Haga clic en `X` en el lado derecho de cualquier fila para eliminar una métrica de la lista. +5. Haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/create_policy_with_policy_editor.mp4" alt="Creación de una política de filtrado de métricas desde el editor de políticas" video="true" >}} + +{{% /tab %}} +{{% tab "Desde la carga de CSV" %}} + +1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla. +2. Haga clic en {{< ui >}}Filter metrics{{< /ui >}}. +3. En el menú desplegable {{< ui >}}Choose policy{{< /ui >}}, haga clic en {{< ui >}}New Policy{{< /ui >}}. Proporcione una descripción para la política. +4. Haga clic en {{< ui >}}Upload CSV{{< /ui >}} a la derecha del campo {{< ui >}}Metrics to Filter{{< /ui >}}. +5. Seleccione el archivo CSV y haga clic en {{< ui >}}Open{{< /ui >}}. +6. Revise las métricas enumeradas. Haga clic en `X` en el lado derecho de cualquier fila para eliminar una métrica de la lista. Si es necesario, cargue archivos CSV adicionales o agregue métricas a través del campo {{< ui >}}Metrics to Filter{{< /ui >}}. +7. Haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/create_policy_with_csv_upload.mp4" alt="Creación de una política de filtrado de métricas con una carga de archivo CSV" video="true" >}} + +{{% /tab %}} +{{< /tabs >}} + +## Edite una política de filtrado de métricas {#edit-a-metric-filtering-policy} + +Puede editar una política de filtrado de métricas desde la [página de Configuración de métricas][1] o la [página de Metrics Summary][2]. + +### Desde la página Configuración de métricas {#from-the-metrics-settings-page-1} + +1. Haga clic en la política para editarla. +2. Haga clic en {{< ui >}}Edit{{< /ui >}}. +3. Seleccione las métricas para filtrar desde el menú desplegable {{< ui >}}Metrics to Filter{{< /ui >}}, o haga clic en {{< ui >}}Upload CSV{{< /ui >}}. + - Si elige cargar un CSV, seleccione el archivo y haga clic en {{< ui >}}Open{{< /ui >}}. +4. Haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/edit_policy_from_metrics_settings.mp4" alt="Edición de una política de filtrado de métricas desde la página de Configuración de métricas" video="true" >}} + +### Desde la página de Metrics Summary {#from-the-metrics-summary-page-1} + +Edite una política de filtrado de métricas desde la página de Metrics Summary utilizando cualquiera de los siguientes métodos: + +{{< tabs >}} +{{% tab "Desde una consulta de métricas" %}} + +1. Ingrese una consulta de métricas en la barra de búsqueda. +2. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla. +3. Haga clic en {{< ui >}}Filter metrics{{< /ui >}}. +4. En el menú desplegable {{< ui >}}Choose policy{{< /ui >}}, seleccione la política que desea editar. +5. Revise las listas {{< ui >}}Metrics to Filter{{< /ui >}} y {{< ui >}}Existing metrics in policy{{< /ui >}}. Haga clic en `X` en el lado derecho de cualquier fila para eliminar una métrica de la lista, o haga clic en {{< ui >}}\+ Include More Metrics{{< /ui >}} para agregar métricas a la lista. +6. Haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/edit_policy_with_metric_query.mp4" alt="Edición de una política de filtrado de métricas con una consulta de métricas" video="true" >}} + +{{% /tab %}} +{{% tab "Desde el editor de políticas" %}} + +1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla. +2. Haga clic en {{< ui >}}Filter metrics{{< /ui >}}. +3. En el menú desplegable {{< ui >}}Choose policy{{< /ui >}}, seleccione la política que desea editar. +4. Seleccione las métricas individualmente desde el menú desplegable {{< ui >}}Metrics to Filter{{< /ui >}}. Haga clic en `X` en el lado derecho de cualquier fila para eliminar una métrica de la lista. +5. Haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +{{% /tab %}} +{{% tab "Desde la carga de CSV" %}} + +1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla. +2. Haga clic en {{< ui >}}Filter metrics{{< /ui >}}. +3. En el menú desplegable {{< ui >}}Choose policy{{< /ui >}}, seleccione la política que desea editar. +4. Haga clic en {{< ui >}}Upload CSV{{< /ui >}} a la derecha del campo {{< ui >}}Metrics to Filter{{< /ui >}}. +5. Seleccione el archivo CSV y haga clic en {{< ui >}}Open{{< /ui >}}. +6. Revise las listas {{< ui >}}Metrics to Filter{{< /ui >}} y {{< ui >}}Existing metrics in policy{{< /ui >}}. Haga clic en `X` en el lado derecho de cualquier fila para eliminar una métrica de la lista, o haga clic en {{< ui >}}\+ Include More Metrics{{< /ui >}} para agregar métricas a la lista. +7. Haga clic en {{< ui >}}Save and Filter{{< /ui >}}. + +{{% /tab %}} +{{< /tabs >}} + +## Visualizar todas las políticas y métricas filtradas {#view-all-policies-and-filtered-metrics} + +Puede visualizar todas sus políticas y métricas filtradas desde la [página de Configuración de métricas][1]. + +Haga clic en el [botón de configuración][1]: + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/settings_from_summary.png" alt="El botón de configuración en la página de Metrics Summary" style="width:100%;" >}} + +Haga clic en {{< ui >}}Metrics{{< /ui >}} en la barra de navegación y vaya directamente a la configuración: + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/settings_from_nav.png" alt="La opción de configuración del panel de Metrics expandido en Datadog" style="width:100%;" >}} + +### Visualizar todas las políticas {#view-all-policies} + +Seleccione la pestaña {{< ui >}}Policies{{< /ui >}} de la barra lateral para ver una lista de todas sus políticas. Si no ve la barra lateral, haga clic en el botón {{< ui >}}Show Sidebar{{< /ui >}} {{< img src="metrics/guide/agent_filtering_for_custom_metrics/show_sidebar.png" inline="true" width="22" >}}. + +Haga clic en cualquier política de filtrado de métricas para abrir y visualizar su detalle, para editarla o eliminarla. + +### Visualizar todas las métricas filtradas {#view-all-filtered-metrics} + +Seleccione la pestaña {{< ui >}}Filtered Metrics{{< /ui >}} de la barra lateral para ver una lista de todas sus métricas filtradas. Si no ve la barra lateral, haga clic en el botón {{< ui >}}Show Sidebar{{< /ui >}} {{< img src="metrics/guide/agent_filtering_for_custom_metrics/show_sidebar.png" inline="true" width="22" >}}. + +Haga clic en las políticas adjuntas de una métrica filtrada en la columna {{< ui >}}ATTACHED POLICIES{{< /ui >}} para editarlas o eliminarlas. + +## Eliminar políticas {#delete-policies} + +Puede eliminar políticas de filtrado de métricas desde la [página de Configuración de métricas][1]. + +1. Haga clic en la política de filtrado de métricas para eliminar. +2. Seleccione {{< ui >}}Delete{{< /ui >}} en la esquina superior derecha de la página. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/delete_policy.png" alt="El botón de eliminar política en una vista de detalles de política de filtrado de métricas" style="width:100%;" >}} + +## Administrar políticas de filtrado de métricas a través de la API {#manage-metric-filtering-policies-through-the-api} + +
Estos puntos de conexión están sujetos a cambios mientras el filtrado del lado del Agent para métricas personalizadas esté en versión preliminar.
+ +Estos puntos de conexión requieren una clave de Datadog API y una clave de aplicación válidas. Consulte [Introducción][8] en la Referencia de la API para obtener más información. + +### Crear una política de métricas filtradas {#create-a-filtered-metric-policy} + +La URL base para su [sitio de Datadog][9] seleccionado es: {{}} + +Sustituya `` en el ejemplo a continuación con la URL base. + +**POST** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies` + +#### Cuerpo del ejemplo {#example-body} + +{{< code-block lang="json" disable_copy="false" collapsible="true" >}} +{ + "data": { + "type": "filtered_metrics", + "attributes": { + "policy_name": "my policy", + "metric_names": [ + "metric.name.one", + "metric.name.two" + ] + } + } +} +{{< /code-block >}} + +### Actualizar una política de métricas filtradas (actualización parcial) {#update-a-filtered-metric-policy-partial-update} + +La URL base para su [sitio de Datadog][9] seleccionado es: {{}} + +Sustituya `` en el ejemplo a continuación con la URL base. + +**PATCH** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +#### Cuerpo del ejemplo {#example-body-1} + +{{< code-block lang="json" disable_copy="false" collapsible="true" >}} +{ + "data": { + "type": "filtered_metrics", + "attributes": { + "policy_name": "my policy", + "metrics_to_add": [ + "metric.name.three", + "metric.name.four" + ], + "metrics_to_remove": [ + "metric.name.five", + "metric.name.six" + ] + } + } +} +{{< /code-block >}} + +### Actualizar una política de métricas filtradas (reemplazo completo) {#update-a-filtered-metric-policy-full-replace} + +La URL base para su [sitio de Datadog][9] seleccionado es: {{}} + +Sustituya `` en el ejemplo a continuación con la URL base. + +**PUT** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +#### Cuerpo del ejemplo {#example-body-2} + +{{< code-block lang="json" disable_copy="false" collapsible="true" >}} +{ + "data": { + "type": "filtered_metrics", + "attributes": { + "policy_name": "my policy", + "metric_names": [ + "metric.name.seven", + "metric.name.eight" + ] + } + } +} +{{< /code-block >}} + +### Eliminar una política {#delete-a-policy} + +La URL base para su [sitio de Datadog][9] seleccionado es: {{}} + +Sustituya `` en el ejemplo a continuación con la URL base. + +**DELETE** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +### Obtener una política de métricas filtradas {#get-a-filtered-metric-policy} + +La URL base para su [sitio de Datadog][9] seleccionado es: {{}} + +Sustituya `` en el ejemplo a continuación con la URL base. + +**GET** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +#### Cuerpo de respuesta de ejemplo {#example-response-body} + +{{< code-block lang="json" disable_copy="true" collapsible="true" >}} +{ + "data": [ + { + "type": "filtered_metrics", + "id": "metric.name.one", + "attributes": { + "updated_timestamp": 1745954352 + } + }, + { + "type": "filtered_metrics", + "id": "metric.name.two" + "attributes": { + "updated_timestamp": 1745954389 + } + } + // ... up to ~10,000 entries + ], + "links": { + "self": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=200&page[limit]=100", + "next": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=300&page[limit]=100", + "prev": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=100&page[limit]=100", + "first": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=0&page[limit]=100", + "last": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=9900&page[limit]=100" + }, + "meta": { + "agent_coverage_percent": 100, + "agents_with_latest_policy_count": 4, + "deployment_failure": { + "failed_agent_count": 0, + "failure_message": "" + }, + "deployment_status": "Deployed to all Agents", + "deployment_strategy": "all", + "policy_name": "test_policy_1", + "total": 7, + "total_agent_count": 4, + "updated_by": "user@datadoghq.com", + "updated_timestamp": 1758912365 + } +} +{{< /code-block >}} + +### Listar políticas de métricas filtradas {#list-filtered-metric-policies} + +La URL base para su [sitio de Datadog][9] seleccionado es: {{}} + +Sustituya `` en el ejemplo a continuación con la URL base. + +**GET** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies` + +#### Cuerpo de respuesta de ejemplo {#example-response-body-1} + +{{< code-block lang="json" disable_copy="true" collapsible="true" >}} +{ + "data": [ + { + "id": "06b-fab-47e", + "type": "filtered_metrics", + "attributes": { + "count": 85, + "deployment_status": "Deployed to all Agents", + "deployment_strategy": "all", + "policy_name": "policy one", + "updated_by": "user@datadoghq.com", + "updated_timestamp": 1758547485, + "version": 4 + } + }, + { + "id": "07b-201-47e", + "type": "filtered_metrics", + "attributes": { + "count": 8, + "deployment_status": "Deployed to all Agents", + "deployment_strategy": "all", + "policy_name": "policy two", + "updated_by": "user@datadoghq.com", + "updated_timestamp": 1758547212, + "version": 1 + } + } + ] +} +{{< /code-block >}} + +## Limitaciones de la versión preliminar {#preview-limitations} + +Esta versión preliminar inicial incluye las siguientes limitaciones: + +- Se puede filtrar un máximo de 10,000 nombres de métricas. +- El impacto del uso de recursos en el Agent se limita hasta 10MB de memoria (RSS), y no hay aumento en el uso de CPU. +- Solo se admiten métricas personalizadas recibidas de DogStatsD o de integraciones del Agent. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/account_management/rbac/permissions/#metrics +[2]: /es/account_management/rbac/permissions/#access-management +[3]: https://app.datadoghq.com/organization-settings/remote-config +[4]: /es/account_management/rbac/permissions#api-and-application-keys +[5]: https://app.datadoghq.com/organization-settings/api-keys +[6]: https://app.datadoghq.com/metric/summary +[7]: https://app.datadoghq.com/metric/settings/policies +[8]: /es/api/latest/#getting-started +[9]: /es/getting_started/site/ \ No newline at end of file diff --git a/hugo/content/es/monitors/types/data_observability.md b/hugo/content/es/monitors/types/data_observability.md index cc6f02d5cea..5c27b776e84 100644 --- a/hugo/content/es/monitors/types/data_observability.md +++ b/hugo/content/es/monitors/types/data_observability.md @@ -222,6 +222,7 @@ Para monitores que utilizan el método de detección {{< ui >}}Anomalies{{< /ui | {{< ui >}}Alert after N consecutive anomalies{{< /ui >}} | La cantidad de evaluaciones fallidas consecutivas antes de que el monitor envíe una alerta. Configure este ajuste para suprimir picos aislados. | | {{< ui >}}Minimum upper bound size{{< /ui >}} | Restringe qué tan estrictamente el modelo rastrea sus datos en el extremo superior. | | {{< ui >}}Minimum lower bound size{{< /ui >}} | Restringe qué tan estrictamente el modelo rastrea sus datos en el extremo inferior. | +| {{< ui >}}Sensitivity{{< /ui >}} | Controle el ancho de los límites esperados. Mueva el control deslizante hacia {{< ui >}}Fewer alerts{{< /ui >}} para límites más anchos, o hacia {{< ui >}}More alerts{{< /ui >}} para límites más estrechos. Los tamaños mínimos de los límites configurados aún se aplican. | ### Programación del monitor {#monitor-schedule} diff --git a/hugo/content/es/network_monitoring/cloud_network_monitoring/_index.md b/hugo/content/es/network_monitoring/cloud_network_monitoring/_index.md index 0727a7b621f..3acd8ffb23e 100644 --- a/hugo/content/es/network_monitoring/cloud_network_monitoring/_index.md +++ b/hugo/content/es/network_monitoring/cloud_network_monitoring/_index.md @@ -10,62 +10,71 @@ aliases: - /es/graphing/infrastructure/network_performance_monitor/ - /es/network_performance_monitoring/ - /es/network_monitoring/performance/ -description: Explora métricas para la comunicación punto a punto en tu infraestructura. +description: Explore métricas para la comunicación punto a punto en su infraestructura. further_reading: +- link: https://www.datadoghq.com/architecture/hybrid-cloud-network-observability/ + tag: Centro de arquitectura + text: Arquitectura de referencia para la observabilidad de red híbrida multinube +- link: https://www.datadoghq.com/blog/cnm-network-health + tag: Blog + text: Detecte, diagnostique y resuelva problemas de red fácilmente con CNM Network + Health - link: /network_monitoring/cloud_network_monitoring/guide/detecting_application_availability/ tag: Guía - text: Detección de la disponibilidad de aplicaciones mediante información de red + text: Detección de disponibilidad de aplicaciones mediante Network Insights - link: https://www.datadoghq.com/blog/npm-windows-support/ tag: Blog - text: Monitorización de hosts de Windows con Cloud Network Monitoring + text: Haga un seguimiento de los hosts de Windows con Cloud Network Monitoring - link: https://www.datadoghq.com/blog/cloud-service-autodetection-datadog/ tag: Blog - text: Monitorizar el estado del endpoint con la autodetección del servicio en la - nube + text: Haga un seguimiento del estado de los puntos de conexión en la nube con la + autodetección de servicios en la nube - link: https://www.datadoghq.com/blog/npm-best-practices/ tag: Blog - text: Prácticas recomendadas para empezar a utilizar Datadog CNM + text: Prácticas recomendadas para comenzar con Datadog CNM - link: https://www.datadoghq.com/blog/monitor-consul-with-datadog-npm/ tag: Blog - text: Datadog CNM ahora admite la conexión en red de Consul + text: Datadog CNM ahora es compatible con redes Consul - link: https://www.datadoghq.com/blog/npm-story-centric-ux/ tag: Blog - text: Inicio rápido de investigaciones de red con UX centrado en la historia de - CNM + text: Inicie rápidamente investigaciones de red con la experiencia de usuario centrada + en historias de CNM - link: https://www.datadoghq.com/blog/monitor-connection-churn-datadog/ tag: Blog - text: Prácticas recomendadas para la monitorización y corrección del churn de conexiones + text: Prácticas recomendadas para hacer un seguimiento y remediar la rotación de + conexiones +- link: /network_monitoring/cloud_network_monitoring/glossary + tag: Doc + text: Términos y conceptos de CNM +- link: https://learn.datadoghq.com/courses/getting-started-infra-cnm + tag: Centro de aprendizaje + text: Primeros pasos con la infraestructura y Cloud Network Monitoring (CNM) title: Cloud Network Monitoring --- - -## Información general +## Descripción general {#overview} {{< vimeo url="https://player.vimeo.com/progressive_redirect/playback/670228207/rendition/1080p/file.mp4?loc=external&signature=42d4a7322017fffa6d5cc2e49ddbb7cfc4c6bbbbf207d13a5c9830630bda4ece" poster="/images/poster/npm.png" >}} -Datadog Cloud Network Monitoring (CNM) te da visibilidad de tu tráfico de red entre servicios, contenedores, zonas de disponibilidad y cualquier otra etiqueta en Datadog. Los datos de conexión a nivel de IP, puerto y PID se agregan en dependencias de la capa de aplicación entre endpoints de cliente y servidor significativos, que pueden analizarse y visualizarse a través de una [página de red][1] y un [mapa de red][2] personalizables. Utiliza los datos de flujo junto con el tráfico de red clave y las métricas de servidor DNS para: - -* Localizar dependencias inesperadas o de servicio latentes -* Optimiza la costosa comunicación entre regiones o nubes múltiples -* Identificar las interrupciones de las regiones proveedoras de la nube y las herramientas de terceros -* Solucionar problemas de servidor DNS del lado del cliente y del lado del servidor - -CNM simplifica la monitorización de redes complejas con la compatibilidad integrada para Linux y [Windows OS][3], así como entornos en contenedores orquestados e [instrumentados con la red de servicio de Istio][4]. +Datadog Cloud Network Monitoring (CNM) le brinda visibilidad del tráfico de su red entre servicios, contenedores, zonas de disponibilidad y cualquier otra etiqueta en Datadog. Los datos de conexión a nivel de IP, puerto y PID se agregan en dependencias de capa de aplicación entre puntos de conexión de cliente y servidor significativos, los cuales pueden analizarse y visualizarse a través de una [página de red][1] y un [Network Map][2] personalizables. Utilice datos de flujo junto con métricas clave de tráfico de red y de servidor DNS para: -Además, la [ruta de red][5], una función de CNM, está disponible en Vista previa, lo que te permite ver el tráfico salto a salto en tu red. +* Identifique dependencias de servicio inesperadas o latentes +* Optimice la costosa comunicación entre regiones o entre nubes +* Identifique interrupciones en regiones de proveedores de nube y herramientas de terceros +* Solucione problemas de servidores DNS del lado del cliente y del lado del servidor {{< whatsnext desc="Esta sección incluye los siguientes temas:">}} - {{< nextlink href="network_monitoring/cloud_network_monitoring/setup" >}}Configuración: configura el Agent para recopilar datos de red.{{< /nextlink >}} - {{< nextlink href="network_monitoring/cloud_network_monitoring/network_analytics" >}}Análisis de red: grafica tus datos de red entre cada cliente y servidor disponible.{{< /nextlink >}} - {{< nextlink href="network_monitoring/cloud_network_monitoring/network_map" >}}Mapa de red: asigna tus datos de red entre tus etiquetas.{{< /nextlink >}} - {{< nextlink href="monitors/types/cloud_network_monitoring/#common-monitors" >}}Monitores comunes: configura monitores de CNM comunes.{{< /nextlink >}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/setup" >}}Configuración: Configure el Agente para recopilar datos de red.{{< /nextlink >}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/network_health" >}}Network Health: Revise el estado de su entorno de red.{{< /nextlink >}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/network_analytics" >}}Network Analytics: Grafique sus datos de red entre cada cliente y servidor disponible.{{< /nextlink >}} + {{< nextlink href="network_monitoring/network_path/setup/#scheduled-tests" >}}Network Path Scheduled Tests: Visualice la ruta que sigue el tráfico de red desde su origen hasta su destino mediante pruebas programadas.{{< /nextlink >}} + {{< nextlink href="network_monitoring/network_path/setup/#dynamic-tests" >}}Network Path Dynamic Tests: Cree pruebas de forma dinámica para permitir que el Agente descubra automáticamente las rutas de red y les haga un seguimiento.{{< /nextlink >}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/network_map" >}}Network Map: Mapee sus datos de red entre sus etiquetas.{{< /nextlink >}} + {{< nextlink href="monitors/types/cloud_network_monitoring/#common-monitors" >}}Monitores comunes: Configure los monitores CNM comunes.{{< /nextlink >}} {{< /whatsnext >}} -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: https://app.datadoghq.com/network -[2]: https://app.datadoghq.com/network/map -[3]: https://www.datadoghq.com/blog/npm-windows-support/ -[4]: https://www.datadoghq.com/blog/monitor-istio-with-npm/ -[5]: /es/network_monitoring/network_path/ \ No newline at end of file +[2]: https://app.datadoghq.com/network/map \ No newline at end of file diff --git a/hugo/content/es/network_monitoring/netflow/_index.md b/hugo/content/es/network_monitoring/netflow/_index.md index 07f9e8866fc..d73d712f828 100644 --- a/hugo/content/es/network_monitoring/netflow/_index.md +++ b/hugo/content/es/network_monitoring/netflow/_index.md @@ -2,6 +2,9 @@ aliases: - /es/network_monitoring/devices/netflow/ further_reading: +- link: https://www.datadoghq.com/architecture/hybrid-cloud-network-observability/ + tag: Centro de arquitectura + text: Arquitectura de referencia para la observabilidad de red híbrida multinube - link: /network_monitoring/devices/profiles tag: Documentación text: Uso de perfiles con Network Device Monitoring @@ -10,10 +13,14 @@ further_reading: text: Configuración de pruebas dinámicas para NetFlow - link: https://www.datadoghq.com/blog/monitor-netflow-with-datadog/ tag: Blog - text: Monitoree los datos de tráfico de NetFlow con Datadog + text: Haga un seguimiento de los datos de tráfico de NetFlow con Datadog - link: https://www.datadoghq.com/blog/diagnose-network-performance-with-snmp-trap-monitoring/ tag: Blog - text: Monitoree y diagnostique problemas de rendimiento de la red con capturas SNMP + text: Haga un seguimiento y un diagnóstico de problemas de rendimiento de la red + con capturas SNMP +- link: https://www.datadoghq.com/blog/understanding-netflow-duplication/ + tag: Blog + text: 'Comprensión de la duplicación de NetFlow: por qué sucede y cómo deduplicarla' title: NetFlow Monitoring --- ## Descripción general {#overview} @@ -93,7 +100,7 @@ Datadog enriquece los puertos en NetFlow con datos de IANA (Internet Assigned Nu También puede agregar sus propios enriquecimientos personalizados para asignar puertos y protocolos a aplicaciones específicas (por ejemplo, si un servicio personalizado se ejecuta en un puerto específico). Esto facilita que los ingenieros de red y sus equipos interpreten y consulten los datos de NetFlow con nombres legibles por humanos. -Desde la pestaña {{< ui >}}Configuration{{< /ui >}} en NetFlow, haga clic en {{< ui >}}+ Add Enrichment{{< /ui >}} para cargar el archivo CSV que contiene sus enriquecimientos personalizados. +Desde la pestaña {{< ui >}}Configuration{{< /ui >}} en NetFlow, haga clic en {{< ui >}}\+ Add Enrichment{{< /ui >}} para cargar el archivo CSV que contiene sus enriquecimientos personalizados. {{< img src="network_device_monitoring/netflow/new_enrichment_2.png" alt="El modal de Nueva asignación de enriquecimiento en la pestaña de configuración de NetFlow" width="100%" >}} @@ -101,7 +108,7 @@ Desde la pestaña {{< ui >}}Configuration{{< /ui >}} en NetFlow, haga clic en {{ También puede agregar sus propios enriquecimientos personalizados para asignar IP y CIDR a etiquetas personalizadas (por ejemplo, para categorizar servicios que se ejecutan en direcciones IP específicas). Esto facilita que los ingenieros de red y sus equipos interpreten y consulten los datos de NetFlow con nombres legibles por humanos. -Desde la [{{< ui >}}Enrichment{{< /ui >}} página de configuración][10], haga clic en {{< ui >}}+ Add Enrichment{{< /ui >}} para agregar asignaciones manualmente o cargar un archivo CSV para agregar asignaciones de forma masiva. +Desde la [{{< ui >}}Enrichment{{< /ui >}} página de configuración][10], haga clic en {{< ui >}}\+ Add Enrichment{{< /ui >}} para agregar asignaciones manualmente o cargar un archivo CSV para agregar asignaciones de forma masiva. ### Enriquecimiento de IP privada de DNS inverso {#reverse-dns-private-ip-enrichment} @@ -109,7 +116,7 @@ Habilite el enriquecimiento de IP privada de DNS inverso para realizar búsqueda De forma predeterminada, el enriquecimiento de IP de DNS inverso en su [`datadog.yaml` archivo][7] está deshabilitado. Para habilitarlo, consulte la sección [Configuración](#configuration) de esta página. -Busque DNS en el menú {{< ui >}}+ Filter{{< /ui >}} para localizar flujos asociados con el enriquecimiento de IP de DNS inverso: +Busque DNS en el menú {{< ui >}}\+ Filter{{< /ui >}} para localizar flujos asociados con el enriquecimiento de IP de DNS inverso: {{< img src="network_device_monitoring/netflow/dns_ip_enrichmen_2.png" alt="Menú de filtro mejorado para mostrar las facetas de destino y fuente de DNS inverso" width="100%" >}} @@ -117,7 +124,7 @@ Busque DNS en el menú {{< ui >}}+ Filter{{< /ui >}} para localizar flujos asoci ## Detalles de IP {#ip-details} -En la vista **Conversaciones**, puede ver la dirección IP pública de la IP de destino. Pase el cursor sobre la IP para mostrar metadatos enriquecidos sobre la IP y un enlace a {{< ui >}}View Related Network Connections{{< /ui >}} donde puede inspeccionar la conectividad con más detalle. +En la vista **Conversaciones**, puede visualizar la dirección IP pública de la IP de destino. Pase el cursor sobre la IP para mostrar metadatos enriquecidos sobre la IP y un enlace a {{< ui >}}View Related Network Connections{{< /ui >}} donde puede inspeccionar la conectividad con más detalle. {{< img src="network_device_monitoring/netflow/NetFlow_IP_pill.png" alt="Pase el cursor sobre una dirección IP para mostrar los detalles de la IP y visualizar conexiones de red relacionadas." width="100%" >}} diff --git a/hugo/content/es/opentelemetry/getting_started/otel_demo_to_datadog.md b/hugo/content/es/opentelemetry/getting_started/otel_demo_to_datadog.md new file mode 100644 index 00000000000..852266c1bdf --- /dev/null +++ b/hugo/content/es/opentelemetry/getting_started/otel_demo_to_datadog.md @@ -0,0 +1,403 @@ +--- +algolia: + tags: + - opentelemetry + - open telemetry + - otel + - opentelemetry demo +aliases: +- /es/opentelemetry/guide/otel_demo_to_datadog +- /es/opentelemetry/otel_demo_to_datadog +further_reading: +- link: /internal_developer_portal/catalog/ + tag: Documentación + text: Catalog +- link: /tracing/trace_explorer/ + tag: Documentación + text: Trace Explorer +- link: /tracing/trace_explorer/trace_queries/ + tag: Documentación + text: Consultas de traza +- link: /error_tracking/ + tag: Documentación + text: Error Tracking +title: Envío de datos de la demostración de OpenTelemetry a Datadog +--- +## Descripción general {#overview} + +
Este tutorial utiliza el Datadog Exporter y el Datadog Connector. Para nuevas configuraciones del Collector, Datadog recomienda la canalización OTLP en Configurar el OpenTelemetry Collector.
+ +La [demostración de OpenTelemetry][1] es una aplicación de demostración de microservicios desarrollada por la comunidad para demostrar OpenTelemetry (OTel) +la instrumentación y sus capacidades de observabilidad. Es una página web de comercio electrónico compuesta por múltiples microservicios que se comunican entre sí a través de HTTP y gRPC. Todos los servicios están instrumentados con OpenTelemetry y producen trazas, métricas y registros. + +Esta página lo guía a través de los pasos necesarios para implementar el OpenTelemetry Demo y enviar sus datos a Datadog. + +## Requisitos previos {#prerequisites} + +Para completar esta guía, asegúrese de tener lo siguiente: + +1. [Cree una cuenta de Datadog][2] si aún no lo ha hecho. +2. Busque o cree su [clave de Datadog API][3]. +3. 6 GB de RAM libre para la aplicación. + +Puede implementar la demostración OpenTelemetry usando Docker o Kubernetes (con Helm). Elija su método de implementación preferido y asegúrese de tener instaladas las herramientas necesarias: + +{{< tabs >}} +{{% tab "Docker" %}} + +- Docker +- Docker Compose v2.0.0+ +- Make (opcional) + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +- Kubernetes 1.24+ +- Helm 3.9+ +- Un clúster de Kubernetes activo con kubectl configurado para conectarse a él + +{{% /tab %}} +{{< /tabs >}} + +## Configuración e implementación del OpenTelemetry Demo {#configuring-and-deploying-the-demo} + +### Clonación del repositorio {#cloning-the-repository} + +Clone el `opentelemetry-demo` repositorio en su dispositivo: + +```shell +git clone https://github.com/open-telemetry/opentelemetry-demo.git +``` + +### Configure el OpenTelemetry Collector {#configuring-the-opentelemetry-collector} + +Para enviar los datos de telemetría del OpenTelemetry Demo a Datadog, necesita añadir los siguientes componentes a la configuración del OpenTelemetry Collector: + +- `Resource Processor` es un componente `optional` pero recomendado que se utiliza para establecer el atributo de recurso `deployment.environment.name`, que Datadog asigna a la etiqueta `env`. +- `Datadog Connector` es responsable de calcular las métricas de traza de Datadog APM. +- `Datadog Exporter` es responsable de exportar trazas, métricas y registros a Datadog. +- `Datadog Extension` es un componente `optional` que le permite visualizar la configuración del OpenTelemetry Collector dentro del monitoreo de infraestructura. (Lea más en [Datadog Extension][13]). + +Complete los siguientes pasos para configurar estos componentes. + +{{< tabs >}} +{{% tab "Docker" %}} + +1. Abra el repositorio de la demostración. Cree un archivo llamado `docker-compose.override.yml` en la carpeta raíz. + +2. Abra el archivo creado. Pegue el siguiente contenido y establezca las variables de entorno [Datadog site][7] y [Datadog API key][8]: + + ```yaml + services: + otel-collector: + command: + - "--config=/etc/otelcol-config.yml" + - "--config=/etc/otelcol-config-extras.yml" + - "--feature-gates=datadog.EnableOperationAndResourceNameV2" + environment: + - DD_SITE_PARAMETER= + - DD_API_KEY= + ``` + +3. Para configurar el OpenTelemetry Collector, abra `src/otel-collector/otelcol-config-extras.yml` y añada lo siguiente al archivo: + + ```yaml + extensions: + datadog/extension: + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + http: + endpoint: "localhost:9875" + path: "/metadata" + + exporters: + datadog: + traces: + compute_stats_by_span_kind: true + trace_buffer: 500 + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + sending_queue: + batch: + min_size: 10 + max_size: 100 + flush_timeout: 10s + + processors: + resource: + attributes: + - key: deployment.environment.name + value: "otel" + action: upsert + + connectors: + datadog/connector: + traces: + compute_stats_by_span_kind: true + + service: + extensions: [datadog/extension] + pipelines: + traces: + receivers: [otlp] + processors: [resourcedetection, memory_limiter, resource, transform/sanitize_spans] + exporters: [otlp_grpc/jaeger, debug, spanmetrics, datadog, datadog/connector] + metrics: + receivers: [datadog/connector, docker_stats, httpcheck/frontend-proxy, hostmetrics, nginx, otlp, postgresql, redis, spanmetrics] + processors: [resourcedetection, memory_limiter, resource] + exporters: [otlp_http/prometheus, debug, datadog] + logs: + receivers: [otlp] + processors: [resourcedetection, memory_limiter, resource] + exporters: [opensearch, debug, datadog] + ``` + + By default, the collector in the demo application merges the configuration from two files: + + - `src/otel-collector/otelcol-config.yml`: contains the default configuration for the collector. + - `src/otel-collector/otelcol-config-extras.yml`: used to add extra configuration to the collector. + +
+ Al combinar valores YAML, los objetos se combinan y las matrices se reemplazan. + Es por eso que hay más componentes especificados en las canalizaciones de los que realmente están configurados. + La configuración anterior no reemplaza los valores configurados en el principal otelcol-config archivo. +
+ +[7]: /es/getting_started/site/ +[8]: https://app.datadoghq.com/organization-settings/api-keys/ + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +1. Cree un secreto llamado `dd-secrets` para almacenar los secretos del sitio de Datadog y la clave de API de Datadog: + + ```shell + kubectl create secret generic dd-secrets --from-literal="DD_SITE_PARAMETER=" --from-literal="DD_API_KEY=" + ``` + +2. Agregue el [Helm chart][4] de OpenTelemetry a su repositorio para administrar e implementar el OpenTelemetry Demo: + + ```shell + helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts + ``` + +3. Cree un archivo llamado `my-values-file.yml` con el siguiente contenido: + + ```yaml + opentelemetry-collector: + extraEnvsFrom: + - secretRef: + name: dd-secrets + config: + extensions: + datadog/extension: + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + http: + endpoint: "localhost:9875" + path: "/metadata" + exporters: + datadog: + traces: + compute_stats_by_span_kind: true + trace_buffer: 500 + hostname: "otelcol-helm" + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + sending_queue: + batch: + min_size: 10 + max_size: 100 + flush_timeout: 10s + + processors: + resource: + attributes: + - key: deployment.environment.name + value: "otel" + action: upsert + + connectors: + datadog/connector: + traces: + compute_stats_by_span_kind: true + + service: + extensions: [health_check, datadog/extension] + pipelines: + traces: + processors: [memory_limiter, resource, resourcedetection, transform] + exporters: [otlp/jaeger, debug, spanmetrics, datadog, datadog/connector] + metrics: + receivers: [datadog/connector, otlp, spanmetrics] + processors: [memory_limiter, resource, resourcedetection, transform] + exporters: [otlphttp/prometheus, debug, datadog] + logs: + processors: [memory_limiter, resource, resourcedetection, transform] + exporters: [opensearch, debug, datadog] + ``` + +
+ Al combinar valores YAML, los objetos se combinan y las matrices se reemplazan. + Es por eso que hay más componentes especificados en las canalizaciones de los que realmente están configurados. + La configuración anterior no reemplaza los valores configurados en el principal otelcol-config archivo. +
+ +[4]: https://opentelemetry.io/docs/demo/kubernetes-deployment/ + +{{% /tab %}} +{{< /tabs >}} + +### Ejecución del OpenTelemetry Demo {#running-the-demo} + +{{< tabs >}} +{{% tab "Docker" %}} + +Si tiene make instalado, puede usar el siguiente comando para iniciar el OpenTelemetry Demo: + +```shell +make start +``` + +Si no tiene `make` instalado, puede usar el comando `docker compose` directamente: + +```shell +docker compose --env-file .env --env-file .env.override up --force-recreate --remove-orphans --detach +``` + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +Para implementar la aplicación del OpenTelemetry Demo en Kubernetes usando Helm, ejecute el siguiente comando: + +```shell +helm install my-otel-demo open-telemetry/opentelemetry-demo --values my-values-file.yml +``` + +{{% /tab %}} +{{< /tabs >}} + +## Navegación por la aplicación {#navigating-the-application} + +Puede acceder a la interfaz web de Astronomy Shop para explorar la aplicación y observar cómo se generan los datos de telemetría. + +{{< tabs >}} +{{% tab "Docker" %}} + +Vaya a . + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +1. Si está ejecutando un clúster local, necesita reenviar el puerto del proxy de frontend: + + ```shell + kubectl port-forward svc/my-otel-demo-frontendproxy 8080:8080 + ``` + +2. Vaya a . + +{{% /tab %}} +{{< /tabs >}} + +## Correlación de datos de telemetría {#telemetry-data-correlation} + +Los pasos de instrumentación utilizados en todos los servicios del OpenTelemetry Demo se pueden encontrar +en la documentación principal de OpenTelemetry. + +Puede encontrar el lenguaje en el que se implementó cada servicio, así como su +documentación en la [tabla de referencia de características de lenguaje][10]. + +## Exploración de datos de OpenTelemetry en Datadog {#exploring-opentelemetry-data-in-datadog} + +Cuando el OTel Demo está en ejecución, el generador de carga integrado simula tráfico en la aplicación. +Después de un par de segundos, puede ver los datos llegando a Datadog. + +### Catalog {#catalog} + +Visualizar todos los servicios que forman parte del OTel Demo: + +1. Vaya a [{{< ui >}}APM{{< /ui >}} > {{< ui >}}Catalog{{< /ui >}}][11]. + +{{< img src="/getting_started/opentelemetry/otel_demo/software_catalog.png" alt="Visualizar la página de catálogo con la lista de servicios del OpenTelemetry Demo" style="width:90%;" >}} + +2. Seleccione {{< ui >}}Map{{< /ui >}} para ver cómo están conectados los servicios. Cambie {{< ui >}}Map layout{{< /ui >}} a {{< ui >}}Cluster{{< /ui >}} o {{< ui >}}Flow{{< /ui >}} para visualizar el mapa en diferentes modos. + +{{< img src="/getting_started/opentelemetry/otel_demo/software_catalog_flow.png" alt="Ver el flujo d Service Map con todos los servicios conectados" style="width:90%;" >}} + +3. Seleccione la vista {{< ui >}}Catalog{{< /ui >}}, luego seleccione un servicio para ver un resumen del rendimiento en el panel lateral. + +{{< img src="/getting_started/opentelemetry/otel_demo/software_catalog_service.png" alt="Visualizar resumen del rendimiento y guía de configuración de un servicio específico" style="width:90%;" >}} + +### Trace Explorer {#trace-explorer} + +Explore las trazas recibidas del OTel Demo: + +1. Desde {{< ui >}}Performance{{< /ui >}} > {{< ui >}}Setup Guidance{{< /ui >}}, haga clic en {{< ui >}}View Traces{{< /ui >}} para abrir el Trace Explorer, con el servicio seleccionado aplicado como filtro. + +{{< img src="/getting_started/opentelemetry/otel_demo/traces_view.png" alt="Vista de traza con todos los tramos indexados para el servicio de comprobación" style="width:90%;" >}} + +2. Seleccione un tramo indexado para visualizar los detalles completos de la traza para esta transacción. + +{{< img src="/getting_started/opentelemetry/otel_demo/trace_waterfall.png" alt="Vista de traza con todos los tramos que pertenecen a esa transacción específica" style="width:90%;" >}} + +3. Navegue por las pestañas para visualizar detalles adicionales: + - Métricas de infraestructura para los servicios que reportan métricas de servidor. + - Métricas de tiempo de ejecución para los servicios que ya se han implementado. + - Entradas de registro correlacionadas con esta traza. + - Enlaces de tramos vinculados a esta traza. + +### Consultas de traza {#trace-queries} + +Datadog le permite filtrar y agrupar los datos de OpenTelemetry recibidos. Por ejemplo, para encontrar todas las transacciones de un usuario específico, puede usar Consultas de traza. + +El OTel Demo envía `user.id` como etiquetas de tramos, por lo que puede usar esto para filtrar todas las transacciones activadas por el usuario: + +1. Desde {{< ui >}}Info{{< /ui >}} en el panel lateral, pase el cursor sobre la línea con el ID de usuario, haga clic en el icono {{< ui >}}cog{{< /ui >}} y seleccione {{< ui >}}filter by @app.user.id:{{< /ui >}}. + +2. Elimine cualquier filtro anterior, dejando solo {{< ui >}}@app.user.id{{< /ui >}} aplicado para visualizar todas las transacciones que contienen tramos con el ID de usuario especificado. + +{{< img src="/getting_started/opentelemetry/otel_demo/trace_query.png" alt="Consulta de traza que filtra todos los tramos que contienen un app.user.id específico" style="width:90%;" >}} + +### Error Tracking {#error-tracking} + +El OpenTelemetry Demo incluye un motor de Feature Flag para simular escenarios de error. + +1. Navegue a [http://localhost:8080/feature][12] para administrar los escenarios disponibles. Consulte la [documentación del OpenTelemetry Demo][5] para obtener más detalles. +2. Después de que el OTel Demo comience a producir errores, puede visualizar y rastrear los servicios afectados en Datadog. + +{{< img src="/getting_started/opentelemetry/otel_demo/error_tracking.png" alt="Vista de Error Tracking que muestra el error PaymentService Fail Feature Flag Enabled" style="width:90%;" >}} + +### Configuración de OpenTelemetry Collector {#opentelemetry-collector-configuration} + +La extensión de Datadog le permite visualizar la configuración de OpenTelemetry Collector dentro de Datadog en cualquiera de las siguientes páginas: + +- [Infrastructure List][14]. +- [Resource Catalog][15]. + +Al seleccionar el nombre de host donde se ejecuta el Collector, puede visualizar su configuración completa: + +{{< img src="/getting_started/opentelemetry/otel_demo/collector_full_config.png" alt="Configuración de OpenTelemetry Collector renderizada dentro de Datadog" style="width:90%;" >}} + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://github.com/open-telemetry/opentelemetry-demo +[2]: https://www.datadoghq.com/free-datadog-trial/ +[3]: https://app.datadoghq.com/organization-settings/api-keys/ +[5]: https://opentelemetry.io/docs/demo/feature-flags/ +[10]: https://opentelemetry.io/docs/demo/#language-feature-reference +[11]: https://app.datadoghq.com/services +[12]: http://localhost:8080/feature +[13]: /es/opentelemetry/integrations/datadog_extension/ +[14]: https://app.datadoghq.com/infrastructure +[15]: https://app.datadoghq.com/infrastructure/catalog \ No newline at end of file diff --git a/hugo/content/es/opentelemetry/integrations/datadog_extension.md b/hugo/content/es/opentelemetry/integrations/datadog_extension.md index 3502f8f5435..879a8ab7e1f 100644 --- a/hugo/content/es/opentelemetry/integrations/datadog_extension.md +++ b/hugo/content/es/opentelemetry/integrations/datadog_extension.md @@ -2,36 +2,37 @@ further_reading: - link: /opentelemetry/setup/collector_exporter/ tag: Documentación - text: Configuración de OpenTelemetry Collector + text: Configuración del OpenTelemetry Collector - link: /infrastructure/list/ tag: Documentación - text: Lista de infraestructuras + text: Lista de infraestructura - link: /infrastructure/resource_catalog/ tag: Documentación text: Resource Catalog title: Extensión de Datadog --- +## Descripción general {#overview} -## Información general +A partir de OpenTelemetry Collector Contrib [modules v0.129.0][4] y versiones posteriores, la extensión de Datadog se incluye en las [distribuciones Contrib][5] de OpenTelemetry Collector. También está disponible para [compilación personalizada][6] de OpenTelemetry Collector. En el [DDOT Collector][8], la extensión se habilita automáticamente. -A partir de OpenTelemetry Collector Contrib [módulos v0.129.0][4] y posteriores, la extensión de Datadog se incluye en [distribuciones de contribución][5] del recopilador de OpenTelemetry. También está disponible para [compilaciones personalizadas][6] del recopilador de OpenTelemetry. +La extensión de Datadog le permite visualizar la configuración y la información de compilación del OpenTelemetry Collector directamente en Datadog mediante [Fleet Automation][7], la [Lista de infraestructura][2] y [Resource Catalog][3]. La extensión funciona con la configuración recomendada del exportador OTLP HTTP y con el exportador de Datadog. -La extensión de Datadog te permite visualizar la configuración del recopilador de OpenTelemetry y la información de compilación directamente en Datadog en la [Lista de infraestructuras][2] y [Resource Catalog][3]. Cuando se utiliza con [Datadog Exporter][1], esta extensión te ofrece visibilidad de tu flota de recopiladores sin salir de la interfaz de usuario de Datadog. +{{< img src="/agent/fleet_automation/fleet-automation-pipeline-view.png" alt="Visualice las configuraciones del OTel Collector con la visualización de pipelines en Fleet Automation" style="width:100%;" >}} -{{< img src="/opentelemetry/integrations/datadog_extension_hostlist.png" alt="Configuración del recopilador de OpenTelemetry mostrada en la lista de hosts de Datadog" style="width:100%;" >}} +## Características clave {#key-features} -## Características principales +- **Visibilidad de la configuración del Collector**: visualice la configuración completa de cualquier OTel Collector en su infraestructura. +- **Información de compilación**: vea la versión del Collector, los detalles de compilación y la información de los componentes. +- **Punto de conexión de inspección local**: utilice un punto de conexión HTTP para la depuración local y la verificación de la configuración. +- **Gestión de flotas**: haga un seguimiento y gestione su flota de OpenTelemetry Collector desde la interfaz de usuario de Datadog. -- **Visibilidad de la configuración del recopilador**: Visualiza la configuración completa de cualquier recopilador de tu infraestructura. -- **Información de compilación**: Consulta la versión del recopilador, los detalles de la compilación y la información de los componentes. -- **Gestión de flotas**: Monitoriza y gestiona tu flota de recopiladores de OpenTelemetry desde la interfaz de usuario de Datadog. -- **Endpoint de inspección local**: Utiliza un endpoint de HTTP para la depuración local y la verificación de la configuración. +## Configuración {#setup} -## Instalación +
Si utiliza el DDOT Collector, no configure manualmente la extensión de Datadog. Está habilitada automáticamente en todas las versiones del DDOT Collector.
-### 1. Añade la extensión de Datadog a la configuración del recopilador. +### 1. Agregue la extensión de Datadog a su configuración del Collector {#1-add-the-datadog-extension-to-your-collector-configuration} -Configura la extensión de Datadog en tu archivo de configuración del recopilador de OpenTelemetry: +Configure la extensión de Datadog en su archivo de configuración de OpenTelemetry Collector: ```yaml extensions: @@ -39,61 +40,225 @@ extensions: api: key: ${env:DD_API_KEY} site: {{< region-param key="dd_site" >}} - # hostname: "my-collector-host" # Optional: must match Datadog Exporter hostname if set + # hostname: "my-collector-host" # Optional: must match the hostname in exported telemetry service: extensions: [datadog] ``` -### 2. Configura el exportador de Datadog +### 2. Configure un pipeline de telemetría activo {#2-configure-an-active-telemetry-pipeline} -Esta función requiere que el exportador de Datadog esté configurado y activado en un pipeline activo (`traces` o `metrics`). La extensión utiliza la telemetría del exportador para asociar la configuración del recopilador con un host específico en Datadog. +Configure al menos un pipeline de telemetría activo y exporte sus datos a Datadog. Para la configuración recomendada, utilice la [configuración del exportador OTLP HTTP][9]. + +La extensión utiliza metadatos del Collector y del servidor para asociar la configuración reportada con el servidor correspondiente en Datadog. + +### 3. (Opcional) Agregue atributos de recurso personalizados {#3-optional-add-custom-resource-attributes} + +La extensión de Datadog recopila automáticamente los atributos de recurso de la telemetría interna del colector y los incluye en la carga útil de metadatos que envía a Datadog. Para adjuntar atributos personalizados como el entorno de despliegue, el equipo o el nombre del clúster de Kubernetes, establézcalos bajo `service.telemetry.resource`: ```yaml +service: + telemetry: + resource: + deployment.environment.name: production + team.name: platform + k8s.cluster.name: prod-us-east1-cluster-a +``` + +El Collector adjunta automáticamente `service.name`, `service.version` y `service.instance.id` (un UUID generado aleatoriamente) a su telemetría interna. No necesita configurarlos manualmente. + +### 4. (Opcional) Configure la topología de puerta de enlace (vista previa) {#4-optional-configure-gateway-topology-preview} + +Cuando tiene una configuración de puerta de enlace de OpenTelemetry Collector que reenvía telemetría a través de uno o más colectores de puerta de enlace antes de llegar a Datadog, la extensión de Datadog puede publicar la topología para que aparezca como un gráfico de canalización conectado en [Fleet Automation][7]: + +{{< img src="opentelemetry/integrations/datadog_extension_gateway_topology.png" alt="Vista de topología de puerta de enlace en Fleet Automation que muestra los colectores DaemonSet reenviando a través de dos capas de colectores de puerta de enlace a Datadog" style="width:100%;" >}} + +Para habilitar esta vista, configure cada Collector en la canalización: + +- Establezca `deployment_type` en `daemonset` para los Collectors de agente o DaemonSet y en `gateway` para los Collectors de puerta de enlace. +- Establezca `gateway_destination` en los Collectors que reenvían a una puerta de enlace descendente. El valor es el servicio de Kubernetes de la puerta de enlace receptora, en forma de `/`. +- Establezca `gateway_service` en los colectores de puerta de enlace. El valor es el servicio de Kubernetes que está frente a los pods de la puerta de enlace. +- Una **puerta de enlace intermedia** en una canalización de varias capas establece **ambos** `gateway_service` (su propio servicio) y `gateway_destination` (la siguiente puerta de enlace). +- Establezca `k8s.cluster.name` bajo `service.telemetry.resource` en cada Collector de la canalización. Esto es **obligatorio**: junto con `gateway_service` y `gateway_destination`, forma la clave de unión que Fleet Automation utiliza para reconstruir el gráfico de la canalización. +- Habilite las métricas internas del Collector para que la extensión pueda atribuir los datos de volumen de registros, métricas o trazas a cada borde en el gráfico con el interruptor **Mostrar tráfico**. Consulte [Métricas de estado del OpenTelemetry Collector][10]. + +El ejemplo a continuación cubre el caso común de dos capas: un DaemonSet local al nodo reenvía a un Deployment de puerta de enlace, el cual envía a Datadog con el Datadog Exporter. + +Cada Collector expone sus propias métricas de estado en un punto de conexión de extracción de Prometheus a través de `service.telemetry.metrics`, extrae ese punto de conexión con un receptor `prometheus/internal` y enruta el resultado a través de la misma canalización de métricas que la telemetría de la aplicación. Esto es lo que completa cada nodo y borde en la visualización de topología. + +#### DaemonSet Collector {#daemonset-collector} + +```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 + prometheus/internal: + config: + scrape_configs: + - job_name: otelcol-internal + scrape_interval: 10s + static_configs: + - targets: ['localhost:8888'] + exporters: - datadog/exporter: + otlp: + endpoint: otelcol-gateway.monitoring.svc.cluster.local:4317 + tls: + insecure: true + +extensions: + datadog: api: key: ${env:DD_API_KEY} site: {{< region-param key="dd_site" >}} - # hostname: "my-collector-host" # Optional: must match Datadog Extension hostname if set + deployment_type: daemonset + gateway_destination: monitoring/otelcol-gateway + +service: + telemetry: + metrics: + level: normal + readers: + - pull: + exporter: + prometheus: + host: 0.0.0.0 + port: 8888 + without_type_suffix: true + without_units: true + resource: + k8s.cluster.name: my-cluster + k8s.node.name: ${env:K8S_NODE_NAME} + k8s.pod.name: ${env:K8S_POD_NAME} + extensions: [datadog] + pipelines: + metrics: + receivers: [otlp, prometheus/internal] + exporters: [otlp] + traces: + receivers: [otlp] + exporters: [otlp] + logs: + receivers: [otlp] + exporters: [otlp] ``` -### 3. Activa la extensión en la configuración de tu servicio +La canalización `metrics` del DaemonSet incluye `prometheus/internal` para que las propias métricas de estado del Collector viajen a través de OTLP a la puerta de enlace junto con la telemetría de la aplicación, llegando a Datadog a través del Datadog Exporter de la puerta de enlace. -Añade la extensión de Datadog a tus extensiones de servicio: +#### Gateway Collector {#gateway-collector} ```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 + prometheus/internal: + config: + scrape_configs: + - job_name: otelcol-internal + scrape_interval: 10s + static_configs: + - targets: ['localhost:8888'] + +exporters: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + metrics: + resource_attributes_as_tags: true + sending_queue: + batch: + flush_timeout: 10s + +extensions: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + deployment_type: gateway + gateway_service: monitoring/otelcol-gateway + service: + telemetry: + metrics: + level: normal + readers: + - pull: + exporter: + prometheus: + host: 0.0.0.0 + port: 8888 + without_type_suffix: true + without_units: true + resource: + k8s.cluster.name: my-cluster + k8s.node.name: ${env:K8S_NODE_NAME} + k8s.pod.name: ${env:K8S_POD_NAME} extensions: [datadog] pipelines: + metrics: + receivers: [otlp, prometheus/internal] + exporters: [datadog] traces: receivers: [otlp] - processors: [batch] - exporters: [datadog/exporter] - metrics: + exporters: [datadog] + logs: receivers: [otlp] - processors: [batch] - exporters: [datadog/exporter] + exporters: [datadog] +``` + +La canalización `metrics` de la puerta de enlace acepta tanto la telemetría reenviada (desde el DaemonSet a través de OTLP) como sus propias métricas internas desde `prometheus/internal`, luego exporta todo a Datadog. + +#### Canalizaciones de puerta de enlace de múltiples capas {#multi-layer-gateway-pipelines} + +Para canalizaciones con más de una capa de puerta de enlace, configure `gateway_service` y `gateway_destination` juntos en la capa intermedia. Por ejemplo, en una topología de tres capas con una puerta de enlace de Capa 2 entre el DaemonSet y una puerta de enlace de Capa 1, la extensión de la puerta de enlace de Capa 2 se configura de la siguiente manera: + +```yaml +extensions: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + deployment_type: gateway + gateway_service: monitoring/otelcol-gateway-l2 + gateway_destination: monitoring/otelcol-gateway-l1 ``` -## Opciones de configuración +El DaemonSet reenvía a `monitoring/otelcol-gateway-l2`, la puerta de enlace de Capa 2 reenvía a `monitoring/otelcol-gateway-l1`, y la puerta de enlace de Capa 1 envía a Datadog. Cada Collector informa el mismo `k8s.cluster.name`. -| Parámetro | Descripción | Valor predeterminado | +## Opciones de configuración {#configuration-options} + +| Parámetro | Descripción | Predeterminado | |-----------|-------------|---------| -| `api.key` | Clave de API de Datadog (obligatoria) | - | -| `api.site` | Sitio de Datadog (por ejemplo, `us5.datadoghq.com`) | `datadoghq.com` | -| `hostname` | Nombre de host personalizado para el recopilador | Autodetección | -| `http.endpoint` | Endpoint del servidor HTTP local | `localhost:9875` | -| `http.path` | Ruta de acceso al servidor HTTP para metadatos | `/metadata` | -| `proxy_url` | URL de proxy HTTP para solicitudes salientes | - | -| `timeout` | Tiempo de espera para solicitudes HTTP | `30s` | -| `tls.insecure_skip_verify` | Omitir la verificación de certificados TLS | `false` | +| `api.key` | Clave de Datadog API (obligatorio). | - | +| `api.site` | Sitio de Datadog (por ejemplo, `us5.datadoghq.com`). | `datadoghq.com` | +| `api.fail_on_invalid_key` | Salir al inicio si la clave de API no es válida. | `true` | +| `hostname` | Nombre de host personalizado para el Collector. | Detectado automáticamente | +| `http.endpoint` | Punto de conexión del servidor HTTP local. | `localhost:9875` | +| `http.path` | Ruta del servidor HTTP para metadatos. | `/metadata` | +| `deployment_type` | Identifica cómo se implementa el Collector. Este valor aparece en [Fleet Automation][7] y es necesario para la [topología de puerta de enlace](#4-optional-configure-gateway-topology-preview). Uno de los siguientes: `gateway`, `daemonset` o `unknown`. El valor predeterminado `unknown` significa que el tipo de implementación no se estableció. | `unknown` | +| `installation_method` | Cómo se instaló el Collector. Uno de los siguientes: `kubernetes`, `bare-metal`, `docker`, `ecs-fargate`, `eks-fargate` o sin establecer. Disponible en Collector v0.148.0 y versiones posteriores. | sin establecer | +| `gateway_service` | Se establece solo en Collectors de **gateway**. El servicio de Kubernetes que respalda los pods del Collector gateway. Formato: `service` o `namespace/service`. Disponible en Collector v0.150.0 y versiones posteriores. | - | +| `gateway_destination` | Establezca en cualquier Collector que reenvíe telemetría a una puerta de enlace descendente. El servicio de Kubernetes al que este Collector reenvía la telemetría. Debe coincidir con `gateway_service` en el gateway Collector receptor. Formato: `service` o `namespace/service`. Disponible en Collector v0.150.0 y versiones posteriores. | - | +| `proxy_url` | URL del proxy HTTP para solicitudes salientes. | - | +| `timeout` | Tiempo de espera para solicitudes HTTP. | `30s` | +| `tls.insecure_skip_verify` | Omitir la verificación del certificado TLS. | `false` |
-Coincidencia de nombres de host: si especificas un nombre de host personalizado en la extensión de Datadog, debe coincidir con el valor del nombre de host en la configuración del exportador de Datadog. La extensión de Datadog no tiene acceso a la telemetría de pipeline y no puede deducir nombres de host de los spans (tramos) entrantes. Solo obtiene los nombres de host de las API del sistema/proveedor de la nube o de la configuración manual. Si la telemetría tiene atributos del nombre de host diferentes del nombre de host informado por la extensión, la telemetría no se correlacionará con el host correcto y es posible que veas hosts duplicados en Datadog. +Coincidencia de nombre de host: Si especifica un nombre de host personalizado hostname en la extensión de Datadog, debe coincidir con el nombre de servidor en la telemetría exportada. La extensión no infiere un nombre de servidor a partir de la telemetría de la aplicación en sus canalizaciones; obtiene su nombre de servidor de las API del sistema o del proveedor de la nube, o de la configuración manual. Si utiliza el exportador de Datadog, su hostname valor también debe coincidir. De lo contrario, es posible que Datadog no correlacione la telemetría con el servidor correcto y que aparezcan servidores duplicados.
-### Ejemplo de configuración completa +### Ejemplo de configuración completa con el exportador de Datadog {#complete-configuration-example-with-the-datadog-exporter} + +El siguiente ejemplo utiliza el exportador de Datadog. La extensión en sí no lo requiere; para la canalización recomendada, utilice la configuración del exportador HTTP de OTLP de [Configurar OpenTelemetry Collector][9]. ```yaml extensions: @@ -116,38 +281,47 @@ exporters: key: ${env:DD_API_KEY} site: {{< region-param key="dd_site" >}} hostname: "my-collector-host" + sending_queue: + batch: + flush_timeout: 10s service: extensions: [datadog] pipelines: traces: receivers: [otlp] - processors: [batch] exporters: [datadog/exporter] metrics: receivers: [otlp] - processors: [batch] exporters: [datadog/exporter] ``` -## Visualización de la configuración del recopilador +## Visualización de la configuración del Collector {#viewing-collector-configuration} + +Una vez configurado, puede visualizar la configuración de su OpenTelemetry Collector y la información de compilación en varias ubicaciones: + +### Fleet Automation {#fleet-automation} +1. Navegue a [{{< ui >}}Integrations{{< /ui >}} > {{< ui >}}Fleet Automation{{< /ui >}}][7]. +2. Filtre los servidores del OTel Collector usando las facetas del Collector y luego haga clic en un servidor. +3. En el panel lateral, seleccione la pestaña {{< ui >}}Info{{< /ui >}} para visualizar la información de compilación. +4. Seleccione la pestaña {{< ui >}}Configurations{{< /ui >}} para visualizar el archivo YAML completo o una visualización de la canalización de las configuraciones de su OTel Collector. -Una vez configurado, puedes visualizar la configuración del recopilador de OpenTelemetry y la información de compilación en dos ubicaciones: +{{< img src="/agent/fleet_automation/fleet-automation-yaml-view.png" alt="Visualizar los YAML de configuración del OTel Collector en Fleet Automation" style="width:100%;" >}} -### Lista de infraestructuras (Lista de hosts) +### Lista de infraestructura (Lista de servidores) {#infrastructure-list-host-list} -1. Ve a **[Infraestructure > Hosts][2]** (Infraestructura > Hosts) en tu cuenta de Datadog. -2. Haz clic en cualquier host que ejecute el recopilador de OpenTelemetry (**Nota**: filtra por `field:apps:OpenTelemetry` para mostrar solo las instancias del recopilador). -3. En el panel de detalles del host, selecciona la pestaña **OTel Collector** (Recopilador de OpenTelemetry) para consultar la información de compilación y la configuración completa del recopilador. +1. Navegue a [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Hosts{{< /ui >}}][2] en su cuenta de Datadog. +2. Haga clic en cualquier servidor que ejecute el OpenTelemetry Collector (**Nota**: filtre por `field:apps:otel` para mostrar solo las instancias del Collector). +3. En el panel de detalles del servidor, seleccione la pestaña {{< ui >}}OTel Collector{{< /ui >}} para ver la información de compilación y la configuración completa del Collector. -### Catálogo de recursos +### Resource Catalog {#resource-catalog} -1. Ve a **[Infrastructure > Resource Catalog][3]** (Infraestructura > Resource Catalog) en tu cuenta de Datadog -2. Filtra por hosts o busca tus instancias del recopilador. -3. Haz clic en cualquier host que ejecute el recopilador de OpenTelemetry. -4. Desplázate a **Collector** (Recopilador) para consultar la información de compilación y la configuración completa del recopilador. +1. Navegue a [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Resource Catalog{{< /ui >}}][3] en su cuenta de Datadog +2. Filtre por servidores o busque sus instancias del Collector. +3. Haga clic en cualquier servidor que ejecute el OpenTelemetry Collector. +4. Desplácese hacia abajo hasta {{< ui >}}Collector{{< /ui >}} para ver la información de compilación y la configuración completa del Collector. -## Servidor HTTP local +## Servidor HTTP local {#local-http-server} La extensión de Datadog incluye un servidor HTTP local para depuración e inspección: @@ -156,34 +330,37 @@ La extensión de Datadog incluye un servidor HTTP local para depuración e inspe curl http://localhost:9875/metadata ``` -Este endpoint proporciona: -- Configuración del recopilador (sin información confidencial) -- Información sobre la compilación y detalles de la versión +Este punto de conexión proporciona: +- Configuración del Collector (sin información confidencial) +- Información de compilación y detalles de la versión - Lista de componentes activos - Estado de la extensión -## Solucionar problemas +## Solución de problemas {#troubleshooting} -### La configuración no aparece en Datadog +### Configuración que no aparece en Datadog {#configuration-not-appearing-in-datadog} -1. **Check la coincidencia de nombres de host**: Asegúrate de que los nombres de host coincidan entre la extensión de Datadog y el exportador de Datadog. -2. **Verificar la clave de API**: Confirma que la clave de API sea válida y que tenga los permisos adecuados. -3. **Check los logs del recopilador**: Busca los logs de inicialización de la extensión y de envío de datos. -4. **Confirmar que la extensión esté activada**: Verifica que la extensión aparezca en la configuración del servicio. +1. **Verificar la coincidencia del nombre de servidor**: Confirme que el nombre de servidor de la extensión de Datadog coincida con el nombre de servidor en la telemetría exportada. Si utiliza el Datadog Exporter, confirme que su nombre de servidor también coincida. +2. **Verificar la clave de API**: Confirme que la clave de API sea válida y tenga los permisos adecuados. +3. **Verificar los registros del Collector**: Busque los registros de inicialización de la extensión y de envío de datos. +4. **Confirmar que la extensión esté habilitada**: Verifique que la extensión aparezca en la configuración del servicio. -### Problemas con el servidor HTTP +### Problemas del servidor HTTP {#http-server-issues} -1. **Conflictos de puertos**: Asegúrate de que el puerto 9875 esté disponible o configura un puerto diferente. -2. **Acceso a la red**: Verifica que el servidor HTTP esté accesible desde tu ubicación de depuración. -3. **Check los logs**: Revisa los logs de la extensión en busca de problemas de inicio del servidor HTTP. +1. **Conflictos de puerto**: Asegúrese de que el puerto 9875 esté disponible o configure un puerto diferente. +2. **Acceso a la red**: Verifique que el servidor HTTP sea accesible desde su ubicación de depuración. +3. **Verificar los registros**: Revise los registros de la extensión para detectar problemas de inicio del servidor HTTP. -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} -[1]: https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/datadogexporter [2]: https://app.datadoghq.com/infrastructure [3]: https://app.datadoghq.com/infrastructure/catalog [4]: https://github.com/open-telemetry/opentelemetry-collector-contrib/releases/tag/v0.129.0 [5]: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.129.1 -[6]: https://opentelemetry.io/docs/collector/custom-collector/ \ No newline at end of file +[6]: https://opentelemetry.io/docs/collector/custom-collector/ +[7]: https://app.datadoghq.com/fleet +[8]: /es/opentelemetry/setup/ddot_collector/ +[9]: /es/opentelemetry/setup/collector_exporter/ +[10]: /es/opentelemetry/integrations/collector_health_metrics/ \ No newline at end of file diff --git a/hugo/content/es/opentelemetry/integrations/kafka_metrics.md b/hugo/content/es/opentelemetry/integrations/kafka_metrics.md index 979b4518402..10c11f55381 100644 --- a/hugo/content/es/opentelemetry/integrations/kafka_metrics.md +++ b/hugo/content/es/opentelemetry/integrations/kafka_metrics.md @@ -2,28 +2,22 @@ further_reading: - link: /opentelemetry/collector_exporter/ tag: Documentación - text: Configuración de OpenTelemetry Collector + text: Configuración del OpenTelemetry Collector title: Métricas de Kafka --- +## Descripción general {#overview} -
-La reasignación de métricas de OTel Kafka está en fase alfa pública. Está disponible en las versiones >= 0.93.0 de Collector. Si tienes algún comentario al respecto, ponte en contacto con el equipo de tu cuenta. -
+{{< img src="/opentelemetry/collector_exporter/kafka_metrics.png" alt="Métricas de Kafka de OpenTelemetry en el Dashboard de Kafka OOTB" style="width:100%;" >}} +El [Kafka metrics receiver][1], [JMX Receiver][2]/[JMX Metrics Gatherer][3] permiten recopilar métricas de Kafka y acceder al [Kafka Dashboard][7] preconfigurado, "Kafka, Zookeeper and Kafka Consumer Overview". -## Información general +**Nota**: el [receptor JMX][2] y el [JMX Metrics Gatherer][3] deben considerarse como reemplazos. Recopilan el mismo conjunto de métricas (el [receptor JMX][2] inicia el [JMX Metrics Gatherer][3]). -{{< img src="/opentelemetry/collector_exporter/kafka_metrics.png" alt="Métricas de OpenTelemetry Kafka en un dashboard de OOTB Kafka" style="width:100%;" >}} -El [receptor de métricas de Kafka][1], [receptor de JMX][2]/[recopilador de métricas de JMX][3] permiten recopilar métricas de Kafka y acceder al [dashboard de Kafka][7] predefinido, "Kafka, Zookeeper and Kafka Consumer Overview". - -Ten en cuenta que el [receptor de JMX][2] y el [recopilador de métricas de JMX][3] deben considerarse sustitutos. Recopilan el mismo conjunto de métricas ([receptor de JMX][2] lanza el [recopilador de métricas de JMX][3]). - - -## Receptor de métricas de Kafka +## Receptor de métricas de Kafka {#kafka-metrics-receiver} {{< tabs >}} -{{% tab "Host" %}} +{{% tab "Servidor" %}} ```yaml receivers: @@ -40,14 +34,15 @@ receivers: {{% tab "Kubernetes" %}} -El receptor de métricas de Kafka debe utilizarse en un recopilador en modo `deployment` con una única réplica. Esto asegura que la misma métrica no se recopile varias veces. El recopilador en modo de despliegue puede entonces aprovechar el Exportador de Datadog para exportar las métricas directamente a Datadog, o aprovechar el exportador OTLP para reenviar las métricas a otra instancia del recopilador. +Use el receptor de métricas de Kafka en un Collector que se ejecute en modo `deployment` con una sola réplica. Esto evita que la misma métrica se recopile varias veces. El Collector puede exportar métricas directamente a Datadog a través de OTLP HTTP o reenviarlas a otra instancia del Collector. + +Agregue las siguientes líneas a `values.yaml`: -Añade las siguientes líneas a `values.yaml`: ```yaml mode: deployment ``` -Añade lo siguiente en la configuración de Collector: +Agregue lo siguiente en la configuración del Collector: ```yaml receivers: @@ -64,16 +59,16 @@ receivers: {{< /tabs >}} -## Receptor JMX +## Receptor JMX {#jmx-receiver} {{< tabs >}} -{{% tab "Host" %}} +{{% tab "Servidor" %}} El receptor JMX tiene los siguientes requisitos: -- JRE está disponible en el host en el que se ejecuta el recopilador. -- El JAR del recopilador de métricas de JMX está disponible en el host donde estás ejecutando el recopilador. Puedes descargar la versión más reciente del JAR del recopilador de métricas de JMX desde la [página de versiones de opentelemetry-java-contrib][1]. +- JRE está disponible en el servidor donde ejecuta el collector. +- El JAR del JMX Metric Gatherer está disponible en el servidor donde ejecuta el collector. Puede descargar la versión más reciente del JAR del JMX Metric Gatherer desde la [página de versiones de opentelemetry-java-contrib][1]. -Añade lo siguiente en la configuración de Collector: +Agregue lo siguiente en la configuración del Collector: ```yaml receivers: @@ -97,28 +92,29 @@ receivers: {{% tab "Kubernetes" %}} -El receptor de JMX debe utilizarse en un recopilador en modo `deployment` con una única réplica. Esto asegura que la misma métrica no se recopile varias veces. El recopilador en modo de despliegue puede entonces aprovechar el Exportador de Datadog para exportar las métricas directamente a Datadog, o aprovechar el exportador OTLP para reenviar las métricas a otra instancia del recopilador. +Use el receptor JMX en un Collector que se ejecute en modo `deployment` con una sola réplica. Esto evita que la misma métrica se recopile varias veces. El Collector puede exportar métricas directamente a Datadog a través de OTLP HTTP o reenviarlas a otra instancia del Collector. -El receptor de JMX tiene los siguientes requisitos: -- JRE está disponible en el host en el que se está ejecutando el recopilador. -- El JAR del recopilador de métricas de JMX está disponible en el host donde estás ejecutando el recopilador. Puedes descargar la versión más reciente del JAR del recopilador de métricas de JMX [aquí][1]. +El receptor JMX tiene los siguientes requisitos: +- JRE está disponible en el servidor en el que ejecuta el collector. +- El JAR del JMX Metrics Gatherer está disponible en el servidor en el que está ejecutando el collector. Puede descargar la versión más reciente del JMX Metrics Gatherer JAR [aquí][1]. -Debido a que la imagen por defecto de OTel Collector no cumple con los requisitos anteriores, es necesario crear una imagen personalizada. Consulta el archivo Dockerfile a continuación para ver una imagen de ejemplo que contiene el archivo binario del recopilador, JRE y JAR del recopilador de métricas de JMX. +Debido a que la imagen predeterminada del collector OTel no cumple con los requisitos anteriores, es necesario crear una imagen personalizada. Consulte el Dockerfile a continuación para ver un ejemplo de una imagen que contiene el binario del collector, JRE y el JAR del JMX Metrics Gatherer. Dockerfile: + ```Dockerfile FROM alpine:latest as prep -# Archivo binario de OpenTelemetry Collector +# OpenTelemetry Collector Binary ARG OTEL_VERSION=0.92.0 ARG TARGETARCH=linux_amd64 ADD "https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v${OTEL_VERSION}/otelcol-contrib_${OTEL_VERSION}_${TARGETARCH}.tar.gz" /otelcontribcol RUN tar -zxvf /otelcontribcol -# JAR del recopilador de métricas de JMX +# JMX Metrics Gatherer Jar ARG JMX_GATHERER_JAR_VERSION=1.27.0 ADD https://github.com/open-telemetry/opentelemetry-java-contrib/releases/download/v${JMX_GATHERER_JAR_VERSION}/opentelemetry-jmx-metrics.jar /opt/opentelemetry-jmx-metrics.jar -# Id. de usuario no raíz (https://groups.google.com/g/distroless-users/c/-DpzCr7xRDY/m/eQqJmJroCgAJ) +# nonroot user id (https://groups.google.com/g/distroless-users/c/-DpzCr7xRDY/m/eQqJmJroCgAJ) ARG USER_UID=65532 RUN chown ${USER_UID} /opt/opentelemetry-jmx-metrics.jar @@ -133,12 +129,13 @@ ENTRYPOINT ["/otelcol-contrib"] CMD ["--config", "/etc/otelcol-contrib/config.yaml"] ``` -Añade las siguientes líneas a `values.yaml`: +Agregue las siguientes líneas a `values.yaml`: + ```yaml mode: deployment ``` -Añade lo siguiente en la configuración de Collector: +Agregue lo siguiente en la configuración del Collector: ```yaml receivers: @@ -164,20 +161,22 @@ receivers: {{< /tabs >}} -## Recopilador de métricas de JMX +## JMX Metrics Gatherer {#jmx-metrics-gatherer} {{< tabs >}} -{{% tab "Host" %}} +{{% tab "Servidor" %}} + +El JMX Metrics Gatherer está diseñado para ejecutarse como un uber jar y configurarse con propiedades desde la línea de comandos. -El Recopilador de métricas de JMX está pensado para ser ejecutado como un uber jar y está configurado con propiedades desde la línea de comandos. +Asegúrese de que JRE esté disponible en el servidor en el que está ejecutando el recopilador. Si no, asegúrese de descargarlo, por ejemplo. -Asegúrate de que JRE está disponible en el host en el que estás ejecutando el recopilador. Si no es así, asegúrate de descargarlo, por ejemplo. ``` apt-get update && \ apt-get -y install default-jre-headless ``` -Una vez hecho esto, descarga la versión más reciente del JAR del Recopilador de métricas de JMX [aquí][1] y ejecútala: +Una vez que haya hecho esto, descargue la versión más reciente del JMX Metrics Gatherer JAR [aquí][1] y ejecute: + ``` // Kafka Broker java -jar -Dotel.jmx.service.url=service:jmx:rmi:///jndi/rmi://{KAFKA_BROKER_JMX_ADDRESS}/jmxrmi \ -Dotel.jmx.target.system=kafka,jvm \ @@ -204,18 +203,19 @@ java -jar -Dotel.jmx.service.url=service:jmx:rmi:///jndi/rmi://{KAFKA_CONSUMER_J {{% tab "Kubernetes" %}} -El Recopilador de métricas de JMX está pensado para ser ejecutado como un uber jar y está configurado con propiedades desde la línea de comandos. +El JMX Metrics Gatherer está diseñado para ejecutarse como un uber jar y configurarse con propiedades desde la línea de comandos. -Para desplegar esto en Kubernetes, necesitas crear una imagen que contenga JRE y el JAR del Recopilador de métricas de JMX. Consulta el Dockerfile a continuación para ver una imagen de ejemplo que contiene JRE y el JAR del Recopilador de métricas de JMX. +Para implementar esto en Kubernetes, necesita crear una imagen que contenga JRE y el JAR del JMX Metrics Gatherer. Consulte el Dockerfile a continuación para ver un ejemplo de una imagen que contiene JRE y el JAR del JMX Metrics Gatherer. Dockerfile: + ```Dockerfile FROM alpine:latest as prep -# JAR del Recopilador de métricas de JMX +# JMX Metrics Gatherer Jar ARG JMX_GATHERER_JAR_VERSION=1.27.0 ADD https://github.com/open-telemetry/opentelemetry-java-contrib/releases/download/v${JMX_GATHERER_JAR_VERSION}/opentelemetry-jmx-metrics.jar /opt/opentelemetry-jmx-metrics.jar -# Id. de usuario no raíz (https://groups.google.com/g/distroless-users/c/-DpzCr7xRDY/m/eQqJmJroCgAJ) +# nonroot user id (https://groups.google.com/g/distroless-users/c/-DpzCr7xRDY/m/eQqJmJroCgAJ) ARG USER_UID=65532 RUN chown ${USER_UID} /opt/opentelemetry-jmx-metrics.jar @@ -236,11 +236,11 @@ CMD ["-Dotel.jmx.service.url=service:jmx:rmi:///jndi/rmi://kafka:1099/jmxrmi", \ {{< /tabs >}} -## APM +## Recopilación de registros {#log-collection} -Consulta [Recopilación de logs][4] para obtener instrucciones sobre cómo recopilar logs con OpenTelemetry Collector. +Consulte [Recopilación de registros][4] para obtener instrucciones sobre cómo recopilar registros utilizando el recopilador de OpenTelemetry. -Para que aparezca en el dashboard predefinido de Kafka, los logs de Kafka deben tener la etiqueta `source:kafka`. Para ello, utiliza un procesador de atributos: +Para aparecer en el Kafka Dashboard preconfigurado, los registros de Kafka deben estar etiquetados con `source:kafka`. Para hacer esto, utilice un procesador de atributos: ```yaml processors: @@ -251,19 +251,33 @@ processors: action: insert ``` -Para asegurarte de que este atributo solo se añade a tus logs de Kafka, utiliza [el filtro include/exclude][8] del procesador de atributos. +Para asegurarse de que este atributo solo se agregue a sus registros de Kafka, utilice el [filtrado de inclusión/exclusión][8] del procesador de atributos. + +## Datos recopilados {#data-collected} + +### Receptor de métricas de Kafka {#kafka-metrics-receiver-1} + +{{< mapping-table resource="kafkametrics.csv">}} + +### JMX Receiver / JMX Metrics Gatherer {#jmx-receiver-jmx-metrics-gatherer} + +#### Kafka broker {#kafka-broker} + +{{< mapping-table resource="kafka.csv">}} -## Datos recopilados +#### Kafka producer {#kafka-producer} -Consulta [asignación de métricas de OpenTelemetry][9] para obtener información sobre las métricas de Kafka recopiladas. +{{< mapping-table resource="kafka-producer.csv">}} +#### Kafka consumer {#kafka-consumer} +{{< mapping-table resource="kafka-consumer.csv">}} -## Ejemplo completo de configuración +**Nota:** En Datadog `-` se traduce como `_`. Por ejemplo, `kafka.producer.request-rate` se convierte en `kafka.producer.request_rate`. -Para ver un ejemplo completo de configuración en funcionamiento con el exportador de Datadog, consulta [`kafka.yaml`][5]. +Para ver la asignación completa entre los nombres de métricas de OpenTelemetry y Datadog, consulte [Asignación de métricas de OpenTelemetry][9]. -## Ejemplo de salida de registro +## Ejemplo de salida de registro {#example-logging-output} ``` Resource SchemaURL: https://opentelemetry.io/schemas/1.20.0 @@ -289,16 +303,15 @@ Timestamp: 2024-01-22 15:51:24.218 +0000 UTC Value: 25 ``` -## Ejemplo de aplicación +## Aplicación de ejemplo {#example-app} -Consulta el siguiente [ejemplo de aplicación][6] que demuestra las configuraciones que se abordan en esta documentación. Esta aplicación de ejemplo está compuesta por un productor, un consumidor, un broker y una instancia de zookeeper. Demuestra el uso del receptor de métricas de Kafka, el receptor de JMX o el Recopilador de métricas de JMX. +Consulte la siguiente [aplicación de ejemplo][6] que demuestra las configuraciones analizadas en esta documentación. Esta aplicación de ejemplo se compone de una instancia de Kafka producer, Kafka consumer, Kafka broker y zookeeper. Demuestra el uso del Kafka metrics receiver, del JMX Receiver y/o del JMX Metrics Gatherer. [1]: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/kafkametricsreceiver [2]: https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/jmxreceiver [3]: https://github.com/open-telemetry/opentelemetry-java-contrib/blob/main/jmx-metrics [4]: /es/opentelemetry/collector_exporter/log_collection -[5]: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/exporter/datadogexporter/examples/kafka.yaml [6]: https://github.com/DataDog/opentelemetry-examples/tree/main/apps/kafka-metrics [7]: https://app.datadoghq.com/dash/integration/50/kafka-zookeeper-and-kafka-consumer-overview [8]: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/processor/attributesprocessor/README.md#includeexclude-filtering diff --git a/hugo/content/es/opentelemetry/setup/otlp_ingest/traces.md b/hugo/content/es/opentelemetry/setup/otlp_ingest/traces.md new file mode 100644 index 00000000000..90d4c65d06f --- /dev/null +++ b/hugo/content/es/opentelemetry/setup/otlp_ingest/traces.md @@ -0,0 +1,238 @@ +--- +aliases: +- /es/opentelemetry/otlp_endpoint +- /es/opentelemetry/setup/intake_endpoint/otlp_traces +- /es/opentelemetry/setup/agentless/traces +further_reading: +- link: https://opentelemetry.io/docs/concepts/sdk-configuration/general-sdk-configuration/ + tag: Sitio externo + text: Configuración general del SDK de OpenTelemetry +- link: https://opentelemetry.io/docs/reference/specification/sdk-environment-variables/ + tag: Sitio externo + text: Especificación de variables de entorno de OpenTelemetry +- link: 'https://opentelemetry.io/docs/reference/specification/protocol/exporter/ ' + tag: Sitio externo + text: Exportador del protocolo OpenTelemetry +title: Punto de conexión de ingesta de trazas OTLP de Datadog +--- +## Descripción general {#overview} + +El punto de conexión de la API de ingesta de trazas del protocolo OpenTelemetry (OTLP) de Datadog permite que las aplicaciones, las plataformas administradas y los colectores de OpenTelemetry envíen trazas a Datadog a través de OTLP HTTP. + +Utilice la configuración directa en esta página cuando necesite enviar trazas sin el [Datadog Agent][2] o un colector de OpenTelemetry. Para implementaciones de colector en producción, utilice [Configurar el colector de OpenTelemetry][1]. + +Para cargas de trabajo Serverless, consulte [OTLP Intake for Serverless][8]. Para plataformas administradas como Cloudflare, Vercel y Heroku, consulte [Ingesta OTLP para plataformas administradas][9]. + +
El punto de conexión de ingesta de trazas OTLP admite http/protobuf y http/json codificación. grpc no es compatible.
+ +## Configuración {#configuration} + +Para exportar datos OTLP al punto de conexión de ingesta de trazas OTLP de Datadog: + +1. [Configure el exportador OTLP HTTP Protobuf](#configure-the-exporter). + - Establezca el punto de conexión de ingesta de trazas OTLP de Datadog. + - Configure los encabezados HTTP requeridos. +1. (Opcional) [Establezca el `dd-otel-span-mapping`encabezado HTTP](#optional-map-or-filter-span-names) para asignar o filtrar tramos. + +### Configure el exportador {#configure-the-exporter} + +Para enviar datos OTLP al punto de conexión de ingesta de trazas OTLP de Datadog, necesita usar el exportador OTLP HTTP Protobuf. El proceso difiere dependiendo de si está utilizando instrumentación automática o manual para OpenTelemetry. + +Las [métricas de traza][7] no se calculan de forma predeterminada para las trazas enviadas directamente al punto de conexión de ingesta de trazas OTLP de Datadog. Los siguientes ejemplos incluyen `compute_stats=true` para habilitar las métricas de traza. + +#### Instrumentación automática {#automatic-instrumentation} + +Si está utilizando [instrumentación automática de OpenTelemetry][3], establezca las siguientes variables de entorno: + +```shell +export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf" +export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="{{< region-param key="otlp_trace_endpoint" >}}" +export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},compute_stats=true" +``` + +#### Instrumentación manual {#manual-instrumentation} + +Si está utilizando instrumentación manual con SDK de OpenTelemetry, configure el exportador OTLP HTTP Protobuf mediante programación. + +
Según su sitio de Datadog, que es {{< region-param key=dd_datacenter code="true" >}}, reemplace ${YOUR_ENDPOINT} con {{< region-param key="otlp_trace_endpoint" code="true" >}}.
+ +{{< tabs >}} +{{% tab "JavaScript" %}} + +El exportador de JavaScript es [`exporter-trace-otlp-proto`][100]. Para configurar el exportador, utilice el siguiente fragmento de código: + +```javascript +const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-proto'); // OTLP http/protobuf exporter + +const exporter = new OTLPTraceExporter({ + url: '${YOUR_ENDPOINT}', // Replace this with the correct endpoint + headers: { + 'dd-api-key': process.env.DD_API_KEY, + 'dd-otel-span-mapping': '{span_name_as_resource_name: true}', + 'compute_stats': 'true', + }, +}); +``` +[100]: https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-proto + +{{% /tab %}} + +{{% tab "Java" %}} + +El exportador de Java es [`OtlpHttpSpanExporter`][200]. Para configurar el exportador, utilice el siguiente fragmento de código: + +```java +import io.opentelemetry.exporter.otlp.http.trace.OtlpHttpSpanExporter; + +OtlpHttpSpanExporter exporter = OtlpHttpSpanExporter.builder() + .setEndpoint("${YOUR_ENDPOINT}") // Replace this with the correct endpoint + .addHeader("dd-api-key", System.getenv("DD_API_KEY")) + .addHeader("dd-otel-span-mapping", "{span_name_as_resource_name: true}") + .addHeader("compute_stats", "true") + .build(); +``` + +[200]: https://javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-otlp-http-trace/ + +{{% /tab %}} +{{% tab "Go" %}} + +El exportador de Go es [`otlptracehttp`][300]. Para configurar el exportador, utilice el siguiente fragmento de código: + +```go +import "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp" + +traceExporter, err := otlptracehttp.New( + ctx, + otlptracehttp.WithEndpoint("${YOUR_ENDPOINT}"), // Replace this with the correct endpoint + otlptracehttp.WithURLPath("/v1/traces"), + otlptracehttp.WithHeaders( + map[string]string{ + "dd-api-key": os.Getenv("DD_API_KEY"), + "dd-otel-span-mapping": "{span_name_as_resource_name: true}", + "compute_stats": "true", + }), +) +``` + +[300]: http://go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp + +{{% /tab %}} +{{% tab "Python" %}} + +El exportador de Python es [`OTLPSpanExporter`][400]. Para configurar el exportador, utilice el siguiente fragmento de código: + +```python +from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter + +exporter = OTLPSpanExporter( + endpoint="${YOUR_ENDPOINT}", # Replace this with the correct endpoint + headers={ + "dd-api-key": os.environ.get("DD_API_KEY"), + "dd-otel-span-mapping": "{span_name_as_resource_name: true}", + "compute_stats": "true", + }, +) +``` + +[400]: https://pypi.org/project/opentelemetry-exporter-otlp-proto-http/ + +{{% /tab %}} +{{< /tabs >}} + +### (Opcional) Asigne o filtre nombres de tramos {#optional-map-or-filter-span-names} + +Utilice el encabezado `dd-otel-span-mapping` para configurar la asignación y el filtrado de tramos. El encabezado JSON contiene los siguientes campos: + +- `ignore_resources`: Una lista de expresiones regulares para deshabilitar trazas según su nombre de recurso. +- `span_name_remappings`: Un mapa de nombres de tramos de Datadog a nombres preferidos. +- `span_name_as_resource_name`: Especifica si se debe usar el nombre del tramo de OpenTelemetry como el nombre de la operación del tramo de Datadog (predeterminado: true). Si es false, el nombre de la operación se deriva de una combinación del nombre del contexto de instrumentación y el tipo de tramo. + +Por ejemplo: + +```json +{ + "span_name_as_resource_name":false, + "span_name_remappings":{ + "io.opentelemetry.javaagent.spring.client":"spring.client" + }, + "ignore_resources":[ + "io.opentelemetry.javaagent.spring.internal" + ] +} +``` +## OpenTelemetry Collector {#opentelemetry-collector} + +Configure la [configuración recomendada de OpenTelemetry Collector][10] para exportar trazas a este punto de conexión y generar métricas de traza de APM antes del muestreo. + +## Solución de problemas {#troubleshooting} + +### Error: 403 Forbidden {#error-403-forbidden} + +Si recibe un error `403 Forbidden` al enviar trazas al punto de conexión de ingesta de trazas OTLP de Datadog, verifique que el punto de conexión coincida con su sitio de Datadog. Su sitio es {{< region-param key=dd_datacenter code="true" >}}, así que use el {{< region-param key="otlp_trace_endpoint" code="true" >}} punto de conexión. + +### Error: 413 Request Entity Too Large {#error-413-request-entity-too-large} + +Si recibe un error `413 Request Entity Too Large` al enviar trazas al punto de conexión de ingesta de trazas OTLP de Datadog, indica que el tamaño de la carga útil enviada por el exportador OTLP excede el límite de 15 MiB (sin comprimir) del punto de conexión de ingesta de trazas de Datadog. + +Este error generalmente ocurre cuando el SDK de OpenTelemetry agrupa demasiados datos de telemetría en una sola carga útil de solicitud. + +**Solución**: Reduzca el tamaño del lote de exportación del procesador de tramos por lotes del SDK. Aquí hay un ejemplo de cómo modificar el `BatchSpanProcessorBuilder` en el SDK de Java de OpenTelemetry: + +```java +CopyBatchSpanProcessor batchSpanProcessor = + BatchSpanProcessor + .builder(exporter) + .setMaxExportBatchSize(10) // Default is 512 + .build(); +``` +Ajuste el valor de `setMaxExportBatchSize` según sus necesidades. Un valor más pequeño resulta en exportaciones más frecuentes con cargas útiles más pequeñas, lo que reduce la probabilidad de exceder el límite de 15 MiB. + +### Advertencia: \"traces export: failed … 202 Accepted\" en Go {#warning-traces-export-failed-202-accepted-in-go} + + +Si está utilizando el SDK de Go de OpenTelemetry y ve un mensaje de advertencia similar a `traces export: failed … 202 Accepted`, se debe a un problema conocido en el exportador HTTP OTLP de OpenTelemetry para Go. + +El exportador HTTP OTLP de OpenTelemetry para Go trata cualquier código de estado HTTP que no sea 200 como un error, incluso si la exportación tiene éxito ([Issue 3706][5]). En contraste, otros SDK de OpenTelemetry consideran cualquier código de estado en el rango [200, 300) como un éxito. El punto de conexión de ingesta de trazas OTLP de Datadog devuelve un código de estado `202 Accepted` para las exportaciones exitosas. + +La comunidad de OpenTelemetry aún está discutiendo si otros códigos de estado `2xx` deben tratarse como éxitos ([Issue 3203][6]). + +**Solución**: Si está utilizando el punto de conexión de ingesta de trazas OTLP de Datadog con el SDK de OpenTelemetry para Go, puede ignorar este mensaje de advertencia de forma segura. Sus trazas se están exportando correctamente a pesar de la advertencia. + +### Problema: Nombres de operación de tramo inesperados {#issue-unexpected-span-operation-names} + +Al utilizar el punto de conexión de ingesta de trazas OTLP de Datadog, es posible que note que los nombres de las operaciones de tramo son diferentes a los generados al utilizar el Datadog Agent o el OpenTelemetry Collector. + +El punto de conexión de ingesta de trazas OTLP de Datadog tiene la opción `span_name_as_resource_name` establecida en `true` de forma predeterminada. Esto significa que Datadog utiliza el nombre del tramo de OpenTelemetry como nombre de la operación. Por el contrario, el Datadog Agent y el OpenTelemetry Collector tienen esta opción establecida en `false` de forma predeterminada. + +Cuando `span_name_as_resource_name` se establece en `false`, el nombre de la operación se deriva de una combinación del nombre del contexto de instrumentación y el tipo de tramo. Por ejemplo, un nombre de operación podría aparecer como `opentelemetry.client`. + +**Solución**: Si desea deshabilitar la opción `span_name_as_resource_name` en el punto de conexión de ingesta de trazas OTLP de Datadog para que coincida con el comportamiento del Datadog Agent o del OpenTelemetry Collector, siga estos pasos: + +1. Consulte [Asignar o filtrar nombres de tramo](#optional-map-or-filter-span-names) en este documento. +1. Establezca la opción `span_name_as_resource_name` en `false` en el encabezado `dd-otel-span-mapping`. + +Por ejemplo: + +```json +jsonCopy{ + "span_name_as_resource_name": false, + ... +} +``` + +Esto garantiza que los nombres de las operaciones de tramo sean consistentes en el punto de conexión de ingesta de trazas OTLP de Datadog, el Datadog Agent y el OpenTelemetry Collector. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/opentelemetry/collector_exporter/ +[2]: /es/opentelemetry/otlp_ingest_in_the_agent/ +[3]: https://opentelemetry.io/docs/specs/otel/glossary/#automatic-instrumentation +[5]: https://github.com/open-telemetry/opentelemetry-go/issues/3706 +[6]: https://github.com/open-telemetry/opentelemetry-specification/issues/3203 +[7]: /es/tracing/metrics/ +[8]: /es/opentelemetry/setup/otlp_ingest/serverless/ +[9]: /es/opentelemetry/setup/otlp_ingest/managed_platforms/ +[10]: /es/opentelemetry/setup/collector_exporter/ \ No newline at end of file diff --git a/hugo/content/es/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md b/hugo/content/es/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md new file mode 100644 index 00000000000..74903067350 --- /dev/null +++ b/hugo/content/es/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md @@ -0,0 +1,134 @@ +--- +algolia: + tags: + - source maps + - build plugins + - error tracking +description: Cargue automáticamente los mapas del código fuente de JavaScript a Datadog + durante el tiempo de compilación para desofuscar los seguimientos de pila en Error + Tracking y RUM. +further_reading: +- link: /real_user_monitoring/guide/upload-javascript-source-maps + tag: Documentación + text: Cargar mapas del código fuente de JavaScript (método manual) +- link: /real_user_monitoring/error_tracking + tag: Documentación + text: Error Tracking +- link: https://github.com/DataDog/build-plugins + tag: Código fuente + text: Repositorio de GitHub de complementos de compilación de Datadog +title: Mapas del código fuente +--- +## Descripción general {#overview} + +El complemento de compilación de mapas del código fuente carga automáticamente los mapas del código fuente de JavaScript a Datadog durante su compilación, lo que permite desofuscar los seguimientos de pila en [Error Tracking][1] y [RUM][2]. Esto reemplaza la necesidad de ejecutar manualmente `datadog-ci sourcemaps upload` o configurar tuberías de CI/CD para las cargas de mapas del código fuente. + +El complemento se conecta al proceso de compilación, descubre todos los archivos `.js` con los archivos de mapa del código fuente `.map` correspondientes de la salida de compilación y los carga a Datadog con metadatos de git. Puede asociar mapas del código fuente con eventos por ID de depuración o por servicio y versión. + +## Requisitos previos {#prerequisites} + +- Una clave de Datadog API, configurada con `auth.apiKey` o la variable de entorno `DATADOG_API_KEY`. +- Mapas del código fuente habilitados en la configuración de su empaquetador. El complemento carga los mapas del código fuente pero no los genera. Consulte [Upload JavaScript Source Maps][3] para la configuración de generación de mapas del código fuente específica del empaquetador. +- Para cargas por ID de depuración, habilite la inyección de ID de depuración en el complemento de compilación. +- Para cargas por servicio y versión, inicialice el SDK de RUM con los parámetros `service` y `version` que coincidan con la configuración del complemento. +- El complemento de compilación de Datadog instalado y registrado en su empaquetador. Consulte [Build Plugins][4] para obtener instrucciones de instalación. + +## Configuración {#configuration} + +Las siguientes variables de entorno anulan los valores de configuración: + +- `DATADOG_SITE` o `DD_SITE`: Anula `auth.site` para la URL de ingesta. +- `DATADOG_SOURCEMAP_INTAKE_URL`: Anula directamente la URL de ingesta completa. + +Elija un método de coincidencia para la carga de mapas del código fuente: ID de depuración o servicio y versión. Estos métodos de carga son mutuamente excluyentes. + +{{< tabs >}} +{{% tab "ID de depuración (Recomendado)" %}} + +Los ID de depuración asocian cada paquete de JavaScript con su mapa del código fuente sin depender de la URL del paquete, el servicio o la versión. Utilice este método para nuevas configuraciones. + +La compatibilidad con ID de depuración requiere [Datadog Build Plugins versión 3.3.0](https://github.com/DataDog/build-plugins/releases/tag/v3.3.0) o posterior. + +Configure las siguientes opciones en `sourcemaps`: + +| Parámetro | Tipo | Requerido | Predeterminado | Descripción | +|-----------|------|----------|---------|-------------| +| `debugId` | Booleano | Sí | Ninguno | Establezca en `true` para inyectar un ID de depuración en cada paquete de JavaScript. | +| `upload` | Booleano | Sí, para cargar | `false` | Establezca en `true` para cargar mapas del código fuente durante la compilación. Si se omite, el complemento solo inyecta ID de depuración. | +| `bailOnError` | Booleano | No | `false` | Si `true`, la compilación falla cuando ocurre un error de carga de mapa del código fuente. | +| `dryRun` | Booleano | No | `false` | Si `true`, el complemento ejecuta el proceso de carga sin enviar datos a Datadog. Utilice esto para verificar su configuración. | +| `maxConcurrency` | Número | No | `20` | Número máximo de cargas simultáneas de mapas del código fuente. | + +Establezca `debugId` y `upload` en `true` para inyectar ID de depuración y cargar mapas del código fuente durante la compilación: + +```javascript +const { datadogWebpackPlugin } = require('@datadog/webpack-plugin'); + +module.exports = { + plugins: [ + datadogWebpackPlugin({ + auth: { + apiKey: process.env.DATADOG_API_KEY, + site: 'datadoghq.com', // Optional: defaults to datadoghq.com + }, + sourcemaps: { + debugId: true, + upload: true, + }, + }), + ], +}; +``` + +{{% /tab %}} +{{% tab "Servicio y versión" %}} + +Configure el objeto `errorTracking.sourcemaps` para cargar mapas del código fuente utilizando la coincidencia de servicio y versión: + +| Parámetro | Tipo | Requerido | Predeterminado | Descripción | +|-----------|------|----------|---------|-------------| +| `service` | Cadena | Sí | Ninguno | Nombre del servicio. Debe coincidir con el parámetro de inicialización `service` del SDK de RUM. | +| `releaseVersion` | Cadena | Sí, a menos que `metadata.version` esté configurado | Ninguno | Versión de lanzamiento. Debe coincidir con el parámetro de inicialización `version` del SDK de RUM. | +| `minifiedPathPrefix` | Cadena | Sí | Ninguno | URL o prefijo de ruta relativo a la raíz donde se sirven sus archivos JavaScript minificados. Por ejemplo, `https://example.com/static/` o `/static/`. | +| `bailOnError` | Booleano | No | `false` | Si `true`, la compilación falla cuando ocurre un error de carga de mapa del código fuente. | +| `dryRun` | Booleano | No | `false` | Si `true`, el complemento ejecuta el proceso de carga sin enviar datos a Datadog. Utilice esto para verificar su configuración. | +| `maxConcurrency` | Número | No | `20` | Número máximo de cargas simultáneas de mapas del código fuente. | + +```javascript +const { datadogWebpackPlugin } = require('@datadog/webpack-plugin'); + +module.exports = { + plugins: [ + datadogWebpackPlugin({ + auth: { + apiKey: process.env.DATADOG_API_KEY, + site: 'datadoghq.com', // Optional: defaults to datadoghq.com + }, + errorTracking: { + sourcemaps: { + service: 'my-application', + releaseVersion: '1.0.0', + minifiedPathPrefix: 'https://example.com/static/', + }, + }, + }), + ], +}; +``` + +Para mostrar también el código fuente en línea en los seguimientos de pila de Error Tracking, combine las cargas de mapas del código fuente de servicio y versión con el complemento [Source Code Context][5]. + +{{% /tab %}} +{{< /tabs >}} + +
Estos ejemplos utilizan webpack. El objeto de configuración es idéntico en todos los empaquetadores compatibles. Solo difieren la importación y el nombre de la función del complemento. Consulte Build Plugins para obtener instrucciones de instalación para su empaquetador.
+ +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/real_user_monitoring/error_tracking +[2]: /es/real_user_monitoring/ +[3]: /es/real_user_monitoring/guide/upload-javascript-source-maps#instrument-your-code +[4]: /es/real_user_monitoring/application_monitoring/browser/build_plugins/ +[5]: /es/real_user_monitoring/application_monitoring/browser/build_plugins/source_code_context \ No newline at end of file diff --git a/hugo/content/es/real_user_monitoring/guide/enable-rum-shopify-store.md b/hugo/content/es/real_user_monitoring/guide/enable-rum-shopify-store.md index 7e4164970ac..714a4e74de5 100644 --- a/hugo/content/es/real_user_monitoring/guide/enable-rum-shopify-store.md +++ b/hugo/content/es/real_user_monitoring/guide/enable-rum-shopify-store.md @@ -1,69 +1,74 @@ --- +description: Configure el monitoreo de RUM en tiendas Shopify para realizar un seguimiento + de las interacciones de los clientes, el rendimiento y las tasas de conversión para + la optimización del comercio electrónico. further_reading: - link: /real_user_monitoring/guide/rum-for-product-analytics/ tag: Documentación - text: Uso de RUM y Session Replay para el análisis de productos + text: Utilice RUM y Session Replay para Product Analytics - link: /real_user_monitoring/guide/alerting-with-conversion-rates/ tag: Documentación - text: Generación de alertas con tasas de conversión -title: Habilitación de RUM en tu tienda Shopify + text: Alerting con tasas de conversión +private: true +title: Habilite RUM en su tienda Shopify --- +
+Checkout Extensibility de Shopify no es compatible con el seguimiento de RUM. Si esta función es fundamental para las necesidades de su negocio, cree un ticket con Soporte de Datadog. +
-## Información general +## Descripción general {#overview} -Comprender cómo interactúan los clientes con tus páginas web es esencial para el éxito de tu tienda en línea. +Comprender cómo interactúan los clientes con sus páginas web es crucial para el éxito de su tienda en línea. -Esta guía te explica cómo puedes configurar Real User Monitoring en tu tienda con tecnología Shopify. +Esta guía explica cómo puede configurar Real User Monitoring en su tienda impulsada por Shopify. -## Configuración +## Configuración {#setup} -1. Inicia sesión en tu panel de administración de Shopify. -2. En **Canales de venta**, haz clic en **Tienda en línea**. +1. Inicie sesión en su panel de administración de Shopify. +2. En {{< ui >}}Sales channels{{< /ui >}}, haga clic en {{< ui >}}Online Store{{< /ui >}}. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-1.png" alt="Habilitar RUM en tu tienda Shopify" style="width:30%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-1.png" alt="Habilite RUM en su tienda Shopify" style="width:30%;">}} -3. Esto abre un nuevo menú. Allí haz clic en **Temas**. +3. Esto abre un nuevo menú, haga clic en {{< ui >}}Themes{{< /ui >}}. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-2.png" alt="Habilitar RUM en tu tienda Shopify" style="width:30%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-2.png" alt="Habilite RUM en su tienda Shopify" style="width:30%;">}} -4. Haz clic en el botón **Editar código** de tu tema actual. +4. Haga clic en el botón {{< ui >}}Edit code{{< /ui >}} para su tema actual. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-3.png" alt="Habilitar RUM en tu tienda Shopify" >}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-3.png" alt="Habilite RUM en su tienda Shopify" >}} -5. En el directorio **Diseño**, busca el archivo principal de tu tema **theme.liquid**. Haz clic en el archivo para editarlo. +5. En el directorio {{< ui >}}Layout{{< /ui >}}, busque el archivo principal de su tema `theme.liquid`. Haga clic en el archivo para editarlo. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-4.png" alt="Habilitar RUM en tu tienda Shopify" style="width:30%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-4.png" alt="Habilite RUM en su tienda Shopify" style="width:30%;">}} -6. Inicializa el SDK del Navegador RUM añadiendo el fragmento de código SDK en la etiqueta (tag) ``. Para ver más información sobre qué método de instalación elegir, consulta la [documentación de monitorización del Navegador RUM][1]. +6. Inicialice el Browser RUM SDK agregando el fragmento de código del SDK dentro de la etiqueta ``. Para obtener más información sobre qué método de instalación elegir, consulte la [RUM Browser Monitoring documentation][1]. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-5.png" alt="Habilitar RUM en tu tienda Shopify" >}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-5.png" alt="Habilite RUM en su tienda Shopify" >}} -7. Haz clic en el botón **Guardar** para guardar los cambios. +7. Haga clic en el botón {{< ui >}}Save{{< /ui >}} para guardar sus cambios. -El aspecto actualizado en la interfaz de usuario de Shopify es el siguiente: +La actualización se ve de la siguiente manera en la interfaz de usuario de Shopify: - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-6.png" alt="Habilitar RUM en tu tienda Shopify" style="width:50%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-6.png" alt="Habilite RUM en su tienda Shopify" style="width:50%;">}} -Para ver más información sobre la edición de códigos de temas, consulta la [documentación de Shopify][2]. +Consulte más información sobre la edición del código del tema en la [documentación de Shopify][2]. -## Para empezar a explorar +## Comience a explorar {#start-exploring} -Una vez que hayas inicializado el SDK del Navegador RUM, puedes empezar a utilizar Real User Monitoring con tu tienda Shopify. +Una vez que haya inicializado el Browser RUM SDK, puede comenzar a usar Real User Monitoring con su tienda Shopify. -Por ejemplo, podrás: +Por ejemplo, puede: -- Obtener información valiosa sobre el comportamiento de tus clientes -tomando decisiones basadas en datos para mejorar tu tienda -- Aumentar la conversión viendo las sesiones enriquecidas de grabaciones del navegador utilizando [Session Replay][3] -- Utilizar el [análisis de embudo][4] para comprender mejor el recorrido del cliente o -- [Generar métricas][5] a partir de esas sesiones recién capturadas. +- Obtenga información valiosa sobre el comportamiento de sus clientes al +tomar decisiones basadas en datos para mejorar su tienda +- Aumente la conversión observando sesiones enriquecidas con grabaciones del navegador mediante [Session Replay][3] +- [Genere métricas][5] a partir de sesiones recién capturadas -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} -[1]: /es/real_user_monitoring/browser/setup/#choose-the-right-installation-method/ +[1]: /es/real_user_monitoring/application_monitoring/browser/setup/#choose-the-right-installation-method/ [2]: https://help.shopify.com/en/manual/online-store/themes/theme-structure/extend/edit-theme-code -[3]: /es/real_user_monitoring/session_replay/browser/ -[4]: /es/product_analytics/journeys/funnel_analysis +[3]: /es/session_replay/ [5]: /es/real_user_monitoring/platform/generate_metrics/ \ No newline at end of file diff --git a/hugo/content/es/real_user_monitoring/guide/investigate-zendesk-tickets-with-session-replay.md b/hugo/content/es/real_user_monitoring/guide/investigate-zendesk-tickets-with-session-replay.md index eb58f6760aa..e3bd6d516bb 100644 --- a/hugo/content/es/real_user_monitoring/guide/investigate-zendesk-tickets-with-session-replay.md +++ b/hugo/content/es/real_user_monitoring/guide/investigate-zendesk-tickets-with-session-replay.md @@ -1,38 +1,40 @@ --- -title: Investigar tickets de Zendesk con Session Replay +description: Integre Session Replay con Zendesk para ayudar a los equipos de soporte + a solucionar problemas de los usuarios viendo las Session Replay directamente desde + los tickets. +title: Investigue tickets de Zendesk con Session Replay --- +## Descripción general {#overview} -## Información general +Al solucionar problemas reportados por los usuarios en tickets de Zendesk, los ingenieros a menudo tienen dificultades para entender el contexto en el que ocurrió el problema. Con la integración de Zendesk y Session Replay, los equipos de soporte pueden reproducir inmediatamente el contexto del usuario desde un ticket de Zendesk con un solo clic. Esto permite a los equipos de soporte solucionar problemas de manera más eficiente y reduce el tiempo necesario para brindar soluciones a los clientes. -Al solucionar los problemas informados por los usuarios en los tickets de Zendesk, los ingenieros a menudo se esfuerzan por entender el contexto en el que se produjo el problema. Gracias a la integración de Zendesk y Session Replay, los equipos de asistencia pueden reproducir inmediatamente el contexto del usuario a partir de un ticket de Zendesk con un solo clic. Esto permite a los equipos de asistencia solucionar los problemas con más eficacia y reduce el tiempo que se tarda en ofrecer soluciones a los clientes. +Con esta integración, los ingenieros de soporte pueden: +- Ver una [Session Replay][3] de las acciones del usuario +- Examinar llamadas de backend relacionadas +- Organizar Session Replay relacionadas en una lista de reproducción -Gracias a esta integración, los ingenieros de soporte pueden: -- Ver un vídeo de [Session Replay][3] de las acciones del usuario -- Examinar las llamadas al backend relacionadas -- Organizar los vídeos de Session Replay relacionados en una lista de reproducción +## Configuración {#setup} -## Configuración +Para configurar la integración de Zendesk, complete la sección **Cómo instalar** de la [página de Zendesk Marketplace para Datadog RUM][2]. -Para configurar la integración Zendesk, completa la sección **Cómo instalar** de la [página de Zendesk Marketplace para RUM Datadog][2]. +## Explore una Session Replay desde Zendesk {#explore-a-session-replay-from-zendesk} -## Explorar un vídeo de Session Replay de Zendesk +Para visualizar las Session Replay asociadas con un ticket de Zendesk: -Para ver las repeticiones de sesiones asociadas a un ticket de Zendesk: +1. Navegue hasta el ticket en Zendesk. +2. Haga clic en el icono de Datadog en la barra lateral derecha para visualizar una lista de Session Replay. +3. Haga clic en una Session Replay para visualizarla en Datadog. -1. Ve al ticket en Zendesk. -2. Haz clic en el icono Datadog de la barra lateral derecha para ver una lista de las repeticiones de sesiones. -3. Haz clic en la repetición de una sesión para verla en Datadog. +{{< img src="real_user_monitoring/guide/zendesk/zendesk-sr-demo.mp4" alt="Acceso a una Session Replay desde Zendesk" video=true >}} -{{< img src="real_user_monitoring/guide/zendesk/zendesk-sr-demo.mp4" alt="Acceder a una repetición de sesión de Zendesk" video=true >}} +Desde la página de Session Replay, puede visualizar una lista de las acciones del usuario, junto con las llamadas de backend asociadas con cada acción. Pase el cursor sobre un evento y haga clic en {{< ui >}}Details{{< /ui >}} para visualizar los traces, errores y más información asociados. -En la página de repetición, puedes ver una lista de las acciones del usuario, junto con las llamadas del backend asociadas a cada acción. Pasa el ratón sobre un evento y haz clic en **Detalles** para ver las trazas (traces), los errores y otros datos asociados. +{{< img src="real_user_monitoring/guide/zendesk/session-replay-details-button.png" alt="Vista al pasar el cursor sobre un evento de Session Replay con el botón Detalles resaltado." style="width:60%;" >}} -{{< img src="real_user_monitoring/guide/zendesk/session-replay-details-button.png" alt="Vista superior de un evento de repetición de sesión con el botón Detalles resaltado" style="width:60%;" >}} - -También puedes añadir la repetición a una lista de reproducción para agrupar las incidencias relacionadas y facilitar la navegación y el uso compartido. Para obtener más información, consulta la [documentación sobre listas de reproducción de Session Replay][4]. +También puede agregar la Session Replay a una lista de reproducción para agrupar problemas relacionados y facilitar su exploración y uso compartido. Para obtener más información, consulte la [documentación de listas de reproducción de Session Replay][4]. [1]: /es/integrations/zendesk/#zendesk-rum-app-installation [2]: https://www.zendesk.com/sg/marketplace/apps/support/993138/datadog-rum/?queryID=fb54e1e367559c15de7e8a0f1eb8aa6f -[3]: /es/real_user_monitoring/session_replay/browser/ -[4]: /es/real_user_monitoring/session_replay/playlists \ No newline at end of file +[3]: /es/session_replay/ +[4]: /es/session_replay/playlists \ No newline at end of file diff --git a/hugo/content/es/real_user_monitoring/guide/mobile-sdk-upgrade.md b/hugo/content/es/real_user_monitoring/guide/mobile-sdk-upgrade.md index d527e10e874..a6f2cd86dbf 100644 --- a/hugo/content/es/real_user_monitoring/guide/mobile-sdk-upgrade.md +++ b/hugo/content/es/real_user_monitoring/guide/mobile-sdk-upgrade.md @@ -1,40 +1,563 @@ --- +description: Guía de migración para actualizar entre versiones principales de los + SDK móviles de RUM, Logs y Trace con cambios incompatibles y nuevas funciones. further_reading: - link: /real_user_monitoring/explorer tag: Documentación - text: Visualiza tus datos RUM en el Explorer + text: Visualice sus datos de RUM en el explorador - link: /real_user_monitoring/guide/mobile-sdk-deprecation-policy tag: Documentación - text: Política de obsolescencia para los SDKs móviles de Datadog -title: Actualizar los SDKs móviles de RUM + text: Política de desaprobación para los SDK móviles de Datadog +title: Actualizar los SDK móviles de RUM --- +## Descripción general {#overview} -## Información general +Siga esta guía para migrar entre versiones principales de los SDK móviles de RUM, Logs y Trace. Consulte la documentación de cada SDK para obtener detalles sobre sus funciones y capacidades. -Sigue esta guía para migrar entre las principales versiones de los SDKs móviles de RUM, SDKs de logs y SDKs de trazas (traces). Consulta la documentación de cada SDK para obtener información detallada sobre sus características y capacidades. -## De v1 a v2 +**Migraciones más comunes**: +- [**v2 a v3**](#from-v2-to-v3): enfoque en la eliminación de Open Tracing y actualizaciones de API +- [**v1 a v2**](#from-v1-to-v2): cambios arquitectónicos importantes hacia un diseño modular + +## De la v2 a la v3 {#from-v2-to-v3} +{{< tabs >}} +{{% tab "Android" %}} + +La transición de la versión 2 a la versión 3 se centra en eliminar el soporte para el proyecto heredado Open Tracing, mejorando la estabilidad y la consistencia del SDK. + +{{% /tab %}} + +{{% tab "iOS" %}} + +La migración de la v2 a la v3 se centra en optimizar los módulos, refinar los valores predeterminados y mejorar la confiabilidad en todas las funciones del producto. + +Todos los productos del SDK (RUM, Trace, Logs, Session Replay, y así sucesivamente) siguen siendo modulares y están separados en bibliotecas distintas. El cambio principal es que el módulo `DatadogObjc` ha sido eliminado, integrando su contenido en los módulos de producto correspondientes. + +{{% /tab %}} + +{{% tab "React Native" %}} + +La migración de la v2 a la v3 se centra en alinear la configuración con el comportamiento del SDK modular de la v3 y consolidar la propiedad de la configuración en `CoreConfiguration`, `RumConfiguration`, `LogsConfiguration` y `TraceConfiguration`. + +Lea [la guía MIGRATION.md][1] en el repositorio oficial de React Native para obtener la lista completa de cambios. + +
+Importante: A diferencia de la v2.x (que siempre habilitaba todos los módulos de funciones al inicializar el SDK), la v3 no inicializa ni habilita un módulo de funciones a menos que pase explícitamente la configuración para él. +
+ +[1]: https://github.com/DataDog/dd-sdk-reactnative/blob/develop/MIGRATION.md + +{{% /tab %}} +{{< /tabs >}} + +### Módulos {#modules} +{{< tabs >}} +{{% tab "Android" %}} + +
+Datadog sigue la política de versiones de la biblioteca AndroidX de Google para el AndroidX bibliotecas, por lo que el nivel mínimo de API de Android compatible con el SDK v3 es 23. +
+ +**Requisitos**: +- Se requiere Kotlin 1.9 +- La dependencia `Open Tracing` se eliminó porque es obsoleta + + +{{% /tab %}} + +{{% tab "iOS" %}} + +Las bibliotecas continúan modularizándose en la v3. Adopte las siguientes bibliotecas: + +- `DatadogCore` +- `DatadogCrashReporting` +- `DatadogLogs` +- `DatadogRUM` +- `DatadogSessionReplay` +- `DatadogTrace` +- `DatadogWebViewTracking` + +
+ SPM (Recomendado) + + ```swift +let package = Package( + ... + dependencies: [ + .package(url: "https://github.com/DataDog/dd-sdk-ios", from: "3.0.0") + ], + targets: [ + .target( + ... + dependencies: [ + .product(name: "DatadogCore", package: "dd-sdk-ios"), + .product(name: "DatadogCrashReporting", package: "dd-sdk-ios"), + .product(name: "DatadogLogs", package: "dd-sdk-ios"), + .product(name: "DatadogRUM", package: "dd-sdk-ios"), + .product(name: "DatadogSessionReplay", package: "dd-sdk-ios"), + .product(name: "DatadogTrace", package: "dd-sdk-ios"), + .product(name: "DatadogWebViewTracking", package: "dd-sdk-ios"), + ] + ), + ] +) + ``` + +
+ +
+ CocoaPods + + ```ruby + pod 'DatadogCore' + pod 'DatadogCrashReporting' + pod 'DatadogLogs' + pod 'DatadogRUM' + pod 'DatadogSessionReplay' + pod 'DatadogTrace' + pod 'DatadogWebViewTracking' + ``` +
+ +
+ Carthage + +El `Cartfile` permanece igual: + ``` + github "DataDog/dd-sdk-ios" + ``` + +En Xcode, **debe** vincular los siguientes frameworks: + ``` + DatadogInternal.xcframework + DatadogCore.xcframework + ``` + +Luego, puede seleccionar los módulos que desea utilizar: + ``` + DatadogCrashReporting.xcframework + DatadogLogs.xcframework + DatadogRUM.xcframework + DatadogSessionReplay.xcframework + DatadogTrace.xcframework + DatadogWebViewTracking.xcframework + ``` +
+ +{{% /tab %}} + +{{% tab "React Native" %}} + +Consulte [la guía MIGRATION.md][1] en el repositorio oficial de React Native para conocer los pasos de actualización recomendados y cualquier actualización de dependencia necesaria. + +
+Importante: En la v3, los módulos de funciones solo se habilitan si pasa su configuración durante la inicialización (por ejemplo, RUM / Logs / Trace). Si omite la configuración de un módulo de funciones, ese módulo no se inicializa ni se habilita. +
+ +[1]: https://github.com/DataDog/dd-sdk-reactnative/blob/develop/MIGRATION.md + +{{% /tab %}} + +{{< /tabs >}} + +### Cambios requeridos y actualizaciones de API {#required-changes-and-api-updates} +{{< tabs >}} +{{% tab "Android" %}} + +### Core {#core} + +
+Acción requerida: En el SDK v3, el ID de información del usuario se vuelve obligatorio y el null valor ya no puede ser proporcionado. +
+ +Cambios en la API: + +| `2.x` | `3.0` | +|---------------------------------------------------------------|--------------------------------------------------------------------| +| `Datadog.setUserInfo(null, "Jane Smith", "jane@example.com")` | `Datadog.setUserInfo("user123", "Jane Smith", "jane@example.com")` | + +### RUM {#rum} + +Realizamos mejoras menores en los módulos de RUM. No requieren cambios significativos en su código, pero vale la pena verificar si puede refactorizar algunos parámetros redundantes. + +La URL proporcionada en el método `useCustomEndpoint` debe ser la URL completa del punto de conexión +(`https://example.com/rum/upload`), no solo el nombre de host: + +```kotlin +Rum.enable( + RumConfiguration.Builder(...) + .useCustomEndpoint("https://example.com/rum/upload") + .build() +) +``` + +Cambios en la API: + +| `2.x` | `3.0` | +|-------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------| +| `DatadogRumMonitor.startResource(String, String, String,Map)` | Utilice el método `startResource` que toma `RumHttpMethod` como parámetro `method` en lugar de | +El objeto | `com.datadog.android.rum.GlobalRum` | `GlobalRum` fue renombrado a `com.datadog.android.rum.GlobalRumMonitor` | +| `com.datadog.android.rum.RumMonitor.addAction()` | El parámetro `attributes: Map` es opcional | +| `com.datadog.android.rum.RumMonitor.startAction()` | El parámetro `attributes: Map` es opcional | +| `com.datadog.android.rum.RumMonitor.stopResource()` | El parámetro `attributes: Map` es opcional | +| `com.datadog.android.rum.RumMonitor.addError()` | El parámetro `attributes: Map` es opcional | +| `com.datadog.android.rum.RumMonitor.addErrorWithStacktrace()` | El parámetro `attributes: Map` es opcional | +| `com.datadog.android.rum.internal.monitor.AdvancedNetworkRumMonitor.stopResource()` | El parámetro `attributes: Map` es opcional | +| `com.datadog.android.rum.internal.monitor.AdvancedNetworkRumMonitor.stopResource()` | El parámetro `attributes: Map` es opcional | + +### Registros {#logs} + +El producto Logs ya no reporta errores fatales. Para habilitar Error Tracking para fallas, Crash Reporting debe estar habilitado junto con RUM. + +La URL proporcionada en el método `useCustomEndpoint` debe ser la URL completa del punto de conexión +(`https://example.com/logs/upload`), no solo el nombre de host: + +```kotlin +Logs.enable( + LogsConfiguration.Builder() + .useCustomEndpoint("https://example.com/logs/upload") + .build() +) +``` + +### Trace {#trace} + +La URL proporcionada en el método `useCustomEndpoint` debe ser la URL completa del punto de conexión +(p. ej.: `https://example.com/trace/upload`), no solo el nombre de host, es decir: + +```kotlin +Trace.enable( + TraceConfiguration.Builder() + .useCustomEndpoint(`https://example.com/trace/upload`) + .build() +) +``` + +El proyecto [`Open Tracing`](https://opentracing.io/) ha sido marcado como archivado y ya no es compatible. Las dependencias de `Open Tracing` se han eliminado del SDK v3. + +El SDK de Datadog ya admite [`Open Telemetry`](https://opentelemetry.io/), que es la forma recomendada de usar la API de rastreo. + +**Tenga en cuenta** que la biblioteca de especificaciones `Open Telemetry` [requiere](https://github.com/open-telemetry/opentelemetry-java?tab=readme-ov-file#requirements) que el desugaring esté habilitado para proyectos con un `minSdk` < 26. + +#### Migración del rastreo de `Open Tracing` a `Open Telemetry` (recomendado) {#migrating-tracing-from-open-tracing-to-open-telemetry-recommended} + +1. Agregue la dependencia `Open Telemetry` a su `build.gradle.kts`: + +```kotlin +implementation(project("com.datadoghq:dd-sdk-android-trace-otel:x.x.x")) +``` + +2. Reemplace la configuración `Open Tracing`: + +```kotlin +GlobalTracer.registerIfAbsent( + AndroidTracer.Builder() + .setService(BuildConfig.APPLICATION_ID) + .build() +) +``` + +con la configuración `Open Telemetry`: + +```kotlin +GlobalOpenTelemetry.set( + DatadogOpenTelemetry(BuildConfig.APPLICATION_ID) +) +``` + +Para acceder al objeto de rastreo para el rastreo manual (personalizado), utilice `io.opentelemetry.api.GlobalOpenTelemetry.get()` en lugar de `io.opentracing.util.GlobalTracer.get()`. +Por ejemplo: + +```kotlin +val tracer: Tracer = GlobalOpenTelemetry + .get() + .getTracer("SampleApplicationTracer") + +val span = tracer + .spanBuilder("Executing operation") + .startSpan() + +// Code that should be instrumented + +span.end() +``` + +Consulte la `Open Telemetry` [documentación](https://opentelemetry.io/docs/) oficial para obtener más detalles. + +#### Migración del rastreo de `Open Tracing` a `DatadogTracing` (período de transición) {#migrating-tracing-from-open-tracing-to-datadogtracing-transition-period} + +
Esta opción se ha agregado por compatibilidad y para simplificar la transición de Open Tracing a Open Telemetry, pero es posible que no esté disponible en futuras versiones principales. Datadog recomienda usar Open Telemetry como estándar para las tareas de rastreo. Sin embargo, si no es posible habilitar el desugaring en su proyecto por alguna razón, puede usar este método.
+Reemplace la configuración `Open Tracing`: + +```kotlin +GlobalTracer.registerIfAbsent( + AndroidTracer.Builder() + .setService(BuildConfig.APPLICATION_ID) + .build() +) +``` + +con la configuración `DatadogTracing`: + +```kotlin +GlobalDatadogTracer.registerIfAbsent( + DatadogTracing.newTracerBuilder() + .build() +) +``` + +Para el rastreo manual (personalizado), utilice `com.datadog.android.trace.GlobalDatadogTracer.get()` en lugar de `io.opentracing.util.GlobalTracer.get()` para acceder al objeto de rastreo. +Por ejemplo: + +```kotlin +val tracer = GlobalDatadogTracer.get() + +val span = tracer + .buildSpan("Executing operation") + .start() + +// Code that should be instrumented + +span.finish() +``` +Consulte la [documentación](https://docs.datadoghq.com/es/tracing/trace_collection/automatic_instrumentation/dd_libraries/android?tab=kotlin) de Datadog para obtener más detalles. + +Cambios en la API: + +| `2.x` | `3.0` `Open Telemetry` | `3.0` `Datadog API` | +|-------------------------------------------|--------------------------------------------|---------------------------------------------------------| +| `io.opentracing.util.GlobalTracer` | `io.opentelemetry.api.GlobalOpenTelemetry` | `com.datadog.android.trace.GlobalDatadogTracer` | +| `com.datadog.android.trace.AndroidTracer` | `io.opentelemetry.api.trace.Tracer` | `com.datadog.android.trace.api.tracer.DatadogTracer` | +| `io.opentracing.Span` | `io.opentelemetry.api.trace.Span` | `com.datadog.android.trace.api.span.DatadogSpan` | +| `io.opentracing.Scope` | `io.opentelemetry.context.Scope` | `com.datadog.android.trace.api.scope.DatadogScope` | +| `io.opentracing.SpanContext` | `io.opentelemetry.api.trace.SpanContext` | `com.datadog.android.trace.api.span.DatadogSpanContext` | + +Sugerencias de reemplazo: + +| `2.x` | `3.0` `Open Telemetry` | `3.0` `Datadog API` | +|-----------------------------------------------|-------------------------------------------------------|---------------------------------------------------| +| `AndroidTracer.Builder().build()` | | `DatadogTracing.newTracerBuilder().build()` | +| `AndroidTracer.setPartialFlushThreshold(Int)` | `OtelTracerProvider.setPartialFlushThreshold()` | `DatadogTracerBuilder.withPartialFlushMinSpans()` | +| `io.opentracing.SpanContext.toTraceId()` | `io.opentelemetry.api.trace.SpanContext.getTraceId()` | `DatadogSpanContext.traceId.toString()` | +| `io.opentracing.Span.setError()` | `io.opentelemetry.api.trace.recordException()` | `DatadogSpan.addThrowable()` | + +### Instrumentación OkHttp {#okhttp-instrumentation} + +La instrumentación de OkHttp (`com.datadoghq:dd-sdk-android-okhttp:x.x.x`) no requiere soporte de desugaring. Sin embargo, es posible que sean necesarias algunas acciones de migración. + +Cambios en la API: + +| `2.x` | `3.0` | +|----------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------| +| `TracingInterceptor(String, List, TracedRequestListener,Sampler)` | Utilice `TracingInterceptor.Builder()` en su lugar. | +| `TracingInterceptor(String?,Map>, TracedRequestListener, Sampler)` | Utilice `TracingInterceptor.Builder()` en su lugar. | +| `TracingInterceptor(String?,TracedRequestListener,Sampler)` | Utilice `TracingInterceptor.Builder()` en su lugar. | +| `DatadogInterceptor(String?, Map>,TracedRequestListener, RumResourceAttributesProvider, Sampler)` | Utilice `DatadogInterceptor.Builder()` en su lugar. | +| `DatadogInterceptor(String?,List,TracedRequestListener,RumResourceAttributesProvider,Sampler)` | Utilice `DatadogInterceptor.Builder()` en su lugar. | +| `DatadogInterceptor(String?,TracedRequestListener,RumResourceAttributesProvider,Sampler) ` | Utilice `DatadogInterceptor.Builder()` en su lugar. | + + +### Session Replay {#session-replay} + +La URL proporcionada en el método `useCustomEndpoint` debe ser la URL completa del punto de conexión +(p. ej.: `https://example.com/session_replay/upload`), no solo el nombre de host, es decir: + +```kotlin +SessionReplay.enable( + SessionReplayConfiguration.Builder(...) + .useCustomEndpoint("https://example.com/session_replay/upload") + .build() +) +``` + +{{% /tab %}} +{{% tab "iOS" %}} + +El SDK debe inicializarse lo antes posible en el ciclo de vida de la aplicación, específicamente en la devolución de llamada `AppDelegate` de `application(_:didFinishLaunchingWithOptions:)`. Esto garantiza una medición precisa de todas las métricas, incluida la duración del inicio de la aplicación. Para aplicaciones creadas con SwiftUI, utilice `@UIApplicationDelegateAdaptor` para acceder a `AppDelegate`. + +```swift +import DatadogCore + +Datadog.initialize( + with: Datadog.Configuration( + clientToken: "", + env: "", + service: "" + ), + trackingConsent: .granted +) +``` + +**Nota**: Inicializar el SDK en otro lugar (por ejemplo, más tarde durante la carga de la vista) puede resultar en telemetría inexacta o faltante, especialmente en relación con el rendimiento del inicio de la aplicación. + +
+Acción requerida: La API para establecer la información del usuario requiere el id parámetro, que era opcional en 2.x. +
+ +| `2.x` | `3.0` | +|-------------------------------------|------------------------------------| +| `Datadog.setUserInfo(id: nil, name: "Jane Smith", email: "jane@example.com")` | `Datadog.setUserInfo(id: "user123", name: "Jane Smith", email: "jane@example.com")` | + +### RUM {#rum-1} + +Los atributos a nivel de visualización de RUM se propagan automáticamente a todos los eventos secundarios relacionados, incluidos recursos, acciones de usuario, errores y tareas largas. Esto garantiza metadatos consistentes en todos los eventos, lo que facilita el filtrado y la correlación de datos en los paneles de Datadog. + +Para gestionar de forma más efectiva los atributos a nivel de visualización, se agregaron nuevas API: +- `Monitor.addViewAttribute(forKey:value:)` +- `Monitor.addViewAttributes(_:)` +- `Monitor.removeViewAttribute(forKey:)` +- `Monitor.removeViewAttributes(forKeys:)` + +Otros cambios notables: +- Todas las API de RUM de Objective-C se incluyen en `DatadogRUM`. El módulo separado `DatadogObjc` ya no está disponible. +- Los bloqueos de aplicaciones (App Hangs) y las terminaciones de Watchdog ya no se reportan desde extensiones de aplicaciones o widgets. +- Se agregó una nueva propiedad `trackMemoryWarnings` a `RUM.Configuration` para reportar advertencias de memoria como errores de RUM. + +Cambios en la API: + +|`2.x`|`3.0`| +|---|---| +|-|`RUM.Configuration.trackMemoryWarnings`| +|`RUMView(path:attributes:)`|`RUMView(name:attributes:isUntrackedModal:)`| +|-|`Monitor.addViewAttribute(forKey:value:)`| +|-|`Monitor.addViewAttributes(:)`| +|-|`Monitor.removeViewAttribute(forKey:)`| +|-|`Monitor.removeViewAttributes(forKeys:)`| + +### Registros {#logs-1} + +El producto Logs ya no reporta errores fatales. Para habilitar Error Tracking para fallas, Crash Reporting debe estar habilitado junto con RUM. + +Además, todas las API de Logs de Objective-C se incluyen en `DatadogLogs`. El módulo separado `DatadogObjc` ya no está disponible. + +### Traza {#trace-1} + +El muestreo de trazas ahora es determinista cuando se utiliza junto con RUM. Utiliza el `session.id` de RUM para garantizar un muestreo consistente. + +Además: +- La configuración `Trace.Configuration.URLSessionTracking.FirstPartyHostsTracing` establece el muestreo para todas las solicitudes de forma predeterminada y el contexto de la traza se inyecta solo en las solicitudes muestreadas. +- Todas las API de traza de Objective-C se incluyen en `DatadogTrace`. El módulo separado `DatadogObjc` ya no está disponible. + +**Nota**: Existe una configuración similar en `RUM.Configuration.URLSessionTracking.FirstPartyHostsTracing`. + +### Session Replay {#session-replay-1} + +La configuración de privacidad es más granular. El parámetro `defaultPrivacyLevel` anterior ha sido reemplazado por: +- `textAndInputPrivacyLevel` +- `imagePrivacyLevel` +- `touchPrivacyLevel` + +Obtenga más información sobre los [niveles de privacidad][1]. + +Cambios en la API: + +|`2.x`|`3.0`| +|---|---| +|`SessionReplay.Configuration(replaySampleRate:defaultPrivacyLevel:startRecordingImmediately:customEndpoint:)`|`SessionReplay.Configuration(replaySampleRate:textAndInputPrivacyLevel:imagePrivacyLevel:touchPrivacyLevel:startRecordingImmediately:customEndpoint:featureFlags:)`| +|`SessionReplay.Configuration(replaySampleRate:defaultPrivacyLevel:startRecordingImmediately:customEndpoint:)`|`SessionReplay.Configuration(replaySampleRate:textAndInputPrivacyLevel:imagePrivacyLevel:touchPrivacyLevel:startRecordingImmediately:customEndpoint:featureFlags:)`| + +### Instrumentación de URLSession {#urlsession-instrumentation} + +Para habilitar la instrumentación de URLSession, asegúrese de habilitar también RUM y/o traza para informar a esos productos respectivamente. + +Los tipos de delegado heredados han sido reemplazados por una API de instrumentación unificada: + +|`2.x`|`3.0`| +|---|---| +|`DatadogURLSessionDelegate()`|`URLSessionInstrumentation.enable(with:)`| +|`DDURLSessionDelegate()`|`URLSessionInstrumentation.enable(with:)`| +|`DDNSURLSessionDelegate()`|`URLSessionInstrumentation.enable(with:)`| + +[1]: /es/session_replay/privacy_options?platform=ios + +{{% /tab %}} + +{{% tab "React Native" %}} + +Lea [la guía MIGRATION.md][1] en el repositorio oficial de React Native. + +
+Importante: A diferencia de la v2.x (que siempre habilitaba todos los módulos de funciones al inicializar el SDK), la v3 no inicializa ni habilita un módulo de funciones a menos que pase explícitamente la configuración para él. +
+ +### Cambios en la configuración {#configuration-changes} + +Ciertas propiedades de configuración han sido movidas, renombradas, eliminadas o divididas: + +| Propiedad | Nueva ubicación | Cambios | +| :--- | :--- | :--- | +| `sampleRate` | *Eliminado* | Propiedad obsoleta eliminada. | +| `sessionSamplingRate` | `RumConfiguration` | Movido y renombrado a `sessionSampleRate`. | +| `resourceTracingSamplingRate` | `RumConfiguration` | Movido y renombrado a `resourceTraceSampleRate`. | +| `proxyConfig` | `CoreConfiguration` | Renombrado a `proxyConfiguration`. | +| `serviceName` | `CoreConfiguration` | Renombrado a `service`. | +| `customEndpoints` | *Dividido* | Dividido en `customEndpoint` dentro de `RumConfiguration`, `LogsConfiguration` y `TraceConfiguration`. | +| *(Nueva propiedad)* | `CoreConfiguration` | `attributeEncoders` agregada. | +| *(Nueva propiedad)* | `RumConfiguration` | `trackMemoryWarnings` agregada. | +| `nativeCrashReportEnabled` | `RumConfiguration` | Movido. | +| `nativeViewTracking` | `RumConfiguration` | Movido. | +| `nativeInteractionTracking` | `RumConfiguration` | Movido. | +| `firstPartyHosts` | `RumConfiguration` | Se forzó el uso del tipo `FirstPartyHost[]` y se movió. | +| `telemetrySampleRate` | `RumConfiguration` | Movido. | +| `nativeLongTaskThresholdMs` | `RumConfiguration` | Movido. | +| `longTaskThresholdMs` | `RumConfiguration` | Movido. | +| `vitalsUpdateFrequency` | `RumConfiguration` | Movido. | +| `trackFrustrations` | `RumConfiguration` | Movido. | +| `trackBackgroundEvents` | `RumConfiguration` | Movido. | +| `bundleLogsWithRum` | `LogsConfiguration` | Movido. | +| `bundleLogsWithTraces` | `LogsConfiguration` | Movido. | +| `trackNonFatalAnrs` | `RumConfiguration` | Movido. | +| `appHangThreshold` | `RumConfiguration` | Movido. | +| `initialResourceThreshold` | `RumConfiguration` | Movido. | +| `trackWatchdogTerminations` | `RumConfiguration` | Movido. | +| `actionNameAttribute` | `RumConfiguration` | Movido. | +| `logEventMapper` | `LogsConfiguration` | Movido. | +| `errorEventMapper` | `RumConfiguration` | Movido. | +| `resourceEventMapper` | `RumConfiguration` | Movido. | +| `actionEventMapper` | `RumConfiguration` | Movido. | +| `useAccessibilityLabel` | `RumConfiguration` | Movido. | +| `trackInteractions` | `RumConfiguration` | Movido. | +| `trackResources` | `RumConfiguration` | Movido. | +| `trackErrors` | `RumConfiguration` | Movido. | + +### Estructuras renombradas {#renamed-structures} + +| `2.x` | `3.x` | +|---|---| +| `DdSdkConfiguration` | `CoreConfiguration` | + +### Actualizaciones de API {#api-updates} + +Además de los cambios en la propiedad de la configuración (configuraciones principales frente a las de funciones), varios tipos y API públicos fueron renombrados o reubicados para coincidir con el diseño modular de la v3. Consulte [la guía MIGRATION.md][1] para obtener la lista autorizada y ejemplos de código. + +[1]: https://github.com/DataDog/dd-sdk-reactnative/blob/develop/MIGRATION.md + +{{% /tab %}} + +{{< /tabs >}} + +## De v1 a v2 {#from-v1-to-v2} {{< tabs >}} {{% tab "Android" %}} -La migración de v1 a v2 representa una migración de un SDK monolito a una arquitectura modular. RUM, trazas, Logs, Session Replay, etc., cada uno tiene módulos individuales, lo que te permite integrar solo lo que se necesita en tu aplicación. +La migración de v1 a v2 representa una migración de un SDK monolítico a una arquitectura modular. RUM, Traza, Registros, Session Replay, entre otros, tienen módulos individuales, lo que le permite integrar solo lo que necesita en su aplicación. -SDK v2 ofrece un diseño de API unificado y una alineación de nombres entre el SDK de iOS, el SDK de Android y otros productos de Datadog. +El SDK v2 ofrece un diseño de API unificado y una alineación de nombres entre el SDK de iOS, el SDK de Android y otros productos de Datadog. -SDK v2 permite el uso de [Mobile Session Replay][1] en aplicaciones Android e iOS. +El SDK v2 permite el uso de [Mobile Session Replay][2] en aplicaciones de Android e iOS. -[1]: /es/real_user_monitoring/session_replay/mobile/ +[2]: /es/session_replay/?platform=android {{% /tab %}} {{% tab "iOS" %}} -La migración de v1 a v2 representa una migración de un SDK monolito a una arquitectura modular. RUM, trazas, logs, Session Replay, etc., cada uno tiene módulos individuales, lo que te permite integrar solo lo que se necesita en tu aplicación. +La migración de v1 a v2 representa una migración de un SDK monolítico a una arquitectura modular. RUM, Traza, Registros, Session Replay, entre otros, tienen módulos individuales, lo que le permite integrar solo lo que necesita en su aplicación. -SDK v2 ofrece un diseño de API unificado y una alineación de nombres entre el SDK de iOS, el SDK de Android y otros productos de Datadog. +El SDK v2 ofrece un diseño de API unificado y una alineación de nombres entre el SDK de iOS, el SDK de Android y otros productos de Datadog. -SDK v2 permite el uso de [Mobile Session Replay][1] en aplicaciones Android e iOS. +El SDK v2 permite el uso de [Mobile Session Replay][3] en aplicaciones de Android e iOS. -[1]: /es/real_user_monitoring/session_replay/mobile/ +[3]: /es/session_replay/?platform=ios {{% /tab %}} {{% tab "React Native" %}} @@ -44,39 +567,40 @@ La migración de v1 a v2 viene con un rendimiento mejorado. {{% /tab %}} {{% tab "Flutter" %}} -La migración de v1 a v2 viene con un rendimiento mejorado y funciones adicionales suministradas por los SDK nativos de v2. +La migración de v1 a v2 viene con un rendimiento mejorado y características adicionales proporcionadas por los SDK nativos de la v2. {{% /tab %}} {{< /tabs >}} -### Módulos + +### Módulos {#modules-1} {{< tabs >}} {{% tab "Android" %}} -Los artefactos se modularizan en la v2. Adopta los siguientes artefactos: +Los artefactos están modularizados en la v2. Adopte los siguientes artefactos: * RUM: `com.datadoghq:dd-sdk-android-rum:x.x.x` -* Logs: `com.datadoghq:dd-sdk-android-logs:x.x.x` +* Registros: `com.datadoghq:dd-sdk-android-logs:x.x.x` * Traza: `com.datadoghq:dd-sdk-android-trace:x.x.x` * Session Replay: `com.datadoghq:dd-sdk-android-session-replay:x.x.x` * WebView Tracking: `com.datadoghq:dd-sdk-android-webview:x.x.x` * Instrumentación de OkHttp: `com.datadoghq:dd-sdk-android-okhttp:x.x.x` -**Nota**: Si utilizas NDK Crash Reporting y WebView Tracking, debes añadir artefactos RUM y logs para informar de eventos a RUM y logs respectivamente. +**Nota**: Si utiliza NDK Crash Reporting y WebView Tracking, debe agregar los artefactos de RUM y Logs para reportar eventos a RUM y Logs respectivamente. -La referencia al artefacto `com.datadoghq:dd-sdk-android` debería ser eliminada de tu script de compilación Gradle, ya que este artefacto ya no existe. +La referencia al artefacto `com.datadoghq:dd-sdk-android` debe eliminarse de su script de compilación de Gradle, ya que este artefacto ya no existe. -**Nota**: Las coordenadas Maven de todos los demás artefactos siguen siendo las mismas. +**Nota**: Las coordenadas de Maven de todos los demás artefactos permanecen iguales. -
v2 no es compatible con Android API 19 (KitKat). El SDK mínimo compatible es ahora API 21 (Lollipop). Se requiere Kotlin 1.7. El propio SDK se compila con Kotlin 1.8, por lo que un compilador de Kotlin 1.6 e inferior no puede leer los metadatos de las clases del SDK.
+
La v2 no es compatible con la API 19 de Android (KitKat). El SDK mínimo compatible ahora es la API 21 (Lollipop). Se requiere Kotlin 1.7. El SDK en sí está compilado con Kotlin 1.8, por lo que un compilador de Kotlin 1.6 o inferior no puede leer los metadatos de las clases del SDK.
-Si te encuentras con un error como el siguiente: +En caso de que encuentre un error como el siguiente: ``` A failure occurred while executing com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt found in modules kotlin-stdlib-1.8.10 (org.jetbrains.kotlin:kotlin-stdlib:1.8.10) and kotlin-stdlib-jdk8-1.7.20 (org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.20) ``` -Añade las siguientes reglas a tu script de compilación (más detalles en el [Problema de sobrecarca del stack][2]): +Añada las siguientes reglas a su script de compilación (más detalles en el [problema de Stack Overflow][4] correspondiente): ```kotlin dependencies { @@ -91,15 +615,15 @@ dependencies { } ``` -Consulta la [aplicación de muestra de Android][3] para ver un ejemplo de cómo configurar el SDK. +Consulte la [aplicación de ejemplo de Android][5] para ver un ejemplo de cómo configurar el SDK. -[2]: https://stackoverflow.com/a/75298544 -[3]: https://github.com/DataDog/dd-sdk-android/tree/develop/sample +[4]: https://stackoverflow.com/a/75298544 +[5]: https://github.com/DataDog/dd-sdk-android/tree/develop/sample {{% /tab %}} {{% tab "iOS" %}} -Las bibliotecas se modularizan en la v2. Adopta las siguientes bibliotecas: +Las bibliotecas están modularizadas en la v2. Adopte las siguientes bibliotecas: - `DatadogCore` - `DatadogLogs` @@ -108,10 +632,10 @@ Las bibliotecas se modularizan en la v2. Adopta las siguientes bibliotecas: - `DatadogRUM` - `DatadogWebViewTracking` -Estas se suman a las ya existentes `DatadogCrashReporting` y `DatadogObjc`. +Estas se añaden a las `DatadogCrashReporting` y `DatadogObjc` existentes.
- SPM (recomendado) + SPM (Recomendado) ```swift let package = Package( @@ -156,18 +680,18 @@ let package = Package(
Carthage - El `Cartfile` se mantiene igual: +El `Cartfile` permanece igual: ``` github "DataDog/dd-sdk-ios" ``` - In Xcode, you **must** link the following frameworks: +En Xcode, **debe** vincular los siguientes frameworks: ``` DatadogInternal.xcframework DatadogCore.xcframework ``` - Then you can select the modules you want to use: +Luego, puede seleccionar los módulos que desea utilizar: ``` DatadogLogs.xcframework DatadogTrace.xcframework @@ -179,33 +703,33 @@ let package = Package( ```
-**Nota**: Cuando utilices Crash Reporting y WebView Tracking, debes añadir los módulos RUM y logs para informar de eventos a RUM y logs respectivamente. +**Nota**: Al utilizar Crash Reporting y WebView Tracking, debe añadir los módulos RUM y Logs para reportar eventos a RUM y Logs respectivamente. {{% /tab %}} {{% tab "React Native" %}} -Actualiza `@datadog/mobile-react-native` en tu package.json: +Actualice `@datadog/mobile-react-native` en su package.json: ```json "@datadog/mobile-react-native": "2.0.0" ``` -Actualiza tus pods de iOS: +Actualice sus pods de iOS: ```bash (cd ios && bundle exec pod update) ``` -Si utilizas una versión de React Native estrictamente superior a `0.67`, utiliza Java versión 17. Si utilizas una versión de React Native igual o inferior a `0.67`, utiliza Java versión 11. Para comprobar tu versión de Java, ejecuta lo siguiente en un terminal: +Si utiliza una versión de React Native estrictamente superior a `0.67`, utilice la versión 17 de Java. Si utiliza una versión de React Native igual o inferior a `0.67`, utilice la versión 11 de Java. Para verificar su versión de Java, ejecute lo siguiente en una terminal: ```bash java --version ``` -### Para React Native < 0.73 +### Para React Native < 0.73 {#for-react-native-073} -En tu archivo `android/build.gradle`, especifica `kotlinVersion` para evitar conflictos entre las dependencias de Kotlin: +En su archivo `android/build.gradle`, especifique `kotlinVersion` para evitar conflictos entre las dependencias de Kotlin: ```groovy buildscript { @@ -216,9 +740,9 @@ buildscript { } ``` -### Para React Native < 0.68 +### Para React Native < 0.68 {#for-react-native-068} -En tu archivo `android/build.gradle`, especifica `kotlinVersion` para evitar conflictos entre las dependencias de Kotlin: +En su archivo `android/build.gradle`, especifique `kotlinVersion` para evitar conflictos entre las dependencias de Kotlin: ```groovy buildscript { @@ -229,17 +753,17 @@ buildscript { } ``` -Si utilizas una versión de `com.android.tools.build:gradle` inferior a `5.0` en tu `android/build.gradle`, añádela en tu archivo `android/gradle.properties`: +Si está utilizando una versión de `com.android.tools.build:gradle` inferior a `5.0` en su `android/build.gradle`, añada en su archivo `android/gradle.properties`: ```properties android.jetifier.ignorelist=dd-sdk-android-core ``` -### Solucionar problemas +### Solución de problemas {#troubleshooting} -#### La compilación de Android falla con `Unable to make field private final java.lang.String java.io.File.path accessible` +#### La compilación de Android falla con `Unable to make field private final java.lang.String java.io.File.path accessible` {#android-build-fails-with-unable-to-make-field-private-final-javalangstring-javaiofilepath-accessible} -Si tu compilación de Android falla con un error como: +Si su compilación de Android falla con un error como: ``` FAILURE: Build failed with an exception. @@ -249,11 +773,11 @@ Execution failed for task ':app:processReleaseMainManifest'. > Unable to make field private final java.lang.String java.io.File.path accessible: module java.base does not "opens java.io" to unnamed module @1bbf7f0e ``` -Estás usando Java 17, que no es compatible con tu versión de React Native. Cambia a Java 11 para resolver el problema. +Está utilizando Java 17, el cual no es compatible con su versión de React Native. Cambie a Java 11 para resolver el problema. -#### La compilación de Android falla con `Unsupported class file major version 61` +#### La compilación de Android falla con `Unsupported class file major version 61` {#android-build-fails-with-unsupported-class-file-major-version-61} -Si tu compilación de Android falla con un error como: +Si su compilación de Android falla con un error como: ``` FAILURE: Build failed with an exception. @@ -266,15 +790,15 @@ Could not determine the dependencies of task ':app:lintVitalRelease'. > Failed to transform '/Users/me/.gradle/caches/modules-2/files-2.1/com.datadoghq/dd-sdk-android-core/2.0.0/a97f8a1537da1de99a86adf32c307198b477971f/dd-sdk-android-core-2.0.0.aar' using Jetifier. Reason: IllegalArgumentException, message: Unsupported class file major version 61. (Run with --stacktrace for more details.) ``` -Utilizas una versión de Android Gradle Plugin inferior a `5.0`. Para solucionar el problema, añade en tu archivo `android/gradle.properties`: +Usted utiliza una versión del complemento de Android para Gradle inferior a `5.0`. Para solucionar el problema, agregue en su archivo `android/gradle.properties`: ```properties android.jetifier.ignorelist=dd-sdk-android-core ``` -#### La compilación de Android falla con `Duplicate class kotlin.collections.jdk8.*` +#### La compilación de Android falla con `Duplicate class kotlin.collections.jdk8.*` {#android-build-fails-with-duplicate-class-kotlincollectionsjdk8} -Si tu compilación de Android falla con un error como: +Si su compilación de Android falla con un error como: ``` FAILURE: Build failed with an exception. @@ -286,7 +810,7 @@ Execution failed for task ':app:checkReleaseDuplicateClasses'. Duplicate class kotlin.internal.jdk7.JDK7PlatformImplementations found in modules jetified-kotlin-stdlib-1.8.10 (org.jetbrains.kotlin:kotlin-stdlib:1.8.10) and jetified-kotlin-stdlib-jdk7-1.7.20 (org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.7.20) ``` -Necesitas establecer una versión de Kotlin para tu proyecto para evitar conflictos entre las dependencias de Kotlin. En tu archivo `android/build.gradle`, especifica la versión `kotlinVersion`: +Debe establecer una versión de Kotlin para su proyecto para evitar conflictos entre las dependencias de Kotlin. En su archivo `android/build.gradle`, especifique `kotlinVersion`: ```groovy buildscript { @@ -297,7 +821,7 @@ buildscript { } ``` -Alternativamente, puedes añadir las siguientes reglas a tu script de compilación en tu archivo `android/app/build.gradle`: +Alternativamente, puede agregar las siguientes reglas a su script de compilación en su archivo `android/app/build.gradle`: ```groovy dependencies { @@ -315,29 +839,29 @@ dependencies { {{% /tab %}} {{% tab "Flutter" %}} -Actualiza `datadog_flutter_plugin` en tu pubspec.yaml: +Actualice `datadog_flutter_plugin` en su pubspec.yaml: ```yaml dependencies: 'datadog_flutter_plugin: ^2.0.0 ``` -## Solucionar problemas +## Solución de problemas {#troubleshooting-1} -### Duplicar interfaz (iOS) +### Interfaz duplicada (iOS) {#duplicate-interface-ios} -Si aparece este error al compilar iOS después de actualizar a `datadog_flutter_plugin` v2.0: +Si ve este error al compilar iOS después de actualizar a `datadog_flutter_plugin` v2.0: ``` Semantic Issue (Xcode): Duplicate interface definition for class 'DatadogSdkPlugin' /Users/exampleuser/Projects/test_app/build/ios/Debug-iphonesimulator/datadog_flutter_plugin/datadog_flutter_plugin.framework/Headers/DatadogSdkPlugin.h:6:0 ``` -Prueba realizar `flutter clean && flutter pub get` y volver a compilar. Esto suele resolver el problema. +Intente realizar `flutter clean && flutter pub get` y volver a compilar. Esto suele resolver el problema. -### Clases duplicadas (Android) +### Clases duplicadas (Android) {#duplicate-classes-android} -Si aparece este error al compilar Android tras la actualización a `datadog_flutter_plugin` v2.0: +Si ve este error al compilar Android después de la actualización a `datadog_flutter_plugin` v2.0: ``` FAILURE: Build failed with an exception. @@ -347,40 +871,40 @@ Execution failed for task ':app:checkDebugDuplicateClasses'. > A failure occurred while executing com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable ``` -Asegúrate de que has actualizado tu versión de Kotlin al menos a la 1.8 en tu archivo `build.gradle`. +Asegúrese de haber actualizado su versión de Kotlin a al menos 1.8 en su archivo `build.gradle`. {{% /tab %}} {{< /tabs >}} -### Inicialización del SDK +### Inicialización del SDK {#sdk-initialization} {{< tabs >}} {{% tab "Android" %}} -Con la extracción de productos diferentes en módulos independientes, la configuración del SDK está organizada por módulo. +Con la extracción de diferentes productos en módulos independientes, la configuración del SDK está organizada por módulo. -`com.datadog.android.core.configuration.Configuration.Builder` tiene los siguientes cambios: +`com.datadog.android.core.configuration.Configuration.Builder` La clase tiene los siguientes cambios: -* El token del cliente, el nombre del entorno, el nombre de la variante (el valor por defecto es una cadena vacía) y el nombre de servicio (el valor por defecto es el ID de la aplicación tomado del manifiesto) deben proporcionarse en el constructor. -* Se elimina la clase `com.datadog.android.core.configuration.Credentials`. -* `logsEnabled`, `tracesEnabled` y `rumEnabled` se eliminan del constructor en favor de la configuración del producto individual (consulta más adelante). -* Se elimina el argumento del constructor `crashReportsEnabled`. Puedes activar o desactivar el informe de fallos de JVM con el método `Configuration.Builder.setCrashReportsEnabled`. Por defecto, el informe de fallos de JVM está activado. -* Los métodos de configuración de productos de RUM, logs y trazas se eliminan de `Configuration.Builder` en favor de la configuración de productos individuales (consulta más abajo). +* Se deben proporcionar el token de cliente, el nombre del entorno, el nombre de la variante (el valor predeterminado es una cadena vacía) y el nombre del servicio (el valor predeterminado es el ID de la aplicación tomado del manifiesto) en el constructor. +* La clase `com.datadog.android.core.configuration.Credentials` ha sido eliminada. +* `logsEnabled`, `tracesEnabled` y `rumEnabled` se eliminaron del constructor a favor de la configuración individual del producto (ver más abajo). +* `crashReportsEnabled` El argumento del constructor se eliminó. Puede habilitar o deshabilitar el informe de fallos de la JVM con el método `Configuration.Builder.setCrashReportsEnabled`. De forma predeterminada, el informe de fallos de la JVM está habilitado. +Los métodos de configuración del producto * RUM, Logs y Trace se eliminaron de `Configuration.Builder` a favor de la configuración individual del producto (ver más abajo). -El método `Datadog.initialize` tiene la clase `Credentials` eliminada de la lista de los argumentos. +El método `Datadog.initialize` tiene la clase `Credentials` eliminada de la lista de argumentos. -Se elimina el paquete `com.datadog.android.plugin` y todas las clases/métodos relacionados. +El paquete `com.datadog.android.plugin` y todas las clases/métodos relacionados se eliminaron. -### Logs +### Logs {#logs-2} -Todas las clases relacionadas con el producto de logs están estrictamente contenidas en el paquete `com.datadog.android.log`. +Todas las clases relacionadas con el producto Logs están estrictamente contenidas en el paquete `com.datadog.android.log`. -Para utilizar el producto de logs, importa el siguiente artefacto: +Para usar el producto Logs, importe el siguiente artefacto: ```kotlin implementation("com.datadoghq:dd-sdk-android-logs:x.x.x") ``` -Puedes activar el producto de logs con el siguiente fragmento: +Puede habilitar el producto Logs con el siguiente fragmento: ```kotlin val logsConfig = LogsConfiguration.Builder() @@ -402,21 +926,21 @@ Cambios en la API: |`com.datadog.android.core.configuration.Configuration.Builder.useCustomLogsEndpoint`|`com.datadog.android.log.LogsConfiguration.Builder.useCustomEndpoint`| |`com.datadog.android.log.Logger.Builder.setLoggerName`|`com.datadog.android.log.Logger.Builder.setName`| |`com.datadog.android.log.Logger.Builder.setSampleRate`|`com.datadog.android.log.Logger.Builder.setRemoteSampleRate`| -|`com.datadog.android.log.Logger.Builder.setDatadogLogsEnabled`|Este método ha sido eliminado. Utiliza `com.datadog.android.log.Logger.Builder.setRemoteSampleRate(0f)` en su lugar para desactivar el envío de logs a Datadog.| +|`com.datadog.android.log.Logger.Builder.setDatadogLogsEnabled`|Este método ha sido eliminado. Use `com.datadog.android.log.Logger.Builder.setRemoteSampleRate(0f)` en su lugar para deshabilitar el envío de Logs a Datadog.| |`com.datadog.android.log.Logger.Builder.setServiceName`|`com.datadog.android.log.Logger.Builder.setService`| |`com.datadog.android.log.Logger.Builder.setDatadogLogsMinPriority`|`com.datadog.android.log.Logger.Builder.setRemoteLogThreshold`| -### Traza +### Trace {#trace-2} -Todas las clases relacionadas con el producto de traza están estrictamente contenidas en el paquete `com.datadog.android.trace` (esto significa que todas las clases que antes residían en `com.datadog.android.tracing` se han desplazado). +Todas las clases relacionadas con el producto Trace están estrictamente contenidas en el paquete `com.datadog.android.trace` (esto significa que todas las clases que residían en `com.datadog.android.tracing` anteriormente se han movido). -Para utilizar el producto de traza, importa el siguiente artefacto: +Para usar el producto Trace, importe el siguiente artefacto: ```kotlin implementation("com.datadoghq:dd-sdk-android-trace:x.x.x") ``` -Puedes activar el producto de traza con el siguiente fragmento: +Puede habilitar el producto Trace con el siguiente fragmento: ```kotlin val traceConfig = TraceConfiguration.Builder() @@ -441,17 +965,17 @@ Cambios en la API: |`com.datadog.android.tracing.AndroidTracer.Builder.setSamplingRate`|`com.datadog.android.trace.AndroidTracer.Builder.setSampleRate`| |`com.datadog.android.tracing.AndroidTracer.Builder.setServiceName`|`com.datadog.android.trace.AndroidTracer.Builder.setService`| -### RUM +### RUM {#rum-2} Todas las clases relacionadas con el producto RUM están estrictamente contenidas en el paquete `com.datadog.android.rum`. -Para utilizar el producto RUM, importa el siguiente artefacto: +Para usar el producto RUM, importe el siguiente artefacto: ```kotlin implementation("com.datadoghq:dd-sdk-android-rum:x.x.x") ``` -Puedes activar el producto RUM con el siguiente fragmento: +Puede habilitar el producto RUM con el siguiente fragmento: ```kotlin val rumConfig = RumConfiguration.Builder(rumApplicationId) @@ -477,68 +1001,68 @@ Cambios en la API: |`com.datadog.android.core.configuration.Configuration.Builder.disableInteractionTracking`|`com.datadog.android.rum.RumConfiguration.Builder.disableUserInteractionTracking`| |`com.datadog.android.core.configuration.Configuration.Builder.sampleRumSessions`|`com.datadog.android.rum.RumConfiguration.Builder.setSessionSampleRate`| |`com.datadog.android.core.configuration.Configuration.Builder.sampleTelemetry`|`com.datadog.android.rum.RumConfiguration.Builder.setTelemetrySampleRate`| -|`com.datadog.android.rum.RumMonitor.Builder`|Esta clase ha sido eliminada. El monitor RUM se crea y registra durante la llamada a `Rum.enable`.| +|`com.datadog.android.rum.RumMonitor.Builder`|Esta clase ha sido eliminada. El monitor RUM se crea y registra durante la llamada `Rum.enable`.| |`com.datadog.android.rum.RumMonitor.Builder.sampleRumSessions`|`com.datadog.android.rum.RumConfiguration.Builder.setSessionSampleRate`| |`com.datadog.android.rum.RumMonitor.Builder.setSessionListener`|`com.datadog.android.rum.RumConfiguration.Builder.setSessionListener`| |`com.datadog.android.rum.RumMonitor.addUserAction`|`com.datadog.android.rum.RumMonitor.addAction`| |`com.datadog.android.rum.RumMonitor.startUserAction`|`com.datadog.android.rum.RumMonitor.startAction`| |`com.datadog.android.rum.RumMonitor.stopUserAction`|`com.datadog.android.rum.RumMonitor.stopAction`| -|`com.datadog.android.rum.GlobalRum.registerIfAbsent`|Este método ha sido eliminado. El monitor RUM se crea y registra durante la llamada a `Rum.enable`.| +|`com.datadog.android.rum.GlobalRum.registerIfAbsent`|Este método ha sido eliminado. El monitor RUM se crea y registra durante la llamada `Rum.enable`.| |`com.datadog.android.rum.GlobalRum`|`com.datadog.android.rum.GlobalRumMonitor`| |`com.datadog.android.rum.GlobalRum.addAttribute`|`com.datadog.android.rum.RumMonitor.addAttribute`| |`com.datadog.android.rum.GlobalRum.removeAttribute`|`com.datadog.android.rum.RumMonitor.removeAttribute`| -### NDK Crash Reporting +### NDK Crash Reporting {#ndk-crash-reporting} El nombre del artefacto sigue siendo el mismo que antes: `com.datadoghq:dd-sdk-android-ndk:x.x.x`. -Puedes activar NDK Crash Reporting con el siguiente fragmento: +Puede habilitar NDK Crash Reporting con el siguiente fragmento: ```kotlin NdkCrashReports.enable() ``` -Esta configuración sustituye a la llamada `com.datadog.android.core.configuration.Configuration.Builder.addPlugin`. +Esta configuración reemplaza la llamada `com.datadog.android.core.configuration.Configuration.Builder.addPlugin`. -**Nota**: Debes tener habilitados los productos RUM y logs para recibir informes de fallos del NDK en RUM y logs respectivamente. +**Nota**: Debe tener habilitados los productos RUM y Logs para recibir informes de fallos NDK en RUM y Logs, respectivamente. -### WebView Tracking +### Seguimiento de WebView {#webview-tracking} El nombre del artefacto sigue siendo el mismo que antes: `com.datadoghq:dd-sdk-android-webview:x.x.x` -Puedes activar WebView Tracking con el siguiente fragmento de código: +Puede habilitar el seguimiento de WebView con el siguiente fragmento: ```kotlin WebViewTracking.enable(webView, allowedHosts) ``` -**Nota**: Debes tener habilitados los productos RUM y logs para recibir eventos procedentes de WebView en RUM y logs respectivamente. +**Nota**: Debe tener habilitados los productos RUM y Logs para recibir eventos provenientes de WebView en RUM y Logs, respectivamente. Cambios en la API: |`1.x`|`2.0`| |---|---| -|`com.datadog.android.webview.DatadogEventBridge`|Este método se convirtió en una clase `internal`. Utiliza `WebViewTracking` en su lugar.| -|`com.datadog.android.rum.webview.RumWebChromeClient`|Esta clase ha sido eliminada. Utiliza `WebViewTracking` en su lugar.| -|`com.datadog.android.rum.webview.RumWebViewClient`|Esta clase ha sido eliminada. Utiliza `WebViewTracking` en su lugar.| +|`com.datadog.android.webview.DatadogEventBridge`|Este método se convirtió en una `internal` clase. Use `WebViewTracking` en su lugar.| +|`com.datadog.android.rum.webview.RumWebChromeClient`|Esta clase fue eliminada. Use `WebViewTracking` en su lugar.| +|`com.datadog.android.rum.webview.RumWebViewClient`|Esta clase fue eliminada. Use `WebViewTracking` en su lugar.| -### OkHttp Tracking +### OkHttp Tracking {#okhttp-tracking} -Para utilizar OkHttp Tracking, importa el siguiente artefacto: +Para usar OkHttp Tracking, importe el siguiente artefacto: ```kotlin implementation("com.datadoghq:dd-sdk-android-okhttp:x.x.x") ``` -La instrumentación de OkHttp admite la inicialización del SDK de Datadog después del cliente OkHttp, permitiendo crear `com.datadog.android.okhttp.DatadogEventListener`, `com.datadog.android.okhttp.DatadogInterceptor` y `com.datadog.android.okhttp.trace.TracingInterceptor` antes que el SDK de Datadog. La instrumentación de OkHttp comienza a informar eventos a Datadog una vez que el SDK de Datadog es inicializado. +La instrumentación de OkHttp admite la inicialización del SDK de Datadog después del cliente de OkHttp, lo que le permite crear `com.datadog.android.okhttp.DatadogEventListener`, `com.datadog.android.okhttp.DatadogInterceptor` y `com.datadog.android.okhttp.trace.TracingInterceptor` antes del SDK de Datadog. La instrumentación de OkHttp comienza a informar eventos a Datadog una vez que se inicializa el SDK de Datadog. -Tanto `com.datadog.android.okhttp.DatadogInterceptor` como `com.datadog.android.okhttp.trace.TracingInterceptor` permiten controlar el muestreo de forma dinámica a través de la integración con un sistema de configuración remoto. +Tanto `com.datadog.android.okhttp.DatadogInterceptor` como `com.datadog.android.okhttp.trace.TracingInterceptor` le permiten controlar el muestreo de forma dinámica mediante la integración con un sistema de configuración remota. -Para ajustar dinámicamente el muestreo, proporciona tu propia implementación de la interfaz `com.datadog.android.core.sampling.Sampler` en el constructor `com.datadog.android.okhttp.DatadogInterceptor`/`com.datadog.android.okhttp.trace.TracingInterceptor`. Se consulta para cada solicitud para tomar la decisión de muestreo. +Para ajustar el muestreo de forma dinámica, proporcione su propia implementación de la interfaz `com.datadog.android.core.sampling.Sampler` en el constructor de `com.datadog.android.okhttp.DatadogInterceptor`/`com.datadog.android.okhttp.trace.TracingInterceptor`. Se consulta para cada solicitud con el fin de tomar la decisión de muestreo. -### Extracción del módulo `dd-sdk-android-ktx` +### `dd-sdk-android-ktx` eliminación del módulo {#dd-sdk-android-ktx-module-removal} -Para mejorar el nivel de detalle de las bibliotecas del SDK de Datadog utilizadas, se elimina el módulo `dd-sdk-android-ktx`. El código se distribuye entre los demás módulos para proporcionar métodos de extensión tanto para las funciones RUM como para trazas. +Para mejorar la granularidad de los SDK de Datadog utilizados, se elimina el módulo `dd-sdk-android-ktx`. El código se distribuye entre los otros módulos para proporcionar métodos de extensión tanto para las funciones de RUM como de traza. | `1.x` | '2.0' | Nombre del módulo | |-------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|-----------------------------------| @@ -558,22 +1082,23 @@ Para mejorar el nivel de detalle de las bibliotecas del SDK de Datadog utilizada | `com.datadog.android.ktx.rum#java.io.InputStream.asRumResource` | `com.datadog.android.rum.resource#java.io.InputStream.asRumResource` | `dd-sdk-android-rum` | | `com.datadog.android.ktx.tracing#okhttp3.Request.Builder.parentSpan` | `com.datadog.android.okhttp.trace#okhttp3.Request.Builder.parentSpan` | `dd-sdk-android-okhttp` | -### Session Replay +### Session Replay {#session-replay-2} -Para obtener instrucciones sobre la configuración de Mobile Session Replay, consulta [Configuración de Mobile Session Replay][4]. +Para obtener instrucciones sobre cómo configurar Mobile Session Replay, consulte [Mobile Session Replay Setup and Configuration][6]. -[4]: /es/real_user_monitoring/session_replay/mobile/setup_and_configuration/?tab=android +[6]: /es/session_replay/setup_and_configuration/?platform=android {{% /tab %}} {{% tab "iOS" %}} -Con la extracción de diferentes productos en módulos independientes, la configuración del SDK se organiza por módulos. +Con la extracción de diferentes productos en módulos independientes, la configuración del SDK está organizada por módulo. > El SDK debe inicializarse antes de habilitar cualquier producto. -El patrón Builder (compilador) de la inicialización del SDK se ha eliminado en favor de las definiciones de estructura. El siguiente ejemplo muestra cómo una inicialización `1.x` se traduciría en `2.0`. +El patrón Builder de la inicialización del SDK se ha eliminado en favor de las definiciones de estructura. El siguiente ejemplo muestra cómo se traduciría una inicialización de `1.x` en `2.0`. + +**Inicialización de V1** -**Inicialización V1** ```swift import Datadog @@ -588,7 +1113,8 @@ Datadog.initialize( .set(serviceName: "") .build() ``` -**Inicialización V2** +**Inicialización de V2** + ```swift import DatadogCore @@ -614,9 +1140,9 @@ Cambios en la API: |`Datadog.Configuration.Builder.set(serverDateProvider:)`|`Datadog.Configuration.serverDateProvider`| |`Datadog.AppContext(mainBundle:)`|`Datadog.Configuration.bundle`| -### Logs +### Registros {#logs-3} -Todas las clases relacionadas con logs se encuentran estrictamente en el módulo `DatadogLogs`. Primero tienes que habilitar el producto: +Todas las clases relacionadas con Logs están estrictamente en el módulo `DatadogLogs`. Primero debe habilitar el producto: ```swift import DatadogLogs @@ -624,7 +1150,7 @@ import DatadogLogs Logs.enable(with: Logs.Configuration(...)) ``` -A continuación, puedes crear una instancia del registrador: +Luego, puede crear una instancia de logger: ```swift import DatadogLogs @@ -649,9 +1175,9 @@ Cambios en la API: |`Logger.Builder.set(datadogReportingThreshold:)`|`Logger.Configuration.remoteLogThreshold`| |`Logger.Builder.printLogsToConsole(_:, usingFormat)`|`Logger.Configuration.consoleLogFormat`| -### Traza +### traza {#trace-3} -Todas las clases relacionadas con trazas se encuentran estrictamente en el módulo `DatadogTrace`. Primero tienes que habilitar el producto: +Todas las clases relacionadas con traza están estrictamente en el módulo `DatadogTrace`. Primero debe habilitar el producto: ```swift import DatadogTrace @@ -661,7 +1187,7 @@ Trace.enable( ) ``` -A continuación, puedes acceder a la instancia compartida del rastreador: +Luego, puede acceder a la instancia compartida de Tracer: ```swift import DatadogTrace @@ -682,9 +1208,9 @@ Cambios en la API: |`Tracer.Configuration.bundleWithRUM`|`Trace.Configuration.bundleWithRumEnabled`| |`Tracer.Configuration.samplingRate`|`Trace.Configuration.sampleRate`| -### RUM +### RUM {#rum-3} -Todas las clases relacionadas con RUM se encuentran estrictamente en el módulo `DatadogRUM`. Primero debes habilitar el producto: +Todas las clases relacionadas con RUM están estrictamente en el módulo `DatadogRUM`. Primero debe habilitar el producto: ```swift import DatadogRUM @@ -694,7 +1220,7 @@ RUM.enable( ) ``` -A continuación, podrás acceder a la instancia de monitor RUM compartida: +Luego, puede acceder a la instancia compartida de seguimiento de RUM: ```swift import DatadogRUM @@ -723,9 +1249,9 @@ Cambios en la API: |`Datadog.Configuration.Builder.set(mobileVitalsFrequency:)`|`RUM.Configuration.vitalsUpdateFrequency`| |`Datadog.Configuration.Builder.set(sampleTelemetry:)`|`RUM.Configuration.telemetrySampleRate`| -### Crash Reporting +### Crash Reporting {#crash-reporting} -Para habilitar Crash Reporting, asegúrate de habilitar RUM y logs para informar a esos productos respectivamente. +Para habilitar Crash Reporting, asegúrese de habilitar RUM y Logs para informar a esos productos respectivamente. ```swift import DatadogCrashReporting @@ -737,9 +1263,9 @@ CrashReporting.enable() |---|---| |`Datadog.Configuration.Builder.enableCrashReporting()`|`CrashReporting.enable()`| -### WebView Tracking +### Seguimiento de WebView {#webview-tracking-1} -Para habilitar WebViewTracking, asegúrate de habilitar también RUM y logs para informar a esos productos respectivamente. +Para habilitar WebViewTracking, asegúrese también de habilitar RUM y Logs para informar a esos productos respectivamente. ```swift import WebKit @@ -753,31 +1279,31 @@ WebViewTracking.enable(webView: webView) |---|---| |`WKUserContentController.startTrackingDatadogEvents`|`WebViewTracking.enable(webView:)`| -### Session Replay +### Session Replay {#session-replay-3} -Para obtener instrucciones sobre la configuración de Mobile Session Replay, consulta [Configuración de Mobile Session Replay][5]. +Para obtener instrucciones sobre cómo configurar Mobile Session Replay, consulte [Mobile Session Replay Setup and Configuration][7]. -[5]: /es/real_user_monitoring/session_replay/mobile/setup_and_configuration/?tab=ios +[7]: /es/session_replay/setup_and_configuration/?platform=ios {{% /tab %}} {{% tab "React Native" %}} -No es necesario ningún cambio en la inicialización del SDK. +No se necesita ningún cambio en la inicialización del SDK. {{% /tab %}} {{% tab "Flutter" %}} -## Cambios de configuración del SDK +## Cambios en la configuración del SDK {#sdk-configuration-changes} -Algunas propiedades de configuración se han movido o renombrado para respaldar la modularidad en los SDKs nativos de Datadog. +Ciertas propiedades de configuración se han movido o renombrado para admitir la modularidad en los SDK nativos de Datadog. -Se ha cambiado el nombre de las siguientes estructuras: +Las siguientes estructuras han sido renombradas: | `1.x` | `2.x` | |-------|-------| | `DdSdkConfiguration` | `DatadogConfiguration` | -| `LoggingConfiguartion` | `DatadogLoggingConfiguration` | +| `LoggingConfiguration` | `DatadogLoggingConfiguration` | | `RumConfiguration` | `DatadogRumConfiguration` | | `DdSdkExistingConfiguration` | `DatadogAttachConfiguration` | @@ -785,28 +1311,28 @@ Las siguientes propiedades han cambiado: | 1.x | 2.x | Notas | |-------|-------|-------| -| `DdSdkConfiguration.trackingConsent`| Eliminada | Parte de `Datadog.initialize` | | -| `DdSdkConfiguration.customEndpoint` | Eliminada | Ahora se configura por característica | | +| `DdSdkConfiguration.trackingConsent`| Eliminado | Parte de `Datadog.initialize` | | +| `DdSdkConfiguration.customEndpoint` | Eliminado | Ahora configurado por función | | | `DdSdkConfiguration.serviceName` | `DatadogConfiguration.service` | | | `DdSdkConfiguration.logEventMapper` | `DatadogLoggingConfiguration.eventMapper` | | | `DdSdkConfiguration.customLogsEndpoint` | `DatadogLoggingConfiguration.customEndpoint` | | | `DdSdkConfiguration.telemetrySampleRate` | `DatadogRumConfiguration.telemetrySampleRate` | | -Además, han cambiado las siguientes API: +Además, las siguientes API han cambiado: | 1.x | 2.x | Notas | |-------|-------|-------| -| `Verbosity` | Eliminada | Consulta `CoreLoggerLevel` o `LogLevel` | +| `Verbosity` | Eliminado | Ver `CoreLoggerLevel` o `LogLevel` | | `DdLogs DatadogSdk.logs` | `DatadogLogging DatadogSdk.logs` | Tipo cambiado | | `DdRum DatadogSdk.rum` | `DatadogRum DatadogSdk.rum` | Tipo cambiado | `Verbosity DatadogSdk.sdkVerbosity` | `CoreLoggerLevel DatadogSdk.sdkVerbosity` | -| `DatadogSdk.runApp` | `DatadogSdk.runApp` | Se ha añadido el parámetro `trackingConsent` | -| `DatadogSdk.initialize` | `DatadogSdk.initialize` | Se ha añadido el parámetro `trackingConsent` | +| `DatadogSdk.runApp` | `DatadogSdk.runApp` | Se agregó el parámetro `trackingConsent` | +| `DatadogSdk.initialize` | `DatadogSdk.initialize` | Se agregó el parámetro `trackingConsent` | | `DatadogSdk.createLogger` | `DatadogLogging.createLogger` | Movido | -## Cambios de Flutter Web +## Cambios en Flutter Web {#flutter-web-changes} -Los clientes que utilicen Flutter Web deben actualizarse para utilizar el SDK de navegador de Datadog v5. Cambia la siguiente importación en tu `index.html`: +Los clientes que usan Flutter Web deben actualizarse al uso del SDK de navegador de Datadog v5. Cambie la siguiente importación en su `index.html`: ```diff - @@ -815,34 +1341,34 @@ Los clientes que utilicen Flutter Web deben actualizarse para utilizar el SDK de + ``` -**Nota**: Datadog proporciona un paquete CDN por sitio. Consulta [README del SDK de navegador](https://github.com/DataDog/browser-sdk/#cdn-bundles) para obtener una lista de todas las URLs de los sitios. +**Nota**: Datadog proporciona un paquete CDN por sitio. Consulte el [README del SDK del navegador](https://github.com/DataDog/browser-sdk/#cdn-bundles) para obtener una lista de todas las URL del sitio. -## Cambios en los productos de logs +## Cambios en el producto Logs {#logs-product-changes} -Al igual que en v1, el registro de Datadog puede activarse configurando el miembro `DatadogConfiguration.loggingConfiguration`. Sin embargo, a diferencia de v1, Datadog no crea un registrador por defecto para ti. `DatadogSdk.logs` es ahora una instancia de `DatadogLogging`, que puede usarse para crear logs. Muchas opciones se han movido a `DatadogLoggerConfiguration` para dar a los desarrolladores una compatibilidad más detallada sobre registradores individuales. +Al igual que en la v1, Datadog Logs se puede habilitar configurando el miembro `DatadogConfiguration.loggingConfiguration`. Sin embargo, a diferencia de la v1, Datadog no crea un logger predeterminado para usted. `DatadogSdk.logs` ahora es una instancia de `DatadogLogging`, que se puede usar para crear Logs. Muchas opciones se movieron a `DatadogLoggerConfiguration` para brindar a los desarrolladores un soporte más granular sobre los loggers individuales. Las siguientes API han cambiado: | 1.x | 2.x | Notas | |-------|-------|-------| -| `LoggingConfiguration` | `DatadogLoggingConfiguration` | La mayoría de los miembros renombrados están ahora en `DatadogLoggerConfiguration` | +| `LoggingConfiguration` | `DatadogLoggingConfiguration` | La mayoría de los miembros renombrados ahora están en `DatadogLoggerConfiguration` | | `LoggingConfiguration.sendNetworkInfo` | `DatadogLoggerConfiguration.networkInfoEnabled` | | | `LoggingConfiguration.printLogsToConsole` | `DatadogLoggerConfiguration.customConsoleLogFunction` | | -| `LoggingConfiguration.sendLogsToDatadog` | Eliminado. Utiliza `remoteLogThreshold` en su lugar | | +| `LoggingConfiguration.sendLogsToDatadog` | Eliminado. Use `remoteLogThreshold` en su lugar | | | `LoggingConfiguration.datadogReportingThreshold` | `DatadogLoggerConfiguration.remoteLogThreshold` | | | `LoggingConfiguration.bundleWithRum` | `DatadogLoggerConfiguration.bundleWithRumEnabled` | | | `LoggingConfiguration.bundleWithTrace` | `DatadogLoggerConfiguration.bundleWithTraceEnabled` | | | `LoggingConfiguration.loggerName` | `DatadogLoggerConfiguration.name` | | | `LoggingConfiguration.sampleRate` | `DatadogLoggerConfiguration.remoteSampleRate` | | -## Cambios en los productos de RUM +## Cambios en el producto RUM {#rum-product-changes} Las siguientes API han cambiado: | 1.x | 2.x | Notas | |-------|-------|-------| | `RumConfiguration` | `DatadogRumConfiguration` | Tipo renombrado | -| `RumConfiguration.vitalsUpdateFrequency` | `DatadogRumConfiguration.vitalsUpdateFrequency` | Establecer en `null` para desactivar las actualizaciones vitales | +| `RumConfiguration.vitalsUpdateFrequency` | `DatadogRumConfiguration.vitalsUpdateFrequency` | Establezca en `null` para deshabilitar las actualizaciones de signos vitales | | `RumConfiguration.tracingSampleRate` | `DatadogRumConfiguration.traceSampleRate` | | `RumConfiguration.rumViewEventMapper` | `DatadogRumConfiguration.viewEventMapper` | | `RumConfiguration.rumActionEventMapper` | `DatadogRumConfiguration.actionEventMapper` | @@ -857,7 +1383,7 @@ Las siguientes API han cambiado: | `DdRum.stopResourceLoading` | `DdRum.stopResource` | | | `DdRum.stopResourceLoadingWithError` | `DdRum.stopResourceWithError` | | -Además, los asignadores de evento ya no permiten modificar los nombres de sus vistas. Para cambiar el nombre de una vista, utiliza en su lugar un [`ViewInfoExtractor`](https://pub.dev/documentation/datadog_flutter_plugin/latest/datadog_flutter_plugin/ViewInfoExtractor.html) personalizado. +Además, los asignadores de eventos ya no le permiten modificar los nombres de visualización. Para cambiar el nombre de una visualización, utilice un [`ViewInfoExtractor`](https://pub.dev/documentation/datadog_flutter_plugin/latest/datadog_flutter_plugin/ViewInfoExtractor.html) personalizado en su lugar. {{% /tab %}} @@ -865,6 +1391,6 @@ Además, los asignadores de evento ya no permiten modificar los nombres de sus v {{< /tabs >}} -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/es/real_user_monitoring/guide/session-replay-for-solutions.md b/hugo/content/es/real_user_monitoring/guide/session-replay-for-solutions.md new file mode 100644 index 00000000000..68404c023d4 --- /dev/null +++ b/hugo/content/es/real_user_monitoring/guide/session-replay-for-solutions.md @@ -0,0 +1,75 @@ +--- +description: Aprenda a adoptar RUM y Session Replay en su organización de Soluciones + o Soporte. +further_reading: +- link: /real_user_monitoring/correlate_with_other_telemetry/apm/ + tag: Documentación + text: Aprenda a conectar RUM con trazas de APM +- link: /session_replay/ + tag: Documentación + text: Más información sobre Session Replay +- link: /session_replay/dev_tools + tag: Documentación + text: Aprenda sobre las herramientas de desarrollo del navegador (Browser Dev Tools) +title: Utilice Session Replay en su flujo de trabajo de soporte técnico +--- +## Descripción general {#overview} + +Puede habilitar a sus equipos de soluciones técnicas y de soporte para solucionar mejor los problemas de los clientes mediante [Session Replay][1]. Con RUM y Session Replay, puede localizar sesiones de usuario específicas, observar los recorridos de los usuarios y acceder a herramientas de desarrollo para ver eventos, registros, errores y atributos. + +Esta guía describe un flujo de trabajo que las organizaciones pueden replicar y usar como un activo para que los equipos de soluciones lo integren en sus flujos de trabajo. + +{{< img src="real_user_monitoring/guide/session-replay/session-replay-recording.png" alt="Grabación de Session Replay de una sesión de usuario en la aplicación Shopist" style="width:100%;">}} + +## Evalúe los problemas de los usuarios {#assess-user-issues} + +Suponga que un cliente encuentra un problema al usar Datadog. Su equipo de Soluciones Técnicas puede usar una solución de soporte, como Zendesk o ServiceNow, que crea un ticket cuando este cliente informa que no puede actualizar o guardar una prueba de API en varios pasos de Synthetics. + +El equipo puede solicitar más información al cliente (como el ID de prueba específico y una grabación de pantalla con las [Browser Dev Tools][2] abiertas) que pueda proporcionar contexto adicional sobre por qué la prueba del cliente no se actualiza o guarda. Si no se registraron errores de consola, el equipo no tendría ninguna pista para comenzar a investigar el problema de la prueba de API en varios pasos. + +El equipo de Soluciones Técnicas puede intentar comprender las siguientes preguntas: + +- ¿Cuál es el error exacto que está experimentando el cliente? +- ¿El cliente está viendo una notificación en la aplicación que indique un problema en particular (como un error de consola o un mensaje de error)? +- ¿En qué botones hizo clic el cliente y en qué orden? ¿Ocurrió una acción inesperada antes de que el cliente hiciera clic en un botón? + +## Investigue la causa raíz {#investigate-the-root-cause} + +Si hubiera una forma de visualizar el recorrido del usuario del cliente en Datadog y ver las solicitudes de backend asociadas, el equipo de Soluciones Técnicas tendría una mejor comprensión de lo que podría estar causando este problema. + +{{< img src="real_user_monitoring/guide/session-replay/apm-traces-in-session-replay.png" alt="Una traza de pila de APM asociada con una acción de visualizar de RUM." style="width:100%;">}} + +Con la integración de APM, puede conectar solicitudes de su aplicación web con las trazas de backend correspondientes para acceder a los datos de traza de APM desde un evento de RUM y descubrir cualquier error de backend en la pestaña {{< ui >}}Errors{{< /ui >}}. + +Para obtener más información, consulte [Conectar RUM y trazas][3]. + +## Vea sesiones de usuario en Session Replay {#watch-user-sessions-in-session-replay} + +El equipo de Soluciones Técnicas puede tener herramientas internas que conectan una plataforma de soporte, como Zendesk, con productos de Datadog, como RUM & Session Replay. Por ejemplo, un enlace contextual en Zendesk puede redirigirlo al [Explorador de RUM][4] y completar automáticamente el ID de usuario en la consulta de búsqueda. Filtre por sesiones de usuario individuales desde la lista de eventos. + +El equipo de Soluciones Técnicas puede usar Session Replay para visualizar una réplica del recorrido del usuario en Datadog y usar las herramientas de desarrollo del navegador para acceder a errores adicionales que puedan aparecer en el frontend. Con acceso a errores de frontend y trazas de backend, su equipo de Soluciones Técnicas está facultado para utilizar la integración de RUM & Session Replay y APM para ayudar a solucionar problemas de los clientes. + +Haga clic en una sesión de usuario con una grabación de reproducción para observar el comportamiento del usuario en la plataforma Datadog. Al usar Session Replay, puede localizar los eventos de RUM correspondientes e identificar la acción `click` específica para guardar la prueba de API en varios pasos. Hacer clic en {{< ui >}}Save{{< /ui >}} en la interfaz de usuario activa la llamada de backend para guardar la configuración de la prueba. + +## Descubra errores en las trazas de backend {#uncover-errors-in-backend-traces} + +Al examinar los errores en la traza de APM de la prueba de API en varios pasos, el equipo de Soluciones Técnicas puede encontrar un `APIInvalidInputError` relacionado con el `maxLength` de una configuración `​​https://properties.steps.items.properties.name/`, que parece ser la causa raíz del error al guardar la prueba. + +{{< img src="real_user_monitoring/guide/session-replay/view-traces.png" alt="Una traza de pila de APM asociada con una acción de visualizar de RUM." style="width:100%;">}} + +La prueba de API en varios pasos no se guardó debido a un límite de caracteres en el nombre del paso. + +## Resuelva los problemas de los usuarios {#resolve-user-problems} + +Para resolver este problema del cliente, el equipo de Soluciones Técnicas puede solicitar al equipo de Producto que actualice el flujo de trabajo de la prueba de API en varios pasos con ayuda contextual para cuando una prueba no se pueda guardar. + +También se puede alentar al equipo de Frontend a implementar un mensaje de error en la interfaz de usuario que garantice que los usuarios sean notificados cuando superen el límite máximo de caracteres para el nombre del paso de la prueba. + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/session_replay/ +[2]: /es/session_replay/dev_tools +[3]: /es/real_user_monitoring/connect_rum_and_traces +[4]: https://app.datadoghq.com/rum/explorer \ No newline at end of file diff --git a/hugo/content/es/real_user_monitoring/guide/upload-javascript-source-maps.md b/hugo/content/es/real_user_monitoring/guide/upload-javascript-source-maps.md index 2471be3b317..6601a638040 100644 --- a/hugo/content/es/real_user_monitoring/guide/upload-javascript-source-maps.md +++ b/hugo/content/es/real_user_monitoring/guide/upload-javascript-source-maps.md @@ -1,43 +1,46 @@ --- -description: Suba mapas del código fuente de JavaScript para mejorar el seguimiento - de errores con trazas de pila legibles y una mejor depuración para el código minificado. +description: Cargue los mapas del código fuente de JavaScript para mejorar Error Tracking + con trazas de pila legibles y una mejor depuración para código minificado. further_reading: - link: /real_user_monitoring/error_tracking tag: Documentación - text: Comience con el seguimiento de errores. + text: Comience con Error Tracking - link: /real_user_monitoring/error_tracking/explorer tag: Documentación - text: Visualice sus datos de seguimiento de errores en el Explorador. -- link: https://github.com/DataDog/datadog-ci/tree/master/packages/base/src/commands/sourcemaps - tag: Código fuente - text: Referencia de comandos de mapas del código fuente + text: Visualice sus datos de Error Tracking en el explorador - link: https://learn.datadoghq.com/courses/tracking-errors-rum-javascript tag: Centro de aprendizaje - text: Seguimiento de errores con RUM para aplicaciones web de JavaScript -title: Suba mapas del código fuente de JavaScript. + text: Seguimiento de errores con RUM para aplicaciones web JavaScript +- link: https://www.datadoghq.com/blog/a-practical-guide-to-react-error-monitoring/ + tag: Blog + text: Una guía práctica para el monitoreo de errores en React +- link: https://github.com/DataDog/datadog-ci/tree/master/packages/base/src/commands/sourcemaps + tag: Código fuente + text: Referencia del comando de mapas del código fuente +title: Cargue los mapas del código fuente de JavaScript --- -## Resumen {#overview} +## Descripción general {#overview} -Si su código fuente de JavaScript del lado del cliente está minificado, suba sus mapas del código fuente a Datadog para desofuscar las trazas de pila. Para cualquier error dado, puede acceder a la ruta del archivo, al número de línea y al fragmento de código para cada marco de la traza de pila relacionada. Datadog también puede vincular los marcos de la pila a su código fuente en su repositorio. +Si su código fuente de JavaScript de front-end está minificado, cargue sus mapas del código fuente en Datadog para desofuscar sus diferentes trazas de pila. Para cualquier error determinado, puede acceder a la ruta del archivo, el número de línea y el fragmento de código para cada marco de la traza de pila relacionada. Datadog también puede vincular marcos de la traza de pila a su código fuente en su repositorio. -
+
-## Instrumenta su código {#instrument-your-code} +## Instrumente su código {#instrument-your-code} -Configure su empaquetador de JavaScript de tal manera que, al minificar su código fuente, se generen mapas de origen que incluyan directamente el código fuente relacionado en el `sourcesContent` atributo. +Configure su empaquetador de JavaScript de tal manera que, al minificar su código fuente, genere mapas del código fuente que incluyan directamente el código fuente relacionado en el atributo `sourcesContent`.
Asegúrese de que el tamaño de cada mapa del código fuente aumentado con el tamaño del archivo minificado relacionado no exceda el límite de 500 MB.
-Consulta las siguientes configuraciones para empaquetadores de JavaScript populares. +Consulte las siguientes configuraciones para los empaquetadores de JavaScript populares. {{< tabs >}} {{% tab "WebpackJS" %}} -Puede generar mapas del código fuente utilizando el complemento incorporado de webpack llamado [SourceMapDevToolPlugin][1]. +Puede generar mapas del código fuente utilizando el complemento integrado de webpack llamado [SourceMapDevToolPlugin][1]. -Vea la configuración de ejemplo en su archivo `webpack.config.js`: +Consulte la configuración de ejemplo en su archivo `webpack.config.js`: ```javascript // ... @@ -67,14 +70,14 @@ module.exports = { {{% /tab %}} {{% tab "ParcelJS" %}} -Parcel genera mapas del código fuente por defecto al ejecutar el comando de construcción: `parcel build `. +Parcel genera mapas del código fuente de forma predeterminada cuando ejecuta el comando de compilación: `parcel build `. {{% /tab %}} {{% tab "Vite" %}} Puede generar mapas del código fuente configurando la opción `build.sourcemap` en su archivo `vite.config.js`. -Vea la configuración de ejemplo: +Consulte el ejemplo de configuración: ```javascript // vite.config.js @@ -88,14 +91,14 @@ export default defineConfig({ }) ``` -**Nota**: Si está utilizando TypeScript, asegúrese de que `compilerOptions.sourceMap` esté establecido en `true` en su archivo `tsconfig.json`. +**Nota**: Si está utilizando TypeScript, asegúrese de que `compilerOptions.sourceMap` esté configurado en `true` en su archivo `tsconfig.json`. {{% /tab %}} {{< /tabs >}} -Después de construir su aplicación, los empaquetadores generan un directorio (típicamente llamado `dist`) con archivos JavaScript minificados ubicados junto a sus correspondientes mapas del código fuente. +Después de compilar su aplicación, los empaquetadores generan un directorio (normalmente llamado `dist`) con archivos JavaScript minificados ubicados junto con sus mapas del código fuente correspondientes. -Vea el siguiente ejemplo: +Consulte el siguiente ejemplo: ```bash ./dist @@ -107,16 +110,80 @@ Vea el siguiente ejemplo: ```
-Si la suma del tamaño del archivo para javascript.364758.min.js y javascript.364758.js.map excede el límite de 500 MB, redúzcalo configurando su empaquetador para dividir el código fuente en múltiples fragmentos más pequeños. Para más información, consulte División de Código con WebpackJS. +Si la suma del tamaño del archivo para javascript.364758.min.js y javascript.364758.js.map excede el límite de 500 MB, redúzcala configurando su empaquetador para dividir el código fuente en varios fragmentos más pequeños. Para obtener más información, consulte División de código con WebpackJS.
-## Suba sus mapas del código fuente {#upload-your-source-maps} +## Cargue sus mapas del código fuente {#upload-your-source-maps} + +Para cargar sus mapas del código fuente, elija uno de los siguientes métodos de coincidencia: ID de depuración (recomendado) o servicio y versión. Los ID de depuración permiten la resolución de mapas del código fuente en micro frontends. + +{{< tabs >}} +{{% tab "ID de depuración (recomendado)" %}} + +Los ID de depuración asocian un paquete de JavaScript con su mapa del código fuente sin depender de la URL del paquete, el servicio o la versión de lanzamiento. + +Elija uno de los siguientes métodos de carga. + +#### Complementos de compilación de Datadog {#datadog-build-plugins} + +Los complementos de compilación de Datadog pueden inyectar ID de depuración y cargar mapas del código fuente directamente durante la compilación. No necesita instalar ni ejecutar `datadog-ci` por separado. + +La compatibilidad con ID de depuración requiere [Datadog Build Plugins versión 3.3.0](https://github.com/DataDog/build-plugins/releases/tag/v3.3.0) o posterior. + +Habilite la inyección de ID de depuración y la carga de mapas del código fuente en su complemento de compilación: + +```javascript +datadogWebpackPlugin({ + auth: { + apiKey: process.env.DATADOG_API_KEY, + site: 'datadoghq.com', + }, + sourcemaps: { + debugId: true, + upload: true, + }, +}); +``` + +El complemento carga cada mapa del código fuente con el ID de depuración inyectado en su paquete de JavaScript correspondiente. + +Este ejemplo utiliza webpack. Consulte [Datadog Build Plugins][8] para obtener instrucciones de instalación y configuración para otros empaquetadores compatibles. + +#### `datadog-ci` {#datadog-ci} + +La compatibilidad con ID de depuración requiere [`@datadog/datadog-ci` la versión 5.24.0](https://github.com/DataDog/datadog-ci/releases/tag/v5.24.0) o posterior. + +1. Agregue `@datadog/datadog-ci` a su archivo `package.json` (asegúrese de estar utilizando la versión más reciente). +2. [Cree una clave de API de Datadog dedicada][6] y expórtela como una variable de entorno llamada `DD_API_KEY`. +3. Para sitios distintos a US1, configure la CLI exportando `DD_SITE` con su [sitio de Datadog][7]. +4. Inyecte los ID de depuración después de la compilación: + + ```bash + datadog-ci sourcemaps inject /path/to/dist + ``` + +5. Cargue los mapas del código fuente y los paquetes de JavaScript correspondientes: + + ```bash + datadog-ci sourcemaps upload /path/to/dist --debug-id + ``` + +No pase `--service`, `--release-version` o `--minified-path-prefix` con `--debug-id`. + +El comando `inject` modifica los paquetes de JavaScript y los mapas del código fuente en el lugar. Ejecútelo después de la compilación y antes de generar artefactos dependientes de bytes, como hashes SRI, activos comprimidos, firmas o manifiestos de suma de comprobación. Implemente los mismos artefactos modificados que cargue. -La mejor manera de subir mapas del código fuente es agregar un paso adicional en su pipeline de CI y ejecutar el comando dedicado desde el [Datadog CLI][1]. Escanea el directorio `dist` y sus subdirectorios para cargar automáticamente los mapas del código fuente con los archivos minificados relevantes. +[6]: https://app.datadoghq.com/organization-settings/api-keys +[7]: /es/getting_started/site/ +[8]: /es/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps/ + +{{% /tab %}} +{{% tab "Servicio y versión" %}} + +Para cargar mapas del código fuente utilizando un servicio y una versión, agregue un paso adicional a su canalización de CI que ejecute el comando `datadog-ci sourcemaps upload`. Escanea el directorio `dist` y sus subdirectorios para cargar automáticamente los mapas del código fuente con los archivos minificados relevantes. {{< site-region region="us" >}} -1. Agregue `@datadog/datadog-ci` a su archivo `package.json` (asegúrese de estar utilizando la última versión). -2. [Cree una clave API dedicada de Datadog][1] y expórtela como una variable de entorno llamada `DATADOG_API_KEY`. +1. Agregue `@datadog/datadog-ci` a su archivo `package.json` (asegúrese de estar utilizando la versión más reciente). +2. [Cree una clave de API de Datadog dedicada][1] y expórtela como una variable de entorno llamada `DD_API_KEY`. 3. Ejecute el siguiente comando una vez por servicio en su aplicación: ```bash @@ -130,11 +197,11 @@ La mejor manera de subir mapas del código fuente es agregar un paso adicional e [1]: https://app.datadoghq.com/organization-settings/api-keys {{< /site-region >}} -{{< site-region region="eu,us3,us5,gov,gov2,ap1,ap2" >}} -1. Agregue `@datadog/datadog-ci` a su archivo `package.json` (asegúrese de estar utilizando la última versión). -2. [Cree una clave API dedicada de Datadog][1] y expórtela como una variable de entorno llamada `DATADOG_API_KEY`. -3. Configure la CLI para cargar archivos en el {{}} sitio exportando dos variables de entorno: `export DATADOG_SITE=`{{}} y `export DATADOG_API_HOST=api.`{{}}. -4. Ejecuta el siguiente comando una vez por servicio en tu aplicación: +{{< site-region region="eu,us3,us5,gov,gov2,ap1,ap2,uk1" >}} +1. Agregue `@datadog/datadog-ci` a su archivo `package.json` (asegúrese de estar utilizando la versión más reciente). +2. [Cree una clave de API de Datadog dedicada][1] y expórtela como una variable de entorno llamada `DD_API_KEY`. +3. Configure la CLI para cargar archivos al {{}} sitio exportando dos variables de entorno: `export DATADOG_SITE=`{{}} y `export DATADOG_API_HOST=api.`{{}}. +4. Ejecute el siguiente comando una vez por servicio en su aplicación: ```bash datadog-ci sourcemaps upload /path/to/dist \ --service my-service \ @@ -146,46 +213,68 @@ La mejor manera de subir mapas del código fuente es agregar un paso adicional e [1]: https://app.datadoghq.com/organization-settings/api-keys {{< /site-region >}} -Para minimizar la sobrecarga en el rendimiento de su CI, la CLI está optimizada para cargar tantos mapas del código fuente como necesite en un corto período de tiempo (típicamente unos pocos segundos). +Para minimizar la sobrecarga en el rendimiento de su CI, la CLI está optimizada para cargar tantos mapas del código fuente como necesite en un corto período de tiempo (normalmente unos pocos segundos). -**Nota**: Volver a cargar un mapa del código fuente no reemplaza el existente si la versión no ha cambiado. +**Nota**: Volver a cargar un mapa del código fuente no sobrescribe el existente si la versión no ha cambiado. -Los parámetros `--service` y `--release-version` deben coincidir con las etiquetas `service` y `version` en sus eventos de seguimiento de errores, eventos de RUM y registros del navegador. Para más información sobre cómo configurar estas etiquetas, consulta la [documentación de inicialización del SDK del navegador][2] o la [documentación de recopilación de registros del navegador][3]. +Los parámetros `--service` y `--release-version` deben coincidir con las etiquetas `service` y `version` en sus eventos de Error Tracking, eventos de RUM y registros de navegador. Para obtener más información sobre cómo configurar estas etiquetas, consulte la [Browser SDK initialization documentation][2] o la [Browser Logs Collection documentation][3]. -
Si ha definido múltiples servicios en su aplicación, ejecute el comando de CI tantas veces como servicios haya, incluso si tiene un conjunto de mapas de origen para toda la aplicación.
+
Si ha definido varios servicios en su aplicación, ejecute el comando de CI tantas veces como servicios haya, incluso si tiene un conjunto de mapas del código fuente para toda la aplicación.
-Al ejecutar el comando contra el directorio de ejemplo `dist`, Datadog espera que su servidor o CDN entregue los archivos JavaScript en `https://hostname.com/static/js/javascript.364758.min.js` y `https://hostname.com/static/js/subdirectory/javascript.464388.min.js`. +Al ejecutar el comando en el directorio de ejemplo `dist`, Datadog espera que su servidor o CDN entregue los archivos JavaScript en `https://hostname.com/static/js/javascript.364758.min.js` y `https://hostname.com/static/js/subdirectory/javascript.464388.min.js`. -Solo los mapas del código fuente con la extensión `.js.map` funcionan para desminificar correctamente las trazas de pila. Los mapas del código fuente con otras extensiones como `.mjs.map` son aceptados pero no desminifican las trazas de pila. +Solo los mapas del código fuente con la extensión `.js.map` funcionan para desminificar correctamente las trazas de pila. Los mapas del código fuente con otras extensiones como `.mjs.map` se aceptan, pero no desminifican las trazas de pila. -
Si está sirviendo los mismos archivos fuente de JavaScript desde diferentes subdominios, cargue el mapa del código fuente relacionado una vez y haga que funcione para múltiples subdominios utilizando la ruta de prefijo absoluto en lugar de la URL completa. Por ejemplo, especifique /static/js en lugar de https://hostname.com/static/js.
+
Si está sirviendo los mismos archivos de código fuente JavaScript desde diferentes subdominios, cargue el mapa del código fuente relacionado una vez y haga que funcione para múltiples subdominios utilizando la ruta de prefijo absoluta en lugar de la URL completa. Por ejemplo, especifique /static/js en lugar de https://hostname.com/static/js.
-Vea todos los símbolos subidos y administre sus mapas del código fuente en la página de [Explore RUM Debug Symbols][5]. +[2]: /es/real_user_monitoring/application_monitoring/browser/setup/#initialization-parameters +[3]: /es/logs/log_collection/javascript/#initialization-parameters + +{{% /tab %}} +{{< /tabs >}} -### Vincule los marcos de pila a su código fuente {#link-stack-frames-to-your-source-code} +Vea todos los símbolos cargados y administre sus mapas del código fuente en la página [{{< ui >}}Explore RUM Debug Symbols{{< /ui >}}][5]. -Si ejecuta `datadog-ci sourcemaps upload` dentro de un directorio de trabajo de Git, Datadog recopila metadatos del repositorio. El comando `datadog-ci` recopila la URL del repositorio, el hash del commit actual y la lista de rutas de archivos en el repositorio que se relacionan con sus mapas del código fuente. Para más detalles sobre la recopilación de metadatos de Git, consulte la [documentación de datadog-ci][4]. +### Vincule los marcos de la traza de pila a su código fuente {#link-stack-frames-to-your-source-code} + +Si ejecuta `datadog-ci sourcemaps upload` dentro de un directorio de trabajo de Git, Datadog recopila metadatos del repositorio. El comando `datadog-ci` recopila la URL del repositorio, el hash de confirmación actual y la lista de rutas de archivo en el repositorio que se relacionan con sus mapas del código fuente. Para obtener más detalles sobre la recopilación de metadatos de Git, consulte la [documentación de datadog-ci][4]. + +Datadog muestra enlaces a su código fuente en marcos de la traza de pila no minificados. + +## Solución de problemas de cargas de ID de depuración {#troubleshooting-debug-id-uploads} + +### Inspeccionar mapas del código fuente locales {#inspect-local-source-maps} + +Para encontrar el mapa del código fuente local para un ID de depuración específico, ejecute: + +```bash +datadog-ci sourcemaps find /path/to/dist --debug-id 12345678-1234-1234-1234-123456789abc +``` + +Para encontrar mapas del código fuente que no contienen un ID de depuración, ejecute: + +```bash +datadog-ci sourcemaps find /path/to/dist --missing-debug-id +``` -Datadog muestra enlaces a su código fuente en marcos de pila no minificados. +El comando `find` solo inspecciona archivos `*.js.map` locales. No confirma si Datadog recibió un artefacto. ## Solucione errores con facilidad {#troubleshoot-errors-with-ease} -Sin acceso a la ruta del archivo y al número de línea, un rastro de pila minificado no es útil para solucionar problemas en su base de código. Además, el fragmento de código está minificado (lo que significa que hay una línea larga de código transformado), lo que dificulta más el proceso de solución de problemas. +Sin acceso a la ruta del archivo y al número de línea, una traza de pila minificada no es útil para solucionar problemas en su base de código. Además, el fragmento de código está minificado (lo que significa que hay una línea larga de código transformado), lo que dificulta el proceso de solución de problemas. -El siguiente ejemplo muestra un rastro de pila minificado: +El siguiente ejemplo muestra una traza de pila minificada: -{{< img src="real_user_monitoring/error_tracking/minified_stacktrace.png" alt="Error Tracking Minified Stack Trace" >}} +{{< img src="real_user_monitoring/error_tracking/minified_stacktrace.png" alt="Traza de pila minificada de Error Tracking" >}} -Por otro lado, un rastro de pila no minificado le proporciona todo el contexto que necesita para una solución de problemas rápida y sin inconvenientes. Para los marcos de pila que se relacionan con su código fuente, Datadog también genera un enlace directo a su repositorio: +Por otro lado, una traza de pila no minificada le proporciona todo el contexto que necesita para una solución de problemas rápida y sin inconvenientes. Para los marcos de pila relacionados con su código fuente, Datadog también genera un enlace directo a su repositorio: -{{< img src="real_user_monitoring/error_tracking/unminified_stacktrace.png" alt="Error Tracking Unminified Stack Trace" >}} +{{< img src="real_user_monitoring/error_tracking/unminified_stacktrace.png" alt="Traza de pila no minificada de Error Tracking" >}} -## Lectura Adicional {#further-reading} +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: https://github.com/DataDog/datadog-ci/tree/master/packages/base/src/commands/sourcemaps -[2]: https://docs.datadoghq.com/es/real_user_monitoring/application_monitoring/browser/setup/#initialization-parameters -[3]: https://docs.datadoghq.com/es/logs/log_collection/javascript/#initialization-parameters [4]: https://github.com/DataDog/datadog-ci/tree/master/packages/base/src/commands/sourcemaps#link-errors-with-your-source-code [5]: https://app.datadoghq.com/source-code/setup/rum \ No newline at end of file diff --git a/hugo/content/es/security/application_security/agentic_onboarding.md b/hugo/content/es/security/application_security/agentic_onboarding.md new file mode 100644 index 00000000000..002db5ea096 --- /dev/null +++ b/hugo/content/es/security/application_security/agentic_onboarding.md @@ -0,0 +1,6 @@ +--- +description: Instrumente sus aplicaciones con App and API Protection utilizando la + AI Setup CLI o el Datadog MCP Server. +title: Agentic Onboarding para App and API Protection +--- +{{< include-markdown "agentic_onboarding/setup" >}} \ No newline at end of file diff --git a/hugo/content/es/security/application_security/api_posture/api_findings.md b/hugo/content/es/security/application_security/api_posture/api_findings.md index 95871cdf677..ae65de83251 100644 --- a/hugo/content/es/security/application_security/api_posture/api_findings.md +++ b/hugo/content/es/security/application_security/api_posture/api_findings.md @@ -1,15 +1,9 @@ --- -description: El triage detectó riesgos de API en definiciones, gateways y tráfico +description: El triaje detectó riesgos de API en definiciones, gateways y tráfico en vivo. title: Hallazgos de API --- -{{< site-region region="gov" >}} -
-App and API Protection se encuentra en versión preliminar en el sitio de Datadog Government US1-FED. -
-{{< /site-region >}} - -El explorador de [Hallazgos de API][1] proporciona una vista central de triage de los riesgos de API detectados en sus definiciones, gateways y tráfico en vivo. Las reglas predeterminadas detectan vulnerabilidades y configuraciones incorrectas comunes. También puede agregar [reglas personalizadas][2] para casos de uso específicos. +El explorador de [Hallazgos de API][1] proporciona una vista central de triaje de los riesgos de API detectados en sus definiciones, gateways y tráfico en vivo. Las reglas predeterminadas detectan vulnerabilidades y configuraciones incorrectas comunes. También puede agregar [reglas personalizadas][2] para casos de uso específicos. Columnas de **Hallazgos de API**: diff --git a/hugo/content/es/security/application_security/setup/aws/waf/_index.md b/hugo/content/es/security/application_security/setup/aws/waf/_index.md index 74f9efae9e5..3aeb45c86d3 100644 --- a/hugo/content/es/security/application_security/setup/aws/waf/_index.md +++ b/hugo/content/es/security/application_security/setup/aws/waf/_index.md @@ -5,7 +5,7 @@ further_reading: text: Cómo funciona App and API Protection - link: /security/application_security/waf-integration/ tag: Documentación - text: Más información sobre las integraciones de WAF + text: Más información sobre las Integrations de WAF - link: /security/application_security/troubleshooting tag: Documentación text: Solución de problemas de protección de aplicaciones y API @@ -17,12 +17,6 @@ further_reading: text: Hacer un seguimiento de la actividad de AWS WAF con Datadog title: Habilitación de App and API Protection para AWS WAF --- -{{< site-region region="gov" >}} -
-App and API Protection se encuentra en versión preliminar en el sitio de Datadog Government US1-FED. -
-{{< /site-region >}} - App and API Protection se integra con AWS Web Application Firewall (WAF) mediante: 1. La conversión de registros en trazas para obtener visibilidad de las solicitudes monitoreadas y bloqueadas diff --git a/hugo/content/es/security/cloud_security_management/vulnerabilities/_index.md b/hugo/content/es/security/cloud_security_management/vulnerabilities/_index.md index a2303bb8ae6..9b1418a074c 100644 --- a/hugo/content/es/security/cloud_security_management/vulnerabilities/_index.md +++ b/hugo/content/es/security/cloud_security_management/vulnerabilities/_index.md @@ -118,7 +118,7 @@ Para habilitar este mapeo de código a la nube, agregue anotaciones de imagen OC Para configurar la vinculación de fuentes, consulte [Vincular Dockerfile a vulnerabilidades][22] en la guía de escaneo de imágenes de contenedor de CI/CD. ## Automatización e integración con Jira {#automation-and-jira-integration} -Haga que Cloud Security Vulnerabilities sea parte de su flujo de trabajo diario configurando [{{< ui >}}security notification rules{{< /ui >}}][17] y [pipelines de automatización (en vista previa)][20]: +Haga que Cloud Security Vulnerabilities sea parte de su flujo de trabajo diario configurando [{{< ui >}}security notification rules{{< /ui >}}][17] y [automation pipelines][20]: - Reciba una alerta tras la detección de una vulnerabilidad explotable para su contexto - Cree tickets de Jira automáticamente - Configure SLAs para remediar vulnerabilidades @@ -151,11 +151,10 @@ Evalúe rápidamente el impacto de una vulnerabilidad emergente crítica buscand [12]: /es/security/cloud_security_management/setup/agent [13]: /es/security/cloud_security_management/vulnerabilities/hosts_containers_compatibility [14]: /es/security/cloud_security_management/troubleshooting/vulnerabilities/ -[16]: https://www.datadoghq.com/product-preview/ecr-vulnerability-scanning/ [17]: https://app.datadoghq.com/security/configuration/notification-rules [18]: https://app.datadoghq.com/dash/integration/csm_vulnerabilities?fromUser=true&refresh_mode=sliding&from_ts=1733323465252&to_ts=1733928265252&live=true [19]: https://app.datadoghq.com/security/catalog/libraries -[20]: https://www.datadoghq.com/product-preview/security-automation-pipelines/ +[20]: /es/security/automation_pipelines/ [21]: /es/security/cloud_security_management/setup/ci_cd [22]: /es/security/cloud_security_management/setup/ci_cd/#link-dockerfile-to-vulnerabilities [23]: https://app.datadoghq.com/security/csm/vm?query=-%40risk.is_image_running%3Afalse%20%40status%3Aopen%20%40risk.has_exploit_available%3Atrue%20%40remediation.is_available%3Atrue%20%40severity%3A%28high%20OR%20critical%29%20%40vulnerability.is_inherited_from_base_image%3Atrue&group=none&order=desc&sort=score diff --git a/hugo/content/es/security/cloud_siem/detect_and_monitor/dynamic_severity.md b/hugo/content/es/security/cloud_siem/detect_and_monitor/dynamic_severity.md new file mode 100644 index 00000000000..ff026e2239d --- /dev/null +++ b/hugo/content/es/security/cloud_siem/detect_and_monitor/dynamic_severity.md @@ -0,0 +1,64 @@ +--- +aliases: +- /es/security/cloud_siem/detect_and_monitor/critical_assets/ +further_reading: +- link: /security/cloud_siem/detect_and_monitor/suppressions/ + tag: Documentación + text: Supresiones +products: +- icon: siem + name: Cloud SIEM + url: /security/cloud_siem/ +- icon: cloud-security-management + name: Workload Protection + url: /security/workload_protection/ +- icon: app-sec + name: App and API Protection + url: /security/application_security/ +title: Gravedad dinámica +--- +{{< product-availability >}} + +## Descripción general {#overview} + +La gravedad dinámica le permite ajustar la gravedad de las señales de seguridad según los activos a los que afectan. Esto ayuda a los analistas a priorizar las señales de acuerdo con la importancia comercial del activo afectado al aumentar, disminuir o mantener la gravedad predeterminada. Para cada activo, puede ajustar los niveles de gravedad, aplicar etiquetas personalizadas y aislar los cambios en reglas específicas. + +### Cómo funciona {#how-it-works} + +- Si se configuran varias reglas de gravedad dinámica para ajustar los niveles de gravedad de una señal de seguridad, la señal adopta automáticamente el nivel de gravedad más alto. Por ejemplo, si una regla de gravedad dinámica establece la gravedad en `MEDIUM` y otra la establece en `HIGH`, la gravedad es `HIGH`. +- Si se configuran varias reglas de gravedad dinámica para realizar la misma acción en los niveles de gravedad de una señal de seguridad, la acción solo se aplica una vez. Por ejemplo, si dos reglas de gravedad dinámica separadas están configuradas para aumentar el nivel de gravedad de una señal que está establecida en `MEDIUM`, solo aumenta una vez a `HIGH`, no nuevamente a `CRITICAL`. + +## Cree una regla de gravedad dinámica {#create-a-dynamic-severity-rule} + +1. En Datadog, vaya a {{< ui >}}Security{{< /ui >}} > {{< ui >}}Settings{{< /ui >}} > [{{< ui >}}Dynamic Severity{{< /ui >}}][1], luego haga clic en {{< ui >}}Create Dynamic Severity Rule{{< /ui >}}. Se abre la ventana Crear regla de gravedad dinámica. +1. En {{< ui >}}Define Asset{{< /ui >}}, ingrese una consulta para definir el activo. +1. En {{< ui >}}Choose Severity Adjustment{{< /ui >}}, elija cómo desea ajustar la gravedad de las señales de seguridad asociadas con el activo. + - Elija {{< ui >}}Increase{{< /ui >}} o {{< ui >}}Decrease{{< /ui >}} para comenzar con el nivel de gravedad predeterminado, luego aumente o disminuya la gravedad en un nivel. + - Elija {{< ui >}}Maintain{{< /ui >}} para mantener el nivel de gravedad predeterminado. + - Elija un nivel de gravedad específico para aplicar siempre ese nivel de gravedad, independientemente de la gravedad inicial asociada con la señal. +1. (Opcional) En {{< ui >}}Details{{< /ui >}}, agregue una descripción, etiquetas y equipos para aplicar a la regla de gravedad dinámica. +1. En {{< ui >}}Select Detection Rules{{< /ui >}}, ingrese reglas de detección específicas para limitar los cambios de gravedad. Para aplicar los cambios a todas las reglas de detección, establezca la consulta en `*`. +1. Haga clic en {{< ui >}}Save{{< /ui >}}. La ventana Crear regla de gravedad dinámica se cierra y su regla de gravedad dinámica aparece en la tabla, donde puede habilitarla o deshabilitarla, o exportar la configuración como archivos Terraform o JSON. + +## Visualizar las señales que afectó una regla de gravedad dinámica {#view-the-signals-a-dynamic-severity-rule-affected} + +1. En Datadog, vaya a {{< ui >}}Security{{< /ui >}} > {{< ui >}}Settings{{< /ui >}} > [{{< ui >}}Dynamic Severity{{< /ui >}}][1]. +1. Junto a una regla de gravedad dinámica, haga clic en el icono {{< ui >}}More Options{{< /ui >}} {{< img src="icons/kebab.png" inline="true" style="height:1em" >}}, luego haga clic en {{< ui >}}Signals affected{{< /ui >}}. El Explorador de señales, prellenado con una consulta para mostrar las señales afectadas, se abre en una nueva pestaña. + +## Visualizar datos de gravedad dinámica en señales de seguridad {#view-dynamic-severity-data-in-security-signals} + +En cada señal de seguridad que una regla de gravedad dinámica ha modificado, una píldora {{< ui >}}Adjusted Severity{{< /ui >}} indica tanto el nivel de gravedad original como el ajustado. Puede pasar el cursor sobre esa píldora para ver qué ajuste aplicó la regla de gravedad dinámica: +{{< img src="security/security_monitoring/critical_assets_pill.png" alt="Píldora y ventana emergente de Gravedad ajustada, que indica que la gravedad de una señal de CloudTrail aumentó de Baja a Media" style="width:50%;" >}} + +En la pestaña {{< ui >}}JSON{{< /ui >}} de una señal de seguridad, también puede encontrar el objeto `critical_assets_data`, que incluye información sobre las reglas de gravedad dinámica asociadas con ella y cómo afectaron la gravedad de la señal. +
Si el nivel de gravedad de una regla de gravedad dinámica fue anulado por un nivel de gravedad superior, es posible que no aparezca en el critical_assets_data objeto.
+ +## Restringir permisos de edición {#restrict-edit-permissions} + +{{% security-products/dynamic-severity-granular-access %}} + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/security/configuration/dynamic-severity \ No newline at end of file diff --git a/hugo/content/es/security/workload_protection/_index.md b/hugo/content/es/security/workload_protection/_index.md index 6f7b95093a0..2e92891c519 100644 --- a/hugo/content/es/security/workload_protection/_index.md +++ b/hugo/content/es/security/workload_protection/_index.md @@ -29,6 +29,12 @@ cascade: description: Detecte y responda a amenazas en tiempo de ejecución en sus servidores, contenedores y cargas de trabajo sin servidor con Datadog Workload Protection. further_reading: +- link: https://learn.datadoghq.com/courses/workload-protection-detect-compromises + tag: Centro de aprendizaje + text: Detecte compromisos de servidores y contenedores con Workload Protection +- link: https://learn.datadoghq.com/courses/workload-protection-enable-manage + tag: Centro de aprendizaje + text: Habilite y administre Workload Protection - link: https://www.datadoghq.com/blog/workload-protection-investigation/ tag: Blog text: Convierta señales fragmentadas de tiempo de ejecución en historias de ataque @@ -37,12 +43,6 @@ further_reading: tag: Blog text: Identifique y remedie problemas de postura en tiempo de ejecución con los hallazgos de Workload Protection -- link: https://learn.datadoghq.com/courses/workload-protection-detect-compromises - tag: Centro de aprendizaje - text: Detecte compromisos de servidores y contenedores con Workload Protection -- link: https://learn.datadoghq.com/courses/workload-protection-enable-manage - tag: Centro de aprendizaje - text: Habilite y administre Workload Protection title: Workload Protection --- Datadog Workload Protection proporciona visibilidad y defensa en tiempo real para su infraestructura mediante el monitoreo continuo de la actividad de archivos, red y procesos en sus entornos. Detecta amenazas a medida que ocurren, generando señales de seguridad y hallazgos. Úselos para identificar, investigar y detener comportamientos maliciosos antes de que afecten sus cargas de trabajo. @@ -88,13 +88,13 @@ En Linux y Windows, Workload Protection cubre más de 40 tipos de eventos, que a Las reglas del Agent realizan un filtrado ligero para que se ejecuten de manera eficiente en cada servidor. Datadog evalúa las correlaciones más complejas a través del tiempo y los procesos: 1. Las [reglas del Agent][6] evalúan la actividad del sistema en el servidor del Agent. -2. Cuando la actividad coincide con una expresión de regla del Agent, el Agent genera un [agent event][7] y lo envía a Datadog. -3. Datadog evalúa los agent events frente a [detection rules][8] y [finding rules][9]. -4. Si una regla de detección coincide, se genera una señal y se muestra en [Signals][10]. Si un atributo de agent event coincide con un [threat intelligence indicator][13], también se muestra el indicador correspondiente. -5. Si una finding rule coincide, se genera un hallazgo y se muestra en [Findings][11]. -6. Se activan todas las [notification rules][12] que coincidan con la gravedad, el tipo de regla, las etiquetas y los atributos de la señal. +2. Cuando la actividad coincide con una expresión de regla del Agent, el Agent genera un [evento de Agent][7] y lo envía a Datadog. +3. Datadog evalúa los eventos de Agents frente a [reglas de detection][8] y [reglas de hallazgos][9]. +4. Si una regla de detección coincide, se genera una señal y se muestra en [Signals][10]. Si un atributo de evento de Agent coincide con un [indicador de inteligencia de amenazas][13], también se muestra el indicador correspondiente. +5. Si una regla de hallazgo coincide, se genera un hallazgo y se muestra en [Findings][11]. +6. Se activan todas las [reglas de notificación][12] que coincidan con la gravedad, el tipo de regla, las etiquetas y los atributos de la señal. -Workload Protection se entrega con más de 350 Agent rules y 200 detection rules, que cubren la mayoría de las tácticas y técnicas de MITRE ATT&CK. También puede escribir las suyas propias, incluidas máquinas de estado en el Agent que alertan solo sobre indicadores de compromiso complejos. +Workload Protection se entrega con más de 350 Agent rules y 200 reglas de detección, que cubren la mayoría de las tácticas y técnicas de MITRE ATT&CK. También puede escribir las suyas propias, incluidas máquinas de estado en el Agent que alertan solo sobre indicadores de compromiso complejos. ### Responder a amenazas {#responding-to-threats} @@ -103,19 +103,19 @@ Las acciones de respuesta se ejecutan en el Agent. El Agent puede terminar un pr - **Automated response** adjunta una acción a una Agent rule, de modo que el Agent actúa tan pronto como la regla coincide. - **Manual response** le permite actuar a partir de una señal después de que se genera. -Ambas dependen de que la enforcement esté habilitada en el Agent. Consulte [Respond to Threats][4]. +Ambas dependen de que la aplicación esté habilitada en el Agent. Consulte [Respond to Threats][4]. -También puede responder desde Datadog en lugar del Agent. Active un [workflow][15] a partir de una señal, o integre señales con sus canalizaciones de respuesta existentes. Consulte [Signal actions][16]. +También puede responder desde Datadog en lugar del Agent. Active un [flujo de trabajo][15] a partir de una señal, o integre señales con sus canalizaciones de respuesta existentes. Consulte [Signal actions][16]. ## Próximos pasos {#next-steps} ### Configuración {#setup} -Comience con la guía de [Setup][1]. Cubre los entornos compatibles, cómo implementar el Agent y cómo experimentar con las funciones de Workload Protection utilizando los playground scripts. +Comience con la guía de [Setup][1]. Cubre los entornos compatibles, cómo implementar el Agent y cómo experimentar con las funciones de Workload Protection utilizando los scripts de área de prueba. ### Detectar y hacer un seguimiento {#detect-and-monitor} -Lea las páginas de [Detect and Monitor][2] para comprender cómo los agent events se traducen en señales y hallazgos de Workload Protection. Estas páginas le ayudan a explorar las detecciones integradas (OOTB) y a crear su propia lógica de detección. +Lea las páginas de [Detect and Monitor][2] para comprender cómo los eventos de Agents se traducen en señales y hallazgos de Workload Protection. Estas páginas le ayudan a explorar las detecciones integradas (OOTB) y a crear su propia lógica de detección. ### Investigar y clasificar {#investigate-and-triage} @@ -123,7 +123,7 @@ Consulte las páginas de [Investigate and Triage][3] para descubrir los explorad ### Responder a amenazas {#respond-to-threats} -La página [Respond to Threats][4] explica cómo configurar la respuesta automatizada y manual. Cubre los requisitos de Agent enforcement, las acciones de respuesta disponibles y cómo interpretar sus resultados. +La página [Respond to Threats][4] explica cómo configurar la respuesta automatizada y manual. Cubre los requisitos de aplicación de Agent, las acciones de respuesta disponibles y cómo interpretar sus resultados. ### Coverage {#coverage} @@ -150,4 +150,8 @@ Utilice [Coverage][5] para obtener una vista unificada y en tiempo real de la po [13]: /es/security/workload_protection/detect_and_monitor/threat_intelligence [14]: /es/security/workload_protection/detect_and_monitor/agent_rules/policy_management [15]: /es/actions/workflows/ -[16]: /es/security/workload_protection/investigate_and_triage/security_signals/actions \ No newline at end of file +[16]: /es/security/workload_protection/investigate_and_triage/security_signals/actions + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/es/service_level_objectives/monitor.md b/hugo/content/es/service_level_objectives/monitor.md index dc7bebfbd5d..e8dc00af271 100644 --- a/hugo/content/es/service_level_objectives/monitor.md +++ b/hugo/content/es/service_level_objectives/monitor.md @@ -2,130 +2,131 @@ aliases: - /es/monitors/service_level_objectives/monitor/ - /es/service_management/service_level_objectives/monitor/ -description: 'Utiliza los monitores para definir el Objetivo de nivel servicio ' +description: Utilice monitores para definir el Service Level Objective further_reading: - link: /monitors/ tag: Documentación - text: Más información sobre Monitores + text: Más información sobre los monitores - link: https://www.datadoghq.com/blog/define-and-manage-slos/#monitor-based-slo tag: Blog - text: Mejores prácticas para gestionar tus SLOs con Datadog + text: Mejores prácticas para administrar sus SLO con Datadog - link: https://www.datadoghq.com/blog/slo-synthetic-monitoring/ tag: Blog - text: Mejorar la precisión y el rendimiento de los SLOs con la monitorización Synthetic - en Datadog -title: SLOs basados en monitores + text: Mejore la precisión y el rendimiento de los SLO con Datadog Synthetic Monitoring. +- link: https://learn.datadoghq.com/courses/understanding-slos + tag: Centro de aprendizaje + text: Comprender los Service Level Objectives (SLOs) +title: SLO basados en monitores --- +## Descripción general {#overview} +Para crear un SLO a partir de los monitores de Datadog nuevos o existentes, cree un SLO basado en monitores. Al utilizar un SLO basado en monitores, puede calcular el Indicador de Nivel de Servicio (SLI) dividiendo el tiempo en que su sistema muestra un buen comportamiento entre el tiempo total. -## Información general -Para crear un SLO a partir de monitores de Datadog nuevos o existentes, crea un SLO basado en un monitor. Utilizando un SLO basado en un monitor, puedes calcular el Indicador de nivel de servicio (SLI) dividiendo la cantidad de tiempo que tu sistema muestra un buen comportamiento por el tiempo total. +
Los SLO de fragmentos de tiempo son otra forma de crear SLOs con un cálculo de SLI basado en el tiempo. Con los SLO de fragmentos de tiempo, puede crear un SLO de tiempo de actividad sin utilizar un monitor, por lo que no tiene que crear y mantener tanto un monitor como un SLO.
-
Los SLOs por intervalos de tiempo son otra forma de crear SLOs con un cálculo de SLI basado en el tiempo. Con los SLOs basados en el tiempo, puedes crear un SLO de tiempo de actividad sin pasar por un monitor, por lo que no tienes que crear ni mantener tanto un monitor como un SLO.
+{{< img src="service_level_objectives/monitor/monitor_slo_side_panel.png" alt="ejemplo de SLO basado en monitores" >}} -{{< img src="service_level_objectives/monitor/monitor_slo_side_panel.png" alt="Ejemplo de SLO basado en un monitor" >}} +## Requisitos previos {#prerequisites} -## Requisitos previos +Para crear un SLO basado en monitores, necesita un monitor de Datadog existente. Para configurar un nuevo monitor, vaya a la [página de creación de monitores][1]. -Para crear un SLO basado en monitor, necesitas un monitor Datadog existente. Para crear un nuevo monitor, ve a la [monitor creation page (página de creación de monitor)][1]. - -Los SLOs basados en monitor Datadog soportan los siguientes tipos de monitores: -- Tipos de Monitores de métrica (métrica, integración, métrica APM, anomalía, predicción, outlier) +Los SLO basados en monitores de Datadog admiten los siguientes tipos de monitores: +- Tipos de monitor de métricas (Métrica, Integración, Métrica de APM, Anomalía, Pronóstico, Valor anómalo) - Synthetic -- Checks de servicio +- Verificaciones de servicio -## Instalación +## Configuración {#setup} -En la [página de estado de SLO][2], haz clic en **+ New SLO** (+ Nuevo SLO). A continuación, selecciona **By Monitor Uptime** (Por tiempo de actividad del monitor). +En la [página de estado de SLO][2], haga clic en {{< ui >}}\+ New SLO{{< /ui >}}. Luego, seleccione {{< ui >}}By Monitor Uptime{{< /ui >}}. -### Definir consultas +### Definir consultas {#define-queries} -En la casilla Buscar, empieza a escribir el nombre de un monitor. Aparecerá una lista de monitores coincidentes. Haz clic en un nombre de monitor para añadirlo a la lista de fuentes. +En el cuadro de búsqueda, comience a escribir el nombre de un monitor. Aparece una lista de monitores coincidentes. Haga clic en el nombre de un monitor para añadirlo a la fuente. **Notas**: -- Si utilizas un monitor único de múltiples alertas en un SLO, puedes seleccionar opcionalmente "Calculate on selected groups" (Calcular en grupos seleccionados) y elegir hasta 20 grupos. -- Si estás añadiendo varios monitores a tu SLO, no se admite la selección de grupos. Puedes añadir hasta 20 monitores. +- Si está utilizando un único monitor de alerta múltiple en un SLO, puede seleccionar opcionalmente "Calcular en grupos seleccionados" y elegir hasta 20 grupos. +- Si está añadiendo múltiples monitores a su SLO, la selección de grupos no es compatible. Puede añadir hasta 20 monitores. -### Establece tus objetivos SLO +### Establezca sus objetivos de SLO {#set-your-slo-targets} -Selecciona un porcentaje **target** (objetivo), **time window** (ventana de tiempo) y nivel opcional de **warning** (advertencia). +Seleccione un {{< ui >}}target{{< /ui >}} porcentaje, {{< ui >}}time window{{< /ui >}} y un nivel {{< ui >}}warning{{< /ui >}} opcional. -El porcentaje objetivo especifica el porcentaje de tiempo que los monitores subyacentes del SLO no deben estar en estado de ALERTA. La ventana de tiempo especifica el periodo continuo en el que el SLO ejecuta su cálculo. +El porcentaje objetivo especifica la porción de tiempo en la que el monitor o los monitores subyacentes del SLO no deben estar en estado de alerta. La ventana de tiempo especifica el período continuo en el que el SLO ejecuta su cálculo. -Dependiendo del valor del SLI, la interfaz de usuario Datadog muestra el estado del SLO en un color diferente: -- Mientras el SLI se mantiene por encima del objetivo, la interfaz de usuario muestra el estado del SLO en verde. +Dependiendo del valor del SLI, la interfaz de usuario de Datadog muestra el estado del SLO en un color diferente: +- Mientras el SLI permanezca por encima del objetivo, la interfaz de usuario muestra el estado del SLO en verde. - Cuando el SLI cae por debajo del objetivo, la interfaz de usuario muestra el estado del SLO en rojo. -- Si incluiste un nivel de advertencia, y el SLI cae por debajo de la advertencia, pero por encima del nivel objetivo, la interfaz de usuario muestra el estado de SLO en amarillo. +- Si incluyó un nivel de advertencia y el SLI cae por debajo de la advertencia, pero por encima del nivel objetivo, la interfaz de usuario muestra el estado del SLO en amarillo. -La ventana temporal que elijas cambia la precisión disponible para tus SLOs basados en monitor: +La ventana de tiempo que elija cambia la precisión disponible para sus SLO basados en monitores: - Las ventanas de tiempo de 7 y 30 días permiten hasta dos decimales. -- Las ventanas de 90 días permiten hasta tres decimales. +- Las ventanas de tiempo de 90 días permiten hasta tres decimales. -En la IU de detalles del SLO, Datadog muestra dos decimales para los SLOs configurados con ventanas de tiempo de 7 y 30 días y tres decimales para los SLOs configurados con ventanas de tiempo de 90 días. +En la interfaz de detalles del SLO, Datadog muestra dos decimales para los SLO configurados con ventanas de tiempo de 7 y 30 días, y tres decimales para los SLO configurados con ventanas de tiempo de 90 días. -El siguiente ejemplo demuestra por qué Datadog muestra un número limitado de decimales para los cálculos de SLO. Un objetivo del 99,999% para una ventana de tiempo de 7 o 30 días da como resultado un presupuesto de error de 6 segundos o 26 segundos, respectivamente. Los monitores evalúan cada minuto, por lo que la granularidad de un SLO basado en monitor también es de 1 minuto. Por lo tanto, una alerta consumiría totalmente y gastaría en exceso el presupuesto de error de 6 segundos o 26 segundos del ejemplo anterior. En la práctica, los equipos no pueden satisfacer presupuestos de error tan pequeños. +El siguiente ejemplo demuestra por qué Datadog muestra un número limitado de decimales para los cálculos de SLO. Un objetivo del 99.999% para una ventana de tiempo de 7 o 30 días resulta en un presupuesto de error de 6 segundos o 26 segundos, respectivamente. Los monitores se evalúan cada minuto, por lo que la granularidad de un SLO basado en monitores también es de 1 minuto. Por lo tanto, una alerta consumiría completamente y excedería el presupuesto de error de 6 o 26 segundos en el ejemplo anterior. En la práctica, los equipos no pueden cumplir con presupuestos de error tan pequeños. -Si necesitas una granularidad más fina que la evaluación de monitor de una vez por minuto, considera el uso de [metric-based SLOs (SLOs basados en métrica)][3] en su lugar. +Si necesita una granularidad más fina que la evaluación del monitor una vez por minuto, considere usar [SLO basados en métricas][3] en su lugar. -### Añadir nombre y etiquetas (tags) +### Agregar nombre y etiquetas {#add-name-and-tags} -Elige un nombre y una descripción ampliada para tu SLO. Selecciona cualquier etiqueta que desees asociar con tu SLO. Selecciona **Create** (Crear) o **Create & Set Alert** (Crear y establecer alerta) para guardar tu nuevo SLO. +Elija un nombre y una descripción extendida para su SLO. Seleccione las etiquetas que desea asociar con su SLO. Seleccione {{< ui >}}Create{{< /ui >}} o {{< ui >}}Create & Set Alert{{< /ui >}} para guardar su nuevo SLO. -## Cálculo del estado +## Cálculo de estado {#status-calculation} -{{< img src="service_level_objectives/monitor/monitor_slo_overall_status.png" alt="SLO basado en un monitor con grupos" >}} +{{< img src="service_level_objectives/monitor/monitor_slo_overall_status.png" alt="SLO basados en monitores con grupos" >}} -Datadog calcula el estado general de SLO como el porcentaje de tiempo de actividad en todos monitores o grupos de monitor, a menos que se hayan seleccionado grupos específicos: -- Si se han seleccionado grupos específicos (hasta 20), el estado SLO se calcula solo con esos grupos. La interfaz de usuario muestra todos los grupos seleccionados. +Datadog calcula el estado general del SLO como el porcentaje de tiempo de actividad en todos los monitores o grupos de monitores, a menos que se hayan seleccionado grupos específicos: +- Si se han seleccionado grupos específicos (hasta 20), el estado del SLO se calcula solo con esos grupos. La interfaz de usuario muestra todos los grupos seleccionados. - Si no se seleccionan grupos específicos, el estado del SLO se calcula en *todos* los grupos. La interfaz de usuario muestra todos los grupos subyacentes del SLO. -**Nota:** Para los SLOs basados en monitor con grupos, se pueden mostrar todos los grupos para cualquier SLO que contenga hasta 5000 grupos. Para los SLOs que contengan más de 5000 grupos, el SLO se calcula en función de todos los grupos, pero no se muestra ningún grupo en la interfaz de usuario. +**Nota:** Para los SLO basados en monitores con grupos, se pueden mostrar todos los grupos para cualquier SLO que contenga hasta 5,000 grupos. Para los SLO que contienen más de 5,000 grupos, el SLO se calcula en función de todos los grupos, pero no se muestra ningún grupo en la interfaz de usuario. -Los SLOs basados en monitor tratan el estado `ADVERTIR` como `OK`. La definición de un SLO requiere una distinción binaria entre buen y mal comportamiento. Los cálculos de SLO tratan `ADVERTIR` como buen comportamiento ya que `WARN` no es lo suficientemente grave como para indicar un mal comportamiento. +Los SLO basados en monitores tratan el estado `WARN` como `OK`. La definición de un SLO requiere una distinción binaria entre el buen y el mal comportamiento. Los cálculos de SLO tratan `WARN` como buen comportamiento, ya que `WARN` no es lo suficientemente grave como para indicar un mal comportamiento. -Considera el siguiente ejemplo para un SLO basado en monitor que contiene 3 monitores. El cálculo para un SLO basado en monitor basado en un monitor de una sola alerta múltiple sería similar. +Considere el siguiente ejemplo para un SLO basado en monitores que contiene 3 monitores. El cálculo para un SLO basado en monitores, utilizando un único monitor de alerta múltiple, sería similar. | Monitor | t1 | t2 | t3 | t4 | t5 | t6 | t7 | t8 | t9 | t10 | Estado | |--------------------|----|----|-------|----|-------|----|----|----|-------|-----|--------| | Monitor 1 | OK | OK | OK | OK | ALERTA | OK | OK | OK | OK | OK | 90% | | Monitor 2 | OK | OK | OK | OK | OK | OK | OK | OK | ALERTA | OK | 90% | | Monitor 3 | OK | OK | ALERTA | OK | ALERTA | OK | OK | OK | OK | OK | 80% | -| **Overall Status** (Estado general) | OK | OK | ALERTA | OK | ALERTA | OK | OK | OK | ALERTA | OK | 70% | +| **Estado general** | OK | OK | ALERTA | OK | ALERTA | OK | OK | OK | ALERTA | OK | 70% | -En este ejemplo, el estado global es inferior a la media de los estados individuales. +En este ejemplo, el estado general es inferior al promedio de los estados individuales. -Silenciar un monitor no afecta al cálculo de SLO. Para excluir periodos de un cálculo de SLO, utiliza la función [Correcciones de estado de SLO][5]. +Silenciar un monitor no afecta el cálculo del SLO. Para excluir períodos de tiempo de un cálculo de SLO, utilice la función [correcciones de estado de SLO][5]. -### Excepciones para las pruebas de Synthetic -En determinados casos, existe una excepción al cálculo del estado para las SLOs basadas en monitor que se componen de una prueba agrupada de Synthetic. Las pruebas de Synthetic tienen condiciones de alerta especiales opcionales que cambian el comportamiento de cuándo la prueba entra en estado de ALERTA y, en consecuencia, afectan al tiempo de actividad general: +### Excepciones para pruebas Synthetic {#exceptions-for-synthetic-tests} +En ciertos casos, existe una excepción en el cálculo del estado para los SLO basados en monitores que se componen de una prueba Synthetic agrupada. Las pruebas Synthetic tienen condiciones de alerta especiales opcionales que cambian el comportamiento de cuándo la prueba entra en estado de ALERTA y, en consecuencia, afectan el tiempo de actividad general: -- Esperar a que los grupos fallen durante un número especificado de minutos (por defecto: 0) -- Esperar a que falle un número especificado de grupos (por defecto: 1) -- Reintentar un número especificado de veces antes de que la prueba de localización se considere un fracaso (por defecto: 0) +- Espere hasta que los grupos fallen durante un número específico de minutos (predeterminado: 0) +- Espere hasta que un número específico de grupos fallen (predeterminado: 1) +- Reintente un número específico de veces antes de que la prueba de una ubicación se considere fallida (predeterminado: 0) -Si cambias cualquiera de estas condiciones a algo distinto de sus valores predeterminados, el estado general de un SLO basado en monitor utilizando una prueba de Synthetic podría parecer mejor que los estados agregados de los grupos individuales de la prueba de Synthetic. +Si cambia cualquiera de estas condiciones a algo distinto de sus valores predeterminados, el estado general de un SLO basado en seguimiento que utiliza una prueba Synthetic podría parecer mejor que los estados agregados de los grupos individuales de la prueba Synthetic. -Para más información sobre las condiciones de alerta de la prueba de Synthetic, puedes ver [Synthetic Monitoring (monitor de Synthetic)][4]. +Para obtener más información sobre las condiciones de alerta de las pruebas Synthetic, consulte [Synthetic Monitoring][4]. -### Datos faltantes -#### Monitores de métrica -Cuando se crea un monitor de métrica, se elige [cómo tratará el monitor los datos que faltan][6]. Esta configuración afecta al modo en que un cálculo de SLO basado en un monitor interpreta los datos que faltan: +### Datos faltantes {#missing-data} +#### Seguimientos de métricas {#metric-monitors} +Cuando crea un seguimiento de métricas, elige [cómo manejará el seguimiento los datos faltantes][6]. Esta configuración afecta cómo el cálculo de un SLO basado en seguimiento interpreta los datos faltantes: -| Configuración del monitor | Cálculo de SLO de los datos que faltan | +| Configuración del seguimiento | Cálculo de SLO de datos faltantes | |---------------------------|---------------------------------| -| `Evaluate as zero` | Depende del umbral de alerta del monitor
Por ejemplo, un umbral de `> 10` daría como resultado Uptime (Tiempo de actividad) (ya que el estado del monitor sería `OK`), mientras que un umbral de `< 10` daría como resultado Downtime (Caída del sistema). | -| `Show last known status` | Mantener último estado de SLO | +| `Evaluate as zero` | Depende del umbral de alerta del seguimiento
Por ejemplo, un umbral de `> 10` resultaría en tiempo de actividad (ya que el estado del seguimiento sería `OK`), mientras que un umbral de `< 10` resultaría en tiempo de inactividad. | +| `Show last known status` | Mantener el último estado del SLO | | `Show NO DATA` | Tiempo de actividad | -| `Show NO DATA and notify` | Caída del sistema | +| `Show NO DATA and notify` | Tiempo de inactividad | | `Show OK` | Tiempo de actividad | -#### Otros tipos de monitores -Cuando se crea un monitor de check de servicio, se elige si se envía una alerta cuando faltan datos. Esta configuración afecta a cómo un cálculo de SLO basado en un monitor interpreta los datos que faltan. Para monitores configurados para ignorar los datos que faltan, los periodos con datos que faltan son tratados como OK (tiempo de actividad) por el SLO. Para monitores configurados para alertar sobre datos faltantes, los periodos con datos faltantes son tratados como ALERT (caída del sistema) por el SLO. +#### Otros tipos de seguimientos {#other-monitor-types} +Cuando crea un seguimiento de verificación de servicio, elige si envía una alerta cuando faltan datos. Esta configuración afecta cómo el cálculo de SLO basado en seguimientos interpreta los datos faltantes. Para los seguimientos configurados para ignorar los datos faltantes, los periodos de tiempo con datos faltantes son tratados como OK (tiempo de actividad) por el SLO. Para los seguimientos configurados para alertar sobre datos faltantes, los periodos de tiempo con datos faltantes son tratados como ALERT (tiempo de inactividad) por el SLO. -Si pausas una prueba de Synthetic, el SLO elimina de su cálculo el período con datos faltantes. En la interfaz de usuario, estos períodos aparecen marcados en gris claro en la barra de estado del SLO. +Si pausa una prueba Synthetic, el SLO elimina el periodo de tiempo con datos faltantes de su cálculo. En la interfaz de usuario, estos periodos de tiempo están marcados en gris claro en la barra de estado del SLO. -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/synthetics/guide/explore-rum-through-synthetics.md b/hugo/content/es/synthetics/guide/explore-rum-through-synthetics.md index 35158667fdf..b2ed98fb18f 100644 --- a/hugo/content/es/synthetics/guide/explore-rum-through-synthetics.md +++ b/hugo/content/es/synthetics/guide/explore-rum-through-synthetics.md @@ -1,76 +1,75 @@ --- aliases: null -description: Los usuarios que no cuentan con RUM pueden ahora previsualizar los datos, - las sesiones y los errores de RUM desde los resultados de los tests de su navegador - Synthetic sin coste adicional. +description: Los usuarios sin RUM ahora pueden obtener una vista previa de los datos, + las sesiones y los errores de RUM desde los resultados de sus pruebas de navegador + de Synthetic sin costo adicional. further_reading: - link: https://docs.datadoghq.com/synthetics/browser_tests/ tag: Documentación - text: Configurar un test de navegador + text: Configurar una prueba de navegador - link: /synthetics/settings/ tag: Documentación - text: Parámetros de monitorización Synthetic + text: Configuración de Synthetic Monitoring title: Explorar una vista previa de las funciones de RUM en Synthetic Monitoring --- +## Descripción general {#overview} -## Información general +
Si tiene Real User Monitoring, puede acceder a una vista previa de RUM, Session Replay, Error Tracking y datos de rendimiento adicionales de las ejecuciones de sus pruebas de navegador de Synthetic.
-
Si tienes Real User Monitoring, puedes acceder a una vista previa de RUM, de Session Replay, de Seguimiento de errores y de los datos de rendimiento adicionales de las ejecuciones de tests de tu navegador Synthetic.
+Las pruebas de navegador de Synthetic integran el SDK de Real User Monitoring, lo que le permite explorar: -Los tests de tu navegador Synthetic integran el SDK de Real User Monitoring, lo que te permite explorar: +- [Session Replay][1] para todas las pruebas. Puede acceder a contexto adicional más allá de las capturas de pantalla disponibles para cada paso y [Browser Dev Tools][2]. +- La sesión en el [RUM Explorer][3]. +- Errores agregados en sus diferentes pasos, pruebas y ejecuciones de prueba con [Error Tracking][4]. Puede definir el contexto del impacto del error y priorizar la corrección de los problemas más graves. +- Recursos adicionales e información de tiempo de RUM, incluidas capacidades adicionales de búsqueda y seguimiento. -- [Session Replay][1] para todos los tests. Puedes acceder al contexto adicional, más allá de las capturas de pantalla disponibles para cada paso, y a las [herramientas de desarrollo del navegador][2]. -- La sesión en el [Explorador RUM][3]. -- Errores agregados a través de tus diferentes pasos, tests y ejecuciones de tests con el [Seguimiento de errores][4]. Puedes delimitar el impacto del error y priorizar la resolución de los problemas más graves. -- Recursos e información de tiempos adicionales de RUM, incluyendo funciones de búsqueda y monitorización adicionales. - -## Permitir datos Synthetic sobre aplicaciones RUM +## Permitir datos de Synthetic en aplicaciones de RUM {#allow-synthetic-data-on-rum-applications}
-Si la aplicación de destino ya está instrumentada con RUM, no debes activar la recopilación de datos de RUM dentro de la configuración de Synthetic Test, ya que esto puede dar lugar a un comportamiento inesperado.
+Si la aplicación de destino ya está instrumentada con RUM, no debe habilitar la recopilación de datos de RUM dentro de la configuración de la prueba Synthetic, ya que esto puede provocar un comportamiento inesperado. -En la grabación del test de tu navegador, haz clic en **Collect RUM Data on* (Recopilar datos de RUM de), arriba del botón **Start Recording** (Iniciar grabación), y selecciona una aplicación de la que recopilar datos. Después de guardar tu grabación y tu configuración del test, RUM recopila datos del test y genera grabaciones de sesiones de las ejecuciones de tests de tu navegador. +En la grabación de su prueba de navegador, haga clic en {{< ui >}}Collect RUM Data on{{< /ui >}} sobre el botón {{< ui >}}Start Recording{{< /ui >}} y seleccione una aplicación en la cual recopilar datos. Después de guardar su grabación y la configuración de la prueba, RUM recopila datos de prueba y genera grabaciones de sesión a partir de las ejecuciones de sus pruebas de navegador. -1. Ve a **Experiencia digital** > **Parámetros** (en Monitorización Synthetic y tests) > [**Parámetros de integración**][5]. -2. En **Recopilación de datos RUM Synthetic**, haz clic en **Enable Synthetic RUM data collection** (Habilitar la recopilación de datos RUM Synthetic) para permitir que Datadog recopile datos RUM de tus ejecuciones de tests. -3. Haz clic en **Save RUM Data Collection** (Guardar recopilación de datos RUM). -4. En **Aplicaciones de datos RUM Synthetic**, en el menú desplegable selecciona una aplicación RUM predeterminada, sugerida en el grabador de tests del navegador. -5. Haz clic en **Save RUM Data Applications** (Guardar aplicaciones de datos RUM). +1. Navegue a {{< ui >}}Digital Experience{{< /ui >}} > {{< ui >}}Settings{{< /ui >}} (en Synthetic Monitoring & Testing) > [{{< ui >}}Integration Settings{{< /ui >}}][5]. +2. En {{< ui >}}Synthetic Data RUM Collection{{< /ui >}}, haga clic en {{< ui >}}Enable Synthetic RUM data collection{{< /ui >}} para permitir que Datadog recopile datos de RUM de sus ejecuciones de prueba. +3. Haga clic en {{< ui >}}Save RUM Data Collection{{< /ui >}}. +4. En {{< ui >}}Synthetic Data RUM Applications{{< /ui >}}, seleccione una aplicación de RUM predeterminada sugerida en el grabador de pruebas de navegador desde el menú desplegable. +5. Haga clic en {{< ui >}}Save RUM Data Applications{{< /ui >}}. -Opcionalmente, haz clic en `Synthetic Tests Default` y selecciona otra aplicación RUM del menú desplegable. Esta aplicación se muestra en la grabación de tests del navegador. +Opcionalmente, haga clic en {{< ui >}}Synthetic Tests Default{{< /ui >}} y seleccione otra aplicación de RUM en el menú desplegable. Esta aplicación se muestra en la grabación de la prueba de navegador. -Para obtener más información, consulta los [parámetros de monitorización Synthetic][6]. +Para obtener más información, consulte [Synthetic Monitoring Settings][6]. -## Synthetic Monitoring a RUM Explorer +## Synthetic Monitoring a RUM Explorer {#synthetic-monitoring-to-rum-explorer} -Ve a tu [lista de tests de navegador][7] y haz clic en una ejecución de test de ejemplo. +Navegue a su [lista de pruebas de navegador][7] y haga clic en una ejecución de prueba de muestra. -{{< img src="synthetics/guide/rum_in_synthetics/browser_test_step_side_panel.png" alt="Panel lateral con detalles del paso del test" style="width:100%;" >}} +{{< img src="synthetics/guide/rum_in_synthetics/browser_test_step_side_panel.png" alt="Panel lateral de detalles del paso de prueba" style="width:100%;" >}} -El panel lateral con detalles del paso aparece con `This Synthetic test generated data in Real User Monitoring` e incluye el ID de sesión y el botón **Go to the View in RUM** (Ir a la vista en RUM). +El panel lateral de detalles del paso aparece con `This Synthetic test generated data in Real User Monitoring` e incluye el ID de sesión y el botón {{< ui >}}Go to the View in RUM{{< /ui >}}. -{{< img src="synthetics/guide/rum_in_synthetics/generated_rum_data.png" alt="Explorador Synthetics" style="width:80%;" >}} +{{< img src="synthetics/guide/rum_in_synthetics/generated_rum_data.png" alt="Synthetics Explorer" style="width:80%;" >}} -Para ver los errores, los recursos y los datos de rendimiento de este paso de test en el [Explorador RUM][3], haz clic en **Go to the View in RUM** (Ir a la vista en RUM). Alternativamente, haz clic en el botón **Replay Session** (Reproducir sesión) o en **View all sessions in RUM** (Ver todas las sesiones en RUM) para explorar las repeticiones de sesión disponibles, capturadas en tu test de navegador. +Para ver los errores, los recursos y los datos de rendimiento de este paso de prueba en el [RUM Explorer][3], haga clic en {{< ui >}}Go to the View in RUM{{< /ui >}}. Alternativamente, haga clic en el botón {{< ui >}}Replay Session{{< /ui >}} o en {{< ui >}}View all sessions in RUM{{< /ui >}} para explorar las reproducciones de sesión disponibles capturadas en su prueba de navegador. -## RUM Explorer a Synthetic Monitoring +## RUM Explorer a Synthetic Monitoring {#rum-explorer-to-synthetic-monitoring} -En el Explorador RUM, ve a tu [lista de sesiones][8] y haz clic en una sesión con una repetición disponible. +En el RUM Explorer, navegue a su [lista de sesiones][8] y haga clic en una sesión con una reproducción disponible. -{{< img src="synthetics/guide/rum_in_synthetics/sessions_details_panel.png" alt="Panel lateral con detalles de las sesiones" style="width:100%;" >}} +{{< img src="synthetics/guide/rum_in_synthetics/sessions_details_panel.png" alt="Panel lateral de detalles de sesiones" style="width:100%;" >}} -El panel de la sesión aparece con `This event was generated by a Synthetic test run` e incluye el ID del test y el botón **View Synthetic Test Result** (Ver resultado del test Synthetic). +El panel de sesión aparece con `This event was generated by a Synthetic test run` e incluye el ID de prueba y el botón {{< ui >}}View Synthetic Test Result{{< /ui >}}. -{{< img src="synthetics/guide/rum_in_synthetics/synthetic_test_session.png" alt="Detalles de las sesiones" style="width:80%;" >}} +{{< img src="synthetics/guide/rum_in_synthetics/synthetic_test_session.png" alt="Detalles de sesiones" style="width:80%;" >}} -Para volver a Synthetic Monitoring y a los resultados de tu test, haz clic en **View Synthetic Test Result** (Ver resultado de Synthetic Test). +Para volver a Synthetic Monitoring y a los resultados de su prueba, haga clic en {{< ui >}}View Synthetic Test Result{{< /ui >}}. -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} -[1]: /es/session_replay/browser/ -[2]: /es/session_replay/browser/dev_tools/ +[1]: /es/session_replay/ +[2]: /es/session_replay/dev_tools [3]: /es/real_user_monitoring/explorer/ [4]: /es/real_user_monitoring/error_tracking/ [5]: https://app.datadoghq.com/synthetics/settings/integrations diff --git a/hugo/content/es/synthetics/guide/rum-to-synthetics.md b/hugo/content/es/synthetics/guide/rum-to-synthetics.md index 4797f84f0f0..5d6b66c9e2e 100644 --- a/hugo/content/es/synthetics/guide/rum-to-synthetics.md +++ b/hugo/content/es/synthetics/guide/rum-to-synthetics.md @@ -2,45 +2,44 @@ further_reading: - link: https://www.datadoghq.com/blog/create-browser-tests-from-datadog-rum-session-replay/ tag: Blog - text: Crear tests de navegador directamente desde Datadog RUM Session Replay + text: Cree pruebas de navegador directamente desde Session Replay de Datadog RUM - link: synthetics/browser_tests tag: Documentación - text: Configurar un test de navegador -- link: real_user_monitoring/browser + text: Configure una prueba de navegador +- link: real_user_monitoring/application_monitoring/browser tag: Documentación - text: Monitorización de RUM Browser -title: Generación de tests de navegador Sintético desde Session Replay + text: Supervisión de navegador de RUM +title: Genere pruebas de navegador sintéticas a partir de Session Replay --- +## Descripción general {#overview} -## Información general +[Real User Monitoring (RUM)][1] le brinda visibilidad de extremo a extremo sobre la actividad y la experiencia en tiempo real de los usuarios individuales. Las [pruebas de navegador sintéticas][2] le permiten observar cómo funcionan sus sistemas y aplicaciones mediante solicitudes y acciones simuladas de todo el mundo. -[Real User Monitoring (RUM)][1] te ofrece visibilidad de extremo a extremo de la actividad y experiencia en tiempo real de usuarios individuales. Los [tests de navegador de Sintético][2] te permiten observar el rendimiento de tus sistemas y aplicaciones mediante solicitudes y acciones simuladas procedentes de todo el mundo. +{{< img src="synthetics/guide/rum_to_synthetics/generate_test_modal.png" alt="Genere una prueba de navegador con su modal de Session Replay" style="width:70%" >}} -{{< img src="synthetics/guide/rum_to_synthetics/generate_test_modal.png" alt="Generar un test de navegador con tu modal de Session Replay" style="width:70%" >}} +Puede crear pruebas de navegador sintéticas a partir de sus Session Replay en RUM para realizar un seguimiento del rendimiento basado en el comportamiento real del usuario. -Puedes crear tests de navegador Sintético a partir de tus repeticiones de sesión en RUM para realizar un rastreo del rendimiento en función del comportamiento del usuario real. +## Genere una prueba a partir de un Session Replay {#generate-a-test-from-a-session-replay} -## Generar un test a partir de una repetición de sesión +Navegue al [RUM Explorer][3] y seleccione una sesión con un [Session Replay][4] disponible a partir del cual desee crear una prueba de navegador. Haga clic en {{< ui >}}Generate Synthetic Browser Test{{< /ui >}} sobre la línea de tiempo de eventos. -Ve al [Explorador de RUM][3] y selecciona una sesión con una [Repetición de sesión][4] disponible a partir de la cual desees crear un test de navegador. Haz clic en **Generar test de navegador Sintético** encima de la línea de tiempo de eventos. +{{< img src="synthetics/guide/rum_to_synthetics/test_recording.png" alt="Una sesión de usuario en el RUM Explorer" style="width:100%" >}} -{{< img src="synthetics/guide/rum_to_synthetics/test_recording.png" alt="Una sesión de usuario en el explorador de RUM" style="width:100%" >}} +Esto clona automáticamente los eventos capturados dentro de un Session Replay, como clics de usuario y cargas de página, en pasos individuales para una nueva prueba de navegador. -Esto clona automáticamente los eventos capturados en una repetición de sesión, como los clics del usuario y las cargas de páginas, en pasos individuales para un nuevo test de navegador. +Por ejemplo, en la siguiente captura de pantalla, la prueba de navegador generada clonó la sesión de un usuario en la página de compras, incluyendo su navegación hacia ella y el clic en el botón {{< ui >}}Add to cart{{< /ui >}}. -Por ejemplo, en la siguiente captura de pantalla, el test de navegador generado clonó la sesión de un usuario en la página de compras, incluidos ir a ella y hacer clic en el botón **Add to cart** (Añadir al carrito). +{{< img src="synthetics/guide/rum_to_synthetics/example_test.png" alt="Grabador de pruebas de navegador completado automáticamente con datos de RUM" style="width:100%" >}} -{{< img src="synthetics/guide/rum_to_synthetics/example_test.png" alt="El grabador de tests de navegador se rellenó automáticamente con datos de RUM" style="width:100%" >}} +Personalice aún más sus pruebas y pasos de prueba para satisfacer sus necesidades, tal como lo haría para [cualquier otra prueba de navegador][6]. Por ejemplo, puede agregar [pasos de prueba][5] adicionales (como aserciones), ajustar la frecuencia de ejecución de su prueba y personalizar su notificación. -Personaliza aún más tus tests y pasos de tests para adaptarlos a tus necesidades, igual que harías con [cualquier otro test de navegador][6]. Por ejemplo, puedes añadir [pasos de tests][5] adicionales (como aserciones), ajustar la frecuencia de ejecución de tus tests y personalizar su notificación. - -## Leer más +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: /es/real_user_monitoring/ [2]: /es/synthetics/browser_tests [3]: https://app.datadoghq.com/rum/sessions -[4]: /es/real_user_monitoring/session_replay/browser/ -[5]: /es/synthetics/browser_tests/actions +[4]: /es/session_replay/ +[5]: /es/synthetics/browser_tests/test_steps [6]: /es/synthetics/browser_tests/?tab=requestoptions#test-configuration \ No newline at end of file diff --git a/hugo/content/es/synthetics/platform/test_coverage/_index.md b/hugo/content/es/synthetics/platform/test_coverage/_index.md index 3bb694e2720..16cee1902e9 100644 --- a/hugo/content/es/synthetics/platform/test_coverage/_index.md +++ b/hugo/content/es/synthetics/platform/test_coverage/_index.md @@ -2,156 +2,94 @@ aliases: - /es/synthetics/dashboards/testing_coverage - /es/synthetics/test_coverage -description: Evalúa la cobertura de las acciones del navegador y los endpoints de - API de tu conjunto de tests. +description: Evalúe la cobertura de su suite de pruebas de las acciones del navegador. further_reading: - link: https://www.datadoghq.com/blog/test-coverage-monitoring-datadog/ tag: Blog - text: Seguimiento de la cobertura de test con Datadog RUM y Synthetic Monitoring -- link: https://www.datadoghq.com/blog/api-test-coverage-monitoring-datadog-synthetics/ - tag: Blog - text: Mejora de la cobertura de test de API con Datadog Synthetic Monitoring + text: Realice un seguimiento de su cobertura de pruebas con Datadog RUM y Synthetic + Monitoring - link: /synthetics/browser_tests tag: Documentación - text: Más información sobre los tests de navegador de Synthetic -- link: /real_user_monitoring/browser/tracking_user_actions + text: Obtenga más información sobre las pruebas Synthetic de navegador +- link: /real_user_monitoring/application_monitoring/browser/tracking_user_actions tag: Documentación - text: Más información sobre las acciones de RUM + text: Obtenga más información sobre las acciones de RUM - link: /real_user_monitoring/session_replay tag: Documentación text: Más información sobre Session Replay -- link: /api_catalog - tag: Documentación - text: Más información sobre el Catálogo de API -title: Cobertura de test +title: Cobertura de pruebas --- +## Descripción general {#overview} -## Información general - -Explora la cobertura de test de Synthetic del conjunto de tests de las acciones del navegador de RUM o los endpoints de API en la [página **Test Coverage** (Cobertura de test)][1], que puedes encontrar en **Digital Experience** > **Synthetic Monitoring & Testing** (Experiencia digital > Synthetic Monitoring y tests). +Explore la cobertura de la prueba Synthetic de su suite de pruebas de las acciones del navegador RUM en la [{{< ui >}}Test Coverage{{< /ui >}}página][1], que puede encontrar en {{< ui >}}Digital Experience{{< /ui >}} > {{< ui >}}Synthetic Monitoring & Testing{{< /ui >}}. -{{< tabs >}} -{{% tab "Acciones del navegador" %}} -La página [**Test Coverage** (Cobertura de test)][1] proporciona información útil sobre la cobertura de test general de las [aplicaciones de RUM][2]. Utiliza [datos recopilados del SDK de RUM del navegador][3] y [resultados de tests de navegador de Synthetic][4]. +La [{{< ui >}}Test Coverage{{< /ui >}}página][1] proporciona información útil sobre la cobertura de pruebas general de sus [aplicaciones RUM][2]. Utiliza [datos recopilados del SDK de RUM para navegador][3] y [resultados de las pruebas Synthetic de navegador][4]. -{{< img src="synthetics/test_coverage/browser_actions.png" alt="Página de cobertura de test con una sección de información general, una sección de acciones no sometidas a test y una sección de acciones sometidas a test" style="width:100%" >}} +{{< img src="synthetics/test_coverage/browser_actions.png" alt="Página de Cobertura de pruebas con una sección de Resumen, una sección de Acciones no probadas y una sección de Acciones probadas" style="width:100%" >}} -La página Test Coverage (Cobertura de test) muestra la siguiente información: +La página de Cobertura de pruebas presenta la siguiente información: -- Páginas web más visitadas -- Porcentaje de [acciones de RUM][5] sometidas a test -- Número de acciones sometidas a tests y total de acciones -- Número de tests de navegador que cubren acciones -- Número de interacciones de usuarios reales +- Las páginas web más visitadas +- El porcentaje de [acciones de RUM][5] probadas +- El número de acciones probadas y totales +- El número de pruebas de navegador que cubren las acciones +- El número de interacciones de usuarios reales -## Investigar la cobertura de test de una aplicación o vista +## Investigue la cobertura de pruebas para una aplicación o vista {#investigate-test-coverage-for-an-application-or-view} -Crea un conjunto de test más completo y preciso identificando acciones no sometidas a tests y vinculándolas con interacciones de usuarios reales en la página Test Coverage (Cobertura de test). +Cree una suite de pruebas más completa y precisa identificando las acciones no probadas y vinculándolas con las interacciones de usuarios reales en la página de Cobertura de pruebas. -Para identificar áreas de tu aplicación o vistas donde deberías crear tests de navegador: +Para identificar áreas en su aplicación o vistas donde debería crear pruebas de navegador: -1. Selecciona una aplicación de RUM en el menú desplegable **Application** (Aplicación) o una vista en el menú desplegable **View Name** (Nombre de vista). -2. Haz clic en **Custom** (Personalizadas) para filtrar los datos por [acciones personalizadas][5], que son únicas y ofrecen resultados de cobertura más precisos que las acciones generadas. Si quieres incluir acciones generadas en el análisis de cobertura de test, selecciona **All Actions** (Todas las acciones). -3. Para identificar vacíos en tu cobertura de test, consulta la información presentada en las siguientes secciones: +1. Seleccione una aplicación RUM del menú desplegable {{< ui >}}Application{{< /ui >}} o una vista del menú desplegable {{< ui >}}View Name{{< /ui >}}. +2. Haga clic en {{< ui >}}Custom{{< /ui >}} para filtrar los datos de [acciones personalizadas][5], las cuales son únicas y ofrecen resultados de cobertura más precisos en comparación con las acciones generadas. Si desea incluir acciones generadas en el análisis de cobertura de pruebas, seleccione {{< ui >}}All Actions{{< /ui >}}. +3. Identifique las brechas en su cobertura de pruebas examinando la información presentada en las siguientes secciones: - **Test Coverage Overview** (Información general de cobertura de test) - : Muestra el porcentaje de acciones que se están sometiendo a test, el porcentaje de acciones que se están sometiendo a test ponderado por el número de interacciones de usuarios reales y una lista de vistas principales con su número de sesiones de usuario y de tests de navegador y el porcentaje de acciones que se están sometiendo a test. + {{< ui >}}Test Coverage Overview{{< /ui >}} + : Muestra el porcentaje de acciones que se están probando, el porcentaje de acciones que se están probando ponderado por el número de interacciones reales de los usuarios, y una lista de las vistas principales con sus conteos de sesiones de usuario y pruebas de navegador, además del porcentaje de acciones que se están probando. - **Untested Actions** (Acciones no sometidas a test) - : Muestra el número de acciones del usuario no sometidas a test, el total de acciones recopiladas y una lista de las principales acciones con las que más interactúan los usuarios reales, pero que _no_ se están sometiendo a test. + {{< ui >}}Untested Actions{{< /ui >}} + : Muestra el número de acciones de usuario no probadas, el número total de acciones recopiladas y una lista de las acciones principales con las que más interactúan los usuarios reales pero que _no_ se están probando. - **Tested Actions** (Acciones sometidas a test) - : Muestra el número de tests de navegador que cubren acciones del usuario, el número de interacciones de usuarios reales y una lista de las principales acciones con las que estos más interactúan y que _se están_ sometiendo a tests. + {{< ui >}}Tested Actions{{< /ui >}} + : Muestra el número de pruebas de navegador que cubren las acciones de usuario, el número de interacciones reales de usuario y una lista de las acciones principales con las que más interactúan los usuarios reales y que _se están probando_. -La [página Test Coverage (Cobertura de test)][1] rellena las acciones muy utilizadas en tu aplicación y oculta las que se usan con menos frecuencia. Para obtener más información sobre los datos mostrados, consulta [Métricas de Synthetic Monitoring][6]. +La [página de Cobertura de pruebas][1] muestra las acciones que se utilizan ampliamente y oculta las acciones que se usan con menos frecuencia en su aplicación. Para obtener más información sobre los datos mostrados, consulte [Synthetic Monitoring métricas][6]. -## Ver repeticiones y añadir tests +## Visualizar reproducciones y agregar pruebas {#view-replays-and-add-tests} -Utiliza la información de la [página Test Coverage (Cobertura de test)][1] para responder las siguientes preguntas: +Utilice la información de la [página de Cobertura de pruebas][1] para responder a las siguientes preguntas: -- ¿Qué acciones no se están sometiendo a test en tu aplicación? -- ¿Qué vistas son las más populares para tus usuarios? -- ¿Qué acciones necesitan más tests de navegador? -- ¿Qué porcentaje de tests de navegador cubren acciones del usuario? +- ¿Qué acciones no se están probando en su aplicación? +- ¿Qué visualizaciones son las más populares para sus usuarios? +- ¿Qué acciones necesitan más pruebas de navegador? +- ¿Qué porcentaje de pruebas de navegador cubren las acciones de usuario? -### Ver repeticiones de sesiones +### Visualizar reproducciones de sesiones {#view-session-replays} -Haz clic en el icono de **reproducción** junto a una acción en la tabla **Untested Actions** (Acciones no sometidas a test) para examinar una [grabación de interacción de usuario real][7] en [Session Replay][8]. +Haga clic en el icono {{< ui >}}Play{{< /ui >}} junto a una acción en la tabla {{< ui >}}Untested Actions{{< /ui >}} para examinar una [grabación de la interacción real del usuario][7] en [Session Replay][8]. -### Examinar acciones +### Examinar acciones {#examine-actions} -Haz clic en una acción para ver el número de tests, vistas, sesiones y un subconjunto de dichos tests, vistas y sesiones en el que se incluye la acción seleccionada. +Haga clic en una acción para acceder al número de pruebas, vistas, sesiones y un subconjunto de estas pruebas, vistas y sesiones que incluyen la acción seleccionada. -{{< img src="synthetics/test_coverage/tested_action.png" alt="Un panel lateral de acciones con pestañas que muestran tests de Synthetic relacionados, vistas de RUM y repeticiones de sesiones" style="width:100%" >}} +{{< img src="synthetics/test_coverage/tested_action.png" alt="Un panel lateral de acciones con pestañas que muestran pruebas Synthetic, vistas de RUM y reproducciones de sesiones relacionadas" style="width:100%" >}} -Añade las secciones más populares de tu aplicación a un nuevo test de navegador o a uno existente para recibir alertas cuando los recorridos de usuario clave de tu aplicación se vean afectados por un cambio de código. +Agregue las secciones más populares de su aplicación a una prueba de navegador nueva o existente para que se le avise cuando los recorridos clave de los usuarios en su aplicación se vean afectados negativamente por un cambio de código. - Para crear un test, haz clic en **+ New Test** (+ Nuevo test) en la parte superior derecha de la [página Test Coverage (Cobertura de test)][1]. Puedes ejecutar tests [directamente en tus pipelines de CI/CD][9] para asegurarte de que no se produzcan regresiones antes de lanzar el código a la fase de producción. + Para crear una prueba, haga clic en {{< ui >}}+ New Test{{< /ui >}} en la parte superior derecha de la [página de cobertura de pruebas][1]. Puede ejecutar pruebas [directamente en sus canalizaciones de CI/CD][9] para asegurarse de que no ocurran regresiones antes de lanzar código en producción. [1]: https://app.datadoghq.com/synthetics/test-coverage/browser [2]: /es/synthetics/guide/explore-rum-through-synthetics/ -[3]: /es/real_user_monitoring/browser/data_collected/ +[3]: /es/real_user_monitoring/application_monitoring/browser/data_collected/ [4]: /es/synthetics/browser_tests/ [5]: /es/real_user_monitoring/guide/send-rum-custom-actions/ [6]: /es/synthetics/metrics/ -[7]: /es/real_user_monitoring/session_replay/browser/ +[7]: /es/session_replay/ [8]: https://app.datadoghq.com/rum/explorer/ [9]: /es/continuous_testing/ -{{% /tab %}} -{{% tab "Endpoints de API" %}} - -La [página **Test Coverage** (Cobertura de test)][1] ofrece información procesable sobre la cobertura de test general de tus [endpoints de API][2]. Utiliza [datos recopilados del Catálogo de API][2] y [tramos (spans) de APM][3]. - -{{< img src="synthetics/test_coverage/api_endpoints.png" alt="Página de cobertura de tests con una sección de información general, una sección de acciones no sometidas a test y una sección de acciones sometidas a test" style="width:100%" >}} - -La página Test Coverage (Cobertura de test) muestra la siguiente información: - -- La cobertura general de tus endpoints de API -- El porcentaje de endpoints de API sometidos a test -- El número de endpoints de API no sometidos a test con el mayor número de solicitudes, ordenados por tasa de error -- El porcentaje de endpoints de API sometidos a test con tests de API que no se han sometido a test en CI -- El número de endpoints de API no sometidos a test que tienen [monitores de APM][4] - -## Investigar la cobertura de test para los endpoints de API - -Mantén un conjunto de tests completo y preciso resolviendo los problemas que provocan que tus tests de Synthetic fallen y tus endpoints de API experimenten un rendimiento deficiente. - -Para identificar las áreas en tu conjunto de tests donde debes crear tests de API: - -1. Haz clic en la casilla **Untested** (No sometido a test) de la sección **API overall coverage** (Cobertura general de API). -2. Examina el panel lateral del endpoint para ver todos los tests aprobados o fallidos que se crearon para el endpoint. El **mapa de dependencias** muestra los problemas ascendentes que pueden contribuir al bajo rendimiento del endpoint y las dependencias descendentes que se ven afectadas. -3. Para identificar vacíos en tu cobertura de test de API, consulta la información presentada en las siguientes secciones: - - **API Overall Coverage** (Cobertura general de API) - : Muestra todos los endpoints no sometidos a test dentro de tu contexto de etiquetas (tags). - - **Performance** (Rendimiento) - : Muestra los endpoints más comprometidos, no sometidos a test y con tasas de error significativas. - - **Tested in the CI** (Sometido a test en CI) - : Muestra los endpoints que se están sometiendo a test actualmente en tus canalizaciones de CI. - - **APM Monitors** (Monitores de APM) - : Muestra los endpoints que no se han sometido a test, pero que tienen monitores activos. - -Para obtener más información sobre los datos que se muestran, consulta [Métricas de APM][5]. - -## Añadir tests - - Para crear un test, haz clic en **+ New Test** (+ Nuevo test) en la parte superior derecha de la [página Test Coverage (Cobertura de test)][1]. Puedes ejecutar tests [directamente en tus pipelines de CI/CD][6] para asegurarte de que no se produzcan regresiones antes de lanzar el código a la fase de producción. - -[1]: https://app.datadoghq.com/synthetics/test-coverage/api -[2]: /es/api_catalog/monitor_apis/ -[3]: /es/tracing/ -[4]: /es/monitors/types/apm -[5]: /es/tracing/metrics/ -[6]: /es/continuous_testing/ - -{{% /tab %}} -{{< /tabs >}} - -## Referencias adicionales +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/es/tests/test_parallelization/setup.md b/hugo/content/es/tests/test_parallelization/setup.md new file mode 100644 index 00000000000..c15a6ecd19d --- /dev/null +++ b/hugo/content/es/tests/test_parallelization/setup.md @@ -0,0 +1,656 @@ +--- +description: Configure la paralelización de prueba con ddtest, configure los proveedores + de CI y distribuya la ejecución de pruebas entre los nodos de CI. +further_reading: +- link: /tests/test_parallelization/configuration/ + tag: Documentación + text: Configure la paralelización de prueba +- link: /tests/test_parallelization/troubleshooting/ + tag: Documentación + text: Solución de problemas de paralelización de prueba +- link: /tests/test_parallelization/best_practices/ + tag: Documentación + text: Prácticas recomendadas para la paralelización de prueba +- link: /tests/setup/ + tag: Documentación + text: Configure Test Optimization +title: Configure la paralelización de prueba +--- +## Requisitos previos {#prerequisites} + +Antes de configurar la paralelización de prueba: + +- Configure Test Optimization +- Para Ruby: utilice la `datadog-ci` versión de la gema `1.31.0` o posterior. +- Para Python: utilice la `ddtrace` versión del paquete `4.11.0` o posterior y `pytest`. +- Para JavaScript: utilice la `dd-trace` versión del paquete `5.111.0` o posterior para `v5` o `v6.0.0` o posterior para `v6`, Node.js y una [versión de framework compatible][8]. Cucumber.js, Cypress, Mocha, Playwright y Vitest requieren `ddtest` 1.6.0 o posterior. +- Habilite [Test Impact Analysis][2] para el servicio de pruebas cuando desee que la paralelización de prueba divida solo las pruebas afectadas por un cambio de código. + +## Conceptos {#concepts} + +Ejecutor +: Un programa que ejecuta pruebas. `ddtest` puede ejecutar pruebas directamente o escribir listas de archivos para otro ejecutor. + +Nodo de CI +: Un entorno de ejecución de CI, como un trabajo de GitHub Actions, un contenedor paralelo de CircleCI, un pod de Kubernetes, una VM o una máquina local. + +Trabajador +: Un proceso iniciado por `ddtest` para ejecutar pruebas. Un nodo de CI puede ejecutar un trabajador o varios trabajadores. + +Plan +: El directorio `.testoptimization/` generado. Contiene los archivos de prueba ejecutables, el paralelismo seleccionado y las listas de archivos por nodo utilizadas por `ddtest run` u otro ejecutor. + +Paralelismo seleccionado +: El recuento de nodos de CI o el recuento de trabajadores locales que `ddtest` elige después de estimar las duraciones de los archivos de prueba. + +## Instale ddtest {#install-ddtest} + +Instale la CLI de `ddtest` en su trabajo de CI. Datadog publica binarios precompilados en [GitHub Releases][3]. + +{{< tabs >}} +{{% tab "CLI de GitHub" %}} + +{{< code-block lang="yaml" >}} +- name: Download ddtest binary + run: | + mkdir -p bin + gh release download --repo DataDog/ddtest --pattern "ddtest-linux-amd64" --dir bin + mv bin/ddtest-linux-amd64 bin/ddtest + chmod +x bin/ddtest + env: + GH_TOKEN: ${{ github.token }} +{{< /code-block >}} + +{{% /tab %}} +{{% tab "curl" %}} + +{{< code-block lang="bash" >}} +mkdir -p bin +curl -fsSL https://github.com/DataDog/ddtest/releases/latest/download/ddtest-linux-amd64 -o bin/ddtest +chmod +x bin/ddtest +{{< /code-block >}} + +{{% /tab %}} +{{< /tabs >}} + +Estos ejemplos descargan el binario de Linux AMD64 más reciente. Para otro sistema operativo o arquitectura, seleccione el activo correspondiente en [GitHub Releases][3]. + +## Adopte ddtest en CI {#adopt-ddtest-in-ci} + +Adopte la paralelización de pruebas en cuatro pasos. Primero, agregue la planificación sin cambiar la forma en que se ejecutan las pruebas. Después de validar el plan, reemplace el comando de prueba existente con `ddtest`, elija un modo de ejecución y mida los ahorros resultantes en CI. + +Realice estos cambios en una rama de características. Confirme y envíe cada cambio de configuración de CI, luego revise la ejecución de CI resultante antes de continuar. + +### 1. Agregue la planificación de pruebas {#1-add-test-planning} + +Después de configurar las dependencias y Test Optimization, agregue `ddtest plan` antes de su paso de prueba existente. Mantenga el comando de prueba existente en su lugar durante este paso. + +Elija el paralelismo mínimo y máximo para su entorno de CI. Por ejemplo, los siguientes valores permiten que `ddtest` elija entre 1 y 8 nodos de CI o trabajadores locales: + +{{< code-block lang="bash" >}} +bin/ddtest plan \ + --platform \ + --framework \ + --min-parallelism 1 \ + --max-parallelism 8 +{{< /code-block >}} + +`--platform` identifica la plataforma de lenguaje y `--framework` identifica el marco de pruebas. Para todos los valores admitidos y predeterminados, consulte [Configuración][4]. + +La planificación descubre pruebas, recupera la duración de la prueba y los datos de Test Impact Analysis, y elige un nivel de paralelismo. No ejecuta pruebas. El directorio `.testoptimization/` generado contiene los archivos de prueba y las divisiones seleccionadas para la ejecución. + +### 2. Inspeccione el plan {#2-inspect-the-plan} + +Los siguientes comandos son una forma de inspeccionar el recuento de ejecutores propuesto y los archivos de prueba en los registros de CI: + +{{< code-block lang="bash" >}} +# Show the number of runners selected by ddtest. +cat .testoptimization/runner/parallel-runners.txt + +# Count the test files selected for execution. +wc -l .testoptimization/runner/test-files.txt + +# Preview the first 20 test files to verify test discovery. +sed -n '1,20p' .testoptimization/runner/test-files.txt + +# Optional: List the per-runner split files to see how ddtest distributed the tests. +find .testoptimization/runner/tests-split -maxdepth 1 -type f -print +{{< /code-block >}} + +Alternativamente, descargue el directorio `.testoptimization/` como un artefacto de CI y abra los archivos en su editor. + +Confirme que `test-files.txt` contenga una lista de archivos para ejecutar. Si Test Impact Analysis está habilitado, los archivos cuyas pruebas se omiten por completo no aparecen en el plan. + +### 3. Reemplace el comando de prueba existente {#3-replace-the-existing-test-command} + +Después de que el plan contenga las pruebas esperadas, reemplace el comando de prueba existente con: + +{{< code-block lang="bash" >}} +bin/ddtest run \ + --platform \ + --framework +{{< /code-block >}} + +`ddtest run` reutiliza el plan generado anteriormente en el flujo de trabajo. Elija cómo ejecutar las divisiones seleccionadas según su arquitectura de CI. + +#### Ejecute trabajadores en un nodo de CI {#run-workers-on-one-ci-node} + +En un solo nodo de CI, `ddtest plan` es opcional. Ejecute `ddtest run` directamente, o ejecute `ddtest plan` y `ddtest run` consecutivamente en el mismo trabajo si desea inspeccionar el plan primero. El paralelismo seleccionado es la cantidad de procesos de trabajador locales que inicia `ddtest`. El comando no requiere opciones adicionales. + +#### Distribuye las pruebas entre los nodos de CI {#distribute-tests-across-ci-nodes} + +Ejecute `ddtest plan` una vez en un trabajo de planificación. Comparta el directorio `.testoptimization/` completo con los trabajos de prueba y use el paralelismo seleccionado para definir el tamaño de su matriz de CI. En cada nodo, ejecute: + +{{< code-block lang="bash" >}} +bin/ddtest run \ + --platform \ + --framework \ + --ci-node +{{< /code-block >}} + +En el modo de nodo de CI, `ddtest` usa un trabajador local de forma predeterminada. Para iniciar varios trabajadores en cada nodo de CI, establezca `--ci-node-workers` en un número entero positivo o `ncpu`. + +Los ejemplos de CI en esta página muestran cómo pasar el plan generado y el recuento de ejecutores seleccionado entre trabajos. + +### 4. Mida los ahorros de CI {#4-measure-ci-savings} + +Después de reemplazar el comando de prueba, confirme en el [Test Optimization Explorer][6] que se completaron las pruebas esperadas. Utilice el [CI Visibility Explorer][7] para comparar las duraciones de los trabajos de prueba y la cantidad de trabajos de prueba entre las ejecuciones de canalización. Si la CI Visibility no está habilitada, utilice las métricas de trabajo equivalentes en su proveedor de CI. + +Si todos los trabajadores se ejecutan en un nodo de CI, la ejecución paralela acorta la etapa de prueba sin cambiar la cantidad de nodos de CI. Si cada trabajador se ejecuta en un nodo de CI independiente, utilice el recuento de ejecutores en `parallel-runners.txt` para dimensionar la matriz de CI. Debido a que Test Impact Analysis elimina las pruebas no afectadas antes de que `ddtest` seleccione el recuento de ejecutores, los cambios más pequeños pueden resultar en el inicio de menos nodos de CI. + +Utilice `--max-parallelism` para limitar la capacidad de CI. El planificador tiene en cuenta el costo de configuración de cada ejecutor adicional a través de `--ci-job-overhead`. Para obtener detalles sobre estas configuraciones, consulte [Configuración][4]. + +Agregue `.testoptimization/` a `.gitignore`. Genere un plan nuevo para cada ejecución de flujo de trabajo de CI y compártalo solo entre trabajos para la misma revisión de fuente y entorno de ejecución. Ejecute la planificación y las pruebas desde el mismo directorio de trabajo. Para obtener detalles sobre los archivos generados, consulte [Plan artifacts][5]. + +## Ejemplos de CI {#ci-examples} + +Utilice los siguientes ejemplos como puntos de partida para GitHub Actions y CircleCI. + +{{< collapse-content title="Ruby" level="h3" >}} + +{{< tabs >}} +{{% tab "GitHub Actions" %}} + +El trabajo de plan elige el recuento de nodos de CI y emite una matriz. El trabajo de prueba descarga el artefacto `.testoptimization/` y ejecuta solo los archivos asignados a su nodo de matriz. + +{{< code-block lang="yaml" >}} +name: CI with Test Parallelization + +on: [push] + +env: + DD_TEST_OPTIMIZATION_RUNNER_PLATFORM: ruby + DD_TEST_OPTIMIZATION_RUNNER_FRAMEWORK: rspec + DD_TEST_OPTIMIZATION_RUNNER_MIN_PARALLELISM: 1 + DD_TEST_OPTIMIZATION_RUNNER_MAX_PARALLELISM: 8 + +jobs: + dd_plan: + runs-on: ubuntu-latest + outputs: + matrix: ${{ steps.dd_plan.outputs.matrix }} + steps: + - uses: actions/checkout@v4 + - name: Download ddtest binary + run: | + mkdir -p bin + gh release download --repo DataDog/ddtest --pattern "ddtest-linux-amd64" --dir bin + mv bin/ddtest-linux-amd64 bin/ddtest + chmod +x bin/ddtest + env: + GH_TOKEN: ${{ github.token }} + - name: Setup Ruby + uses: ruby/setup-ruby@v1 + with: + bundler-cache: true + - name: Configure Datadog Test Optimization + uses: datadog/test-visibility-github-action@v2 + with: + languages: ruby + api_key: ${{ secrets.DD_API_KEY }} + site: datadoghq.com + - id: dd_plan + name: Plan test execution + run: bin/ddtest plan + - uses: actions/upload-artifact@v4 + with: + name: dd-artifacts + path: .testoptimization + include-hidden-files: true + + dd_test: + runs-on: ubuntu-latest + needs: [dd_plan] + strategy: + fail-fast: false + matrix: ${{ fromJson(needs.dd_plan.outputs.matrix) }} + steps: + - uses: actions/checkout@v4 + - name: Download ddtest binary + run: | + mkdir -p bin + gh release download --repo DataDog/ddtest --pattern "ddtest-linux-amd64" --dir bin + mv bin/ddtest-linux-amd64 bin/ddtest + chmod +x bin/ddtest + env: + GH_TOKEN: ${{ github.token }} + - uses: actions/download-artifact@v4 + with: + name: dd-artifacts + path: .testoptimization + - name: Setup Ruby + uses: ruby/setup-ruby@v1 + with: + bundler-cache: true + - name: Configure Datadog Test Optimization + uses: datadog/test-visibility-github-action@v2 + with: + languages: ruby + api_key: ${{ secrets.DD_API_KEY }} + site: datadoghq.com + - name: Run tests + run: bin/ddtest run --ci-node ${{ matrix.ci_node_index }} +{{< /code-block >}} + +{{% /tab %}} +{{% tab "CircleCI" %}} + +El flujo de trabajo de configuración ejecuta `ddtest plan`, almacena `.testoptimization/` y continúa en un flujo de trabajo de prueba con el recuento de nodos de CI seleccionado. + +En `.circleci/config.yml`: + +{{< code-block lang="yaml" >}} +version: "2.1" +setup: true + +orbs: + ruby: circleci/ruby@2 + test-optimization-circleci-orb: datadog/test-optimization-circleci-orb@1 + continuation: circleci/continuation@0.2.0 + +jobs: + plan: + docker: + - image: cimg/ruby:3.4.1 + steps: + - checkout + - ruby/install-deps + - test-optimization-circleci-orb/autoinstrument: + languages: ruby + site: datadoghq.com + - run: + name: Download ddtest + command: | + mkdir -p bin + curl -fsSL https://github.com/DataDog/ddtest/releases/latest/download/ddtest-linux-amd64 -o bin/ddtest + chmod +x bin/ddtest + - run: + name: Plan tests + command: bin/ddtest plan --platform ruby --framework rspec + environment: + DD_TEST_OPTIMIZATION_RUNNER_MIN_PARALLELISM: 1 + DD_TEST_OPTIMIZATION_RUNNER_MAX_PARALLELISM: 8 + - save_cache: + key: ddtest-plan-{{ .Revision }} + paths: + - .testoptimization + - bin/ddtest + - run: + name: Continue with selected parallelism + command: | + desired=$(cat .testoptimization/runner/parallel-runners.txt 2>/dev/null || echo 1) + printf '{"parallelism": %s}\n' "${desired}" > pipeline-parameters.json + - continuation/continue: + configuration_path: .circleci/test.yml + parameters: pipeline-parameters.json + +workflows: + plan: + jobs: + - plan +{{< /code-block >}} + +En `.circleci/test.yml`: + +{{< code-block lang="yaml" >}} +version: "2.1" + +parameters: + parallelism: + type: integer + default: 1 + +orbs: + ruby: circleci/ruby@2 + test-optimization-circleci-orb: datadog/test-optimization-circleci-orb@1 + +jobs: + test: + parallelism: << pipeline.parameters.parallelism >> + docker: + - image: cimg/ruby:3.4.1 + steps: + - checkout + - restore_cache: + keys: + - ddtest-plan-{{ .Revision }} + - ruby/install-deps + - test-optimization-circleci-orb/autoinstrument: + languages: ruby + site: datadoghq.com + - run: + name: Run tests + command: | + export DD_TEST_SESSION_NAME="ruby-tests-${CIRCLE_NODE_INDEX:-0}" + bin/ddtest run --platform ruby --framework rspec --ci-node "${CIRCLE_NODE_INDEX:-0}" + +workflows: + test: + jobs: + - test +{{< /code-block >}} + +{{% /tab %}} +{{< /tabs >}} + +{{< /collapse-content >}} + +{{< collapse-content title="Python" level="h3" >}} + +{{< tabs >}} +{{% tab "GitHub Actions" %}} + +El trabajo de plan elige el recuento de nodos de CI y emite una matriz. El trabajo de prueba descarga el artefacto `.testoptimization/` y ejecuta solo los archivos asignados a su nodo de matriz. + +{{< code-block lang="yaml" >}} +name: CI with Test Parallelization + +on: [push] + +env: + DD_TEST_OPTIMIZATION_RUNNER_PLATFORM: python + DD_TEST_OPTIMIZATION_RUNNER_FRAMEWORK: pytest + DD_TEST_OPTIMIZATION_RUNNER_MIN_PARALLELISM: 1 + DD_TEST_OPTIMIZATION_RUNNER_MAX_PARALLELISM: 8 + +jobs: + dd_plan: + runs-on: ubuntu-latest + outputs: + matrix: ${{ steps.dd_plan.outputs.matrix }} + steps: + - uses: actions/checkout@v4 + - name: Download ddtest binary + run: | + mkdir -p bin + gh release download --repo DataDog/ddtest --pattern "ddtest-linux-amd64" --dir bin + mv bin/ddtest-linux-amd64 bin/ddtest + chmod +x bin/ddtest + env: + GH_TOKEN: ${{ github.token }} + - name: Setup Python + uses: actions/setup-python@v5 + with: + python-version: "3.12" + cache: pip + - name: Install Python dependencies + run: python -m pip install -r requirements.txt "ddtrace>=4.11.0" pytest + - name: Configure Datadog Test Optimization + uses: datadog/test-visibility-github-action@v2 + with: + languages: python + api_key: ${{ secrets.DD_API_KEY }} + site: datadoghq.com + - id: dd_plan + name: Plan test execution + run: bin/ddtest plan + - uses: actions/upload-artifact@v4 + with: + name: dd-artifacts + path: .testoptimization + include-hidden-files: true + + dd_test: + runs-on: ubuntu-latest + needs: [dd_plan] + strategy: + fail-fast: false + matrix: ${{ fromJson(needs.dd_plan.outputs.matrix) }} + steps: + - uses: actions/checkout@v4 + - name: Download ddtest binary + run: | + mkdir -p bin + gh release download --repo DataDog/ddtest --pattern "ddtest-linux-amd64" --dir bin + mv bin/ddtest-linux-amd64 bin/ddtest + chmod +x bin/ddtest + env: + GH_TOKEN: ${{ github.token }} + - uses: actions/download-artifact@v4 + with: + name: dd-artifacts + path: .testoptimization + - name: Setup Python + uses: actions/setup-python@v5 + with: + python-version: "3.12" + cache: pip + - name: Install Python dependencies + run: python -m pip install -r requirements.txt "ddtrace>=4.11.0" pytest + - name: Configure Datadog Test Optimization + uses: datadog/test-visibility-github-action@v2 + with: + languages: python + api_key: ${{ secrets.DD_API_KEY }} + site: datadoghq.com + - name: Run tests + run: bin/ddtest run --ci-node ${{ matrix.ci_node_index }} +{{< /code-block >}} + +{{% /tab %}} +{{% tab "CircleCI" %}} + +El flujo de trabajo de configuración ejecuta `ddtest plan`, almacena `.testoptimization/` y continúa en un flujo de trabajo de prueba con el recuento de nodos de CI seleccionado. + +En `.circleci/config.yml`: + +{{< code-block lang="yaml" >}} +version: "2.1" +setup: true + +orbs: + test-optimization-circleci-orb: datadog/test-optimization-circleci-orb@1 + continuation: circleci/continuation@0.2.0 + +jobs: + plan: + docker: + - image: cimg/python:3.12 + steps: + - checkout + - run: + name: Install Python dependencies + command: python -m pip install -r requirements.txt "ddtrace>=4.11.0" pytest + - test-optimization-circleci-orb/autoinstrument: + languages: python + site: datadoghq.com + - run: + name: Download ddtest + command: | + mkdir -p bin + curl -fsSL https://github.com/DataDog/ddtest/releases/latest/download/ddtest-linux-amd64 -o bin/ddtest + chmod +x bin/ddtest + - run: + name: Plan tests + command: bin/ddtest plan --platform python --framework pytest + environment: + DD_TEST_OPTIMIZATION_RUNNER_MIN_PARALLELISM: 1 + DD_TEST_OPTIMIZATION_RUNNER_MAX_PARALLELISM: 8 + - save_cache: + key: ddtest-plan-{{ .Revision }} + paths: + - .testoptimization + - bin/ddtest + - run: + name: Continue with selected parallelism + command: | + desired=$(cat .testoptimization/runner/parallel-runners.txt 2>/dev/null || echo 1) + printf '{"parallelism": %s}\n' "${desired}" > pipeline-parameters.json + - continuation/continue: + configuration_path: .circleci/test.yml + parameters: pipeline-parameters.json + +workflows: + plan: + jobs: + - plan +{{< /code-block >}} + +En `.circleci/test.yml`: + +{{< code-block lang="yaml" >}} +version: "2.1" + +parameters: + parallelism: + type: integer + default: 1 + +orbs: + test-optimization-circleci-orb: datadog/test-optimization-circleci-orb@1 + +jobs: + test: + parallelism: << pipeline.parameters.parallelism >> + docker: + - image: cimg/python:3.12 + steps: + - checkout + - restore_cache: + keys: + - ddtest-plan-{{ .Revision }} + - run: + name: Install Python dependencies + command: python -m pip install -r requirements.txt "ddtrace>=4.11.0" pytest + - test-optimization-circleci-orb/autoinstrument: + languages: python + site: datadoghq.com + - run: + name: Run tests + command: | + export DD_TEST_SESSION_NAME="python-tests-${CIRCLE_NODE_INDEX:-0}" + bin/ddtest run --platform python --framework pytest --ci-node "${CIRCLE_NODE_INDEX:-0}" + +workflows: + test: + jobs: + - test +{{< /code-block >}} + +{{% /tab %}} +{{< /tabs >}} + +{{< /collapse-content >}} + +{{< collapse-content title="JavaScript" level="h3" >}} + +Utilice la misma estructura de trabajo de prueba y plan que los ejemplos de Ruby y Python. Establezca `DD_TEST_OPTIMIZATION_RUNNER_FRAMEWORK` en `cucumber`, `cypress`, `jest`, `mocha`, `playwright` o `vitest`. Los siguientes ejemplos usan Jest; reemplace `jest` con el marco de trabajo para su conjunto de pruebas. + +{{< tabs >}} +{{% tab "GitHub Actions" %}} + +Establezca estas variables de entorno a nivel de flujo de trabajo o de trabajo: + +{{< code-block lang="yaml" >}} +env: + DD_TEST_OPTIMIZATION_RUNNER_PLATFORM: javascript + DD_TEST_OPTIMIZATION_RUNNER_FRAMEWORK: jest + DD_TEST_OPTIMIZATION_RUNNER_MIN_PARALLELISM: 1 + DD_TEST_OPTIMIZATION_RUNNER_MAX_PARALLELISM: 8 +{{< /code-block >}} + +Reemplace cada paso de configuración de lenguaje con la instalación de dependencias de Node.js: + +{{< code-block lang="yaml" >}} +- name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: "22" + cache: npm +- name: Install JavaScript dependencies + run: npm ci +{{< /code-block >}} + +Configure Datadog Test Optimization para JavaScript: + +{{< code-block lang="yaml" >}} +- name: Configure Datadog Test Optimization + uses: datadog/test-visibility-github-action@v2 + with: + languages: js + api_key: ${{ secrets.DD_API_KEY }} + site: datadoghq.com +{{< /code-block >}} + +Los comandos `ddtest plan` y `ddtest run --ci-node ${{ matrix.ci_node_index }}` permanecen sin cambios cuando la plataforma y el marco de trabajo se proporcionan a través del entorno. + +{{% /tab %}} +{{% tab "CircleCI" %}} + +Utilice una imagen de Node.js y establezca el entorno del ejecutor en el trabajo `plan`: + +{{< code-block lang="yaml" >}} +jobs: + plan: + docker: + - image: cimg/node:22.14 + environment: + DD_TEST_OPTIMIZATION_RUNNER_PLATFORM: javascript + DD_TEST_OPTIMIZATION_RUNNER_FRAMEWORK: jest + DD_TEST_OPTIMIZATION_RUNNER_MIN_PARALLELISM: 1 + DD_TEST_OPTIMIZATION_RUNNER_MAX_PARALLELISM: 8 + steps: + - checkout + - run: + name: Install JavaScript dependencies + command: npm ci + - test-optimization-circleci-orb/autoinstrument: + languages: js + site: datadoghq.com +{{< /code-block >}} + +Mantenga los pasos de descarga, plan, caché y continuación de `ddtest` del flujo de trabajo de CircleCI. En el trabajo de prueba, instale las dependencias, autoinstrumente JavaScript y pase el índice de nodo de CircleCI a `ddtest`: + +{{< code-block lang="yaml" >}} +- run: + name: Install JavaScript dependencies + command: npm ci +- test-optimization-circleci-orb/autoinstrument: + languages: js + site: datadoghq.com +- run: + name: Run tests + command: | + NODE_INDEX=${CIRCLE_NODE_INDEX:-0} + bin/ddtest run --platform javascript --framework jest --ci-node "${NODE_INDEX}" +{{< /code-block >}} + +{{% /tab %}} +{{< /tabs >}} + +`ddtest` antepone `NODE_OPTIONS=-r dd-trace/ci/init` para los procesos de trabajo de JavaScript, por lo que las dependencias del proyecto instaladas antes de `ddtest plan` deben incluir `dd-trace`. Esto no reemplaza la [Test Optimization setup][8] específica del marco de trabajo. Por ejemplo, Cypress requiere instrumentación manual en su archivo de configuración. + +{{< /collapse-content >}} + +## Lecturas adicionales {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /es/tests/setup/ +[2]: /es/tests/test_impact_analysis/ +[3]: https://github.com/DataDog/ddtest/releases/latest +[4]: /es/tests/test_parallelization/configuration/ +[5]: /es/tests/test_parallelization/configuration/#plan-artifacts +[6]: /es/tests/explorer/ +[7]: /es/continuous_integration/explorer/ +[8]: /es/tests/setup/javascript/ \ No newline at end of file diff --git a/hugo/content/es/tracing/_index.md b/hugo/content/es/tracing/_index.md index 96dbc20830c..0649849bc8d 100644 --- a/hugo/content/es/tracing/_index.md +++ b/hugo/content/es/tracing/_index.md @@ -16,53 +16,43 @@ aliases: cascade: algolia: rank: 70 -description: Instrumenta tu código para mejorar el rendimiento +description: Instrumente su código para mejorar el rendimiento further_reading: -- link: https://app.datadoghq.com/release-notes?category=APM - tag: Notas de la versión - text: ¡Consulta las últimas versiones de Datadog APM! (Se requiere inicio de sesión - en la aplicación) +- link: https://www.datadoghq.com/architecture/observability-in-event-driven-architecture/ + tag: Centro de arquitectura + text: Observabilidad en arquitecturas basadas en eventos - link: https://learn.datadoghq.com/courses/getting-started-apm tag: Centro de aprendizaje - text: Comenzando con métricas y trazas de APM -- link: https://www.datadoghq.com/blog/monitor-rust-otel/ - tag: Blog - text: Cómo monitorear tus aplicaciones de Rust con OpenTelemetry + text: Introducción a las métricas y trazas de APM +- link: https://dtdg.co/fe + tag: Foundation Enablement + text: Únase a una sesión interactiva para mejorar su comprensión de APM - link: https://www.datadoghq.com/blog/span-based-metrics/ tag: Blog - text: Genera métricas basadas en tramos para rastrear tendencias históricas en el - rendimiento de la aplicación + text: Genere métricas basadas en tramos para realizar un seguimiento de las tendencias + históricas en el rendimiento de las aplicaciones - link: https://www.datadoghq.com/blog/apm-security-view/ tag: Blog - text: Obtén visibilidad sobre riesgos, vulnerabilidades y ataques con APM Security + text: Obtenga visibilidad de los riesgos, vulnerabilidades y ataques con APM Security View -- link: https://www.datadoghq.com/blog/monitor-azure-app-service-linux/ - tag: Blog - text: Monitorea tus aplicaciones web de Linux en Azure App Service con Datadog -- link: https://www.datadoghq.com/blog/monitor-apis-datadog-api-catalog/ - tag: Blog - text: Gestiona el rendimiento, la seguridad y la propiedad de la API con el Catálogo - de API de Datadog -- link: https://www.datadoghq.com/blog/software-catalog/ - tag: Blog - text: Mejora la experiencia del desarrollador y la colaboración con Software Catalog -- link: https://www.datadoghq.com/blog/datadog-csi-driver/ - tag: Blog - text: Aporta observabilidad de alto rendimiento a entornos Kubernetes seguros con - Datadog's CSI driver -- link: https://dtdg.co/fe - tag: Habilitación de la Fundación - text: Únete a una sesión interactiva para mejorar tu comprensión de APM -- link: https://www.datadoghq.com/blog/gitlab-source-code-integration - tag: Blog - text: Resuelve problemas más rápido con la integración de código fuente de GitLab - en Datadog - link: https://www.datadoghq.com/blog/pubsub-cloud-run-tracing tag: Blog - text: Rastrea cargas de trabajo de Google Pub/Sub en Cloud Run con Datadog + text: Rastree cargas de trabajo de Google Pub/Sub en Cloud Run con Datadog - link: https://www.datadoghq.com/blog/analyzing-roundtrip-query-latency tag: Blog - text: Analizando la latencia de consulta de ida y vuelta + text: Análisis de la latencia de ida y vuelta de las consultas +- link: https://www.datadoghq.com/blog/boomi-observability-opentelemetry-datadog/ + tag: Blog + text: Instrumente y haga un seguimiento de flujos de integración de Boomi con OpenTelemetry + y Datadog +- link: https://www.datadoghq.com/blog/dbm-supabase/ + tag: Blog + text: Haga un seguimiento y optimice el rendimiento de las consultas de Supabase + con Datadog Database Monitoring +- link: https://app.datadoghq.com/release-notes?category=APM + tag: Notas de la versión + text: ¡Eche un vistazo a los últimos lanzamientos de Datadog APM! (Se requiere inicio + de sesión en la aplicación). title: APM --- {{< vimeo url="https://player.vimeo.com/progressive_redirect/playback/381554158/rendition/1080p/file.mp4?loc=external&signature=e19b4e64632c3b1a42b11cb27fca2682dfadecd4690774c005ba2f5079b6a416" poster="/images/poster/tracing.png" >}} @@ -70,70 +60,70 @@ title: APM
-{{< learning-center-callout header="Únete a una sesión de seminario web de habilitación" hide_image="true" btn_title="Regístrate" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=APM">}} - Únete a una sesión de habilitación introductoria o intermedia para aprender más sobre cómo Datadog Application Performance Monitoring (APM) proporciona trazado distribuido a nivel de código impulsado por IA desde aplicaciones de navegador y móviles hasta servicios de backend y bases de datos. +{{< learning-center-callout header="Únase a una sesión de seminario web de habilitación" hide_image="true" btn_title="Registrarse" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=APM">}} + Únase a una sesión de capacitación introductoria o intermedia para obtener más información sobre cómo Datadog Application Performance Monitoring (APM) proporciona trazas distribuidas a nivel de código impulsadas por IA, desde aplicaciones móviles y de navegador hasta servicios backend y bases de datos. {{< /learning-center-callout >}} ## Descripción general {#overview} -Datadog Application Performance Monitoring (APM) proporciona una profunda visibilidad en tus aplicaciones, permitiéndote identificar cuellos de botella en el rendimiento, solucionar problemas y optimizar tus servicios. Con trazado distribuido, tableros listos para usar y correlación sin problemas con otros datos de telemetría, Datadog APM ayuda a garantizar el mejor rendimiento y experiencia de usuario posible para tus aplicaciones. +Datadog Application Performance Monitoring (APM) proporciona una visibilidad profunda de sus aplicaciones, lo que le permite identificar cuellos de botella en el rendimiento, solucionar problemas y optimizar sus servicios. Con trazas distribuidas, los tableros listos para usar y la correlación perfecta con otros datos de telemetría, Datadog APM ayuda a garantizar el mejor rendimiento y la mejor experiencia de usuario posibles para sus aplicaciones. -Para una introducción a la terminología utilizada en Datadog APM, consulta [Términos y conceptos de APM][1]. +Para obtener una introducción a la terminología utilizada en Datadog APM, consulte [APM Terms and Concepts][1]. -## Comenzando {#getting-started} +## Primeros pasos {#getting-started} -La forma más sencilla de comenzar con Datadog APM es con Single Step Instrumentation. Este enfoque instala el Datadog Agent e instrumenta tu aplicación en un solo paso, sin requerir pasos de configuración adicionales. Para aprender más, lee [Single Step Instrumentation][27]. +La forma más sencilla de comenzar con Datadog APM es con la instrumentación de un solo paso (Single Step Instrumentation). Este enfoque instala el Datadog Agent e instrumenta su aplicación en un solo paso, sin necesidad de pasos de configuración adicionales. Para obtener más información, lea [Single Step Instrumentation][27]. -Para configuraciones que requieren más personalización, Datadog admite instrumentación personalizada con Datadog SDKs y [Dynamic Instrumentation][30] en la interfaz de usuario de Datadog. Para aprender más, lee [Application Instrumentation][2]. +Para configuraciones que requieren más personalización, Datadog admite la instrumentación personalizada con los SDK de Datadog y [Dynamic Instrumentation][30] en la interfaz de usuario de Datadog. Para obtener más información, lea [Application Instrumentation][2]. -
Si eres nuevo en Datadog APM, lee Comenzando con APM para aprender cómo enviar tu primera traza a Datadog.
+
Si es nuevo en Datadog APM, lea Getting Started with APM para aprender cómo enviar su primera traza a Datadog.
## Casos de uso {#use-cases} -Descubre algunas formas en que Datadog APM puede ayudar a respaldar tus casos de uso: +Descubra algunas formas en las que Datadog APM puede ayudar a respaldar sus casos de uso: -| Tú quieres...| Cómo Datadog APM puede ayudar | +| Usted quiere...| Cómo puede ayudar Datadog APM | | ----------- | ----------- | -| Entiende cómo fluyen las solicitudes a través de tu sistema. | Usa el [Trace Explorer][21] para consultar y visualizar trazas de extremo a extremo a través de servicios distribuidos. | -| Monitorea la salud y el rendimiento de cada servicio. | Usa [service][26] y [resource pages][28] para evaluar la salud del servicio analizando métricas de rendimiento, rastreando implementaciones e identificando recursos problemáticos. | -| Correlaciona trazas con DBM, RUM, registros, pruebas Synthetic y perfiles. | [Correlate APM Data with Other Telemetry][20] para dar contexto a tus datos y lograr un análisis más completo. | -| Controla cómo fluyen los datos hacia Datadog. | Usa [Ingestion Controls][6] para ajustar la configuración y las tasas de muestreo por servicio y recurso. Usa [Retention filters][7] para elegir qué tramos retener durante 15 días. | +| Comprenda cómo fluyen las solicitudes a través de su sistema. | Utilice el [Trace Explorer][21] para consultar y visualizar trazas de extremo a extremo en servicios distribuidos. | +| Haga un seguimiento del estado y el rendimiento de servicios individuales. | Utilice las [páginas de servicio][26] y [recursos][28] para evaluar el estado del servicio analizando métricas de rendimiento, rastreando implementaciones e identificando recursos problemáticos. | +| Correlacione trazas con DBM, RUM, registros, pruebas Synthetic y perfiles. | [Correlacione datos de APM con otra telemetría][20] para dar contexto a sus datos y realizar un análisis más completo. | +| Controle cómo fluyen los datos hacia Datadog. | Utilice los [Controles de ingesta][6] para ajustar la configuración de ingesta y las tasas de muestreo por servicio y recurso. Utilice los [Filtros de retención][7] para elegir qué tramos conservar durante 15 días. | ### Trace Explorer {#trace-explorer} -El [Trace Explorer][21] te permite buscar y analizar tus trazas en tiempo real. Identifica cuellos de botella en el rendimiento, resuelve errores y consulta los registros y métricas relacionadas para comprender el contexto completo de cualquier incidencia. +El [Trace Explorer][21] le permite buscar y analizar sus trazas en tiempo real. Identifique cuellos de botella en el rendimiento, solucione errores y pivote hacia registros y métricas relacionados para comprender el contexto completo de cualquier problema. -{{< img src="/tracing/trace_explorer/trace_explorer.png" alt="Visualización de Trace Explorer." style="width:100%;" >}} +{{< img src="/tracing/trace_explorer/trace_explorer.png" alt="Vista de Trace Explorer." style="width:100%;" >}} -### Service page {#service-page} +### Página de servicio {#service-page} -La [service page][26] te ayuda a monitorear el rendimiento del servicio y [compare between versions during deployments][15]. +La [página de servicio][26] le ayuda a hacer un seguimiento del rendimiento del servicio y [comparar entre versiones durante las implementaciones][15]. -{{< img src="tracing/deployment_tracking/VersionComparison.png" alt="Versions on the Service Page" style="width:100%;">}} +{{< img src="tracing/deployment_tracking/VersionComparison.png" alt="Versiones en la Página de servicio" style="width:100%;">}} -### Correlacionando trazas con otra telemetría {#correlating-traces-with-other-telemetry} +### Correlación de trazas con otra telemetría {#correlating-traces-with-other-telemetry} -Datadog APM se integra sin problemas con registros, monitoreo de usuario real (RUM), monitoreo sintético y más: +Datadog APM se integra perfectamente con registros, monitoreo de usuarios reales (RUM), monitoreo sintético y más: -- [View your application logs side-by-side with traces][9] para encontrar registros de solicitudes, servicios o versiones específicas. -- [Associate RUM sessions with backend traces][10] para entender cómo el rendimiento del backend afecta la experiencia del usuario. -- [Associate synthetic tests with traces][11] para solucionar fallas en las solicitudes del frontend y del backend. +- [Vea los registros de su aplicación junto con las trazas][9] para encontrar registros de solicitudes, servicios o versiones específicas. +- [Asocie sesiones RUM con trazas de backend][10] para comprender cómo el rendimiento del backend afecta la experiencia del usuario. +- [Asocie pruebas Synthetic con trazas][11] para solucionar problemas en solicitudes de frontend y backend. -{{< img src="tracing/index/ConnectLogsWithTraces.png" alt="Conecta registros y trazas" style="width:100%;">}} +{{< img src="tracing/index/ConnectLogsWithTraces.png" alt="Conecte registros y trazas" style="width:100%;">}} -### Ingestion Controls and Retention Filters {#ingestion-controls-and-retention-filters} +### Controles de ingesta y filtros de retención {#ingestion-controls-and-retention-filters} -Las trazas comienzan en tus aplicaciones instrumentadas y fluyen hacia Datadog. +Las trazas comienzan en sus aplicaciones instrumentadas y fluyen hacia Datadog. -Datadog APM proporciona herramientas para gestionar el volumen y la retención de tus datos de traza. Usa [Ingestion Controls][6] para ajustar las tasas de muestreo y [Retention filters][7] para controlar qué tramos se almacenan. +Datadog APM proporciona herramientas para administrar el volumen y la retención de sus datos de trazas. Utilice [Controles de ingesta][6] para ajustar las tasas de muestreo y [filtros de retención][7] para controlar qué tramos se almacenan. {{< img src="/tracing/apm_lifecycle/apm_lifecycle_0.png" alt="Flujo de datos a través de Datadog APM." style="width:100%;" >}} ## Solución de problemas {#troubleshooting} -Para obtener ayuda con la solución de problemas, lee la guía [APM Troubleshooting][29]. +Para obtener asistencia en la solución de problemas, lea la guía de [Solución de problemas de APM][29]. -## Lectura adicional {#further-reading} +## Lecturas adicionales {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/fr/bits_ai/_index.md b/hugo/content/fr/bits_ai/_index.md index d16624cce04..008ec2a2add 100644 --- a/hugo/content/fr/bits_ai/_index.md +++ b/hugo/content/fr/bits_ai/_index.md @@ -1,46 +1,59 @@ --- aliases: - /fr/bits_ai/query_examples/ -description: Découvrez Bits AI, votre agent dans Datadog, qui automatise le développement, - la sécurité et les flux de travail opérationnels. +description: Découvrez Bits AI, votre coéquipier agentique dans Datadog, qui automatise + les workflows de développement, de sécurité et d'exploitation. disable_toc: false further_reading: -- link: https://www.datadoghq.com/product/ai/bits-ai-agents/ - tag: Page produit - text: Bits AI Agents +- link: /account_management/billing/ai_credits/ + tag: Documentation + text: Crédits IA +- link: /mcp_server/ + tag: Documentation + text: Obtenez des analyses d'observabilité provenant d'agents IA avec Datadog MCP + Server - link: https://www.datadoghq.com/blog/bits-ai-sre/ tag: Blog - text: Présentation de Bits AI SRE, votre agent d'astreinte AI + text: Présentation de Bits Investigation, votre coéquipier IA d'astreinte - link: https://www.datadoghq.com/blog/bits-ai-dev-agent/ tag: Blog - text: Identifiez automatiquement les problèmes et générez des corrections avec Bits - AI Dev + text: Identifiez automatiquement les problèmes et générez des correctifs avec Bits + Code - link: https://www.datadoghq.com/blog/bits-ai-security-analyst/ tag: Blog - text: Automatisez les enquêtes Cloud SIEM avec Bits AI Security Analyst + text: Automatisez les investigations Cloud SIEM avec Bits AI Security Analyst - link: https://www.datadoghq.com/blog/introducing-bits-assistant/ tag: Blog text: Recherchez et agissez dans Datadog pour résoudre les problèmes plus rapidement - avec Bits Assistant. + avec Bits Chat - link: https://www.datadoghq.com/blog/how-to-use-ai-more-effectively/ tag: Blog - text: 'Comment utiliser les outils IA plus efficacement : Conseils des ingénieurs - de Datadog' + text: 'Comment utiliser les outils d''IA plus efficacement : conseils des ingénieurs + Datadog' +- link: https://www.datadoghq.com/product/ai/bits-ai-agents/ + tag: Page du produit + text: Agents Bits AI is_beta: true title: Bits AI --- -Bits AI est votre agent dans Datadog, conçu pour automatiser le développement, la sécurité et les flux de travail opérationnels. Vous pouvez discuter et collaborer avec Bits en temps réel, ou déléguer des tâches complètes—comme les enquêtes d'alerte, les corrections de code ou le triage de sécurité—et le laisser s'occuper des détails. +Bits AI est votre coéquipier agentique dans Datadog, conçu pour automatiser les workflows de développement, de sécurité et d'exploitation. Vous pouvez discuter et collaborer avec Bits en temps réel, ou lui déléguer des tâches complètes — comme les enquêtes sur les alertes, les correctifs de code ou le triage de sécurité — et le laisser s'occuper des détails. + +Découvrez la tarification de Bits AI sur [AI Credits][1]. ## Fonctionnalités {#features} -{{< whatsnext desc="Découvrez comment vous pouvez utiliser Bits AI :" >}} - {{< nextlink href="bits_ai/bits_ai_sre" >}}Enquêtez sur les alertes avec Bits AI SRE{{< /nextlink >}} - {{< nextlink href="bits_ai/bits_ai_dev_agent" >}}Automatisez les corrections de code avec Bits AI Dev Agent{{< /nextlink >}} - {{< nextlink href="bits_ai/bits_ai_security_analyst" >}}Triagez les signaux de menaces de sécurité avec Bits AI Security Analyst{{< /nextlink >}} - {{< nextlink href="bits_ai/bits_assistant" >}}Explorez vos données d'observabilité avec Bits AI Assistant{{< /nextlink >}} - {{< nextlink href="bits_ai/mcp_server" >}}Obtenez des insights d'observabilité des agents AI grâce au serveur MCP de Datadog.{{< /nextlink >}} +{{< whatsnext desc="Découvrez comment utiliser Bits AI :" >}} + {{< nextlink href="bits_ai/bits_investigation" >}}Enquêtez sur les alertes avec Bits Investigation{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_code" >}}Automatisez les correctifs de code avec Bits Code{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_security_analyst" >}}Triez les signaux de menaces de sécurité avec Bits Security Analyst{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_chat" >}}Explorez vos données d'observabilité avec Bits Chat{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_data_analysis" >}}Explorez vos données métier dans un langage naturel avec Bits Data Analysis{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_detection" >}}Surveillez de manière autonome les dégradations de service impactantes avec Bits Detection{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_remediation" >}}Agissez sur les causes profondes avec Bits Remediation{{< /nextlink >}} {{< /whatsnext >}} -## Lectures complémentaires {#further-reading} +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} -{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file +[1]: /fr/account_management/billing/ai_credits/ \ No newline at end of file diff --git a/hugo/content/fr/bits_ai/bits_investigation/knowledge_sources.md b/hugo/content/fr/bits_ai/bits_investigation/knowledge_sources.md new file mode 100644 index 00000000000..941f836c595 --- /dev/null +++ b/hugo/content/fr/bits_ai/bits_investigation/knowledge_sources.md @@ -0,0 +1,119 @@ +--- +aliases: +- /fr/bits_ai/bits_ai_sre/help_bits_learn/ +- /fr/bits_ai/bits_investigation/help_bits_learn/ +- /fr/bits_ai/bits_ai_sre/knowledge_sources/ +title: Sources de connaissances +--- +Bits Investigation s'améliore avec le temps en combinant trois sources de connaissances distinctes : +- [**Runbooks :**](#runbooks) Conseils de dépannage étape par étape +- [**bits.md :**](#bitsmd) Contexte sur votre environnement +- [**Retours et souvenirs :**](#feedback-and-memories) Apprentissages issus des investigations + +## Runbooks {#runbooks} +Considérez l'intégration de Bits comme vous le feriez pour un nouveau coéquipier : plus vous fournissez de contexte, mieux il peut enquêter. + +Vous pouvez soit ajouter des instructions de dépannage étape par étape directement dans le message du monitor, soit créer un lien vers une page Confluence qui contient ces instructions. + +- **Inclure des liens de télémétrie Datadog** : Lors de l'ajout d'instructions dans le message du monitor, incluez des liens vers la télémétrie la plus pertinente. Commencez par le premier endroit où vous regarderiez normalement dans Datadog lorsque le monitor se déclenche, comme un dashboard, des logs, des traces ou un notebook avec des widgets clés. Les liens n'ont pas besoin d'un formatage spécial ; les URL simples fonctionnent. + +Comme ces liens sont définis par l'utilisateur, vous avez le contrôle sur ce que Bits examine, ce qui garantit qu'il se concentre sur les mêmes données que vous, et vous donne la flexibilité d'adapter les investigations aux workflows de votre équipe. + +- **Notebooks** : Les monitors peuvent renvoyer vers des notebooks contenant des instructions sur la façon de dépanner le monitor ou le service associé. Les notebooks prennent en charge le markdown ainsi que les requêtes Datadog, donnant à l'agent des instructions sur la meilleure façon d'effectuer une analyse des causes profondes. + +- **Confluence integration** : Si vos runbooks se trouvent dans Confluence, liez les pages pertinentes dans le message du monitor. Lors d'une investigation, Bits lit la page, extrait les liens de télémétrie, suit les étapes de dépannage documentées lorsque cela est possible et intègre les conseils de remédiation dans ses recommandations. + +Pour maximiser la valeur de cette intégration, documentez en détail les services, les dépendances et les systèmes impliqués, et fournissez des instructions claires et étape par étape pour résoudre le problème. Des runbooks bien structurés et spécifiques permettent à Bits de mener des investigations plus précises et efficaces. + +{{< img src="bits_ai/optimization_example.png" alt="Exemple de monitor avec des étapes d'optimisation appliquées" style="width:100%;" >}} + +## Bits.md {#bitsmd} + +Vous pouvez guider de manière proactive la façon dont Bits examine votre environnement en créant un fichier `bits.md` dans [{{< ui >}}Bits Investigation{{< /ui >}} > {{< ui >}}Settings{{< /ui >}} > {{< ui >}}Bits.md{{< /ui >}}][2]. + +`bits.md` est un fichier Markdown qui fournit un contexte structuré sur votre environnement à Bits. Il sert de guide léger pour améliorer la précision de l'investigation, la construction des requêtes et l'alignement de la terminologie. Ajoutez des connaissances spécifiques à l'équipe telles que les conventions de marquage, les modèles architecturaux, les termes du glossaire et les meilleures pratiques d'investigation. + +### Exemple bits.md {#sample-bitsmd} + +{{< code-block lang="markdown" filename="bits.md" collapsible="true" >}} + +## Scope rules +- Always carry forward explicit scope from the user (env, service, team, region, namespace). +- Treat mentioned values as hard filters in all queries. +- Do not broaden scope unless explicitly asked. + +--- + +## Tag and naming conventions + +### Environment normalization +Environment values may differ across telemetry sources (monitors, APM, logs, tickets). + +Example: +- Alerts/APM: `env:blue-prod` +- Logs: `env:prod` + +Rule: When switching data sources, normalize to the correct env value for that source before querying. + +--- + +### Service name normalization +Service/application names may appear in different formats across systems (alerts, logs, tickets, asset systems). + +Example: +- Alert tag: `checkout_prd` +- Ticketing system: `CHECKOUT` +- Logs: `checkout-service` + +Rule: +- Derive a canonical service name. +- Use case-insensitive or wildcard matching when correlating across systems. +- Do not assume naming is identical across tools. + +--- + +## Kubernetes quick checks +For pod issues, check Kubernetes events first: +`source:kubernetes pod_name: kube_namespace:` + +Common causes: +- `FailedMount` → missing Secret/ConfigMap +- `ImagePullBackOff` → image/registry issue +- `OOMKilled` → memory pressure + +--- + +## Known noise and false positives +Document recurring patterns that look like incidents but are expected behavior. + +Examples: +- Nightly batch jobs trigger CPU spikes between 02:00–02:30 UTC. +- Synthetic monitoring tests intentionally generate short-lived 5xx errors. +- Canary deployments temporarily increase error rates during rollout. +- Autoscaling events may cause brief latency spikes. + +Rule: +- Check whether the signal matches a documented noise pattern. +- If behavior matches a known pattern, classify as expected unless additional impact is observed. + +{{< /code-block >}} + +## Retours et souvenirs {#feedback-and-memories} + +À la fin d'une investigation, indiquez à Bits si la conclusion qu'il a tirée était correcte. + +{{< img src="bits_ai/help_bits_ai_learn_2.png" alt="Flux de retours sur la cause profonde après investigation" style="width:100%;" >}} + +Si la conclusion était inexacte, fournissez à Bits la cause profonde correcte, en soulignant ce qu'il a manqué et en expliquant ce qu'il devrait faire différemment la prochaine fois. Vos retours doivent : +- Identifier la cause profonde réelle (pas seulement les effets ou symptômes observés) +- Spécifier les services, composants ou métriques pertinents +- Inclure des liens de télémétrie pointant vers la cause profonde + +**Exemple de commentaire de cause profonde de haute qualité** : « Utilisation élevée de la mémoire dans le pod auth-service due à une fuite de mémoire dans le cache de session, provoquant des arrêts OOM toutes les 2 heures à partir du 2025-11-15 14:30 UTC. » Cela est démontré par `https://app.datadoghq.com/logs?`. + +Tous les retours positifs, ainsi que tout retour négatif incluant des détails fournis dans le chat de Bits, créent une **mémoire**. Bits sélectionne dynamiquement les mémoires à utiliser lors des futures investigations pour améliorer ses performances. Il applique les corrections passées dans des contextes similaires, réutilise les requêtes efficaces et affine la façon dont il hiérarchise les étapes d'investigation. Au fil du temps, cela permet à Bits de s'adapter à votre environnement, devenant plus précis et efficace à chaque investigation. + +Pour gérer les mémoires, notamment pour les consulter et les supprimer, accédez à la colonne {{< ui >}}Memories{{< /ui >}} de la page [Monitor Management][1]. + +[1]: https://app.datadoghq.com/bits-ai/monitors/supported +[2]: https://app.datadoghq.com/bits-ai/settings/bits-md \ No newline at end of file diff --git a/hugo/content/fr/byoc-logs/operate/sizing.md b/hugo/content/fr/byoc-logs/operate/sizing.md new file mode 100644 index 00000000000..c7b63922870 --- /dev/null +++ b/hugo/content/fr/byoc-logs/operate/sizing.md @@ -0,0 +1,195 @@ +--- +aliases: +- /fr/cloudprem/configure/cluster_sizing/ +- /fr/cloudprem/operate/sizing/ +description: En savoir plus sur le dimensionnement des clusters pour les BYOC Logs +further_reading: +- link: /byoc-logs/configure/ingress/ + tag: Documentation + text: Configurer l'Ingress des BYOC Logs +- link: /byoc-logs/configure/pipelines/ + tag: Documentation + text: Configurer le traitement des BYOC Logs +- link: /byoc-logs/introduction/architecture/ + tag: Documentation + text: En savoir plus sur l'architecture des BYOC Logs +title: Dimensionnement du cluster +--- +{{< jqmath-vanilla >}} + +## Présentation {#overview} + +Un dimensionnement approprié du cluster permet de garantir des performances, une rentabilité et une fiabilité optimales pour votre déploiement de logs BYOC (Bring Your Own Cloud). Vos besoins en matière de dimensionnement dépendent de plusieurs facteurs, notamment le volume d'ingestion des logs, les modèles de requête, la période de rétention et la complexité de vos données de log. + +Les [exemples de dimensionnement](#sizing-examples) ci-dessous fournissent des configurations de départ pour des volumes de logs quotidiens courants. Pour des conseils plus approfondis sur chaque composant, consultez les sections qui suivent. + +
+Utilisez votre volume de logs quotidien attendu et vos taux d'ingestion de pointe comme points de départ, puis surveillez les performances de votre cluster et ajustez le dimensionnement si nécessaire. +
+ +## Exemples de dimensionnement {#sizing-examples} + +Le tableau suivant fournit des configurations de référence pour des volumes de logs quotidiens courants. Ces recommandations sont destinées à servir de points de départ et doivent être ajustées en fonction de l'utilisation des ressources et des performances de requête observées. + +Comme point de départ, prévoyez environ : + +- 2 vCPU d'indexeur par To de logs ingérés par jour +- 1 vCPU de compacteur pour 2 To de logs ingérés par jour + +La capacité des Searchers dépend de la simultanéité des requêtes, de la complexité des requêtes et de la quantité de données analysées. Il doit donc être dimensionné en fonction de la charge de travail de recherche attendue plutôt que du seul volume d'ingestion. Les charges de travail intensives en analyse peuvent nécessiter jusqu'à deux fois la capacité de recherche de référence indiquée ci-dessous. + +Ces recommandations supposent l'utilisation de processeurs x86 modernes, tels que ceux utilisés dans les types d'instances AWS M6, ou de processeurs équivalents d'autres fournisseurs de cloud. Les processeurs basés sur ARM, tels qu'AWS Graviton, peuvent offrir une meilleure rentabilité à débit comparable. + +Le tableau suivant indique la capacité totale en vCPU pour chaque composant. + +| Volume quotidien | Total vCPU Indexeur | Total vCPU Compactor | Total vCPU Searcher | +|---------------:|--------------------:|----------------------:|---------------------:| +| **1 To/jour** | 2 | 0,5 | 4 | +| **10 To/jour** | 20 | 5 | 40 | +| **100 To/jour** | 200 | 50 | 400 | + +Utilisez les allocations de CPU et de mémoire par pod suivantes comme point de départ pour répartir la capacité totale entre les pods : + +| Volume quotidien | Indexeur par pod | Compactor par pod | Searcher par pod | +|-----------------|----------------:|------------------:|-----------------:| +| **Jusqu'à 30 To/jour** | 4 vCPU, 16 Go | 4 vCPU, 16 Go | 16 vCPU, 64 Go | +| **Au-delà de 30 To/jour** | 8 vCPU, 32 Go | 8 vCPU, 32 Go | 64 vCPU, 256 Go | + +
+Facturation par rapport au provisionnement : Les vCPU provisionnés et les vCPU facturés sont différents. Un cluster de production est intentionnellement surprovisionné pour absorber les pics d'ingestion et de recherche. Contactez votre représentant Datadog pour obtenir des conseils sur la facturation. +
+ +## Indexeurs {#indexers} + +Les indexeurs reçoivent les logs des agents Datadog, puis les traitent, les indexent et les stockent sous forme de fichiers d'index (appelés _splits_) dans le stockage objet. Un dimensionnement approprié est essentiel pour maintenir le débit d'ingestion et garantir que votre cluster peut gérer votre volume de logs. + +| Spécification | Recommandation | Remarques | +|----------------------|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **Performances** | 8 Mo/s par vCPU | Débit de base pour déterminer le dimensionnement initial. Les performances réelles dépendent des caractéristiques des logs (taille, nombre d'attributs, niveau d'imbrication) | +| **Mémoire** | 4 Go de RAM par vCPU | | +| **Taille minimale de pod** | 2 vCPU, 8 Go de RAM | Minimum recommandé pour les pods d'indexeur | +| **Capacité de stockage** | Au moins 30 Go | Requis pour les données temporaires lors de la création et de la fusion des fichiers d'index | +| **Type de stockage** | Stockage en mode bloc attaché au réseau | Par exemple : Amazon EBS gp3, Azure Managed Disks ou GCP Persistent Disk. Les données sont temporairement stockées dans un log de pré-écriture (WAL) avant d'être téléchargées vers le stockage objet. Le WAL n'est pas répliqué, donc l'utilisation de SSD locaux (éphémères) augmente le risque de perdre quelques minutes de données en cas de défaillance du disque. Le stockage en mode bloc attaché au réseau offre une redondance intégrée. | +| **E/S disque** | ~20 Mo/s par vCPU | Équivalent à 320 IOPS par vCPU pour Amazon EBS (en supposant 64 Ko par IOPS). Par exemple, le débit par défaut d'Amazon EBS gp3 de 125 Mio/s est suffisant pour un indexeur de 4 vCPU. | + + +{{% collapse-content title="Exemple : Dimensionnement pour 100 To de logs par jour" level="h3" expanded=false %}} +Pour indexer 100 To de logs par jour (~1 160 Mo/s), suivez ces étapes : + +1. **Calculer les vCPU :** `1,160 MB/s ÷ 8 MB/s per vCPU ≈ 145 vCPUs` +2. **Calculer la RAM :** `145 vCPUs × 4 GB RAM per vCPU ≈ 580 GB RAM` +3. **Ajouter une marge de sécurité :** Commencez avec 50 pods indexeurs, chacun configuré avec **4 vCPU, 16 Go de RAM et un disque de 30 Go**. Ajustez ces valeurs en fonction des performances observées et des besoins en redondance. +{{% /collapse-content %}} + +{{% collapse-content title="Dimensionnement par nombre d'événements" level="h3" expanded=false %}} +Si vous connaissez votre nombre quotidien d'événements mais pas votre volume en octets, utilisez cette formule pour estimer : + +$$\\text\"Volume quotidien (To)\" = {\\text\"événements par jour\" × \\text\"taille moyenne d'un événement (octets)\"} / 10^\{12\}$$ + +Par exemple, avec 1 milliard d'événements/jour à une taille moyenne de 1 Ko : + +`1,000,000,000 × 1,000 / 1,000,000,000,000 = 1 TB/day` + +Les tailles typiques des événements de logs varient de 500 octets (syslog court) à 2–3 Ko (JSON avec des tags Kubernetes). Mesurez un échantillon représentatif de vos logs pour obtenir une moyenne précise. +{{% /collapse-content %}} + +## Compacteurs {#compactors} + +Le compacteur fusionne les petits segments d'index en segments plus grands pour réduire la fragmentation et améliorer l'efficacité de la recherche. Il supprime également les segments obsolètes pour récupérer de l'espace de stockage. + +| Spécification | Recommandation | Notes | +|------------------|---------------------|--------------------------------------------------------------| +| **Performances** | 1 vCPU par 2 To/jour | Référence pour le dimensionnement initial | +| **Mémoire** | 4 Go de RAM par vCPU | | +| **Type de stockage** | SSD local | Les instances avec SSD locaux, telles que AWS M8gd, sont recommandées | + +## Searchers {#searchers} + +Les Searchers traitent les requêtes de recherche depuis l'interface utilisateur Datadog, lisent les métadonnées du Metastore et récupèrent les données du stockage objet. + +Un point de départ général consiste à provisionner environ le double du nombre total de vCPU alloués aux Indexeurs. Consultez nos exemples de dimensionnement. + +- **Performances :** Les performances de recherche dépendent fortement de la charge de travail (complexité des requêtes, concurrence, quantité de données analysées). Par exemple, les requêtes de terme (`status:error AND message:exception`) sont généralement moins coûteuses en calcul que les requêtes de recherche par caractères génériques ou sur l'événement complet. +- **Mémoire :** 4 Go de RAM par vCPU de recherche. Allouez plus de RAM si vous prévoyez de nombreuses demandes d'agrégation simultanées. + + +## Autres services {#other-services} + +Allouez les ressources suivantes pour ces composants légers : + +| Service | vCPU | RAM | Réplicas | +|---------|-------|-----|----------| +| **Plan de contrôle** | 2 | 4 Go | 1 | +| **Metastore** | 2 | 4 Go | 2 | +| **Janitor** | 2 | 4 Go | 1 | + +## Estimation du stockage objet {#object-storage-estimation} + +BYOC Logs compresse et indexe les données de logs avant de les stocker dans un stockage d'objets. Le taux de compression dépend du format des logs, de la structure et de la redondance de vos données. + +| Métrique | Plage typique | +|--------|---------------| +| **Taux de compression** | 5x à 8x (entrée brute par rapport à la taille stockée) | +| **Stockage par To/jour ingéré** | 125-200 Go/jour sur stockage objet | + +Pour estimer vos besoins en stockage d'objets : + +$$\\text\"Données stockées par jour\" = {\\text\"Volume quotidien\"} / {\\text\"Taux de compression\"}$$ + +$$\\text\"Stockage total\" = \\text\"Données stockées par jour\" × \\text\"période de rétention (jours)\"$$ + +Les exemples suivants supposent une période de rétention de 30 jours et un taux de compression de 6x : + +| Volume quotidien | Stockage d'objets | +|---------------:|---------------:| +| **1 To/jour** | ~5 To | +| **10 To/jour** | ~50 To | +| **100 To/jour** | ~500 To | + +{{% collapse-content title="Exemple : Stockage pour 10 To/jour avec une rétention de 30 jours" level="h3" expanded=false %}} +En supposant un taux de compression de 6x : + +1. **Données stockées par jour :** `10 TB / 6 ≈ 1.67 TB/day` +2. **Total pour 30 jours :** `1.67 TB × 30 ≈ 50 TB` + +Utilisez un stockage d'objets de niveau standard (par exemple, S3 Standard, GCS Standard) pour les données actives. Les niveaux de coût inférieur tels que S3 Infrequent Access ou GCS Nearline ne sont pas validés pour une utilisation avec BYOC Logs. +{{% /collapse-content %}} + +## Base de données PostgreSQL {#postgresql-database} + +- **Taille de l'instance :** Pour la plupart des cas d'utilisation, une instance PostgreSQL avec 1 vCPU et 4 Go de RAM est suffisante +- **Recommandation AWS RDS :** Si vous utilisez AWS RDS, le type d'instance `t4g.medium` est un point de départ approprié +- **Haute disponibilité :** Activez le déploiement Multi-AZ avec un réplica de secours pour une haute disponibilité + +## Niveaux de dimensionnement du chart Helm {#helm-chart-sizing-tiers} + +Le chart Helm BYOC Logs fournit des niveaux de ressources prédéfinis via les paramètres `indexer.podSize` et `searcher.podSize`. `podSize` sélectionne les besoins en ressources du pod et les paramètres de réglage Quickwit associés. La valeur par défaut `podSize` est `xlarge` pour les deux composants. Chaque préréglage est conçu pour laisser de l'espace sur un nœud correspondant pour les composants système Kubernetes, les DaemonSets et les modules complémentaires. + +Les préréglages tiennent compte des ressources réservées aux composants système de Kubernetes. Les montants de réservation sont basés sur le [calcul de réservation de nœud GKE](https://docs.cloud.google.com/kubernetes-engine/docs/concepts/plan-node-sizes#resource_reservations). Un supplément de 250m de CPU et 512Mi de mémoire par nœud est réservé pour les DaemonSets et les modules complémentaires : + +```text +Actual CPU request = (nominal pod CPU - Kubernetes system CPU reservation - 250m), rounded down to the nearest 100m +Actual memory request/limit = (nominal pod memory - Kubernetes system memory reservation - 512Mi), rounded down to the nearest 100Mi +``` + +| `podSize` | Demande de CPU nominale | Demande de CPU réelle | Demande/limite de mémoire nominale | Demande/limite de mémoire réelle | +|---|---:|---:|---:|---:| +| `large` | 2 | 1600m | 8Gi | 5700Mi | +| `xlarge` | 4 | 3600m | 16Gi | 13100Mi | +| `2xlarge` | 8 | 7600m | 32Gi | 28500Mi | +| `4xlarge` | 16 | 15600m | 64Gi | 59300Mi | +| `6xlarge` | 24 | 23600m | 96Gi | 90100Mi | +| `8xlarge` | 32 | 31600m | 128Gi | 120900Mi | + +Les préréglages ne définissent pas de limite de CPU, permettant à un pod d'utiliser le CPU inutilisé sur son nœud sans être limité. Les demandes et les limites de mémoire sont égales afin de maintenir l'utilisation de la mémoire dans la capacité allouable du nœud. + +Les valeurs définissant les tailles de la file d'attente d'ingestion et les tailles du cache de recherche sont automatiquement appliquées pour le niveau sélectionné. Consultez la [carte de dimensionnement du chart Helm][1] pour la configuration complète. Pour plus de détails sur chaque paramètre, consultez la documentation de Quickwit pour les [paramètres de l'indexeur][2], les [paramètres de l'API d'ingestion][3] et les [paramètres du moteur de recherche][4]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://github.com/DataDog/helm-charts/blob/main/charts/cloudprem/sizing-map.yaml +[2]: https://quickwit.io/docs/configuration/node-config#indexer-configuration +[3]: https://quickwit.io/docs/configuration/node-config#ingest-api-configuration +[4]: https://quickwit.io/docs/configuration/node-config#searcher-configuration \ No newline at end of file diff --git a/hugo/content/fr/cloud_cost_management/reporting/explorer.md b/hugo/content/fr/cloud_cost_management/reporting/explorer.md new file mode 100644 index 00000000000..386c8112a5f --- /dev/null +++ b/hugo/content/fr/cloud_cost_management/reporting/explorer.md @@ -0,0 +1,172 @@ +--- +description: Interrogez et analysez les coûts cloud en temps réel grâce à des filtres + et des visualisations flexibles. +further_reading: +- link: /cloud_cost_management/reporting/ + tag: Documentation + text: Créez et enregistrez des rapports de coûts +- link: /cloud_cost_management/tags/multisource_querying + tag: Documentation + text: Interrogez les coûts auprès de plusieurs fournisseurs +- link: /monitors/types/cloud_cost/ + tag: Documentation + text: Créez des monitors de coûts +- link: /cloud_cost_management/ + tag: Documentation + text: Découvrez Cloud Cost Management. +title: Cost Explorer +--- +## Présentation {#overview} + +Le [Cloud Cost Explorer][1] fournit une interface interactive basée sur des requêtes pour analyser vos dépenses cloud sur [AWS][2], [Azure][3], [Google Cloud][4], [Oracle][5], [les fournisseurs SaaS][6] et [les coûts Datadog][7]. Contrairement aux rapports enregistrés, l'Explorer vous permet d'effectuer des analyses ad hoc avec des requêtes, des filtres et des visualisations flexibles pour étudier les tendances des coûts, identifier les anomalies et répondre à des questions spécifiques sur vos dépenses cloud. + +Utilisez le Cost Explorer pour : +- Créez des requêtes personnalisées auprès de plusieurs fournisseurs à l'aide de tags, de services et de filtres +- Étudiez l'évolution des coûts au fil du temps grâce à des regroupements et des ventilations flexibles +- Téléchargez des données, créez des widgets de dashboard ou configurez des monitors de coûts + +## Interrogez vos données de coûts {#query-your-cost-data} + +1. Accédez à [**Cloud Cost > Analyze > Explorer**][1] dans Datadog. +2. Créez une requête de recherche à l'aide de l'éditeur de requête ou des filtres déroulants : + - Utilisez le menu déroulant {{< ui >}}Provider{{< /ui >}} pour sélectionner un ou plusieurs fournisseurs cloud + - Cliquez sur {{< ui >}}\+ Filter{{< /ui >}} pour ajouter des filtres pour les services, les tags, les régions, les équipes et d'autres attributs + - Saisissez directement dans la barre de recherche pour des requêtes plus avancées + + {{< img src="cloud_cost/reporting/reporting-overview-1.png" alt="Le générateur de requêtes Cloud Cost Explorer affichant la sélection du fournisseur, les filtres de type de coût, la recherche par tag, les filtres de service et les options de regroupement" style="width:100%;" >}} + +3. Regroupez vos données de coûts en cliquant sur {{< ui >}}Group by{{< /ui >}} et en sélectionnant des dimensions telles que : + - Nom du fournisseur + - Nom du service + - Tags de ressource (telles que `team`, `env`, `project`) + - Région + - ID de compte + +4. Sélectionnez une plage horaire à l'aide du sélecteur de temps pour analyser les coûts sur différentes périodes (heure, jour, semaine, mois ou plage personnalisée). + +**Remarque** : lors de l'interrogation des coûts auprès de plusieurs fournisseurs, les tags au niveau de la ressource ne sont pas disponibles. Pour accéder aux tags spécifiques aux ressources, filtrez sur un seul fournisseur dans votre requête. + +## Panneau latéral Résumé des variations de coûts {#cost-change-summary-side-panel} + +Cliquez sur n'importe quelle ligne du tableau en bas de l'Explorer pour ouvrir le {{< ui >}}Cost Change Summary panel{{< /ui >}} pour ce fournisseur, ce service ou cette ressource spécifique. Le panneau met en évidence ce qui, ou qui, peut être à l'origine des variations de coûts pour la période actuelle par rapport à la période précédente. + +Le panneau contient quatre sections générales : +- Résumé des changements de coûts +- Équipes associées +- Détails des variations +- Enquêtez davantage + +{{< img src="cloud_cost/reporting/cost-change-sidepanel.png" alt="Le panneau Résumé des changements de coûts met en évidence ce qui, ou qui, peut être à l'origine des variations de coûts pour la période actuelle par rapport à la période précédente." style="width:100%;" >}} + +En haut, vous pouvez voir le **coût total** pour la période actuelle ainsi que la variation des coûts en dollars et en pourcentage par rapport à la période précédente (**ce qui s'est passé**). + +### Enquêtez sur le changement {#investigate-the-change} + +Utilisez les sections {{< ui >}}Change Details{{< /ui >}} et {{< ui >}}Investigate Further{{< /ui >}} pour : + +- **Identifiez instantanément les anomalies de coûts** : les écarts de coûts inattendus, calculés par rapport aux données historiques, sont automatiquement mis en évidence en rouge, ce qui vous permet de concentrer votre enquête sur les tendances critiques. + +- **Analysez les facteurs de changement** : Déterminez facilement la cause d'une variation de coût, qu'elle soit due à un changement d'**utilisation** (le nombre de ressources) ou à un changement de **prix unitaire** (le coût par ressource). Par exemple, dans la capture d'écran ci-dessous, la variation des dépenses est due à un changement du prix unitaire plutôt qu'à l'utilisation : le nombre de ressources reste stable tandis que le coût par ressource augmente et diminue, provoquant la variation globale des coûts. + +{{< img src="cloud_cost/reporting/cloud-cost-spend-summary.png" alt="La variation des dépenses est due à un changement du prix unitaire plutôt qu'à l'utilisation : le nombre de ressources reste stable tandis que le coût par ressource augmente et diminue, provoquant la variation globale des coûts." style="width:100%;" >}} + +### Collaborez et surveillez {#collaborate-and-monitor} + +- **Contactez l'équipe responsable** : + - Consultez la section {{< ui >}}Associated Team(s){{< /ui >}} pour identifier quelles équipes possèdent les ressources à l'origine de la variation des coûts (déduites à partir de tags tels que `team:shopist`). Faites un suivi auprès des équipes listées (par exemple, Shopist, Platform, Cloud-Networks) pour obtenir le contexte complet du changement. + - Cliquez sur {{< ui >}}Send Notebook{{< /ui >}} pour partager directement le contexte complet de l'enquête sur les coûts avec l'équipe, leur permettant de consigner les conclusions, d'ajouter des annotations et de suivre le fil de l'enquête. + +- **Filtrez par tags** : + - Utilisez {{< ui >}}Associated Tags{{< /ui >}} pour voir tous les tags contribuant au poste de coût. + - Cliquez sur n'importe quelle valeur de tag (comme `account:demo` ou une `aws_account` spécifique) pour affiner votre recherche et filtrer l'ensemble de l'Explorer afin de n'afficher que les ressources possédant ce tag. + +- **Créez un monitor** : + - Configurez un monitor Cloud Cost pour être alerté la prochaine fois qu'un changement similaire se produira. En savoir plus sur les [monitors Cloud Cost][8]. + +## Affiner vos résultats {#refine-your-results} + +Cliquez sur {{< ui >}}Refine Results{{< /ui >}} pour accéder aux options de filtrage avancées qui vous aident à vous concentrer sur des modèles de coûts spécifiques. + + {{< img src="cloud_cost/reporting/refine-results.png" alt="Le panneau Affiner les résultats affiche des options de filtrage, notamment Frais d'utilisation uniquement, Jours complets uniquement, Coût total, Variation en dollars et Variation en pourcentage." style="width:100%;" >}} + +{{< ui >}}Complete Days Only{{< /ui >}} +: Excluez les données de coût des deux derniers jours, qui peuvent être incomplètes. Utilisez cette option pour une analyse historique précise. + +{{< ui >}}Total Cost{{< /ui >}} +: Filtrez les données pour afficher les coûts dans une plage de dollars spécifique (par exemple, n'afficher que les ressources coûtant plus de 1 000 $). + +{{< ui >}}Dollar Change{{< /ui >}} +: Affichez uniquement les variations de coût dans une plage de montant spécifiée (par exemple, affichez les services avec une augmentation de 500 $ ou plus). + +{{< ui >}}Percent Change{{< /ui >}} +: Affichez uniquement les variations de coût dans une plage de pourcentage spécifiée (par exemple, affichez les ressources avec une augmentation de coût de 20 % ou plus). + +## Modifier les vues de données {#change-data-views} + +Le Cost Explorer affiche vos données de coût sous forme de série temporelle avec une ventilation en tableau. Vous pouvez modifier la façon dont le graphique affiche les données en sélectionnant l'une des vues suivantes : + +- {{< ui >}}Costs ($){{< /ui >}} : Affichez les coûts totaux en dollars au fil du temps +- {{< ui >}}Change trends (%){{< /ui >}} : Affichez les variations de coût sous forme d'augmentations ou de diminutions en pourcentage +- {{< ui >}}Change trends ($){{< /ui >}} : Affichez les variations de coût en montants monétaires + +{{< img src="cloud_cost/reporting/change-view.png" alt="Menu déroulant affichant trois options de vue : Coûts en $, Tendances de changement en % et Tendances de changement en $" style="width:100%;" >}} + +Passez d'une vue à l'autre pour déterminer si vous suivez les coûts absolus ou si vous analysez les variations de coûts. + +### Options d'affichage du tableau {#table-display-options} + +Sous le graphique, le tableau affiche les coûts ventilés selon le regroupement sélectionné (tel que le fournisseur, le nom du service ou les tags). Vous pouvez personnaliser la façon dont ces données sont affichées. + +{{< img src="cloud_cost/reporting/table-display-options.png" alt="Options d'affichage du tableau montrant les modes de vue Résumé et Ventilation, les bascules de visibilité des colonnes et le filtre Top changements uniquement" style="width:100%;" >}} + +**Modes de vue** +- {{< ui >}}Summary{{< /ui >}} : Affichez les coûts agrégés sur toutes les périodes pour une vue d'ensemble de haut niveau +- {{< ui >}}Breakdown{{< /ui >}} : Consultez les coûts ventilés par période (quotidienne, hebdomadaire ou mensuelle selon la plage temporelle sélectionnée) + +**Filtres** +- {{< ui >}}Top changes only{{< /ui >}} : Cochez cette case pour filtrer le tableau et afficher uniquement les ressources ou services présentant les plus fortes augmentations ou diminutions de coûts + +**Visibilité des colonnes** + +Affichez ou masquez des colonnes dans le tableau pour vous concentrer sur les métriques importantes : +- {{< ui >}}Total{{< /ui >}}: Coûts totaux agrégés pour chaque ressource ou service +- {{< ui >}}Dollar change trends{{< /ui >}}: Variations des coûts en montants monétaires au fil du temps +- {{< ui >}}Change trends{{< /ui >}}: Variations des coûts en pourcentage au fil du temps + +## Exporter et partager {#export-and-share} + +Après avoir analysé les coûts dans l'Explorer, vous pouvez : + +### Exporter au format csv {#export-to-csv} +Téléchargez vos données de coûts pour une analyse hors ligne, pour établir des rapports ou pour les partager avec les parties prenantes. Cliquez sur le bouton {{< ui >}}Export{{< /ui >}} et sélectionnez {{< ui >}}Download as CSV{{< /ui >}}. + +### Créez un widget de dashboard {#create-a-dashboard-widget} +Enregistrez votre requête actuelle en tant que widget de dashboard pour surveiller les coûts parallèlement à d'autres métriques : +1. Cliquez sur {{< ui >}}Export{{< /ui >}} et sélectionnez {{< ui >}}Export to Dashboard{{< /ui >}}. +2. Choisissez un dashboard existant ou créez-en un. +3. Personnalisez le titre et les paramètres du widget. + +### Créer un monitor de coûts {#create-a-cost-monitor} +Configurez des alertes basées sur votre requête actuelle pour être avertis lorsque les coûts dépassent les seuils ou changent de manière inattendue : +1. Cliquez sur {{< ui >}}Export{{< /ui >}} et sélectionnez {{< ui >}}Create Monitor{{< /ui >}}. +2. Configurez les conditions d'alerte (par exemple, lorsque les coûts dépassent 10 000 $ ou augmentent de 20 %). +3. Définissez les canaux de notification (e-mail, Slack, PagerDuty). + +En savoir plus sur les [monitors Cloud Cost][8]. + +### Partager votre requête {#share-your-query} +Copiez l'URL depuis votre navigateur pour partager votre requête de coûts actuelle avec les membres de l'équipe. L'URL inclut tous les filtres, regroupements et paramètres de plage de temps. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/cost/analyze/explorer +[2]: /fr/cloud_cost_management/aws/ +[3]: /fr/cloud_cost_management/azure/ +[4]: /fr/cloud_cost_management/google_cloud/ +[5]: /fr/cloud_cost_management/oracle/ +[6]: /fr/cloud_cost_management/saas_costs/ +[7]: /fr/cloud_cost_management/datadog_costs/ +[8]: /fr/monitors/types/cloud_cost/ +[9]: /fr/cloud_cost_management/reporting/ \ No newline at end of file diff --git a/hugo/content/fr/containers/guide/auto_conf.md b/hugo/content/fr/containers/guide/auto_conf.md index 6f4ae03713d..fba561ad98b 100644 --- a/hugo/content/fr/containers/guide/auto_conf.md +++ b/hugo/content/fr/containers/guide/auto_conf.md @@ -1,30 +1,29 @@ --- algolia: tags: - - configuration automatique - - ignorer la configuration automatique - - configuration automatique - - ignorer la configuration automatique + - auto conf + - ignore auto conf + - autoconf + - ignore autoconf aliases: - /fr/agent/autodiscovery/auto_conf - /fr/agent/faq/auto_conf - /fr/agent/guide/auto_conf -description: Gérer la configuration automatique pour les services conteneurisés populaires - à l'aide de modèles de configuration automatique Autodiscovery +description: Gérer la configuration automatique des services conteneurisés populaires + à l'aide des modèles d'autoconfiguration Autodiscovery further_reading: - link: /containers/kubernetes/integrations/ tag: Documentation - text: Configurer des intégrations avec Autodiscovery sur Kubernetes + text: Configurez les intégrations avec Autodiscovery sur Kubernetes - link: /containers/docker/integrations/ tag: Documentation - text: Configurer des intégrations avec Autodiscovery sur Docker + text: Configurez les intégrations avec Autodiscovery sur Docker - link: /containers/guide/container-discovery-management/ tag: Documentation text: Gestion de la découverte de conteneurs title: Configuration automatique d'Autodiscovery --- - -Lorsque l'Agent s'exécute en tant que conteneur, [Autodiscovery][49] tente de découvrir d'autres conteneurs en fonction de fichiers de configuration par défaut nommés `auto_conf.yaml`. Vous pouvez trouver ces fichiers dans les dossiers `conf.d/.d/` correspondants pour les intégrations suivantes : +Lorsque l'Agent s'exécute en tant que conteneur, [Autodiscovery][44] tente de découvrir d'autres conteneurs en se basant sur des fichiers de configuration par défaut nommés `auto_conf.yaml`. Vous pouvez trouver ces fichiers dans les dossiers `conf.d/.d/` correspondants pour les intégrations suivantes : | Intégration | Fichier de configuration automatique | | ------ | -------- | @@ -36,35 +35,34 @@ Lorsque l'Agent s'exécute en tant que conteneur, [Autodiscovery][49] tente de d | [Couchbase][11] | [auto_conf.yaml][12] | | [Elastic][13] | [auto_conf.yaml][14] | | [Etcd][15] | [auto_conf.yaml][16] | -| [External DNS][17] | [auto_conf.yaml][18] | -| [Harbor][19] | [auto_conf.yaml][20] | -| [Istio][21] | [auto_conf.yaml][22] | -| [Kube APIserver][23] | [auto_conf.yaml][24] | -| [Kube Controller Manager][25] | [auto_conf.yaml][26] | -| [KubeDNS][23] | [auto_conf.yaml][27] | -| [Kube Scheduler][28] | [auto_conf.yaml][29] | -| [Kubernetes State][23] | [auto_conf.yaml][30] | -| [Kyoto Tycoon][31] | [auto_conf.yaml][32] | -| [Memcache][33] | [auto_conf.yaml][34] | -| [Presto][35] | [auto_conf.yaml][36] | -| [RabbitMQ][47] | [auto_conf.yaml][48] | -| [Redis][37] | [auto_conf.yaml][38] | -| [Riak][39] | [auto_conf.yaml][40] | -| [Tomcat][41] | [auto_conf.yaml][42] | +| [DNS externe][17] | [auto_conf.yaml][18] | +| [Istio][19] | [auto_conf.yaml][20] | +| [Serveur d'API Kube][21] | [auto_conf.yaml][22] | +| [Kube Controller Manager][23] | [auto_conf.yaml][24] | +| [KubeDNS][21] | [auto_conf.yaml][25] | +| [Planificateur Kube][26] | [auto_conf.yaml][27] | +| [État de Kubernetes][21] | [auto_conf.yaml][28] | +| [Kyototycoon][29] | [auto_conf.yaml][30] | +| [MemCached][31] | [auto_conf.yaml][32] | +| [Presto][33] | [auto_conf.yaml][34] | +| [RabbitMQ][42] | [auto_conf.yaml][43] | +| [Redis][35] | [auto_conf.yaml][36] | +| [Riak][37] | [auto_conf.yaml][38] | +| [Tomcat][39] | [auto_conf.yaml][40] | -Les fichiers de configuration `auto_conf.yaml` rassemblent tous les paramètres requis pour configurer une intégration spécifique. Les [template variables Autodiscovery][43] correspondantes qui sont fournies prennent en compte l'environnement conteneurisé. +Les `auto_conf.yaml` fichiers de configuration couvrent tous les paramètres requis pour configurer une intégration spécifique, avec leurs [variables de modèles Autodiscovery][41] correspondantes en place pour prendre en compte l'environnement conteneurisé. -## Remplacer la configuration automatique -Chaque fichier `auto_conf.yaml` fournit une configuration par défaut. Pour la remplacer, vous pouvez ajouter une configuration personnalisée dans les [annotations Kubernetes][50] ou les [étiquettes Docker][51]. +## Remplacer l'auto-configuration {#override-auto-configuration} +Chaque `auto_conf.yaml` fichier fournit une configuration par défaut. Pour remplacer cela sur Kubernetes, vous pouvez ajouter une configuration personnalisée dans les [annotations Kubernetes][45] ou utiliser la [`DatadogInstrumentation` ressource personnalisée][47]. Pour Docker, utilisez les [étiquettes Docker][46]. -Les annotations Kubernetes et les étiquettes Docker ont la priorité sur les fichiers `auto_conf.yaml`, mais les fichiers `auto_conf.yaml` ont la priorité sur la configuration Autodiscovery définie dans le Datadog Operator et les charts Helm. Pour utiliser le Datadog Operator ou Helm afin de configurer Autodiscovery pour une intégration du tableau de cette page, vous devez [désactiver la configuration automatique](#desactiver-la-configuration-automatique). +Les annotations Kubernetes prévalent sur les ressources `DatadogInstrumentation` et les fichiers `auto_conf.yaml`. Les ressources `DatadogInstrumentation` prévalent sur les fichiers `auto_conf.yaml`, et les fichiers `auto_conf.yaml` prévalent sur la configuration Autodiscovery définie dans Datadog Operator et les Helm charts. Pour utiliser Datadog Operator ou Helm afin de configurer Autodiscovery pour une intégration dans le tableau de cette page, vous devez [désactiver l'auto-configuration](#disable-auto-configuration). -## Désactiver la configuration automatique +## Désactiver l'auto-configuration {#disable-auto-configuration} -Les exemples suivants désactivent la configuration automatique pour les intégrations Redis et Istio. +Les exemples suivants désactivent l'auto-configuration pour les intégrations Redis et Istio. {{< tabs >}} -{{% tab "Operator Datadog" %}} +{{% tab "Datadog Operator" %}} Dans votre `datadog-agent.yaml`, utilisez `override.nodeAgent.containers.agent.env` pour définir la variable d'environnement `DD_IGNORE_AUTOCONF` dans le conteneur `agent`. @@ -103,7 +101,7 @@ datadog: ``` {{% /tab %}} {{% tab "Agent conteneurisé" %}} -Pour désactiver la configuration automatique d'intégration(s) avec votre Agent conteneurisé (DaemonSet manuel, Docker, ECS), ajoutez la variable d'environnement `DD_IGNORE_AUTOCONF` : +Pour désactiver l'intégration de la configuration automatique avec votre agent conteneurisé (DaemonSet manuel, Docker, ECS), ajoutez la variable d'environnement `DD_IGNORE_AUTOCONF` : ```yaml DD_IGNORE_AUTOCONF="redisdb istio" @@ -111,7 +109,7 @@ DD_IGNORE_AUTOCONF="redisdb istio" {{% /tab %}} {{< /tabs >}} -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} @@ -133,36 +131,32 @@ DD_IGNORE_AUTOCONF="redisdb istio" [16]: https://github.com/DataDog/integrations-core/blob/master/etcd/datadog_checks/etcd/data/auto_conf.yaml [17]: /fr/integrations/external_dns [18]: https://github.com/DataDog/integrations-core/blob/master/external_dns/datadog_checks/external_dns/data/auto_conf.yaml -[19]: /fr/integrations/harbor/ -[20]: https://github.com/DataDog/integrations-core/blob/master/harbor/datadog_checks/harbor/data/auto_conf.yaml -[21]: /fr/integrations/istio -[22]: https://github.com/DataDog/integrations-core/blob/master/istio/datadog_checks/istio/data/auto_conf.yaml -[23]: /fr/agent/kubernetes/ -[24]: https://github.com/DataDog/integrations-core/blob/master/kube_apiserver_metrics/datadog_checks/kube_apiserver_metrics/data/auto_conf.yaml -[25]: /fr/integrations/kube_controller_manager -[26]: https://github.com/DataDog/integrations-core/blob/master/kube_controller_manager/datadog_checks/kube_controller_manager/data/auto_conf.yaml -[27]: https://github.com/DataDog/integrations-core/blob/master/kube_dns/datadog_checks/kube_dns/data/auto_conf.yaml -[28]: /fr/integrations/kube_scheduler -[29]: https://github.com/DataDog/integrations-core/blob/master/kube_scheduler/datadog_checks/kube_scheduler/data/auto_conf.yaml -[30]: https://github.com/DataDog/integrations-core/blob/master/kubernetes_state/datadog_checks/kubernetes_state/data/auto_conf.yaml -[31]: /fr/integrations/kyototycoon/ -[32]: https://github.com/DataDog/integrations-core/blob/master/kyototycoon/datadog_checks/kyototycoon/data/auto_conf.yaml -[33]: /fr/integrations/mcache/ -[34]: https://github.com/DataDog/integrations-core/blob/master/mcache/datadog_checks/mcache/data/auto_conf.yaml -[35]: /fr/integrations/presto/ -[36]: https://github.com/DataDog/integrations-core/blob/master/presto/datadog_checks/presto/data/auto_conf.yaml -[37]: /fr/integrations/redisdb/ -[38]: https://github.com/DataDog/integrations-core/blob/master/redisdb/datadog_checks/redisdb/data/auto_conf.yaml -[39]: /fr/integrations/riak/ -[40]: https://github.com/DataDog/integrations-core/blob/master/riak/datadog_checks/riak/data/auto_conf.yaml -[41]: /fr/integrations/tomcat/ -[42]: https://github.com/DataDog/integrations-core/blob/master/tomcat/datadog_checks/tomcat/data/auto_conf.yaml -[43]: /fr/agent/guide/template_variables/ -[44]: /fr/agent/kubernetes/integrations/?tab=keyvaluestore#configuration -[45]: /fr/agent/kubernetes/integrations/?tab=kubernetes#configuration -[46]: /fr/agent/docker/integrations/#configuration -[47]: /fr/integrations/rabbitmq/ -[48]: https://github.com/DataDog/integrations-core/blob/master/rabbitmq/datadog_checks/rabbitmq/data/auto_conf.yaml -[49]: /fr/getting_started/containers/autodiscovery -[50]: /fr/containers/kubernetes/integrations/?tab=annotations#configuration -[51]: /fr/containers/docker/integrations/ \ No newline at end of file +[19]: /fr/integrations/istio +[20]: https://github.com/DataDog/integrations-core/blob/master/istio/datadog_checks/istio/data/auto_conf.yaml +[21]: /fr/agent/kubernetes/ +[22]: https://github.com/DataDog/integrations-core/blob/master/kube_apiserver_metrics/datadog_checks/kube_apiserver_metrics/data/auto_conf.yaml +[23]: /fr/integrations/kube_controller_manager +[24]: https://github.com/DataDog/integrations-core/blob/master/kube_controller_manager/datadog_checks/kube_controller_manager/data/auto_conf.yaml +[25]: https://github.com/DataDog/integrations-core/blob/master/kube_dns/datadog_checks/kube_dns/data/auto_conf.yaml +[26]: /fr/integrations/kube_scheduler +[27]: https://github.com/DataDog/integrations-core/blob/master/kube_scheduler/datadog_checks/kube_scheduler/data/auto_conf.yaml +[28]: https://github.com/DataDog/integrations-core/blob/master/kubernetes_state/datadog_checks/kubernetes_state/data/auto_conf.yaml +[29]: /fr/integrations/kyototycoon/ +[30]: https://github.com/DataDog/integrations-core/blob/master/kyototycoon/datadog_checks/kyototycoon/data/auto_conf.yaml +[31]: /fr/integrations/mcache/ +[32]: https://github.com/DataDog/integrations-core/blob/master/mcache/datadog_checks/mcache/data/auto_conf.yaml +[33]: /fr/integrations/presto/ +[34]: https://github.com/DataDog/integrations-core/blob/master/presto/datadog_checks/presto/data/auto_conf.yaml +[35]: /fr/integrations/redisdb/ +[36]: https://github.com/DataDog/integrations-core/blob/master/redisdb/datadog_checks/redisdb/data/auto_conf.yaml +[37]: /fr/integrations/riak/ +[38]: https://github.com/DataDog/integrations-core/blob/master/riak/datadog_checks/riak/data/auto_conf.yaml +[39]: /fr/integrations/tomcat/ +[40]: https://github.com/DataDog/integrations-core/blob/master/tomcat/datadog_checks/tomcat/data/auto_conf.yaml +[41]: /fr/agent/guide/template_variables/ +[42]: /fr/integrations/rabbitmq/ +[43]: https://github.com/DataDog/integrations-core/blob/master/rabbitmq/datadog_checks/rabbitmq/data/auto_conf.yaml +[44]: /fr/getting_started/containers/autodiscovery +[45]: /fr/containers/kubernetes/integrations/?tab=annotations#configuration +[46]: /fr/containers/docker/integrations/ +[47]: /fr/containers/guide/configure-autodiscovery-with-the-datadoginstrumentation-crd/ \ No newline at end of file diff --git a/hugo/content/fr/containers/guide/aws-batch-ecs-fargate.md b/hugo/content/fr/containers/guide/aws-batch-ecs-fargate.md index 711d4308bb2..0398e90dd0d 100644 --- a/hugo/content/fr/containers/guide/aws-batch-ecs-fargate.md +++ b/hugo/content/fr/containers/guide/aws-batch-ecs-fargate.md @@ -2,53 +2,55 @@ aliases: - /fr/integrations/faq/aws-batch-ecs-fargate - /fr/agent/guide/aws-batch-ecs-fargate-datadog-agent -description: Déployer l'Agent Datadog aux côtés des tâches AWS Batch s'exécutant sur - ECS Fargate pour une surveillance complète +description: Déployez le Datadog Agent avec les jobs AWS Batch s'exécutant sur ECS + Fargate pour une surveillance complète. further_reading: - link: integrations/ecs_fargate/?tab=webui#aws-batch-on-ecs-fargate tag: Documentation text: Amazon ECS sur AWS Fargate avec AWS Batch -title: AWS Batch avec ECS Fargate et l'Agent Datadog +- link: https://www.datadoghq.com/architecture/using-datadog-with-ecs-fargate/ + tag: Architecture Center + text: Utilisation de Datadog avec ECS Fargate +title: AWS Batch avec ECS Fargate et le Datadog Agent --- +Vous pouvez exécuter le Datadog Agent avec vos conteneurs de job AWS Batch en ajoutant le conteneur à votre définition de job. -Vous pouvez exécuter l'Agent Datadog aux côtés de vos conteneurs de tâches AWS Batch en ajoutant le conteneur à votre définition de tâche. - -## Prérequis +## Prérequis {#prerequisites} * Environnement de calcul AWS Batch -* File d'attente de tâches AWS Batch associée à un environnement de calcul +* File d'attente de jobs AWS Batch associée à un environnement de calcul -## Créer la définition de tâche +## Créez la définition de job {#create-the-job-definition} {{< tabs >}} {{% tab "Interface Web AWS" %}} -1. Connectez-vous à votre [console Web AWS][1] et accédez à la section AWS Batch. -2. Cliquez sur **Job Definitions** dans le menu de gauche, puis cliquez sur le bouton **Create** ou choisissez une définition de tâche AWS Batch existante. -3. Pour les nouvelles définitions de tâche : - 1. Sélectionnez **Fargate** comme type d'orchestration. - 2. Désélectionnez l'option **Use legacy containerProperties structure**. - 3. Saisissez un **Job Definition Name**, tel que `my-app-and-datadog`. - 4. Sélectionnez un rôle IAM d'exécution. Consultez la section [Créer ou modifier votre stratégie IAM](#creer-ou-modifier-votre-strategie-iam) ci-dessous pour connaître les exigences d'autorisation. - 5. Activez **Assign public IP** pour autoriser l'accès réseau sortant, puis cliquez sur le bouton **Next**. - 6. Configurez le conteneur de l'Agent Datadog. - 1. Pour le champ **Container name**, saisissez `datadog-agent`. - 2. Pour **Image**, saisissez `public.ecr.aws/datadog/agent:latest`. - 3. Configurez les exigences de ressources **CPU** et **Memory** en fonction de vos besoins. - 4. Pour **Env Variables**, ajoutez la **Key** `DD_API_KEY` et saisissez votre [clé d'API Datadog][2] comme valeur. - 5. Ajoutez une autre variable d'environnement avec la **clé** `ECS_FARGATE` et la valeur `true`. Cliquez sur **Add** pour ajouter le conteneur. - 6. Ajoutez une autre variable d'environnement en utilisant la **clé** `DD_SITE` et la valeur {{< region-param key="dd_site" code="true" >}}. Le site `datadoghq.com` est utilisé par défaut si vous ne le définissez pas. - 7. Ajoutez vos autres conteneurs d'application à la définition de tâche. - 8. AWS Batch prend en charge [Fluent Bit et Firelens][3]. Pour activer la collecte de logs pour vos conteneurs d'application avec Datadog : - 1. Créez un conteneur de routeur de log distinct dans la définition de tâche. +1. Connectez-vous à votre [Console Web AWS][1] et accédez à la section AWS Batch. +2. Cliquez sur {{< ui >}}Job Definitions{{< /ui >}} dans le menu de gauche, puis cliquez sur le bouton {{< ui >}}Create{{< /ui >}} ou choisissez une définition de job AWS Batch existante. +3. Pour les nouvelles définitions de job : + 1. Sélectionnez {{< ui >}}Fargate{{< /ui >}} comme type d'orchestration. + 2. Désélectionnez l'option {{< ui >}}Use legacy containerProperties structure{{< /ui >}}. + 3. Saisissez un {{< ui >}}Job Definition Name{{< /ui >}}, tel que `my-app-and-datadog`. + 4. Sélectionnez un rôle IAM d'exécution. Consultez les exigences en matière d'autorisations dans la section [Créer ou modifier votre politique IAM](#create-or-modify-your-iam-policy) ci-dessous. + 5. Activez {{< ui >}}Assign public IP{{< /ui >}} pour autoriser l'accès réseau sortant, puis cliquez sur le bouton {{< ui >}}Next{{< /ui >}}. + 6. Configurez le conteneur du Datadog Agent. + 1. Pour {{< ui >}}Container name{{< /ui >}} saisissez `datadog-agent`. + 2. Pour {{< ui >}}Image{{< /ui >}} saisissez `public.ecr.aws/datadog/agent:latest`. + 3. Configurez les besoins en ressources pour {{< ui >}}CPU{{< /ui >}} et {{< ui >}}Memory{{< /ui >}} en fonction de vos besoins. + 4. Pour {{< ui >}}Env Variables{{< /ui >}}, ajoutez {{< ui >}}Key{{< /ui >}} `DD_API_KEY` et saisissez votre [clé d'API Datadog][2] comme valeur. + 5. Ajoutez une autre variable d'environnement en utilisant {{< ui >}}Key{{< /ui >}} `ECS_FARGATE` et la valeur `true`. Cliquez sur {{< ui >}}Add{{< /ui >}} pour ajouter le conteneur. + 6. Ajoutez une autre variable d'environnement en utilisant {{< ui >}}Key{{< /ui >}} `DD_SITE` et la valeur {{< region-param key="dd_site" code="true" >}}. La valeur par défaut est `datadoghq.com` si vous ne la définissez pas. + 7. Ajoutez vos autres conteneurs d'application à la définition de job. + 8. AWS Batch prend en charge [Fluent Bit et Firelens][3]. Pour activer la collecte de logs pour vos conteneurs d'application avec Datadog : + 1. Créez un conteneur de routage de logs distinct dans la définition de job. 2. Configurez l'image `amazon/aws-for-fluent-bit:stable"` pour le conteneur. - 3. Dans la section Firelens Configuration : - - Configurez le **Type** sur `fluentbit`. - - Configurez les **Options** pour inclure `enable-ecs-log-metadata` défini sur `true` pour **Name** et **Value** respectivement - 4. Pour vos conteneurs d'application, dans la section Log Configuration : - - Configurez le **Log Driver** sur `awsfirelens` - - Configurez les **Options** pour inclure les **Name** et **Value** suivants de manière similaire à l'étape 2 de la section [ECS Fargate Fluent Bit et Firelens][4] - 10. Cliquez sur **Create job definition** pour créer la définition de tâche. + 3. Dans la section Firelens Configuration : + - Configurez {{< ui >}}Type{{< /ui >}} sur `fluentbit`. + - Configurez {{< ui >}}Options{{< /ui >}} pour inclure `enable-ecs-log-metadata` défini sur `true` pour {{< ui >}}Name{{< /ui >}} et {{< ui >}}Value{{< /ui >}} respectivement + 4. Pour vos conteneurs d'application, dans la section Log Configuration : + - Configurez {{< ui >}}Log Driver{{< /ui >}} sur `awsfirelens` + - Configurez {{< ui >}}Options{{< /ui >}} pour inclure les {{< ui >}}Name{{< /ui >}} et {{< ui >}}Value{{< /ui >}} suivants, comme à l'étape 2 de la [section ECS Fargate Fluent Bit et Firelens][4] + 10. Cliquez sur {{< ui >}}Create job definition{{< /ui >}} pour créer la définition de job. [1]: https://app.datadoghq.com/organization-settings/api-keys [2]: https://app.datadoghq.com/organization-settings/api-keys @@ -58,15 +60,15 @@ Vous pouvez exécuter l'Agent Datadog aux côtés de vos conteneurs de tâches A {{% /tab %}} {{% tab "AWS CLI" %}} -1. Téléchargez [datadog-agent-aws-batch-ecs-fargate.json][1]. +1. Téléchargez [datadog-agent-aws-batch-ecs-fargate.json][1]. - **Remarque** : si vous utilisez Internet Explorer, cela peut être téléchargé sous forme de fichier gzip, qui contient le fichier JSON mentionné ci-dessous. -2. Mettez à jour le JSON avec un `JOB_DEFINITION_NAME`, votre [clé d'API Datadog][2] et le `DD_SITE` approprié ({{< region-param key="dd_site" code="true" >}}). + **Remarque** : Si vous utilisez Internet Explorer, ce fichier peut être téléchargé en tant que fichier gzip, qui contient le fichier JSON mentionné ci-dessous. +2. Mettez à jour le JSON avec un `JOB_DEFINITION_NAME`, votre [clé d'API Datadog][2] et le `DD_SITE` approprié ("{{< region-param key="dd_site" code="true" >}}). - **Remarque** : la variable d'environnement `ECS_FARGATE` est déjà définie sur `"true"`. -3. Ajoutez vos autres conteneurs d'application à la définition de tâche. -4. AWS Batch prend en charge [Fluent Bit et Firelens][3]. Pour activer la collecte de logs pour vos conteneurs d'application avec Datadog : - - Dans le fichier JSON, ajoutez un conteneur `log_router` supplémentaire avec ce qui suit dans la section `containers` : + **Remarque** : La variable d'environnement `ECS_FARGATE` est déjà définie sur `"true"`. +3. Ajoutez vos autres conteneurs d'application à la définition de job. +4. AWS Batch prend en charge [Fluent Bit et Firelens][3]. Pour activer la collecte de logs pour vos conteneurs d'application avec Datadog : + - Dans le fichier JSON, ajoutez un conteneur `log_router` supplémentaire avec ce qui suit dans la section `containers` : ```json { "name": "log_router", @@ -90,32 +92,32 @@ Vous pouvez exécuter l'Agent Datadog aux côtés de vos conteneurs de tâches A ] } ``` - - Dans vos conteneurs d'application, ajoutez les options `logConfiguration` pertinentes de manière similaire à l'étape 2 de la section [ECS Fargate Fluent Bit et Firelens][4] -5. Exécutez la commande suivante pour enregistrer la définition de tâche : + - Dans vos conteneurs d'application, ajoutez les options `logConfiguration` pertinentes de manière similaire à l'étape 2 de la [section ECS Fargate Fluent Bit et Firelens][4] +5. Exécutez la commande suivante pour enregistrer la définition de job : ```bash aws batch register-job-definition --cli-input-json file:///datadog-agent-aws-batch-ecs-fargate.json ``` -[1]: https://docs.datadoghq.com/resources/json/datadog-agent-aws-batch-ecs-fargate.json +[1]: https://docs.datadoghq.com/fr/resources/json/datadog-agent-aws-batch-ecs-fargate.json [2]: https://app.datadoghq.com/organization-settings/api-keys [3]: https://aws.amazon.com/about-aws/whats-new/2025/04/aws-batch-amazon-elastic-container-service-exec-firelens-log-router/ [4]: https://docs.datadoghq.com/fr/integrations/ecs_fargate/?tab=webui#fluent-bit-and-firelens {{% /tab %}} {{< /tabs >}} -## Soumettre la tâche AWS Batch +## Soumettez le job AWS Batch {#submit-the-aws-batch-job} {{< tabs >}} {{% tab "Interface Web AWS" %}} -1. Connectez-vous à votre [console Web AWS][1] et accédez à la section AWS Batch. Si nécessaire, créez un [environnement de calcul][2] et/ou une [file d'attente de tâches][3] associée à un environnement de calcul. -2. Dans l'onglet **Jobs**, cliquez sur le bouton **Submit new job**. -3. Saisissez un **Job name**. -4. Pour **Job Definition**, sélectionnez la tâche créée dans les étapes précédentes. -5. Choisissez la file d'attente de tâches sur laquelle exécuter l'Agent Datadog. -6. Les **Container overrides** sont facultatifs selon votre préférence. -7. Cliquez sur le bouton **Next**, puis cliquez sur le bouton **Create job**. +1. Connectez-vous à votre [Console Web AWS][1] et accédez à la section AWS Batch. Si nécessaire, créez un [environnement de calcul][2] et/ou une [file d'attente de jobs][3] associée à un environnement de calcul. +2. Sur l'onglet {{< ui >}}Jobs{{< /ui >}}, cliquez sur le bouton {{< ui >}}Submit new job{{< /ui >}}. +3. Saisissez un {{< ui >}}Job name{{< /ui >}}. +4. Pour {{< ui >}}Job Definition{{< /ui >}}, sélectionnez le job créé lors des étapes précédentes. +5. Choisissez la file d'attente de jobs sur laquelle exécuter le Datadog Agent. +6. {{< ui >}}Container overrides{{< /ui >}} sont facultatifs selon vos préférences. +7. Cliquez sur le bouton {{< ui >}}Next{{< /ui >}}, puis cliquez sur le bouton {{< ui >}}Create job{{< /ui >}}. [1]: https://aws.amazon.com/console [2]: https://docs.aws.amazon.com/batch/latest/userguide/create-compute-environment.html @@ -124,7 +126,7 @@ Vous pouvez exécuter l'Agent Datadog aux côtés de vos conteneurs de tâches A {{% /tab %}} {{% tab "AWS CLI" %}} -1. Exécutez la commande suivante pour soumettre une tâche pour votre définition de tâche : +1. Exécutez la commande suivante pour soumettre un job pour votre définition de job : ```bash aws batch submit-job --job-name \ @@ -135,6 +137,6 @@ aws batch submit-job --job-name \ {{% /tab %}} {{< /tabs >}} -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/fr/continuous_integration/explorer/facets.md b/hugo/content/fr/continuous_integration/explorer/facets.md index a9334d37d81..bcc586bab72 100644 --- a/hugo/content/fr/continuous_integration/explorer/facets.md +++ b/hugo/content/fr/continuous_integration/explorer/facets.md @@ -1,154 +1,153 @@ --- -description: Découvrez comment utiliser les facettes par défaut pour rechercher vos - exécutions de pipeline dans le CI Visibility Explorer. +description: Découvrez les facettes par défaut que vous pouvez utiliser pour rechercher + vos exécutions de pipeline dans CI Visibility Explorer. further_reading: - link: continuous_integration/search/ tag: Documentation - text: Découvrir comment rechercher vos pipelines + text: Découvrez comment effectuer une recherche sur vos pipelines. - link: continuous_integration/explorer/ tag: Documentation - text: En savoir plus sur le CI Visibility Explorer -title: Facettes pour les exécutions de pipeline + text: Découvrez CI Visibility Explorer. +title: Facettes d'exécution de pipeline --- +## Présentation {#overview} -## Présentation +Les facettes sont des tags et des attributs définis par l'utilisateur provenant de vos pipelines. Elles sont utiles pour l'analyse de données [qualitatives](#qualitative-facets) et [quantitatives](#quantitative-measures). Les facettes vous permettent de manipuler vos pipelines dans vos [monitors de pipeline CI][1], ainsi que dans les requêtes de recherche qui apparaissent sur les [tableaux de bord][2] et dans les [notebooks][3]. -Les facettes correspondent à des tags définis par l'utilisateur et à des attributs issus de vos pipelines. Elles servent à effectuer des analyses de données à la fois [qualitatives](#facettes-qualitatives) et [quantitatives](#mesures-quantitatives). Elles vous permettent de manipuler vos pipelines dans vos [monitors de pipeline de CI][1] ainsi que dans les requêtes de recherche qui figurent dans les [dashboards][2] et les [notebooks][3]. +[La création de facettes](#creating-facets) n'est **pas requise** pour [rechercher des exécutions de pipeline][5]. Les fonctionnalités de saisie semi-automatique utilisent les facettes existantes, mais toute entrée correspondant aux exécutions de pipeline entrantes s'applique également. -Il n'est **pas nécessaire** de [créer des facettes] (#creer-des-facettes) pour [rechercher des exécutions de pipeline][5]. La fonctionnalité de remplissage automatique utilise les facettes existantes, mais toute entrée correspondant à des exécutions de pipeline entrantes s'applique également. +## Facettes courantes {#common-facets} -## Facettes communes +Accédez à [**Software Delivery** > **CI Visibility** > **Executions**][7] pour accéder à la liste des facettes à gauche de la liste des exécutions de pipeline. -Naviguez jusqu'à [**Software Delivery** > **CI Visibility** > **Executions**][7] pour accéder à la liste des facettes située à gauche de la liste des exécutions de pipeline. +{{< img src="/continuous_integration/facets-pipelines.png" text="Facets list on the Pipeline Executions page of the CI Visibility Explorer" style="width:100%" >}} -{{< img src="/continuous_integration/facets-pipelines.png" text="Liste des facettes sur la page Pipeline Executions du CI Visibility Explorer" style="width:100%" >}} - -Le [CI Visibility Explorer][4] inclut les facettes par défaut suivantes : +[CI Vsibility Explorer][4] inclut les facettes prêtes à l'emploi suivantes : | Facette | Description | |---|---| -| CI Provider | Le nom du fournisseur de CI (GitHub, GitLab, etc.). | -| Pipeline Name | Le nom du pipeline de CI. | -| Node Name | Le nom du nœud de CI qui a exécuté le pipeline, le stage ou le job. | -| Node Labels | Les étiquettes associées au nœud de CI qui a exécuté le pipeline, le stage ou le job. | -| Pipeline URL | L'URL du fournisseur pour une exécution de pipeline. | -| Pipeline ID | L'ID du pipeline. | -| Pipeline Number | Le numéro d'exécution d'un pipeline de CI, qui est défini par le fournisseur de CI. Cette valeur augmente en cas de nouvelle tentative partielle d'exécution d'un pipeline. | -| Job URL | L'URL du fournisseur pour une exécution de job. | -| Stage Name | Le nom du stage de CI. | -| Job Name | Le nom du job de CI. | -| Kubernetes Namespace | L'espace de nommage dans lequel le pod Kubernetes s'exécute. | -| Kubernetes pod Nom | Le nom du pod Kubernetes. | -| Image Tag | Le tag d'image du conteneur Kubernetes. | -| Container Name | Le tag de nom du conteneur Kubernetes. | -| Image Name | Le tag de nom de l'image du conteneur Kubernetes. | -| Container ID | L'ID du conteneur Kubernetes. | -| Kubernetes Container Name | Le nom du conteneur Kubernetes. | -| Kubernetes Deployment | Le déploiement Kubernetes auquel le pod appartient. | -| Kubernetes Stateful Set | Le StatefulSet Kubernet auquel le pod appartient. | -| Repository URL | L'URL du référentiel Git. | -| Repository ID | L'ID unique qui identifie un référentiel Git. | -| Commit SHA | Le SHA du commit Git. | -| Branch | La branche Git. | -| Tag | Le tag Git. | -| Author Email | L'adresse e-mail de l'auteur Git. | -| Committer Email | L'adresse e-mail de l'auteur du commit Git. | -| Committer Date | La date de l'auteur du commit Git. | -| Author Date | La date de l'auteur Git. | -| Env | L'environnement dans lequel le pipeline de CI s'exécute. | -| Resource | La ressource utilisée par le pipeline de CI. | -| Operation Name | L'opération réalisée au sein du pipeline de CI. | -| Error Type | Le type d'erreur rencontrée lors de l'exécution du CI. | -| Type | Le type de l'exécution ou de l'entité de CI. | -| Complete Trace | La trace complète de l'exécution de pipeline de CI. | -| Duration | La durée de l'exécution, en secondes. | -| Version | La version du pipeline de CI ou de l'outil utilisé. | -| Is Default Branch | Indique si l'exécution s'applique ou non à la branche par défaut du référentiel Git. | - -Vous pouvez utiliser des facettes dans le CI Visibility Explorer pour accomplir ce qui suit : - -- [Rechercher et filtrer des exécutions de pipeline][5] -- Analyser des pipelines -- Commencer à dépanner vos problèmes après l'exécution de vos pipelines - - -### Facettes qualitatives +| Fournisseur CI | Nom du fournisseur CI (GitHub, GitLab, et plus). | +| Nom du pipeline | Nom du pipeline CI. | +| Nom du nœud | Nom du nœud CI qui a exécuté le pipeline, l'étape ou le job. | +| Libellés du nœud | Libellés associés au nœud CI qui a exécuté le pipeline, l'étape ou le job. | +| URL du pipeline | URL du fournisseur pour une exécution de pipeline. | +| ID du pipeline | ID du pipeline. | +| Numéro du pipeline | Numéro d'exécution d'un pipeline CI, fourni par le fournisseur CI. Ceci augmente lors d'une nouvelle tentative partielle d'un pipeline. | +| URL du job | URL du fournisseur pour une exécution de job. | +| Nom de l'étape | Nom de l'étape CI. | +| Nom du job | Nom du job CI. | +| Espace de noms Kubernetes | L'espace de noms dans lequel le pod Kubernetes est en cours d'exécution. | +| Nom du pod Kubernetes | Nom du pod Kubernetes. | +| Tag d'image | Tag d'image de conteneur Kubernetes. | +| Nom du conteneur | Tag de nom de conteneur Kubernetes. | +| Nom de l'image | Tag de nom d'image de conteneur Kubernetes. | +| ID de conteneur | ID de conteneur Kubernetes. | +| Nom du conteneur Kubernetes | Nom du conteneur Kubernetes. | +| Déploiement Kubernetes | Le déploiement Kubernetes auquel appartient un pod. | +| StatefulSet Kubernetes | Le StatefulSet Kubernetes auquel appartient un pod. | +| URL du dépôt | URL du dépôt Git. | +| ID du dépôt | ID qui identifie de manière unique un dépôt Git. | +| SHA de commit | SHA de commit Git. | +| Branche | Branche Git. | +| Tag | Tag Git. | +| E-mail de l'auteur | E-mail de l'auteur Git. | +| E-mail du committer | E-mail du committer Git. | +| Date du committer | Date du committer Git. | +| Date de l'auteur | Date de l'auteur Git. | +| Env | L'environnement dans lequel le pipeline CI est en cours d'exécution. | +| Ressource | La ressource utilisée par le pipeline CI. | +| Nom de l'opération | L'opération effectuée au sein du pipeline CI. | +| Type d'erreur | Type d'erreur rencontrée lors de l'exécution du CI. | +| Type | Type de l'exécution ou de l'entité CI. | +| Trace complète | Trace complète de l'exécution du pipeline CI. | +| Durée | La durée de l'exécution en secondes. | +| Version | Version du pipeline CI ou de l'outil utilisé. | +| Est la branche par défaut | Indique si l'exécution a été effectuée sur la branche par défaut du dépôt Git. | + +Vous pouvez utiliser des facettes dans CI Visibility Explorer pour : + +- [Rechercher et filtrer les exécutions de pipeline][5] +- Effectuer des analyses de pipeline +- Commencer le dépannage une fois vos pipelines terminés + + +### Facettes qualitatives {#qualitative-facets} Les facettes qualitatives vous permettent d'accomplir les tâches suivantes : -- **Obtenir des insights relatives** sur les valeurs -- **Compter des valeurs uniques** -- **Filtrer** régulièrement vos exécutions de pipeline selon des valeurs données ; vous pouvez par exemple créer une facette sur le tag environment pour réduire vos recherches aux environnements de production, de développement et intermédiaires.
+- **Obtenir des informations relatives** pour les valeurs. +- **Compter les valeurs uniques**. +- Filtrer**fréquemment** vos exécutions de pipeline par rapport à des valeurs particulières. Par exemple, créez une facette sur un tag d'environnement pour limiter le dépannage aux environnements de développement, de staging ou de production.
-**Remarque :** bien que vous n'ayez pas besoin de créer des facettes pour appliquer un filtre sur des tags, vous pouvez accélérer la résolution des problèmes en définissant des facettes sur les tags que vous utilisez régulièrement. +**Remarque :** Bien que les facettes ne soient pas nécessaires pour filtrer les tags, définir des facettes pour les tags que vous utilisez souvent lors de vos investigations peut vous aider à réduire votre temps de résolution. -### Mesures quantitatives +### Mesures quantitatives {#quantitative-measures} -Utilisez des mesures quantitatives pour accomplir ce qui suit : +Utilisez des mesures quantitatives lorsque vous devez : -- **Agréger** des valeurs provenant de plusieurs exécutions de pipeline -- **Appliquer un filtre** à vos exécutions de pipeline basé sur des plages de valeurs -- **Trier** vos exécutions de pipeline en fonction de ces valeurs +- **Agréger** des valeurs provenant de plusieurs exécutions de pipeline. +- **Filtrer par plage** vos exécutions de pipeline. +- **Trier** vos exécutions de pipeline par rapport à cette valeur. -#### Types +#### Types {#types} -Les mesures disposent d'un nombre entier (long) ou d'une double valeur. Ces deux types de valeurs proposent des fonctionnalités équivalentes. +Les mesures ont soit une valeur entière longue, soit une valeur double pour des capacités équivalentes. -#### Unités +#### Unités {#units} -Les mesures ont une unité (de **temps** en secondes ou de **taille** en octets) afin de gérer les ordres de grandeur au moment de la requête et de l'affichage. L'unité est une propriété de la mesure, et non du champ. +Les mesures prennent en charge des unités (**temps** en secondes ou **taille** en octets) pour la gestion des ordres de grandeur au moment de la requête et de l'affichage. L'unité est une propriété de la mesure elle-même, et non du champ. -Prenons l'exemple d'une mesure `duration` en nanosecondes. Imaginons que les exécutions de pipeline du service `service:A` aient comme durée `duration:10000000`, soit `10 milliseconds`, et que les exécutions de pipeline du service `service:B` aient comme durée `duration:5000000`, soit `5 milliseconds`. Utilisez `duration:>2ms` pour interroger de manière cohérente les tags des exécutions de pipeline dans les deux services. Pour en savoir plus sur les requêtes de recherche, consultez la section [Syntaxe de recherche][6]. +Par exemple, considérez une `duration` mesure en nanosecondes. Supposons que les exécutions de pipeline de `service:A` aient `duration:10000000`, ce qui signifie `10 milliseconds`. Supposons que les exécutions de pipeline de `service:B` aient `duration:5000000`, ce qui signifie `5 milliseconds`. Utilisez `duration:>2ms` pour interroger systématiquement les tags d'exécution de pipeline des deux services à la fois. Pour plus d'informations sur les requêtes de recherche, consultez [Search Syntax][6]. -## Volet des facettes +## Panneau de facettes {#facet-panel} -La barre de recherche fournit un grand nombre de fonctionnalités interactives vous permettant de filtrer et regrouper vos données. Toutefois, dans de nombreuses situations, il est plus simple d'utiliser le volet des facettes pour parcourir vos données. Ouvrez une facette pour consulter une synthèse de son contenu en fonction du contexte de la requête actuellement appliquée. +La barre de recherche offre l'ensemble d'interactions le plus complet pour filtrer et regrouper vos données. Cependant, dans de nombreux cas, le panneau des facettes est un moyen simple de naviguer dans vos données. Ouvrez une facette pour voir un résumé de son contenu pour la portée de la requête actuelle. La barre de recherche et l'URL s'adaptent automatiquement à vos sélections dans le volet des facettes. -- L'interface des **facettes (qualitatives)** propose une top list des valeurs uniques et indique le nombre d'exécutions de pipeline correspondant à chacune de ces valeurs. -- L'interface des **mesures (quantitatives)* comprend un curseur vous permettant de définir une valeur maximale ainsi qu'une valeur minimale. Utilisez le curseur, ou saisissez des valeurs numériques, pour restreindre la requête de recherche. +- **Les facettes (qualitatives)** sont accompagnées d'une top list des valeurs uniques et d'un décompte des exécutions de pipeline correspondant à chacune d'elles. +- **Les mesures (quantitatives)** sont accompagnées d'un curseur indiquant les valeurs minimale et maximale. Utilisez le curseur, ou saisissez des valeurs numériques, pour limiter la requête de recherche à différentes bornes. -### Regrouper des facettes +### Regroupement des facettes {#grouping-facets} -Dans la liste des facettes, ces dernières sont regroupées selon différents thèmes pertinents. Les opérations d'attribution ou de réattribution d'une facette à un groupe affectent uniquement la liste des facettes et n'ont aucune incidence sur les fonctionnalités de recherche et d'analyse. +Les facettes sont regroupées en thèmes significatifs dans la liste des facettes. L'attribution ou la réattribution d'un groupe pour une facette n'affecte que la liste des facettes et n'a aucun impact sur la recherche ou l'analyse. -### Filtrer des facettes +### Filtrage des facettes {#filtering-facets} -Utilisez la zone de recherche du volet des facettes afin d'affiner la liste des facettes et d'accéder à celles dont vous avez besoin. La recherche de facette réduit le nombre de résultats affichés en se basant sur le nom d'affichage des facettes et sur le nom de leur champ. +Utilisez la zone de recherche des facettes sur le panneau des facettes pour limiter toute la liste des facettes et naviguer vers la facette avec laquelle vous devez interagir. La recherche de facettes utilise le nom d'affichage de la facette et le nom du champ pour limiter les résultats. -## Créer des facettes +## Création de facettes {#creating-facets} -Il n'est pas nécessaire de créer une facette sur un attribut ou un tag d'exécution de pipeline pour rechercher des exécutions de pipeline. Les facettes s'avèrent utiles lorsque vous souhaitez ajouter une description pertinente à un attribut d'exécution de pipeline spécifique, ou lorsque vous souhaitez que les valeurs de l'attribut apparaissent dans la liste des facettes. +La création d'une facette sur un attribut ou un tag d'exécution de pipeline n'est pas une étape obligatoire pour rechercher des exécutions de pipeline. Les facettes sont utiles si vous souhaitez ajouter une description significative à un attribut d'exécution de pipeline spécifique, ou si vous voulez que les valeurs d'attribut apparaissent dans la liste des facettes. -### Créer des facettes à partir du volet latéral des exécutions de pipeline +### Création de facettes à partir des panneaux latéraux des exécutions de pipeline {#creating-facets-from-the-pipeline-executions-side-panels} -Pour créer une facette, la méthode la plus simple consiste à l'ajouter depuis le volet latéral des exécutions de pipeline. Ainsi, la majorité des détails de la facette sont préremplis. +Le moyen le plus simple de créer une facette consiste à l'ajouter depuis le panneau latéral des exécutions de pipeline afin que la plupart des détails de la facette soient pré-remplis. -{{< img src="continuous_integration/create_facet.png" alt="Créer une facette à partir du volet latéral d'une exécution de pipeline de CI" style="width:100%;">}} +{{< img src="continuous_integration/create_facet.png" alt="Créer une facette à partir du panneau latéral d'exécution de pipeline CI" style="width:100%;">}} -1. Naviguez jusqu'à l'exécution de pipeline qui vous intéresse dans le [CI Visibility Explorer][4] et qui contient le champ à partir duquel vous souhaitez créer une facette. -2. Ouvrez le volet latéral des exécutions de pipeline en sélectionnant l'exécution de pipeline dans la liste. -3. Cliquez sur le champ de votre choix (dans l'onglet **Info** pour la span d'une exécution de pipeline) et créez une facette à partir des informations affichées : +1. Accédez à une exécution de pipeline d'intérêt dans [CI Visibility Explorer][4] qui contient le champ sur lequel créer une facette. +2. Ouvrez le panneau latéral des exécutions de pipeline en sélectionnant l'exécution de pipeline dans la liste. +3. Cliquez sur le champ souhaité (dans l'onglet **Info** pour l'étendue d'une exécution de pipeline) et créez une facette à partir de là: - - Si la valeur du champ correspond à un nombre, vous pouvez créer une facette ou une mesure. - - Si la valeur du champ correspond à une chaîne, vous pouvez uniquement créer une facette. + - Si le champ a une valeur numérique, vous pouvez créer soit une facette, soit une mesure. + - Si le champ a une valeur de chaîne, seule la création de facette est disponible. -### Créer des facettes à partir de la liste des facettes +### Création de facettes à partir de la liste des facettes {#creating-facets-from-the-facet-list} -Si vous ne trouvez pas d'exécution de pipeline contenant le champ souhaité, créez une facette directement à partir du volet des facettes en cliquant sur **+ Add**. +S'il n'est pas possible de trouver une exécution de pipeline possédant le champ souhaité, créez une facette directement depuis le panneau des facettes en cliquant sur {{< ui >}}\+ Add{{< /ui >}}. -{{< img src="continuous_integration/add_facet.png" alt="Ajouter une facette à partir du volet latéral des facettes" style="width:30%;">}} +{{< img src="continuous_integration/add_facet.png" alt="Ajoutez une facette depuis le panneau latéral des facettes" style="width:30%;">}} -Définissez le nom (à savoir la clé) du champ sous-jacent de votre facette. +Définissez le nom (à savoir, la clé) du champ sous-jacent de votre facette. -- Utilisez le nom de la clé du tag pour les tags d'infrastructure. -- Utilisez le chemin d'attribut pour les attributs d'exécution de pipeline, en ajoutant le préfixe `@`. +- Utilisez le nom de la clé de tag pour les tags d'infrastructure. +- Utilisez le chemin d'attribut pour les attributs d'exécution de pipeline, avec le préfixe `@`. -Grâce à la fonctionnalité de remplissage automatique, qui se base sur le contenu des exécutions de pipeline des vues actuelles, vous pouvez définir facilement un nom de champ adéquat. Toutefois, sachez que vous pouvez indiquer n'importe quelle valeur, surtout si aucune exécution de pipeline correspondante n'a été transmise à Datadog. +La saisie semi-automatique basée sur le contenu des exécutions de pipeline des vues actuelles vous aide à définir le nom de champ approprié. Mais vous pouvez utiliser pratiquement n'importe quelle valeur ici, notamment dans le cas où vous n'avez pas encore reçu d'exécutions de pipeline correspondantes dans Datadog. -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/fr/dashboards/widgets/table.md b/hugo/content/fr/dashboards/widgets/table.md index 6cfbbab60a9..d01d9f69971 100644 --- a/hugo/content/fr/dashboards/widgets/table.md +++ b/hugo/content/fr/dashboards/widgets/table.md @@ -10,60 +10,62 @@ further_reading: - link: /dashboards/querying/ tag: Documentation text: Découvrir comment créer une requête de graphique +- link: https://learn.datadoghq.com/courses/discovering-table-list-widgets + tag: Centre d'apprentissage + text: Découverte des widgets Tableau, Liste, SLO et Architecture title: Widget Tableau widget_type: query_table --- +## Présentation {#overview} -## Présentation +La visualisation sous forme de tableau affiche des colonnes de données agrégées regroupées par clé de tag. Utilisez des tableaux pour comparer des valeurs entre de nombreux groupes de données et observer les tendances, les changements et les singularités. -Les tableaux affichent au sein de leurs colonnes des données agrégées regroupées en fonction d'une clé de tag. Ils vous permettent de comparer les valeurs de différents groupes de données, ainsi que de visualiser des tendances, changements et singularités. +{{< img src="/dashboards/widgets/table/table_conditional_formatting.png" alt="Widget de tableau avec formatage conditionnel" style="width:100%;">}} -{{< img src="/dashboards/widgets/table/table_conditional_formatting.png" alt="Widget Tableau avec une mise en forme conditionnelle" style="width:100%;">}} +## Configuration {#setup} -## Configuration +### Configuration {#configuration} -### Configuration +1. Choisissez les données à représenter graphiquement : + * Métrique : consultez la [documentation principale sur les graphiques][1] pour configurer une requête de métrique. + * Sources de données non métriques : consultez la [documentation sur la recherche de logs][2] pour configurer une requête d'événement. -1. Choisissez les données à représenter : - * Métrique : consultez la [documentation principale sur les graphiques][1] pour configurer une requête de métrique. - * Sources de données sans métriques : consultez la section [Syntaxe de recherche de logs][2] pour configurer une requête d'événement. +2. Ajoutez des colonnes supplémentaires au tableau en utilisant les boutons {{< ui >}}\+ Add Query{{< /ui >}} et {{< ui >}}\+ Add Formula{{< /ui >}}. -2. Cliquez sur les boutons **+ Add Query** et **+ Add Formula** pour ajouter des colonnes supplémentaires au tableau. +### Options {#options} -### Options +* Renommez les en-têtes de colonne en définissant des alias, cliquez sur le bouton {{< ui >}}as...{{< /ui >}}. +* Configurez l'affichage ou non de la barre de recherche. {{< ui >}}Auto{{< /ui >}} est la valeur par défaut et affiche la barre de recherche en fonction de la taille du widget ; cela signifie que si votre écran devient trop petit, il donne la priorité à l'affichage des données sur le widget et masque la barre de recherche, qui reste toutefois disponible en mode plein écran. -* Vous pouvez cliquer sur le bouton **as...** pour configurer des alias afin de renommer les en-têtes de vos colonnes. -* Définissez si la barre de recherche doit s'afficher ou non. L'option **Auto**, appliquée par défaut, affiche la barre de recherche en fonction de la taille du widget. Ainsi, si la fenêtre devient trop petite, le widget affiche en priorité les données et masque la barre de recherche. Cette dernière continue à s'afficher en mode plein écran. +#### Formatage de colonne {#column-formatting} -#### Mise en forme des colonnes +Personnalisez la visualisation des valeurs de cellule pour chaque colonne avec des règles de formatage de colonne. Créez des codes couleur pour vos données afin de visualiser les tendances et les changements. +* Formatage par seuil : mettez en surbrillance les cellules avec des couleurs lorsque des plages de valeurs spécifiques sont atteintes. +* Formatage par plage : codez par couleur les cellules avec une plage de valeurs. +* Formatage de texte : remplacez les cellules par des valeurs de texte d'alias pour améliorer la lisibilité. +* Informations sur les tendances : visualisez les requêtes de métriques et d'événements. -Personnalisez l'affichage des valeurs des cellules pour chaque colonne grâce aux règles de mise en page des colonnes. Vous pouvez ainsi créer des codes couleur pour vos données afin de représenter des tendances et changements. -* Mise en forme par seuil : mettre en évidence les cellules avec des couleurs lorsque des plages de valeurs spécifiques sont atteintes. -* Mise en forme avec des plages : appliquez un code couleur à vos cellules en fonction d'une plage de valeurs. -* Mise en forme de texte : remplacez des cellules par des alias de valeurs textuelles afin d'améliorer la lisibilité de vos données. -* Informations sur les tendances : visualiser des requêtes de métriques et d'événements. +{{< img src="/dashboards/widgets/table/conditional_formatting_trends.png" alt="Widget de tableau affichant un formatage conditionnel avec des indicateurs de tendance" style="width:100%;" >}} -{{< img src="/dashboards/widgets/table/conditional_formatting_trends.png" alt="Widget Table affichant une mise en forme conditionnelle avec des indicateurs de tendance" style="width:100%;" >}} +#### Liens contextuels {#context-links} -#### Liens de contexte +Les [liens contextuels][10] sont activés par défaut et peuvent être activés ou désactivés. Les liens contextuels relient les widgets de dashboard à d'autres pages dans Datadog ou à des applications tierces. -Les [liens de contexte][10] sont activés par défaut, mais vous pouvez les désactiver si vous le souhaitez. Ils relient les widgets du dashboard à d'autres pages dans Datadog ou sur des applications externes. +## Valeurs N/A {#na-values} -## Absence de valeurs +Les colonnes du widget de tableau sont interrogées indépendamment les unes des autres. Les groupes qui se chevauchent avec des noms correspondants sont joints en temps réel pour former les lignes du tableau. En raison de ce processus, il peut y avoir des situations sans chevauchement total, affichant des cellules N/A. Pour atténuer cela : + * Augmentez la limite des requêtes à des nombres plus élevés, afin de maximiser le chevauchement entre les colonnes + * Triez les tableaux selon la colonne que vous pourriez considérer comme « moteur » de l'analyse -Les colonnes d'un widget Tableau sont chacune interrogées indépendamment. Les groupes dont les données se recoupent et qui partagent le même nom sont fusionnés en temps réel. Ils représentent les lignes du tableau. Ainsi, il arrive qu'aucune donnée ne se chevauche, ce qui donne lieu à des cellules sans valeur. Pour y remédier, procédez comme suit : - * Autorisez un plus grand nombre de requêtes, afin de maximiser le chevauchement de données entre les colonnes. - * Triez les tableaux en fonction de la colonne qui contient les données centrales à votre analyse. +## API {#api} -## API - -Ce widget peut être utilisé avec l'**API Dashboards**. Consultez la [documentation à ce sujet][8] pour en savoir plus. +Ce widget peut être utilisé avec l'**API Dashboards**. Consultez la [documentation de l'API Dashboards][8] pour plus d'informations. Le [schéma JSON][9] utilisé pour le widget Tableau est le suivant : {{< dashboards-widgets-api >}} -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/fr/data_observability/cicd.md b/hugo/content/fr/data_observability/cicd.md new file mode 100644 index 00000000000..842c2e2296c --- /dev/null +++ b/hugo/content/fr/data_observability/cicd.md @@ -0,0 +1,151 @@ +--- +description: Vérifiez automatiquement les pull requests qui modifient des modèles + dbt pour évaluer l'impact en aval et la dérive des données avant leur fusion. +further_reading: +- link: /data_observability/ + tag: Documentation + text: Vue d'ensemble de Data Observability +- link: /data_observability/data_catalog/ + tag: Documentation + text: Catalogue de données +- link: /data_observability/lineage/ + tag: Documentation + text: Lignage +- link: /data_observability/quality_monitoring/ + tag: Documentation + text: Quality Monitoring +- link: /data_observability/jobs_monitoring/ + tag: Documentation + text: Jobs Monitoring +title: CI/CD +--- +## Présentation {#overview} + +{{< img src="data_observability/cicd/cicd-overview.png" alt="La page de rapport de la fonctionnalité CI/CD" style="width:100%;" >}} + +Les checks CI/CD de Data Observability s'exécutent automatiquement lorsque vous ouvrez une pull request (PR) qui modifie des modèles dbt. Les checks vous donnent les informations nécessaires pour décider si une modification peut être fusionnée en toute sécurité. + +Datadog publie les résultats sous forme de commentaire sur votre PR, et le commentaire est mis à jour à chaque fois que vous envoyez de nouvelles modifications. Un rapport complet est également disponible dans Datadog, et vous obtenez un lien vers celui-ci dans le commentaire de la PR. + +## Types de checks {#check-types} + +### Lignage d'impact {#impact-lineage} + +Le lignage d'impact construit un graphe de tout ce qui se trouve en aval de vos modèles dbt modifiés. Utilisez-le pour évaluer le rayon d'action d'une modification avant la fusion. Identifiez quels tableaux, dashboards et autres consommateurs dépendent des modèles que vous avez modifiés, puis assignez l'examen aux propriétaires appropriés. + +Consultez [Lignage][1] pour plus de détails sur la façon dont Datadog construit et navigue dans les graphes de lignage. + +### Détection de dérive {#drift-detection} + +La détection de dérive compare les données produites par vos modèles avant et après vos modifications à l'aide d'une série de checks statistiques. Utilisez-la pour confirmer qu'une modification de modèle produit le résultat attendu, ou pour détecter des effets secondaires involontaires tels que des changements significatifs du nombre de lignes, des variations du taux de valeurs nulles ou des changements de cardinalité dans les valeurs d'une colonne. + +## Configuration {#setup} + +### 1. Connectez votre fournisseur de contrôle de version et votre projet dbt {#1-connect-your-source-control-provider-and-dbt-project} + +1. Connectez votre [fournisseur de contrôle de version][2]. Les checks CI/CD prennent en charge GitHub et GitLab. +2. Connectez le [compte de source de données pris en charge][3] où vos modèles dbt s'exécutent. +3. Connectez votre projet [dbt Cloud][4] ou [dbt Core][5] à Datadog. Vous pouvez également connecter votre projet dbt lors de la configuration des checks CI/CD. + +### 2. Sélectionnez votre projet dbt et votre dépôt {#2-select-your-dbt-project-and-repository} + +1. Depuis les paramètres CI/CD, cliquez sur {{< ui >}}Add CI/CD Checks{{< /ui >}}. +2. Sélectionnez le projet dbt pour lequel vous souhaitez ajouter des checks. +3. Sélectionnez le job principal pour le projet. Il s'agit du job qui possède la meilleure connaissance de votre schéma dbt. +4. Si Datadog ne déduit pas automatiquement le dépôt de votre fournisseur de contrôle de version, sélectionnez-le manuellement. + +{{< img src="data_observability/cicd/cicd-connection.png" alt="La page de création de la fonctionnalité CI/CD" style="width:100%;" >}} + +#### Paramètres avancés {#advanced-settings} + +Si votre projet dbt ne se trouve pas à la racine de votre dépôt, vous pouvez spécifier le chemin d'accès à votre projet dbt dans les paramètres avancés. + +### 3. Configurer les checks {#3-configure-checks} + +Vous pouvez activer chaque check indépendamment. L'activation de tous les checks permet d'obtenir les rapports les plus complets. + +#### Lignage d'impact {#impact-lineage-1} + +Le lignage d'impact génère un graphe des ressources en aval qui peuvent être affectées par les modifications de vos modèles. + +##### Paramètres généraux {#general-settings} + +| Paramètre | Description | +| ---------------------------------- | -------------------------------------------------------------------- | +| `Run on Draft Pull/Merge Requests` | Activez cette option pour exécuter le check sur les pull requests ou merge requests en brouillon. | + +#### Détection de dérive {#drift-detection-1} + +La détection de dérive compare l'état actuel de vos données sur la branche à une référence et signale toute déviation. Datadog utilise les exécutions dbt de votre pipeline CI comme déclencheurs pour les checks de détection de dérive. Pour **dbt Core**, vous devez envoyer des événements OpenLineage depuis votre job CI afin que Datadog reçoive ces exécutions. Consultez la [documentation de configuration d'OpenLineage][6]. Pour **dbt Cloud**, configurez le job CI qui s'exécute sur les pull requests dans le paramètre `CI Job URL` de la section [dbt Cloud](#dbt-cloud). + +Datadog doit également être en mesure de lire les tables que votre job CI construit pour les comparer. Le rôle que vous avez créé lors de la configuration de Snowflake (`DATADOG_ROLE` par défaut) nécessite `USAGE` et `SELECT` sur la base de données dans laquelle votre job CI matérialise les modèles. La configuration de l'intégration Snowflake de Datadog inclut une procédure `grant_database_access` qui accorde cela sur toutes les tables et vues actuelles et futures dans chaque schéma d'une base de données. Exécutez-la pour la base de données dans laquelle votre job CI écrit : + +```sql +CALL grant_database_access('[""]', ''); +``` + +Si votre CI crée une base de données éphémère par pull request, appelez la procédure dans le cadre de cette étape de provisionnement afin que chaque nouvelle base de données soit lisible. Consultez [Configuration de Snowflake][8] pour la définition de la procédure. Sans cet accès, Datadog reçoit l'exécution CI mais ne peut pas interroger les tables CI, et la détection de dérive échoue. + +Pour **dbt Core**, la détection de dérive nécessite également que le numéro de pull request soit joint à vos événements OpenLineage via la facette `sourceCodeLocation`. Cela nécessite la version `openlineage-dbt` 1.46.0 ou ultérieure et la variable d'environnement `OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__DISABLED=false`. Consultez [Définir les variables d'environnement][7]. Si votre job CI dbt Core s'exécute dans un conteneur, il nécessite une configuration supplémentaire. Consultez la section [Exécution de votre job CI dbt Core dans un conteneur](#running-your-dbt-core-ci-job-in-a-container). + +##### Paramètres généraux {#general-settings-1} + +| Paramètre | Description | +| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `Run on Draft Pull/Merge Requests` | Activez cette option pour exécuter le check sur les pull requests ou merge requests en brouillon. | +| `Threshold` | Le seuil pour la détection de dérive (par exemple, `0.1` pour 10 % de dérive). Si une métrique dépasse ce seuil, elle apparaît sous forme d'avertissement dans les résultats du check. | +| `Downstream Checks` | Lorsqu'un modèle dbt change, des checks de détection de dérive sont générés pour celui-ci et pour tous les modèles dbt en aval. Ce paramètre contrôle jusqu'où en aval les checks s'exécutent. | + +##### dbt Cloud {#dbt-cloud} + +| Paramètre | Description | +| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `CI Job URL` | Le localisateur du job CI dbt Cloud qui est déclenché par les pull requests et matérialise les modèles dbt pour l'intégration continue. Datadog reçoit les événements d'exécution de ce job via l'intégration dbt Cloud. Ceux-ci ressemblent généralement à `https://cloud.getdbt.com/...`. | + +##### dbt Core {#dbt-core} + +| Paramètre | Description | +| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `CI Job Name` | Le nom du job qui est déclenché par les pull requests, matérialise les modèles dbt pour la CI et envoie des événements OpenLineage à Datadog. | +| `CI Job Namespace` | La variable OPENLINEAGE_NAMESPACE spécifiée lors de l'envoi d'événements OpenLineage depuis le job spécifié ci-dessus. Consultez [Définir les variables d'environnement][7]. Si vous ne définissez pas cette variable lors de l'envoi d'événements OpenLineage, vous n'avez pas besoin de la spécifier ici. | + +#### Exécution de votre job CI dbt Core dans un conteneur {#running-your-dbt-core-ci-job-in-a-container} + +Si votre job CI dbt Core s'exécute à l'intérieur d'un conteneur lancé par le runner CI (par exemple, un workflow GitHub Actions qui exécute le job avec `docker run`), le conteneur n'hérite pas du contexte git du runner CI. Par conséquent, l'URL du dépôt, le SHA du commit et le numéro de la pull request ne sont pas détectés automatiquement, et la facette `sourceCodeLocation` est envoyée sans eux. Datadog utilise ces valeurs pour faire correspondre l'exécution à la pull request que vous avez ouverte ou mise à jour ; sans elles, aucun résultat de dérive n'apparaît sur la pull request. + +L'exemple suivant utilise GitHub Actions ; sur d'autres fournisseurs CI, les noms des variables d'environnement diffèrent, mais l'approche est la même. Sur le runner CI, lisez les valeurs et transmettez-les explicitement dans le conteneur : + +```shell +# On the CI runner, before launching the container: +PR_NUMBER=$(jq -r '.pull_request.number' "$GITHUB_EVENT_PATH") +HEAD_SHA=$(jq -r '.pull_request.head.sha' "$GITHUB_EVENT_PATH") # the pull request's head commit, not the merge commit +REPO_URL="${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}" + +docker run \ + -e OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__DISABLED=false \ + -e OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__REPO_URL="$REPO_URL" \ + -e OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__PULL_REQUEST_NUMBER="$PR_NUMBER" \ + -e OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__VERSION="$HEAD_SHA" \ + +``` + +Le workflow doit s'exécuter lorsqu'une demande de tirage est ouverte ou mise à jour : + +```yaml +on: + pull_request: + types: [opened, synchronize, reopened] +``` + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/data_observability/lineage/ +[2]: /fr/integrations/#cat-source-control +[3]: /fr/data_observability/quality_monitoring/#supported-data-sources +[4]: /fr/data_observability/jobs_monitoring/dbt/?tab=dbtcloud +[5]: /fr/data_observability/jobs_monitoring/dbt/?tab=dbtcore +[6]: /fr/data_observability/jobs_monitoring/openlineage/ +[7]: /fr/data_observability/jobs_monitoring/dbt/?tab=dbtcore#set-the-environment-variables +[8]: /fr/data_observability/quality_monitoring/data_warehouses/snowflake/ \ No newline at end of file diff --git a/hugo/content/fr/data_observability/jobs_monitoring/dbt.md b/hugo/content/fr/data_observability/jobs_monitoring/dbt.md new file mode 100644 index 00000000000..ffd29cea358 --- /dev/null +++ b/hugo/content/fr/data_observability/jobs_monitoring/dbt.md @@ -0,0 +1,172 @@ +--- +aliases: +- /fr/data_observability/jobs_monitoring/dbtcore +- /fr/data_observability/jobs_monitoring/dbtcloud +description: Connectez dbt Cloud ou dbt Core à Datadog pour obtenir les métadonnées + d'exécution des jobs et le lignage des modèles. +further_reading: +- link: /data_observability/ + tag: Documentation + text: En savoir plus sur Data Observability. +- link: https://www.datadoghq.com/blog/understanding-dbt/ + tag: Blog + text: 'Comprendre dbt : notions de base et bonnes pratiques' +title: dbt +--- +## Présentation {#overview} + +Datadog peut accéder aux métadonnées de votre dbt Cloud ou dbt Core pour extraire des informations sur les exécutions de jobs, notamment les durées d'exécution, les modèles générés par dbt et les relations de lignage entre les modèles. Datadog fait correspondre les tables de votre entrepôt de données avec les modèles dbt pour déterminer la causalité et les conséquences d'une défaillance de tableau. + +{{< tabs >}} +{{% tab "dbt Cloud" %}} + +Suivez les étapes ci-dessous pour connecter dbt Cloud à Datadog. + +## Générez un jeton API dans dbt Cloud {#generate-an-api-token-in-dbt-cloud} + +Créez un jeton de service dans dbt Cloud afin que Datadog puisse accéder aux métadonnées de votre compte. + +1. Dans dbt Cloud, accédez à {{< ui >}}User Profile{{< /ui >}} > {{< ui >}}API Tokens{{< /ui >}} > {{< ui >}}Service Tokens{{< /ui >}}. +2. Cliquez sur {{< ui >}}\+ Create Service Token{{< /ui >}}. +3. Donnez un nom au jeton. +4. Définissez les autorisations du jeton : + - Si vous créez vous-même le webhook dans dbt Cloud, utilisez l'ensemble d'autorisations {{< ui >}}Stakeholder/Read-Only{{< /ui >}} limité aux projets dbt Cloud concernés. + - Si Datadog crée et gère le webhook, utilisez les autorisations {{< ui >}}Developer{{< /ui >}} pour le plan dbt Cloud Enterprise ou les autorisations {{< ui >}}Account Admin{{< /ui >}} pour le plan dbt Cloud Team. +5. Cliquez sur {{< ui >}}Save{{< /ui >}} et copiez le jeton API généré. + +## Connectez votre compte dbt Cloud à Datadog {#connect-your-dbt-cloud-account-to-datadog} + +Utilisez le jeton API pour configurer l'intégration dans Data Observability. + +1. Accédez à [{{< ui >}}Datadog Data Observability{{< /ui >}} > {{< ui >}}Settings{{< /ui >}}][1]. +2. Dans la section {{< ui >}}dbt Cloud{{< /ui >}}, cliquez sur {{< ui >}}Configure{{< /ui >}}. +3. Si vous avez déjà créé un compte d'intégration dbt Cloud, assurez-vous de l'avoir mis à jour avec le jeton d'API disposant des autorisations décrites ci-dessus. +4. Sinon, créez un compte. Remplissez les sections {{< ui >}}Account Name{{< /ui >}}, {{< ui >}}Account Id{{< /ui >}}, {{< ui >}}Account Url{{< /ui >}} et {{< ui >}}API Token{{< /ui >}}. +5. Cliquez sur {{< ui >}}Save{{< /ui >}} pour enregistrer vos paramètres. + +## Configurez les webhooks {#configure-webhooks} + +Dans les paramètres de Data Observability, développez le compte dbt Cloud et choisissez la manière dont Datadog reçoit les événements d'exécution de job dbt Cloud. + +### Créez vous-même le webhook dans dbt Cloud {#create-the-webhook-in-dbt-cloud-yourself} + +Utilisez cette option si vous souhaitez utiliser un jeton de service {{< ui >}}Stakeholder/Read-Only{{< /ui >}} pour l'ingestion d'artefacts. + +1. Sélectionnez {{< ui >}}I'll manage the webhook in dbt Cloud myself{{< /ui >}}. +2. Copiez l'URL du webhook Datadog. +3. Dans dbt Cloud, accédez à {{< ui >}}Account Settings{{< /ui >}} > {{< ui >}}Webhooks{{< /ui >}} > {{< ui >}}Create New Webhook{{< /ui >}}. +4. Collez l'URL du webhook Datadog dans le champ URL du webhook. +5. Activez les événements {{< ui >}}Job Run Started{{< /ui >}} et {{< ui >}}Job Run Completed{{< /ui >}}. Pour étendre l'ingestion à des jobs spécifiques, sélectionnez ces jobs dans la configuration du webhook de dbt Cloud. +6. Enregistrez le webhook dans dbt Cloud. +7. Copiez le secret HMAC depuis dbt Cloud, collez-le dans le champ {{< ui >}}HMAC secret from dbt Cloud{{< /ui >}} dans Datadog, puis cliquez sur {{< ui >}}Save{{< /ui >}}. + +**Remarque** : Après l'enregistrement, les webhooks que vous créez vous-même peuvent mettre jusqu'à 5 minutes avant de commencer à accepter le trafic provenant de dbt Cloud. + +Si vous supprimez ultérieurement une configuration de webhook gérée par l'utilisateur dans Datadog, supprimez manuellement le webhook de dbt Cloud. + +### Laissez Datadog gérer le webhook {#let-datadog-manage-the-webhook} + +Utilisez cette option si vous souhaitez que Datadog crée et maintienne le webhook dans dbt Cloud. + +1. Sélectionnez {{< ui >}}Datadog-managed{{< /ui >}}. +2. Cliquez sur {{< ui >}}Save{{< /ui >}}. + +Ce mode nécessite un jeton dbt Cloud avec des autorisations {{< ui >}}Developer{{< /ui >}} pour le plan dbt Cloud Enterprise ou des autorisations {{< ui >}}Account Admin{{< /ui >}} pour le plan dbt Cloud Team. + +## Prochaines étapes {#whats-next} + +Après votre prochaine exécution de job dbt, vous devriez commencer à voir les données d'exécution de job et de lignage dans [Datadog Data Observability][2], comme illustré ci-dessous. + +{{< img src="data_observability/data-obs-dbt-cloud-final.png" alt="Vue d'ensemble de Data Observability montrant les exécutions des jobs dbt sous forme de graphique à barres empilées au fil du temps et un tableau des comptes dbt Cloud connectés avec leur statut." style="width:100%;" >}} + +[1]: https://app.datadoghq.com/data-obs/settings/integrations +[2]: https://app.datadoghq.com/data-obs/catalog?integration=dbt + +{{% /tab %}} + +{{% tab "dbt Core" %}} + +Suivez les étapes ci-dessous pour connecter dbt Core à Datadog. + +**Remarque** : Si vous exécutez dbt Core avec un orchestrateur externe (tel qu'Airflow) et que vous souhaitez corréler les tâches de l'orchestrateur avec les exécutions dbt, suivez d'abord les [instructions d'intégration Airflow][1]. + +## Récupérez votre clé Datadog API {#retrieve-your-datadog-api-key} + +1. [Suivez ces instructions][2] pour créer ou récupérer une clé Datadog API. + +## Installez openlineage-dbt {#install-openlineage-dbt} + +1. Installez le package `openlineage-dbt`. Consultez [Utilisation de dbt avec Amazon MWAA][3] pour configurer ce package dans votre environnement virtuel. + + ```shell + pip3 install openlineage-dbt>=1.39.0 + ``` + +## Définissez les variables d'environnement {#set-the-environment-variables} + +1. Définissez les variables d'environnement suivantes. Remplacez `datadoghq.com` par le [site Datadog][4] correspondant à votre organisation. Pour plus d'informations sur les sites Datadog prédéfinis, consultez la [documentation OpenLineage][5]. + + ```shell + export DD_SITE=datadoghq.com + export DD_API_KEY= + export OPENLINEAGE__TRANSPORT__TYPE=datadog + + # OPENLINEAGE_NAMESPACE determines the Datadog tag value for the environment (similar to how the service tag identifies the application). + # Typical values are dev, staging, or prod, but you can over ride it with any custom value. + export OPENLINEAGE_NAMESPACE= + + # Optional, for debugging purposes + export OPENLINEAGE_CLIENT_LOGGING=DEBUG + + # Required for CI/CD Drift Detection (requires openlineage-dbt >= 1.46.0). + # Attaches the sourceCodeLocation facet (repository URL, commit SHA, and pull + # request number) so Datadog can associate the dbt run with a pull request. + # Disabled by default; not required for job monitoring alone. + export OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__DISABLED=false + ``` + + Pour les [vérifications CI/CD][8], le numéro de pull request est détecté automatiquement lorsque l'exécution expose `GITHUB_REF` (workflows GitHub Actions déclenchés par une pull request) ou `CI_MERGE_REQUEST_IID` (pipelines de merge request GitLab). Si aucune de ces variables n'est présente, définissez explicitement le numéro de pull request : + + ```shell + export OPENLINEAGE__FACETS__SOURCE_CODE_LOCATION__PULL_REQUEST_NUMBER= + ``` + + Si votre job CI s'exécute dans un conteneur qui n'hérite pas du contexte git du runner (par exemple, un workflow GitHub Actions lançant un conteneur), l'URL du dépôt, le SHA du commit et le numéro de pull request ne sont pas détectés automatiquement ; vous devez donc transmettre les trois explicitement. Consultez [Exécution de votre job CI dbt Core dans un conteneur](/data_observability/cicd/#running-your-dbt-core-ci-job-in-a-container). + +## Mettez à jour l'appel dbt {#update-the-dbt-invocation} + +1. Modifiez vos appels dbt pour utiliser le wrapper OpenLineage (`dbt-ol`) au lieu d'appeler `dbt` directement. Cela s'applique à toute commande dbt que vous souhaitez suivre dans Datadog, telle que `run`, `build` et `test`. Pour la liste complète des commandes disponibles, consultez la [documentation dbt][7]. +2. Ajoutez l'indicateur `--consume-structured-logs` pour afficher les jobs dbt pendant que la commande est encore en cours d'exécution. + + ```shell + # Run models + dbt-ol run --consume-structured-logs --openlineage-dbt-job-name + + # Run tests (required to see test failures in Datadog) + dbt-ol test --consume-structured-logs --openlineage-dbt-job-name + + # Run build (runs models, tests, seeds, and snapshots) + dbt-ol build --consume-structured-logs --openlineage-dbt-job-name + ``` + +## Quelle est la prochaine étape {#whats-next-1} + +Après votre prochaine exécution de job dbt, vous devriez commencer à voir les données d'exécution de job et de lignage dans [Datadog Data Observability][6], comme illustré ci-dessous. + +{{< img src="data_observability/data-obs-dbt-cloud-final.png" alt="Vue d'ensemble de Data Observability montrant les exécutions des jobs dbt et le lignage des modèles." style="width:100%;" >}} + +[1]: /fr/data_jobs/airflow/?tab=kubernetes +[2]: /fr/account_management/api-app-keys/#add-an-api-key-or-client-token +[3]: https://docs.aws.amazon.com/mwaa/latest/userguide/samples-dbt.html +[4]: /fr/getting_started/site/#access-the-datadog-site +[5]: https://openlineage.io/docs/client/python/#predefined-datadog-sites +[6]: https://app.datadoghq.com/data-obs/catalog?integration=dbt +[7]: https://docs.getdbt.com/docs/running-a-dbt-project/run-your-dbt-projects +[8]: /fr/data_observability/cicd/ + +{{% /tab %}} +{{< /tabs >}} + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/fr/deployment_gates/_index.md b/hugo/content/fr/deployment_gates/_index.md new file mode 100644 index 00000000000..d1235f894bb --- /dev/null +++ b/hugo/content/fr/deployment_gates/_index.md @@ -0,0 +1,38 @@ +--- +algolia: + tags: + - cd gates +description: Réduisez les incidents de déploiement en évaluant automatiquement les + monitors et les anomalies APM pour interrompre les mises en production lorsque des + régressions de performance sont détectées. +further_reading: +- link: /deployment_gates/setup + tag: Documentation + text: Configurez Deployment Gates +- link: /deployment_gates/explore + tag: Documentation + text: En savoir plus sur l'explorer de portes de déploiement +- link: continuous_delivery + tag: Documentation + text: En savoir plus sur Continuous Delivery Visibility +- link: continuous_delivery/deployments + tag: Documentation + text: Découvrez comment configurer CD Visibility +title: Portes de déploiement +--- +Deployment Gates vous permettent de réduire la probabilité et l'impact des incidents causés par les déploiements. + +Lors d'un déploiement en production, vous pouvez utiliser Deployment Gates pour évaluer l'impact des nouveaux changements en utilisant des [monitors][1] et des anomalies APM. +Lorsque des anomalies ou des régressions de performance sont détectées, vous pouvez interrompre automatiquement la mise en production, empêchant ainsi le code instable d'atteindre une base d'utilisateurs plus large. De plus, vous pouvez ensuite utiliser Deployment Gates comme point d'entrée pour enquêter sur le problème. + +Pour les instructions de configuration, consultez [Set up Deployment Gates][2]. Une fois la configuration terminée, vous pouvez suivre et analyser les évaluations de Deployment Gates via la page [Deployment Gates Evaluations][3] : + +{{< img src="/deployment_gates/explore/deployment_gates_explorer.png" text="The Deployment Gate evaluation page in Datadog" style="width:100%" >}} + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/monitors/ +[2]: /fr/deployment_gates/setup +[3]: /fr/deployment_gates/explore \ No newline at end of file diff --git a/hugo/content/fr/deployment_gates/explore.md b/hugo/content/fr/deployment_gates/explore.md new file mode 100644 index 00000000000..c41da717959 --- /dev/null +++ b/hugo/content/fr/deployment_gates/explore.md @@ -0,0 +1,25 @@ +--- +description: Consultez les évaluations de barrières de déploiement, identifiez les + règles qui échouent fréquemment, analysez les modèles d'échec et suivez les tendances + d'évaluation au fil du temps. +further_reading: +- link: /deployment_gates/setup + tag: Documentation + text: Configurez Deployment Gates +title: Explorez les barrières de déploiement +--- +Pour explorer vos barrières de déploiement et vos évaluations de règles, accédez à [{{< ui >}}Software Delivery{{< /ui >}} > {{< ui >}}Deployment Gates{{< /ui >}} > {{< ui >}}Evaluations{{< /ui >}}][1]. + +Sur cette page, vous pouvez : +* Consultez les évaluations de barrières de déploiement récemment terminées et les raisons des échecs +* Identifiez les règles et les barrières de déploiement qui échouent fréquemment +* Analysez les modèles d'échec courants +* Suivez les tendances d'évaluation au fil du temps + +{{< img src="/deployment_gates/explore/deployment_gates_explorer.png" text="The Deployment Gate evaluation page in Datadog" style="width:100%" >}} + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/ci/deployment-gates/evaluations \ No newline at end of file diff --git a/hugo/content/fr/error_tracking/frontend/browser.md b/hugo/content/fr/error_tracking/frontend/browser.md new file mode 100644 index 00000000000..abbcc1e8ee0 --- /dev/null +++ b/hugo/content/fr/error_tracking/frontend/browser.md @@ -0,0 +1,237 @@ +--- +aliases: +- /fr/real_user_monitoring/error_tracking/browser_errors +- /fr/error_tracking/standalone_frontend/browser +further_reading: +- link: https://learn.datadoghq.com/courses/tracking-errors-rum-javascript + tag: Centre d'apprentissage + text: Suivi des erreurs avec RUM pour les applications Web JavaScript +- link: https://github.com/DataDog/datadog-ci/tree/master/packages/datadog-ci/src/commands/sourcemaps + tag: Code source + text: Code source datadog-ci +- link: /real_user_monitoring/guide/upload-javascript-source-maps + tag: Documentation + text: Téléverser des maps source JavaScript +- link: /real_user_monitoring/guide/upload-webassembly-symbols + tag: Documentation + text: Téléverser des symboles WebAssembly +- link: /error_tracking/explorer + tag: Documentation + text: En savoir plus sur l'Error Tracking Explorer +title: Browser Error Tracking +--- +## Présentation {#overview} + +[Error Tracking][1] traite les erreurs collectées depuis le navigateur par le Browser SDK. Chaque fois qu'une erreur [source][2], [custom][3], [report][4] ou [console][4] contenant une trace de pile est collectée, Error Tracking la traite et la regroupe sous un problème, ou groupe d'erreurs similaires à retrouver dans l'[Error Tracking Explorer][16]. + +## Prérequis {#prerequisites} + +Téléchargez la dernière version du [Browser SDK][5]. + +## Configuration {#setup} + +Pour commencer à envoyer des données d'Error Tracking depuis votre application de navigateur vers Datadog, suivez les [instructions de configuration dans l'application][6] ou suivez les étapes ci-dessous. + +### Étape 1 - Créer l'application {#step-1-create-the-application} + +1. Dans Datadog, accédez à la page [{{< ui >}}Errors{{< /ui >}} > {{< ui >}}Settings{{< /ui >}} > {{< ui >}}Browser and Mobile{{< /ui >}} > {{< ui >}}Add an Application{{< /ui >}}][6] et sélectionnez le type d'application JavaScript (JS). +2. Saisissez un nom pour votre application, puis cliquez sur {{< ui >}}Create Application{{< /ui >}}. Cela génère une `clientToken` et une `applicationId` pour votre application. + +### Étape 2 - Choisir la méthode d'installation appropriée {#step-2-choose-the-right-installation-method} + +Choisissez le type d'installation pour le Browser SDK. + +{{< tabs >}} +{{% tab "npm" %}} + +L'installation via npm (Node Package Manager) est recommandée pour les applications Web modernes. Le Browser SDK est packagé avec le reste de votre code JavaScript frontend. Il n'a aucun impact sur les performances de chargement des pages. Cependant, le SDK peut manquer des erreurs, des ressources et des actions utilisateur déclenchées avant l'initialisation du SDK. Datadog recommande d'utiliser une version correspondante avec le Browser Logs SDK. + +Ajoutez [`@datadog/browser-rum`][1] à votre fichier `package.json`, puis initialisez-le avec : + +```javascript +import { datadogRum } from '@datadog/browser-rum'; + +datadogRum.init({ + + applicationId: '', + clientToken: '', + service: '', + env: '', + // site: '', + // version: '1.0.0', + trackUserInteractions: true, + trackResources: true +}); + +``` + +Le paramètre `trackUserInteractions` permet la collecte automatique des clics utilisateur dans votre application. **Les données sensibles et privées** contenues dans vos pages peuvent être incluses pour identifier les éléments avec lesquels une interaction a eu lieu. + +[1]: https://www.npmjs.com/package/@datadog/browser-rum + +{{% /tab %}} +{{% tab "CDN async" %}} + +L'installation via CDN asynchrone est recommandée pour les applications web ayant des objectifs de performance. Le Browser SDK se charge depuis le CDN de Datadog de manière asynchrone, garantissant que le téléchargement du Browser SDK n'impacte pas les performances de chargement de la page. Cependant, le SDK peut manquer des erreurs, des ressources et des actions utilisateur déclenchées avant l'initialisation du SDK. + +Ajoutez l'extrait de code généré dans le tag head de toutes les pages HTML que vous souhaitez surveiller dans votre application. Pour le **{{}}** [site][1] : + +```javascript + +``` + +Le paramètre `trackUserInteractions` permet la collecte automatique des clics utilisateur dans votre application. **Les données sensibles et privées** contenues dans vos pages peuvent être incluses pour identifier les éléments avec lesquels une interaction a eu lieu. + +[1]: /fr/getting_started/site/ + +{{% /tab %}} +{{% tab "CDN sync" %}} + +L'installation via CDN synchrone est recommandée pour collecter tous les événements. Le Browser SDK se charge depuis le CDN de Datadog de manière synchrone, garantissant que le Browser SDK se charge en premier et collecte toutes les erreurs, ressources et actions utilisateur. Cette méthode peut impacter les performances de chargement de la page. + +Ajoutez l'extrait de code généré au tag head (avant tout autre tag script) de chaque page HTML que vous souhaitez surveiller dans votre application. Placer le tag script plus haut et la charger de manière synchrone garantit que Datadog RUM peut collecter toutes les données de performance et les erreurs. Pour le **{{}}** [site][1] : + +```javascript + + +``` + +Le paramètre `trackUserInteractions` permet la collecte automatique des clics utilisateur dans votre application. **Les données sensibles et privées** contenues dans vos pages peuvent être incluses pour identifier les éléments avec lesquels une interaction a eu lieu. + +[1]: /fr/getting_started/site/ + +{{% /tab %}} +{{< /tabs >}} + +#### TypeScript (facultatif) {#typescript-optional} + +Si vous initialisez le SDK dans un projet TypeScript, utilisez l'extrait de code ci-dessous. Les types sont compatibles avec TypeScript >= 3.8.2. + +
Pour les versions antérieures de TypeScript, importez les sources JavaScript et utilisez des variables globales pour éviter tout problème de compilation.
+ +```javascript +import '@datadog/browser-rum/bundle/datadog-rum' + +window.DD_RUM.init({ + applicationId: 'XXX', + clientToken: 'XXX', + site: 'datadoghq.com', + trackUserInteractions: true, + trackResources: true, + ... +}) +``` + +### Étape 3 - Configurer l'environnement et les paramètres {#step-3-configure-environment-and-settings} + +1. Dans le champ Environnement, définissez l'environnement (`env`) pour que votre application utilise le [unified service tagging][18]. +2. Dans le champ Service, définissez le service (`service`) pour que votre application utilise le [unified service tagging][18]. +3. Définissez le niveau de confidentialité pour les saisies utilisateur. Consultez [Options de confidentialité du navigateur pour Session Replay][10] pour plus de détails. +4. Définissez un numéro de version (`version`) pour votre application déployée dans l'extrait d'initialisation. Pour plus d'informations, consultez [Tagging](#tagging-for-error-tracking). +5. Configurez des paramètres supplémentaires si nécessaire. Consultez la section [Référence de configuration](#configuration-reference) ci-dessous pour toutes les options disponibles. + +### Étape 4 - Déployez votre application {#step-4-deploy-your-application} + +Déployez les modifications sur votre application. Une fois votre déploiement en ligne, Datadog collecte les événements depuis les navigateurs de vos utilisateurs. + +### Étape 5 - Téléchargez les maps source et les symboles WebAssembly (facultatif mais recommandé) {#step-5-upload-source-maps-and-webassembly-symbols-optional-but-recommended} + +Téléchargez vos maps source JavaScript pour accéder aux stack traces non minifiées. Consultez le [guide de téléchargement des maps source][17]. + +Si votre application de navigateur utilise WebAssembly, [configurez le Browser SDK WASM plugin][20] et [téléchargez les symboles de débogage du module][21]. + +### Étape 6 - Visualisez vos données {#step-6-visualize-your-data} + +Maintenant que vous avez terminé la configuration de base du Browser Error Tracking, votre application collecte les erreurs de navigateur et vous pouvez commencer à surveiller et à déboguer les problèmes en temps réel. + +Visualisez les [données collectées][7] dans des [dashboards][8] ou créez une requête de recherche dans Error Tracking. + +Tant que Datadog ne reçoit pas de données, votre application apparaît comme `pending` sur la page {{< ui >}}Applications{{< /ui >}}. + +### Étape 7 - Liez les erreurs à votre code source (facultatif) {#step-7-link-errors-with-your-source-code-optional} + +En plus d'envoyer des maps source, le [Datadog CLI][11] rapporte des informations Git telles que le hash du commit, l'URL du dépôt et une liste des chemins de fichiers suivis dans le dépôt de code. + +Error Tracking peut utiliser ces informations pour corréler les erreurs avec votre [code source][15], vous permettant de passer de n'importe quelle trame de trace de pile à la ligne de code associée dans [GitHub][12], [GitLab][13] et [Bitbucket][14]. + +
La liaison des trames de stack trace au code source est prise en charge dans la version Datadog CLI 0.12.0 et ultérieure.
+ +Pour plus d'informations, consultez l'[intégration du code source Datadog][15]. + +## Tagging for Error Tracking {#tagging-for-error-tracking} + +Ces tags (configurés à l'étape 3 ci-dessus) alimentent la fonctionnalité d'Error Tracking : + +- Filtrage et facettage des problèmes par `service` et `env` +- Corrélation inter-produits avec RUM, Logs et APM pour le même `service`/`env` +- Correspondance des maps source téléchargées via les mêmes `service` et `version` que vous configurez lors du téléchargement + +Un service est un dépôt de code indépendant et déployable qui correspond à un ensemble de pages : + +- Si votre application de navigateur a été construite comme un monolithe, votre application Datadog possède un nom de service pour l'application. +- Si votre application de navigateur a été construite sous forme de dépôts séparés pour plusieurs pages, modifiez les noms de service par défaut tout au long du cycle de vie de votre application. + +En savoir plus sur le [tagging][19] dans Datadog. + +## Référence de configuration {#configuration-reference} + +Consultez la [Browser SDK API Reference][9] pour obtenir la liste complète des options de configuration disponibles. + +## Étapes suivantes {#next-steps} + +Vous pouvez surveiller les exceptions non gérées, les rejets de promesses non gérés, les exceptions gérées, les rejets de promesses gérés et d'autres erreurs que le Browser SDK ne suit pas automatiquement. En savoir plus sur [Collecting Browser Errors][3]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/error_tracking/ +[2]: /fr/real_user_monitoring/application_monitoring/browser/data_collected/?tab=error#source-errors +[3]: /fr/error_tracking/frontend/collecting_browser_errors/ +[4]: /fr/error_tracking/frontend/collecting_browser_errors/?tab=npm#error-sources +[5]: https://www.npmjs.com/package/@datadog/browser-rum +[6]: https://app.datadoghq.com/error-tracking/settings/setup/client +[7]: /fr/real_user_monitoring/application_monitoring/browser/data_collected/ +[8]: /fr/real_user_monitoring/platform/dashboards/errors/ +[9]: https://datadoghq.dev/browser-sdk/interfaces/_datadog_browser-rum.RumInitConfiguration.html +[10]: /fr/session_replay/privacy_options?platform=browser#mask-action-names +[11]: https://github.com/DataDog/datadog-ci/tree/master/packages/datadog-ci/src/commands/sourcemaps#sourcemaps-command +[12]: https://github.com +[13]: https://about.gitlab.com +[14]: https://bitbucket.org/product +[15]: /fr/integrations/guide/source-code-integration/ +[16]: /fr/error_tracking/explorer +[17]: /fr/real_user_monitoring/guide/upload-javascript-source-maps +[18]: /fr/getting_started/tagging/unified_service_tagging/ +[19]: /fr/getting_started/tagging/ +[20]: /fr/real_user_monitoring/application_monitoring/browser/collecting_browser_errors/#configure-webassembly-error-tracking +[21]: /fr/real_user_monitoring/guide/upload-webassembly-symbols/#upload-your-symbols \ No newline at end of file diff --git a/hugo/content/fr/experiments/_index.md b/hugo/content/fr/experiments/_index.md index fc5a85e22be..c7fdd8e4c0d 100644 --- a/hugo/content/fr/experiments/_index.md +++ b/hugo/content/fr/experiments/_index.md @@ -20,9 +20,15 @@ further_reading: - link: https://www.datadoghq.com/blog/experiments tag: Blog text: Mesurez l'impact commercial de chaque changement de produit avec Datadog Experiments +- link: https://www.datadoghq.com/blog/coordinate-product-launches-with-datadog/ + tag: Blog + text: Coordonnez les lancements de produits avec Datadog +- link: https://www.datadoghq.com/blog/chatgpt-datadog-experiments/ + tag: Blog + text: Analysez vos expérimentations dans ChatGPT avec le plugin Datadog Experiments title: Experiments --- -## Vue d'ensemble {#overview} +## Présentation {#overview} Datadog Experiments est une plateforme composable pour l'expérimentation de bout en bout. Une expérience dans Datadog se compose de deux éléments : @@ -63,7 +69,7 @@ Les métriques d'expérience définissent ce que vous mesurez pour décider si u ### Mode natif d'entrepôt {#warehouse-native-mode} -En mode natif d'entrepôt, Datadog exécute l'analyse d'expérience directement dans Snowflake, BigQuery, Redshift ou Databricks. Après avoir [connecté votre entrepôt][13], créez un **Modèle SQL de métrique** qui mappe les tables de l'entrepôt vers Datadog, puis définissez des métriques à partir de ce modèle. Mappez chaque modèle à un ou plusieurs [types de sujets][18] et spécifiez une colonne d'horodatage afin que Datadog puisse joindre les événements de métrique aux expositions de l'expérience. +En mode natif d'entrepôt, Datadog exécute l'analyse d'expérience directement dans Snowflake, BigQuery, Redshift ou Databricks. Après avoir [connecté votre entrepôt][13], créez un **Modèle SQL de métrique** qui mappe les tableaux de l'entrepôt vers Datadog, puis définissez des métriques à partir de ce modèle. Mappez chaque modèle à un ou plusieurs [types de sujets][18] et spécifiez une colonne d'horodatage afin que Datadog puisse joindre les événements de métrique aux expositions de l'expérience. Le mode entrepôt est requis lorsque vous utilisez des [modèles SQL d'exposition][17] pour la randomisation. Il convient également aux équipes dont la source de vérité pour les métriques métier se trouve déjà dans l'entrepôt. @@ -79,7 +85,7 @@ Datadog applique une analyse statistique pour comparer les variantes et estimer {{< img src="/product_analytics/experiment/overview_metrics_view-1.png" alt="La vue des métriques d'Experiments affichant les métriques métier, de funnel et de performance avec les valeurs de contrôle et de variante ainsi que le lift relatif pour chaque métrique. Une info-bulle est ouverte sur la métrique Revenue, affichant les valeurs sans CUPED pour le revenu par utilisateur, le revenu total et le nombre d'assignations d'utilisateurs dans les groupes de contrôle et de variante." style="width:90%;" >}} -## Lectures complémentaires {#further-reading} +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: /fr/feature_flags/ diff --git a/hugo/content/fr/experiments/defining_metrics/_index.md b/hugo/content/fr/experiments/defining_metrics/_index.md new file mode 100644 index 00000000000..1890f7420fe --- /dev/null +++ b/hugo/content/fr/experiments/defining_metrics/_index.md @@ -0,0 +1,183 @@ +--- +aliases: +- /fr/product_analytics/experimentation/defining_metrics/ +description: Créez les métriques que vous souhaitez mesurer dans vos expériences. +further_reading: +- link: https://www.datadoghq.com/blog/datadog-product-analytics/ + tag: Blog + text: Prenez des décisions de conception basées sur les données avec Product Analytics +- link: https://www.datadoghq.com/blog/how-we-built-datadog-experiments/ + tag: Blog + text: Comment nous avons conçu Datadog Experiments +title: Créez des métriques d'expérimentation +--- +## Présentation {#overview} + +Créez les métriques que vous souhaitez mesurer dans vos expériences. Vous pouvez utiliser des données issues de Real User Monitoring (RUM), de Product Analytics ou de votre propre entrepôt pour créer des métriques Datadog Experiments. + +
Si votre organisation utilise des rôles personnalisés, vous devez disposer des autorisations Product Analytics appropriées pour créer des métriques d'expérimentation.
+ +## Créer une métrique {#create-a-metric} + +Sélectionnez votre source de données : + +{{< tabs >}} +{{% tab "Product Analytics ou RUM" %}} + +### Prérequis {#prerequisites} + +Pour créer une métrique à partir de données Product Analytics ou RUM, vous devez avoir installé le [SDK côté client][3] de Datadog dans votre application et capturer activement des données. Si vous n'avez pas encore configuré votre SDK, sélectionnez votre type d'application pour commencer : + +- [Android et Android TV][4] +- [iOS et tvOS][5] +- [Navigateur (JavaScript)][6] +- [React Native][7] + +Product Analytics utilise les mêmes SDK et la même configuration que Real User Monitoring (RUM). Une fois votre SDK configuré à l'aide de la documentation de configuration RUM, créez votre métrique dans l'interface utilisateur de Product Analytics. + +### Créer une métrique à l'aide de données Product Analytics ou RUM {#create-a-metric-using-product-analytics-or-rum-data} + +Pour créer une métrique pour votre expérimentation : + +1. Accédez à la [page Métriques][1] dans Datadog Product Analytics. +1. Sélectionnez l'onglet {{< ui >}}Metrics{{< /ui >}} et cliquez sur {{< ui >}}Create Metric{{< /ui >}} dans le coin supérieur droit. +1. Ajoutez un {{< ui >}}Metric name{{< /ui >}} et, éventuellement, un {{< ui >}}Description{{< /ui >}}. +1. Sous la section {{< ui >}}Metric definition{{< /ui >}}, cliquez sur {{< ui >}}Select an event{{< /ui >}} pour ouvrir le sélecteur d'événements. Le graphique sur la droite se met à jour en temps réel à mesure que vous configurez votre métrique. + 1. Recherchez un événement spécifique ou utilisez le filtre {{< ui >}}By Type{{< /ui >}} pour parcourir par type d'événement. +1. Sélectionnez une [méthode d'agrégation](#aggregation-methods) dans la liste déroulante. La valeur par défaut est {{< ui >}}Count of events{{< /ui >}}. +1. Cliquez sur {{< ui >}}Add Filter{{< /ui >}} pour [filtrer votre métrique](#add-filters) par propriétés supplémentaires. +1. (Facultatif) Sous la section {{< ui >}}Additional settings{{< /ui >}} : + 1. Activez {{< ui >}}Mark as certified{{< /ui >}} pour indiquer que cette métrique est approuvée pour la prise de décisions importantes. Cela nécessite l'autorisation Product Analytics Certified Metrics Write. + 1. Ajustez [{{< ui >}}Experiment settings{{< /ui >}}](#advanced-options) et {{< ui >}}Units{{< /ui >}} selon vos besoins. Les valeurs par défaut conviennent à la plupart des cas d'utilisation. +1. Cliquez sur {{< ui >}}Save{{< /ui >}}. + +{{< img src="/product_analytics/experiment/exp_create_new_metric.png" alt="La page Create Metric avec le Metric name défini sur « Example metric », l'événement « click on ADD TO CART » sélectionné, la méthode d'agrégation définie sur Nombre d'événements, la section Paramètres supplémentaires, un aperçu du graphique à barres sur la droite et le bouton Save mis en surbrillance." style="width:90%;" >}} + +[1]: https://app.datadoghq.com/product-analytics/experimentation-metrics +[3]: /fr/real_user_monitoring/#get-started +[4]: /fr/real_user_monitoring/application_monitoring/android/setup/?tab=kotlin +[5]: /fr/real_user_monitoring/application_monitoring/ios/setup/?tab=swift-package-manager--spm +[6]: /fr/real_user_monitoring/application_monitoring/browser/setup/client/?tab=npm +[7]: /fr/real_user_monitoring/application_monitoring/react_native/setup/?platform=react_native + +### Ajouter des filtres {#add-filters} + +Vous pouvez filtrer votre métrique en sélectionnant un filtre {{< ui >}}Event properties{{< /ui >}}, tel que Service, Pays ou Type d'appareil. Utilisez le filtre {{< ui >}}By Data Type{{< /ui >}} pour restreindre la liste des propriétés disponibles par type (par exemple, Chaîne ou Booléen). + +Si vous ne voyez pas la propriété dont vous avez besoin, saisissez le nom de la propriété dans le champ {{< ui >}}Custom property{{< /ui >}} (par exemple, `@context.tracking`) et cliquez sur {{< ui >}}Add{{< /ui >}}. + +{{< img src="/product_analytics/experiment/exp_filter_by_2.png" alt="Le panneau Filtrer par ouvert dans la section Définition de la métrique, affichant Toutes les propriétés sélectionnées, les propriétés d'événement telles que ID d'application, Service, Nom du navigateur et Pays au centre, un filtre Par type de données avec des options Numérique, Chaîne et Booléen sur la gauche, et une section Propriété personnalisée en bas avec un champ de texte affichant l'espace réservé « e.g. @context.tracking » et un bouton Ajouter." style="width:90%;" >}} + +{{% /tab %}} +{{% tab "Entrepôt" %}} + +### Prérequis {#prerequisites-1} + +Pour créer une métrique à partir des données de votre entrepôt, vous devez [connecter votre entrepôt à Datadog][8]. Datadog prend en charge BigQuery, Databricks, Redshift et Snowflake. + +Une fois votre entrepôt connecté, créez un modèle SQL pour mapper vos données vers Datadog, puis utilisez le modèle pour créer une métrique. + +### Créer un modèle SQL {#create-a-sql-model} + +Rédigez votre requête SQL pour définir et prévisualiser vos données, puis configurez votre modèle pour mapper les données vers Datadog. + +#### Rédigez votre SQL {#write-your-sql} + +Commencez par rédiger une requête pour récupérer vos données: + +1. Accédez à la [page Métriques][1] dans Datadog Product Analytics. +1. Sélectionnez l'onglet {{< ui >}}Metric SQL Models{{< /ui >}} et cliquez sur {{< ui >}}Create SQL Model{{< /ui >}}. +1. Dans la section {{< ui >}}Write SQL{{< /ui >}}, saisissez une requête SQL qui renvoie les données qui vous intéressent. L'éditeur SQL prend en charge `SELECT * FROM` et des instructions SQL plus avancées. +1. Cliquez sur {{< ui >}}Run{{< /ui >}} pour prévisualiser vos données. + +{{< img src="/product_analytics/experiment/exp_create_metric_sql_models_writesql_1.png" alt="La section Write SQL de la page Create Metric SQL Model montrant une requête SELECT pour user_id, revenue_timestamp et amount à partir d'un tableau de commandes de revenus, avec un aperçu de requête réussi ci-dessous affichant les colonnes USER_ID, REVENUE_TIMESTAMP et AMOUNT." style="width:80%;" >}} + +Pour les grands tableaux, utilisez des [variables de modèle SQL][13] pour appliquer les filtres de date de Datadog à votre requête et réduire la quantité de données que votre entrepôt analyse à chaque exécution. + +#### Mappez vos données d'entrepôt à Datadog {#map-your-warehouse-data-to-datadog} + +Après avoir prévisualisé vos données, mappez-les à Datadog. Dans la section {{< ui >}}Structure your model{{< /ui >}} : + +1. Ajoutez un {{< ui >}}Metric SQL Model Name{{< /ui >}} (par exemple, **Revenue Orders**). +1. (Facultatif) Activez {{< ui >}}Mark as certified{{< /ui >}} pour indiquer que ce modèle SQL est approuvé pour une prise de décision importante. Cela nécessite l'autorisation Product Analytics Certified Metrics Write. +1. Mappez les colonnes de votre tableau d'entrepôt vers les éléments suivants : + - {{< ui >}}Timestamp column{{< /ui >}} + - La colonne qui répertorie l'horodatage associé à l'événement de métrique. + - L'analyse inclut uniquement les lignes créées après l'inscription du sujet à l'expérimentation. + - {{< ui >}}Subject Type{{< /ui >}} + - L'attribut que Datadog utilise pour attribuer aléatoirement des groupes d'expérimentation. + - Vous pouvez définir le type de sujet et sa colonne d'entrepôt par défaut sur la page [Types de sujets][12]. Par exemple, vous pouvez utiliser `user_id` pour un utilisateur individuel ou `org_id` pour un compte d'organisation. + - {{< ui >}}Measures{{< /ui >}} (facultatif) + - Les colonnes numériques de votre tableau d'entrepôt que Datadog peut agréger en métriques (par exemple, une colonne `revenue` ou `amount`). + - Chaque modèle SQL inclut automatiquement une mesure {{< ui >}}each record{{< /ui >}}. Utilisez cette mesure pour compter le nombre de lignes pertinentes dans le tableau pour un sujet d'expérimentation spécifique. +1. Cliquez sur {{< ui >}}Create Metric SQL Model{{< /ui >}} pour enregistrer votre modèle SQL. + +{{< img src="/product_analytics/experiment/exp_create_metrics_sql_model_structure4.png" alt="Le panneau Structurez votre modèle avec le champ Nom du modèle SQL de métrique défini sur « Revenue Orders » et mis en surbrillance, un bouton bascule Marquer comme certifié, la colonne Horodatage définie sur REVENUE_TIMESTAMP, le Type de sujet défini sur Utilisateur (@usr.id) avec USER_ID sélectionné dans le sélecteur de colonne, un menu déroulant Mesures affichant « Revenue Orders (chaque enregistrement) » et le bouton Créer un modèle SQL de métrique mis en surbrillance." style="width:80%;" >}} + +### Créez une métrique à l'aide de votre modèle SQL {#create-a-metric-using-your-sql-model} + +Une fois votre modèle SQL créé, utilisez-le pour créer une métrique : + +1. Accédez à la [page Métriques][1] dans Datadog Product Analytics. +1. Sélectionnez l'onglet {{< ui >}}Metrics{{< /ui >}} et cliquez sur {{< ui >}}Create Metric{{< /ui >}} dans le coin supérieur droit. +1. Ajoutez un {{< ui >}}Metric name{{< /ui >}} et, éventuellement, un {{< ui >}}Description{{< /ui >}}. +1. Sous la section {{< ui >}}Metric definition{{< /ui >}}, cliquez sur {{< ui >}}Select an event{{< /ui >}} pour ouvrir le sélecteur d'événements. Le graphique sur la droite se met à jour en temps réel à mesure que vous configurez votre métrique. + 1. Sélectionnez le modèle SQL pertinent. Vos modèles SQL apparaissent sous leur source de données (par exemple, **Revenue Orders** sous **Snowflake**). +1. Sélectionnez une [méthode d'agrégation](#aggregation-methods) dans la liste déroulante. +1. (Facultatif) Sous la section {{< ui >}}Additional settings{{< /ui >}} : + 1. Activez {{< ui >}}Mark as certified{{< /ui >}} pour indiquer que cette métrique est approuvée pour une prise de décision importante. Cela nécessite l'autorisation Product Analytics Certified Metrics Write. + 1. Ajustez [{{< ui >}}Experiment settings{{< /ui >}}](#advanced-options) et {{< ui >}}Units{{< /ui >}} selon vos besoins. Les valeurs par défaut conviennent à la plupart des cas d'utilisation. +1. Cliquez sur {{< ui >}}Save{{< /ui >}}. + +{{< img src="/product_analytics/experiment/exp_create_metric_from_sqlmodel_2.png" alt="Le sélecteur d'événements Créer une métrique affichant Tous les événements sélectionnés, avec des types d'événements incluant Snowflake, Actions, Vues, Sessions, Erreurs et Tâches longues sur la gauche, et le modèle SQL Revenue Orders mis en surbrillance sous Snowflake sur la droite, affichant Mesures : montant et Dimensions filtrables : N/A." style="width:80%;" >}} + +[1]: https://app.datadoghq.com/product-analytics/experimentation-metrics +[8]: /fr/experiments/guide/connecting_a_data_warehouse/ +[12]: https://app.datadoghq.com/product-analytics/experiments/settings/subject-types +[13]: /fr/experiments/concepts/sql_template_variables/ + +{{% /tab %}} +{{< /tabs >}} + +## Méthodes d'agrégation {#aggregation-methods} + +Les méthodes d'agrégation déterminent la manière dont Datadog résume les données pour chaque sujet d'expérience. Un sujet d'expérience est l'unité que Datadog randomise pour l'expérience. Il s'agit généralement d'un utilisateur, mais cela peut aussi être une organisation, un cookie ou un appareil, selon la façon dont vous configurez votre expérience. + +Datadog Experiments prend en charge les méthodes d'agrégation suivantes : + +- {{< ui >}}Count of events{{< /ui >}} (par défaut) +- {{< ui >}}Count of unique users{{< /ui >}} (utile pour les métriques de conversion) +- {{< ui >}}Sum of{{< /ui >}} une propriété d'événement (utile pour les métriques de revenus) +- {{< ui >}}Distinct values of{{< /ui >}} une propriété d'événement (utile pour les métriques de pages uniques vues) +- {{< ui >}}Percentile{{< /ui >}} d'une propriété d'événement (utile pour les métriques de latence) +- {{< ui >}}Average of{{< /ui >}} une propriété d'événement (utile pour les métriques de satisfaction) + +{{< img src="/product_analytics/experiment/exp_default_metric_agg_1.png" alt="La liste déroulante des méthodes d'agrégation affiche « Count of unique users » (selected) et « Count of events » en haut, suivie d'une section « SELECT A MEASURE » proposant les options « Sum of », « Distinct values of », « Percentile » et « Average of », avec une description indiquant « The number of users who performed the event » sur la droite." style="width:90%;" >}} + +Datadog calcule des métriques pour chaque sujet d'expérience. Par exemple, une métrique {{< ui >}}Count of events{{< /ui >}} sur une expérience randomisée par utilisateur calcule le nombre total d'événements pour tous les utilisateurs de la variante (groupe d'expérience) divisé par le nombre d'utilisateurs dans cette variante. + +### Métriques de ratio {#ratio-metrics} + +Cliquez sur {{< ui >}}Create Ratio{{< /ui >}} pour diviser votre métrique par une valeur autre que le nombre par défaut de sujets de l'expérience. Le dénominateur peut utiliser l'une des [méthodes d'agrégation](#aggregation-methods). Par exemple, divisez les achats par les pages vues des produits pour mesurer la conversion à une étape spécifique de l'entonnoir, plutôt que sur tous les utilisateurs inscrits. + +Datadog prend en compte les corrélations entre le numérateur et le dénominateur en utilisant la [méthode delta][2]. + +{{< img src="/product_analytics/experiment/exp_create_ratio_new_ui.png" alt="La section de définition de la métrique montrant l'événement « click on ADD TO CART » avec l'agrégation Count of events et une option Add Filter, le bouton Create Ratio mis en surbrillance ci-dessous, ainsi que la section Additional settings avec le bouton bascule Mark as certified, Experiment settings et Units." style="width:90%;" >}} + +## Options avancées {#advanced-options} + +Datadog Experiments prend en charge les options avancées suivantes. Celles-ci peuvent être modifiées sous {{< ui >}}Additional settings{{< /ui >}} > {{< ui >}}Experiment settings{{< /ui >}} lors de la création d'une métrique. + +Filtres de période +: Par défaut, Datadog inclut tous les événements entre la première exposition d'un utilisateur et la fin de l'expérience. Utilisez ce paramètre pour mesurer une valeur limitée dans le temps, telle que « sessions within 7 days ». Si vous ajoutez un filtre de période, la métrique inclut uniquement les événements de la fenêtre temporelle spécifiée, à partir du moment où l'utilisateur est inscrit pour la première fois à l'expérience. + +Direction souhaitée de la métrique +: Datadog met en évidence les résultats statistiquement significatifs. Utilisez ce paramètre pour spécifier si vous souhaitez que cette métrique augmente ou diminue. + +Gestion des singularités +: Les données réelles incluent souvent des singularités extrêmes qui peuvent avoir un impact sur les résultats de l'expérience. Utilisez ce paramètre pour définir un seuil auquel Datadog tronque les données. Par exemple, définissez une limite supérieure de 99 % pour tronquer tous les résultats au 99e percentile de la métrique. + +## Pour aller plus loin {#further-reading} +{{< partial name="whats-next/whats-next.html" >}} + +[2]: https://en.wikipedia.org/wiki/Delta_method \ No newline at end of file diff --git a/hugo/content/fr/getting_started/application/_index.md b/hugo/content/fr/getting_started/application/_index.md index ff693bfa8d6..d056652658f 100644 --- a/hugo/content/fr/getting_started/application/_index.md +++ b/hugo/content/fr/getting_started/application/_index.md @@ -1,176 +1,177 @@ --- +description: Présentation de la navigation dans l'interface utilisateur de Datadog, + des fonctionnalités clés, notamment les tableaux de bord, les monitors, les intégrations + et les capacités principales de la plateforme. further_reading: -- link: https://learn.datadoghq.com/courses/dd-101-dev +- link: https://learn.datadoghq.com/bundles/frontend-engineer-learning-path tag: Centre d'apprentissage - text: 'Datadog 101 : Développeur' -- link: https://learn.datadoghq.com/courses/dd-101-sre + text: Parcours d'apprentissage pour ingénieur frontend +- link: https://learn.datadoghq.com/bundles/backend-engineer-learning-path tag: Centre d'apprentissage - text: 'Datadog 101 : Ingénieur en fiabilité de site' + text: Parcours d'apprentissage pour ingénieur backend +- link: https://learn.datadoghq.com/bundles/site-reliability-engineer-learning-path + tag: Centre d'apprentissage + text: Parcours d'apprentissage pour ingénieurs en fiabilité des sites (SRE). - link: https://dtdg.co/fe tag: Validation des bases text: Participer à une session interactive pour comprendre les principes fondamentaux de Datadog - link: https://www.datadoghq.com/blog/datadog-quick-nav-menu/ - tag: GitHub - text: Présentation du menu de navigation rapide Datadog -- link: https://www.datadoghq.com/blog/engineering/druids-the-design-system-that-powers-datadog/ tag: Blog - text: 'DRUIDS : l''acronyme qui définit la conception chez Datadog' + text: Présentation du menu de navigation rapide Datadog title: Débuter avec Datadog --- +{{< learning-center-callout header="Essayez les compétences fondamentales de Datadog dans le centre d'apprentissage" btn_title="Inscrivez-vous maintenant" btn_url="https://learn.datadoghq.com/bundles/core-skills-learning-path">}} + Apprenez gratuitement sur une capacité de calcul cloud réelle et un compte d'essai Datadog. Démarrez ces laboratoires pratiques pour vous familiariser avec les tags, les métriques, les Monitors et les tableaux de bord. +{{< /learning-center-callout >}} -## Présentation +## Présentation {#overview} Cette page fournit un aperçu général des fonctionnalités disponibles sur le [site Datadog][1]. -La navigation du site Datadog varie en fonction de la largeur de votre navigateur. Il existe trois types de navigations. Pour changer de type de navigation, ajustez la taille de votre navigateur. - -## Intégrations - -{{< img src="getting_started/integrations.png" alt="Intégrations" >}} - -- Datadog dispose de plus de {{< translate key="integration_count" >}} intégrations officielles [répertoriées][2]. -- Des intégrations personnalisées sont disponibles via [l'API Datadog][3]. -- L'Agent est [open source][4]. -- Une fois les intégrations configurées, toutes les données sont traitées de la même façon sur Datadog, qu'elles soient stockées dans un centre de données ou dans un service en ligne. - -## Log Management - -{{< img src="getting_started/logs.png" alt="Logs" >}} +
+ La navigation sur le site Datadog varie en fonction de la largeur de votre navigateur. Vous pouvez avoir jusqu'à trois types de navigation. Pour changer de type de navigation, modifiez la largeur de votre navigateur. +

+ Vous pouvez appuyer sur Cmd/Ctrl + K pour rechercher des pages et des entités, comme des tableaux de bord et des monitors, dans tout Datadog. +
-La solution [Log Management][5] de Datadog vous permet d'envoyer et de traiter chaque log généré par vos applications et votre infrastructure. Vous pouvez visualiser vos logs en temps réel à l'aide de la fonction Live Tail, sans avoir à les indexer. Il est possible d'ingérer tous les logs provenant de vos applications et de votre infrastructure, d'utiliser des filtres pour déterminer de façon dynamique les logs à indexer, puis de les stocker dans une archive. +## Infrastructure {#infrastructure} -## APM et profileur en continu +La [liste d'infrastructure][2] sert de vue centrale pour toutes vos ressources d'infrastructure (hôtes, conteneurs, processus, etc.) et leurs métadonnées associées. -{{< img src="getting_started/apm.png" alt="Dashboard APM" >}} +**Fonctionnalités clés :** -La solution [Application Performance Monitoring de Datadog][6] (appelée APM ou tracing) vous fournit des informations précises sur les performances de votre application, grâce aux dashboards générés automatiquement qui surveillent des métriques clés, comme le volume et la latence des requêtes, ou encore aux traces détaillées portant sur des requêtes individuelles. Ces données viennent compléter vos logs et la surveillance de votre infrastructure. Lorsqu'une requête est envoyée à une application, Datadog peut surveiller les traces associées au sein d'un système distribué et générer des données sur ce qu'il advient de cette requête. +- Étudiez les performances de l'infrastructure. +- Organisez, filtrez et visualisez les hôtes en fonction des tags et des métriques. +- Inspectez les hôtes pour examiner leurs tags, leurs performances, leur état de santé, et plus encore. -## Infrastructure +Accédez à [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Hosts{{< /ui >}}][3] dans l'application pour commencer. Pour en savoir plus, lisez la [documentation sur la liste d'infrastructure][2]. -{{< img src="getting_started/infrastructure.png" alt="Infrastructure" >}} +## Hostmaps et cartes de conteneurs {#host-and-container-maps} -- Toutes les machines apparaissent dans la [liste d'infrastructures][7]. -- Vous pouvez consulter les tags appliqués à chaque machine. Les fonctions de tagging vous permettent d'attribuer un rôle précis à vos machines. -- Datadog attribue automatiquement une catégorie à vos serveurs. Si un tag a été ajouté à une nouvelle machine, vous pouvez consulter immédiatement les statistiques liées à cette dernière en fonction de ce qui a précédemment été configuré pour ce tag. [En savoir plus sur le tagging][8]. +{{< img src="getting_started/application/host_map_2025.png" alt="Présentation de la hostmap avec regroupement par zone de disponibilité." >}} -## Hostmap +Les [hostmaps et cartes de conteneurs][4] vous offrent une vue d'ensemble visuelle de tous vos hôtes et conteneurs, en utilisant un code couleur basé sur des métriques clés comme l'utilisation du processeur afin que vous puissiez identifier les problèmes. -{{< img src="getting_started/hostmap-overview.png" alt="Aperçu de la hostmap" >}} +**Fonctionnalités clés** : -[La hostmap][9] se trouve dans le menu Infrastructure. Grâce à cette carte, vous pouvez : +- Visualisez l'ensemble de votre infrastructure en une seule fois sous forme de carte. +- Utilisez un code couleur basé sur diverses métriques pour repérer les problèmes de performance, et filtrez ou regroupez par tags et métadonnées. +- Approfondissez l'analyse au niveau de chaque hôte ou conteneur pour résoudre les problèmes. -- Visualiser rapidement votre environnement -- Identifier les singularités -- Détecter les modèles d'utilisation -- Optimiser les ressources +Accédez à [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Host Map{{< /ui >}}][5] dans l'application pour commencer. Pour en savoir plus, consultez la [documentation sur les cartes d'hôtes et de conteneurs][4]. -Consultez la section [Hostmap][9] pour en savoir plus. +## Log Management {#log-management} -## Événements +[Datadog Log Management][6] vous permet d'envoyer et de traiter tous les logs produits par vos applications et votre infrastructure. Vous pouvez observer vos logs en temps réel grâce au [Live Tail][7], sans avoir à les indexer. -{{< img src="events/explorer/events-overview.png" alt="Events Explorer" style="width:100%;" >}} +**Fonctionnalités clés** : -La vue [Events Explorer][10] affiche les événements les plus récents générés par votre infrastructure et vos services. +- Collectez automatiquement les logs de tous les services, applications et plateformes. +- Visualisez et recherchez les logs en temps réel et filtrez-les par service, hôte et type d'erreur. +- Choisissez les logs à conserver et pour combien de temps, afin de réduire les coûts de stockage. -Des événements peuvent être générés pour : +Accédez à [{{< ui >}}Logs{{< /ui >}}][8] dans l'application pour commencer. Pour en savoir plus, consultez la [documentation sur Log Management][6]. -- Les déploiements de code -- Les modifications du statut de santé de vos services -- Les changements de configuration -- Les alertes de surveillance +## APM {#apm} -L'Events Explorer rassemble automatiquement les événements recueillis par l'Agent et les intégrations installées. +[Datadog Application Performance Monitoring][9] (APM ou tracing) vous offre une visibilité approfondie sur les performances de votre application, parallèlement à vos logs et à la surveillance de votre infrastructure. -Vous pouvez également envoyer vos propres événements personnalisés à l'aide de l'API Datadog, des checks d'Agent custom, de DogStatsD ou de l'API d'e-mail pour les événements. +**Fonctionnalités clés** : -Dans l'Events Explorer, vous pouvez filtrer vos événements en fonction de facettes ou de requêtes de recherche. Il est également possible de regrouper ou de filtrer les événements par attribut, et de les représenter graphiquement avec des [analyses d'événements][11]. +- Tracez les requêtes adressées à une application de bout en bout à travers un système distribué. +- Identifiez les goulots d'étranglement en visualisant le temps passé à chaque étape de la requête. +- Visualisez les dépendances entre services et les flux de données avec la Service Map. +- Corrélez les traces avec les logs, les métriques et les sessions utilisateur correspondants pour obtenir un contexte full-stack. -## Dashboards +Accédez à [{{< ui >}}APM{{< /ui >}}][10] dans l'application pour commencer. Pour en savoir plus, lisez la [documentation sur l'APM][9]. -{{< img src="getting_started/dashboard.png" alt="Dashboards" >}} +## RUM & Session Replay {#rum-session-replay} -Les [dashboards][12] contiennent des graphiques avec des métriques enregistrant des performances en temps réel. +Datadog [Real User Monitoring][11] (RUM) vous permet de visualiser et d'analyser les activités et expériences réelles des utilisateurs sur les applications web et mobiles. Avec [Session Replay][12], vous pouvez capturer et visualiser les sessions utilisateur pour mieux comprendre leur comportement. -- Déplacez simultanément votre curseur sur l'ensemble des graphiques d'un [screenboard][13]. -- Les barres verticales correspondent à des événements. Elles permettent de placer une métrique dans son contexte. -- Cliquez sur un graphique et faites-le glisser pour étudier un intervalle spécifique. -- Lorsque vous passez le curseur sur le graphique, le flux d'événements se déplace avec vous. -- Affichez l'utilisation par zone, par host ou globale. -- Datadog met à votre disposition l'éditeur JSON du graphique afin d'appliquer [des opérations arithmétiques][14] et des [fonctions][15] aux métriques. -- Partagez un snapshot de graphique qui apparaît dans le flux d'événements. -- Les graphiques peuvent être intégrés à un iframe. Cela permet à un tiers d'accéder au graphique en direct sans qu'il puisse accéder à vos données ou à toute autre information. +**Fonctionnalités clés** : +- Surveillez les performances sur les navigateurs web et les plateformes mobiles (iOS, Android, React Native, Flutter, et plus) avec Core Web Vitals et Mobile Vitals. +- Suivez et dépannez les erreurs grâce au regroupement automatisé, au rapport de plantage et à l'identification des commits suspects. +- Détectez les signaux de frustration des utilisateurs tels que les clics de rage et les clics d'erreur pour identifier les problèmes d'UX. +- Surveillez les performances et l'adoption des feature flags. +- Corrélez les problèmes frontend avec les traces backend, les logs et les métriques d'infrastructure pour une visibilité full-stack. -## Monitors +Accédez à [{{< ui >}}RUM explorer{{< /ui >}}][13] dans l'application pour commencer. Pour en savoir plus, lisez la [documentation RUM][11]. -Les [monitors][16] fournissent des alertes et notifications basées sur des seuils de métriques, la disponibilité des intégrations, des endpoints réseau, et bien plus encore. +## Synthetic Monitoring {#synthetic-monitoring} -- Utilisez n'importe quelle métrique transmise à Datadog. -- Configurez des alertes multiples en fonction d'un appareil, d'un host, etc. -- Utilisez la syntaxe `@` dans les messages d'alerte pour acheminer les notifications vers les bonnes personnes. -- Planifiez des downtimes pour interrompre l'envoi de notifications en cas d'arrêts système, de maintenance hors ligne, etc. +Datadog [Synthetic Monitoring][14] vous permet de créer et d'exécuter des tests d'API, de navigateur, mobiles et Network Path qui surveillent de manière proactive les requêtes et actions simulées à travers le monde. Ces tests surveillent vos applications et API pour détecter les problèmes de performance et les temps d'arrêt avant qu'ils n'affectent les utilisateurs. -{{< img src="getting_started/application/metric_monitor.png" alt="Configuration d'une alerte" >}} +**Fonctionnalités clés** : -## Network Performance Monitoring +- Testez les endpoints d'API et les parcours utilisateur critiques pour l'entreprise. +- Détectez les erreurs, identifiez les régressions et automatisez les rollbacks afin d'empêcher l'apparition des problèmes en production. +- Identifiez les problèmes de performance affectant les utilisateurs dans divers emplacements et déclenchez des alertes. -{{< img src="getting_started/npm.png" alt="NPM" >}} +Accédez à [{{< ui >}}Synthetic Monitoring & Testing{{< /ui >}}][15] dans l'application pour commencer. Pour en savoir plus, lisez la [documentation sur le Synthetic Monitoring][14]. -La solution [Network Performance Monitoring][17] (NPM) de Datadog vous permet de visualiser votre trafic réseau sur n'importe quel objet tagué dans Datadog : conteneurs, hosts, services ou encore zones de disponibilité. Vous pouvez utiliser n'importe quel élément, que ce soit des datacenters, des équipes ou des conteneurs spécifiques, pour regrouper vos données. Les tags vous aident à filtrer le trafic en fonction de la source et de la destination. Les filtres agrègent ensuite les données sous la forme de flux, qui représentent chacun le trafic entre une source et une destination, via une page et une Network Map personnalisables. Chaque flux contient des métriques réseau, telles que le débit, la bande passante, le nombre de retransmissions et les informations sur la source/destination, avec des détails pouvant aller jusqu'à l'adresse IP, le port et le PID. Les flux renvoient ensuite des métriques clés, telles que le volume du trafic et les retransmissions TCP. +## Intégrations {#integrations} -## RUM et Session Replay +Utilisez les {{< translate key="integration_count" >}} [integrations][16] de Datadog pour rassembler toutes les métriques et les logs de votre infrastructure et obtenir des informations sur l'ensemble de votre système d'observabilité. -{{< img src="getting_started/rum.png" alt="RUM" >}} +{{< img src="getting_started/application/integrations-2025.png" alt="Integrations" >}} -La solution [Real User Monitoring][18] (RUM) de Datadog vous permet de visualiser et d'analyser les activités et les expériences de vos utilisateurs en temps réel. Grâce à la fonctionnalité [Session Replay][19], il est possible de capturer et de visualiser les sessions de navigation de vos utilisateurs, afin de mieux comprendre leur comportement. Vous pouvez non seulement consulter dans le RUM Explorer les durées de chargement, les erreurs frontend et les dépendances de page, mais également mettre en corrélation les métriques métier et les métriques d'application. Cette approche vous permet de bénéficier d'un unique dashboard comportant vos métriques d'application, d'infrastructure et métier, afin de résoudre plus facilement vos problèmes. +**Fonctionnalités clés** : -## Sans serveur +- Les intégrations disponibles couvrent les technologies cloud, la réponse aux incidents, les couches de données, la sécurité, l'IA, et plus encore. +- Une fois les intégrations configurées, toutes les données sont traitées de la même manière dans Datadog, qu'elles résident dans un centre de données ou dans un service en ligne. +- Créez votre propre intégration en utilisant la [documentation développeur][17]. -L'[informatique sans serveur][20] consiste à écrire du code orienté événement et à l'importer dans un fournisseur de cloud afin qu'il gère toutes les ressources de calcul sous-jacentes. Les fonctionnalités sans serveur Datadog regroupent en une unique vue les métriques, traces et logs de vos fonctions AWS Lambda qui exécutent des applications sans serveur. Vous pouvez ainsi optimiser vos performances en filtrant les fonctions caractérisées par des erreurs, une forte latence ou des démarrages à froid. +Accédez à [{{< ui >}}Integrations{{< /ui >}}][18] dans l'application pour commencer, ou parcourez la liste des intégrations dans la [documentation][19]. -## Cloud SIEM +## Dashboards {#dashboards} -{{< img src="getting_started/security.png" alt="security" >}} +[Dashboards][20] contiennent des graphiques avec des métriques de performance en temps réel, unifiant votre vue des données à travers les métriques, les logs, les traces, et plus encore. -La solution [Cloud SIEM][21] (Security Information and Event Management) de Datadog détecte automatiquement les menaces concernant votre application ou votre infrastructure. Il peut par exemple s'agir d'une attaque ciblée, d'une adresse IP communiquant avec vos systèmes alors qu'elle fait partie d'une liste noire, ou d'une configuration non sécurisée. Ces menaces sont affichées dans Datadog sous forme de signaux de sécurité et peuvent être mises en corrélation et triées dans le Security Signals Explorer. +**Fonctionnalités clés** : -## Surveillance Synthetic +- Commencez avec des tableaux de bord prêts à l'emploi ou créez les vôtres pour répondre à vos questions spécifiques. +- Personnalisez les tableaux de bord avec des widgets par glisser-déposer, des requêtes personnalisées et des mises en page flexibles. +- Combinez plusieurs types de données (y compris les métriques, les logs, l'APM et le RUM) en un seul endroit et visualisez les données en temps réel. +- Annotez vos graphiques avec des commentaires ou des événements pour le contexte de votre équipe. -{{< img src="getting_started/synthetics.png" alt="Synthetics" >}} +Accédez à [{{< ui >}}Dashboard List{{< /ui >}}][21] dans l'application pour commencer. Pour en savoir plus, lisez la [documentation sur les Dashboards][20]. -La [surveillance Synthetic][22] Datadog vous permet de créer et d'exécuter des tests API et Browser afin de simuler de façon proactive les transactions de vos utilisateurs sur vos applications, mais également de surveiller tous les endpoints réseau internes et externes sur l'ensemble des couches de votre système. Vous pouvez ainsi détecter les erreurs, identifier les régressions et automatiser les rollbacks afin d'empêcher tout problème de se manifester dans les environnements de production. +## Monitors {#monitors} -## Version mobile de Datadog +[Monitors][22] fournissent des alertes et des notifications basées sur des seuils de métriques, la disponibilité des intégrations, les endpoints réseau, et plus encore. -L'[application mobile Datadog][23] est disponible dans [l'App Store d'Apple][24] et dans le [Google Play Store][25]. Elle permet aux ingénieurs en service et aux utilisateurs métier de surveiller la santé de leurs services et de trier rapidement leurs problèmes sans utiliser d'ordinateur. Vous pouvez ainsi accéder aux dashboards, monitors, incidents ou encore SLO de votre organisation directement depuis votre appareil mobile. +- Créez des monitors en utilisant n'importe quelle métrique rapportée à Datadog. +- Créez une logique d'alerte complexe en utilisant plusieurs conditions de déclenchement. +- Envoyez des alertes vers Slack, par e-mail, PagerDuty et plus encore, en ajoutant`@` dans les messages d'alerte pour diriger les notifications vers les bonnes personnes. +- Planifiez des périodes d'indisponibilité pour suspendre les notifications lors des arrêts du système, de la maintenance hors ligne, et bien plus encore. -{{< img src="getting_started/application/mobile-app-store-screens.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Application mobile sous iOS">}} +Accédez à [{{< ui >}}Monitors List{{< /ui >}}][23] dans l'application pour commencer. Pour en savoir plus, lisez la [documentation sur les monitors][22]. -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: https://app.datadoghq.com -[2]: http://www.datadoghq.com/integrations -[3]: /fr/api/ -[4]: https://github.com/DataDog/datadog-agent -[5]: /fr/logs/ -[6]: /fr/tracing/ -[7]: /fr/infrastructure/ -[8]: /fr/getting_started/tagging/ -[9]: /fr/infrastructure/hostmap/ -[10]: /fr/events/ -[11]: /fr/events/explorer/analytics -[12]: /fr/dashboards/ -[13]: /fr/dashboards/#screenboards -[14]: /fr/dashboards/functions/arithmetic/ -[15]: /fr/dashboards/functions/ -[16]: /fr/monitors/ -[17]: /fr/network_monitoring/performance/ -[18]: /fr/real_user_monitoring/ -[19]: /fr/real_user_monitoring/session_replay/ -[20]: /fr/serverless -[21]: /fr/security/cloud_siem/ -[22]: /fr/synthetics/ -[23]: /fr/service_management/mobile/ -[24]: https://apps.apple.com/app/datadog/id1391380318 -[25]: https://play.google.com/store/apps/details?id=com.datadog.app \ No newline at end of file +[2]: /fr/infrastructure/list/ +[3]: https://app.datadoghq.com/infrastructure +[4]: /fr/infrastructure/hostmap/ +[5]: https://app.datadoghq.com/infrastructure/map +[6]: /fr/logs/ +[7]: /fr/logs/explorer/live_tail/ +[8]: https://app.datadoghq.com/logs +[9]: /fr/tracing/ +[10]: https://app.datadoghq.com/apm/home +[11]: /fr/real_user_monitoring/ +[12]: /fr/session_replay/ +[13]: https://app.datadoghq.com/rum/sessions +[14]: /fr/synthetics/ +[15]: https://app.datadoghq.com/synthetics/tests +[16]: https://www.datadoghq.com/product/platform/integrations/ +[17]: /fr/extend/integrations/ +[18]: https://app.datadoghq.com/integrations +[19]: /fr/integrations/ +[20]: /fr/dashboards/ +[21]: https://app.datadoghq.com/dashboard/lists +[22]: /fr/monitors/ +[23]: https://app.datadoghq.com/monitors/manage \ No newline at end of file diff --git a/hugo/content/fr/getting_started/code_security/_index.md b/hugo/content/fr/getting_started/code_security/_index.md new file mode 100644 index 00000000000..8259ff0b6d3 --- /dev/null +++ b/hugo/content/fr/getting_started/code_security/_index.md @@ -0,0 +1,163 @@ +--- +aliases: +- /fr/getting_started/code_analysis/ +description: Sécurisez vos applications avec des outils SAST, SCA et IAST pour détecter + les vulnérabilités dans le code de première partie et les bibliothèques open source. +further_reading: +- link: https://learn.datadoghq.com/courses/code-security-SAST + tag: Centre d'apprentissage + text: Écrivez du code sécurisé avec Datadog Code Security +title: Prise en main de Code Security +--- +## Présentation {#overview} + +Datadog Code Security vous aide à sécuriser et à maintenir le code de première partie et les bibliothèques open source de vos applications, du développement à la production. + +Il propose une suite d'outils pour vous aider à sécuriser votre code tout au long du cycle de vie du développement logiciel : + +- **Static Code Analysis (SAST)** utilise une méthode Static Application Security Testing pour analyser vos dépôts à la recherche de problèmes de sécurité et de qualité dans le code de première partie, en fournissant des suggestions de correctifs pour empêcher ces problèmes d'atteindre la production. +- **Software Composition Analysis (SCA)** détecte les bibliothèques open source vulnérables présentes dans vos dépôts et affectant vos services lors de l'exécution, vous aidant ainsi à sécuriser et à maintenir votre chaîne d'approvisionnement logicielle. +- **Runtime Code Analysis (IAST)** utilise une méthode Interactive Application Security Testing pour détecter les vulnérabilités affectant vos services lors de l'exécution. + +## Configurer Code Security {#set-up-code-security} + +### Bibliothèques open source {#open-source-libraries} + +Datadog Software Composition Analysis détecte les vulnérabilités des bibliothèques et répertorie les dépendances au sein de votre base de code et de vos services en cours d'exécution. + +Consultez [Software Composition Analysis][1] pour configurer la détection des vulnérabilités des bibliothèques de manière statique et/ou lors de l'exécution. + +### Code de première partie {#first-party-code} + +{{< whatsnext desc="Il existe deux façons de sécuriser et de maintenir votre code de première partie avec Datadog :">}} + {{< nextlink href="security/code_security/static_analysis/setup/" >}}Configuration de Static Code Analysis (SAST){{< /nextlink >}} + {{< nextlink href="security/code_security/iast/setup/" >}}Configuration de Runtime Code Analysis (IAST){{< /nextlink >}} +{{< /whatsnext >}} + +## Intégrations d'outils de développement {#developer-tool-integrations} + +### Activer les commentaires sur les pull requests {#enable-pull-request-comments} + +Datadog peut agir comme un réviseur de code automatique pour signaler les vulnérabilités et les violations de qualité dans les pull requests GitHub. Pour plus d'informations, consultez [GitHub Pull Requests][2]. + +{{< img src="/security/application_security/code_security/github_suggestion.png" alt="Revue de code Datadog dans GitHub" style="width:100%;" >}} + +### Installez les intégrations IDE {#install-ide-integrations} + +Installez les [plugins IDE Datadog][5] pour identifier les problèmes de sécurité du code directement dans votre éditeur de code. Selon votre IDE, les plugins prennent en charge les fonctionnalités suivantes : + +- Static Code Analysis (SAST) +- Software Composition Analysis (SCA) +- Runtime Code Analysis (IAST) +- Secret Scanning +- Infrastructure as Code (IaC) Scanning + +{{< whatsnext desc="Pour les instructions de configuration et les détails sur les fonctionnalités prises en charge, consultez la documentation de votre éditeur de code préféré :">}} + {{< nextlink href="ide_plugins/idea/code_security/" >}}IDE JetBrains : IntelliJ IDEA, GoLand, PyCharm, RubyMine, WebStorm et PhpStorm{{< /nextlink >}} + {{< nextlink href="ide_plugins/vscode/code_security/" >}}Visual Studio Code & Cursor{{< /nextlink >}} +{{< /whatsnext >}} + +### Personnalisez les paramètres de votre dépôt {#customize-your-repository-settings} +Dans les [paramètres de Code Security][3], vous pouvez gérer les dépôts pour lesquels les commentaires de PR sont activés, ainsi que [personnaliser la configuration][11] des règles de Static Code Analysis (SAST) appliquées à travers ou au sein des dépôts. Pour toutes les règles par défaut fournies par Datadog, consultez les [Règles SAST][4]. + +### Configurez les portes de PR {#set-up-pr-gates} + +Datadog fournit des [Portes de PR][6] en tant que fonctionnalité de plateforme pour vous aider à maintenir et à appliquer des normes de sécurité et de qualité pour les modifications apportées à votre base de code. Pour plus d'informations, consultez la [configuration des portes de PR][7]. + +## Priorisez les vulnérabilités avec le contexte d'exécution {#prioritize-vulnerabilities-with-runtime-context} + +Code Security offre des **vues centrées sur les vulnérabilités** de toutes les vulnérabilités dans les bibliothèques et le code détectées à la fois par l'analyse statique des dépôts et par la détection des services en cours d'exécution. + +### Explorez les vulnérabilités {#explore-vulnerabilities} + +Pour les vulnérabilités de bibliothèque, chaque ligne du tableau représente une vulnérabilité spécifique affectant une version de bibliothèque. Selon que vous avez activé la détection statique ou au moment de l'exécution, la colonne {{< ui >}}Detected In{{< /ui >}} affiche les dépôts et/ou services spécifiques affectés par cette vulnérabilité. + +Dans le panneau latéral pour une vulnérabilité de bibliothèque unique dans SCA, en plus des détails sur la vulnérabilité, Datadog affiche : + +- Un {{< ui >}}Severity breakdown{{< /ui >}} de l'instance de plus haute gravité de cette vulnérabilité observée dans vos dépôts et vos services. Pour chaque emplacement détecté de la vulnérabilité dans vos dépôts et/ou services, Datadog ajuste le score de gravité de base de la vulnérabilité en fonction de facteurs environnementaux. Pour en savoir plus, consultez [Score de gravité Datadog][8]. +- Un {{< ui >}}Repositories{{< /ui >}} tableau de toutes les instances où la vulnérabilité a été détectée dans vos dépôts. Pour chaque instance, Datadog indique si la dépendance est classée comme directe ou transitive, le statut de remédiation de la vulnérabilité, ainsi que les étapes de remédiation spécifiques. +- Un {{< ui >}}Impacted Services{{< /ui >}} tableau de tous les services en cours d'exécution affectés par cette vulnérabilité de bibliothèque. Un service est affecté par une vulnérabilité de bibliothèque si la bibliothèque a été chargée au moment de l'exécution et détectée par les SDK d'application de Datadog. + + Les niveaux de gravité sont évalués comme suit : +| Score CVSS | Évaluation qualitative +| --------------| -------------------| +| `0.0` | Aucun | +| `0.1 - 3.9` | Faible | +| `4.0 - 6.9` | Moyen | +| `7.0 - 8.9` | Élevé | +| `9.0 - 10.0` | Critique | + +### Explorer les résultats par dépôt {#explore-results-per-repository} + +Code Security propose également des **vues centrées sur les dépôts** des résultats d'analyse statique, prenant en charge un filtrage granulaire sur toutes les branches et tous les commits pour les dépôts analysés. + +Cliquez sur un dépôt sur la page {{< ui >}}Repositories{{< /ui >}} pour accéder à une vue plus détaillée où vous pouvez personnaliser la requête de recherche par branche (la branche par défaut apparaissant en premier) et par commit (en commençant par le plus récent). + +{{< tabs >}} +{{% tab "Static Code Analysis (SAST)" %}} + +Vous pouvez utiliser les facettes prêtes à l'emploi suivantes pour créer une requête de recherche afin d'identifier et de résoudre les mauvaises pratiques de codage dans l'onglet {{< ui >}}Code Quality{{< /ui >}} ou les risques de sécurité dans l'onglet {{< ui >}}Code Vulnerabilities{{< /ui >}}. + +| Nom de la facette | Description | +|-----------------------------------|-------------------------------------------------------------------------| +| État du résultat | Filtre les résultats en fonction de l'état d'achèvement de l'analyse. | +| ID de la règle | Règles spécifiques ayant déclenché les résultats. | +| Nom de l'outil | Détermine quels outils ont contribué à l'analyse. | +| CWE (Common Weakness Enumeration) | Filtre les résultats par catégories de vulnérabilités reconnues. | +| Correctifs disponibles | Filtre les problèmes pour lesquels des correctifs suggérés sont disponibles. | +| Message de résultat | Contient des descriptions ou des messages concis associés aux résultats. | +| Description de la règle | Contient la justification de chaque règle. | +| Fichier source | Contient les fichiers où des problèmes ont été détectés. | +| Version de l'outil | Filtre les résultats par la version des outils utilisés. | + +Vous pouvez accéder aux correctifs suggérés directement depuis les résultats pour remédier aux vulnérabilités de sécurité ou améliorer les pratiques de qualité du code. + +{{< img src="/getting_started/code_analysis/suggested_fix.png" alt="Un correctif de code suggéré sur l'onglet Correctifs d'un résultat d'analyse de code" style="width:100%" >}} + +{{% /tab %}} +{{% tab "Software Composition Analysis" %}} + +Vous pouvez utiliser les facettes prêtes à l'emploi suivantes pour créer une requête de recherche afin d'identifier et de traiter les risques de sécurité dans les bibliothèques tierces dans l'onglet {{< ui >}}Library Vulnerabilities{{< /ui >}} ou pour examiner votre inventaire de bibliothèques dans l'onglet {{< ui >}}Library Catalog{{< /ui >}}. + +| Nom de la facette | Description | +|--------------------|----------------------------------------------------------------| +| Nom de la dépendance | Identifie les bibliothèques par leur nom. | +| Version de la dépendance | Filtre par versions spécifiques de bibliothèques. | +| Langage | Trie les bibliothèques par langage de programmation. | +| Score | Trie le score de risque ou de qualité des dépendances. | +| Gravité | Filtre les vulnérabilités en fonction de leur niveau de gravité. | +| Plateforme | Distingue les bibliothèques selon la plateforme à laquelle elles sont destinées. | + +Vous pouvez accéder aux rapports de vulnérabilité et localiser les fichiers sources où la vulnérabilité a été découverte dans vos projets, ainsi que des informations sur les propriétaires du code du fichier. + +{{< img src="/security/application_security/code_security/sci_vulnerabilities.png" alt="Un lien vers le code source directement dans GitHub à partir d'une vulnérabilité de bibliothèque détectée" style="width:100%" >}} + +{{% /tab %}} +{{< /tabs >}} + +## Notifier, corriger et signaler {#notify-remediate-and-report} + +Code Security vous aide à configurer des workflows pour suivre et gérer la correction des résultats : + +- Configurez des [règles de notification][9] pour informer votre ou vos équipes des nouveaux résultats via Slack, Jira, e‑mail, et plus encore +- Suivez les vulnérabilités par service et par équipe sur la page {{< ui >}}Code Security Summary{{< /ui >}}. + +## Liez les résultats aux services et équipes Datadog {#link-findings-to-datadog-services-and-teams} + +{{% security-products/link-findings-to-datadog-services-and-teams %}} + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/code_security/software_composition_analysis/ +[2]: /fr/security/code_security/dev_tool_int/github_pull_requests/ +[3]: https://app.datadoghq.com/security/configuration/code-security/setup +[4]: /fr/security/code_security/static_analysis/static_analysis_rules/ +[5]: /fr/security/code_security/dev_tool_int/ide_plugins/ +[6]: /fr/pr_gates/ +[7]: /fr/pr_gates/setup +[8]: /fr/security/code_security/software_composition_analysis/#datadog-severity-score +[9]: https://app.datadoghq.com/security/configuration/notification-rules +[10]: /fr/account_management/teams/ +[11]: /fr/security/code_security/static_analysis/setup/#customize-your-configuration \ No newline at end of file diff --git a/hugo/content/fr/getting_started/integrations/aws.md b/hugo/content/fr/getting_started/integrations/aws.md index be900a9de84..bd62ee7d9d6 100644 --- a/hugo/content/fr/getting_started/integrations/aws.md +++ b/hugo/content/fr/getting_started/integrations/aws.md @@ -1,8 +1,11 @@ --- -description: Intégrez votre compte Amazon Web Services avec Datadog en utilisant CloudFormation. - Configurez les rôles IAM, activez les intégrations de services et configurez le - transfert de journaux. +description: Intégrez votre compte Amazon Web Services à Datadog en utilisant CloudFormation. + Configurez les rôles IAM, activez les intégrations de services et paramétrez le + transfert de logs. further_reading: +- link: https://www.datadoghq.com/architecture/a-guide-to-integrating-100-aws-accounts-with-datadog/ + tag: Architecture Center + text: Guide pour intégrer plus de 100 comptes AWS avec Datadog - link: https://www.datadoghq.com/blog/aws-monitoring/ tag: Blog text: Métriques clés pour la surveillance AWS @@ -17,7 +20,7 @@ further_reading: text: Implémenter la surveillance en tant que code avec Datadog et le registre CloudFormation - link: https://www.datadoghq.com/blog/datadog-serverless-view/ tag: Blog - text: Surveiller toute votre pile sans serveur avec la vue Serverless + text: Surveiller toute votre pile serverless avec la vue Serverless - link: https://www.datadoghq.com/blog/monitor-aws-fargate/ tag: Blog text: Surveiller des applications ECS sur AWS Fargate avec Datadog @@ -30,17 +33,20 @@ further_reading: - link: https://www.datadoghq.com/blog/monitor-aws-graviton3-with-datadog/ tag: Blog text: Surveiller vos instances EC2 basées sur Graviton3 avec Datadog +- link: https://learn.datadoghq.com/courses/getting-started-with-the-datadog-aws-integration + tag: Centre d'apprentissage + text: Bien démarrer avec l'intégration AWS de Datadog title: Débuter avec AWS --- -## Aperçu {#overview} +## Présentation {#overview} -Ce guide vous accompagne dans l'intégration d'un compte Amazon Web Services (AWS) avec Datadog en utilisant le modèle CloudFormation de Datadog. Après avoir terminé la configuration, vous pouvez activer des intégrations de services AWS individuelles, installer l'agent Datadog sur des instances EC2 pour une visibilité approfondie et configurer le transfert de journaux. +Ce guide vous accompagne dans l'intégration d'un compte Amazon Web Services (AWS) à Datadog à l'aide du modèle CloudFormation de Datadog. Une fois la configuration terminée, vous pouvez activer des intégrations de services AWS individuels, installer Datadog Agent sur des instances EC2 pour une visibilité accrue et configurer le transfert de logs. ## Prérequis {#prerequisites} -Avant de commencer, assurez-vous de disposer d'un compte [AWS][7]. Le modèle CloudFormation crée un rôle IAM et une politique associée, permettant au compte AWS de Datadog d'effectuer des appels API à votre compte AWS pour collecter et transmettre des données. Votre utilisateur AWS doit disposer des autorisations IAM suivantes pour exécuter le modèle : +Avant de commencer, assurez-vous de disposer d'un compte [AWS][7]. Le modèle CloudFormation crée un rôle IAM et une politique associée, permettant au compte AWS de Datadog d'effectuer des appels API vers votre compte AWS pour collecter et transférer des données. Votre utilisateur AWS doit disposer des autorisations IAM suivantes pour exécuter le modèle : -{{% collapse-content title="Autorisations IAM requises" level="h4" expanded=false id="iam-permissions" %}} +{{% collapse-content title="Autorisations IAM requises" level="h3" expanded=false id="iam-permissions" %}} - cloudformation:CreateStack - cloudformation:CreateUploadBucket - cloudformation:DeleteStack @@ -100,138 +106,155 @@ Avant de commencer, assurez-vous de disposer d'un compte [AWS][7]. Le modèle Cl - serverlessrepo:CreateCloudFormationTemplate {{% /collapse-content %}} -## Configurer {#setup} +## Configuration {#setup} -1. Allez à la [page de configuration d'intégration AWS][8] dans Datadog et cliquez sur {{< ui >}}Add AWS Account{{< /ui >}}. +1. Accédez à la [page de configuration de l'intégration AWS][8] dans Datadog et cliquez sur {{< ui >}}Add AWS Account{{< /ui >}}. 1. Configurez les paramètres de l'intégration sous l'option {{< ui >}}Automatically using CloudFormation{{< /ui >}}. 1. Sélectionnez les régions AWS à intégrer. - 1. Ajoutez votre [clé API Datadog][9]. - 1. Optionnellement, envoyez des journaux et d'autres données à Datadog avec le [Lambda Datadog Forwarder][1]. - 1. Optionnellement, activez [Cloud Security Misconfigurations][54] pour analyser votre environnement cloud, vos hôtes et vos conteneurs pour des erreurs de configuration et des risques de sécurité. -1. Cliquez sur {{< ui >}}Launch CloudFormation Template{{< /ui >}}. Cela ouvre la Console AWS et charge la pile CloudFormation. Tous les paramètres sont remplis en fonction de vos sélections dans le formulaire Datadog précédent, donc vous n'avez pas besoin de les modifier sauf si vous le souhaitez. -**Remarque:** Le paramètre `DatadogAppKey` permet à la pile CloudFormation d'effectuer des appels API à Datadog pour ajouter et modifier la configuration Datadog pour ce compte AWS. La clé est générée automatiquement et liée à votre compte Datadog. -1. Cochez les cases requises d'AWS et cliquez sur {{< ui >}}Create stack{{< /ui >}}. Cela lance le processus de création de la pile Datadog ainsi que trois piles imbriquées. Cela peut prendre plusieurs minutes. Assurez-vous que la pile est créée avec succès avant de continuer. -1. Après la création de la pile, retournez à la tuile d'intégration AWS dans Datadog et cliquez sur {{< ui >}}Ready!{{< /ui >}} -1. Attendez jusqu'à 10 minutes pour que les données commencent à être collectées, puis consultez le tableau de bord [vue d'ensemble AWS][12] pour voir les métriques envoyées par vos services et infrastructures AWS : -{{< img src="getting_started/integrations/aws-dashboard.png" alt="Le tableau de bord vue d'ensemble AWS dans le compte Datadog. À gauche se trouve le logo AWS et un graphique d'événements AWS indiquant 'Aucune entrée correspondante trouvée'. Au centre se trouvent des graphiques liés aux volumes EBS avec des données numériques affichées et une carte thermique montrant des données cohérentes. À droite se trouvent des graphiques liés aux ELB montrant des données numériques ainsi qu'un graphique de séries temporelles affichant des pics de données provenant de trois sources.">}} + 1. Ajoutez votre [clé d'API][9] Datadog. + 1. Optionnellement, envoyez des logs et d'autres données à Datadog avec le [Datadog Forwarder Lambda][1]. + 1. Optionnellement, activez [Cloud Security Misconfigurations][54] pour analyser votre environnement cloud, vos hôtes et vos conteneurs à la recherche de mauvaises configurations et de risques de sécurité. +1. Cliquez sur {{< ui >}}Launch CloudFormation Template{{< /ui >}}. Cela ouvre la console AWS et charge la pile CloudFormation. Tous les paramètres sont renseignés en fonction de vos sélections dans le formulaire Datadog précédent, vous n'avez donc pas besoin de les modifier sauf si vous le souhaitez. +**Remarque :** Le paramètre `DatadogAppKey` permet à la pile CloudFormation d'effectuer des appels API vers Datadog pour ajouter et modifier la configuration Datadog pour ce compte AWS. La clé est générée automatiquement et liée à votre compte Datadog. +1. Cochez les cases requises par AWS et cliquez sur {{< ui >}}Create stack{{< /ui >}}. Cela lance le processus de création de la pile Datadog ainsi que de trois piles imbriquées. Cela pourrait prendre plusieurs minutes. Assurez-vous que la pile est correctement créée avant de continuer. +1. Une fois la pile créée, retournez sur la tuile d'intégration AWS dans Datadog et cliquez sur {{< ui >}}Ready!{{< /ui >}} +1. Attendez jusqu'à 10 minutes que la collecte des données commence, puis consultez le [dashboard de présentation AWS][12] prêt à l'emploi pour voir les métriques envoyées par vos services et votre infrastructure AWS : +{{< img src="getting_started/integrations/aws-dashboard.png" alt="Le dashboard de présentation AWS dans le compte Datadog. À gauche se trouvent le logo AWS et un graphique des événements AWS indiquant « Aucune entrée correspondante trouvée ». Au centre se trouvent des graphiques relatifs aux volumes EBS avec des données numériques affichées et une carte thermique montrant des données cohérentes. Sur la droite se trouvent des graphiques relatifs aux ELB affichant des données numériques ainsi qu'une série temporelle montrant des données irrégulières provenant de trois sources.">}} Pour configurer plusieurs comptes à la fois, utilisez l'[API][3], l'[AWS CLI][4] ou [Terraform][5]. Pour plus d'informations, consultez le [guide Datadog-Amazon CloudFormation][6]. -**Remarque** : Le modèle CloudFormation de Datadog ne prend en charge que la création et la suppression de ses ressources définies. Consultez [Mettre à jour votre modèle de pile][59] pour des conseils sur l'application des mises à jour à votre pile. +**Remarque** : Le modèle CloudFormation de Datadog prend uniquement en charge la création et la suppression des ressources qu'il définit. Consultez [Mettre à jour votre modèle de stack][59] pour obtenir des conseils sur l'application des mises à jour à votre stack. ### À quoi s'attendre après la configuration {#what-to-expect-after-setup} -Après que l'intégration est configurée avec succès, les données commencent à apparaître dans Datadog selon la chronologie suivante : +Une fois l'intégration correctement configurée, les données commencent à apparaître dans Datadog selon le calendrier suivant : -- **Métriques** : Apparaissent en environ 10 minutes avec le polling API, ou 2-3 minutes avec [CloudWatch Metric Streams][60]. Tous les services ne rapportent pas à la même cadence, donc un tableau de bord partiellement peuplé pendant la première heure est normal. -- **Tags** : Les tags des ressources AWS peuvent prendre un temps supplémentaire à se propager. Les modifications des tags dans AWS peuvent prendre de 15 minutes à plusieurs heures pour se refléter dans Datadog. -- **Ressources** : Découvertes lors du prochain cycle de crawl des ressources après la configuration. -- **Journaux** : Nécessite une configuration séparée. Voir [Envoyer des journaux](#send-logs) pour les instructions de configuration. +- **Métriques** : Apparaissent en 10 minutes environ avec l'interrogation de l'API, ou en 2 à 3 minutes avec les [flux de métriques CloudWatch][60]. Tous les services ne transmettent pas les données à la même fréquence ; il est donc normal qu'un dashboard soit partiellement rempli au cours de la première heure. +- **Tags** : Les tags de ressources AWS peuvent mettre plus de temps à se propager. Les modifications apportées aux tags dans AWS peuvent mettre de 15 minutes à plusieurs heures avant d'être répercutées dans Datadog. +- **Ressources** : Découvertes lors du prochain cycle d'exploration des ressources après la configuration. +- **Logs** : Nécessitent une configuration distincte. Consultez [Envoyer des logs](#send-logs) pour les instructions de configuration.
-Datadog ne remplit pas les données métriques historiques d'avant l'activation de l'intégration. Les métriques commencent à circuler à partir du moment où l'intégration est configurée avec succès. +Datadog ne remplit pas les données de métriques historiques antérieures à l'activation de l'intégration. Les métriques commencent à circuler à partir du moment où l'intégration est configurée avec succès.
## Configuration {#configuration} -### Activer les intégrations pour les services AWS individuels {#enable-integrations-for-individual-aws-services} +### Activer les intégrations pour des services AWS individuels {#enable-integrations-for-individual-aws-services} -Voir la [page des intégrations][13] pour une liste complète des sous-intégrations disponibles. Beaucoup de ces intégrations sont installées par défaut lorsque Datadog reconnaît des données provenant de votre compte AWS. +Consultez la [page Intégrations][13] pour obtenir une liste complète des sous-intégrations disponibles. Bon nombre de ces intégrations sont installées par défaut lorsque Datadog reconnaît les données provenant de votre compte AWS. -Utilisez l'onglet {{< ui >}}Metric Collection{{< /ui >}} sur la [page d'intégration AWS][8] pour configurer les services dont l'intégration Datadog collecte les métriques. +Utilisez l'onglet {{< ui >}}Metric Collection{{< /ui >}} sur la [page d'intégration AWS][8] pour configurer les services à partir desquels l'intégration Datadog collecte des métriques. + +### Filtrer les métriques par nom de métrique {#filter-metrics-by-metric-name} + +Utilisez l'onglet {{< ui >}}Metric Collection{{< /ui >}} sur la [page d'intégration AWS][8] pour filtrer les métriques CloudWatch par espace de nom. Développez un espace de nom dans le tableau de collecte des métriques CloudWatch et choisissez un filtre **Inclure** ou **Exclure** : + +- **Inclure** : Collectez uniquement les noms de métriques Datadog qui correspondent aux modèles configurés pour cet espace de nom. +- **Exclure** : Collectez tous les noms de métriques Datadog pour cet espace de nom, à l'exception de ceux qui correspondent aux modèles configurés. + +Chaque espace de nom peut utiliser un seul mode de filtrage à la fois. Les modèles de filtrage prennent en charge les lettres minuscules, les chiffres, `.`, `_` et `*`. Par exemple, `aws.ec2.network_*` correspond aux métriques réseau EC2. Le tableau prévisualise le nombre de métriques correspondant à chaque modèle avant que vous n'enregistriez les modifications. + +Les filtres de noms de métriques s'appliquent par espace de nom et sont évalués une fois que l'espace de nom est activé pour la collecte de métriques. + +
+Les filtres de noms de métriques ne peuvent pas supprimer aws.ec2.cpuutilization ou aws.lambda.invocations. Datadog collecte toujours ces métriques requises. +
+ +Pour gérer les filtres de noms de métriques par programmation, consultez [Configurer les filtres de noms de métriques AWS avec l'API][61]. ### Ajouter des régions {#add-regions} Sous l'onglet {{< ui >}}General{{< /ui >}} sur la [page d'intégration AWS][8], vous pouvez contrôler les régions AWS où Datadog collecte des métriques, des événements CloudWatch et des ressources. -## Envoyer des journaux{#send-logs} +## Envoyer des logs {#send-logs} -Il existe deux façons d'envoyer des journaux de service AWS à Datadog : +Il existe deux façons d'envoyer des logs de service AWS à Datadog : -- [Destination Amazon Data Firehose][10] : Recommandé pour les journaux CloudWatch à fort volume. -- [Fonction Lambda Forwarder][11] : Nécessaire pour les traces, les métriques améliorées ou les métriques personnalisées des fonctions Lambda. Également recommandé pour les journaux provenant de S3 ou d'autres ressources qui ne peuvent pas être diffusées directement vers Amazon Data Firehose. +- [Amazon Data Firehose destination][10] : Recommandé pour les logs CloudWatch à haut volume. +- [Forwarder Lambda function][11] : Requis pour les traces, les métriques améliorées ou les métriques personnalisées provenant des fonctions Lambda. Également recommandé pour les logs provenant de S3 ou d'autres ressources qui ne peuvent pas être diffusés directement vers Amazon Data Firehose. -Voir [Activer la journalisation pour votre service AWS][14] pour les instructions de configuration. +Consultez [Activer la journalisation pour votre service AWS][14] pour obtenir des instructions de configuration. ### Validation {#validation} -Une fois que vous avez activé les journaux, trouvez-les dans le [Log Explorer][15] en utilisant soit les facettes `source` ou `service` du panneau de facettes, comme cet exemple de S3 : -{{< img src="getting_started/integrations/logs-explorer.png" alt="La page Log Explorer du compte Datadog. À gauche, l'image affiche les facettes Source et Service, toutes deux cochées avec 's3'. À droite, certaines entrées de journal sont affichées sous forme de liste.">}} +Une fois que vous avez activé les logs, retrouvez-les dans le [Log Explorer][15] en utilisant les facettes `source` ou `service` depuis le panneau des facettes, comme dans cet exemple provenant de S3 : +{{< img src="getting_started/integrations/logs-explorer.png" alt="La page Log Explorer du compte Datadog. Sur la gauche, l'image affiche les facettes Source et Service, toutes deux cochées avec « s3 ». Sur la droite, certaines entrées de logs sont affichées sous forme de liste.">}} -## Obtenez plus de la plateforme Datadog {#get-more-from-the-datadog-platform} +## Tirez le meilleur parti de la plateforme Datadog {#get-more-from-the-datadog-platform} -### Visibilité approfondie avec l'agent Datadog sur EC2 {#deeper-visibility-with-the-datadog-agent-on-ec2} +### Une visibilité accrue avec Datadog Agent sur EC2 {#deeper-visibility-with-the-datadog-agent-on-ec2} -Par défaut, l'intégration AWS de Datadog explore l'API CloudWatch pour les métriques fournies par AWS, mais vous pouvez obtenir une visibilité encore plus approfondie sur vos instances EC2 avec l'[agent Datadog][16]. L'agent est un démon léger qui rapporte des métriques et des événements, et peut également être configuré pour les journaux et les traces. La section [Installation de l'Agent][17] de l'application Datadog fournit des instructions pour installer l'Agent sur une grande variété de systèmes d'exploitation. De nombreux systèmes d'exploitation (par exemple, Amazon Linux) ont des commandes d'installation en une étape que vous pouvez exécuter depuis le terminal de l'instance pour installer l'Agent : -{{< img src="getting_started/integrations/integrations-agent-installation.png" alt="La section « Agent » de l'onglet « Intégrations » dans Datadog. À gauche, une liste des systèmes d'exploitation pris en charge pour l'Agent Datadog est affichée. 'Amazon Linux' est mis en évidence dans cette liste. À droite, est affiché « Utilisez notre installation facile en une étape ». La commande pour installer l'Agent est affichée en dessous, avec la section DD_API_KEY obfusquée.">}} +Par défaut, l'intégration AWS de Datadog explore l'API CloudWatch pour les métriques fournies par AWS, mais vous pouvez obtenir une visibilité encore plus approfondie sur vos instances EC2 avec [Datadog Agent][16]. L'Agent est un démon léger qui rapporte des métriques et des événements, et peut également être configuré pour les logs et les traces. La section [Installation de l'Agent][17] de l'application Datadog fournit des instructions pour installer l'Agent sur une grande variété de systèmes d'exploitation. De nombreux systèmes d'exploitation (par exemple, Amazon Linux) disposent de commandes d'installation en une étape que vous pouvez exécuter depuis le terminal de l'instance pour installer l'Agent : +{{< img src="getting_started/integrations/integrations-agent-installation.png" alt="La section 'Agent' de l'onglet 'Integrations' dans Datadog. Sur la gauche est affichée une liste des systèmes d'exploitation pris en charge pour Datadog Agent. «Amazon Linux» est mis en surbrillance dans cette liste. À droite s'affiche 'Use our easy one-step install'. La commande d'installation de l'Agent s'affiche en dessous, avec la section DD_API_KEY masquée.">}} -Une fois l'Agent installé, il est représenté graphiquement dans le [Infrastructure List] avec une icône d'os : -{{< img src="getting_started/integrations/infrastructure-list.png" alt="La liste d'infrastructure montrant deux hôtes sous forme de liste. Les deux hôtes affichent l'icône AWS pour l'intégration AWS et « aws » affiché dans une boîte bleue pour montrer qu'ils sont associés à l'intégration AWS. Un hôte affiche également une icône d'os et des boîtes bleues pour « ntp » et « system ».">}} +Une fois l'Agent installé, il est représenté graphiquement dans la [Infrastructure List][18] avec une icône en forme d'os : +{{< img src="getting_started/integrations/infrastructure-list.png" alt="La liste d'infrastructure affichant deux hôtes sous forme de liste. Les deux hôtes affichent l'icône AWS pour l'intégration AWS et 'aws' dans un encadré bleu pour indiquer qu'ils sont associés à l'intégration AWS. Un hôte affiche également une icône en forme d'os et des encadrés bleus pour 'ntp' et 'system'.">}} -La capture d'écran ci-dessus montre l'hôte avec l'Agent Datadog rapportant des données des vérifications [System][19] et [NTP][20]. La vérification System fournit des métriques liées au CPU, à la mémoire, au système de fichiers et à l'I/O, offrant des informations supplémentaires sur l'hôte. Vous pouvez activer des [integrations][21] supplémentaires pour adapter votre configuration à votre environnement et à votre cas d'utilisation, ou utiliser également [DogStatsD][22] pour envoyer des métriques personnalisées directement à Datadog. +La capture d'écran ci-dessus montre l'hôte avec Datadog Agent rapportant des données à partir des vérifications [System][19] et [NTP][20]. La vérification System fournit des métriques sur le CPU, la mémoire, le système de fichiers et les E/S, offrant des informations supplémentaires sur l'hôte. Vous pouvez activer des [intégrations][21] supplémentaires pour les adapter à votre environnement et à votre cas d'utilisation, ou utiliser en complément [DogStatsD][22] pour envoyer des métriques personnalisées directement à Datadog. -Consultez la [FAQ sur l'installation de l'Agent Datadog sur des instances cloud][23] pour en savoir plus sur les avantages de cette méthode. +Consultez la [FAQ sur l'installation de Datadog Agent sur des instances cloud][23] pour en savoir plus sur les avantages de cette méthode. -### Utilisation de l'Agent Datadog avec Amazon Container Services {#using-the-datadog-agent-with-amazon-container-services} +### Utilisation de Datadog Agent avec Amazon Container Services {#using-the-datadog-agent-with-amazon-container-services} -Pour les environnements conteneurisés, vous pouvez utiliser l'Agent Datadog, que vous gériez vos instances ou que vous utilisiez [Fargate][24] pour un environnement sans serveur. +Pour les environnements conteneurisés, vous pouvez utiliser Datadog Agent, que vous gériez vos instances ou que vous utilisiez [Fargate][24] pour un environnement serverless. -#### ECS avec EC2 launch type {#ecs-with-ec2-launch-type} +#### ECS avec type de lancement EC2 {#ecs-with-ec2-launch-type} -Utilisez la [documentation Amazon ECS][25] pour exécuter l'[Agent Docker Datadog][26] sur les instances EC2 de votre cluster ECS. Consultez la [Amazon ECS Data Collection documentation][27] pour voir les métriques et événements signalés à votre compte Datadog. +Utilisez la [documentation Amazon ECS][25] pour exécuter l'[Agent Docker Datadog][26] sur les instances EC2 de votre cluster ECS. Consultez la [documentation sur la collecte de données Amazon ECS][27] pour voir les métriques et les événements signalés à votre compte Datadog. -#### ECS avec Fargate launch type {#ecs-with-fargate-launch-type} +#### ECS avec type de lancement Fargate {#ecs-with-fargate-launch-type} -Utilisez la [Amazon ECS on AWS Fargate documentation][28] pour exécuter l'Agent en tant que conteneur dans la même définition de tâche que votre application. **Remarque** : La version 6.1.1 ou supérieure de l'Agent Datadog est nécessaire pour tirer pleinement parti de l'intégration Fargate. +Utilisez la [documentation Amazon ECS sur AWS Fargate][28] pour exécuter l'Agent en tant que conteneur dans la même définition de tâche que votre application. **Remarque** : la version 6.1.1 ou supérieure de Datadog Agent est nécessaire pour tirer pleinement parti de l'intégration Fargate. -#### AWS Batch avec Fargate orchestration type {#aws-batch-with-fargate-orchestration-type} +#### AWS Batch avec type d'orchestration Fargate {#aws-batch-with-fargate-orchestration-type} -Utilisez la [Amazon ECS on AWS Fargate for AWS Batch documentation][58] pour exécuter l'Agent en tant que conteneur dans la même définition de tâche AWS Batch que votre application. **Remarque** : La version 6.1.1 ou supérieure de l'Agent Datadog est nécessaire pour tirer pleinement parti de l'intégration Fargate. +Utilisez la [documentation Amazon ECS sur AWS Fargate pour AWS Batch][58] pour exécuter l'Agent en tant que conteneur dans la même définition de job AWS Batch que votre application. **Remarque** : la version 6.1.1 ou supérieure de Datadog Agent est nécessaire pour tirer pleinement parti de l'intégration Fargate. #### EKS {#eks} -Aucune configuration spécifique n'est nécessaire pour Amazon Elastic Kubernetes Service (EKS), comme mentionné dans la [Kubernetes Distributions documentation][29]. Utilisez la [dedicated Kubernetes documentation][30] pour déployer l'Agent dans votre cluster EKS. +Vous n'avez besoin d'aucune configuration spécifique pour Amazon Elastic Kubernetes Service (EKS), comme mentionné dans la [documentation sur les distributions Kubernetes][29]. Utilisez la [documentation Kubernetes dédiée][30] pour déployer l'Agent dans votre cluster EKS. #### EKS avec Fargate {#eks-with-fargate} -Étant donné que les pods Fargate sont gérés par AWS, ils excluent les vérifications système basées sur l'hôte comme le CPU et la mémoire. Pour collecter des données de vos pods AWS Fargate, utilisez la [Amazon EKS on AWS Fargate documentation][31] pour exécuter l'Agent en tant que sidecar de votre pod d'application avec un contrôle d'accès basé sur les rôles (RBAC) personnalisé. **Remarque** : Cela nécessite la version 7.17 ou supérieure de l'Agent Datadog. +Comme les pods Fargate sont gérés par AWS, ils excluent les vérifications système basées sur l'hôte telles que le CPU et la mémoire. Pour collecter des données à partir de vos pods AWS Fargate, utilisez la [documentation Amazon EKS sur AWS Fargate][31] pour exécuter l'Agent en tant que sidecar de votre pod d'application avec un contrôle d'accès basé sur les rôles (RBAC) personnalisé. **Remarque** : Cela nécessite la version 7.17 ou supérieure de Datadog Agent. #### EKS Anywhere {#eks-anywhere} Référez-vous à la [documentation relative à EKS Anywhere][32] pour vos clusters Kubernetes sur site. -### Créer des ressources Datadog supplémentaires {#create-additional-datadog-resources} -En plus d'utiliser l'interface Datadog ou l'[API][33], vous pouvez créer de nombreuses [Datadog resources][34] avec le [CloudFormation Registry][35]. Pour la visibilité et le dépannage, utilisez des [dashboards][36] pour afficher des données clés, appliquer des [Functions][37] et trouver des [Metric Correlations][38]. +### Créer des ressources Datadog supplémentaires {#create-additional-datadog-resources} +En plus d'utiliser l'interface utilisateur ou l'[API][33] Datadog, vous pouvez créer de nombreuses [ressources Datadog][34] avec le [registre CloudFormation][35]. Pour la visibilité et le dépannage, utilisez des [tableaux de bord][36] pour afficher les données clés, appliquer des [fonctions][37] et trouver des [corrélations de métriques][38]. -Pour être informé de tout comportement indésirable ou inattendu dans votre compte, créez des [monitors][39]. Les moniteurs évaluent constamment les données signalées dans votre compte et envoient des [Notifications][40] pour s'assurer que les bonnes informations parviennent aux bons membres de l'équipe. Consultez la [List of Notification Integrations][41] pour toutes les manières de notifier votre équipe. +Pour être averti de tout comportement indésirable ou inattendu sur votre compte, créez des [monitors][39]. Les monitors évaluent en permanence les données transmises à votre compte et envoient des [notifications][40] pour garantir que les bonnes informations parviennent aux bons membres de l'équipe. Consultez la [liste des intégrations de notification][41] pour connaître toutes les façons d'avertir votre équipe. -## Explorez des produits connexes {#explore-related-products} +## Explorer les produits associés {#explore-related-products} -### Sans serveur {#serverless} +### Serverless {#serverless} -Pour surveiller les fonctions AWS Lambda avec Datadog, consultez [Serverless][42] pour des instructions sur l'instrumentation de votre application, l'installation des [Serverless Libraries and Integrations][43], la mise en œuvre du [distributed tracing with serverless applications][44] ou le [troubleshooting serverless issues][45]. +Pour surveiller les fonctions AWS Lambda avec Datadog, consultez [Serverless][42] pour obtenir des instructions sur l'instrumentation de votre application, l'installation de [bibliothèques et intégrations Serverless][43], la mise en œuvre du [tracing distribué avec des applications serverless][44] ou le [dépannage des problèmes serverless][45]. -### APM {#apm} +### APM {#apm} -Pour collecter des traces distribuées de vos applications et services AWS, utilisez l'Agent Datadog avec [APM][47]. Pour les fonctions AWS Lambda, instrumentez avec l'[Datadog Lambda Extension][44]. Consultez la [documentation APM][48] pour des détails sur l'analyse des données de performance des applications. +Pour collecter des traces distribuées à partir de vos applications et services AWS, utilisez Datadog Agent avec l'[APM][47]. Pour les fonctions AWS Lambda, instrumentez avec l'[Datadog Lambda Extension][44]. Consultez la [documentation APM][48] pour plus de détails sur l'analyse des données de performance des applications. -Vous pouvez également utiliser [Watchdog][49], une fonctionnalité algorithmique pour les performances APM et les métriques d'infrastructure, pour détecter automatiquement et être informé des problèmes potentiels d'application. +Vous pouvez également utiliser [Watchdog][49], une fonctionnalité algorithmique pour les performances APM et les métriques d'infrastructure, pour détecter automatiquement les problèmes d'application potentiels et en être informé. ### Sécurité {#security} #### Cloud SIEM {#cloud-siem} -Consultez [Getting Started with Cloud SIEM][50] pour évaluer vos journaux par rapport aux [Log Detection Rules][51] prêtes à l'emploi. Ces règles sont personnalisables, et lorsque des menaces sont détectées, elles génèrent des signaux de sécurité accessibles dans le [Security Signals Explorer][52]. Utilisez [Notification Rules][53] pour configurer les préférences de notification sur plusieurs règles. +Consultez [Prise en main de Cloud SIEM][50] pour évaluer vos logs par rapport aux [règles de détection de logs][51] prêtes à l'emploi. Ces règles sont personnalisables et, lorsque des menaces sont détectées, elles génèrent des signaux de sécurité accessibles dans l'[Explorer de signaux de sécurité][52]. Utilisez les [règles de notification][53] pour configurer les préférences de notification pour plusieurs règles. -#### Mauvaises configurations de la sécurité cloud {#cloud-security-misconfigurations} +#### Mauvaises configurations de Cloud Security {#cloud-security-misconfigurations} -Utilisez le guide [Setting Up Cloud Security Misconfigurations][54] pour détecter et évaluer les mauvaises configurations dans votre environnement cloud. Les données de configuration des ressources sont évaluées par rapport aux règles de conformité [Cloud][55] et [Infrastructure][56] prêtes à l'emploi pour signaler les techniques d'attaque et les mauvaises configurations potentielles. +Utilisez le guide [Setting Up Cloud Security Misconfigurations][54] pour détecter et évaluer les mauvaises configurations dans votre environnement cloud. Les données de configuration des ressources sont évaluées par rapport aux règles de conformité [Cloud][55] et [Infrastructure][56] prêtes à l'emploi pour signaler les techniques d'attaquants et les mauvaises configurations potentielles. ### Dépannage {#troubleshooting} -Si vous rencontrez l'erreur `Datadog is not authorized to perform sts:AssumeRole`, consultez sa page de dépannage dédiée [troubleshooting page][2]. Pour tout autre problème, consultez le [AWS integration troubleshooting guide][57]. +Si vous rencontrez l'erreur `Datadog is not authorized to perform sts:AssumeRole`, consultez sa [page de dépannage][2] dédiée. Pour tout autre problème, consultez le [guide de dépannage de l'intégration AWS][57]. -## Lectures complémentaires {#further-reading} +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} @@ -294,4 +317,5 @@ Si vous rencontrez l'erreur `Datadog is not authorized to perform sts:AssumeRole [57]: /fr/integrations/guide/aws-integration-troubleshooting/ [58]: /fr/integrations/ecs_fargate/?tab=webui#installation-for-aws-batch [59]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-get-template.html -[60]: /fr/integrations/guide/aws-cloudwatch-metric-streams-with-kinesis-data-firehose/ \ No newline at end of file +[60]: /fr/integrations/guide/aws-cloudwatch-metric-streams-with-kinesis-data-firehose/ +[61]: /fr/integrations/guide/aws-metric-name-filters/ \ No newline at end of file diff --git a/hugo/content/fr/incident_response/incident_management/_index.md b/hugo/content/fr/incident_response/incident_management/_index.md new file mode 100644 index 00000000000..09d6caed2dc --- /dev/null +++ b/hugo/content/fr/incident_response/incident_management/_index.md @@ -0,0 +1,171 @@ +--- +aliases: +- /fr/monitors/incident_management/ +- /fr/service_management/incident_management/ +description: Créer et gérer des incidents +further_reading: +- link: dashboards/querying/#incident-management-analytics + tag: Documentation + text: Incident Management Analytics +- link: https://learn.datadoghq.com/courses/getting-started-incident-management + tag: Centre d'apprentissage + text: Premiers pas avec Incident Management +- link: https://dtdg.co/fe + tag: Validation des bases + text: Participer à une session interactive pour améliorer la Incident Management +- link: https://www.datadoghq.com/blog/mobile-incident-management-datadog/ + tag: Blog + text: Gérez et résolvez des incidents où que vous soyez avec l'application mobile + Datadog +- link: https://www.datadoghq.com/blog/incident-postmortem-process-best-practices/ + tag: Blog + text: Meilleures pratiques pour écrire des postmortems d'incident +- link: https://www.datadoghq.com/blog/incident-response-with-datadog/ + tag: Blog + text: Incident Management avec Datadog +- link: https://www.datadoghq.com/blog/datadog-service-management/ + tag: Blog + text: Assurez une haute disponibilité des services avec Datadog Service Management +- link: https://www.datadoghq.com/blog/how-datadog-manages-incidents/ + tag: Blog + text: Comment Datadog gère ses incidents +- link: https://www.datadoghq.com/blog/incidents-ai-workbench-status-page/ + tag: Blog + text: Unifiez la remédiation et la communication avec Datadog Incident Response +- link: https://www.datadoghq.com/blog/servicenow-datadog-incident-response + tag: Blog + text: Intégrer ServiceNow ITSM à Datadog pour accélérer la réponse aux incidents +- link: https://app.datadoghq.com/release-notes?category=Incident%20Management + tag: Notes de version + text: Découvrez les dernières nouveautés d'Incident Management ! (Connexion à l'application + requise). +title: Incident Management +--- +{{< learning-center-callout header="Rejoignez une session de webinaire de formation" hide_image="true" btn_title="S'inscrire" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=Incidents">}} + Explorez et inscrivez-vous aux sessions de formation fondamentale. Découvrez comment Datadog Incident Management permet aux équipes DevOps et aux SRE de gérer plus efficacement leurs workflows de réponse aux incidents du début à la fin, en gagnant du temps et en réduisant la frustration lorsque cela compte le plus. +{{< /learning-center-callout >}} + +Datadog Incident Management aide les membres de votre équipe à identifier, atténuer et analyser les perturbations et les menaces pesant sur les services de votre organisation. Avec Incident Management, vous pouvez concevoir un processus de réponse amélioré par l'automatisation qui aide vos équipes à se rassembler autour d'un cadre et d'une boîte à outils partagés. Vous pouvez également utiliser l'analyse des incidents pour évaluer l'efficacité de votre processus de réponse aux incidents. + +Les incidents vivent dans Datadog aux côtés de vos métriques, traces et logs. Vos équipes peuvent déclarer des incidents à partir d'alertes de monitor, de signaux de sécurité, d'événements, de cas, et plus encore. Vous pouvez également configurer des monitors pour [déclarer automatiquement des incidents][30]. + +## Commencez {#get-started} + +Incident Management ne nécessite aucune installation. Commencez par suivre un cours du Learning Center, lire notre visite guidée ou déclarer un incident. + +{{< whatsnext desc="En savoir plus sur Incident Management :">}} + {{< nextlink href="https://learn.datadoghq.com/courses/intro-to-incident-management" >}}Découvrez Datadog Incident Management en travaillant sur des exemples pratiques{{< /nextlink >}} + {{< nextlink href="https://docs.datadoghq.com/getting_started/incident_management/" >}}Visite guidée d'un workflow d'incident{{< /nextlink >}} + {{< nextlink href="/incident_response/incident_management/investigate/declare" >}}Déclarer un incident{{< /nextlink >}} +{{< /whatsnext >}} + +## Facturation {#billing} + +Incident Management est une offre basée sur le nombre de sièges. Pour en savoir plus sur la facturation d'Incident Management et sur la gestion des sièges dans Datadog, consultez notre [page de tarification][31] et la [documentation sur la facturation d'Incident Response][32]. + +## Afficher et rechercher des incidents {#view-and-search-for-incidents} + +Pour afficher vos incidents, accédez à la page [Incidents][1] pour voir un flux de tous les incidents en cours. Vous pouvez filtrer vos incidents via les propriétés listées sur la gauche, exporter vos résultats de recherche et configurer des champs supplémentaires qui apparaissent pour tous les incidents dans les [Paramètres des incidents][2]. + +### Exemples de recherche {#search-examples} + +La recherche d'incidents utilise la même [syntaxe de recherche][33] basée sur les événements que Logs et Event Management. Combinez des paires `key:value` avec des opérateurs booléens (`AND`, `OR`, `-`) pour filtrer les incidents. + +| Requête | Description | +|-------|-------------| +| `severity:SEV-1` | Afficher tous les incidents SEV-1 | +| `severity:(SEV-1 OR SEV-2) state:active` | Afficher tous les incidents SEV-1 ou SEV-2 actifs | +| `services:checkout AND -state:resolved` | Afficher les incidents non résolus affectant le service de paiement | +| `teams:platform` | Afficher les incidents assignés à l'équipe plateforme | +| `services:web*` | Afficher les incidents affectant les services commençant par « web » | +| `Root\ Cause\ Category:Bug ` | Afficher les incidents avec un attribut de cause racine spécifique | +| `responder:john.smith@datadoghq.com ` | Afficher les incidents où John Smith est un intervenant | + +### Filtrer et exporter {#filter-and-export} + +- **Filtrer par propriétés** : utilisez le panneau des facettes sur la gauche pour filtrer par statut, gravité, délai de réparation (heures) et d'autres propriétés configurées. +- **Exporter les résultats de recherche** : exportez vos résultats de recherche à l'aide du bouton Exporter en haut de la liste des incidents. +- **Enregistrer les vues** : enregistrez vos requêtes de recherche et vos filtres fréquemment utilisés pour un accès rapide. + +### Accès mobile {#mobile-access} + +Vous pouvez également consulter votre liste d'incidents depuis l'écran d'accueil de votre appareil mobile et gérer/créer des incidents en téléchargeant l'[application mobile Datadog][3], disponible sur l'[Apple App Store][4] et le [Google Play Store][5]. + +{{< img src="incident_response/incident_management/iOS_Incident_V2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Deux vues dans l'application mobile Datadog : l'une affichant une liste d'incidents avec des détails de haut niveau sur chaque incident, et l'autre affichant un panneau détaillé pour un incident unique.">}} + +## Décrire l'incident {#describing-the-incident} + +Lors de la déclaration d'un incident, il est essentiel de fournir une description complète, détaillant ce qui s'est passé, pourquoi cela s'est produit et les attributs associés pour garantir que toutes les parties prenantes du processus Incident Management soient pleinement informées. Les éléments essentiels d'une déclaration d'incident incluent un titre, un niveau de gravité et les responsables d'incident. Une documentation efficace sur Incident Management comprend : +- Mise à jour des détails de l'incident, y compris son statut, son impact, sa cause première, ses méthodes de détection et ses impacts sur les services. +- Formation et gestion d'une équipe d'intervention, utilisation de rôles d'intervenants personnalisés et exploitation des attributs de métadonnées pour une évaluation détaillée des incidents. +- Configuration des notifications pour tenir toutes les parties prenantes informées tout au long du processus de résolution des incidents. + +Pour plus d'informations, consultez la documentation [Décrire un incident][20]. + +## Évaluer les données d'incident {#evaluate-incident-data} + +L'analyse des incidents fournit des informations sur l'efficacité et les performances de votre processus de réponse aux incidents en vous permettant d'agréger et d'analyser les statistiques des incidents passés. Des métriques clés, tels que le temps de résolution et l'impact sur les clients, peuvent être suivis au fil du temps. Vous pouvez interroger ces analyses à l'aide de widgets graphiques dans les tableaux de bord et les notebooks. Datadog propose des modèles personnalisables, tels que le dashboard de vue d'ensemble Incident Management et un rapport d'incident de notebook, pour vous aider à démarrer. + +Pour plus de détails sur les mesures collectées et les configurations graphiques étape par étape pour visualiser vos données, consultez [Analyse Incident Management][10]. + +## Intégrations {#integrations} + +Incident Management s'intègre étroitement aux autres produits Datadog, notamment : + +- [Pages de statut Datadog][26] pour créer des pages de statut publiques ou privées et les connecter aux incidents. +- [Datadog On-Call][27] pour convertir des pages en incidents et alerter, manuellement ou automatiquement, les équipes lors d'un incident. +- [Datadog Notebooks][28] pour rédiger et examiner des [post-mortems][34]. +- [Datadog Workflow Automation][29] pour créer et exécuter des automatisations. + +### Intégrations tierces {#third-party-integrations} + +Incident Management s'intègre à des applications tierces, notamment : + +- [Atlassian Statuspage][25] pour créer et mettre à jour des incidents Statuspage. +- [Confluence][22] pour générer des [post-mortems][34] d'incident. +- [CoTerm][21] pour suivre en temps réel les activités de remédiation d'incident basées sur le terminal. +- [Jira][15] pour créer un ticket Jira pour un incident. +- [Microsoft Teams][23] pour créer des canaux et des réunions vidéo pour les incidents. +- [PagerDuty][12] et [OpsGenie][13] pour avertir vos ingénieurs d'astreinte et résoudre automatiquement les alertes lors de la résolution de l'incident. +- [ServiceNow][19] pour créer des tickets ServiceNow pour les incidents. +- [Slack][11] pour créer des canaux pour les incidents. +- [Webhooks][16] pour envoyer des notifications d'incident via des webhooks (par exemple, [envoyer des SMS à Twilio][17]). +- [Zoom][24] pour lancer des appels vidéo pour les incidents. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/incidents +[2]: https://app.datadoghq.com/incidents/settings +[3]: /fr/mobile +[4]: https://apps.apple.com/app/datadog/id1391380318 +[5]: https://play.google.com/store/apps/details?id=com.datadog.app +[6]: /fr/incident_response/incident_management/investigate/declare +[7]: /fr/account_management/teams/ +[8]: /fr/getting_started/tagging/assigning_tags?tab=noncontainerizedenvironments#overview +[9]: /fr/tracing/#2-instrument-your-application +[10]: /fr/incident_response/incident_management/analytics_and_reporting/ +[11]: /fr/integrations/slack/?tab=slackapplicationbeta#using-the-slack-app +[12]: /fr/integrations/pagerduty/ +[13]: /fr/integrations/opsgenie/ +[15]: /fr/integrations/jira/ +[16]: /fr/integrations/webhooks/ +[17]: /fr/integrations/webhooks/#sending-sms-through-twilio +[18]: /fr/integrations/statuspage/ +[19]: /fr/integrations/servicenow/ +[20]: /fr/incident_response/incident_management/investigate/describe +[21]: /fr/coterm +[22]: /fr/integrations/confluence/ +[23]: /fr/integrations/microsoft-teams/?tab=datadogapprecommended#datadog-incident-management-in-microsoft-teams +[24]: /fr/integrations/zoom-incident-management/ +[25]: /fr/integrations/statuspage/ +[26]: /fr/incident_response/status_pages/ +[27]: /fr/incident_response/on-call/ +[28]: /fr/notebooks/ +[29]: /fr/actions/workflows/ +[30]: /fr/incident_response/incident_management/investigate/declare#from-a-monitor +[31]: https://www.datadoghq.com/pricing/?product=incident-response#products +[32]: /fr/account_management/billing/incident_response/ +[33]: /fr/getting_started/search/#event-based-queries +[34]: /fr/incident_response/incident_management/post_incident/postmortems \ No newline at end of file diff --git a/hugo/content/fr/integrations/guide/aws-integration-and-cloudwatch-faq.md b/hugo/content/fr/integrations/guide/aws-integration-and-cloudwatch-faq.md index 16bab090079..c473be0b81d 100644 --- a/hugo/content/fr/integrations/guide/aws-integration-and-cloudwatch-faq.md +++ b/hugo/content/fr/integrations/guide/aws-integration-and-cloudwatch-faq.md @@ -2,56 +2,62 @@ aliases: - /fr/integrations/faq/do-you-believe-you-re-seeing-a-discrepancy-between-your-data-in-cloudwatch-and-datadog - /fr/integrations/faq/aws-integration-and-cloudwatch-faq - +description: Questions fréquentes sur l'intégration Datadog AWS et la collecte de + métriques CloudWatch. title: FAQ sur l'intégration AWS et CloudWatch --- +### Puis-je collecter des métriques personnalisées AWS via l'intégration ? {#can-i-collect-aws-custom-metrics-through-the-integration} + +Oui. Activez **Collect Custom Metrics** sous l'onglet **Metric Collection** sur la [page d'intégration AWS][1]. -### Est-il possible de recueillir des métriques custom AWS via l'intégration ? +### Puis-je filtrer les métriques AWS par nom de métrique ? {#can-i-filter-aws-metrics-by-metric-name} -Oui. Activez l'option **Collect Custom Metrics** dans l'onglet **Metric Collection** sur la [page de l'intégration AWS][1]. +Oui. Sur la [page d'intégration AWS][1], ouvrez l'onglet **Metric Collection**, développez un espace de nom CloudWatch et ajoutez des filtres de nom de métrique. Utilisez **Include** pour collecter uniquement les noms de métriques Datadog correspondants pour cet espace de nom, ou **Exclude** pour tout collecter à l'exception des noms de métriques correspondants. -### Comment recueillir des métriques à partir d'un service pour lequel il n'existe pas d'intégration Datadog officielle ? +Pour plus d'informations sur la syntaxe et les métriques requises, consultez [Démarrer avec AWS][14]. Pour gérer les filtres de nom de métrique par programmation, consultez [Configurer les filtres de nom de métrique AWS avec l'API][15]. -Les métriques AWS en provenance d'un `AWS/` pour lequel il n'existe pas d'intégration officielle sont également ingérées sous l'espace de nommage personnalisé lorsque l'option `Collect custom metrics` est activée. Pour filtrer ces métriques et ne conserver que celles qui vous intéressent, utilisez la chaîne de filtrage sous l'espace de nommage personnalisé avec l'API [Définir un filtre de tags AWS][2]. +### Comment collecter des métriques à partir d'un service pour lequel Datadog ne dispose pas d'intégration officielle ? {#how-do-i-collect-metrics-from-a-service-for-which-datadog-doesnt-have-an-official-integration} -### Comment l'intégration Datadog/AWS utilise-t-elle CloudWatch ? +Les métriques AWS provenant d'un `AWS/` pour lequel il n'existe aucune intégration officielle sont également importées sous l'espace de nom personnalisé lorsque l'option `Collect custom metrics` est activée. Vous pouvez filtrer ces métriques et ne conserver que celles que vous souhaitez en utilisant la chaîne de filtrage sous l'espace de nom personnalisé avec l'API [Définir un filtre de tag AWS][2]. -Datadog utilise les API de surveillance CloudWatch pour surveiller vos ressources AWS. Ces API sont principalement utilisées pour la collecte de données de métriques brutes via l'endpoint `GetMetricData`. +### Comment l'intégration Datadog AWS utilise-t-elle CloudWatch ? {#how-does-the-datadog-aws-integration-use-cloudwatch} -D'autres API sont utilisées pour enrichir les données de métriques. Voici quelques exemples : +Datadog utilise les API de surveillance CloudWatch pour surveiller vos ressources AWS. Notre utilisation principale de ces API consiste à collecter des données de métriques brutes via l'endpoint `GetMetricData`. - * Récupérer des tags personnalisés pour les ajouter aux métriques +D'autres API sont utilisées pour enrichir les données de métriques. Voici quelques exemples : - * Récupérer des informations sur le statut ou la santé de ressources, comme la désactivation automatique + * Collecte de tags personnalisés à ajouter aux métriques - * Récupérer des flux de logs + * Collecte d'informations sur le statut ou l'état de santé des ressources, comme la désactivation automatique -### Combien de requêtes API sont-elles effectuées et comment surveiller mon utilisation de CloudWatch ? + * Collecte de flux de logs -Datadog récupère les métriques disponibles toutes les 10 minutes pour chaque sous-intégration AWS que vous avez installée. Si vous avez de nombreuses ressources AWS pour une sous-intégration spécifique (SQS, ELB, DynamoDB, métriques custom AWS), cela peut affecter votre facture AWS CloudWatch. +### Combien de requêtes API sont effectuées et comment puis-je surveiller mon utilisation de CloudWatch ? {#how-many-api-requests-are-made-and-how-can-i-monitor-my-cloudwatch-usage} + +Datadog collecte les métriques disponibles toutes les 10 minutes pour chaque sous-intégration AWS que vous avez installée. Si vous avez un grand nombre de ressources AWS pour une sous-intégration particulière (SQS, ELB, DynamoDB, métriques personnalisées AWS), cela peut avoir un impact sur votre facture AWS CloudWatch. Vous pouvez surveiller votre utilisation de l'API CloudWatch avec l'[intégration AWS Billing][3]. -### Comment réduire le délai de réception de mes métriques CloudWatch dans Datadog ? +### Comment puis-je réduire le délai de réception de mes métriques CloudWatch vers Datadog ? {#how-can-i-reduce-the-delay-of-receiving-my-cloudwatch-metrics-to-datadog} -Par défaut, Datadog recueille les métriques AWS toutes les 10 minutes. Consultez la section [Délai de réception des métriques cloud][4] pour en savoir plus. Si vous souhaitez réduire cette latence, contactez l'[assistance Datadog][5] pour obtenir de l'aide. Pour que les métriques CloudWatch parviennent à Datadog avec une latence de 2 à 3 minutes seulement, nous vous conseillons d'utiliser les [Flux de métriques AWS CloudWatch avec Amazon Kinesis Data Firehose][6]. +Par défaut, Datadog collecte les métriques AWS toutes les 10 minutes. Consultez [Cloud Metric Delay][4] pour plus d'informations. Si vous devez réduire la latence, contactez le [support Datadog][5] pour obtenir de l'aide. Pour obtenir les métriques CloudWatch dans Datadog plus rapidement avec une latence de 2 à 3 minutes, nous recommandons d'utiliser [Amazon CloudWatch Metric Streams et Amazon Data Firehose][6]. -### Pourquoi seules les valeurs moyennes de mes métriques AWS/CloudWatch custom sont-elles visibles ? +### Pourquoi ne vois-je que les valeurs moyennes de mes métriques AWS/Cloudwatch personnalisées ? {#why-am-i-only-seeing-the-average-values-of-my-custom-awscloudwatch-metrics} -Par défaut, Datadog recueille uniquement les valeurs moyennes de vos métriques AWS/CloudWatch custom. Toutefois, des valeurs supplémentaires sont disponibles en contactant l'[assistance Datadog][5]. Celles-ci incluent (lorsque c'est possible) la valeur minimale, la valeur maximale, la somme et le nombre d'échantillons. +Par défaut, Datadog collecte uniquement les valeurs moyennes de vos métriques AWS/Cloudwatch personnalisées. Cependant, des valeurs supplémentaires sont disponibles en contactant le [support Datadog][5]. Celles-ci incluent (lorsqu'elles sont disponibles) le minimum, le maximum, la somme et le nombre d'échantillons. -### Y a-t-il des différences entre mes données dans CloudWatch et dans Datadog ? +### Existe-t-il un écart entre mes données dans CloudWatch et Datadog ? {#is-there-a-discrepancy-between-my-data-in-cloudwatch-and-datadog} Il est important de tenir compte des distinctions suivantes : -- Datadog recueille la _moyenne_ de toutes les métriques CloudWatch. -- Pour les counters AWS, un graphique défini sur `sum` `1 minute` affiche le nombre total d'occurrences en l'espace d'une minute, soit le taux par minute. Datadog affiche les données brutes à partir des valeurs AWS normalisées par seconde, peu importe l'intervalle sélectionné dans AWS. Cela explique pourquoi la valeur affichée dans Datadog peut être plus faible. -- Les valeurs `min`, `max` et `avg` n'ont généralement pas la même signification dans AWS. Dans AWS, les latences moyenne, minimale et maximale correspondent à trois métriques distinctes recueillies. Lorsque Datadog récupère des métriques à partir d'AWS CloudWatch, la latence moyenne est transmise sous la forme de séries temporelles distinctes pour chaque ELB. Dans Datadog, lorsque vous sélectionnez les valeurs `min`, `max` ou `avg`, vous définissez les critères de rassemblement de séries temporelles. Par exemple, si vous cherchez à obtenir `system.cpu.idle` sans appliquer de filtre, une série est renvoyée pour chaque host qui transmet cette métrique. Datadog combine ces séries en utilisant l'[agrégation spatiale][7]. À l'inverse, si vous cherchez à obtenir `system.cpu.idle` pour un seul host, aucune agrégation n'est nécessaire. Les valeurs `avg` et `max` obtenues sont identiques. +- Datadog collecte une seule statistique CloudWatch pour la métrique CloudWatch équivalente dans Datadog. Comparer `Sum` dans CloudWatch à `Average` dans Datadog entraîne des écarts. Pour certaines métriques CloudWatch, plusieurs statistiques peuvent être utiles et Datadog crée des noms de métriques différents pour la même métrique CloudWatch avec des statistiques différentes. Par exemple, `aws.elb.latency` et `aws.elb.latency.maximum`. +- Dans AWS pour les compteurs, un graphique réglé sur `sum` `1 minute` affiche le nombre total d'occurrences en une minute jusqu'à ce point (le taux par minute). Datadog affiche les données brutes provenant d'AWS normalisées en valeurs par seconde, indépendamment de la période sélectionnée dans AWS. Par conséquent, vous pourriez voir une valeur inférieure dans Datadog. +- Dans l'ensemble, `min`, `max` et `avg` ont des significations différentes au sein d'AWS. AWS collecte distinctement la latence moyenne, la latence minimale et la latence maximale. Lors de la récupération des métriques depuis AWS CloudWatch, Datadog ne reçoit que la latence moyenne sous forme de série temporelle unique par ELB. Dans Datadog, lorsque vous sélectionnez `min`, `max` ou `avg`, vous contrôlez la manière dont les multiples séries temporelles sont combinées. Par exemple, demander `system.cpu.idle` sans aucun filtre renvoie une série pour chaque host rapportant cette métrique. Datadog combine ces séries temporelles en utilisant [l'agrégation spatiale][7]. Sinon, si vous avez demandé `system.cpu.idle` à partir d'un seul host, aucune agrégation n'est nécessaire et basculer entre `avg` et `max` donne le même résultat. -### Comment ajuster mes données sur Datadog pour qu'elles correspondent à celles affichées dans CloudWatch ? +### Comment puis-je ajuster mes données sur Datadog pour qu'elles correspondent aux données affichées dans CloudWatch ? {#how-do-i-adjust-my-data-on-datadog-to-match-the-data-displayed-in-cloudwatch} -AWS CloudWatch transmet ses métriques avec une granularité d'une minute à partir des données normalisées par minute. Datadog transmet ses métriques avec une granularité d'une minute à partir des données normalisées par seconde. Pour ajuster les données dans Datadog, multipliez-les par 60. Assurez-vous également que la statistique de la métrique est la même. Par exemple, la métrique `IntegrationLatency` récupère plusieurs statistiques différentes : la moyenne, le maximum, le minimum ainsi que les centiles. Dans Datadog, chacune de ces statistiques est représentée par une métrique distincte : +AWS CloudWatch rapporte les métriques avec une granularité d'une minute normalisée en données par minute. Datadog rapporte les métriques avec une granularité d'une minute normalisée en données par seconde. Pour ajuster les données dans Datadog, multipliez par 60. Assurez-vous également que la statistique de la métrique est la même. Par exemple, la métrique `IntegrationLatency` récupère un certain nombre de statistiques différentes : Moyenne, Maximum, Minimum, ainsi que des centiles. Dans Datadog, ces statistiques sont chacune représentées comme leurs propres métriques : ``` aws.apigateway.integration_latency (average) aws.apigateway.integration_latency.maximum @@ -60,9 +66,50 @@ aws.apigateway.integration_latency.p50 ``` -#### Est-il possible d'effectuer un rollup() pour ajuster mes données ? +#### Est-ce qu'un rollup() ajustera mes données ? {#will-a-rollup-adjust-my-data} + +Les rollups n'affichent pas de résultats similaires. Pour un appel rollup de `rollup(sum, 60)`, le serveur regroupe tous les points de données dans des compartiments d'une minute et renvoie la somme de chaque compartiment sous forme de point de données. Cependant, la granularité des métriques AWS est d'une minute, il n'y a donc qu'un seul point de données par compartiment, ce qui n'entraîne aucun changement. + +### Pourquoi ne vois-je pas les métriques d'un nouveau service AWS que j'ai activé ? {#why-dont-i-see-metrics-for-a-new-aws-service-i-enabled} + +Si vous avez récemment activé une nouvelle intégration de service AWS mais que vous ne voyez pas les métriques dans Datadog, vérifiez les points suivants : + +1. **Autorisations IAM** : Confirmez que le rôle IAM ou l'utilisateur IAM associé à l'intégration Datadog inclut les autorisations requises par le service. Consultez les [pages d'intégration AWS][8] individuelles pour connaître les exigences d'autorisation spécifiques au service. +2. **Région** : Confirmez que la région AWS où vos ressources sont déployées est activée sur la [page d'intégration AWS][1]. +3. **Disponibilité de CloudWatch** : Ouvrez la console CloudWatch dans AWS et confirmez que les métriques attendues existent. Certains services n'émettent pas de métriques CloudWatch tant que des conditions spécifiques ne sont pas remplies (par exemple, un ELB sans instances associées n'émet pas de métriques). +4. **Délai de sondage** : Le sondage par API collecte les métriques environ toutes les 10 minutes. Si vous utilisez [CloudWatch Metric Streams][6], prévoyez un délai de 2 à 3 minutes. Attendez au moins un cycle de sondage avant d'enquêter davantage. + +### Quelle est la différence entre le sondage par API et CloudWatch Metric Streams ? {#what-is-the-difference-between-api-polling-and-cloudwatch-metric-streams} + +|   | Sondage par API (par défaut) | CloudWatch Metric Streams | +|---|---|---| +| **Latence typique** | ~10 minutes | 2-3 minutes | +| **Configuration** | Incluse avec l'intégration AWS | Nécessite une configuration distincte avec [Amazon Data Firehose][6] | +| **Coût AWS** | Appels d'API CloudWatch `GetMetricData`Frais de diffusion CloudWatch Metric Streams et Firehose | | +| **Couverture** | Tous les espaces de noms CloudWatch standard ; les espaces de noms personnalisés nécessitent l'activation de **Collect Custom Metrics** | La plupart des espaces de noms CloudWatch (certaines exclusions s'appliquent) | +| **Espaces de noms personnalisés** | Pris en charge avec **Collect Custom Metrics** activé | Pris en charge en incluant l'espace de noms dans la configuration du flux | + +Pour plus de détails, consultez [Délai des métriques cloud][4] et le [guide CloudWatch Metric Streams][6]. + +### Pourquoi mes valeurs de métriques semblent-elles doublées après l'activation de Metric Streams ? {#why-do-my-metric-values-look-doubled-after-enabling-metric-streams} + +Lors de la transition du sondage par API vers CloudWatch Metric Streams, il existe une période de chevauchement où les deux méthodes de collecte envoient des données pour les mêmes métriques. Cela peut entraîner un doublement des valeurs de métriques dans Datadog. + +Datadog détecte automatiquement les espaces de noms diffusés et cesse de les sonder, vous n'avez donc pas besoin de désactiver manuellement le sondage par API. Laissez vos paramètres de configuration sur la [page d'intégration AWS][1] inchangés, car Datadog continue d'utiliser le sondage par API pour collecter les tags personnalisés, les métadonnées et les métriques qui ne peuvent pas être envoyés via Metric Streams (tels que `aws.s3.bucket_size_bytes` et `aws.billing.estimated_charges`). + +La détection prend généralement jusqu'à cinq minutes, mais la période de chevauchement peut se prolonger en fonction du moment où les active polling crawlers procèdent au sondage. Si les valeurs semblent toujours doublées après plusieurs minutes, consultez le [guide CloudWatch Metric Streams][6] pour le dépannage. + +### Quels services AWS nécessitent une configuration supplémentaire au-delà de l'intégration principale ? {#which-aws-services-require-additional-setup-beyond-the-core-integration} + +Certains services AWS n'émettent pas de métriques vers CloudWatch par défaut et nécessitent une configuration supplémentaire : -Les rollups n'affichent pas des résultats identiques. Pour un appel rollup correspondant à `rollup(sum, 60)`, le serveur regroupe tous les points de données en bins d'une minute et renvoie la somme de chaque bin sous forme de point de données. Toutefois, étant donné que les métriques AWS ont une granularité d'une minute et qu'il n'y a qu'un seul point de données par bin, cela n'entraîne aucun changement. +| Service | Configuration supplémentaire requise | +|---|---| +| Amazon RDS (métriques au niveau de l'OS) | Activez [Enhanced Monitoring][9] dans la console RDS | +| Amazon S3 (métriques Storage Lens) | Configurez [Storage Lens][10] dans la console S3 | +| Métriques de facturation AWS | Activez `Billing` dans l'[onglet Collecte de métriques][1], ajoutez l'autorisation `budgets:ViewBudget` et [activez les métriques de facturation][11] dans la console AWS. Consultez [Surveillez vos détails de facturation AWS][13] pour obtenir des instructions complètes. | +| Espaces de noms CloudWatch personnalisés | Activez **Collect Custom Metrics** dans l'[onglet Metric Collection][1] | +| Surveillance détaillée EC2 | Activez la [surveillance détaillée][12] par instance dans la console EC2 | [1]: https://app.datadoghq.com/integrations/amazon-web-services [2]: https://docs.datadoghq.com/fr/api/latest/aws-integration/#set-an-aws-tag-filter @@ -70,4 +117,12 @@ Les rollups n'affichent pas des résultats identiques. Pour un appel rollup corr [4]: /fr/integrations/guide/cloud-metric-delay/ [5]: /fr/help/ [6]: https://docs.datadoghq.com/fr/integrations/guide/aws-cloudwatch-metric-streams-with-kinesis-data-firehose/ -[7]: /fr/metrics/introduction/#space-aggregation \ No newline at end of file +[7]: /fr/metrics/introduction/#space-aggregation +[8]: /fr/integrations/#cat-aws +[9]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.Enabling.html +[10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html +[11]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html#turning_on_billing_metrics +[12]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-cloudwatch-new.html +[13]: /fr/integrations/guide/monitor-your-aws-billing-details/ +[14]: /fr/getting_started/integrations/aws/#filter-metrics-by-metric-name +[15]: /fr/integrations/guide/aws-metric-name-filters/ \ No newline at end of file diff --git a/hugo/content/fr/integrations/guide/aws-terraform-setup.md b/hugo/content/fr/integrations/guide/aws-terraform-setup.md index 8683291459a..b6b378a1fb6 100644 --- a/hugo/content/fr/integrations/guide/aws-terraform-setup.md +++ b/hugo/content/fr/integrations/guide/aws-terraform-setup.md @@ -1,169 +1,1138 @@ --- aliases: - /fr/integrations/faq/aws-integration-with-terraform/ +description: Configurez l'intégration Datadog-AWS avec Terraform, y compris le rôle + IAM et la ressource d'intégration. disable_toc: true further_reading: +- link: https://www.datadoghq.com/architecture/a-guide-to-integrating-100-aws-accounts-with-datadog/ + tag: Architecture Center + text: Guide pour intégrer plus de 100 comptes AWS avec Datadog - link: https://www.datadoghq.com/blog/managing-datadog-with-terraform/ tag: Blog text: Gérer Datadog avec Terraform - +- link: https://learn.datadoghq.com/courses/visibility-aws-lambda + tag: Centre d'apprentissage + text: Configurer AWS Lambda pour Serverless Monitoring avec Datadog title: Intégration AWS avec Terraform --- +En utilisant [Terraform][1], vous pouvez créer le rôle IAM Datadog, le document de politique et l'intégration Datadog-AWS avec une seule commande `terraform apply`. -L'utilisation de [Terraform][1] vous permet de créer le rôle IAM Datadog, le document de stratégie et l'intégration Datadog/AWS à l'aide d'une seule commande `terraform apply`. +1. Configurez le [fournisseur Terraform Datadog][2] pour interagir avec Datadog API via une configuration Terraform. + * Si ce n'est pas déjà fait, configurez `api_url` sur l'URL de l'API de votre site Datadog. + * **Remarque** : La ressource `datadog_integration_aws_account` a remplacé la ressource `datadog_integration_aws` dans la version `3.50.0` du fournisseur Terraform Datadog. Pour effectuer la mise à niveau depuis la ressource `datadog_integration_aws`, consultez [Mise à niveau depuis les ressources datadog_integration_aws][3]. +{{< site-region region="us,us3,us5,eu" >}} +2. Configurez votre fichier de configuration Terraform en utilisant l'exemple ci-dessous comme modèle de base. Assurez-vous de mettre à jour les paramètres suivants avant d'appliquer les modifications : + * `AWS_ACCOUNT_ID` : Votre ID de compte AWS. -1. Configurez le [fournisseur Terraform Datadog][2] pour interagir avec l'API Datadog via une configuration Terraform. +Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. -{{< site-region region="us,us3,us5,eu" >}} +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::464622532012:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +
Par défaut, la configuration ci-dessus n'inclut pas Cloud Security. Pour activer Cloud Security, sous resources_config, définissez cloud_security_posture_management_collection = true.
+ +[1]: /fr/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws_account +{{< /site-region >}} + +{{< site-region region="uk1" >}} +2. Configurez votre fichier de configuration Terraform en utilisant l'exemple ci-dessous comme modèle de base. Assurez-vous de mettre à jour les paramètres suivants avant d'appliquer les modifications : + * `AWS_ACCOUNT_ID` : Votre ID de compte AWS. + +Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. -2. Définissez votre fichier de configuration Terraform en utilisant l'exemple ci-dessous comme modèle. Mettez à jour les paramètres suivants avant d'appliquer les modifications : - * `AWS_PERMISSIONS_LIST` : Les stratégies IAM requises pour les intégrations Datadog/AWS. La liste actuelle est disponible dans la documentation de l'[intégration Datadog/AWS][1]. - * `AWS_ACCOUNT_ID` : L'ID de votre compte AWS. - - Consultez la page sur la [ressource de l'intégration Datadog/AWS][2] dans le registre Terraform pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs, ainsi que des ressources Datadog supplémentaires. - - ```hcl - data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { - statement { - actions = ["sts:AssumeRole"] - - principals { - type = "AWS" - identifiers = ["arn:aws:iam::464622532012:root"] - } - condition { - test = "StringEquals" - variable = "sts:ExternalId" - - values = [ - "${datadog_integration_aws.sandbox.external_id}" - ] - } - } - } - - data "aws_iam_policy_document" "datadog_aws_integration" { - statement { - actions = [] - - resources = ["*"] - } - } - - resource "aws_iam_policy" "datadog_aws_integration" { - name = "DatadogAWSIntegrationPolicy" - policy = "${data.aws_iam_policy_document.datadog_aws_integration.json}" - } - - resource "aws_iam_role" "datadog_aws_integration" { - name = "DatadogAWSIntegrationRole" - description = "Role for Datadog AWS Integration" - assume_role_policy = "${data.aws_iam_policy_document.datadog_aws_integration_assume_role.json}" - } - - resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { - role = "${aws_iam_role.datadog_aws_integration.name}" - policy_arn = "${aws_iam_policy.datadog_aws_integration.arn}" - } - - resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { - role = "${aws_iam_role.datadog_aws_integration.name}" - policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" - } - - resource "datadog_integration_aws" "sandbox" { - account_id = "" - role_name = "DatadogAWSIntegrationRole" - } - ``` - - [1]: /integrations/amazon_web_services/?tab=manual#aws-iam-permissions - [2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::117348461845:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +
Par défaut, la configuration ci-dessus n'inclut pas Cloud Security. Pour activer Cloud Security, sous resources_config, définissez cloud_security_posture_management_collection = true.
+ +[1]: /fr/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws_account {{< /site-region >}} {{< site-region region="ap1" >}} +2. Configurez votre fichier de configuration Terraform en utilisant l'exemple ci-dessous comme modèle de base. Assurez-vous de mettre à jour les paramètres suivants avant d'appliquer les modifications : + * `AWS_ACCOUNT_ID` : Votre ID de compte AWS. + +Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::417141415827:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] -2. Définissez votre fichier de configuration Terraform en utilisant l'exemple ci-dessous comme modèle. Mettez à jour les paramètres suivants avant d'appliquer les modifications : - * `AWS_PERMISSIONS_LIST` : Les stratégies IAM requises pour les intégrations Datadog/AWS. La liste actuelle est disponible dans la documentation de l'[intégration Datadog/AWS][1]. - * `AWS_ACCOUNT_ID` : L'ID de votre compte AWS. - - Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. - - ```hcl - data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { - statement { - actions = ["sts:AssumeRole"] - - principals { - type = "AWS" - identifiers = ["arn:aws:iam::417141415827:root"] - } - condition { - test = "StringEquals" - variable = "sts:ExternalId" - - values = [ - "${datadog_integration_aws.sandbox.external_id}" - ] - } - } - } - - data "aws_iam_policy_document" "datadog_aws_integration" { - statement { - actions = [] - - resources = ["*"] - } - } - - resource "aws_iam_policy" "datadog_aws_integration" { - name = "DatadogAWSIntegrationPolicy" - policy = "${data.aws_iam_policy_document.datadog_aws_integration.json}" - } - - resource "aws_iam_role" "datadog_aws_integration" { - name = "DatadogAWSIntegrationRole" - description = "Role for Datadog AWS Integration" - assume_role_policy = "${data.aws_iam_policy_document.datadog_aws_integration_assume_role.json}" - } - - resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { - role = "${aws_iam_role.datadog_aws_integration.name}" - policy_arn = "${aws_iam_policy.datadog_aws_integration.arn}" - } - - resource "datadog_integration_aws" "sandbox" { - account_id = "" - role_name = "DatadogAWSIntegrationRole" - } - ``` + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + + # Optionally, specify services to include for X-Ray tracing + traces_config { + xray_services { + } + } + + # Optionally, specify the ARN of the Datadog Forwarder Lambda function and sources to enable for automatic log collection + logs_config { + lambda_forwarder { + } + } + + # Optionally, specify namespaces to exclude from metric collection + metrics_config { + namespace_filters { + } + } +} +``` + +
Par défaut, la configuration ci-dessus n'inclut pas Cloud Security. Pour activer Cloud Security, sous resources_config, définissez cloud_security_posture_management_collection = true.
+ +[1]: /fr/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws +{{< /site-region >}} + +{{< site-region region="ap2" >}} +2. Configurez votre fichier de configuration Terraform en utilisant l'exemple ci-dessous comme modèle de base. Assurez-vous de mettre à jour les paramètres suivants avant d'appliquer les modifications : + * `AWS_ACCOUNT_ID` : Votre ID de compte AWS. + +Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::412381753143:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +
Par défaut, la configuration ci-dessus n'inclut pas Cloud Security. Pour activer Cloud Security, sous resources_config, définissez cloud_security_posture_management_collection = true.
+ +[1]: /fr/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws +{{< /site-region >}} + +{{< site-region region="uk1" >}} +2. Configurez votre fichier de configuration Terraform en utilisant l'exemple ci-dessous comme modèle de base. Assurez-vous de mettre à jour les paramètres suivants avant d'appliquer les modifications : + * `AWS_ACCOUNT_ID` : Votre ID de compte AWS. + +Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::117348461845:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +
Par défaut, la configuration ci-dessus n'inclut pas Cloud Security. Pour activer Cloud Security, sous resources_config, définissez cloud_security_posture_management_collection = true.
[1]: /fr/integrations/amazon_web_services/?tab=manual#aws-iam-permissions [2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws {{< /site-region >}} {{< site-region region="gov" >}} +2. Sélectionnez l'onglet correspondant à votre type de compte AWS, puis utilisez l'exemple ci-dessous comme modèle de base pour configurer votre fichier de configuration Terraform. Assurez-vous de mettre à jour les paramètres suivants avant d'appliquer les modifications : + * `AWS_ACCOUNT_ID` : Votre ID de compte AWS. + +{{< tabs >}} + +{{% tab "AWS Commercial Cloud" %}} + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::392588925713:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) -2. Si vous utilisez des clés d'accès pour installer l'intégration Datadog/AWS, assurez-vous d'avoir créé un utilisateur IAM disposant des [autorisations requises][1] ainsi que de la clé d'accès conformément aux instructions de la section [Guide de configuration manuelle d'AWS][3]. Remplacez les placeholders dans l'exemple ci-dessous par l'ID de la clé d'accès et la clé d'accès secrète. Pour en savoir plus sur l'utilisation de Terraform pour configurer l'utilisateur AWS et la clé d'accès associée, consultez les ressources [AWS Provider][2] dans le registre Terraform. + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} - ``` - resource "datadog_integration_aws" "sandbox" { - access_key_id = "" - secret_access_key = "" - } - ``` +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +{{% /tab %}} + +{{% tab "AWS GovCloud" %}} + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws-us-gov:iam::065115117704:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws-us-gov:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws-us-gov" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +{{% /tab %}} + +{{< /tabs >}} + +Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. + +
Par défaut, la configuration ci-dessus n'inclut pas Cloud Security. Pour activer Cloud Security, sous resources_config, définissez cloud_security_posture_management_collection = true.
+ +[1]: /fr/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws +{{< /site-region >}} + +{{< site-region region="gov2" >}} +2. Sélectionnez l'onglet correspondant à votre type de compte AWS, puis utilisez l'exemple ci-dessous comme modèle de base pour configurer votre fichier de configuration Terraform. Assurez-vous de mettre à jour les paramètres suivants avant d'appliquer les modifications : + * `AWS_ACCOUNT_ID` : Votre ID de compte AWS. + +{{< tabs >}} + +{{% tab "AWS Commercial Cloud" %}} + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws:iam::382742775718:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +{{% /tab %}} + +{{% tab "AWS GovCloud" %}} + +```hcl +data "aws_iam_policy_document" "datadog_aws_integration_assume_role" { + statement { + actions = ["sts:AssumeRole"] + principals { + type = "AWS" + identifiers = ["arn:aws-us-gov:iam::486737091498:root"] + } + condition { + test = "StringEquals" + variable = "sts:ExternalId" + values = [ + "${datadog_integration_aws_account.datadog_integration.auth_config.aws_auth_config_role.external_id}" + ] + } + } +} + +data "datadog_integration_aws_iam_permissions" "datadog_permissions" {} + +locals { + all_permissions = data.datadog_integration_aws_iam_permissions.datadog_permissions.iam_permissions + + max_policy_size = 6144 + target_chunk_size = 5900 + + permission_sizes = [ + for perm in local.all_permissions : + length(perm) + 3 + ] + cumulative_sizes = [ + for i in range(length(local.permission_sizes)) : + sum(slice(local.permission_sizes, 0, i + 1)) + ] + + chunk_assignments = [ + for cumulative_size in local.cumulative_sizes : + floor(cumulative_size / local.target_chunk_size) + ] + chunk_numbers = distinct(local.chunk_assignments) + permission_chunks = [ + for chunk_num in local.chunk_numbers : [ + for i, perm in local.all_permissions : + perm if local.chunk_assignments[i] == chunk_num + ] + ] +} + +data "aws_iam_policy_document" "datadog_aws_integration" { + count = length(local.permission_chunks) + + statement { + actions = local.permission_chunks[count.index] + resources = ["*"] + } +} + +resource "aws_iam_policy" "datadog_aws_integration" { + count = length(local.permission_chunks) + + name = "DatadogAWSIntegrationPolicy-${count.index + 1}" + policy = data.aws_iam_policy_document.datadog_aws_integration[count.index].json +} +resource "aws_iam_role" "datadog_aws_integration" { + name = "DatadogIntegrationRole" + description = "Role for Datadog AWS Integration" + assume_role_policy = data.aws_iam_policy_document.datadog_aws_integration_assume_role.json +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration" { + count = length(local.permission_chunks) + + role = aws_iam_role.datadog_aws_integration.name + policy_arn = aws_iam_policy.datadog_aws_integration[count.index].arn +} +resource "aws_iam_role_policy_attachment" "datadog_aws_integration_security_audit" { + role = aws_iam_role.datadog_aws_integration.name + policy_arn = "arn:aws-us-gov:iam::aws:policy/SecurityAudit" +} + +resource "datadog_integration_aws_account" "datadog_integration" { + account_tags = [] + aws_account_id = "" + aws_partition = "aws-us-gov" + aws_regions { + include_all = true + } + auth_config { + aws_auth_config_role { + role_name = "DatadogIntegrationRole" + } + } + resources_config { + cloud_security_posture_management_collection = false + extended_collection = true + } + traces_config { + xray_services { + } + } + logs_config { + lambda_forwarder { + } + } + metrics_config { + namespace_filters { + } + } +} +``` + +{{% /tab %}} + +{{< /tabs >}} + +Consultez le [registre Terraform][2] pour obtenir d'autres exemples d'utilisation, la liste complète des paramètres facultatifs ainsi que des ressources Datadog supplémentaires. + +
Par défaut, la configuration ci-dessus n'inclut pas Cloud Security. Pour activer Cloud Security, sous resources_config, définissez cloud_security_posture_management_collection = true.
+ +[1]: /fr/integrations/amazon_web_services/?tab=manual#aws-iam-permissions +[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws +{{< /site-region >}} -[1]: /fr/integrations/guide/aws-manual-setup/?tab=accesskeysgovcloudorchinaonly#aws-integration-iam-policy -[2]: https://registry.terraform.io/providers/hashicorp/aws/latest/docs -[3]: /fr/integrations/guide/aws-manual-setup/?tab=accesskeysgovcloudorchinaonly#aws -{{< /site-region>}} +3. Exécutez `terraform apply`. Attendez jusqu'à 10 minutes que la collecte des données commence, puis consultez le [dashboard de présentation AWS][4] prêt à l'emploi pour voir les métriques envoyées par vos services et votre infrastructure AWS. -3. Exécutez `terraform apply`. Patientez 10 minutes le temps que les données commencent à être recueillies, puis accédez au [dashboard récapitulatif d'AWS][5] prêt à l'emploi pour visualiser les métriques envoyées par vos services et votre infrastructure AWS. +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: https://www.terraform.io [2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs -[5]: https://app.datadoghq.com/screen/integration/7/aws-overview +[3]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/integration_aws_account#upgrading-from-datadog_integration_aws-resources +[4]: https://app.datadoghq.com/screen/integration/7/aws-overview \ No newline at end of file diff --git a/hugo/content/fr/llm_observability/build_with_ai/mcp_server.md b/hugo/content/fr/llm_observability/build_with_ai/mcp_server.md index 5595668326c..fe69f72592c 100644 --- a/hugo/content/fr/llm_observability/build_with_ai/mcp_server.md +++ b/hugo/content/fr/llm_observability/build_with_ai/mcp_server.md @@ -45,7 +45,7 @@ Connectez un client compatible MCP au Datadog MCP Server avec l'ensemble d'outil L'endpoint du serveur MCP dépend de votre [site Datadog][5]. Utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} pour afficher l'endpoint de votre site. Ajoutez `?toolsets=llmobs,core` pour activer Agent Observability et les ensembles d'outils principaux. {{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} -Endpoint pour votre site sélectionné ({{< region-param key="dd_site_name" >}}): +Endpoint pour votre site sélectionné ({{< region-param key="dd_site_name" >}}) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=llmobs,core
{{< /site-region >}} @@ -358,6 +358,9 @@ L'ensemble d'outils `llmobs` comprend les outils suivants : `list_llmobs_evals_by_ml_app` : List all LLM-judge evaluators configured for a specific ML application. → Listez tous les évaluateurs LLM-judge configurés pour une application ML spécifique. +`list_llmobs_feedback_labels` +: Lister toutes les étiquettes de commentaires soumises par les utilisateurs finaux pour une application d'apprentissage automatique spécifique. + `get_llmobs_evaluator` : Retrieve an LLM-judge evaluator configuration by name, including its target (ml_app, sampling, filter), LLM provider, and judge prompt template. → Récupérez la configuration d'un évaluateur LLM-judge par son nom, incluant sa cible (ml_app, échantillonnage, filtre), le fournisseur LLM et le modèle de prompt de l'évaluateur. diff --git a/hugo/content/fr/llm_observability/instrument/sdk.md b/hugo/content/fr/llm_observability/instrument/sdk.md index 20f38e173d1..dfdb9596d3b 100644 --- a/hugo/content/fr/llm_observability/instrument/sdk.md +++ b/hugo/content/fr/llm_observability/instrument/sdk.md @@ -171,9 +171,13 @@ Vous pouvez fournir les paramètres suivants sous forme de variables d'environne
**Remarque**: Avant la version 1.54.0 de `dd-trace-java`, il s'agit d'un **champ obligatoire**. `DD_LLMOBS_AGENTLESS_ENABLED` ou `dd.llmobs.agentless.enabled` -: facultatif - _entier ou chaîne de caractères_ - **par défaut** : `false` +: facultatif - _entier ou chaîne_ - **par défaut**: `false`
Requis uniquement si vous n'utilisez pas le Datadog Agent, auquel cas cela doit être défini sur `1` ou `true`. +`DD_LLMOBS_SAMPLE_RATE` ou `dd.llmobs.sample.rate` +: facultatif - _nombre à virgule flottante_ - **par défaut** : `1.0` +
La fraction de traces conservée par Agent Observability. Nécessite `dd-trace-java` 1.66.0 ou une version ultérieure. Voir [Échantillonnage de traces](#trace-sampling). + `DD_API_KEY` ou `dd.api.key` : optionnel - _ chaîne_
Votre clé d'API Datadog. Requis uniquement si vous n'utilisez pas le Datadog Agent. @@ -317,7 +321,7 @@ Après avoir installé le SDK et exécuté votre application, vous devriez voir ## Échantillonnage des traces {#trace-sampling} -
L'échantillonnage des traces est disponible dans le SDK Python (ddtrace 4.12.0 ou version ultérieure) et le SDK Node.js (dd-trace 5.110.0 ou version ultérieure). Le SDK Java ne prend pas en charge l'échantillonnage des traces.
+
L'échantillonnage des traces est disponible dans le SDK Python (ddtrace 4.12.0 ou une version ultérieure), le SDK Node.js (dd-trace 5.110.0 ou une version ultérieure), et le SDK Java (dd-trace-java 1.66.0 ou une version ultérieure).
L'échantillonnage des traces définit la fraction de traces qu'Agent Observability conserve. Comme la facturation d'Agent Observability est basée sur le volume de spans que vous envoyez, définir un taux d'échantillonnage est un moyen de contrôler vos coûts liés à Agent Observability. Le SDK prend la décision d'échantillonnage sur le span racine et l'applique à tous les spans enfants de ce span racine, y compris les spans créés dans les services en aval via le [ tracing distribué](#distributed-tracing). @@ -325,8 +329,8 @@ L'échantillonnage n'affecte pas vos [métriques Agent Observability](/llm_obser Configurez le taux d'échantillonnage via l'un des deux mécanismes suivants : -- **Variable d'environnement** (`DD_LLMOBS_SAMPLE_RATE`) : s'applique à la fois à la [configuration en ligne de commande](#command-line-setup) et à la [configuration dans le code](#in-code-setup). -- **Paramètre dans le code** (`sample_rate` en Python, `sampleRate` en Node.js) : transmis à `LLMObs.enable()` en Python, ou sous `llmobs` en Node.js, lorsque vous activez le SDK avec la [configuration dans le code](#in-code-setup). Lorsqu'il est défini, il prévaut sur `DD_LLMOBS_SAMPLE_RATE`. +- **Variable d'environnement** (`DD_LLMOBS_SAMPLE_RATE`) : s'applique à la fois à la [configuration en ligne de commande](#command-line-setup) et à la [configuration dans le code](#in-code-setup). En Java, la propriété système `dd.llmobs.sample.rate` définit la même valeur. +- **Paramètre dans le code** (`sample_rate` en Python, `sampleRate` en Node.js) : transmis à `LLMObs.enable()` en Python, ou sous `llmobs` en Node.js, lorsque vous activez le SDK avec la [configuration dans le code](#in-code-setup). Lorsqu'il est défini, il prévaut sur `DD_LLMOBS_SAMPLE_RATE`. Le SDK Java n'a pas d'équivalent dans le code. Le taux d'échantillonnage est un nombre à virgule flottante compris entre `0.0` (aucune trace conservée) et `1.0` (toutes les traces conservées). La valeur par défaut est `1.0`. Les valeurs hors plage sont ignorées. @@ -370,6 +374,25 @@ const tracer = require('dd-trace').init({ const llmobs = tracer.llmobs; {{< /code-block >}} {{% /tab %}} + +{{% tab "Java" %}} +Définissez le taux d'échantillonnage avec la variable d'environnement : + +{{< code-block lang="shell" >}} +DD_LLMOBS_SAMPLE_RATE=0.5 \ +java -javaagent:path/to/your/dd-trace-java-jar/dd-java-agent-SNAPSHOT.jar \ +-Ddd.service=my-app -Ddd.llmobs.enabled=true -Ddd.llmobs.ml.app= \ +-jar path/to/your/app.jar +{{< /code-block >}} + +Ou définissez la propriété système équivalente `dd.llmobs.sample.rate` : + +{{< code-block lang="shell" >}} +java -javaagent:path/to/your/dd-trace-java-jar/dd-java-agent-SNAPSHOT.jar \ +-Ddd.service=my-app -Ddd.llmobs.enabled=true -Ddd.llmobs.ml.app= \ +-Ddd.llmobs.sample.rate=0.5 -jar path/to/your/app.jar +{{< /code-block >}} +{{% /tab %}} {{< /tabs >}} ## Instrumentation manuelle {#manual-instrumentation} @@ -1307,11 +1330,11 @@ La méthode `LLMObs.annotate()` accepte les arguments suivants : `input_data` : optionnel - _type sérialisable en JSON ou liste de dictionnaires_ -
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste de dictionnaires avec ce format: `{"content": \"...\", \"role\": \"...\", \"tool_calls\": ..., \"tool_results\": ..., \"audio_parts\": ..., \"image_parts\": ...}`, où `"tool_calls"` est une liste optionnelle de dictionnaires d'appels d'outils avec les clés requises : `"name"`, `"arguments"`, et `"tool_id"` , `"type"` et `"tool_results"` est une liste optionnelle de dictionnaires de résultats d'outils avec la clé requise : `"result"`, et les clés optionnelles : `"name"`, `"tool_id"`, `"type"` pour les scénarios d'appel de fonction. `"audio_parts"` et `"image_parts"` sont des listes facultatives de dictionnaires de médias pour les spans multimodaux, chacun avec un `"mime_type"` requis et exactement l'un des suivants : `"content"` (média encodé en base64, inclus en ligne) ou `"attachment_key"`. **Note** : Les spans d'embedding sont un cas particulier et nécessitent une chaîne ou un dictionnaire (ou une liste de dictionnaires) avec ce format : `{"text": "..."}`. +
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste de dictionnaires avec ce format: `{"content": \"...\", \"role\": \"...\", \"tool_calls\": ..., \"tool_results\": ..., \"audio_parts\": ..., \"image_parts\": ...}`, où `"tool_calls"` est une liste optionnelle de dictionnaires d'appels d'outils avec les clés requises : `"name"`, `"arguments"`, et `"tool_id"` , `"type"` et `"tool_results"` est une liste optionnelle de dictionnaires de résultats d'outils avec la clé requise : `"result"`, et les clés optionnelles : `"name"`, `"tool_id"`, `"type"` pour les scénarios d'appel de fonction. `"audio_parts"` et `"image_parts"` sont des listes facultatives de dictionnaires multimédias pour les étendues multimodales, chacune avec un `"mime_type"` et un `"content"` requis (média encodé en base64, intégré en ligne). **Note** : Les spans d'embedding sont un cas particulier et nécessitent une chaîne ou un dictionnaire (ou une liste de dictionnaires) avec ce format : `{"text": "..."}`. `output_data` a: facultatif - _type sérialisable en JSON ou liste de dictionnaires_ -
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste de dictionnaires avec ce format : `{"content": "...", "role": "...", "tool_calls": ..., "audio_parts": ..., "image_parts": ...}`, où `"tool_calls"` est une liste facultative de dictionnaires d'appels d'outils avec les clés requises : `"name"`, `"arguments"`, et les clés facultatives : `"tool_id"`, `"type"` pour les scénarios d'appel de fonction. `"audio_parts"` et `"image_parts"` sont des listes facultatives de dictionnaires de médias pour les spans multimodaux, chacun avec un `"mime_type"` requis et exactement l'un des suivants : `"content"` (média encodé en base64, inclus en ligne) ou `"attachment_key"`. **Note** : Les spans de récupération sont un cas particulier et nécessitent une chaîne ou un dictionnaire (ou une liste de dictionnaires) avec ce format : `{"text": "...", "name": "...", "score": float, "id": "..."}`. +
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste de dictionnaires avec ce format : `{"content": "...", "role": "...", "tool_calls": ..., "audio_parts": ..., "image_parts": ...}`, où `"tool_calls"` est une liste facultative de dictionnaires d'appels d'outils avec les clés requises : `"name"`, `"arguments"`, et les clés facultatives : `"tool_id"`, `"type"` pour les scénarios d'appel de fonction. `"audio_parts"` et `"image_parts"` sont des listes facultatives de dictionnaires multimédias pour les étendues multimodales, chacune avec un `"mime_type"` et un `"content"` requis (média encodé en base64, intégré en ligne). **Note** : Les spans de récupération sont un cas particulier et nécessitent une chaîne ou un dictionnaire (ou une liste de dictionnaires) avec ce format : `{"text": "...", "name": "...", "score": float, "id": "..."}`. `tool_definitions` a: facultatif - _liste de dictionnaires_ @@ -1435,11 +1458,7 @@ def describe_image(image_bytes): {{< /code-block >}} -Les messages annotés avec `audio_parts` ou `image_parts` s'affichent sous forme de lecteurs audio et d'images intégrés dans la vue de trace : - -{{< img src="llm_observability/instrumentation/audio_example.png" alt="Un span LLM dans la vue de trace Agent Observability. Le message d'entrée de l'UTILISATEUR affiche un lecteur audio intégré avec la transcription « Hey, how are you? », et le message de sortie de l'ASSISTANT affiche une commande « Click to play audio » avec la transcription « Hey! ». Je vais très bien, merci de demander. « How about you? »." style="width:100%;" >}} - -{{< img src="llm_observability/instrumentation/image_example.png" alt="Un span LLM dans la vue de trace Agent Observability. Le message d'entrée de l'UTILISATEUR affiche l'invite « What is in this image? ». avec une photo intégrée d'un chiot noir, et le message de sortie de l'ASSISTANT le décrit comme un chiot Labrador Retriever noir sur une surface en bois." style="width:100%;" >}} +Les messages annotés avec `audio_parts` ou `image_parts` s'affichent sous forme de lecteurs audio et d'images intégrés dans la vue de trace. Pour des exemples rendus, les formats pris en charge, les limites de taille et les intégrations qui remplissent automatiquement ces champs, consultez [Support multimodal](/llm_observability/instrument/multimodal/). {{% /tab %}} @@ -1461,11 +1480,11 @@ L'objet `annotationOptions` peut contenir les éléments suivants : `inputData` : facultatif - _type sérialisable en JSON ou liste d'objets_ -
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste de dictionnaires avec ce format: `{role: \"...\", content: \"...\", audioParts: [...], imageParts: [...]}` (pour les spans LLM). `audioParts` et `imageParts` sont des listes facultatives d'objets multimédias pour les spans multimodaux, chacun avec un `mimeType` requis et exactement un élément parmi `content` (média encodé en base64, transporté en ligne) ou `attachmentKey`. **Remarque** : Les spans d'embedding sont un cas particulier et nécessitent une chaîne ou un objet (ou une liste d'objets) avec ce format : `{text: "..."}`. +
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste de dictionnaires avec ce format: `{role: \"...\", content: \"...\", audioParts: [...], imageParts: [...]}` (pour les spans LLM). `audioParts` et `imageParts` sont des listes facultatives d'objets multimédias pour les étendues multimodales, chacune avec un `mimeType` et un `content` requis (média encodé en base64, intégré en ligne). **Remarque** : Les spans d'embedding sont un cas particulier et nécessitent une chaîne ou un objet (ou une liste d'objets) avec ce format : `{text: "..."}`. `outputData` : facultatif - _type sérialisable en JSON ou liste d'objets_ -
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste d'objets avec ce format : `{role: "...", content: "...", audioParts: [...], imageParts: [...]}` (pour les spans LLM). `audioParts` et `imageParts` sont des listes facultatives d'objets multimédias pour les spans multimodaux, chacun avec un `mimeType` requis et exactement un élément parmi `content` (média encodé en base64, transporté en ligne) ou `attachmentKey`. **Remarque** : Les spans de récupération sont un cas particulier et nécessitent une chaîne ou un objet (ou une liste d'objets) avec ce format : `{text: "...", name: "...", score: number, id: "..."}`. +
Soit un type sérialisable en JSON (pour les spans non-LLM), soit une liste d'objets avec ce format : `{role: "...", content: "...", audioParts: [...], imageParts: [...]}` (pour les spans LLM). `audioParts` et `imageParts` sont des listes facultatives d'objets multimédias pour les étendues multimodales, chacune avec un `mimeType` et un `content` requis (média encodé en base64, intégré en ligne). **Remarque** : Les spans de récupération sont un cas particulier et nécessitent une chaîne ou un objet (ou une liste d'objets) avec ce format : `{text: "...", name: "...", score: number, id: "..."}`. `metadata` : facultatif - _objet_ @@ -1576,13 +1595,9 @@ describeImage = llmobs.wrap({ kind: 'llm', modelName: 'gpt-4o', modelProvider: ' {{< /code-block >}} -Les messages annotés avec `audioParts` ou `imageParts` s'affichent sous forme de lecteurs audio et d'images intégrés dans la vue de trace : - -{{< img src="llm_observability/instrumentation/audio_example.png" alt="Un span LLM dans la vue de trace Agent Observability. Le message d'entrée de l'UTILISATEUR affiche un lecteur audio intégré avec la transcription « Hey, how are you? », et le message de sortie de l'ASSISTANT affiche une commande « Click to play audio » avec la transcription « Hey! ». Je vais très bien, merci de demander. « How about you? »." style="width:100%;" >}} - -{{< img src="llm_observability/instrumentation/image_example.png" alt="Un span LLM dans la vue de trace Agent Observability. Le message d'entrée de l'UTILISATEUR affiche l'invite « What is in this image? ». avec une photo intégrée d'un chiot noir, et le message de sortie de l'ASSISTANT le décrit comme un chiot Labrador Retriever noir sur une surface en bois." style="width:100%;" >}} +Les messages annotés avec `audioParts` ou `imageParts` s'affichent sous forme de lecteurs audio et d'images intégrés dans la vue de trace. Pour des exemples rendus, les formats pris en charge, les limites de taille et les intégrations qui remplissent automatiquement ces champs, consultez [Support multimodal](/llm_observability/instrument/multimodal/). -Pour les complétions de chat audio OpenAI, `audioParts` sont également capturés automatiquement par [les intégrations LLM de Datadog](/llm_observability/instrument/auto_instrumentation/) — aucune annotation manuelle n'est requise. Contrairement à `audioParts`, `imageParts` ne sont actuellement pas capturés automatiquement et doivent être annotés manuellement ; une capture automatique est prévue pour une version ultérieure. +Pour les complétions de chat audio OpenAI, `audioParts` sont également capturés automatiquement par [les intégrations LLM de Datadog](/llm_observability/instrument/auto_instrumentation/), sans aucune annotation manuelle requise. Le SDK Node.js ne capture pas `imageParts` automatiquement. Annotez-les comme indiqué ci-dessus. {{% /tab %}} {{% tab "Java" %}} @@ -2879,7 +2894,7 @@ Le constructeur accepte les méthodes suivantes :
Une explication textuelle du feedback. {{% /collapse-content %}} -**Note**: `LLMObs.submitFeedback()` valide le commentaire et génère une `IllegalArgumentException` lorsque l'Agent Observability est activé et que le commentaire est invalide, par exemple lorsque la cible, la valeur ou l'expéditeur est manquant. Lorsque l'Agent Observability est désactivé, ou que l'Agent n'est pas attaché, l'appel est un no-op. +**Note**: `LLMObs.submitFeedback()` valide le commentaire et génère une `IllegalArgumentException` lorsque Agent Observability est activé et que le commentaire est invalide, par exemple lorsque la cible, la valeur ou l'expéditeur est manquant. Lorsque l'Agent Observability est désactivé, ou que l'Agent n'est pas attaché, l'appel est un no-op. #### Exemple {#example-31} diff --git a/hugo/content/fr/logs/log_configuration/logs_to_metrics.md b/hugo/content/fr/logs/log_configuration/logs_to_metrics.md index f0c812c3e34..f54d872344d 100644 --- a/hugo/content/fr/logs/log_configuration/logs_to_metrics.md +++ b/hugo/content/fr/logs/log_configuration/logs_to_metrics.md @@ -27,7 +27,7 @@ La fonctionnalité [Logging without Limits][1]* de Datadog vous permet de décid Avec des métriques basées sur des logs, vous pouvez générer une métrique count représentant le nombre de logs qui correspondent à une requête, ou une [métrique de distribution][3] représentant une valeur numérique contenue dans des logs, comme la durée des requêtes. -**Note de facturation :** Les métriques créées à partir de logs ingérés sont facturées en tant que [Custom Metrics][4]. +**Note de facturation :** Les métriques créées à partir de logs ingérés sont facturées en tant que [métriques personnalisées][4]. ## Générer une métrique basée sur les logs {#generate-a-log-based-metric} @@ -37,7 +37,7 @@ Pour générer une nouvelle métrique basée sur les logs : 1. Accédez à la page [Generate Metrics][5]. 1. Sélectionnez l'onglet {{< ui >}}Generate Metrics{{< /ui >}}. -1. Cliquez sur {{< ui >}}+New Metric{{< /ui >}}. +1. Cliquez {{< ui >}}\+ New Metric{{< /ui >}}. Vous pouvez également créer des métriques à partir d'une recherche Analytics en sélectionnant l'option {{< ui >}}Generate new metric{{< /ui >}} dans le menu {{< ui >}}Export{{< /ui >}}. diff --git a/hugo/content/fr/mcp_server/setup.md b/hugo/content/fr/mcp_server/setup.md index 5c8d993a31c..bb2968cf236 100644 --- a/hugo/content/fr/mcp_server/setup.md +++ b/hugo/content/fr/mcp_server/setup.md @@ -7,37 +7,41 @@ algolia: - setup aliases: - /fr/bits_ai/mcp_server/setup/ -description: Apprenez à connecter votre agent IA au serveur Datadog MCP. +description: Apprenez à connecter votre agent IA au Datadog MCP Server. further_reading: - link: mcp_server tag: Documentation - text: Serveur Datadog MCP + text: Datadog MCP Server - link: mcp_server/tools tag: Documentation - text: Outils du serveur Datadog MCP -- link: ide_plugins/vscode/?tab=cursor - tag: Documentation - text: Extension Datadog pour Cursor -title: Configurer le serveur Datadog MCP + text: Outils de Datadog MCP Server +- link: https://www.datadoghq.com/blog/kubernetes-mcp-tools/ + tag: Blog + text: Examinez les ressources Kubernetes avec les outils Datadog MCP +- link: https://www.datadoghq.com/blog/datadog-ai-agent-integrations/ + tag: Blog + text: Intégrez la télémétrie Datadog en temps réel dans vos agents IA grâce à des + intégrations natives +title: Configurer Datadog MCP Server --- -Apprenez à configurer et à paramétrer le serveur Datadog MCP, qui vous permet de récupérer des informations de télémétrie et de gérer les fonctionnalités de la plateforme directement depuis des clients alimentés par l'IA. Sélectionnez votre client : +Apprenez à installer et à configurer le Datadog MCP Server, qui vous permet de récupérer des informations de télémétrie et de gérer les fonctionnalités de la plateforme directement depuis des clients basés sur l'IA. Sélectionnez votre client : {{< tabs >}} {{% tab "ChatGPT" %}} -Connectez Datadog à ChatGPT en installant l'[application Datadog][1] depuis le répertoire d'applications de ChatGPT. L'application s'authentifie avec votre organisation Datadog via un flux OAuth. +Connectez Datadog à ChatGPT en installant l'[application Datadog][1] depuis le répertoire d'applications de ChatGPT. L'application s'authentifie auprès de votre organisation Datadog via un flux OAuth. {{< site-region region="us" >}} -
L'application Datadog ChatGPT est en aperçu. Pendant l'aperçu, elle est disponible uniquement pour les clients US1.
+
L'application Datadog pour ChatGPT est en version préliminaire. Pendant la version préliminaire, elle est disponible uniquement pour les clients US1.
-1. Dans ChatGPT, allez à {{< ui >}}Settings{{< /ui >}} > {{< ui >}}Apps{{< /ui >}} > {{< ui >}}Browse Apps{{< /ui >}} et recherchez **Datadog**. Si l'application Datadog n'est pas disponible, contactez l'administrateur ChatGPT de votre organisation pour obtenir une approbation. -1. Sélectionnez l'application, cliquez sur {{< ui >}}Connect{{< /ui >}}, et suivez la configuration guidée. -1. Complétez le flux de connexion OAuth lorsque cela est demandé. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour accéder aux ressources Datadog auxquelles vous souhaitez accéder. +1. Dans ChatGPT, accédez à {{< ui >}}Settings{{< /ui >}} > {{< ui >}}Apps{{< /ui >}} > {{< ui >}}Browse Apps{{< /ui >}} et recherchez **Datadog**. Si l'application Datadog n'est pas disponible, contactez l'administrateur ChatGPT de votre organisation pour obtenir une approbation. +1. Sélectionnez l'application, cliquez sur {{< ui >}}Connect{{< /ui >}} et suivez la configuration guidée. +1. Terminez le flux de connexion OAuth lorsque vous y êtes invité. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. {{< /site-region >}} -{{< site-region region="us3,us5,eu,ap1,ap2,gov,gov2" >}} -
L'application Datadog ChatGPT n'est pas prise en charge pour votre site Datadog sélectionné ({{< region-param key="dd_site_name" >}}).
+{{< site-region region="us3,us5,eu,ap1,ap2,uk1,gov,gov2" >}} +
L'application Datadog pour ChatGPT n'est pas prise en charge pour le site Datadog sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [1]: https://chatgpt.com/apps/datadog--preview/asdk_app_69e8c7f174a08191a28b6da96c8062c4 @@ -45,61 +49,63 @@ Connectez Datadog à ChatGPT en installant l'[application Datadog][1] depuis le {{% tab "Claude" %}} -Installez le [connecteur Datadog](https://claude.ai/directory/connectors/datadog) depuis le répertoire des connecteurs Claude. Le connecteur officiel est la méthode recommandée pour connecter Datadog à Claude (y compris Claude Cowork) et inclut des applications MCP pour des visualisations dans le produit. Si vous avez précédemment ajouté Datadog en tant que connecteur personnalisé, supprimez-le pour éviter les conflits. +Installez le [connecteur Datadog](https://claude.ai/directory/connectors/datadog) depuis le répertoire des connecteurs Claude. Le connecteur officiel est la méthode recommandée pour connecter Datadog à Claude (y compris Claude Cowork) et inclut des applications MCP pour les visualisations intégrées au produit. Si vous avez précédemment ajouté Datadog en tant que connecteur personnalisé, supprimez-le pour éviter les conflits. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -1. Dans Claude, cliquez sur l'icône **+** en bas de n'importe quelle invite, puis cliquez sur {{< ui >}}Add Connector{{< /ui >}}. -1. Trouvez **Datadog** dans le répertoire et activez le connecteur. -1. Complétez le flux de connexion OAuth lorsque cela est demandé. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +1. Dans Claude, cliquez sur l'icône {{< ui >}}\+{{< /ui >}} en bas de n'importe quelle invite, puis cliquez sur {{< ui >}}Add Connector{{< /ui >}}. +1. Recherchez **Datadog** dans le répertoire et activez le connecteur. +1. Terminez le flux de connexion OAuth lorsque vous y êtes invité. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. {{% collapse-content title="Configuration manuelle avec un connecteur personnalisé" level="h4" expanded=false id="claude-custom-connector" %}} -Si le connecteur du répertoire n'est pas disponible pour vous, vous pouvez ajouter Datadog en tant que [connecteur personnalisé](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) en utilisant l'URL MCP distante pour votre [site Datadog](/getting_started/site/) ({{< region-param key="dd_site_name" >}}). Pour les instructions correctes, utilisez le {{< ui >}}Datadog Site{{< /ui >}}sélecteur sur le côté droit de cette page de documentation pour sélectionner votre site. +Si le connecteur de répertoire ne vous est pas accessible, vous pouvez ajouter Datadog en tant que [connecteur personnalisé](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) en utilisant l'URL MCP distante pour votre [site Datadog](/getting_started/site/) ({{< region-param key="dd_site_name" >}}). Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -1. Suivez le guide du centre d'aide Claude sur [les connecteurs personnalisés](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) pour ajouter un nouveau connecteur personnalisé. +1. Suivez le guide du centre d'aide Claude sur les [connecteurs personnalisés](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) pour ajouter un nouveau connecteur personnalisé. -1. Lorsque vous êtes invité à entrer une URL, saisissez : +1. Lorsque vous êtes invité à saisir une URL, entrez :
{{< region-param key="mcp_server_endpoint" >}}
- Pour activer [des outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients qui prennent en charge le filtrage des outils) : + Pour activer des [outils spécifiques au produit](#toolsets), ajoutez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint : Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Complétez le flux de connexion OAuth lorsque cela est demandé. +1. Terminez le flux de connexion OAuth lorsque vous y êtes invité. {{% /collapse-content %}} {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site Datadog sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour votre site Datadog sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} {{% /tab %}} {{% tab "Claude Code" %}} -Installez le Datadog plugin depuis le [official Anthropic Plugin Marketplace](https://code.claude.com/docs/en/discover-plugins#official-anthropic-marketplace). Le plugin regroupe le serveur MCP Datadog avec des compétences intégrées et se met à jour automatiquement lorsque de nouvelles versions de plugins sont publiées. Pour plus de détails, consultez le [dépôt de plugins](https://github.com/datadog-labs/claude-code-plugin). Si vous avez précédemment installé le serveur MCP Datadog manuellement, retirez-le de votre configuration Claude Code pour éviter les conflits. +Installez le plugin Datadog depuis l'[Anthropic Plugin Marketplace officielle](https://code.claude.com/docs/en/discover-plugins#official-anthropic-marketplace). Le plugin regroupe le Datadog MCP Server avec des compétences intégrées et se met à jour automatiquement lors de la sortie de nouvelles versions du plugin. Pour plus de détails, consultez le [dépôt du plugin](https://github.com/datadog-labs/claude-code-plugin). -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} +**Remarque** : Si vous avez précédemment installé le Datadog MCP Server manuellement, supprimez-le de votre configuration Claude Code pour éviter les conflits. + +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} 1. Installez le plugin Datadog :
/plugin install datadog@claude-plugins-official
-1. Pour la première configuration, exécutez `/ddsetup` ou entrez toute invite liée à Datadog. Lors de la configuration, sélectionnez votre [site Datadog](/getting_started/site/) et complétez la connexion OAuth. Alternativement, définissez le domaine du serveur MCP (et éventuellement les clés API et d'application Datadog) comme variables d'environnement avant de démarrer Claude Code. +1. Pour une première configuration, exécutez `/ddsetup` ou saisissez n'importe quelle invite liée à Datadog . Lors de la configuration, sélectionnez votre [site Datadog](/getting_started/site/) et terminez la connexion OAuth. Sinon, définissez le domaine du serveur MCP (et éventuellement les clés d'API et d'application Datadog) en tant que variables d'environnement avant de démarrer Claude Code. -1. Exécutez `/ddtoolsets` pour activer ou désactiver des groupes d'[outils MCP spécifiques au produit](#toolsets). +1. Exécutez `/ddtoolsets` pour activer ou désactiver des groupes d'[outils MCP spécifiques au produit](#toolsets) . -1. Après avoir effectué tout changement de configuration, exécutez `/reload-plugins` et réauthentifiez-vous en ouvrant `/plugin` et en sélectionnant le plugin Datadog. +1. Après avoir effectué toute modification de configuration, exécutez `/reload-plugins` et réauthentifiez-vous en ouvrant `/plugin` et en sélectionnant le plugin Datadog. -1. Vérifiez que vous avez les [permissions](#required-permissions) requises pour accéder aux ressources Datadog que vous souhaitez utiliser. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. -
Consultez le dépôt de plugins pour toutes les commandes slash disponibles et les options de configuration.
+
Consultez le dépôt du plugin pour connaître toutes les commandes slash et options de configuration disponibles.
{{% collapse-content title="Configuration manuelle du serveur MCP" level="h4" expanded=false id="claudecode-manual" %}} -Si le plugin n'est pas disponible pour vous, pointez Claude Code vers le point de terminaison du serveur MCP pour votre [site Datadog](/getting_started/site/) régional directement. Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +Si le plugin ne vous est pas accessible, indiquez directement à Claude Code l'endpoint du serveur MCP pour votre [site Datadog](/getting_started/site/) régional. Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. 1. Exécutez dans le terminal :
claude mcp add --transport http datadog-mcp {{< region-param key="mcp_server_endpoint" >}}
- Alternativement, ajoutez à `~/.claude.json` : + Sinon, ajoutez à `~/.claude.json` :
{
       "mcpServers": {
         "datadog": {
@@ -109,17 +115,17 @@ Si le plugin n'est pas disponible pour vous, pointez Claude Code vers le point d
        }
     }
-1. Pour activer [des outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, idéal pour les clients qui prennent en charge le filtrage des outils) : +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-
Si l'authentification à distance n'est pas disponible, utilisez l'authentification binaire locale à la place.
+
Si l'authentification à distance n'est pas disponible, utilisez plutôt l'authentification binaire locale.
{{% /collapse-content %}} {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} @@ -127,53 +133,106 @@ Si le plugin n'est pas disponible pour vous, pointez Claude Code vers le point d {{% tab "Codex" %}} -Dirigez votre agent IA vers le point de terminaison du serveur MCP pour votre [Datadog site][1] régional. Pour les instructions correctes, utilisez le {{< ui >}}Datadog Site{{< /ui >}}sélecteur sur le côté droit de cette page de documentation pour sélectionner votre site. +Indiquez à votre agent IA l'endpoint du serveur MCP pour votre [site Datadog][1] régional. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. -1. Modifiez `~/.codex/config.toml` (ou votre fichier de configuration Codex CLI) pour ajouter le serveur MCP Datadog avec transport HTTP et l'URL de point de terminaison pour votre site. Exemple : +1. Modifiez `~/.codex/config.toml` (ou votre fichier de configuration CLI Codex) pour ajouter le Datadog MCP Server avec le transport HTTP et l'URL de l'endpoint pour votre site. Exemple :
[mcp_servers.datadog]
    url = "{{< region-param key="mcp_server_endpoint" >}}"
    
- Pour activer [des outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients qui prennent en charge le filtrage des outils) : + Pour activer des [outils spécifiques au produit](#toolsets), définissez un en-tête `X-Datadog-MCP-Toolsets` dans le fichier `config.toml` sur la ligne après l'URL. Par exemple, cet en-tête active _uniquement_ les outils APM et Agent Observability (utilisez `X-Datadog-MCP-Toolsets = "all"` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients qui prennent en charge le filtrage des outils) : -
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
+
http_headers = { "X-Datadog-MCP-Toolsets" = "apm,llmobs" }
-1. Connectez-vous au serveur MCP Datadog : +1. Connectez-vous au Datadog MCP Server : ```shell codex mcp login datadog ``` - Cela ouvre votre navigateur pour compléter le flux OAuth. Codex stocke les identifiants résultants afin que vous n'ayez pas besoin de vous reconnecter jusqu'à l'expiration du jeton. + Cela ouvre votre navigateur pour terminer le flux OAuth. Codex stocke les identifiants résultants afin que vous n'ayez pas besoin de vous reconnecter avant l'expiration du jeton. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour accéder aux ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. -
Le Plugin Codex (Aperçu) ne peut être utilisé que dans l'application de bureau Codex dans la région US1. Pour installer, utilisez les instructions de l'application ChatGPT. Après avoir installé l'application ChatGPT, le plugin Codex est automatiquement inclus. +
Le plugin Codex (Aperçu) ne peut être utilisé que dans l'application Codex Desktop dans la région US1. Pour l'installer, suivez les instructions de l'application ChatGPT. Après avoir installé l'application ChatGPT, le plugin Codex est également inclus automatiquement.
{{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [1]: /fr/getting_started/site/ {{% /tab %}} -{{% tab "Cursor" %}} +{{% tab "Copilot CLI" %}} -Installez le [Datadog Plugin][1] depuis le Cursor Marketplace—le plugin inclut le serveur MCP Datadog et d'autres ressources. Si vous avez précédemment installé le serveur MCP Datadog manuellement, retirez-le de la configuration de l'IDE pour éviter les conflits. +Installez le plugin Datadog depuis la [`awesome-copilot`](https://awesome-copilot.github.com/) marketplace de plugins. Le plugin regroupe le Datadog MCP Server avec des compétences intégrées et se met à jour automatiquement lors de la sortie de nouvelles versions du plugin. Pour plus de détails, consultez le dépôt [copilot-plugin](https://github.com/datadog-labs/copilot-plugin) de Datadog. + +**Remarque** : Si vous avez précédemment installé le Datadog MCP Server manuellement, supprimez-le de votre configuration Copilot avant d'installer le plugin pour éviter les conflits. {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -1. Vous pouvez installer le plugin depuis le Cursor Marketplace ou depuis l'intérieur de Cursor : - - Depuis le Cursor Marketplace, ouvrez le [Datadog Plugin][1] et cliquez sur **Ajouter à Cursor**. - - Dans Cursor, accédez à **Paramètres de Cursor** > **Plugins**, puis recherchez le plugin Datadog et cliquez sur **Ajouter à Cursor**. +1. Installez le plugin Datadog : +
copilot plugin install datadog@awesome-copilot
+ +1. Pour une première configuration, exécutez `/ddsetup` ou saisissez n'importe quelle invite liée à Datadog . Lors de la configuration, sélectionnez votre [site Datadog](/getting_started/site/) et terminez la connexion OAuth. Alternativement, définissez le domaine du serveur MCP (et éventuellement les clés d'API et d'application Datadog) en tant que variables d'environnement avant de démarrer Copilot. + +1. Exécutez `/ddtoolsets` pour activer ou désactiver des groupes d'[outils MCP spécifiques au produit](#toolsets) . + +1. Après avoir effectué toute modification de configuration, redémarrez `copilot` et réauthentifiez le Datadog MCP Server. + +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. + +
Consultez le dépôt copilot-plugin pour connaître toutes les commandes slash et options de configuration disponibles.
+ +{{% collapse-content title="Configuration manuelle du serveur MCP" level="h4" expanded=false id="copilot-manual" %}} +Si le plugin ne vous est pas accessible, pointez directement Copilot vers l'endpoint du serveur MCP pour votre [site Datadog](/getting_started/site/) régional. Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. + +1. Exécutez dans le terminal : +
copilot mcp add --transport http datadog-mcp {{< region-param key="mcp_server_endpoint" >}}
+ + Sinon, ajoutez à `~/.copilot/mcp-config.json` : +
{
+      "servers": {
+        "datadog": {
+          "type": "http",
+          "url": "{{< region-param key="mcp_server_endpoint" >}}"
+         }
+       }
+    }
+ +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) : + +
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
+ +{{% /collapse-content %}} +{{< /site-region >}} + +{{< site-region region="gov,gov2" >}} + +
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
+ +{{< /site-region >}} + +{{% /tab %}} + +{{% tab "Cursor" %}} + +Installez le [Datadog Plugin][1] depuis la Cursor Marketplace — le plugin inclut le Datadog MCP Server et d'autres ressources. + +**Remarque** : Si vous avez précédemment installé le Datadog MCP Server manuellement, supprimez-le de la configuration de l'IDE pour éviter les conflits. + +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +1. Vous pouvez installer le plugin depuis la Cursor Marketplace ou depuis Cursor : + - Depuis la Cursor Marketplace, ouvrez le [Datadog Plugin][1] et cliquez sur {{< ui >}}Add to Cursor{{< /ui >}} . + - Dans Cursor, accédez à {{< ui >}}Cursor Settings{{< /ui >}} > {{< ui >}}Plugins{{< /ui >}}, puis recherchez le plugin Datadog et cliquez sur {{< ui >}}Add to Cursor{{< /ui >}} . 1. Après l'installation du plugin, tapez `/ddsetup` dans le chat de l'agent pour effectuer la configuration initiale. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour accéder aux ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. [1]: https://cursor.com/marketplace/datadog [2]: /fr/ide_plugins/vscode/?tab=cursor#installation @@ -181,7 +240,7 @@ Installez le [Datadog Plugin][1] depuis le Cursor Marketplace—le plugin inclut {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [1]: https://cursor.com/marketplace/datadog @@ -189,37 +248,37 @@ Installez le [Datadog Plugin][1] depuis le Cursor Marketplace—le plugin inclut {{% tab "Devin" %}} -Connectez Devin au Datadog MCP Server en l'activant depuis le Devin MCP Marketplace. Pour les instructions correctes, utilisez le {{< ui >}}Datadog Site{{< /ui >}}sélecteur sur le côté droit de cette page de documentation pour sélectionner votre site. +Connectez Devin au Datadog MCP Server en l'activant depuis la MCP Marketplace de Devin. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -1. Dans Devin, allez à {{< ui >}}Settings{{< /ui >}} > {{< ui >}}MCP Marketplace{{< /ui >}} et recherchez `Datadog`. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +1. Dans Devin, allez dans {{< ui >}}Settings{{< /ui >}} > {{< ui >}}MCP Marketplace{{< /ui >}} et recherchez `Datadog`. 1. Sélectionnez votre site Datadog pour le {{< ui >}}Server URL{{< /ui >}} ; par exemple, votre site sélectionné est {{< region-param key="dd_site_name" code="true" >}}. -1. Entrez vos clés API et d'application Datadog. -1. Installez et activez le serveur, et complétez le flux de connexion OAuth lorsque cela est demandé. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Saisissez vos clés d'API et d'application Datadog. +1. Installez et activez le Datadog MCP Server, et terminez le flux de connexion OAuth lorsque vous y êtes invité. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. -
Pour utiliser des ensembles d'outils spécifiques au produit, configurez un serveur MCP personnalisé dans Devin et incluez le toolsets requête à la fin de l'URL de l'endpoint. Voir Ensembles d'outils pour plus d'informations. +
Pour utiliser des ensembles d'outils spécifiques à un produit, configurez un serveur MCP personnalisé dans Devin et incluez le toolsets requête à la fin de l'URL de l'endpoint. Consultez Toolsets pour plus d'informations.
{{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} {{% /tab %}} {{% tab "Gemini CLI" %}} -Dirigez votre agent IA vers le point de terminaison du serveur MCP pour votre [site Datadog][1] régional. Pour les instructions correctes, utilisez le sélecteur **Site Datadog** sur le côté droit de cette page de documentation pour sélectionner votre site. +Indiquez à votre agent IA l'endpoint du serveur MCP pour votre [site Datadog][1] régional. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. 1. Exécutez dans le terminal :
gemini mcp add --transport http datadog {{< region-param key="mcp_server_endpoint" >}}
- Alternativement, ajoutez à `~/.gemini/settings.json` : + Sinon, ajoutez à `~/.gemini/settings.json` :
{
       "mcpServers": {
         "datadog": {
@@ -228,19 +287,19 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) :
       }
     }
-1. Pour activer les [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, idéal pour les clients qui prennent en charge le filtrage des outils) : +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Vérifiez que vous avez les [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. -
Si l'authentification à distance n'est pas disponible, utilisez l'authentification binaire locale à la place.
+
Si l'authentification à distance n'est pas disponible, utilisez plutôt l'authentification binaire locale.
[1]: /fr/getting_started/site/ {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [1]: /fr/getting_started/site/ @@ -248,47 +307,71 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{% tab "Goose" %}} -Dirigez votre agent IA vers le point de terminaison du serveur MCP pour votre [site Datadog][3] régional. Pour les instructions correctes, utilisez le {{< ui >}}Datadog Site{{< /ui >}} sélecteur sur le côté droit de cette page de documentation pour sélectionner votre site. +Pointez votre agent IA vers l'endpoint du serveur MCP pour votre [site Datadog][3] régional. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. -1. Ajoutez le serveur MCP Datadog à Goose en utilisant l'une des méthodes suivantes : - - **Installation en un clic (recommandée) :** Utilisez le serveur MCP Datadog {{< region-param key="goose_mcp_install_deeplink" link="true" text="install deeplink" >}}. - - **Configuration manuelle :** Suivez les instructions de Goose pour [ajouter un serveur MCP][2], en utilisant l'endpoint listé dans cette section comme l'URL du serveur HTTP diffusé. Pour modifier la configuration directement, modifiez `~/.config/goose/config.yaml`. +1. Ajoutez le Datadog MCP Server à Goose en utilisant l'une des méthodes suivantes : + - **Installation en un clic (recommandé) :** Utilisez le Datadog MCP Server {{< region-param key="goose_mcp_install_deeplink" link="true" text="install deeplink" >}}. + - **Configuration manuelle :** Suivez les instructions de Goose pour [ajouter un serveur MCP][2], en utilisant l'endpoint listé dans cette section comme URL du serveur HTTP diffusable. Pour modifier la configuration directement, modifiez `~/.config/goose/config.yaml`. -1. Pour activer [des outils spécifiques au produit][1], incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent : +1. Pour activer les [outils spécifiques au produit][1], incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
To enable all generally available toolsets, use `toolsets=all`. This works best for clients that support tool filtering. -1. Lors du premier lancement de session, choisissez votre compte Datadog lorsque cela est demandé pour l'authentification. +1. Lors du lancement de la première session, choisissez votre compte Datadog lorsque vous êtes invité à vous authentifier. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. [1]: #toolsets [2]: https://goose-docs.ai/docs/getting-started/using-extensions#mcp-servers {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [3]: /fr/getting_started/site/ {{% /tab %}} +{{% tab "Grok Build" %}} + +Installez le plugin Datadog depuis la Grok Build Plugin Marketplace. Le plugin intègre le Datadog MCP Server avec des mises à jour automatiques lors de la sortie de nouvelles versions du plugin. Pour plus de détails, consultez le [dépôt Plugin Marketplace][1]. + +**Remarque** : Si vous avez précédemment installé le Datadog MCP Server manuellement, supprimez-le de votre configuration Grok Build pour éviter les conflits. + +[1]: https://github.com/xai-org/plugin-marketplace + +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +1. Dans Grok Build, tapez `/marketplace` pour ouvrir le catalogue Marketplace. Sous xAI Official, recherchez et installez le plugin Datadog. + +1. Ouvrez l'onglet **MCP Servers** ou tapez `/mcps`. Sous **Plugin: datadog**, recherchez **datadog-grok** et appuyez sur `i` pour vous authentifier. Sélectionnez votre [site Datadog][2] et terminez le processus de connexion OAuth. + +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. + +[2]: /fr/getting_started/site/ +{{< /site-region >}} + +{{< site-region region="gov,gov2" >}} +
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}} + +{{% /tab %}} + {{% tab "IDE JetBrain" %}} -JetBrains propose les plugins [Junie][1] et [AI Assistant][2] pour sa gamme d'IDE. GitHub propose le plugin [Copilot][4]. Alternativement, de nombreux développeurs utilisent un agent CLI, tel que Claude Code, Codex ou Gemini CLI, en complément de leur IDE. +JetBrains propose les plugins [Junie][1] et [AI Assistant][2] pour sa gamme d'IDE. GitHub propose le plugin [Copilot][4]. Alternativement, de nombreux développeurs utilisent une CLI d'agent, telle que Claude Code, Codex ou Gemini CLI, parallèlement à leur IDE. -Dirigez votre plugin vers le point de terminaison du serveur MCP pour votre site régional [Datadog][3]. Pour les instructions correctes, utilisez le {{< ui >}}Datadog Site{{< /ui >}} sélecteur sur le côté droit de cette page de documentation pour sélectionner votre site. +Pointez votre plugin vers l'endpoint du serveur MCP pour votre [site Datadog][3] régional. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. {{% collapse-content title="Junie" level="h4" expanded=false id="jetbrains-junie" %}} -1. Allez à {{< ui >}}Tools{{< /ui >}} > {{< ui >}}Junie{{< /ui >}} > {{< ui >}}MCP Settings{{< /ui >}} et ajoutez le bloc suivant : +1. Allez dans {{< ui >}}Tools{{< /ui >}} > {{< ui >}}Junie{{< /ui >}} > {{< ui >}}MCP Settings{{< /ui >}} et ajoutez le bloc suivant :
{
       "mcpServers": {
@@ -300,23 +383,23 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) :
     }
     
-1. Pour activer les [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, idéal pour les clients qui prennent en charge le filtrage des outils) : +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Vous êtes invité à vous connecter via OAuth. L'indicateur de statut dans les paramètres affiche une coche verte lorsque la connexion est réussie. +1. Vous êtes invité à vous connecter via OAuth. L'indicateur d'état dans les paramètres affiche une coche verte lorsque la connexion est réussie. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. {{% /collapse-content %}} {{% collapse-content title="JetBrains AI Assistant" level="h4" expanded=false id="jetbrains-ai-assistant" %}} -1. Allez à {{< ui >}}Tools{{< /ui >}} > {{< ui >}}AI Assistant{{< /ui >}} > {{< ui >}}Model Context Protocol (MCP){{< /ui >}} et ajoutez le bloc suivant : +1. Allez dans {{< ui >}}Tools{{< /ui >}} > {{< ui >}}AI Assistant{{< /ui >}} > {{< ui >}}Model Context Protocol (MCP){{< /ui >}} et ajoutez le bloc suivant :
{
       "mcpServers": {
         "datadog": {
-          "url": "{{< region-param key="mcp_server_endpoint" >}}"
+          "url": "{{< region-param key="mcp_server_endpoint" >}}",
           "headers": {
             "DD_API_KEY": "<YOUR_API_KEY>",
             "DD_APPLICATION_KEY": "<YOUR_APP_KEY>"
@@ -326,18 +409,18 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) :
     }
     
-1. Pour activer les [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, idéal pour les clients qui prennent en charge le filtrage des outils) : +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. L'indicateur de statut dans les paramètres affiche une coche verte lorsque la connexion est réussie. +1. L'indicateur d'état dans les paramètres affiche une coche verte lorsque la connexion est réussie. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. {{% /collapse-content %}} {{% collapse-content title="GitHub Copilot" level="h4" expanded=false id="github-copilot" %}} -1. Allez à {{< ui >}}Tools{{< /ui >}} > {{< ui >}}GitHub Copilot{{< /ui >}} > {{< ui >}}Model Context Protocol (MCP){{< /ui >}} et ajoutez le bloc suivant : +1. Allez dans {{< ui >}}Tools{{< /ui >}} > {{< ui >}}GitHub Copilot{{< /ui >}} > {{< ui >}}Model Context Protocol (MCP){{< /ui >}} et ajoutez le bloc suivant :
{
       "servers": {
@@ -349,23 +432,23 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) :
     }
     
-1. Pour activer les [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, idéal pour les clients qui prennent en charge le filtrage des outils) : +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Cliquez sur l'élément `Start` qui apparaît dans l'éditeur pour démarrer le serveur. Vous êtes invité à vous connecter via OAuth. +1. Cliquez sur l'élément {{< ui >}}Start{{< /ui >}} qui apparaît dans l'éditeur pour démarrer le serveur. Vous êtes invité à vous connecter via OAuth. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. {{% /collapse-content %}} -{{% collapse-content title="Agents CLI" level="h4" expanded=false id="jetbrains-agent-clis" %}} -De nombreux développeurs utilisent un agent CLI tel que Claude Code, Codex ou Gemini CLI avec leur IDE JetBrains. Voir la configuration de ces outils CLI : +{{% collapse-content title="CLI d'Agent" level="h4" expanded=false id="jetbrains-agent-clis" %}} +De nombreux développeurs utilisent une CLI d'agent telle que Claude Code, Codex ou Gemini CLI avec leur IDE JetBrains. Consultez la configuration de ces outils CLI : - [Claude Code][4] - [Codex][5] - [Gemini CLI][6] -Le [plugin Datadog pour les IDE JetBrains][3] s'intègre à ces agents CLI. Pour une expérience ininterrompue, installez le plugin en même temps que vous configurez le serveur MCP Datadog. +Le [plugin Datadog pour les IDE JetBrains][3] s'intègre à ces CLI d'agent. Pour une expérience ininterrompue, installez le plugin en même temps que vous configurez le Datadog MCP Server. [3]: /fr/ide_plugins/idea/ [4]: /fr/mcp_server/setup/?tab=claudecode @@ -375,7 +458,7 @@ Le [plugin Datadog pour les IDE JetBrains][3] s'intègre à ces agents CLI. Pour {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [1]: https://plugins.jetbrains.com/plugin/26104-junie-the-ai-coding-agent-by-jetbrains @@ -386,12 +469,12 @@ Le [plugin Datadog pour les IDE JetBrains][3] s'intègre à ces agents CLI. Pour {{% tab "Kiro" %}} -Dirigez votre agent IA vers le point de terminaison du serveur MCP pour votre [site Datadog][3] régional. Pour les instructions correctes, utilisez le {{< ui >}}Datadog Site{{< /ui >}} sélecteur sur le côté droit de cette page de documentation pour sélectionner votre site. +Pointez votre agent IA vers l'endpoint du serveur MCP pour votre [site Datadog][3] régional. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. -1. Ajoutez ce qui suit à votre [fichier de configuration Kiro MCP][2] (`~/.kiro/settings/mcp.json` pour la configuration spécifique à l'utilisateur) : +1. Ajoutez ce qui suit à votre [fichier de configuration Kiro MCP][2] (`~/.kiro/settings/mcp.json` pour une configuration au niveau de l'utilisateur) :
{
       "mcpServers": {
@@ -401,17 +484,17 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : <
       }
     }
-1. Pour activer les [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, idéal pour les clients qui prennent en charge le filtrage des outils) : +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Vérifiez que vous avez les [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. [2]: https://kiro.dev/docs/mcp/configuration/ {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [3]: /fr/getting_started/site/ @@ -419,9 +502,9 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : < {{% tab "OpenCode" %}} -Connectez [OpenCode][3] au serveur MCP Datadog avec le [plugin Datadog OpenCode][2] officiel (en aperçu). Le plugin écrit et maintient l'entrée du serveur MCP dans votre `opencode.json` et expose les outils `ddsetup`, `ddconfig` et `ddtoolsets` que l'agent utilise pour gérer la configuration, les changements de site et la sélection de [toolset](#toolsets). +Connectez [OpenCode][3] au Datadog MCP Server avec le [plugin officiel Datadog OpenCode][2] (en préversion). Le plugin écrit et maintient l'entrée du serveur MCP dans votre `opencode.json` et expose les outils `ddsetup`, `ddconfig` et `ddtoolsets` que l'agent utilise pour gérer la configuration, les changements de site et la sélection de l'[ensemble d'outils](#toolsets). -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} 1. Ajoutez le plugin à votre fichier de configuration `opencode.json`. Créez le fichier s'il n'existe pas : @@ -433,22 +516,22 @@ Connectez [OpenCode][3] au serveur MCP Datadog avec le [plugin Datadog OpenCode] If you previously configured the Datadog MCP Server manually in `opencode.json`, remove or disable that entry to avoid conflicts with the plugin. -1. Redémarrez OpenCode. Le package est récupéré depuis npm au démarrage. +1. Redémarrez OpenCode. Le paquet est récupéré depuis npm au démarrage. -1. Demandez à l'agent d'exécuter `ddsetup`. Le plugin guide la sélection du site. +1. Demandez à l'agent d'exécuter `ddsetup`. Le plugin parcourt la sélection du site. -1. Redémarrez OpenCode à nouveau pour activer le serveur MCP et complétez le flux de connexion OAuth lorsque cela est demandé. +1. Redémarrez OpenCode pour activer le serveur MCP et terminez le flux de connexion OAuth lorsque vous y êtes invité. -1. Vérifiez que vous avez les [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. 1. Pour activer les [outils spécifiques au produit](#toolsets), demandez à l'agent d'exécuter `ddtoolsets`. -Après la configuration, demandez à l'agent d'exécuter `ddconfig` pour changer votre site Datadog ou résoudre le problème de connexion. +Après la configuration, demandez à l'agent d'exécuter `ddconfig` pour changer votre site Datadog ou résoudre les problèmes de connexion. {{% collapse-content title="Configuration manuelle" level="h4" expanded=false id="opencode-manual" %}} Pour configurer le serveur MCP sans le plugin, ajoutez ce qui suit à votre fichier de configuration `opencode.json`. -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}.
{
   "mcp": {
@@ -460,7 +543,7 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : <
   }
 }
-Pour activer les [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent : +Pour activer des [outils spécifiques au produit](#toolsets), ajoutez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint : Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
@@ -471,7 +554,7 @@ Pour activer tous les ensembles d'outils généralement disponibles, utilisez `t {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [2]: https://github.com/datadog-labs/opencode-plugin @@ -480,42 +563,42 @@ Pour activer tous les ensembles d'outils généralement disponibles, utilisez `t {{% tab "VS Code" %}} -L'extension [Cursor et VS Code de Datadog][1] inclut un accès intégré au serveur MCP géré par Datadog. GitHub Copilot peut également accéder au serveur MCP de Datadog dans VS Code (nécessite un abonnement actif à GitHub Copilot). +Pour Copilot, installez le [plugin Datadog Copilot][2] depuis la marketplace. Pour plus d'informations, consultez les instructions relatives à la [Copilot CLI][3]. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -1. Installez l'extension (omettez `--profile` et le nom de profil pour l'installer sur le profil par défaut de VS Code) : - ```shell - code --install-extension datadog.datadog-vscode --profile - ``` - Alternativement, installez l'[extension Datadog][2]. Si vous avez déjà installé l'extension, assurez-vous qu'elle est à jour. +Pour les autres extensions et CLI, l'[extension Cursor et VS Code][1] de Datadog fournit un assistant de configuration pour le Datadog MCP Server. + +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +1. Installez l'[extension Datadog][2]. Si l'extension est déjà installée, assurez-vous qu'elle est à jour. 1. Connectez-vous à votre compte Datadog. 1. **Redémarrez l'IDE.** -1. Confirmez que le serveur MCP de Datadog est disponible et que les [outils][3] sont listés : ouvrez le panneau de discussion, sélectionnez le mode agent et cliquez sur le bouton {{< ui >}}Configure Tools{{< /ui >}}. - {{< img src="bits_ai/mcp_server/vscode_configure_tools_button.png" alt="Bouton Configurer les outils dans VS Code" style="width:70%;" >}} -1. Si vous avez précédemment installé le serveur MCP de Datadog manuellement, retirez-le de la configuration de l'IDE pour éviter les conflits. Ouvrez la palette de commandes (`Shift` + `Cmd/Ctrl` + `P`) et exécutez `MCP: Open User Configuration`. -1. Vérifiez que vous avez les [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Exécutez {{< ui >}}Datadog: Open MCP Configuration Assistant{{< /ui >}} et suivez les instructions pour configurer le Datadog MCP Server. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. + +La connexion au Datadog MCP Server est gérée par Copilot (ou l'agent que vous utilisez), et non par l'extension Datadog. Vous devez autoriser le Datadog MCP Server indépendamment de l'extension. [2]: /fr/ide_plugins/vscode/?tab=vscode#installation [3]: /fr/mcp_server/tools {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [1]: /fr/ide_plugins/vscode/ +[2]: https://awesome-copilot.github.com/plugins/#file=plugins%2Fdatadog +[3]: /fr/mcp_server/setup/?tab=copilot-cli {{% /tab %}} {{% tab "Warp" %}} -[Warp][1] est un terminal agentique avec un support MCP intégré. Dirigez l'agent Warp vers le point de terminaison du serveur MCP pour votre [site Datadog][2] régional. Pour les instructions correctes, utilisez le {{< ui >}}Datadog Site{{< /ui >}}sélecteur sur le côté droit de cette page de documentation pour sélectionner votre site. +[Warp][1] est un terminal agentique avec prise en charge native de MCP. Pointez l'agent Warp vers l'endpoint du serveur MCP pour votre [site Datadog][2] régional. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. -1. Dans l'application Warp, allez à {{< ui >}}Settings{{< /ui >}} > {{< ui >}}MCP Servers{{< /ui >}} et cliquez sur {{< ui >}}+ Add{{< /ui >}}. +1. Dans l'application Warp, accédez à {{< ui >}}Settings{{< /ui >}} > {{< ui >}}MCP Servers{{< /ui >}} et cliquez sur {{< ui >}}+ Add{{< /ui >}}. -1. Collez la configuration suivante : +1. Collez la configuration suivante :
{
       "Datadog": {
@@ -527,14 +610,14 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : <
 
     
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Cliquez sur {{< ui >}}Start{{< /ui >}} sur le serveur Datadog. Warp ouvre votre navigateur pour compléter le flux de connexion OAuth. Les identifiants sont stockés en toute sécurité sur votre appareil et réutilisés pour les sessions futures. +1. Cliquez sur {{< ui >}}Start{{< /ui >}} sur le serveur Datadog. Warp ouvre votre navigateur pour terminer le flux de connexion OAuth. Les informations d'identification sont stockées en toute sécurité sur votre appareil et réutilisées pour les sessions futures. -1. Vérifiez que vous disposez des [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} [1]: https://www.warp.dev/ @@ -543,14 +626,14 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : < {{% tab "Other" %}} -Pour la plupart des [clients pris en charge](#supported-clients), utilisez ces instructions pour l'authentification à distance. Pour Cline ou lorsque l'authentification à distance est peu fiable ou non disponible, utilisez [l'authentification binaire locale](#local-binary-authentication). +Pour la plupart des autres [clients pris en charge](#supported-clients), utilisez ces instructions pour l'authentification distante. Pour Cline ou lorsque l'authentification distante n'est pas fiable ou n'est pas disponible, utilisez [l'authentification binaire locale](#local-binary-authentication). -Dirigez votre agent IA vers le point de terminaison du serveur MCP pour votre site [Datadog][1]. Pour les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation pour sélectionner votre site. +Indiquez à votre agent IA l'endpoint du serveur MCP pour votre [site Datadog][1] régional. Pour obtenir les instructions correctes, utilisez le sélecteur {{< ui >}}Datadog Site{{< /ui >}} sur le côté droit de cette page de documentation afin de sélectionner votre site. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Endpoint sélectionné ({{< region-param key="dd_site_name" >}}) : {{< region-param key="mcp_server_endpoint" >}}. -1. Ajoutez le serveur Datadog MCP au fichier de configuration de votre client en utilisant le transport HTTP et l'URL de point de terminaison de votre site. Exemple : +1. Ajoutez le Datadog MCP Server au fichier de configuration de votre client en utilisant le transport HTTP et l'URL de l'endpoint de votre site. Exemple :
{
       "mcpServers": {
@@ -561,16 +644,16 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : <
       }
     }
-1. Pour activer les [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL du point de terminaison. Par exemple, cette URL active _uniquement_ les outils APM et d'observabilité de l'agent (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, idéal pour les clients qui prennent en charge le filtrage des outils) : +1. Pour activer des [outils spécifiques au produit](#toolsets), incluez le paramètre de requête `toolsets` à la fin de l'URL de l'endpoint. Par exemple, cette URL active _uniquement_ les outils APM et Agent Observability (utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles, ce qui est préférable pour les clients prenant en charge le filtrage des outils) :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Vérifiez que vous avez les [permissions](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. +1. Vérifiez que vous disposez des [autorisations](#required-permissions) requises pour les ressources Datadog auxquelles vous souhaitez accéder. {{< /site-region >}} {{< site-region region="gov,gov2" >}} -
Le serveur MCP Datadog n'est pas pris en charge pour votre site sélectionné ({{< region-param key="dd_site_name" >}}).
+
Le Datadog MCP Server n'est pas pris en charge pour le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}} @@ -580,126 +663,171 @@ Point de terminaison sélectionné ({{< region-param key="dd_site_name" >}}) : < ## Ensembles d'outils {#toolsets} -Le serveur Datadog MCP prend en charge _les ensembles d'outils_, ce qui vous permet d'utiliser uniquement les [outils MCP][49] dont vous avez besoin, économisant ainsi de l'espace précieux dans la fenêtre de contexte. Pour utiliser un ensemble d'outils, incluez le `toolsets` paramètre de requête dans l'URL de point de terminaison lors de la connexion au serveur MCP ([authentification à distance](#authentication) uniquement). Utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles en même temps. +Le Datadog MCP Server prend en charge les _ensembles d'outils_, qui vous permettent d'utiliser uniquement les [outils MCP][49] dont vous avez besoin, économisant ainsi un espace précieux dans la fenêtre de contexte. Pour utiliser un ensemble d'outils, incluez le paramètre de requête `toolsets` dans l'URL de l'endpoint lors de la connexion au serveur MCP ([authentification distante](#authentication) uniquement). Utilisez `toolsets=all` pour activer tous les ensembles d'outils généralement disponibles en une seule fois. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Par exemple, en fonction de votre [Datadog site] sélectionné ({{< region-param key="dd_site_name" >}}) : +
Pour l'interface de ligne de commande Codex, utilisez le X-Datadog-MCP-Toolsets en-tête décrit dans les instructions de configuration de Codex, et non le paramètre de requête décrit ici.
-- Récupérez uniquement les outils principaux (c'est le paramètre par défaut si `toolsets` n'est pas spécifié) : +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Par exemple, en fonction de votre [site Datadog][17] sélectionné ({{< region-param key="dd_site_name" >}}) : + +- Récupérer uniquement les outils principaux (c'est la valeur par défaut si `toolsets` n'est pas spécifié) :
{{< region-param key="mcp_server_endpoint" >}}
-- Récupérez uniquement les outils liés aux tests synthétiques : +- Récupérer uniquement les outils liés à Synthetic Testing :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=synthetics
-- Récupérez les outils principaux, les outils de test synthétiques et les outils de livraison de logiciels : +- Récupérer les outils principaux, Synthetic Testing et Software Delivery :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=core,synthetics,software-delivery
-- Récupérez tous les outils généralement disponibles : +- Récupérer tous les outils généralement disponibles :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=all
-
Activer tous les ensembles d'outils augmente le nombre de définitions d'outils envoyées à votre client AI, ce qui consomme de l'espace dans la fenêtre de contexte. toolsets=all fonctionne mieux avec des clients qui prennent en charge le filtrage des outils, comme Claude Code.
+
L'activation de tous les ensembles d'outils augmente le nombre de définitions d'outils envoyées à votre client IA, ce qui consomme de l'espace dans la fenêtre de contexte. toolsets=all fonctionne mieux avec les clients qui prennent en charge le filtrage des outils, tels que Claude Code.
[17]: /fr/getting_started/site/#navigate-the-datadog-documentation-by-site {{< /site-region >}} ### Omettez des outils spécifiques {#omit-specific-tools} -Utilisez le `omit_tools` paramètre de requête pour supprimer des outils spécifiques de la liste finale des outils. +Utilisez le paramètre de requête `omit_tools` pour supprimer des outils spécifiques de la liste finale des outils. -{{< site-region region="us,us3,us5,eu,ap1,ap2" >}} +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} Exemples pour votre site sélectionné ({{< region-param key="dd_site_name" >}}) : -- Omettez des outils de l'ensemble par défaut : +- Omettez des outils de l'ensemble par défaut :
{{< region-param key="mcp_server_endpoint" >}}?omit_tools=search_datadog_logs,search_datadog_spans
-- Sélectionnez des ensembles d'outils, puis omettez un outil : +- Sélectionnez des ensembles d'outils, puis omettez un outil :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=core,software-delivery&omit_tools=search_datadog_incidents
-- Commencez par tous les ensembles d'outils généralement disponibles, puis omettez les outils d'écriture : +- Commencez par tous les ensembles d'outils généralement disponibles, puis omettez les outils d'écriture :
{{< region-param key="mcp_server_endpoint" >}}?toolsets=all&omit_tools=create_datadog_notebook,edit_datadog_notebook
{{< /site-region >}} -Fournissez les noms des outils sous forme de liste séparée par des virgules. Lorsque les deux paramètres sont présents, le serveur résout d'abord `toolsets` puis supprime les outils correspondants dans `omit_tools`. Si `omit_tools` inclut des noms d'outils inconnus, le serveur avertit et continue. +Fournissez les noms des outils sous forme de liste séparée par des virgules. Lorsque les deux paramètres sont présents, le serveur résout `toolsets` en premier, puis supprime les outils correspondants dans `omit_tools`. Si `omit_tools` inclut des noms d'outils inconnus, le serveur émet un avertissement et continue. ### Ensembles d'outils disponibles {#available-toolsets} -Ces ensembles d'outils sont généralement disponibles. Consultez [Datadog MCP Server Tools][49] pour une référence complète des outils disponibles organisés par ensemble d'outils, avec des exemples de requêtes. - -- `core` : L'ensemble d'outils par défaut pour les journaux, les métriques, les traces, les tableaux de bord, les moniteurs, les incidents, les hôtes, les services, les événements et les carnets de notes -- `alerting` : Outils pour valider et créer des moniteurs, rechercher des groupes de moniteurs, récupérer des modèles de moniteurs, analyser la couverture des moniteurs et rechercher des SLOs. -- `cases` : Outils pour [Case Management][42], y compris la création, la recherche et la mise à jour des cas ; la gestion des projets ; et le lien avec les problèmes Jira. -- `dashboards` : Outils pour récupérer, créer, mettre à jour et supprimer des [dashboards][46], ainsi que pour la référence et la validation du schéma des widgets. -- `dbm` : Outils pour interagir avec [Database Monitoring][33]. -- `ddsql` : Outils pour interroger les données Datadog en utilisant [DDSQL][44], un dialecte SQL avec support pour les ressources d'infrastructure, les journaux, les métriques, RUM, les spans et d'autres sources de données Datadog. -- `error-tracking` : Outils pour interagir avec [Suivi des erreurs][32] de Datadog. -- `feature-flags` : Outils pour gérer les [feature flags][35], y compris la création, l'énumération et la mise à jour des flags et de leurs environnements. -- `kubernetes` : Outils pour rechercher et décrire les ressources [Kubernetes][51] et récupérer des manifests à travers tous les clusters. -- `llmobs` : Outils pour rechercher et analyser les spans et les expériences [Agent Observability][36]. -- `networks` : Outils pour l'analyse de [Cloud Network Monitoring][37] et [Network Device Monitoring][38]. -- `onboarding` : Outils d'intégration agentique pour une configuration et une mise en place guidées de Datadog. -- `product-analytics` : Outils pour interagir avec les requêtes de [Product Analytics]. -- `profiling` : Outils pour découvrir, explorer et analyser les données de [Continuous Profiler][58]. -- `reference-tables` : Outils pour gérer [Reference Tables][48], y compris l'énumération des tables, la lecture des lignes, l'ajout de lignes et la création de tables à partir du stockage cloud. -- `security` : Outils pour l'analyse de la sécurité du code et la recherche de [security signals][39] et de [security findings][40]. -- `software-delivery` : Outils pour interagir avec la livraison de logiciels ([CI Visibility][30] et [Test Optimization][31]). -- `synthetics` : Outils pour interagir avec les [Synthetic tests][29] de Datadog. -- `widgets` : Outils pour la visualisation, la validation et la conversion de type des widgets de [dashboard][46] et de [notebook][54]. -- `workflows` : Outils pour [Workflow Automation][43], y compris l'énumération, l'inspection, l'exécution et la configuration des workflows pour l'utilisation par les agents. - -### : Ensembles d'outils de prévisualisation {#preview-toolsets} - -Ces ensembles d'outils sont en prévisualisation. Inscrivez-vous à un ensemble d'outils en remplissant le formulaire de prévisualisation du produit ou contactez [Datadog support][47] pour demander l'accès. -- `apm` : ([Inscrivez-vous][45]) Outils pour une analyse approfondie des traces [APM][34], la recherche de spans, les Watchdog insights et l'enquête sur les performances. -- `code-exec` : ([Inscrivez-vous][60]) Un outil unique qui exécute du TypeScript écrit par des agents dans un bac à sable géré par Datadog avec un accès direct aux API de Datadog, pour une enquête multi-signaux et une exploration de données ad hoc en un seul appel. -- `remote-actions`: ([Inscrivez-vous][62]) Outils pour les diagnostics sur hôte, y compris la lecture de fichiers, la liste des répertoires et l'exécution de commandes shell en lecture seule directement sur les hôtes instrumentés via l'Agent -- `rum`: Outils pour [Real User Monitoring][57], y compris la synthèse des performances applicatives, l'inspection de la configuration des applications et la réalisation d'analyses de performance +Ces ensembles d'outils sont généralement disponibles. Consultez [Datadog MCP Server Tools][49] pour une référence complète des outils disponibles organisés par ensemble d'outils, avec des exemples de prompts. + +- `core` : L'ensemble d'outils par défaut pour les logs, les métriques, les traces, les dashboards, les monitors, les incidents, les hosts, les services, les événements et les notebooks +- `alerting` : Outils pour valider et créer des monitors, rechercher des groupes de monitors, récupérer des modèles de monitors, analyser la couverture des monitors et rechercher des SLOs +- `audit-trail` : Outils pour [Audit Trail][70], incluant la recherche et la récupération d'événements Audit Trail et la formation de requêtes de recherche Audit Trail +- `code-exec` : Un outil unique qui exécute du TypeScript créé par l'agent dans un bac à sable géré par Datadog avec un accès direct aux API Datadog, pour l'investigation multi-signal et l'exploration de données ad hoc en un seul appel +- `cost` : Outils pour [Cloud Cost Management][63], incluant la liste des recommandations d'économies de coûts classées par économies quotidiennes potentielles estimées +- `dashboards` : Outils pour récupérer, créer, mettre à jour et supprimer des [dashboards][46], ainsi que pour la référence et la validation du schéma des widgets +- `data-observability` : Outils pour [Data Observability][69], incluant la recherche dans le catalogue de données, l'analyse de lignage, la surveillance de la qualité des données, ainsi que des recommandations de coût et de performance pour les entrepôts de données et les jobs Spark +- `dbm` : Outils pour interagir avec [Database Monitoring][33] +- `ddsql` : Outils pour interroger les données Datadog à l'aide de [DDSQL][44], un dialecte SQL prenant en charge les ressources d'infrastructure, les logs, les métriques, le RUM, les spans et d'autres sources de données Datadog +- `error-tracking` : Outils pour interagir avec Datadog [Error Tracking][32] +- `feature-flags` : Outils pour gérer les [feature flags][35], incluant la création, la liste et la mise à jour des flags et de leurs environnements +- `kubernetes` : Outils pour rechercher et décrire les ressources [Kubernetes][51] et récupérer les manifestes sur tous les clusters +- `llmobs` : Outils pour rechercher et analyser les spans et les expériences d'[Agent Observability][36]. +- `networks` : Outils pour l'analyse de [Cloud Network Monitoring][37] et de [Network Device Monitoring][38]. +- `notebooks` : Outils étendus pour les [notebooks][54], au-delà des outils de [notebooks] inclus dans l'ensemble d'outils `core`. +- `onboarding` : Outils d'intégration Agentic pour la configuration guidée de Datadog. +- `product-analytics` : Outils pour interagir avec les requêtes de [Product Analytics][41]. +- `profiling` : Outils pour découvrir, explorer et analyser les données du [Continuous Profiler][58]. +- `reference-tables` : Outils pour gérer les [Reference Tables][48], y compris la liste des tables, la lecture des lignes, l'ajout de lignes et la création de tables à partir du stockage cloud. +- `rum` : Outils pour le [Real User Monitoring][57], y compris la résolution des applications, la synthèse des performances, la présentation d'informations agrégées, la surveillance et la gestion des opérations, l'exploration des métriques, la gestion des filtres de rétention et la gestion des métriques RUM personnalisées. +- `security` : Outils pour l'analyse de la sécurité du code et la recherche de [signaux de sécurité][39] et de [résultats de sécurité][40]. +- `software-delivery` : Outils pour interagir avec la Software Delivery ([CI Visibility][30] et [Test Optimization][31]). +- `synthetics` : Outils pour interagir avec les [tests Synthetic][29] de Datadog. +- `widgets` : Outils pour la visualisation, la validation et la conversion de type des widgets de [dashboard][46] et de [notebooks][54]. +- `workflows` : Outils pour le [Workflow Automation][43], y compris la liste, l'inspection, l'exécution et la configuration des workflows pour une utilisation par l'agent. + +###  : Prévisualisez les ensembles d'outils {#preview-toolsets} + +Ces ensembles d'outils sont en préversion et ne sont pas inclus dans l'alias `all` ; demandez-les explicitement par leur nom. Les exigences d'accès varient selon l'ensemble d'outils, comme indiqué ci-dessous. Lorsqu'un formulaire de préversion de produit est indiqué, inscrivez-vous via celui-ci ou contactez le [support Datadog][47] pour demander l'accès. +- `apm` : ([S'inscrire][45]) Outils pour l'analyse approfondie des traces [APM][34], la recherche de spans, les Watchdog insights et l'investigation des performances +- `cases` : Outils pour le [Case Management][42], y compris la création, la recherche et la mise à jour de cas ; la gestion de projets ; et la liaison d'issues Jira. Aucune inscription ni demande d'accès requise. +- `remote-actions` : ([S'inscrire][62]) Outils pour les diagnostics on-host, y compris la lecture de fichiers, la liste des répertoires et l'exécution de commandes shell sécurisées en lecture seule directement sur les hosts instrumentés via l'Agent ## Clients pris en charge {#supported-clients} -| Client | Développeur | Remarques | +| Client | Développeur | Notes | |--------|------|------| -| [ChatGPT][59] | OpenAI | En prévisualisation, et disponible uniquement pour les clients US1. | -| [Cursor][3] | Cursor | Datadog [Cursor & VS Code extension][15] recommandée. | -| [Claude Code][4] | Anthropic | Datadog [Claude Code plugin][55] recommandé. | -| [Claude][19] | Anthropic | Datadog [Claude Connector][56] recommandé. Inclut Claude Cowork. | +| [ChatGPT][59] | OpenAI | En préversion, et disponible uniquement pour les clients US1. | +| [Cursor][3] | Cursor | [Plugin Cursor][15] Datadog recommandé. | +| [Claude Code][4] | Anthropic | [Plugin Claude Code][55] Datadog recommandé. | +| [Claude][19] | Anthropic | [Claude Connector][56] Datadog recommandé. Inclut Claude Cowork. | | [Codex CLI][6] | OpenAI | | +| [Copilot CLI][64] | Microsoft | [Copilot plugin][16] Datadog recommandé. | | [Gemini CLI][50] | Google | | +| [Grok Build][71] | SpaceXAI | [Grok Build plugin][72] Datadog recommandé. | | [Warp][28] | Warp | | -| [VS Code][7] | Microsoft | Datadog [Cursor & VS Code extension][16] recommandée. | -| [JetBrains IDEs][18] | JetBrains | Datadog [Datadog plugin][18] recommandé. | +| [VS Code][7] | Microsoft | [Copilot plugin][16] Datadog recommandé. | +| [JetBrains IDEs][18] | JetBrains | [Datadog plugin][18] recommandé. | | [Kiro][9], [Kiro CLI][10] | Amazon Web Services | | | [Goose][8] | Agentic AI Foundation | | | [OpenCode][52] | SST | Datadog [OpenCode plugin][53] recommandé. | -| [Cline][11] | Divers | Voir l'onglet {{< ui >}}Other{{< /ui >}} ci-dessus. Utilisez l'authentification binaire locale pour Cline si l'authentification à distance est peu fiable. | +| [Cline][11] | Divers | Voir l'onglet {{< ui >}}Other{{< /ui >}} ci-dessus. Utilisez l'authentification binaire locale pour Cline si l'authentification à distance n'est pas fiable. | -
Le serveur Datadog MCP est en plein développement, et d'autres clients pris en charge pourraient devenir disponibles.
+
Le Datadog MCP Server est en cours de développement avancé, et d'autres clients pris en charge pourraient devenir disponibles.
-## Permissions requises {#required-permissions} +## Autorisations requises {#required-permissions} -Les outils du serveur MCP nécessitent les [permissions de rôle utilisateur Datadog][22] suivantes : +Les outils du serveur MCP nécessitent les [autorisations de rôle utilisateur Datadog][22] suivantes : -| Permission | Requise pour | +| Autorisation | Requis pour | |------------|-------------| -| mcp_read | Outils qui lisent des données de Datadog (par exemple, interroger des moniteurs, rechercher des journaux, récupérer des tableaux de bord) | -| mcp_write | Outils qui créent ou modifient des ressources dans Datadog (par exemple, créer des moniteurs, mettre des hôtes en sourdine) | +| mcp_read | Outils qui lisent des données depuis Datadog (par exemple, interroger des monitors, rechercher des logs, récupérer des dashboards) | +| mcp_write | Outils qui créent ou modifient des ressources dans Datadog (par exemple, créer des monitors, mettre en sourdine des hosts) | -En plus de `mcp_read` ou `mcp_write`, les utilisateurs ont besoin des permissions standard Datadog pour la ressource sous-jacente. Par exemple, utiliser un outil MCP qui lit des moniteurs nécessite à la fois `mcp_read` et la permission [Monitors Read][24] : Voir [Datadog Role Permissions][25] pour la liste complète des permissions au niveau des ressources. +En plus de `mcp_read` ou `mcp_write`, les utilisateurs ont besoin des autorisations Datadog standard pour la ressource sous-jacente. Par exemple, l'utilisation d'un outil MCP qui lit les monitors nécessite à la fois `mcp_read` et l'autorisation [Monitors Read][24]. Consultez [Datadog Role Permissions][25] pour obtenir la liste complète des autorisations au niveau de la ressource. -Les utilisateurs ayant le **Datadog Standard Role** disposent par défaut des autorisations du serveur MCP. Si votre organisation utilise des [custom roles][23], ajoutez les autorisations manuellement : -1. Allez dans [**Organization Settings > Roles**][26] en tant qu'administrateur, et cliquez sur le rôle que vous souhaitez mettre à jour. -1. Cliquez sur {{< ui >}}Edit Role{{< /ui >}} (icône de crayon). -1. Sous la liste des autorisations, sélectionnez les cases à cocher {{< ui >}}MCP Read{{< /ui >}} et {{< ui >}}MCP Write{{< /ui >}}. -1. Sélectionnez toutes les autres autorisations au niveau des ressources dont vous avez besoin pour le rôle. +Les utilisateurs disposant du {{< ui >}}Datadog Standard Role{{< /ui >}} ont les deux autorisations du serveur MCP par défaut. Si votre organisation utilise des [rôles personnalisés][23], ajoutez les autorisations manuellement : +1. Accédez à [{{< ui >}}Organization Settings{{< /ui >}} > {{< ui >}}Roles{{< /ui >}}][26] en tant qu'administrateur et cliquez sur le rôle que vous souhaitez mettre à jour. +1. Cliquez sur {{< ui >}}Edit Role{{< /ui >}} (icône crayon). +1. Sous la liste des autorisations, cochez les cases {{< ui >}}MCP Read{{< /ui >}} et {{< ui >}}MCP Write{{< /ui >}}. +1. Sélectionnez toute autre autorisation au niveau de la ressource dont vous avez besoin pour le rôle. 1. Cliquez sur {{< ui >}}Save{{< /ui >}}. -Les administrateurs d'organisation peuvent gérer l'accès global au MCP et les capacités d'écriture depuis [Organization Settings][27]. +Les administrateurs de l'organisation peuvent gérer l'accès MCP global et les capacités d'écriture depuis [Organization Settings][27]. + +### Restreindre l'accès réseau {#restrict-network-access} + +Pour contrôler quels réseaux peuvent se connecter au Datadog MCP Server, activez la [liste d'autorisation IP][68]. Cela empêche les utilisateurs de se connecter au serveur MCP depuis des origines non approuvées, même s'ils disposent des autorisations requises. ## Authentification {#authentication} -Le serveur MCP utilise OAuth 2.0 pour [l'authentification][14]. Si vous ne pouvez pas passer par le flux OAuth (par exemple, sur un serveur), vous pouvez fournir une [API key and application key][1] en tant qu'en-têtes HTTP `DD_API_KEY` et `DD_APPLICATION_KEY`. +Pour la plupart des utilisateurs, OAuth 2.0 est la méthode d'authentification recommandée, et votre client MCP la gère lors de la configuration. Utilisez l'une des méthodes basées sur les en-têtes ci-dessous uniquement lorsque vous ne pouvez pas terminer le flux OAuth, par exemple sur un serveur ou dans un environnement CI. + +### OAuth 2.0 (recommandé) {#oauth-20-recommended} + +La plupart des clients terminent automatiquement le flux OAuth 2.0 lors de la configuration. Sélectionnez votre client en haut de cette page pour obtenir des instructions. Avec OAuth, vous ne gérez pas directement les identifiants à longue durée de vie. Pour plus de détails, consultez la [spécification d'autorisation MCP][14]. + +### Jeton d'accès personnel ou de service {#personal-or-service-access-token} + +Pour une authentification basée sur les en-têtes, un [Jeton d'accès personnel (PAT)][66] ou un [Jeton d'accès de service (SAT)][67] Datadog est l'option privilégiée. Transmettez le jeton en tant que jeton bearer dans l'en-tête `Authorization`. Aucune clé d'API n'est requise. {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Par exemple, en fonction de votre [Datadog site][17] ({{< region-param key="dd_site_name" >}}) : +Par exemple, en fonction de votre [site Datadog][17] sélectionné ({{< region-param key="dd_site_name" >}}) : + +
{
+  "mcpServers": {
+    "datadog": {
+      "type": "http",
+      "url": "{{< region-param key="mcp_server_endpoint" >}}",
+      "headers": {
+          "Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
+      }
+    }
+  }
+}
+
+ +[17]: /fr/getting_started/site/#navigate-the-datadog-documentation-by-site +{{< /site-region >}} + +Utilisez un PAT pour un utilisateur individuel ou un SAT pour un [compte de service][13]. Pour les périmètres, la gestion des jetons et d'autres méthodes d'authentification, consultez la documentation sur les [PAT][66] et les [SAT][67]. + +### Clés d'API et d'application {#api-and-application-keys} + +Alternativement, fournissez une clé d'API Datadog et une clé d'application Datadog [API key and application key][1] en tant qu'en-têtes HTTP `DD_API_KEY` et `DD_APPLICATION_KEY` : + +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +Par exemple, en fonction de votre [site Datadog][17] sélectionné ({{< region-param key="dd_site_name" >}}) :
{
   "mcpServers": {
@@ -718,31 +846,31 @@ Par exemple, en fonction de votre [Datadog site][17] ({{< region-param key="dd_s
 [17]: /fr/getting_started/site/#navigate-the-datadog-documentation-by-site
 {{< /site-region >}}
 
-Pour des raisons de sécurité, utilisez une clé API et une clé d'application à portée limitée provenant d'un [service account][13] qui dispose uniquement des autorisations requises.
+Pour des raisons de sécurité, utilisez une clé d'API et une clé d'application à périmètre limité provenant d'un [compte de service][13] qui ne dispose que des autorisations requises.
 
 ### Ajout de clients OAuth {#adding-oauth-clients}
 
-Vous pouvez autoriser vos URL de redirection dans [Organization Preferences][27] sous `MCP OAuth Redirect URLs`. 
+Vous pouvez ajouter vos URL de redirection à la liste d'autorisation dans [{{< ui >}}Organization Preferences{{< /ui >}}][27] sous {{< ui >}}MCP OAuth Redirect URLs{{< /ui >}}.
 
-Si vous êtes un partenaire ou un fournisseur ajoutant Datadog à un annuaire MCP pour votre plateforme d'agent IA, soumettez votre intérêt via le [Technology Partner Signup][61].
+Si vous êtes un partenaire ou un fournisseur ajoutant Datadog à un répertoire MCP pour votre plateforme d'agent IA, soumettez votre demande via le [formulaire d'inscription des partenaires technologiques][61] de Datadog.
 
 ### Authentification binaire locale {#local-binary-authentication}
 
-L'authentification locale est recommandée pour Cline et lorsque l'authentification à distance est peu fiable ou indisponible. Après l'installation, vous n'avez généralement pas besoin de mettre à jour le binaire local pour bénéficier des mises à jour du serveur MCP, car les outils sont à distance.
+L'authentification locale est recommandée pour Cline et lorsque l'authentification à distance est peu fiable ou indisponible. Après l'installation, vous n'avez généralement pas besoin de mettre à jour le binaire local pour bénéficier des mises à jour du serveur MCP, car les outils sont distants.
 
-{{% collapse-content title="Configurez le binaire local du serveur Datadog MCP" level="h5" expanded=false id="mcp-local-binary" %}}
+{{% collapse-content title="Configurer le binaire local du Datadog MCP Server" level="h4" expanded=false id="mcp-local-binary" %}}
 
-1. Installez le binaire du serveur Datadog MCP (macOS et Linux) :
+1. Installez le binaire du Datadog MCP Server (macOS et Linux) :
    ```bash
    curl -sSL https://coterm.datadoghq.com/mcp-cli/install.sh | bash
    ```
-   Cela installe le binaire dans `~/.local/bin/datadog_mcp_cli`.
+   Ceci installe le binaire dans `~/.local/bin/datadog_mcp_cli`.
 
    Pour Windows, téléchargez la [version Windows][20].
 
-2. Exécutez `datadog_mcp_cli login` manuellement pour suivre le flux de connexion OAuth et choisir un [Datadog site][21].
+2. Exécutez `datadog_mcp_cli login` manuellement pour suivre le processus de connexion OAuth et choisir un [site Datadog][21].
 
-3. Configurez votre client AI pour utiliser le transport stdio avec `datadog_mcp_cli` comme commande. Par exemple, sur macOS (remplacez `` par votre nom d'utilisateur OS) :
+3. Configurez votre client IA pour utiliser le transport stdio avec `datadog_mcp_cli` comme commande. Par exemple, sous macOS (remplacez `` par votre nom d'utilisateur système) :
    ```json
    {
      "mcpServers": {
@@ -756,32 +884,32 @@ L'authentification locale est recommandée pour Cline et lorsque l'authentificat
    }
    ```
 
-   Pour d'autres systèmes d'exploitation, remplacez le chemin `command` par l'emplacement du binaire téléchargé :
-   - Linux : `/home//.local/bin/datadog_mcp_cli`
-   - Windows : `\bin\datadog_mcp_cli.exe`
+   Pour les autres systèmes d'exploitation, remplacez le chemin `command` par l'emplacement du binaire téléchargé :
+   - Linux: `/home//.local/bin/datadog_mcp_cli`
+   - Windows: `\bin\datadog_mcp_cli.exe`
 
-   
Pour Claude Code, vous pouvez plutôt exécuter : +
Pour Claude Code, vous pouvez plutôt exécuter:
claude mcp add datadog --scope user -- ~/.local/bin/datadog_mcp_cli
-4. Redémarrez complètement votre client AI pour appliquer la configuration et charger le serveur MCP. +4. Redémarrez complètement votre client IA pour appliquer la configuration et charger le serveur MCP. {{% /collapse-content %}} -## Testez l'accès au serveur MCP {#test-access-to-the-mcp-server} +## Tester l'accès au serveur MCP {#test-access-to-the-mcp-server} 1. Installez l'[inspecteur MCP][2], un outil de développement pour tester et déboguer les serveurs MCP. ```bash npx @modelcontextprotocol/inspector ``` -2. Dans l'interface web de l'inspecteur, pour {{< ui >}}Transport Type{{< /ui >}}, sélectionnez {{< ui >}}Streamable HTTP{{< /ui >}}. -3. Pour {{< ui >}}URL{{< /ui >}}, entrez le point de terminaison du serveur MCP pour votre site Datadog régional. - {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} +2. Dans l'interface utilisateur web de l'inspecteur, pour {{< ui >}}Transport Type{{< /ui >}}, sélectionnez {{< ui >}}Streamable HTTP{{< /ui >}}. +3. Pour {{< ui >}}URL{{< /ui >}}, saisissez l'endpoint du serveur MCP pour votre site Datadog régional. + {{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} Par exemple, pour {{< region-param key="dd_site_name" >}}: {{< region-param key="mcp_server_endpoint" >}} {{< /site-region >}} -4. Cliquez sur {{< ui >}}Connect{{< /ui >}}, puis allez à {{< ui >}}Tools{{< /ui >}} > {{< ui >}}List Tools{{< /ui >}}. +4. Cliquez sur {{< ui >}}Connect{{< /ui >}}, puis accédez à {{< ui >}}Tools{{< /ui >}} > {{< ui >}}List Tools{{< /ui >}}. 5. Vérifiez si les [outils disponibles][12] apparaissent. -## Lecture complémentaire : {#further-reading} +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} @@ -799,8 +927,8 @@ L'authentification locale est recommandée pour Cline et lorsque l'authentificat [12]: /fr/mcp_server/tools [13]: /fr/account_management/org_settings/service_accounts/ [14]: https://modelcontextprotocol.io/specification/draft/basic/authorization -[15]: /fr/ide_plugins/vscode/?tab=cursor -[16]: /fr/ide_plugins/vscode/ +[15]: https://cursor.com/marketplace/datadog +[16]: https://awesome-copilot.github.com/plugins/#file=plugins%2Fdatadog [17]: /fr/getting_started/site/#navigate-the-datadog-documentation-by-site [18]: /fr/ide_plugins/idea/ [19]: https://claude.ai @@ -820,7 +948,7 @@ L'authentification locale est recommandée pour Cline et lorsque l'authentificat [33]: /fr/database_monitoring/ [34]: /fr/tracing/ [35]: /fr/feature_flags/ -[36]: /fr/llm_observability/mcp_server/ +[36]: /fr/llm_observability/build_with_ai/mcp_server/ [37]: /fr/network_monitoring/cloud_network_monitoring/ [38]: /fr/network_monitoring/devices/ [39]: /fr/security/threats/security_signals/ @@ -842,8 +970,17 @@ L'authentification locale est recommandée pour Cline et lorsque l'authentificat [55]: https://claude.com/plugins/datadog [56]: https://claude.ai/directory/connectors/datadog [57]: /fr/real_user_monitoring/ -[58]: https://partners.datadoghq.com/s/login/SelfRegister +[58]: /fr/getting_started/profiler/ [59]: https://chatgpt.com/ -[60]: https://www.datadoghq.com/product-preview/mcp-codexec/ -[61]: /fr/getting_started/profiler/ -[62]: https://www.datadoghq.com/product-preview/datadog-agent-mcp/ \ No newline at end of file +[61]: https://partners.datadoghq.com/s/login/SelfRegister +[62]: https://www.datadoghq.com/product-preview/datadog-agent-mcp/ +[63]: /fr/cloud_cost_management/ +[64]: https://github.com/features/copilot/cli +[65]: https://awesome-copilot.github.com/plugins/#file=plugins%2Fdatadog +[66]: /fr/account_management/personal-access-tokens/ +[67]: /fr/account_management/service-access-tokens/ +[68]: /fr/account_management/org_settings/ip_allowlist/ +[69]: /fr/data_observability/ +[70]: /fr/account_management/audit_trail/ +[71]: https://x.ai/build +[72]: https://github.com/xai-org/plugin-marketplace \ No newline at end of file diff --git a/hugo/content/fr/metrics/guide/agent-filtering-for-custom-metrics.md b/hugo/content/fr/metrics/guide/agent-filtering-for-custom-metrics.md new file mode 100644 index 00000000000..4613b6ccdef --- /dev/null +++ b/hugo/content/fr/metrics/guide/agent-filtering-for-custom-metrics.md @@ -0,0 +1,400 @@ +--- +aliases: +- /fr/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics/ +description: Filtrez les métriques personnalisées inutilisées au niveau de Datadog + Agent pour réduire le volume de métriques ingérées et indexées. +further_reading: +- link: /metrics/custom_metrics/ + tag: Documentation + text: En savoir plus sur métriques personnalisées +- link: /account_management/billing/custom_metrics/?tab=countrate + tag: Documentation + text: Facturation des métriques personnalisées +- link: /metrics/metrics-without-limits/ + tag: Documentation + text: Metrics without Limits™ +- link: /metrics/volume/ + tag: Documentation + text: Gestion du volume de métriques +- link: https://www.datadoghq.com/blog/custom-metrics-governance/ + tag: Blog + text: Bonnes pratiques pour la gouvernance de bout en bout des métriques personnalisées +title: Filtrage côté Agent pour les métriques personnalisées +--- +{{< callout url="https://www.datadoghq.com/product-preview/agent-side-filtering-for-custom/" >}} Le filtrage côté Agent pour les métriques personnalisées est en préversion. Si cette fonctionnalité vous intéresse, remplissez ce formulaire. {{< /callout >}} + +## Présentation {#overview} + +Le filtrage côté Agent vous permet de filtrer les métriques personnalisées inutilisées ou indésirables (provenant à la fois de DogStatsD et des intégrations de l'Agent) directement au niveau de Datadog Agent, avant de les envoyer à Datadog. Cela peut réduire considérablement le volume de métriques personnalisées indexées et ingérées. + +Le filtrage est effectué au niveau de l'Agent mais géré de manière centralisée via l'interface utilisateur Datadog, offrant aux équipes une visibilité et un contrôle complets. Vous pouvez créer, mettre à jour et gérer des politiques de filtrage dans Datadog, rationalisant ainsi la gouvernance des métriques tout en maintenant la transparence. + +La création et la mise à jour de politiques de filtrage nécessitent l'autorisation RBAC [`metric_tags_write`][1]. Tous les utilisateurs peuvent consulter les politiques de filtrage. + +## Prérequis {#prerequisites} + +- Mettez à niveau vers Datadog Agent v7.67.0 ou une version supérieure. + - L'utilisation de la v7.70.0 ou d'une version supérieure est recommandée pour filtrer les métriques DogStatsD. + - L'utilisation de la v7.74.0 ou d'une version supérieure est requise pour les métriques d'intégration de l'Agent. +- Avec les autorisations [`org_management`][2], activez [Remote Configuration][3] pour votre organisation. +- Avec les autorisations [`api_keys_write`][4], activez la [fonctionnalité Remote Configuration sur les clés d'API][5] utilisées par vos Agents. Après avoir activé Remote Configuration sur une clé d'API, redémarrez vos Agents pour que le changement prenne effet. + +{{Bouton « Activer » pour les propriétés de la clé d'API dotées de la fonctionnalité Remote Configuration.}} + +## Créez une politique de filtrage des métriques {#create-a-metric-filtering-policy} + +Vous pouvez créer une politique de filtrage des métriques depuis la [page Paramètres des métriques][7] ou la [page Metrics Summary][6]. + +Les politiques de filtrage des métriques sont appliquées à tous les Agents v7.67.0+ (v7.74.0+ pour les métriques d'intégration de l'Agent) avec Remote Configuration activé. Les versions d'Agent plus anciennes, ou les Agents avec la Remote Configuration désactivé, n'appliquent pas les politiques de filtrage. + +Les mises à jour des politiques sont déployées sur les Agents en 1 à 2 minutes. + +### Depuis la page Paramètres des métriques {#from-the-metrics-settings-page} + +1. Cliquez sur {{< ui >}}\+ Create Policy{{< /ui >}}. +2. Cliquez sur {{< ui >}}Filter metrics{{< /ui >}}. +3. Fournissez une description pour la nouvelle politique. +4. Sélectionnez les métriques à filtrer dans le menu déroulant {{< ui >}}Metrics to Filter{{< /ui >}}, ou cliquez sur {{< ui >}}Upload CSV{{< /ui >}}. + - Si vous choisissez de téléverser un fichier CSV, sélectionnez le fichier et cliquez sur {{< ui >}}Open{{< /ui >}}. Vous pouvez utiliser plusieurs fichiers CSV pour créer la politique. +5. Lorsque vous êtes satisfait de la liste des métriques à filtrer, cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +### Depuis la page Metrics Summary {#from-the-metrics-summary-page} + +Créez une politique de filtrage des métriques depuis la page Metrics Summary en utilisant l'une des méthodes suivantes : + +{{< tabs >}} +{{% tab "Depuis une requête de métrique" %}} + +1. Saisissez une requête de métrique dans la barre de recherche. +2. Cliquez sur le bouton avec les trois points verticaux sur le côté droit de l'écran. +3. Cliquez sur {{< ui >}}Filter metrics{{< /ui >}}. +4. Dans le menu déroulant {{< ui >}}Choose policy{{< /ui >}}, cliquez sur {{< ui >}}New Policy{{< /ui >}}. Fournissez une description pour la politique. +5. Examinez le {{< ui >}}Metrics to Filter{{< /ui >}}. Cliquez sur `X` sur le côté droit de n'importe quelle ligne pour supprimer une métrique de la liste, ou cliquez sur {{< ui >}}\+ Include More Metrics{{< /ui >}} pour ajouter des métriques à la liste. +6. Cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/create_policy_from_metric_query.mp4" alt="Création d'une politique de filtrage de métriques à partir d'une requête de métrique" video="true" >}} + +{{% /tab %}} +{{% tab "Depuis l'éditeur de politique" %}} + +1. Cliquez sur le bouton avec trois points verticaux sur le côté droit de l'écran. +2. Cliquez sur {{< ui >}}Filter metrics{{< /ui >}}. +3. Dans la liste déroulante {{< ui >}}Choose policy{{< /ui >}}, cliquez sur {{< ui >}}New Policy{{< /ui >}}. Fournissez une description pour la politique. +4. Saisissez une requête de métrique dans le champ {{< ui >}}Metrics to Filter{{< /ui >}}, ou sélectionnez des métriques individuellement dans la liste déroulante. Cliquez sur `X` sur le côté droit de n'importe quelle ligne pour supprimer une métrique de la liste. +5. Cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/create_policy_with_policy_editor.mp4" alt="Création d'une politique de filtrage de métriques depuis l'éditeur de politique" video="true" >}} + +{{% /tab %}} +{{% tab "Depuis un téléversement CSV" %}} + +1. Cliquez sur le bouton avec trois points verticaux sur le côté droit de l'écran. +2. Cliquez sur {{< ui >}}Filter metrics{{< /ui >}}. +3. Dans la liste déroulante {{< ui >}}Choose policy{{< /ui >}}, cliquez sur {{< ui >}}New Policy{{< /ui >}}. Fournissez une description pour la politique. +4. Cliquez sur {{< ui >}}Upload CSV{{< /ui >}} à droite du champ {{< ui >}}Metrics to Filter{{< /ui >}}. +5. Sélectionnez le fichier CSV, et cliquez sur {{< ui >}}Open{{< /ui >}}. +6. Examinez les métriques listées. Cliquez sur `X` sur le côté droit de n'importe quelle ligne pour supprimer une métrique de la liste. Si nécessaire, téléversez des fichiers CSV supplémentaires, ou ajoutez des métriques via le champ {{< ui >}}Metrics to Filter{{< /ui >}}. +7. Cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/create_policy_with_csv_upload.mp4" alt="Création d'une politique de filtrage de métriques avec un téléversement de fichier CSV" video="true" >}} + +{{% /tab %}} +{{< /tabs >}} + +## Modifier une politique de filtrage de métriques {#edit-a-metric-filtering-policy} + +Vous pouvez modifier une politique de filtrage de métriques depuis la [page Paramètres des métriques][1] ou la [page Metrics Summary][2]. + +### Depuis la page Paramètres des métriques {#from-the-metrics-settings-page-1} + +1. Cliquez sur la politique pour la modifier. +2. Cliquez sur {{< ui >}}Edit{{< /ui >}}. +3. Sélectionnez les métriques à filtrer dans la liste déroulante {{< ui >}}Metrics to Filter{{< /ui >}}, ou cliquez sur {{< ui >}}Upload CSV{{< /ui >}}. + - Si vous choisissez de téléverser un fichier CSV, sélectionnez le fichier et cliquez sur {{< ui >}}Open{{< /ui >}}. +4. Cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/edit_policy_from_metrics_settings.mp4" alt="Modification d'une politique de filtrage de métriques depuis la page Paramètres des métriques" video="true" >}} + +### Depuis la page Metrics Summary {#from-the-metrics-summary-page-1} + +Modifiez une politique de filtrage de métriques depuis la page Metrics Summary en utilisant l'une des méthodes suivantes : + +{{< tabs >}} +{{% tab "Depuis une requête de métrique" %}} + +1. Saisissez une requête de métrique dans la barre de recherche. +2. Cliquez sur le bouton avec les trois points verticaux sur le côté droit de l'écran. +3. Cliquez sur {{< ui >}}Filter metrics{{< /ui >}}. +4. Dans la liste déroulante {{< ui >}}Choose policy{{< /ui >}}, sélectionnez la politique à modifier. +5. Examinez les listes {{< ui >}}Metrics to Filter{{< /ui >}} et {{< ui >}}Existing metrics in policy{{< /ui >}}. Cliquez sur `X` sur le côté droit de n'importe quelle ligne pour supprimer une métrique de la liste, ou cliquez sur {{< ui >}}\+ Include More Metrics{{< /ui >}} pour ajouter des métriques à la liste. +6. Cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/edit_policy_with_metric_query.mp4" alt="Modification d'une politique de filtrage de métriques avec une requête de métrique" video="true" >}} + +{{% /tab %}} +{{% tab "Depuis l'éditeur de politique" %}} + +1. Cliquez sur le bouton avec trois points verticaux sur le côté droit de l'écran. +2. Cliquez sur {{< ui >}}Filter metrics{{< /ui >}}. +3. Dans la liste déroulante {{< ui >}}Choose policy{{< /ui >}}, sélectionnez la politique à modifier. +4. Sélectionnez les métriques individuellement dans la liste déroulante {{< ui >}}Metrics to Filter{{< /ui >}}. Cliquez sur `X` sur le côté droit de n'importe quelle ligne pour supprimer une métrique de la liste. +5. Cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +{{% /tab %}} +{{% tab "Depuis un téléversement CSV" %}} + +1. Cliquez sur le bouton avec trois points verticaux sur le côté droit de l'écran. +2. Cliquez sur {{< ui >}}Filter metrics{{< /ui >}}. +3. Dans la liste déroulante {{< ui >}}Choose policy{{< /ui >}}, sélectionnez la politique à modifier. +4. Cliquez sur {{< ui >}}Upload CSV{{< /ui >}} à droite du champ {{< ui >}}Metrics to Filter{{< /ui >}}. +5. Sélectionnez le fichier CSV, et cliquez sur {{< ui >}}Open{{< /ui >}}. +6. Examinez les listes {{< ui >}}Metrics to Filter{{< /ui >}} et {{< ui >}}Existing metrics in policy{{< /ui >}}. Cliquez sur `X` sur le côté droit de n'importe quelle ligne pour supprimer une métrique de la liste, ou cliquez sur {{< ui >}}\+ Include More Metrics{{< /ui >}} pour ajouter des métriques à la liste. +7. Cliquez sur {{< ui >}}Save and Filter{{< /ui >}}. + +{{% /tab %}} +{{< /tabs >}} + +## Afficher toutes les politiques et les métriques filtrées {#view-all-policies-and-filtered-metrics} + +Vous pouvez afficher toutes vos politiques et métriques filtrées depuis la [page Paramètres des métriques][1]. + +Cliquez sur le [bouton des paramètres][1] : + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/settings_from_summary.png" alt="Le bouton des paramètres sur la page de résumé des métriques" style="width:100%;" >}} + +Cliquez sur {{< ui >}}Metrics{{< /ui >}} dans la barre de navigation et accédez directement aux paramètres : + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/settings_from_nav.png" alt="L'option des paramètres depuis le panneau Métriques développé dans Datadog" style="width:100%;" >}} + +### Afficher toutes les politiques {#view-all-policies} + +Sélectionnez l'onglet {{< ui >}}Policies{{< /ui >}} dans la barre latérale pour voir une liste de toutes vos politiques. Si vous ne voyez pas la barre latérale, cliquez sur le bouton {{< ui >}}Show Sidebar{{< /ui >}} {{< img src="metrics/guide/agent_filtering_for_custom_metrics/show_sidebar.png" inline="true" width="22" >}}. + +Cliquez sur n'importe quelle politique de filtrage de métriques pour ouvrir sa vue détaillée afin de la modifier ou de la supprimer. + +### Afficher toutes les métriques filtrées {#view-all-filtered-metrics} + +Sélectionnez l'onglet {{< ui >}}Filtered Metrics{{< /ui >}} dans la barre latérale pour voir une liste de toutes vos métriques filtrées. Si vous ne voyez pas la barre latérale, cliquez sur le bouton {{< ui >}}Show Sidebar{{< /ui >}} {{< img src="metrics/guide/agent_filtering_for_custom_metrics/show_sidebar.png" inline="true" width="22" >}}. + +Cliquez sur les politiques associées à une métrique filtrée dans la colonne {{< ui >}}ATTACHED POLICIES{{< /ui >}} pour les modifier ou les supprimer. + +## Supprimer les politiques {#delete-policies} + +Vous pouvez supprimer les politiques de filtrage de métriques depuis la [Metrics Settings page][1]. + +1. Cliquez sur la politique de filtrage de métriques à supprimer. +2. Sélectionnez {{< ui >}}Delete{{< /ui >}} dans le coin supérieur droit de la page. + +{{< img src="metrics/guide/agent_filtering_for_custom_metrics/delete_policy.png" alt="Le bouton de suppression de politique sur une vue détaillée de politique de filtrage de métriques" style="width:100%;" >}} + +## Gérez les politiques de filtrage de métriques via l'API {#manage-metric-filtering-policies-through-the-api} + +
Ces endpoints sont susceptibles de changer pendant que le filtrage côté Agent pour les métriques personnalisées est en version préliminaire.
+ +Ces endpoints nécessitent une clé Datadog API et une clé d'application valides. Consultez [Getting started][8] dans la référence de l'API pour plus d'informations. + +### Créer une politique de métrique filtrée {#create-a-filtered-metric-policy} + +L'URL de base pour votre [Datadog site][9] sélectionné est : {{}} + +Remplacez `` dans l'exemple ci-dessous par l'URL de base. + +**POST** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies` + +#### Exemple de corps {#example-body} + +{{< code-block lang="json" disable_copy="false" collapsible="true" >}} +{ + "data": { + "type": "filtered_metrics", + "attributes": { + "policy_name": "my policy", + "metric_names": [ + "metric.name.one", + "metric.name.two" + ] + } + } +} +{{< /code-block >}} + +### Mettre à jour une politique de filtrage de métriques (mise à jour partielle) {#update-a-filtered-metric-policy-partial-update} + +L'URL de base pour votre [Datadog site][9] sélectionné est : {{}} + +Remplacez `` dans l'exemple ci-dessous par l'URL de base. + +**PATCH** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +#### Exemple de corps {#example-body-1} + +{{< code-block lang="json" disable_copy="false" collapsible="true" >}} +{ + "data": { + "type": "filtered_metrics", + "attributes": { + "policy_name": "my policy", + "metrics_to_add": [ + "metric.name.three", + "metric.name.four" + ], + "metrics_to_remove": [ + "metric.name.five", + "metric.name.six" + ] + } + } +} +{{< /code-block >}} + +### Mettre à jour une politique de filtrage de métriques (remplacement complet) {#update-a-filtered-metric-policy-full-replace} + +L'URL de base pour votre [Datadog site][9] sélectionné est : {{}} + +Remplacez `` dans l'exemple ci-dessous par l'URL de base. + +**PUT** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +#### Exemple de corps {#example-body-2} + +{{< code-block lang="json" disable_copy="false" collapsible="true" >}} +{ + "data": { + "type": "filtered_metrics", + "attributes": { + "policy_name": "my policy", + "metric_names": [ + "metric.name.seven", + "metric.name.eight" + ] + } + } +} +{{< /code-block >}} + +### Supprimer une politique {#delete-a-policy} + +L'URL de base pour votre [Datadog site][9] sélectionné est : {{}} + +Remplacez `` dans l'exemple ci-dessous par l'URL de base. + +**DELETE** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +### Obtenir une politique de filtrage de métriques {#get-a-filtered-metric-policy} + +L'URL de base pour votre [Datadog site][9] sélectionné est : {{}} + +Remplacez `` dans l'exemple ci-dessous par l'URL de base. + +**GET** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}` + +#### Exemple de corps de réponse {#example-response-body} + +{{< code-block lang="json" disable_copy="true" collapsible="true" >}} +{ + "data": [ + { + "type": "filtered_metrics", + "id": "metric.name.one", + "attributes": { + "updated_timestamp": 1745954352 + } + }, + { + "type": "filtered_metrics", + "id": "metric.name.two" + "attributes": { + "updated_timestamp": 1745954389 + } + } + // ... up to ~10,000 entries + ], + "links": { + "self": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=200&page[limit]=100", + "next": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=300&page[limit]=100", + "prev": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=100&page[limit]=100", + "first": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=0&page[limit]=100", + "last": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=9900&page[limit]=100" + }, + "meta": { + "agent_coverage_percent": 100, + "agents_with_latest_policy_count": 4, + "deployment_failure": { + "failed_agent_count": 0, + "failure_message": "" + }, + "deployment_status": "Deployed to all Agents", + "deployment_strategy": "all", + "policy_name": "test_policy_1", + "total": 7, + "total_agent_count": 4, + "updated_by": "user@datadoghq.com", + "updated_timestamp": 1758912365 + } +} +{{< /code-block >}} + +### Lister les politiques de filtrage de métriques {#list-filtered-metric-policies} + +L'URL de base pour votre [Datadog site][9] sélectionné est : {{}} + +Remplacez `` dans l'exemple ci-dessous par l'URL de base. + +**GET** `/api/unstable/remote_config/products/metric_control/filtered_metrics/policies` + +#### Exemple de corps de réponse {#example-response-body-1} + +{{< code-block lang="json" disable_copy="true" collapsible="true" >}} +{ + "data": [ + { + "id": "06b-fab-47e", + "type": "filtered_metrics", + "attributes": { + "count": 85, + "deployment_status": "Deployed to all Agents", + "deployment_strategy": "all", + "policy_name": "policy one", + "updated_by": "user@datadoghq.com", + "updated_timestamp": 1758547485, + "version": 4 + } + }, + { + "id": "07b-201-47e", + "type": "filtered_metrics", + "attributes": { + "count": 8, + "deployment_status": "Deployed to all Agents", + "deployment_strategy": "all", + "policy_name": "policy two", + "updated_by": "user@datadoghq.com", + "updated_timestamp": 1758547212, + "version": 1 + } + } + ] +} +{{< /code-block >}} + +## Limitations de la version préliminaire {#preview-limitations} + +Cette version préliminaire initiale inclut les limitations suivantes : + +- Un maximum de 10 000 noms de métriques peuvent être filtrés. +- L'impact de l'utilisation des ressources sur l'Agent est limité à 10 Mo de mémoire (RSS), sans augmentation de l'utilisation du CPU. +- Seules les métriques personnalisées reçues de DogStatsD ou des intégrations de l'Agent sont prises en charge. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/account_management/rbac/permissions/#metrics +[2]: /fr/account_management/rbac/permissions/#access-management +[3]: https://app.datadoghq.com/organization-settings/remote-config +[4]: /fr/account_management/rbac/permissions#api-and-application-keys +[5]: https://app.datadoghq.com/organization-settings/api-keys +[6]: https://app.datadoghq.com/metric/summary +[7]: https://app.datadoghq.com/metric/settings/policies +[8]: /fr/api/latest/#getting-started +[9]: /fr/getting_started/site/ \ No newline at end of file diff --git a/hugo/content/fr/monitors/guide/custom_schedules.md b/hugo/content/fr/monitors/guide/custom_schedules.md new file mode 100644 index 00000000000..5c5823199eb --- /dev/null +++ b/hugo/content/fr/monitors/guide/custom_schedules.md @@ -0,0 +1,115 @@ +--- +description: Configurez des plannings de monitor personnalisés avec des intervalles + quotidiens, hebdomadaires ou mensuels pour les jobs critiques en utilisant des modèles + RRULE pour une planification avancée. +disable_toc: false +further_reading: +- link: https://docs.datadoghq.com/monitors/configuration/?tab=thresholdalert#evaluation-frequency + tag: Documentation + text: En savoir plus sur la fréquence d'évaluation des monitors +- link: /monitors/downtimes + tag: Documentation + text: Downtimes +- link: /monitors/configuration/?tab=thresholdalert#evaluation-window + tag: Documentation + text: Périodes cumulées +title: Personnalisez les fréquences d'évaluation des monitors +--- +## Présentation {#overview} + +Définissez une heure d'évaluation spécifique et contrôlez la fréquence d'évaluation des monitors pour suivre l'exécution des jobs critiques s'exécutant dans votre environnement. Les plannings personnalisés de monitor vous permettent d'alerter sur des systèmes et des processus qui n'ont pas besoin d'être surveillés en continu, tels que les jobs cron. + +Les plannings personnalisés de monitor sont pris en charge sur les monitors d'événements, de logs et de métriques avec des intervalles de planification quotidiens, hebdomadaires et mensuels. + +## Configuration {#configuration} + +{{< img src="/monitors/guide/custom_schedules/add_custom_schedule.png" alt="Bouton pour ajouter un planning personnalisé dans la configuration du monitor" style="width:100%;" >}} + +Cliquez sur {{< ui >}}Add Custom Schedule{{< /ui >}} pour configurer votre fréquence d'évaluation. + +
Lorsqu'un planning personnalisé est activé sur un monitor, il ne peut pas être désactivé. Les plannings personnalisés ne peuvent être ajoutés ou supprimés que lors de la création du monitor. Le paramètre {{< ui >}}Remove non-reporting groups{{< /ui >}} est indisponible. Pour contourner ce problème, créez un nouveau monitor sans plannings personnalisés. +
+ +{{< tabs >}} +{{% tab "Jour" %}} +Sélectionnez l'heure de la journée à laquelle vous souhaitez que le monitor effectue l'évaluation. + +Par exemple, le monitor suivant vérifie chaque jour à 20h00 que le job de sauvegarde quotidienne a généré un événement de réussite pour chaque instance de base de données. + +{{< img src="monitors/guide/custom_schedules/custom_day.png" alt="Configuration du monitor pour vérifier chaque jour à 20h qu'un événement de réussite a été généré pour chaque instance de base de données suite au job de sauvegarde quotidienne" style="width:100%;" >}} + +{{% /tab %}} + +{{% tab "Semaine" %}} +Sélectionnez les jours de la semaine ainsi que l'heure de la journée à laquelle vous souhaitez que le monitor effectue l'évaluation. + +Par exemple, le monitor suivant vérifie chaque semaine le mardi et le samedi à 6h00 que les e-mails marketing ont été envoyés pour chaque campagne individuelle. + +{{< img src="monitors/guide/custom_schedules/custom_week.png" alt="Configuration du monitor pour vérifier chaque semaine le mardi et le samedi à 6h que les e-mails marketing ont été envoyés pour chaque campagne individuelle" style="width:100%;" >}} + +{{% /tab %}} + +{{% tab "Mois" %}} +Sélectionnez le jour du mois ainsi que l'heure de la journée à laquelle vous souhaitez que le monitor effectue son évaluation. + +Par exemple, le monitor suivant vérifie le premier jour de chaque mois si le job cron générant les factures clients s'est exécuté avec succès. + +{{< img src="monitors/guide/custom_schedules/custom_month.png" alt="Configuration du monitor pour vérifier le premier jour de chaque mois si le job cron générant les factures clients s'est exécuté avec succès." style="width:100%;" >}} + +{{% /tab %}} +{{< /tabs >}} + +## RRULES {#rrules} + +La règle de récurrence (RRULE) est un nom de propriété issu de la [RFC iCalendar][1], qui est la norme pour définir des événements récurrents. Utilisez le [générateur RRULE officiel][2] pour générer des règles récurrentes. Tirez parti des RRULE pour couvrir des cas d'utilisation de planification plus avancés. + +Pour rédiger une RRULE personnalisée pour votre monitor, cliquez sur {{< ui >}}Use RRULE{{< /ui >}}. + +**Remarques** : +- Les attributs spécifiant la durée dans une règle RRULE ne sont pas pris en charge (par exemple, DTSTART, DTEND, DURATION). +- Les fréquences d'évaluation doivent être d'un jour ou plus. Pour des fréquences d'évaluation plus courtes, utilisez les plannings de monitor par défaut. + +#### Exemple : Le monitor s'évalue le dernier jour du mois {#example-monitor-evaluates-on-the-last-day-of-the-month} + +```text +FREQ=MONTHLY;BYMONTHDAY=28,29,30,31;BYSETPOS=-1 +``` +{{< img src="monitors/guide/custom_schedules/RRULE_last_day_month.png" alt="Syntaxe RRULE utilisée dans l'interface utilisateur pour évaluer le dernier jour du mois" style="width:90%;" >}} + +#### Exemple : Le monitor s'évalue un mois sur deux le premier et le dernier dimanche du mois : {#example-monitor-evaluates-every-other-month-on-the-first-and-last-sunday-of-the-month} + +```text +FREQ=MONTHLY;INTERVAL=2;BYDAY=1SU,-1SU +``` + +{{< img src="monitors/guide/custom_schedules/RRULE_month_last_sunday.png" alt="Syntaxe RRULE utilisée dans l'interface utilisateur pour évaluer un mois sur deux le premier et le dernier dimanche du mois" style="width:90%;" >}} + +## Comportement d'alerte des monitors avec des plannings personnalisés {#alerting-behavior-of-monitors-with-custom-schedules} + +Les monitors utilisant la planification par défaut exécutent la requête avec la fréquence d'évaluation par défaut et envoient des alertes en fonction des transitions d'état du monitor (par exemple, lorsqu'un monitor passe de WARN à OK ou de OK à ALERT). + +La chronologie ci-dessous illustre le comportement d'un monitor avec une planification par défaut. Le monitor envoie des alertes correspondant aux changements d'état. + +{{< img src="monitors/guide/custom_schedules/alerting_behavior_regular.png" alt="Diagramme visuel montrant quand un monitor envoie une alerte en fonction des transitions d'état du monitor pour le planning par défaut avec une fréquence d'évaluation de trente minutes" style="width:100%;" >}} + +Les monitors avec des plannings personnalisés, en revanche, s'évaluent sur une base quotidienne, hebdomadaire ou mensuelle et envoient des alertes en fonction des résultats des évaluations individuelles. Chaque évaluation est indépendante de la précédente et envoie une notification lorsque le résultat n'est pas OK. + +La chronologie ci-dessous illustre le comportement d'un monitor fonctionnant sur un planning personnalisé. Contrairement au monitor à planning par défaut, le monitor à planning personnalisé envoie une alerte pendant son temps d'évaluation en fonction de l'état du monitor. +{{< img src="monitors/guide/custom_schedules/alerting_behavior_custom.png" alt="Diagramme visuel montrant quand un monitor envoie une alerte en fonction de l'état du monitor pour le planning personnalisé avec une fréquence d'évaluation quotidienne" style="width:100%;" >}} + +## Rétention de groupe {#group-retention} + +Par défaut, [les groupes sont conservés][3] pendant 24 ou 48 heures après qu'un groupe a cessé de rapporter des données, puis sont supprimés du monitor. Les monitors avec des plannings personnalisés conservent les groupes beaucoup plus longtemps, et leur rétention s'adapte à la fréquence d'évaluation que vous configurez : +| Fréquence d'évaluation | Rétention de groupe | +|-----------------------|------------------| +| Quotidienne | 30 jours | +| Hebdomadaire | 90 jours | +| Mensuelle | 180 jours | + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://icalendar.org/rrule-tool.html +[2]: https://icalendar.org/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html +[3]: https://docs.datadoghq.com/fr/monitors/configuration/?tab=thresholdalert#group-retention-time \ No newline at end of file diff --git a/hugo/content/fr/network_monitoring/cloud_network_monitoring/_index.md b/hugo/content/fr/network_monitoring/cloud_network_monitoring/_index.md new file mode 100644 index 00000000000..1f22f4dbd5f --- /dev/null +++ b/hugo/content/fr/network_monitoring/cloud_network_monitoring/_index.md @@ -0,0 +1,80 @@ +--- +algolia: + tags: + - Cloud Network Monitoring + - Network Performance Monitoring + - CNM + - NPM +aliases: +- /fr/monitors/network_flow_monitors/ +- /fr/graphing/infrastructure/network_performance_monitor/ +- /fr/network_performance_monitoring/ +- /fr/network_monitoring/performance/ +description: Explorez les métriques pour la communication point à point sur votre + infrastructure. +further_reading: +- link: https://www.datadoghq.com/architecture/hybrid-cloud-network-observability/ + tag: Architecture Center + text: Architecture de référence pour l'observabilité des réseaux hybrides multi-cloud +- link: https://www.datadoghq.com/blog/cnm-network-health + tag: Blog + text: Détectez, diagnostiquez et résolvez facilement les problèmes réseau avec CNM + Network Health +- link: /network_monitoring/cloud_network_monitoring/guide/detecting_application_availability/ + tag: Guide + text: Détection de la disponibilité des applications à l'aide de Network Insights +- link: https://www.datadoghq.com/blog/npm-windows-support/ + tag: Blog + text: Surveillez les hôtes Windows avec Cloud Network Monitoring +- link: https://www.datadoghq.com/blog/cloud-service-autodetection-datadog/ + tag: Blog + text: Surveiller la santé d'endpoints cloud avec la détection automatique des services + cloud +- link: https://www.datadoghq.com/blog/npm-best-practices/ + tag: Blog + text: Bonnes pratiques pour bien démarrer avec Datadog CNM +- link: https://www.datadoghq.com/blog/monitor-consul-with-datadog-npm/ + tag: Blog + text: Datadog CNM prend désormais en charge la mise en réseau Consul +- link: https://www.datadoghq.com/blog/npm-story-centric-ux/ + tag: Blog + text: Démarrage rapide des investigations réseau avec l'UX centrée sur les scénarios + de CNM +- link: https://www.datadoghq.com/blog/monitor-connection-churn-datadog/ + tag: Blog + text: Bonnes pratiques pour surveiller et corriger la baisse des connexions +- link: /network_monitoring/cloud_network_monitoring/glossary + tag: Doc + text: Termes et concepts de CNM +- link: https://learn.datadoghq.com/courses/getting-started-infra-cnm + tag: Centre d'apprentissage + text: Premiers pas avec Infrastructure and Cloud Network Monitoring (CNM) +title: Cloud Network Monitoring +--- +## Présentation {#overview} + +{{< vimeo url="https://player.vimeo.com/progressive_redirect/playback/670228207/rendition/1080p/file.mp4?loc=external&signature=42d4a7322017fffa6d5cc2e49ddbb7cfc4c6bbbbf207d13a5c9830630bda4ece" poster="/images/poster/npm.png" >}} + +Datadog Cloud Network Monitoring (CNM) vous offre une visibilité sur votre trafic réseau entre les services, les conteneurs, les zones de disponibilité et tout autre tag dans Datadog. Les données de connexion aux niveaux IP, port et PID sont agrégées en dépendances de couche application entre des endpoints client et serveur significatifs, qui peuvent être analysés et visualisés via une [page réseau][1] et une [carte réseau][2] personnalisables. Utilisez les données de flux ainsi que les métriques clés du trafic réseau et du serveur DNS pour : + +* Identifier précisément les dépendances de service inattendues ou latentes +* Optimiser les communications coûteuses inter-régionales ou multi-cloud +* Identifier les pannes des régions de fournisseurs cloud et des outils tiers +* Dépanner les problèmes de serveur DNS côté client et côté serveur + +{{< whatsnext desc="Cette section comprend les sujets suivants :">}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/setup" >}}Configuration : Configurez l'Agent pour collecter les données réseau.{{< /nextlink >}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/network_health" >}}Santé du réseau : Examinez la santé de votre environnement réseau.{{< /nextlink >}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/network_analytics" >}}Network Analytics : Représentez graphiquement vos données réseau entre les clients et serveurs disponibles{{< /nextlink >}} + {{< nextlink href="network_monitoring/network_path/setup/#scheduled-tests" >}}Tests planifiés Network Path : Visualisez l'itinéraire que suit le trafic réseau de son origine à sa destination à l'aide de tests planifiés.{{< /nextlink >}} + {{< nextlink href="network_monitoring/network_path/setup/#dynamic-tests" >}}Tests dynamiques Network Path : Créez dynamiquement des tests pour permettre à l'Agent de découvrir et de surveiller automatiquement les chemins réseau.{{< /nextlink >}} + {{< nextlink href="network_monitoring/cloud_network_monitoring/network_map" >}}Network Map : Cartographiez vos données réseau entre vos tags.{{< /nextlink >}} + {{< nextlink href="monitors/types/cloud_network_monitoring/#common-monitors" >}}monitors communs : Configurez les monitors CNM communs.{{< /nextlink >}} +{{< /whatsnext >}} + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/network +[2]: https://app.datadoghq.com/network/map \ No newline at end of file diff --git a/hugo/content/fr/network_monitoring/netflow/_index.md b/hugo/content/fr/network_monitoring/netflow/_index.md index 70318af3738..15a307a9115 100644 --- a/hugo/content/fr/network_monitoring/netflow/_index.md +++ b/hugo/content/fr/network_monitoring/netflow/_index.md @@ -2,6 +2,9 @@ aliases: - /fr/network_monitoring/devices/netflow/ further_reading: +- link: https://www.datadoghq.com/architecture/hybrid-cloud-network-observability/ + tag: Architecture Center + text: Architecture de référence pour l'observabilité des réseaux hybrides multi-cloud - link: /network_monitoring/devices/profiles tag: Documentation text: Utiliser des profils avec le Network Device Monitoring @@ -15,6 +18,10 @@ further_reading: tag: Blog text: Surveiller et résoudre des problèmes de performances réseau avec des interruptions SNMP +- link: https://www.datadoghq.com/blog/understanding-netflow-duplication/ + tag: Blog + text: 'Comprendre la duplication NetFlow : pourquoi elle se produit et comment la + dédupliquer' title: NetFlow Monitoring --- ## Présentation {#overview} @@ -94,7 +101,7 @@ Datadog enrichit les ports dans NetFlow avec les données de l'IANA (Internet As Vous pouvez également ajouter vos propres enrichissements personnalisés pour mapper les ports et les protocoles à des applications spécifiques (par exemple, si un service personnalisé s'exécute sur un port spécifique). Cela permet aux ingénieurs réseau et à leurs équipes d'interpréter et d'interroger plus facilement les données NetFlow avec des noms lisibles par l'homme. -Depuis l'onglet {{< ui >}}Configuration{{< /ui >}} dans NetFlow, cliquez sur {{< ui >}}+ Add Enrichment{{< /ui >}} pour télécharger le fichier CSV contenant vos enrichissements personnalisés. +Depuis l'onglet {{< ui >}}Configuration{{< /ui >}} dans NetFlow, cliquez sur {{< ui >}}\+ Add Enrichment{{< /ui >}} pour importer le fichier CSV contenant vos enrichissements personnalisés. {{< img src="network_device_monitoring/netflow/new_enrichment_2.png" alt="La nouvelle fenêtre modale de mappage d'enrichissement dans l'onglet de configuration NetFlow." width="100%" >}} @@ -102,7 +109,7 @@ Depuis l'onglet {{< ui >}}Configuration{{< /ui >}} dans NetFlow, cliquez sur {{< Vous pouvez également ajouter vos propres enrichissements personnalisés pour mapper les IP et les CIDR à des tags personnalisés (par exemple, pour catégoriser les services s'exécutant sur des adresses IP spécifiques). Cela permet aux ingénieurs réseau et à leurs équipes d'interpréter et d'interroger plus facilement les données NetFlow avec des noms lisibles par l'homme. -Depuis la [{{< ui >}}Enrichment{{< /ui >}} page des paramètres][10], cliquez sur {{< ui >}}+ Add Enrichment{{< /ui >}} pour ajouter des mappages manuellement ou téléchargez un fichier CSV pour ajouter des mappages en masse. +Depuis la [{{< ui >}}Enrichment{{< /ui >}} page des paramètres][10], cliquez sur {{< ui >}}\+ Add Enrichment{{< /ui >}} pour ajouter des mappages manuellement ou importer un fichier CSV afin d'ajouter des mappages en masse. ### Enrichissement IP privé DNS inverse {#reverse-dns-private-ip-enrichment} @@ -110,7 +117,7 @@ Activez l'enrichissement IP privé DNS inverse pour effectuer des recherches DNS Par défaut, l'enrichissement IP DNS inverse dans votre [`datadog.yaml` fichier][7] est désactivé. Pour l'activer, consultez la section [Configuration](#configuration) de cette page. -Recherchez DNS dans le menu {{< ui >}}+ Filter{{< /ui >}} pour localiser les flux associés à l'enrichissement IP DNS inverse : +Recherchez DNS dans le menu {{< ui >}}\+ Filter{{< /ui >}} pour localiser les flux associés à l'enrichissement IP DNS inverse : {{< img src="network_device_monitoring/netflow/dns_ip_enrichmen_2.png" alt="Menu de filtrage amélioré pour afficher les facettes de destination et de source DNS inverse" width="100%" >}} diff --git a/hugo/content/fr/opentelemetry/getting_started/otel_demo_to_datadog.md b/hugo/content/fr/opentelemetry/getting_started/otel_demo_to_datadog.md new file mode 100644 index 00000000000..92f92cf8ea8 --- /dev/null +++ b/hugo/content/fr/opentelemetry/getting_started/otel_demo_to_datadog.md @@ -0,0 +1,403 @@ +--- +algolia: + tags: + - opentelemetry + - open telemetry + - otel + - opentelemetry demo +aliases: +- /fr/opentelemetry/guide/otel_demo_to_datadog +- /fr/opentelemetry/otel_demo_to_datadog +further_reading: +- link: /internal_developer_portal/catalog/ + tag: Documentation + text: Catalog +- link: /tracing/trace_explorer/ + tag: Documentation + text: Trace Explorer +- link: /tracing/trace_explorer/trace_queries/ + tag: Documentation + text: Requêtes de traces +- link: /error_tracking/ + tag: Documentation + text: Error Tracking +title: Envoi de données de la démo OpenTelemetry vers Datadog +--- +## Présentation {#overview} + +
Ce tutoriel utilise l'exportateur Datadog et le connecteur Datadog. Pour les nouvelles configurations de Collector, Datadog recommande le pipeline OTLP dans Configurer le Collector OpenTelemetry.
+ +La [démo OpenTelemetry][1] est une application de microservices développée par la communauté pour démontrer l'instrumentation OpenTelemetry (OTel) +et ses capacités d'observabilité. Il s'agit d'une page web de commerce électronique composée de multiples microservices communiquant entre eux via HTTP et gRPC. Tous les services sont instrumentés avec OpenTelemetry et produisent des traces, des métriques et des logs. + +Cette page vous guide à travers les étapes nécessaires pour déployer la démo OpenTelemetry et envoyer ses données vers Datadog. + +## Prérequis {#prerequisites} + +Pour compléter ce guide, assurez-vous de disposer des éléments suivants : + +1. [Créez un compte Datadog][2] si ce n'est pas déjà fait. +2. Trouvez ou créez votre [clé Datadog API][3]. +3. 6 Go de RAM libre pour l'application. + +Vous pouvez déployer la démo en utilisant Docker ou Kubernetes (avec Helm). Choisissez votre méthode de déploiement préférée et assurez-vous d'avoir installé les outils nécessaires : + +{{< tabs >}} +{{% tab "Docker" %}} + +- Docker +- Docker Compose v2.0.0+ +- Make (optionnel) + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +- Kubernetes 1.24+ +- Helm 3.9+ +- Un cluster Kubernetes actif avec kubectl configuré pour s'y connecter + +{{% /tab %}} +{{< /tabs >}} + +## Configuration et déploiement de la démo {#configuring-and-deploying-the-demo} + +### Clonage du dépôt {#cloning-the-repository} + +Clonez le dépôt `opentelemetry-demo` sur votre appareil : + +```shell +git clone https://github.com/open-telemetry/opentelemetry-demo.git +``` + +### Configuration de l'OpenTelemetry Collector {#configuring-the-opentelemetry-collector} + +Pour envoyer les données de télémétrie de la démo à Datadog, vous devez ajouter les composants suivants à la configuration de l'OpenTelemetry Collector : + +- `Resource Processor` est un composant `optional` mais recommandé, utilisé pour définir l'attribut de ressource `deployment.environment.name`, que Datadog mappe vers le tag `env`. +- `Datadog Connector` est responsable du calcul des métriques de trace Datadog APM. +- `Datadog Exporter` est responsable de l'exportation des traces, des métriques et des logs vers Datadog. +- `Datadog Extension` est un composant `optional` qui vous permet de visualiser la configuration de l'OpenTelemetry Collector au sein de la surveillance de l'infrastructure. (En savoir plus sur [Datadog Extension][13]). + +Complétez les étapes suivantes pour configurer ces composants. + +{{< tabs >}} +{{% tab "Docker" %}} + +1. Ouvrez le dépôt de la démo. Créez un fichier nommé `docker-compose.override.yml` dans le dossier racine. + +2. Ouvrez le fichier créé. Collez le contenu suivant et définissez les variables d'environnement [Datadog site][7] et [Datadog API key][8] : + + ```yaml + services: + otel-collector: + command: + - "--config=/etc/otelcol-config.yml" + - "--config=/etc/otelcol-config-extras.yml" + - "--feature-gates=datadog.EnableOperationAndResourceNameV2" + environment: + - DD_SITE_PARAMETER= + - DD_API_KEY= + ``` + +3. Pour configurer l'OpenTelemetry Collector, ouvrez `src/otel-collector/otelcol-config-extras.yml` et ajoutez ce qui suit au fichier : + + ```yaml + extensions: + datadog/extension: + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + http: + endpoint: "localhost:9875" + path: "/metadata" + + exporters: + datadog: + traces: + compute_stats_by_span_kind: true + trace_buffer: 500 + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + sending_queue: + batch: + min_size: 10 + max_size: 100 + flush_timeout: 10s + + processors: + resource: + attributes: + - key: deployment.environment.name + value: "otel" + action: upsert + + connectors: + datadog/connector: + traces: + compute_stats_by_span_kind: true + + service: + extensions: [datadog/extension] + pipelines: + traces: + receivers: [otlp] + processors: [resourcedetection, memory_limiter, resource, transform/sanitize_spans] + exporters: [otlp_grpc/jaeger, debug, spanmetrics, datadog, datadog/connector] + metrics: + receivers: [datadog/connector, docker_stats, httpcheck/frontend-proxy, hostmetrics, nginx, otlp, postgresql, redis, spanmetrics] + processors: [resourcedetection, memory_limiter, resource] + exporters: [otlp_http/prometheus, debug, datadog] + logs: + receivers: [otlp] + processors: [resourcedetection, memory_limiter, resource] + exporters: [opensearch, debug, datadog] + ``` + + By default, the collector in the demo application merges the configuration from two files: + + - `src/otel-collector/otelcol-config.yml`: contains the default configuration for the collector. + - `src/otel-collector/otelcol-config-extras.yml`: used to add extra configuration to the collector. + +
+ Lors de la fusion de valeurs YAML, les objets sont fusionnés et les tableaux sont remplacés. + C'est pourquoi davantage de composants sont spécifiés dans les pipelines qu'il n'y en a réellement de configurés. + La configuration précédente ne remplace pas les valeurs configurées dans le principal otelcol-config fichier. +
+ +[7]: /fr/getting_started/site/ +[8]: https://app.datadoghq.com/organization-settings/api-keys/ + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +1. Créez un secret nommé `dd-secrets` pour stocker les secrets Datadog Site et API Key : + + ```shell + kubectl create secret generic dd-secrets --from-literal="DD_SITE_PARAMETER=" --from-literal="DD_API_KEY=" + ``` + +2. Ajoutez le [chart Helm][4] OpenTelemetry à votre dépôt pour gérer et déployer la démo OpenTelemetry : + + ```shell + helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts + ``` + +3. Créez un fichier nommé `my-values-file.yml` avec le contenu suivant : + + ```yaml + opentelemetry-collector: + extraEnvsFrom: + - secretRef: + name: dd-secrets + config: + extensions: + datadog/extension: + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + http: + endpoint: "localhost:9875" + path: "/metadata" + exporters: + datadog: + traces: + compute_stats_by_span_kind: true + trace_buffer: 500 + hostname: "otelcol-helm" + api: + site: ${env:DD_SITE_PARAMETER} + key: ${env:DD_API_KEY} + sending_queue: + batch: + min_size: 10 + max_size: 100 + flush_timeout: 10s + + processors: + resource: + attributes: + - key: deployment.environment.name + value: "otel" + action: upsert + + connectors: + datadog/connector: + traces: + compute_stats_by_span_kind: true + + service: + extensions: [health_check, datadog/extension] + pipelines: + traces: + processors: [memory_limiter, resource, resourcedetection, transform] + exporters: [otlp/jaeger, debug, spanmetrics, datadog, datadog/connector] + metrics: + receivers: [datadog/connector, otlp, spanmetrics] + processors: [memory_limiter, resource, resourcedetection, transform] + exporters: [otlphttp/prometheus, debug, datadog] + logs: + processors: [memory_limiter, resource, resourcedetection, transform] + exporters: [opensearch, debug, datadog] + ``` + +
+ Lors de la fusion de valeurs YAML, les objets sont fusionnés et les tableaux sont remplacés. + C'est pourquoi davantage de composants sont spécifiés dans les pipelines qu'il n'y en a réellement de configurés. + La configuration précédente ne remplace pas les valeurs configurées dans le principal otelcol-config fichier. +
+ +[4]: https://opentelemetry.io/docs/demo/kubernetes-deployment/ + +{{% /tab %}} +{{< /tabs >}} + +### Exécution de la démo {#running-the-demo} + +{{< tabs >}} +{{% tab "Docker" %}} + +Si make est installé, vous pouvez utiliser la commande suivante pour démarrer la démo : + +```shell +make start +``` + +Si `make` n'est pas installé, vous pouvez utiliser directement la commande `docker compose` : + +```shell +docker compose --env-file .env --env-file .env.override up --force-recreate --remove-orphans --detach +``` + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +Pour déployer l'application de démo sur Kubernetes avec Helm, exécutez la commande suivante : + +```shell +helm install my-otel-demo open-telemetry/opentelemetry-demo --values my-values-file.yml +``` + +{{% /tab %}} +{{< /tabs >}} + +## Navigation dans l'application {#navigating-the-application} + +Vous pouvez accéder à l'interface web de l'Astronomy Shop pour explorer l'application et observer comment les données de télémétrie sont générées. + +{{< tabs >}} +{{% tab "Docker" %}} + +Allez sur . + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +1. Si vous exécutez un cluster local, vous devez rediriger le port du proxy frontend : + + ```shell + kubectl port-forward svc/my-otel-demo-frontendproxy 8080:8080 + ``` + +2. Allez sur . + +{{% /tab %}} +{{< /tabs >}} + +## Corrélation des données de télémétrie {#telemetry-data-correlation} + +Les étapes d'instrumentation utilisées dans tous les services de la démo se trouvent +dans la documentation principale d'OpenTelemetry. + +Vous pouvez trouver le langage dans lequel chaque service a été implémenté ainsi que sa +documentation dans le [tableau de référence des fonctionnalités linguistiques][10]. + +## Explorer les données OpenTelemetry dans Datadog {#exploring-opentelemetry-data-in-datadog} + +Lorsque la démo OTel est en cours d'exécution, le générateur de charge intégré simule du trafic dans l'application. +Après quelques secondes, vous pouvez voir les données arriver dans Datadog. + +### Catalog {#catalog} + +Affichez tous les services qui font partie de la démo OTel : + +1. Allez dans [{{< ui >}}APM{{< /ui >}} > {{< ui >}}Catalog{{< /ui >}}][11]. + +{{< img src="/getting_started/opentelemetry/otel_demo/software_catalog.png" alt="Voir la page du catalogue avec la liste des services de l'application de démo OpenTelemetry" style="width:90%;" >}} + +2. Sélectionnez {{< ui >}}Map{{< /ui >}} pour voir comment les services sont connectés. Changez {{< ui >}}Map layout{{< /ui >}} pour {{< ui >}}Cluster{{< /ui >}} ou {{< ui >}}Flow{{< /ui >}} pour voir la carte dans différents modes. + +{{< img src="/getting_started/opentelemetry/otel_demo/software_catalog_flow.png" alt="Voir le flux de la Service Map avec tous les services connectés" style="width:90%;" >}} + +3. Sélectionnez la vue {{< ui >}}Catalog{{< /ui >}}, puis sélectionnez un service pour voir un résumé des performances dans le panneau latéral. + +{{< img src="/getting_started/opentelemetry/otel_demo/software_catalog_service.png" alt="Voir le résumé des performances et les conseils de configuration d'un service spécifique" style="width:90%;" >}} + +### Trace Explorer{#trace-explorer} + +Explorez les traces reçues de la démo OTel : + +1. Depuis {{< ui >}}Performance{{< /ui >}} > {{< ui >}}Setup Guidance{{< /ui >}}, cliquez sur {{< ui >}}View Traces{{< /ui >}} pour ouvrir Trace Explorer, avec le service sélectionné appliqué comme filtre. + +{{< img src="/getting_started/opentelemetry/otel_demo/traces_view.png" alt="Vue des traces avec tous les spans indexés pour le service checkout" style="width:90%;" >}} + +2. Sélectionnez un span indexé pour voir les détails complets de la trace pour cette transaction. + +{{< img src="/getting_started/opentelemetry/otel_demo/trace_waterfall.png" alt="Vue de trace avec tous les spans appartenant à cette transaction spécifique" style="width:90%;" >}} + +3. Naviguez à travers les onglets pour voir des détails supplémentaires : + - Métriques d'infrastructure pour les services rapportant des Host Metrics. + - Métriques d'exécution pour les services qui ont déjà été implémentés. + - Entrées de log corrélées avec cette trace. + - Liens de span liés à cette trace. + +### Requêtes de trace {#trace-queries} + +Datadog vous permet de filtrer et de regrouper les données OpenTelemetry reçues. Par exemple, pour trouver toutes les transactions d'un utilisateur spécifique, vous pouvez utiliser les requêtes de trace : + +La démo OTel envoie `user.id` sous forme de tags de span, vous pouvez donc l'utiliser pour filtrer toutes les transactions déclenchées par l'utilisateur : + +1. Depuis {{< ui >}}Info{{< /ui >}} dans le panneau latéral, survolez la ligne avec l'identifiant utilisateur, cliquez sur l'icône {{< ui >}}cog{{< /ui >}} et sélectionnez {{< ui >}}filter by @app.user.id:{{< /ui >}}. + +2. Supprimez tous les filtres précédents, en ne laissant que {{< ui >}}@app.user.id{{< /ui >}} appliqué pour afficher toutes les transactions contenant des spans avec l'identifiant utilisateur spécifié. + +{{< img src="/getting_started/opentelemetry/otel_demo/trace_query.png" alt="Requête de trace filtrant tous les spans qui contiennent un app.user.id spécifique" style="width:90%;" >}} + +### Error Tracking {#error-tracking} + +La démo OpenTelemetry inclut un feature flag engine pour simuler des scénarios d'erreur. + +1. Accédez à [http://localhost:8080/feature][12] pour gérer les scénarios disponibles. Consultez la [documentation de la démo OpenTelemetry][5] pour plus de détails. +2. Une fois que la démo commence à produire des erreurs, vous pouvez visualiser et localiser les services affectés dans Datadog. + +{{< img src="/getting_started/opentelemetry/otel_demo/error_tracking.png" alt="Vue Error Tracking montrant le feature flag PaymentService Fail activé" style="width:90%;" >}} + +### Configuration du collecteur OpenTelemetry {#opentelemetry-collector-configuration} + +L'extension Datadog vous permet de visualiser la configuration du collecteur OpenTelemetry dans Datadog sur l'une des pages suivantes : + +- [Liste des infrastructures][14]. +- [Resource Catalog][15]. + +Lors de la sélection du nom d'hôte où le collecteur est en cours d'exécution, vous pouvez visualiser sa configuration complète : + +{{< img src="/getting_started/opentelemetry/otel_demo/collector_full_config.png" alt="Configuration du collecteur OpenTelemetry rendue dans Datadog" style="width:90%;" >}} + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://github.com/open-telemetry/opentelemetry-demo +[2]: https://www.datadoghq.com/free-datadog-trial/ +[3]: https://app.datadoghq.com/organization-settings/api-keys/ +[5]: https://opentelemetry.io/docs/demo/feature-flags/ +[10]: https://opentelemetry.io/docs/demo/#language-feature-reference +[11]: https://app.datadoghq.com/services +[12]: http://localhost:8080/feature +[13]: /fr/opentelemetry/integrations/datadog_extension/ +[14]: https://app.datadoghq.com/infrastructure +[15]: https://app.datadoghq.com/infrastructure/catalog \ No newline at end of file diff --git a/hugo/content/fr/opentelemetry/integrations/datadog_extension.md b/hugo/content/fr/opentelemetry/integrations/datadog_extension.md new file mode 100644 index 00000000000..4f2c4f791ee --- /dev/null +++ b/hugo/content/fr/opentelemetry/integrations/datadog_extension.md @@ -0,0 +1,366 @@ +--- +further_reading: +- link: /opentelemetry/setup/collector_exporter/ + tag: Documentation + text: Configurer le Collector OpenTelemetry +- link: /infrastructure/list/ + tag: Documentation + text: Liste d'insfrastructures +- link: /infrastructure/resource_catalog/ + tag: Documentation + text: Resource Catalog +title: Datadog Extension +--- +## Présentation {#overview} + +À partir des [modules v0.129.0][4] d'OpenTelemetry Collector Contrib et des versions ultérieures, l'extension Datadog est incluse dans les [distributions contrib][5] d'OpenTelemetry Collector. Elle est également disponible pour les [builds personnalisés][6] d'OpenTelemetry Collector. Dans le [DDOT Collector][8], l'extension est automatiquement activée. + +L'extension Datadog vous permet de visualiser les informations de configuration et de build du collecteur OpenTelemetry directement dans Datadog à l'aide de [Fleet Automation][7], de la [liste d'infrastructures][2] et de [Resource Catalog][3]. L'extension fonctionne avec la configuration recommandée de l'exportateur OTLP HTTP et avec l'exportateur Datadog. + +{{< img src="/agent/fleet_automation/fleet-automation-pipeline-view.png" alt="Visualisez les configurations du collecteur OTel avec la visualisation de pipeline dans Fleet Automation" style="width:100%;" >}} + +## Fonctionnalités clés {#key-features} + +- **Collector Configuration Visibility** : Visualisez la configuration complète de n'importe quel OTel Collector dans votre infrastructure. +- **Informations de build** : consultez la version du collecteur, les détails du build et les informations sur les composants. +- **Endpoint d'inspection locale** : utilisez un endpoint HTTP pour le débogage local et la vérification de la configuration. +- **Gestion de parc** : surveillez et gérez votre parc de collecteurs OpenTelemetry depuis l'interface utilisateur Datadog. + +## Configuration {#setup} + +
Si vous utilisez le collecteur DDOT, ne configurez pas manuellement l'extension Datadog. Elle est automatiquement activée dans toutes les versions du collecteur DDOT.
+ +### 1. Ajoutez l'extension Datadog à la configuration de votre collecteur {#1-add-the-datadog-extension-to-your-collector-configuration} + +Configurez l'extension Datadog dans votre fichier de configuration du collecteur OpenTelemetry : + +```yaml +extensions: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + # hostname: "my-collector-host" # Optional: must match the hostname in exported telemetry + +service: + extensions: [datadog] +``` + +### 2. Configurez un pipeline de télémétrie actif {#2-configure-an-active-telemetry-pipeline} + +Configurez au moins un pipeline de télémétrie actif et exportez ses données vers Datadog. Pour la configuration recommandée, utilisez la [configuration de l'exportateur OTLP HTTP][9]. + +L'extension utilise les métadonnées du collecteur et de l'hôte pour associer la configuration rapportée à l'hôte correspondant dans Datadog. + +### 3. (Facultatif) Ajoutez des attributs de ressource personnalisés {#3-optional-add-custom-resource-attributes} + +L'extension Datadog collecte automatiquement les attributs de ressource à partir de la télémétrie interne du Collector et les inclut dans la charge utile de métadonnées qu'elle envoie à Datadog. Pour joindre des attributs personnalisés tels que l'environnement de déploiement, l'équipe ou le nom du cluster Kubernetes, définissez-les sous `service.telemetry.resource` : + +```yaml +service: + telemetry: + resource: + deployment.environment.name: production + team.name: platform + k8s.cluster.name: prod-us-east1-cluster-a +``` + +Le Collector joint automatiquement `service.name`, `service.version` et `service.instance.id` (un UUID généré aléatoirement) à sa télémétrie interne. Vous n'avez pas besoin de les définir manuellement. + +### 4. (Facultatif) Configurez la topologie de la passerelle (aperçu) {#4-optional-configure-gateway-topology-preview} + +Lorsque vous disposez d'une configuration de passerelle OpenTelemetry Collector qui transfère la télémétrie via un ou plusieurs Collectors de passerelle avant d'atteindre Datadog, l'extension Datadog peut publier la topologie afin qu'elle apparaisse sous forme de graphe de pipeline connecté dans [Fleet Automation][7] : + +{{< img src="opentelemetry/integrations/datadog_extension_gateway_topology.png" alt="Vue de la topologie de la passerelle dans Fleet Automation montrant des Collectors DaemonSet transférant les données via deux couches de Collectors de passerelle vers Datadog" style="width:100%;" >}} + +Pour activer cette vue, configurez chaque Collector dans le pipeline : + +- Définissez `deployment_type` sur `daemonset` pour les Collectors agent ou DaemonSet et `gateway` pour les Collectors de passerelle. +- Définissez `gateway_destination` sur les Collectors qui transfèrent les données vers une passerelle en aval. La valeur est le service Kubernetes de la passerelle réceptrice, sous la forme `/`. +- Définissez `gateway_service` sur les Collector de passerelle. La valeur est le service Kubernetes qui se trouve devant les pods de la passerelle. +- Une passerelle **intermédiaire** dans un pipeline multicouche définit **à la fois** `gateway_service` (son propre service) et `gateway_destination` (la passerelle suivante). +- Définissez `k8s.cluster.name` sous `service.telemetry.resource` sur chaque Collector du pipeline. Ceci est **requis** : avec `gateway_service` et `gateway_destination`, cela forme la clé de jointure que Fleet Automation utilise pour reconstruire le graphe du pipeline. +- Activez les métriques internes du Collector afin que l'extension puisse attribuer les données de volume des logs, métriques ou traces à chaque arête du graphe avec le bouton **Afficher le trafic**. Consultez [OpenTelemetry Collector Health Metrics][10]. + +L'exemple ci-dessous couvre le cas courant à deux couches : un DaemonSet local au nœud transfère les données vers un déploiement de passerelle, qui les envoie à Datadog avec l'exportateur Datadog. + +Chaque Collector expose ses propres métriques de santé sur un endpoint de pull Prometheus via `service.telemetry.metrics`, récupère cet endpoint avec un récepteur `prometheus/internal`, et achemine le résultat via le même pipeline de métriques que la télémétrie d'application. C'est ce qui alimente chaque nœud et chaque arête dans la vue topologique. + +#### Collecteur DaemonSet {#daemonset-collector} + +```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 + prometheus/internal: + config: + scrape_configs: + - job_name: otelcol-internal + scrape_interval: 10s + static_configs: + - targets: ['localhost:8888'] + +exporters: + otlp: + endpoint: otelcol-gateway.monitoring.svc.cluster.local:4317 + tls: + insecure: true + +extensions: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + deployment_type: daemonset + gateway_destination: monitoring/otelcol-gateway + +service: + telemetry: + metrics: + level: normal + readers: + - pull: + exporter: + prometheus: + host: 0.0.0.0 + port: 8888 + without_type_suffix: true + without_units: true + resource: + k8s.cluster.name: my-cluster + k8s.node.name: ${env:K8S_NODE_NAME} + k8s.pod.name: ${env:K8S_POD_NAME} + extensions: [datadog] + pipelines: + metrics: + receivers: [otlp, prometheus/internal] + exporters: [otlp] + traces: + receivers: [otlp] + exporters: [otlp] + logs: + receivers: [otlp] + exporters: [otlp] +``` + +Le pipeline `metrics` du DaemonSet inclut `prometheus/internal` afin que les métriques de santé du collecteur lui-même transitent via OTLP vers la passerelle aux côtés de la télémétrie applicative, atteignant Datadog par le biais de l'exportateur Datadog de la passerelle. + +#### Collecteur de passerelle {#gateway-collector} + +```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 + prometheus/internal: + config: + scrape_configs: + - job_name: otelcol-internal + scrape_interval: 10s + static_configs: + - targets: ['localhost:8888'] + +exporters: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + metrics: + resource_attributes_as_tags: true + sending_queue: + batch: + flush_timeout: 10s + +extensions: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + deployment_type: gateway + gateway_service: monitoring/otelcol-gateway + +service: + telemetry: + metrics: + level: normal + readers: + - pull: + exporter: + prometheus: + host: 0.0.0.0 + port: 8888 + without_type_suffix: true + without_units: true + resource: + k8s.cluster.name: my-cluster + k8s.node.name: ${env:K8S_NODE_NAME} + k8s.pod.name: ${env:K8S_POD_NAME} + extensions: [datadog] + pipelines: + metrics: + receivers: [otlp, prometheus/internal] + exporters: [datadog] + traces: + receivers: [otlp] + exporters: [datadog] + logs: + receivers: [otlp] + exporters: [datadog] +``` + +Le pipeline `metrics` de la passerelle accepte à la fois la télémétrie transférée (depuis le DaemonSet via OTLP) et ses propres métriques internes provenant de `prometheus/internal`, puis exporte le tout vers Datadog. + +#### Pipelines de passerelle multicouches {#multi-layer-gateway-pipelines} + +Pour les pipelines comportant plus d'une couche de passerelle, définissez `gateway_service` et `gateway_destination` ensemble sur la couche intermédiaire. Par exemple, dans une topologie à trois couches avec une passerelle de couche 2 entre le DaemonSet et une passerelle de couche 1, l'extension de la passerelle de couche 2 est configurée comme suit : + +```yaml +extensions: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + deployment_type: gateway + gateway_service: monitoring/otelcol-gateway-l2 + gateway_destination: monitoring/otelcol-gateway-l1 +``` + +Le DaemonSet transfère vers `monitoring/otelcol-gateway-l2`, la passerelle de couche 2 transfère vers `monitoring/otelcol-gateway-l1`, et la passerelle de couche 1 envoie vers Datadog. Chaque Collector rapporte le même `k8s.cluster.name`. + +## Options de configuration {#configuration-options} + +| Paramètre | Description | Par défaut | +|-----------|-------------|---------| +| `api.key` | Clé Datadog API (requise). | - | +| `api.site` | Site Datadog (par exemple, `us5.datadoghq.com`). | `datadoghq.com` | +| `api.fail_on_invalid_key` | Quittez au démarrage si la clé d'API est invalide. | `true` | +| `hostname` | Nom d'hôte personnalisé pour le Collector. | Détecté automatiquement | +| `http.endpoint` | Endpoint du serveur HTTP local. | `localhost:9875` | +| `http.path` | Chemin du serveur HTTP pour les métadonnées. | `/metadata` | +| `deployment_type` | Identifie la manière dont le collecteur est déployé. Cette valeur apparaît dans [Fleet Automation][7] et est requise pour [la topologie de passerelle](#4-optional-configure-gateway-topology-preview). L'un des éléments suivants : `gateway`, `daemonset` ou `unknown`. La valeur par défaut `unknown` signifie que le type de déploiement n'a pas été défini. | `unknown` | +| `installation_method` | Comment le Collector a été installé. L'un des éléments suivants : `kubernetes`, `bare-metal`, `docker`, `ecs-fargate`, `eks-fargate` ou non défini. Disponible dans Collector v0.148.0 et versions ultérieures. | non défini | +| `gateway_service` | À définir uniquement sur les Collectors **passerelle**. Le service Kubernetes qui sert de façade aux pods du Collector de passerelle. Format : `service` ou `namespace/service`. Disponible dans Collector v0.150.0 et versions ultérieures. | - | +| `gateway_destination` | À définir sur tout Collector qui transfère la télémétrie vers une passerelle en aval. Le service Kubernetes vers lequel ce Collector transfère la télémétrie. Doit correspondre à `gateway_service` sur le Collector de passerelle récepteur. Format : `service` ou `namespace/service`. Disponible dans Collector v0.150.0 et versions ultérieures. | - | +| `proxy_url` | URL du proxy HTTP pour les requêtes sortantes. | - | +| `timeout` | Délai d'expiration pour les requêtes HTTP. | `30s` | +| `tls.insecure_skip_verify` | Ignorer la vérification du certificat TLS. | `false` | + +
+Correspondance du nom d'hôte : Si vous spécifiez un nom personnalisé hostname dans l'extension Datadog, il doit correspondre au nom d'hôte dans la télémétrie exportée. L'extension ne déduit pas de nom d'hôte à partir de la télémétrie de l'application dans vos pipelines ; elle obtient son nom d'hôte à partir des API du système ou du fournisseur cloud, ou d'une configuration manuelle. Si vous utilisez l'exportateur Datadog, sa hostname valeur doit également correspondre. Sinon, Datadog pourrait ne pas corréler la télémétrie au bon hôte, et des hôtes en double peuvent apparaître. +
+ +### Exemple de configuration complète avec l'exportateur Datadog {#complete-configuration-example-with-the-datadog-exporter} + +L'exemple suivant utilise l'exportateur Datadog. L'extension elle-même ne le nécessite pas ; pour le pipeline recommandé, utilisez la configuration de l'exportateur HTTP OTLP depuis [Set Up the OpenTelemetry Collector][9]. + +```yaml +extensions: + datadog: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + hostname: "my-collector-host" + http: + endpoint: "localhost:9875" + path: "/metadata" + proxy_url: "http://proxy.example.com:8080" + timeout: 30s + tls: + insecure_skip_verify: false + +exporters: + datadog/exporter: + api: + key: ${env:DD_API_KEY} + site: {{< region-param key="dd_site" >}} + hostname: "my-collector-host" + sending_queue: + batch: + flush_timeout: 10s + +service: + extensions: [datadog] + pipelines: + traces: + receivers: [otlp] + exporters: [datadog/exporter] + metrics: + receivers: [otlp] + exporters: [datadog/exporter] +``` + +## Affichage de la configuration du Collector {#viewing-collector-configuration} + +Une fois configuré, vous pouvez afficher la configuration de l'OpenTelemetry Collector ainsi que les informations de build à divers endroits : + +### Fleet Automation {#fleet-automation} +1. Accédez à [{{< ui >}}Integrations{{< /ui >}} > {{< ui >}}Fleet Automation{{< /ui >}}][7]. +2. Filtrez les hôtes du Collector OTel en utilisant les facettes du Collector, puis cliquez sur un hôte. +3. Dans le panneau latéral, sélectionnez l'onglet {{< ui >}}Info{{< /ui >}} pour afficher les informations de build. +4. Sélectionnez l'onglet {{< ui >}}Configurations{{< /ui >}} pour afficher le fichier YAML complet ou une visualisation du pipeline de vos configurations du Collector OTel. + +{{< img src="/agent/fleet_automation/fleet-automation-yaml-view.png" alt="Afficher les YAML de configuration du Collector OTel dans Fleet Automation" style="width:100%;" >}} + +### Liste d'infrastructure (Liste des hôtes) {#infrastructure-list-host-list} + +1. Accédez à [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Hosts{{< /ui >}}][2] dans votre compte Datadog. +2. Cliquez sur n'importe quel hôte exécutant l'OpenTelemetry Collector (**Remarque** : filtrez par `field:apps:otel` pour n'afficher que les instances du Collector). +3. Dans le panneau des détails de l'hôte, sélectionnez l'onglet {{< ui >}}OTel Collector{{< /ui >}} pour voir les informations de build et la configuration complète du Collector. + +### Resource Catalog {#resource-catalog} + +1. Accédez à [{{< ui >}}Infrastructure{{< /ui >}} > {{< ui >}}Resource Catalog{{< /ui >}}][3] dans votre compte Datadog +2. Filtrez par hôtes ou recherchez vos instances de Collector. +3. Cliquez sur n'importe quel hôte exécutant l'OpenTelemetry Collector. +4. Faites défiler jusqu'à {{< ui >}}Collector{{< /ui >}} pour voir les informations de build et la configuration complète du Collector. + +## Serveur HTTP local {#local-http-server} + +L'extension Datadog inclut un serveur HTTP local pour le débogage et l'inspection : + +```bash +# Access collector metadata locally +curl http://localhost:9875/metadata +``` + +Cet endpoint fournit : +- Configuration du Collector (nettoyée des informations sensibles) +- Informations sur la build et détails de la version +- Liste des composants actifs +- État de l'extension + +## Dépannage {#troubleshooting} + +### La configuration n'apparaît pas dans Datadog {#configuration-not-appearing-in-datadog} + +1. **Vérifiez la correspondance du nom d'hôte** : confirmez que le nom d'hôte de l'extension Datadog correspond au nom d'hôte dans la télémétrie exportée. Si vous utilisez l'exportateur Datadog, confirmez que son nom d'hôte correspond également. +2. **Vérifiez la clé d'API** : confirmez que la clé d'API est valide et dispose des autorisations appropriées. +3. **Vérifiez les logs du Collector** : recherchez les logs d'initialisation de l'extension et de soumission des données. +4. **Confirmez que l'extension est activée** : vérifiez que l'extension est répertoriée dans la configuration du service. + +### Problèmes de serveur HTTP {#http-server-issues} + +1. **Conflits de port** : Assurez-vous que le port 9875 est disponible ou configurez un port différent. +2. **Accès réseau** : Vérifiez que le serveur HTTP est accessible depuis votre emplacement de débogage. +3. **Vérifiez les logs** : Examinez les logs de l'extension pour détecter les problèmes de démarrage du serveur HTTP. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[2]: https://app.datadoghq.com/infrastructure +[3]: https://app.datadoghq.com/infrastructure/catalog +[4]: https://github.com/open-telemetry/opentelemetry-collector-contrib/releases/tag/v0.129.0 +[5]: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.129.1 +[6]: https://opentelemetry.io/docs/collector/custom-collector/ +[7]: https://app.datadoghq.com/fleet +[8]: /fr/opentelemetry/setup/ddot_collector/ +[9]: /fr/opentelemetry/setup/collector_exporter/ +[10]: /fr/opentelemetry/integrations/collector_health_metrics/ \ No newline at end of file diff --git a/hugo/content/fr/opentelemetry/integrations/kafka_metrics.md b/hugo/content/fr/opentelemetry/integrations/kafka_metrics.md new file mode 100644 index 00000000000..f14a1b6d042 --- /dev/null +++ b/hugo/content/fr/opentelemetry/integrations/kafka_metrics.md @@ -0,0 +1,318 @@ +--- +further_reading: +- link: /opentelemetry/collector_exporter/ + tag: Documentation + text: Configurer le Collector OpenTelemetry +title: Métriques Kafka +--- +## Présentation {#overview} + +{{< img src="/opentelemetry/collector_exporter/kafka_metrics.png" alt="Métriques Kafka OpenTelemetry dans le dashboard Kafka prêt à l'emploi" style="width:100%;" >}} + +Le [récepteur de métriques Kafka][1], le [récepteur JMX][2]/ [collecteur de métriques JMX][3] permettent de collecter les métriques Kafka et d'accéder au [dashboard Kafka][7] prêt à l'emploi, « Vue d'ensemble de Kafka, Zookeeper et du consommateur Kafka ». + +**Remarque** : le [récepteur JMX][2] et le [collecteur de métriques JMX][3] doivent être considérés comme des remplacements. Ils collectent le même ensemble de métriques (le [récepteur JMX][2] lance le [collecteur de métriques JMX][3]). + + +## Récepteur de métriques Kafka {#kafka-metrics-receiver} + +{{< tabs >}} +{{% tab "Host" %}} + +```yaml +receivers: + kafkametrics: + brokers: "${env:KAFKA_BROKER_ADDRESS}" + protocol_version: 2.0.0 + scrapers: + - brokers + - topics + - consumers +``` + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +Utilisez le récepteur de métriques Kafka dans un collecteur fonctionnant en mode `deployment` avec une seule réplique. Cela empêche la même métrique d'être collectée plusieurs fois. Le collecteur peut exporter les métriques directement vers Datadog via OTLP HTTP ou les transférer vers une autre instance de collecteur. + +Ajoutez les lignes suivantes à `values.yaml` : + +```yaml +mode: deployment +``` + +Ajoutez ce qui suit dans la configuration du collecteur : + +```yaml +receivers: + kafkametrics: + brokers: ${env:KAFKA_BROKER_ADDRESS} + protocol_version: 2.0.0 + scrapers: + - brokers + - topics + - consumers +``` + +{{% /tab %}} + +{{< /tabs >}} + +## Récepteur JMX {#jmx-receiver} + +{{< tabs >}} +{{% tab "Host" %}} + +Le récepteur JMX a les exigences suivantes : +- Le JRE est disponible sur l'hôte où vous exécutez le collecteur. +- Le fichier JAR du collecteur de métriques JMX est disponible sur l'hôte où vous exécutez le collecteur. Vous pouvez télécharger la version la plus récente du fichier JAR du collecteur de métriques JMX depuis la [page des versions opentelemetry-java-contrib][1]. + +Ajoutez ce qui suit dans la configuration du collecteur : + +```yaml +receivers: + jmx: + jar_path: /path/to/opentelemetry-jmx-metrics.jar + endpoint: ${env:KAFKA_BROKER_JMX_ADDRESS} + target_system: kafka,jvm + jmx/consumer: + jar_path: /path/to/opentelemetry-jmx-metrics.jar + endpoint: ${env:KAFKA_CONSUMER_JMX_ADDRESS} + target_system: kafka-consumer + jmx/producer: + jar_path: /path/to/opentelemetry-jmx-metrics.jar + endpoint: ${env:KAFKA_PRODUCER_JMX_ADDRESS} + target_system: kafka-producer +``` + +[1]: https://github.com/open-telemetry/opentelemetry-java-contrib/releases + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +Utilisez le récepteur JMX dans un collecteur fonctionnant en mode `deployment` avec une seule réplique. Cela empêche la même métrique d'être collectée plusieurs fois. Le collecteur peut exporter les métriques directement vers Datadog via OTLP HTTP ou les transférer vers une autre instance de collecteur. + +Le récepteur JMX a les exigences suivantes : +- Le JRE est disponible sur l'hôte sur lequel vous exécutez le collecteur. +- Le fichier JAR du collecteur de métriques JMX est disponible sur l'hôte sur lequel vous exécutez le collecteur. Vous pouvez télécharger la version la plus récente du fichier JAR du collecteur de métriques JMX [ici][1]. + +Comme l'image par défaut du collecteur OTel ne répond pas aux exigences ci-dessus, une image personnalisée doit être créée. Consultez le Dockerfile ci-dessous pour obtenir un exemple d'image contenant le binaire du collecteur, le JRE et le fichier JAR du collecteur de métriques JMX. + +Dockerfile : + +```Dockerfile +FROM alpine:latest as prep + +# OpenTelemetry Collector Binary +ARG OTEL_VERSION=0.92.0 +ARG TARGETARCH=linux_amd64 +ADD "https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v${OTEL_VERSION}/otelcol-contrib_${OTEL_VERSION}_${TARGETARCH}.tar.gz" /otelcontribcol +RUN tar -zxvf /otelcontribcol + +# JMX Metrics Gatherer Jar +ARG JMX_GATHERER_JAR_VERSION=1.27.0 +ADD https://github.com/open-telemetry/opentelemetry-java-contrib/releases/download/v${JMX_GATHERER_JAR_VERSION}/opentelemetry-jmx-metrics.jar /opt/opentelemetry-jmx-metrics.jar +# nonroot user id (https://groups.google.com/g/distroless-users/c/-DpzCr7xRDY/m/eQqJmJroCgAJ) +ARG USER_UID=65532 +RUN chown ${USER_UID} /opt/opentelemetry-jmx-metrics.jar + + +FROM gcr.io/distroless/java17-debian11:nonroot + +COPY --from=prep /opt/opentelemetry-jmx-metrics.jar /opt/opentelemetry-jmx-metrics.jar +COPY --from=prep /otelcol-contrib /otelcol-contrib + +EXPOSE 4317 55680 55679 +ENTRYPOINT ["/otelcol-contrib"] +CMD ["--config", "/etc/otelcol-contrib/config.yaml"] +``` + +Ajoutez les lignes suivantes à `values.yaml` : + +```yaml +mode: deployment +``` + +Ajoutez ce qui suit dans la configuration du collecteur : + +```yaml +receivers: + jmx: + jar_path: /path/to/opentelemetry-jmx-metrics.jar + endpoint: ${env:KAFKA_BROKER_JMX_ADDRESS} + target_system: kafka,jvm + jmx/consumer: + jar_path: /path/to/opentelemetry-jmx-metrics.jar + endpoint: ${env:KAFKA_CONSUMER_JMX_ADDRESS} + target_system: kafka-consumer + jmx/producer: + jar_path: /path/to/opentelemetry-jmx-metrics.jar + endpoint: ${env:KAFKA_PRODUCER_JMX_ADDRESS} + target_system: kafka-producer +``` + +[1]: https://github.com/open-telemetry/opentelemetry-java-contrib/releases + + +{{% /tab %}} + +{{< /tabs >}} + + +## Collecteur de métriques JMX {#jmx-metrics-gatherer} + +{{< tabs >}} +{{% tab "Host" %}} + +Le collecteur de métriques JMX est conçu pour être exécuté en tant qu'uber jar et configuré avec des propriétés à partir de la ligne de commande. + +Veuillez vous assurer que le JRE est disponible sur l'hôte sur lequel vous exécutez le collecteur. Si ce n'est pas le cas, veuillez vous assurer de le télécharger, par exemple. + +``` +apt-get update && \ +apt-get -y install default-jre-headless +``` + +Une fois cela fait, téléchargez la version la plus récente du JAR du collecteur de métriques JMX [ici][1] et exécutez : + +``` +// Kafka Broker +java -jar -Dotel.jmx.service.url=service:jmx:rmi:///jndi/rmi://{KAFKA_BROKER_JMX_ADDRESS}/jmxrmi \ -Dotel.jmx.target.system=kafka,jvm \ +-Dotel.metrics.exporter=otlp \ +-Dotel.exporter.otlp.endpoint=http://localhost:4317 \ +-jar /path/to/opentelemetry-jmx-metrics.jar + +// Kafka Producer +java -jar -Dotel.jmx.service.url=service:jmx:rmi:///jndi/rmi://{KAFKA_PRODUCER_JMX_ADDRESS}/jmxrmi \ -Dotel.jmx.target.system=kafka-producer \ +-Dotel.metrics.exporter=otlp \ +-Dotel.exporter.otlp.endpoint=http://localhost:4317 \ +-jar /path/to/opentelemetry-jmx-metrics.jar + +// Kafka Consumer +java -jar -Dotel.jmx.service.url=service:jmx:rmi:///jndi/rmi://{KAFKA_CONSUMER_JMX_ADDRESS}/jmxrmi \ -Dotel.jmx.target.system=kafka-consumer \ +-Dotel.metrics.exporter=otlp \ +-Dotel.exporter.otlp.endpoint=http://localhost:4317 \ +-jar /path/to/opentelemetry-jmx-metrics.jar +``` + +[1]: https://github.com/open-telemetry/opentelemetry-java-contrib/releases + +{{% /tab %}} + +{{% tab "Kubernetes" %}} + +Le collecteur de métriques JMX est conçu pour être exécuté en tant qu'uber jar et configuré avec des propriétés à partir de la ligne de commande. + +Afin de déployer ceci dans Kubernetes, vous devez créer une image contenant le JRE et le fichier JAR du collecteur de métriques JMX. Veuillez consulter le Dockerfile ci-dessous pour obtenir un exemple d'image contenant le JRE et le fichier JAR du collecteur de métriques JMX. + +Dockerfile : + +```Dockerfile +FROM alpine:latest as prep + +# JMX Metrics Gatherer Jar +ARG JMX_GATHERER_JAR_VERSION=1.27.0 +ADD https://github.com/open-telemetry/opentelemetry-java-contrib/releases/download/v${JMX_GATHERER_JAR_VERSION}/opentelemetry-jmx-metrics.jar /opt/opentelemetry-jmx-metrics.jar +# nonroot user id (https://groups.google.com/g/distroless-users/c/-DpzCr7xRDY/m/eQqJmJroCgAJ) +ARG USER_UID=65532 +RUN chown ${USER_UID} /opt/opentelemetry-jmx-metrics.jar + +FROM gcr.io/distroless/java17-debian11:nonroot + +COPY --from=prep /opt/opentelemetry-jmx-metrics.jar /opt/opentelemetry-jmx-metrics.jar + +EXPOSE 4317 55680 55679 +ENTRYPOINT ["java"] +CMD ["-Dotel.jmx.service.url=service:jmx:rmi:///jndi/rmi://kafka:1099/jmxrmi", \ +"-Dotel.jmx.target.system=kafka,jvm", \ +"-Dotel.metrics.exporter=otlp", \ +"-Dotel.exporter.otlp.endpoint=http://otelcol:4317", \ +"-jar", \ +"/opt/opentelemetry-jmx-metrics.jar"] +``` +{{% /tab %}} + +{{< /tabs >}} + +## Collecte de logs {#log-collection} + +Consultez [Log Collection][4] pour obtenir des instructions sur la collecte de logs à l'aide du collecteur OpenTelemetry. + +Pour apparaître dans le dashboard Kafka prêt à l'emploi, les logs Kafka doivent être marqués avec `source:kafka`. Pour ce faire, utilisez un processeur d'attributs : + +```yaml +processors: + attributes: + actions: + - key: ddtags + value: "source:kafka" + action: insert +``` + +Afin de vous assurer que cet attribut n'est ajouté qu'à vos logs Kafka, utilisez le [filtrage include/exclude][8] du processeur d'attributs. + +## Données collectées {#data-collected} + +### Récepteur de métriques Kafka {#kafka-metrics-receiver-1} + +{{< mapping-table resource="kafkametrics.csv">}} + +### Récepteur JMX / Collecteur de métriques JMX {#jmx-receiver-jmx-metrics-gatherer} + +#### Courtier Kafka {#kafka-broker} + +{{< mapping-table resource="kafka.csv">}} + +#### Producteur Kafka {#kafka-producer} + +{{< mapping-table resource="kafka-producer.csv">}} + +#### Consommateur Kafka {#kafka-consumer} + +{{< mapping-table resource="kafka-consumer.csv">}} + +**Remarque :** Dans Datadog, `-` est traduit par `_`. Par exemple, `kafka.producer.request-rate` devient `kafka.producer.request_rate`. + +Pour le mappage complet entre les noms de métriques OpenTelemetry et Datadog, consultez [OpenTelemetry Metrics Mapping][9]. + +## Exemple de sortie de journalisation {#example-logging-output} + +``` +Resource SchemaURL: https://opentelemetry.io/schemas/1.20.0 +Resource attributes: + -> service.name: Str(unknown_service:java) + -> telemetry.sdk.language: Str(java) + -> telemetry.sdk.name: Str(opentelemetry) + -> telemetry.sdk.version: Str(1.27.0) +ScopeMetrics #0 +ScopeMetrics SchemaURL: +InstrumentationScope io.opentelemetry.contrib.jmxmetrics 1.27.0-alpha +Metric #0 +Descriptor: + -> Name: kafka.message.count + -> Description: The number of messages received by the broker + -> Unit: {messages} + -> DataType: Sum + -> IsMonotonic: true + -> AggregationTemporality: Cumulative +NumberDataPoints #0 +StartTimestamp: 2024-01-22 15:50:24.212 +0000 UTC +Timestamp: 2024-01-22 15:51:24.218 +0000 UTC +Value: 25 +``` + +## Exemple d'application {#example-app} + +Veuillez consulter l'[exemple d'application][6] suivant qui démontre les configurations abordées dans cette documentation. Cet exemple d'application est composé d'un producteur, d'un consommateur, d'un courtier et d'une instance Zookeeper. Il démontre l'utilisation du récepteur de métriques Kafka, du récepteur JMX et/ou du collecteur de métriques JMX. + + +[1]: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/kafkametricsreceiver +[2]: https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/jmxreceiver +[3]: https://github.com/open-telemetry/opentelemetry-java-contrib/blob/main/jmx-metrics +[4]: /fr/opentelemetry/collector_exporter/log_collection +[6]: https://github.com/DataDog/opentelemetry-examples/tree/main/apps/kafka-metrics +[7]: https://app.datadoghq.com/dash/integration/50/kafka-zookeeper-and-kafka-consumer-overview +[8]: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/processor/attributesprocessor/README.md#includeexclude-filtering +[9]: /fr/opentelemetry/guide/metrics_mapping/#kafka-metrics \ No newline at end of file diff --git a/hugo/content/fr/opentelemetry/integrations/trace_metrics.md b/hugo/content/fr/opentelemetry/integrations/trace_metrics.md new file mode 100644 index 00000000000..82da79e2b61 --- /dev/null +++ b/hugo/content/fr/opentelemetry/integrations/trace_metrics.md @@ -0,0 +1,39 @@ +--- +aliases: +- /fr/opentelemetry/collector_exporter/trace_metrics/ +further_reading: +- link: /opentelemetry/collector_exporter/ + tag: Documentation + text: Démarrage du Collector +- link: /opentelemetry/guide/service_entry_spans_mapping/ + tag: Documentation + text: Mappage des conventions sémantiques OpenTelemetry vers les spans d'entrée + de service +title: Métriques de trace +--- +## Présentation {#overview} + +{{< img src="/opentelemetry/collector_exporter/trace_metrics.png" alt="Métriques APM d'OpenTelemetry" style="width:100%;" >}} + +Pour envoyer des statistiques APM telles que les hits, les erreurs et la durée, configurez le [`span_metrics` connecteur][1]. Configurez le connecteur pour recevoir toutes les traces avant tous les processeurs d'échantillonnage, afin que les métriques de trace représentent le trafic non échantillonné. + +## Configuration {#setup} + +Sélectionnez votre environnement dans la [configuration recommandée du Collector][1] et utilisez son bloc de connecteur `span_metrics` complet. Conservez toutes ses dimensions, que Datadog utilise pour dériver les tags d'hôte, les services pairs, les noms d'opération et les noms de ressource. + +## Données collectées {#data-collected} + +Voir [Métriques de trace][2]. + +## Exemple de configuration complète {#full-example-configuration} + +Pour des exemples de fichiers complets et fonctionnels, consultez le dépôt [`opentelemetry-examples`][5]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + + +[1]: /fr/opentelemetry/setup/collector_exporter/#span-metrics-connector +[2]: /fr/tracing/metrics/metrics_namespace/ +[5]: https://github.com/DataDog/opentelemetry-examples/tree/be842bc1447337c32f2d6265612232932a6cdbfd/configurations/opentelemetry-collector \ No newline at end of file diff --git a/hugo/content/fr/opentelemetry/setup/otlp_ingest/traces.md b/hugo/content/fr/opentelemetry/setup/otlp_ingest/traces.md new file mode 100644 index 00000000000..fe3b97a530a --- /dev/null +++ b/hugo/content/fr/opentelemetry/setup/otlp_ingest/traces.md @@ -0,0 +1,238 @@ +--- +aliases: +- /fr/opentelemetry/otlp_endpoint +- /fr/opentelemetry/setup/intake_endpoint/otlp_traces +- /fr/opentelemetry/setup/agentless/traces +further_reading: +- link: https://opentelemetry.io/docs/concepts/sdk-configuration/general-sdk-configuration/ + tag: Site externe + text: Configuration générale du SDK OpenTelemetry +- link: https://opentelemetry.io/docs/reference/specification/sdk-environment-variables/ + tag: Site externe + text: Spécification des variables d'environnement OpenTelemetry +- link: 'https://opentelemetry.io/docs/reference/specification/protocol/exporter/ ' + tag: Site externe + text: Exportateur du protocole OpenTelemetry +title: Endpoint d'ingestion de traces OTLP Datadog +--- +## Présentation {#overview} + +L'endpoint de l'API d'ingestion de traces du protocole OpenTelemetry (OTLP) de Datadog permet aux applications, aux plateformes gérées et aux collecteurs OpenTelemetry d'envoyer des traces à Datadog via OTLP HTTP. + +Utilisez la configuration directe sur cette page lorsque vous devez envoyer des traces sans le [Datadog Agent][2] ou un collecteur OpenTelemetry. Pour les déploiements de collecteurs en production, utilisez [Configurer le collecteur OpenTelemetry][1]. + +Pour les charges de travail serverless, consultez [Ingestion OTLP pour le serverless][8]. Pour les plateformes gérées telles que Cloudflare, Vercel et Heroku, consultez [Ingestion OTLP pour les plateformes gérées][9]. + +
L'endpoint d'ingestion de traces OTLP prend en charge http/protobuf et http/json encodage. grpc n'est pas pris en charge.
+ +## Configuration {#configuration} + +Pour exporter des données OTLP vers l'endpoint d'ingestion de traces OTLP de Datadog : + +1. [Configurez l'exportateur OTLP HTTP Protobuf](#configure-the-exporter). + - Définissez l'endpoint d'ingestion de traces OTLP de Datadog. + - Configurez les en-têtes HTTP requis. +1. (Facultatif) [Définissez l'en-tête HTTP `dd-otel-span-mapping`](#optional-map-or-filter-span-names) pour mapper ou filtrer les spans. + +### Configurez l'exportateur {#configure-the-exporter} + +Pour envoyer des données OTLP vers l'endpoint d'ingestion de traces OTLP de Datadog, vous devez utiliser l'exportateur OTLP HTTP Protobuf. Le processus diffère selon que vous utilisez une instrumentation automatique ou manuelle pour OpenTelemetry. + +Les [métriques de trace][7] ne sont pas calculées par défaut pour les traces envoyées directement à l'endpoint d'ingestion de traces OTLP de Datadog. Les exemples suivants incluent `compute_stats=true` pour activer les métriques de trace. + +#### Instrumentation automatique {#automatic-instrumentation} + +Si vous utilisez l'[instrumentation automatique OpenTelemetry][3], définissez les variables d'environnement suivantes : + +```shell +export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL="http/protobuf" +export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="{{< region-param key="otlp_trace_endpoint" >}}" +export OTEL_EXPORTER_OTLP_TRACES_HEADERS="dd-api-key=${DD_API_KEY},compute_stats=true" +``` + +#### Instrumentation manuelle {#manual-instrumentation} + +Si vous utilisez une instrumentation manuelle avec les SDK OpenTelemetry, configurez l'exportateur OTLP HTTP Protobuf par programmation. + +
Selon votre site Datadog, qui est {{< region-param key=dd_datacenter code="true" >}}, remplacez ${YOUR_ENDPOINT} par {{< region-param key="otlp_trace_endpoint" code="true" >}}.
+ +{{< tabs >}} +{{% tab "JavaScript" %}} + +L'exportateur JavaScript est [`exporter-trace-otlp-proto`][100]. Pour configurer l'exportateur, utilisez l'extrait de code suivant : + +```javascript +const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-proto'); // OTLP http/protobuf exporter + +const exporter = new OTLPTraceExporter({ + url: '${YOUR_ENDPOINT}', // Replace this with the correct endpoint + headers: { + 'dd-api-key': process.env.DD_API_KEY, + 'dd-otel-span-mapping': '{span_name_as_resource_name: true}', + 'compute_stats': 'true', + }, +}); +``` +[100]: https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-proto + +{{% /tab %}} + +{{% tab "Java" %}} + +L'exportateur Java est [`OtlpHttpSpanExporter`][200]. Pour configurer l'exportateur, utilisez l'extrait de code suivant : + +```java +import io.opentelemetry.exporter.otlp.http.trace.OtlpHttpSpanExporter; + +OtlpHttpSpanExporter exporter = OtlpHttpSpanExporter.builder() + .setEndpoint("${YOUR_ENDPOINT}") // Replace this with the correct endpoint + .addHeader("dd-api-key", System.getenv("DD_API_KEY")) + .addHeader("dd-otel-span-mapping", "{span_name_as_resource_name: true}") + .addHeader("compute_stats", "true") + .build(); +``` + +[200]: https://javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-otlp-http-trace/ + +{{% /tab %}} +{{% tab "Go" %}} + +L'exportateur Go est [`otlptracehttp`][300]. Pour configurer l'exportateur, utilisez l'extrait de code suivant : + +```go +import "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp" + +traceExporter, err := otlptracehttp.New( + ctx, + otlptracehttp.WithEndpoint("${YOUR_ENDPOINT}"), // Replace this with the correct endpoint + otlptracehttp.WithURLPath("/v1/traces"), + otlptracehttp.WithHeaders( + map[string]string{ + "dd-api-key": os.Getenv("DD_API_KEY"), + "dd-otel-span-mapping": "{span_name_as_resource_name: true}", + "compute_stats": "true", + }), +) +``` + +[300]: http://go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp + +{{% /tab %}} +{{% tab "Python" %}} + +L'exportateur Python est [`OTLPSpanExporter`][400]. Pour configurer l'exportateur, utilisez l'extrait de code suivant : + +```python +from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter + +exporter = OTLPSpanExporter( + endpoint="${YOUR_ENDPOINT}", # Replace this with the correct endpoint + headers={ + "dd-api-key": os.environ.get("DD_API_KEY"), + "dd-otel-span-mapping": "{span_name_as_resource_name: true}", + "compute_stats": "true", + }, +) +``` + +[400]: https://pypi.org/project/opentelemetry-exporter-otlp-proto-http/ + +{{% /tab %}} +{{< /tabs >}} + +### (Facultatif) Mapper ou filtrer les noms de spans {#optional-map-or-filter-span-names} + +Utilisez l'en-tête `dd-otel-span-mapping` pour configurer le mappage et le filtrage des spans. L'en-tête JSON contient les champs suivants : + +- `ignore_resources` : une liste d'expressions régulières pour désactiver les traces en fonction de leur nom de ressource. +- `span_name_remappings` : une carte des noms de span Datadog vers les noms préférés. +- `span_name_as_resource_name` : spécifie s'il faut utiliser le nom du span OpenTelemetry comme nom d'opération du span Datadog (par défaut : true). Si la valeur est false, le nom de l'opération est dérivé d'une combinaison du nom de la portée d'instrumentation et du type de span. + +Exemple : + +```json +{ + "span_name_as_resource_name":false, + "span_name_remappings":{ + "io.opentelemetry.javaagent.spring.client":"spring.client" + }, + "ignore_resources":[ + "io.opentelemetry.javaagent.spring.internal" + ] +} +``` +## OpenTelemetry Collector {#opentelemetry-collector} + +Configurez la [configuration recommandée d'OpenTelemetry Collector][10] pour exporter les traces vers cet endpoint et générer des métriques de trace APM avant l'échantillonnage. + +## Dépannage {#troubleshooting} + +### Erreur : 403 Forbidden {#error-403-forbidden} + +Si vous recevez une erreur `403 Forbidden` lors de l'envoi de traces à l'endpoint d'ingestion de traces OTLP de Datadog, vérifiez que l'endpoint correspond à votre site Datadog. Votre site est {{< region-param key=dd_datacenter code="true" >}}, utilisez donc l' {{< region-param key="otlp_trace_endpoint" code="true" >}} endpoint. + +### Erreur : 413 Request Entity Too Large {#error-413-request-entity-too-large} + +Si vous recevez une erreur `413 Request Entity Too Large` lors de l'envoi de traces à l'endpoint d'ingestion de traces OTLP de Datadog, cela indique que la taille de la charge utile envoyée par l'exportateur OTLP dépasse la limite de 15 MiB (non compressée) du point de terminaison d'ingestion de traces de Datadog. + +Cette erreur se produit généralement lorsque le SDK OpenTelemetry regroupe trop de données de télémétrie dans une seule charge utile de requête. + +**Solution** : réduisez la taille du lot d'exportation du processeur de span par lots du SDK. Voici un exemple de la façon de modifier le `BatchSpanProcessorBuilder` dans le SDK OpenTelemetry Java : + +```java +CopyBatchSpanProcessor batchSpanProcessor = + BatchSpanProcessor + .builder(exporter) + .setMaxExportBatchSize(10) // Default is 512 + .build(); +``` +Ajustez la valeur `setMaxExportBatchSize` selon vos besoins. Une valeur plus petite entraîne des exportations plus fréquentes avec des charges utiles plus petites, ce qui réduit la probabilité de dépasser la limite de 15 MiB. + +### Avertissement : « traces export: failed … 202 Accepted » dans Go {#warning-traces-export-failed-202-accepted-in-go} + + +Si vous utilisez le SDK Go d'OpenTelemetry et que vous voyez un message d'avertissement similaire à `traces export: failed … 202 Accepted`, cela est dû à un problème connu dans l'exportateur HTTP OTLP d'OpenTelemetry Go. + +L'exportateur HTTP OTLP d'OpenTelemetry Go traite tout code d'état HTTP autre que 200 comme une erreur, même si l'exportation réussit ([Issue 3706][5]). En revanche, d'autres SDK OpenTelemetry considèrent tout code d'état dans la plage [200, 300) comme un succès. L'endpoint d'ingestion de traces OTLP de Datadog renvoie un code d'état `202 Accepted` pour les exportations réussies. + +La communauté OpenTelemetry discute encore de la question de savoir si d'autres codes d'état `2xx` devraient être traités comme des succès ([Issue 3203][6]). + +**Solution** : Si vous utilisez l'endpoint d'ingestion de traces OTLP de Datadog avec le SDK OpenTelemetry pour Go, vous pouvez ignorer ce message d'avertissement en toute sécurité. Vos traces sont exportées avec succès malgré l'avertissement. + +### Problème : Noms d'opération de span inattendus {#issue-unexpected-span-operation-names} + +Lorsque vous utilisez l'endpoint d'ingestion de traces OTLP de Datadog, vous pouvez remarquer que les noms d'opération de span sont différents de ceux générés lors de l'utilisation de Datadog Agent ou du collecteur OpenTelemetry. + +L'endpoint d'ingestion de traces OTLP de Datadog a l'option `span_name_as_resource_name` définie sur `true` par défaut. Cela signifie que Datadog utilise le nom du span OpenTelemetry comme nom d'opération. En revanche, Datadog Agent et le collecteur OpenTelemetry ont cette option définie sur `false` par défaut. + +Lorsque `span_name_as_resource_name` est défini sur `false`, le nom de l'opération est dérivé d'une combinaison du nom de la portée d'instrumentation et du type de span. Par exemple, un nom d'opération peut apparaître sous la forme `opentelemetry.client`. + +**Solution** : Si vous souhaitez désactiver l'option `span_name_as_resource_name` dans l'endpoint d'ingestion de traces OTLP de Datadog pour correspondre au comportement de Datadog Agent ou du collecteur OpenTelemetry, suivez ces étapes : + +1. Consultez [Mapper ou filtrer les noms de spans](#optional-map-or-filter-span-names) dans ce document. +1. Définissez l'option `span_name_as_resource_name` sur `false` dans l'en-tête `dd-otel-span-mapping`. + +Exemple : + +```json +jsonCopy{ + "span_name_as_resource_name": false, + ... +} +``` + +Cela garantit que les noms d'opération de span sont cohérents entre l'endpoint d'ingestion de traces OTLP de Datadog, Datadog Agent et le collecteur OpenTelemetry. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/opentelemetry/collector_exporter/ +[2]: /fr/opentelemetry/otlp_ingest_in_the_agent/ +[3]: https://opentelemetry.io/docs/specs/otel/glossary/#automatic-instrumentation +[5]: https://github.com/open-telemetry/opentelemetry-go/issues/3706 +[6]: https://github.com/open-telemetry/opentelemetry-specification/issues/3203 +[7]: /fr/tracing/metrics/ +[8]: /fr/opentelemetry/setup/otlp_ingest/serverless/ +[9]: /fr/opentelemetry/setup/otlp_ingest/managed_platforms/ +[10]: /fr/opentelemetry/setup/collector_exporter/ \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/_index.md b/hugo/content/fr/real_user_monitoring/_index.md index f0aff859354..484103da6a6 100644 --- a/hugo/content/fr/real_user_monitoring/_index.md +++ b/hugo/content/fr/real_user_monitoring/_index.md @@ -16,13 +16,13 @@ further_reading: - link: /real_user_monitoring/application_monitoring/browser/data_collected/ tag: Documentation text: Données RUM Browser recueillies +- link: https://learn.datadoghq.com/courses/intro-to-rum + tag: Centre d'apprentissage + text: Introduction au Real User Monitoring (RUM) - link: https://dtdg.co/fe tag: Validation des bases text: Participer à une session interactive pour obtenir des informations exploitables grâce à la solution Real User Monitoring -- link: https://learn.datadoghq.com/courses/intro-to-rum - tag: Centre d'apprentissage - text: Introduction au Real User Monitoring (RUM) - link: https://www.datadoghq.com/blog/ai-summaries-and-smart-chapters/ tag: Blog text: Comprenez plus rapidement les replays de session grâce aux résumés générés @@ -110,7 +110,7 @@ Une session RUM peut durer jusqu'à 4 heures et expire après 15 minutes d'inact | Profondeur maximale des attributs par événement | 20 | | Taille maximale d'un événement | 1 Mo | | Taille maximale de la charge utile d'ingestion | 5 Mo | -| Taille maximale des source maps et des fichiers de mappage | 500 Mo par fichier | +| Taille maximale des maps source et des fichiers de mappage | 500 Mo par fichier | | Taille maximale des fichiers dSYM | 2 Go par fichier | | Délai maximal lors de l'ingestion | 24 heures | @@ -161,7 +161,7 @@ Le tableau suivant répertorie les fonctionnalités RUM qui sont prises en charg | Session Replay | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | | **Flutter** Session Replay est en préversion. | | Signaux de frustration | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | Uniquement partiellement pris en charge pour tous les appareils **mobile** et **Roku**. | -## Points de terminaison pris en charge pour les domaines SDK {#supported-endpoints-for-sdk-domains} +## Endpoints pris en charge pour les domaines SDK {#supported-endpoints-for-sdk-domains} Tout le trafic des SDK Datadog est transmis via SSL (par défaut, sur le port 443) aux domaines suivants : @@ -177,7 +177,7 @@ Tout le trafic des SDK Datadog est transmis via SSL (par défaut, sur le port 4 | AP2 | `https://browser-intake-ap2-datadoghq.com` | | UK1 | `https://browser-intake-uk1-datadoghq.com` | -### Points de terminaison supplémentaires pour le profilage de navigateur {#additional-endpoints-for-browser-profiling} +### Endpoints supplémentaires pour le profilage de navigateur {#additional-endpoints-for-browser-profiling} Lorsque le [Browser Profiling][19] est activé, le SDK contacte également une API de quota pour déterminer si le profilage est autorisé pour la session en cours. Ceci utilise un `quota.` sous-domaine de l'origine d'ingestion standard : @@ -233,7 +233,7 @@ Affichez les sessions utilisateur par segments, par exemple pour vérifier quand {{< img src="real_user_monitoring/explorer/analytics/rum_analytics.mp4" alt="RUM Analytics" video=true >}} -### Intégration avec les logs, l'APM et le profiler {#integration-with-logs-apm-and-profiler} +### Intégration avec les logs, APM et le profiler {#integration-with-logs-apm-and-profiler} Plongez au cœur de vos [métriques d'infrastructure, logs et traces backend][5] jusqu'à identifier la ligne de code précise qui nuit aux performances de votre application, afin d'améliorer l'expérience de vos utilisateurs et résoudre les problèmes signalés. diff --git a/hugo/content/fr/real_user_monitoring/application_monitoring/_index.md b/hugo/content/fr/real_user_monitoring/application_monitoring/_index.md new file mode 100644 index 00000000000..f5c771aa859 --- /dev/null +++ b/hugo/content/fr/real_user_monitoring/application_monitoring/_index.md @@ -0,0 +1,47 @@ +--- +aliases: +- /fr/real_user_monitoring/mobile_and_tv_monitoring/ +- /fr/real_user_monitoring/mobile_and_tv_monitoring/advanced_configuration/ +- /fr/real_user_monitoring/mobile_and_tv_monitoring/data_collected/ +- /fr/real_user_monitoring/mobile_and_tv_monitoring/integrated_libraries/ +- /fr/real_user_monitoring/mobile_and_tv_monitoring/other_frameworks/ +- /fr/real_user_monitoring/mobile_and_tv_monitoring/setup/ +- /fr/real_user_monitoring/mobile_and_tv_monitoring/troubleshooting/ +description: Collectez les données RUM de vos applications sur navigateur, mobiles + et TV. +further_reading: +- link: /session_replay/ + tag: Documentation + text: Session Replay +title: Surveillance des applications +--- +## Présentation {#overview} + +Datadog Real User Monitoring (RUM) offre une vision approfondie des performances frontend de votre application. Surveillez les données réelles des utilisateurs afin d'optimiser leur expérience web et de leur offrir une expérience utilisateur exceptionnelle. Corrélez les tests Synthetic, les métriques backend, les traces et les logs en un seul endroit pour identifier et résoudre les problèmes de performance sur l'ensemble de la pile. + +Datadog vous aide à comprendre le niveau actuel de l'expérience utilisateur, à identifier les domaines à améliorer et à mesurer le succès de chaque changement et/ou déploiement. Utilisez ces informations pour identifier et résoudre les problèmes frontend inattendus avant que les utilisateurs ne soient impactés afin d'offrir la meilleure expérience possible. + +La responsabilité de maintenir la sécurité des données des utilisateurs est partagée entre Datadog et les développeurs qui utilisent les SDK RUM. En savoir plus sur la [responsabilité partagée][1]. + +## Démarrez {#get-started} + +Sélectionnez une plateforme pour commencer à collecter des données RUM sur votre application : + +{{< card-grid image_width="200" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/browser/setup" src="integrations_logos/javascript_large.svg" alt="browser" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/android/setup" src="integrations_logos/android_large.svg" alt="android" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/android/setup" src="integrations_logos/android_tv_large.svg" alt="android tv" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/cpp/setup/" src="integrations_logos/cpp_large.svg" alt="C / C++" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/flutter/setup/" src="integrations_logos/flutter_large.svg" alt="flutter" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/ios/setup/" src="integrations_logos/ios_large.svg" alt="ios" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/ios/setup/" src="integrations_logos/tv_os_large.svg" alt="tv OS" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/kotlin_multiplatform/setup/" src="integrations_logos/kotlin-multiplatform_large.svg" alt="kotlin-multiplatform" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/maui/setup/" src="integrations_logos/maui_large.svg" alt=".NET MAUI" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/react_native/setup/" src="integrations_logos/react-native_large.svg" alt="react-native" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/react_native/setup/codepush/" src="integrations_logos/react-codepush_large.svg" alt="react-codepush" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/react_native/setup/expo/" src="integrations_logos/rum-expo_large.svg" alt="rum-expo" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/roku/setup/" src="integrations_logos/roku_large.svg" alt="Roku" >}} + {{< image-card href="/real_user_monitoring/application_monitoring/unity/setup" src="integrations_logos/rum-unity_large.svg" alt="rum-unity" >}} +{{< /card-grid >}} + +[1]: /fr/data_security/real_user_monitoring/#shared-responsibility \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md b/hugo/content/fr/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md new file mode 100644 index 00000000000..54ea34385cb --- /dev/null +++ b/hugo/content/fr/real_user_monitoring/application_monitoring/browser/build_plugins/source_maps.md @@ -0,0 +1,133 @@ +--- +algolia: + tags: + - source maps + - build plugins + - error tracking +description: Téléchargez automatiquement les maps source JavaScript vers Datadog lors + de votre build pour désobfusquer les traces de pile dans Error Tracking et RUM. +further_reading: +- link: /real_user_monitoring/guide/upload-javascript-source-maps + tag: Documentation + text: Téléchargez les maps source JavaScript (méthode manuelle) +- link: /real_user_monitoring/error_tracking + tag: Documentation + text: Error Tracking +- link: https://github.com/DataDog/build-plugins + tag: Code source + text: Dépôt GitHub des plugins de build Datadog +title: Maps source +--- +## Présentation {#overview} + +Le plugin de build Source Maps télécharge automatiquement les maps source JavaScript vers Datadog pendant votre build, permettant d'obtenir des traces de pile désobfusquées dans [Error Tracking][1] et [RUM][2]. Cela évite d'avoir à exécuter manuellement `datadog-ci sourcemaps upload` ou à configurer des pipelines CI/CD pour les téléchargements de maps source. + +Le plugin s'intègre au processus de build, détecte tous les fichiers `.js` avec les fichiers maps source `.map` correspondants à partir de la sortie de build, et les télécharge vers Datadog avec les métadonnées git. Il peut associer les maps source aux événements par ID de débogage ou par service et version. + +## Prérequis {#prerequisites} + +- Une clé Datadog API, définie avec `auth.apiKey` ou la variable d'environnement `DATADOG_API_KEY`. +- Maps source activées dans la configuration de votre bundler. Le plugin télécharge les maps source mais ne les génère pas. Consultez [Upload JavaScript Source Maps][3] pour la configuration de génération de maps source spécifique au bundler. +- Pour les téléchargements par ID de débogage, activez l'injection d'ID de débogage dans le plugin de build. +- Pour les téléchargements par service et version, initialisez le SDK RUM avec les paramètres `service` et `version` qui correspondent à la configuration du plugin. +- Le plugin de build Datadog installé et enregistré auprès de votre bundler. Consultez [Build Plugins][4] pour les instructions d'installation. + +## Configuration {#configuration} + +Les variables d'environnement suivantes remplacent les valeurs de configuration : + +- `DATADOG_SITE` ou `DD_SITE` : Remplace `auth.site` pour l'URL d'ingestion. +- `DATADOG_SOURCEMAP_INTAKE_URL` : Remplace directement l'URL d'ingestion complète. + +Choisissez une méthode de correspondance pour le téléchargement des maps source : ID de débogage ou service et version. Ces méthodes de téléchargement sont mutuellement exclusives. + +{{< tabs >}} +{{% tab "ID de débogage (recommandé)" %}} + +Les ID de débogage associent chaque bundle JavaScript à sa map source sans dépendre de l'URL du bundle, du service ou de la version. Utilisez cette méthode pour les nouvelles configurations. + +La prise en charge des ID de débogage nécessite [Datadog Build Plugins version 3.3.0](https://github.com/DataDog/build-plugins/releases/tag/v3.3.0) ou ultérieure. + +Configurez les options suivantes dans `sourcemaps` : + +| Paramètre | Type | Requis | Par défaut | Description | +|-----------|------|----------|---------|-------------| +| `debugId` | Booléen | Oui | Aucun | Définissez sur `true` pour injecter un ID de débogage dans chaque bundle JavaScript. | +| `upload` | Booléen | Oui, pour télécharger | `false` | Définissez sur `true` pour télécharger les maps source pendant la build. Si omis, le plugin injecte uniquement les ID de débogage. | +| `bailOnError` | Booléen | Non | `false` | Si `true`, la build échoue lorsqu'une erreur de téléchargement d'une map source se produit. | +| `dryRun` | Booléen | Non | `false` | Si `true`, le plugin exécute le processus de téléchargement sans envoyer de données à Datadog. Utilisez cette option pour vérifier votre configuration. | +| `maxConcurrency` | Nombre | Non | `20` | Nombre maximal de téléchargements simultanés de maps source. | + +Définissez `debugId` et `upload` sur `true` pour injecter des ID de débogage et télécharger des maps source pendant la build : + +```javascript +const { datadogWebpackPlugin } = require('@datadog/webpack-plugin'); + +module.exports = { + plugins: [ + datadogWebpackPlugin({ + auth: { + apiKey: process.env.DATADOG_API_KEY, + site: 'datadoghq.com', // Optional: defaults to datadoghq.com + }, + sourcemaps: { + debugId: true, + upload: true, + }, + }), + ], +}; +``` + +{{% /tab %}} +{{% tab "Service et version" %}} + +Configurez l'objet `errorTracking.sourcemaps` pour télécharger des maps source en utilisant la correspondance de service et de version : + +| Paramètre | Type | Requis | Par défaut | Description | +|-----------|------|----------|---------|-------------| +| `service` | Chaîne | Oui | Aucun | Nom du service. Doit correspondre au paramètre d'initialisation `service` du SDK RUM. | +| `releaseVersion` | Chaîne | Oui, sauf si `metadata.version` est défini | Aucun | Version de la release. Doit correspondre au paramètre d'initialisation `version` du SDK RUM. | +| `minifiedPathPrefix` | Chaîne | Oui | Aucun | URL ou préfixe de chemin relatif à la racine où vos fichiers JavaScript minifiés sont servis. Par exemple, `https://example.com/static/` ou `/static/`. | +| `bailOnError` | Booléen | Non | `false` | Si `true`, la build échoue lorsqu'une erreur de téléchargement d'une map source se produit. | +| `dryRun` | Booléen | Non | `false` | Si `true`, le plugin exécute le processus de téléchargement sans envoyer de données à Datadog. Utilisez cette option pour vérifier votre configuration. | +| `maxConcurrency` | Nombre | Non | `20` | Nombre maximal de téléchargements simultanés de maps source. | + +```javascript +const { datadogWebpackPlugin } = require('@datadog/webpack-plugin'); + +module.exports = { + plugins: [ + datadogWebpackPlugin({ + auth: { + apiKey: process.env.DATADOG_API_KEY, + site: 'datadoghq.com', // Optional: defaults to datadoghq.com + }, + errorTracking: { + sourcemaps: { + service: 'my-application', + releaseVersion: '1.0.0', + minifiedPathPrefix: 'https://example.com/static/', + }, + }, + }), + ], +}; +``` + +Pour afficher également le code source en ligne dans les traces de pile d'Error Tracking, associez les téléchargements de maps source de service et de version au plugin [Source Code Context][5]. + +{{% /tab %}} +{{< /tabs >}} + +
Ces exemples utilisent webpack. L'objet de configuration est identique pour tous les bundlers pris en charge — seuls le nom de l'import et celui de la fonction du plugin diffèrent. Consultez Build Plugins pour obtenir les instructions d'installation pour votre bundler.
+ +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/real_user_monitoring/error_tracking +[2]: /fr/real_user_monitoring/ +[3]: /fr/real_user_monitoring/guide/upload-javascript-source-maps#instrument-your-code +[4]: /fr/real_user_monitoring/application_monitoring/browser/build_plugins/ +[5]: /fr/real_user_monitoring/application_monitoring/browser/build_plugins/source_code_context \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/application_monitoring/browser/collecting_browser_errors.md b/hugo/content/fr/real_user_monitoring/application_monitoring/browser/collecting_browser_errors.md new file mode 100644 index 00000000000..8524e350522 --- /dev/null +++ b/hugo/content/fr/real_user_monitoring/application_monitoring/browser/collecting_browser_errors.md @@ -0,0 +1,308 @@ +--- +aliases: +- /fr/error_tracking/standalone_frontend/collecting_browser_errors +- /fr/real_user_monitoring/browser/collecting_browser_errors/ +description: Apprenez à collecter et suivre les erreurs frontend provenant de plusieurs + sources à l'aide de RUM Browser SDK, y compris la collecte manuelle d'erreurs et + les limites d'erreurs de React. +further_reading: +- link: /error_tracking/explorer/ + tag: Documentation + text: Explorez vos erreurs dans Datadog +- link: /error_tracking/monitors/ + tag: Documentation + text: Alertez de manière proactive sur les problèmes ayant un impact. +- link: /real_user_monitoring + tag: Documentation + text: Mesurez les performances et l'impact sur les utilisateurs +title: Collecte d'erreurs du navigateur +--- +## Présentation {#overview} + +Le SDK Browser collecte les erreurs frontend, y compris le message d'erreur et la trace de pile lorsqu'ils sont disponibles. Pour le tri et la gestion de ces erreurs dans le produit Error Tracking, consultez [Browser Error Tracking][4]. + +Lorsque le SDK Browser collecte une erreur : + +* L'erreur est capturée en tant qu'[événement d'erreur][14] dans RUM. +* Les [filtres de rétention][15] qui ciblent les sessions contenant un événement d'erreur conservent la session actuelle. +* Les [métriques RUM][16] `rum.measure.error`, `rum.measure.session.error` et `rum.measure.view.error_free` sont mises à jour, que la session soit conservée ou non. +* L'erreur est capturée dans [Error Tracking][4]. + +Les [règles Error Tracking][17] ne s'appliquent pas aux _événements d'erreur_, et RUM enregistre toujours les événements d'erreur qui correspondent aux [problèmes ignorés et exclus][18] dans Error Tracking. Pour empêcher l'enregistrement d'erreurs en tant qu'événements d'erreur, vous devez les rejeter avant qu'elles ne soient envoyées à Datadog [à l'aide du rappel `beforeSend`][19]. + +## Sources d'erreur {#error-sources} +Les erreurs frontend proviennent de plusieurs sources différentes : + +- **agent** : De l'exécution du SDK +- **console** : Des appels d'API `console.error()` +- **custom** : Envoyé avec l'API [`addError`](#collect-errors-manually) +- **report** : De l'API `ReportingObserver` +- **source** : Des exceptions non gérées ou des rejets de promesse non gérés dans le code source + +## Attributs d'erreur {#error-attributes} + +Pour plus d'informations sur les attributs par défaut de tous les types d'événements, consultez [Données collectées][1]. Pour plus d'informations sur la configuration de l'échantillonnage ou du contexte global, consultez [Modification des données et du contexte][2]. + +| Attribut | Type | Description | +|-----------------|--------|-------------------------------------------------------------------| +| `error.source` | chaîne | L'origine de l'erreur (par exemple, `console`). | +| `error.type` | chaîne | Le type d'erreur (ou code d'erreur dans certains cas). | +| `error.message` | chaîne | Un message concis, lisible par l'homme et sur une seule ligne expliquant l'événement. | +| `error.stack` | chaîne | La trace de pile ou des informations complémentaires sur l'erreur. | +| `error.causes` | [Array][12] | Une liste facultative d'erreurs fournissant un contexte supplémentaire. Cet attribut est utilisé pour afficher les erreurs séparément et améliorer le formatage. Pour plus d'informations, consultez la [documentation MDN][13]. | + +### Erreurs source {#source-errors} + +Les erreurs source incluent des informations au niveau du code concernant l'erreur. Plus d'informations sur les différents types d'erreurs sont disponibles dans [la documentation MDN][3]. + +| Attribut | Type | Description | +|-----------------|--------|-------------------------------------------------------------------| +| `error.type` | chaîne | Le type d'erreur (ou code d'erreur dans certains cas). | + +## Configurer le suivi des erreurs WebAssembly {#configure-webassembly-error-tracking} + +Pour suivre les erreurs WebAssembly (WASM), installez le plugin WASM du SDK Browser. Utilisez la même version pour le plugin et le SDK RUM Browser : + +```shell +npm install --save-exact \ + @datadog/browser-rum@ \ + @datadog/browser-plugin-wasm@ +``` + +Enregistrez le plugin lors de l'initialisation de RUM : + +```javascript +import { makeWasmPlugin } from '@datadog/browser-plugin-wasm'; +import { datadogRum } from '@datadog/browser-rum'; + +datadogRum.init({ + // ... + plugins: [makeWasmPlugin()], +}); +``` + +Initialisez RUM avant de charger tout module WASM. Le plugin observe les modules créés avec les API `WebAssembly` du navigateur et ajoute leurs URL et build IDs aux erreurs contenant une trace de pile WASM. Cela permet à Datadog de sélectionner le bon ID de build lorsqu'une application charge plusieurs modules. + +Les erreurs non gérées sont collectées automatiquement. Pour signaler une erreur WASM gérée, passez l'objet `Error` à [`addError()`](#collect-errors-manually). + +Ensuite, [téléchargez les symboles WebAssembly][20] pour symboliser les erreurs. + +## Collecter les erreurs manuellement {#collect-errors-manually} + +Surveillez les exceptions gérées, les rejets de promesses gérés et d'autres erreurs non suivies automatiquement par le SDK Browser avec l'API `addError()` : + +{{< code-block lang="javascript" >}} +addError( + error: unknown, + context?: Context +); +{{< /code-block >}} + +**Remarque** : [Error Tracking][4] traite les erreurs envoyées avec la source définie sur `custom`, `source`, `report` ou `console`, et contenant une trace de pile. Les erreurs envoyées avec toute autre source (telle que `network`) ou envoyées depuis des extensions de navigateur ne sont pas traitées par Error Tracking. + +{{< tabs >}} +{{% tab "npm" %}} + +```javascript +import { datadogRum } from '@datadog/browser-rum'; + +// Send a custom error with context +const error = new Error('Something wrong occurred.'); + +datadogRum.addError(error, { + pageStatus: 'beta', +}); + +// Send a network error +fetch('').catch(function(error) { + datadogRum.addError(error); +}) + +// Send a handled exception error +try { + //Some code logic +} catch (error) { + datadogRum.addError(error); +} +``` +{{% /tab %}} +{{% tab "CDN async" %}} + +```javascript +// Send a custom error with context +const error = new Error('Something wrong occurred.'); + +window.DD_RUM.onReady(function() { + window.DD_RUM.addError(error, { + pageStatus: 'beta', + }); +}); + +// Send a network error +fetch('').catch(function(error) { + window.DD_RUM.onReady(function() { + window.DD_RUM.addError(error); + }); +}) + +// Send a handled exception error +try { + //Some code logic +} catch (error) { + window.DD_RUM.onReady(function() { + window.DD_RUM.addError(error); + }) +} +``` +{{% /tab %}} +{{% tab "CDN sync" %}} + +```javascript +// Send a custom error with context +const error = new Error('Something wrong occurred.'); + +window.DD_RUM && window.DD_RUM.addError(error, { + pageStatus: 'beta', +}); + +// Send a network error +fetch('').catch(function(error) { + window.DD_RUM && window.DD_RUM.addError(error); +}) + +// Send a handled exception error +try { + //Some code logic +} catch (error) { + window.DD_RUM && window.DD_RUM.addError(error); +} +``` +{{% /tab %}} +{{< /tabs >}} + +### Instrumentation des limites d'erreurs de React {#react-error-boundaries-instrumentation} + +Vous pouvez instrumenter les limites d'erreurs de React [5] pour surveiller les erreurs de rendu React à l'aide de l'API `addError()` du SDK RUM Browser. + +Les erreurs de rendu collectées contiennent une pile de composants, qui est déminifiée comme n'importe quelle autre trace de pile d'erreurs après avoir [téléchargé les sourcemaps][6]. + +Pour instrumenter les limites d'erreur React à des fins de surveillance, procédez comme suit : + +{{< tabs >}} +{{% tab "npm" %}} + +```javascript +import { datadogRum } from '@datadog/browser-rum'; + +class ErrorBoundary extends React.Component { + ... + + componentDidCatch(error, info) { + const renderingError = new Error(error.message); + renderingError.name = `ReactRenderingError`; + renderingError.stack = info.componentStack; + renderingError.cause = error; + + datadogRum.addError(renderingError); + } + + ... +} +``` + +{{% /tab %}} +{{% tab "CDN async" %}} + +```javascript +class ErrorBoundary extends React.Component { + ... + + componentDidCatch(error, info) { + const renderingError = new Error(error.message); + renderingError.name = `ReactRenderingError`; + renderingError.stack = info.componentStack; + renderingError.cause = error; + + DD_RUM.onReady(function() { + DD_RUM.addError(renderingError); + }); + } + + ... +} +``` + +{{% /tab %}} +{{% tab "CDN sync" %}} + +```javascript +class ErrorBoundary extends React.Component { + ... + + componentDidCatch(error, info) { + const renderingError = new Error(error.message); + renderingError.name = `ReactRenderingError`; + renderingError.stack = info.componentStack; + renderingError.cause = error; + + window.DD_RUM && + window.DD_RUM.addError(renderingError); + + } + + ... +} +``` + +{{% /tab %}} +{{< /tabs >}} + + +## Dépannage {#troubleshooting} + +### Erreur de script {#script-error} + +Pour des raisons de sécurité, les navigateurs masquent les détails des erreurs déclenchées par des scripts inter-origines. Lorsque cela se produit, l'onglet {{< ui >}}Error Details{{< /ui >}} affiche une erreur avec le message minimal « Script error. » + +{{< img src="real_user_monitoring/browser/script-error.png" alt="Exemple d'erreur de script Real User Monitoring" style="width:75%;" >}} + +Pour plus d'informations sur les scripts inter-origines et les raisons pour lesquelles les détails sont masqués, consultez [CORS][7] et [cette note sur les gestionnaires d'événements globaux][8]. Certaines raisons possibles pour cette erreur incluent : +- Vos fichiers JavaScript sont hébergés sur un nom de host différent (par exemple, `example.com` inclut des ressources provenant de `static.example.com`). +- Votre site web inclut des bibliothèques JavaScript hébergées sur un CDN. +- Votre site web inclut des bibliothèques JavaScript tierces hébergées sur les serveurs du fournisseur. + +Pour gagner en visibilité sur les scripts interorigines, suivez les deux étapes ci-dessous : +1. Appelez les bibliothèques JavaScript avec [`crossorigin="anonymous"`][9]. + + Avec `crossorigin="anonymous"`, la requête pour récupérer le script est effectuée de manière sécurisée. Aucune donnée sensible n'est transmise via des cookies ou une authentification HTTP. + +2. Configurez l'en-tête de réponse HTTP [`Access-Control-Allow-Origin`][10] : + + - `Access-Control-Allow-Origin: *` pour autoriser toutes les origines à récupérer la ressource. + - `Access-Control-Allow-Origin: example.com` pour spécifier une seule origine autorisée. Si le serveur prend en charge des clients provenant de plusieurs origines, il doit renvoyer l'origine pour le client spécifique effectuant la requête. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + + +[1]: /fr/real_user_monitoring/application_monitoring/browser/data_collected/ +[2]: /fr/real_user_monitoring/application_monitoring/browser/advanced_configuration/ +[3]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error +[4]: /fr/real_user_monitoring/error_tracking +[5]: https://legacy.reactjs.org/docs/error-boundaries.html +[6]: /fr/real_user_monitoring/guide/upload-javascript-source-maps/?tab=webpackjs#upload-your-source-maps +[7]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS +[8]: https://developer.mozilla.org/en-US/docs/Web/API/GlobalEventHandlers/onerror#notes +[9]: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin +[10]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin +[11]: /fr/real_user_monitoring/guide/upload-javascript-source-maps/?tab=webpackjs +[12]: https://github.com/DataDog/rum-events-format/blob/69147431d689b3e59bff87e15bb0088a9bb319a9/lib/esm/generated/rum.d.ts#L185-L203 +[13]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/cause +[14]: /fr/real_user_monitoring/explorer/search/#event-types +[15]: /fr/real_user_monitoring/rum_without_limits/retention_filters +[16]: /fr/real_user_monitoring/rum_without_limits/metrics +[17]: /fr/error_tracking/manage_data_collection +[18]: /fr/error_tracking/issue_states#excluding-an-issue +[19]: /fr/real_user_monitoring/guide/enrich-and-control-rum-data/?tab=event#discard-a-frontend-error +[20]: /fr/real_user_monitoring/guide/upload-webassembly-symbols/ \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/error_tracking/mobile/maui.md b/hugo/content/fr/real_user_monitoring/error_tracking/mobile/maui.md new file mode 100644 index 00000000000..69bd19eba47 --- /dev/null +++ b/hugo/content/fr/real_user_monitoring/error_tracking/mobile/maui.md @@ -0,0 +1,206 @@ +--- +aliases: +- /fr/real_user_monitoring/error_tracking/maui +- /fr/error_tracking/frontend/mobile/maui/ +code_lang: maui +code_lang_weight: 55 +description: Configurez Error Tracking pour vos applications .NET MAUI. +further_reading: +- link: /real_user_monitoring/error_tracking/ + tag: Documentation + text: Débuter avec Error Tracking +- link: /real_user_monitoring/error_tracking/explorer + tag: Documentation + text: Visualiser les données d'Error Tracking dans l'Explorer +title: .NET MAUI Crash Reporting et Error Tracking +type: multi-code-lang +--- +## Présentation {#overview} + +Error Tracking traite les erreurs collectées à partir du SDK .NET MAUI. + +Activez les rapports de plantage .NET MAUI Crash Reporting et Error Tracking pour obtenir des rapports de plantage complets, des traces de pile iOS natives symbolisées et des tendances d'erreurs sur iOS et Android. Vos rapports de plantage apparaissent dans [{{< ui >}}Error Tracking{{< /ui >}}][1]. + +### Suivi des erreurs C# {#c-error-tracking} + +Le suivi des erreurs C# est activé automatiquement dès que RUM est activé — aucune configuration supplémentaire n'est requise. Le SDK capture : + +- Exceptions C# non gérées (`AppDomain.UnhandledException`) +- Exceptions de tâche non observées (`TaskScheduler.UnobservedTaskException`) + +Vous pouvez également signaler manuellement une erreur avec `DdRum.AddError`. + +### Rapports de plantage natifs (facultatif) {#native-crash-reporting-optional} + +`NativeCrashReportEnabled` est **uniquement** nécessaire si vous souhaitez également capturer les plantages provenant de code iOS ou Android natif — par exemple, un plantage Objective-C/Swift sur iOS, ou un plantage JNI/Kotlin sur Android. Le suivi des erreurs C# fonctionne sans cela. + +Pour activer les rapports de plantage natifs, définissez `NativeCrashReportEnabled = true` dans la configuration du SDK : + +```csharp +.UseDatadog(new DdSdkConfiguration +{ + ClientToken = "", + Environment = "", + TrackingConsent = TrackingConsent.Granted, + NativeCrashReportEnabled = true, +}) +``` + +{% alert level="info" %} +Lorsque `NativeCrashReportEnabled = true`, une exception C# non gérée qui fait planter l'application est signalée **deux fois** : une fois en tant qu'erreur C# capturée par `AppDomain.UnhandledException`, et une fois en tant que plantage natif iOS ou Android capturé par le rapporteur de plantage de la plateforme. Les deux événements partagent la même session et la même vue RUM, vous pouvez donc les corréler dans l'Explorer. + +Si vous souhaitez n'en conserver qu'une seule version, utilisez [`ErrorEventMapper`][5] pour supprimer celle qui ne correspond pas à votre workflow (par exemple, filtrez par le contenu `Source` ou `Stacktrace`). +{% /alert %} + +## Configuration {#setup} + +Si vous n'avez pas encore configuré le SDK .NET MAUI, suivez les [instructions de configuration dans l'application][2] ou consultez la [documentation de configuration de .NET MAUI][3]. + +## Obtenez des traces de pile symbolisées {#get-symbolicated-stack-traces} + +Pour résoudre les noms de méthodes et les adresses de plantage dans les rapports de plantage iOS natifs, téléversez le bundle `.dSYM` de votre application vers Datadog. La symbolisation s'effectue ensuite côté serveur lors de chaque événement de plantage. + +| Type de trace de pile | Fichier de symboles | Comment il est résolu | +|---|---|---| +| Plantages iOS natifs (et noms de méthodes C# compilés AOT) | `.dSYM` bundle | Téléversé vers Datadog, résolu côté serveur lors de chaque événement de plantage | + +Le bundle `.dSYM` iOS est le seul fichier de symboles que le SDK téléverse. Les fichiers de mappage Android R8/ProGuard et les fichiers PDB portables ne sont pas téléversés — voir [Limitations](#limitations). + +### Téléversez les symboles avec `datadog-ci` {#upload-symbols-with-datadog-ci} + +Le package NuGet `Datadog.Maui` fournit une cible MSBuild qui téléverse automatiquement les symboles vers Datadog dans le cadre de `dotnet publish`. Pour l'activer : + +#### 1. Installez `datadog-ci` {#1-install-datadog-ci} + +```bash +npm install -g @datadog/datadog-ci +``` + +Vérifiez l'installation avec `datadog-ci version`. + +#### 2. Définissez votre clé d'API Datadog {#2-set-your-datadog-api-key} + +Exportez la clé dans le shell qui exécute `dotnet publish` : + +```bash +export DATADOG_API_KEY= +``` + +Pour les environnements CI, définissez `DATADOG_API_KEY` comme variable d'environnement protégée/secrète sur votre exécuteur. Ne validez pas la clé dans le contrôle de code source. + +Pour les tests locaux, vous pouvez transmettre la clé en tant que propriété MSBuild (`-p:DatadogApiKey=...`), mais **ne définissez pas `DatadogApiKey` dans votre `.csproj`** — ce fichier est déjà intégré dans le dépôt. + +#### 3. Activez le téléversement {#3-enable-the-upload} + +Définissez `DatadogUploadSymbols=true` soit comme une entrée `` dans votre `.csproj`, soit sur la ligne de commande `dotnet publish`. Les cibles MSBuild s'exécutent automatiquement après la publication et sont ignorées silencieusement si `datadog-ci` est manquant ou si la clé d'API n'est pas définie. + +```bash +dotnet publish -c Release -f net10.0-ios -r ios-arm64 \ + -p:DatadogUploadSymbols=true +``` + +Le bundle `.dSYM` généré à côté du `.app` est téléversé. Les dSYM ne sont produits que pour les builds d'appareil (`-r ios-arm64`) ; les builds de simulateur (`iossimulator-arm64`) ignorent le téléchargement. + +### Configuration {#configuration} + +Toute la configuration s'effectue via les propriétés MSBuild — soit dans votre `.csproj` ``, soit sur la ligne de commande `dotnet publish` avec `-p:`. + +| Propriété | Requis | Par défaut | Description | +|---|---|---|---| +| `DatadogUploadSymbols` | Oui | `false` | Défini sur `true` pour activer le téléchargement des symboles après la publication. | +| `DatadogServiceName` | Non | `$(AssemblyName)` | Nom du service utilisé pour identifier votre application dans Datadog. Doit correspondre au `Service` que vous transmettez à `DdSdkConfiguration` au moment de l'exécution. | +| `DatadogSite` | Non | `datadoghq.com` | Le site Datadog qui reçoit le téléchargement (par exemple, `datadoghq.eu`, `us5.datadoghq.com`). Doit correspondre à la valeur `Site` définie sur `DdSdkConfiguration`. | +| `DatadogApiKey` | Non | — | Clé d'API transmise directement. Si elle n'est pas définie, la variable d'environnement `DATADOG_API_KEY` est utilisée à la place. | + +```xml + + my-maui-app + datadoghq.eu + +``` + +Le logger de terminal que `dotnet publish` utilise par défaut masque les informations de sortie. Pour voir les messages de téléchargement Datadog, ajoutez `-v n -tl:off` : + +```bash +dotnet publish -c Release -f net10.0-ios -r ios-arm64 \ + -p:DatadogUploadSymbols=true -v n -tl:off +``` + +Après le téléchargement, le traitement des symboles peut prendre jusqu'à 5 minutes. Vous pouvez confirmer leur réception sous [{{< ui >}}Error Tracking{{< /ui >}} > {{< ui >}}Settings{{< /ui >}} > {{< ui >}}Symbol Files{{< /ui >}}][4]. + +## Limitations {#limitations} + +### Traces de pile C# gérées {#managed-c-stack-traces} + +Les traces de pile d'exceptions C# gérées ne sont résolues qu'en noms de méthodes. Les noms de fichiers et les numéros de ligne ne sont pas encore disponibles. + +Les builds de version .NET MAUI compilent le C# en AOT avant la distribution, de sorte que le runtime sur l'appareil ne peut pas mapper une trame vers un emplacement source. +- Sur iOS, le runtime minimal ne peut pas lire du tout les fichiers PDB portables. +- Sur Android, les frames compilées en AOT rapportent `Unknown Source`. +La résolution de ces frames nécessite de combiner le PDB portable de votre application (`.pdb`) avec les informations de débogage natives de la plateforme côté serveur, ce qui n'est pas pris en charge. Les fichiers PDB portables ne sont pas téléchargés vers Datadog, et les inclure dans l'application n'ajoute pas d'informations de fichier ou de ligne aux traces de pile rapportées. + +### Téléchargement de symboles Android {#android-symbol-upload} + +Le téléchargement de symboles n'est pas pris en charge pour les builds Android. Les fichiers R8/ProGuard `mapping.txt` ne sont pas téléchargés, donc les frames Java/Kotlin obfusquées dans les rapports de crash Android ne sont pas dés-obfusquées. Les crashs Android sont toujours collectés et rapportés — seule l'étape de dés-obfuscation est indisponible. + +### Taille des fichiers {#file-sizing} + +Les bundles dSYM (iOS) peuvent atteindre jusqu'à **2 Go** chacun. + +### Collecte {#collection} + +Le SDK gère les rapports de panne avec les comportements suivants : + +- Les crashs ne peuvent être détectés qu'une fois le SDK initialisé. Initialisez le SDK le plus tôt possible dans `MauiProgram.CreateMauiApp`. +- Les crashs RUM doivent être associés à une vue RUM. Si un crash survient avant qu'une vue ne soit visible (ou après que l'application a été mise en arrière-plan par l'utilisateur), le crash est ignoré et n'est pas rapporté. Pour atténuer cela, définissez `TrackBackgroundEvents = true` sur `DdRumConfiguration`. +- Seuls les crashs survenant lors de sessions échantillonnées sont conservés. + +### Symboles de crash NDK Android {#android-ndk-crash-symbols} + +Lorsque `NativeCrashReportEnabled = true`, les crashs natifs (C/C++) capturés par `dd-sdk-android-ndk` nécessitent des fichiers `.so` non dépouillés pour la symbolisation. + +Dans une application MAUI, les fichiers `.so` natifs proviennent généralement du runtime .NET (`libmonosgen-2.0.so`, `libmonodroid.so`) et de la propre bibliothèque NDK de Datadog — Datadog résout ces derniers côté serveur ; aucun téléchargement manuel n'est nécessaire pour l'un ou l'autre. Si vous distribuez des bibliothèques C/C++ natives personnalisées, téléchargez leurs symboles manuellement avec `datadog-ci dsyms upload `. + +## Testez votre implémentation {#test-your-implementation} + +Pour vérifier votre configuration de Crash Reporting et d'Error Tracking, déclenchez un crash et confirmez que l'erreur apparaît dans Datadog : + +1. Exécutez votre application sur un appareil réel ou un émulateur (les dSYM ne sont générés que pour les builds d'appareil sur iOS). +2. Exécutez du code qui génère une exception non gérée. Exemple : + + ```csharp + void OnButtonClicked(object sender, EventArgs e) + { + throw new InvalidOperationException("Crash the app"); + } + ``` + +3. Après le crash, redémarrez votre application et attendez que le SDK télécharge le rapport de crash. +4. Confirmez l'événement dans [{{< ui >}}Error Tracking{{< /ui >}}][1]. Pour un crash iOS natif provenant d'un build d'appareil, les frames sont symbolisées. + +## Dépannage {#troubleshooting} + +**`Skipping symbol upload — datadog-ci is not installed`** +Exécutez `npm install -g @datadog/datadog-ci` et vérifiez avec `datadog-ci version`. + +**`Skipping symbol upload — DATADOG_API_KEY is not set`** +Exportez la clé dans votre shell : `export DATADOG_API_KEY=`. Vérifiez avec `echo $DATADOG_API_KEY`. + +**`Skipping dSYM upload — file not found`** +Les dSYM ne sont générés que pour les builds d'appareil (`-r ios-arm64`). Les builds pour simulateur ne produisent pas de dSYM. + +**Aucune sortie Datadog visible lors de la publication** +Le logger du terminal masque les messages d'information. Ajoutez `-v n -tl:off` à votre commande `dotnet publish`. + +**Le téléchargement se termine mais les symboles n'apparaissent pas dans Datadog** +Le traitement des symboles peut prendre jusqu'à 5 minutes. Vérifiez [{{< ui >}}Error Tracking{{< /ui >}} > {{< ui >}}Settings{{< /ui >}} > {{< ui >}}Symbol Files{{< /ui >}}][4]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/rum/error-tracking +[2]: https://app.datadoghq.com/rum/application/create +[3]: /fr/real_user_monitoring/application_monitoring/maui/setup +[4]: https://app.datadoghq.com/source-code/setup/symbols +[5]: /fr/real_user_monitoring/application_monitoring/maui/advanced_configuration/#modify-or-drop-rum-events \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/guide/debug-symbols.md b/hugo/content/fr/real_user_monitoring/guide/debug-symbols.md new file mode 100644 index 00000000000..888cebb1166 --- /dev/null +++ b/hugo/content/fr/real_user_monitoring/guide/debug-symbols.md @@ -0,0 +1,51 @@ +--- +description: Déboguez et désobfusquez les traces de pile dans RUM à l'aide de symboles + de débogage pour examiner les erreurs dans des applications mobiles et web obfusquées. +title: Examinez les traces de pile obfusquées avec les symboles de débogage RUM. +--- +La [page Symboles de débogage RUM][1] répertorie tous les symboles de débogage téléchargés pour un type donné d'application RUM. Vous pouvez utiliser cette page pour examiner les traces de pile obfusquées. + +
Pour associer automatiquement les traces de pile à votre service et à votre version pour la résolution du code source, utilisez le plugin de build Source Code Context.
+ +Le message d'erreur suivant s'affiche lorsqu'une trace de pile n'est pas correctement désobfusquée dans RUM ou Error Tracking : _La trace de pile n'a pas pu être désobfusquée car aucun symbole de débogage n'a pu être trouvé pour cette application. Si vous n'obfusquez pas votre application, ignorez ce message. Sinon, téléchargez vos symboles de débogage pour voir les traces de pile désobfusquées. Vous pouvez consulter tous vos symboles téléchargés sur la page Symboles de débogage RUM._ + +{{< img src="real_user_monitoring/guide/debug-symbols/deobfuscation-failed-message.png" alt="Échec de la désobfuscation : la trace de pile n'a pas pu être désobfusquée car aucun fichier de mappage n'a pu être trouvé pour cette application. Si vous n'obfusquez pas votre application, ignorez ce message. Sinon, téléchargez vos fichiers de mappage pour voir les traces de pile désobfusquées. Vous pouvez consulter tous vos fichiers téléchargés sur la page Symboles de débogage RUM." >}} + +Cela peut se produire pour plusieurs raisons : + +### La trace de pile n'était pas obfusquée {#the-stack-trace-was-not-obfuscated} + +Datadog tente de désobfusquer toutes les traces de pile, y compris celles qui ne sont pas obfusquées (par exemple, issues de tests locaux ou de builds hors production). + +Vous pouvez ignorer cet avertissement. La trace de pile est déjà lisible. + +### Aucun symbole de débogage téléchargé pour cette version {#no-debug-symbols-uploaded-for-this-version} + +Utilisez la [page Symboles de débogage RUM][1] pour voir si des symboles de débogage existent pour votre application. Cette page est filtrée par {{< ui >}}type{{< /ui >}} (JavaScript, WebAssembly, Android, iOS, React Native, Flutter). Utilisez le filtre pour trouver les symboles de débogage que vous recherchez. + +S'il n'y a pas de symboles de débogage pour votre application, [téléchargez-les][2]. + +
+Assurez-vous que la taille de chaque symbole de débogage ne dépasse pas la limite de **500 Mo**, sinon le téléchargement sera rejeté. +Pour les dSYM iOS, des fichiers individuels allant jusqu'à **2 Go** sont pris en charge. +
+ +### Les tags des symboles de débogage ne correspondent pas {#debug-symbol-tags-do-not-match} + +Datadog s'appuie sur différents tags pour faire correspondre les symboles de débogage aux traces de pile. Ces tags varient pour chaque type d'application : + +| Type d'application | Combinaison de tags utilisée pour la correspondance | +| ---- | ---- | +| JavaScript | `service`, `version`, `path`| +| WebAssembly | `build_id` | +| Android | v1.13.0+ : `build_id`
Versions antérieures : `service`, `version`, `variant`| +| iOS | `uuid` | +| React Native | `service`, `version`, `bundle_name`, `platform` ; si plusieurs maps source correspondent à ces champs, celle avec la valeur `build_number` la plus élevée est sélectionnée | +| Flutter | `service`, `version`, `variant`, `architecture` | + +La [page Symboles de débogage RUM][1] affiche les valeurs de ces tags. Si vous constatez une incohérence, téléchargez à nouveau les symboles de débogage avec un ensemble de tags corrigé. + + + +[1]: https://app.datadoghq.com/source-code/setup/rum +[2]: /fr/real_user_monitoring/error_tracking/mobile/android/?tab=us#upload-your-mapping-file \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/guide/enable-rum-shopify-store.md b/hugo/content/fr/real_user_monitoring/guide/enable-rum-shopify-store.md index e5fec9ccf68..47366356970 100644 --- a/hugo/content/fr/real_user_monitoring/guide/enable-rum-shopify-store.md +++ b/hugo/content/fr/real_user_monitoring/guide/enable-rum-shopify-store.md @@ -1,69 +1,74 @@ --- +description: Configurez la surveillance RUM sur les boutiques Shopify pour suivre + les interactions des clients, les performances et les taux de conversion pour l'optimisation + du commerce électronique. further_reading: - link: /real_user_monitoring/guide/rum-for-product-analytics/ tag: Documentation - text: Utiliser la solution RUM et Session Replay pour l'analyse des produits + text: Utiliser la solution RUM et Session Replay pour Product Analytics - link: /real_user_monitoring/guide/alerting-with-conversion-rates/ tag: Documentation text: Alertes avec des taux de conversion +private: true title: Activer la solution RUM pour votre boutique Shopify --- +
+Shopify's Checkout Extensibility n'est pas prise en charge avec le suivi RUM. Si cette fonctionnalité est essentielle pour les besoins de votre entreprise, créez un ticket auprès du Datadog Support. +
-## Présentation +## Présentation {#overview} Comprendre comment les clients interagissent avec vos pages web est crucial pour le succès de votre boutique en ligne. Ce guide explique comment vous pouvez mettre en place le Real User Monitoring (la surveillance des utilisateurs réels) pour votre boutique Shopify. -## Implémentation +## Configuration {#setup} -1. Connectez-vous à votre volet d'administration Shopify. -2. Sous **Sales channels**, cliquez sur **Online Store**. +1. Connectez-vous à votre panneau d'administration Shopify. +2. Sous {{< ui >}}Sales channels{{< /ui >}}, cliquez sur {{< ui >}}Online Store{{< /ui >}}. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-1.png" alt="Activer la solution RUM pour votre boutique Shopify" style="width:30%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-1.png" alt="Activez RUM sur votre boutique Shopify" style="width:30%;">}} -3. Un nouveau menu s'ouvre, cliquez sur **Themes**. +3. Cela ouvre un nouveau menu ; cliquez sur {{< ui >}}Themes{{< /ui >}}. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-2.png" alt="Activer la solution RUM pour votre boutique Shopify" style="width:30%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-2.png" alt="Activez RUM sur votre boutique Shopify" style="width:30%;">}} -4. Cliquez sur le bouton **Edit code** de votre thème actuel. +4. Cliquez sur le bouton {{< ui >}}Edit code{{< /ui >}} pour votre thème actuel. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-2.png" alt="Activer la solution RUM pour votre boutique Shopify" >}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-3.png" alt="Activez RUM sur votre boutique Shopify" >}} -5. Sous le répertoire **Layout**, trouvez le fichier principal de votre thème **theme.liquid**. Cliquez sur le fichier pour le modifier. +5. Sous le répertoire {{< ui >}}Layout{{< /ui >}}, recherchez le fichier principal de votre thème `theme.liquid`. Cliquez sur le fichier pour le modifier. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-4.png" alt="Activer la solution RUM pour votre boutique Shopify" style="width:30%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-4.png" alt="Activez RUM sur votre boutique Shopify" style="width:30%;">}} -6. Initialisez le SDK RUM Browser en ajoutant l'extrait de code du SDK dans le tag ``. Pour en savoir plus sur la méthode d'installation à choisir, consultez la [documentation relative la surveillance Browser avec RUM][1]. +6. Initialisez le Browser RUM SDK en ajoutant l'extrait de code du SDK à l'intérieur du tag ``. Pour plus d'informations sur la méthode d'installation à choisir, consultez la [documentation RUM Browser Monitoring][1]. - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-5.png" alt="Activer la solution RUM pour votre boutique Shopify" >}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-5.png" alt="Activez RUM sur votre boutique Shopify" >}} -7. Cliquez sur le bouton **Save** pour enregistrer vos modifications. +7. Cliquez sur le bouton {{< ui >}}Save{{< /ui >}} pour enregistrer vos modifications. La mise à jour ressemble à ce qui suit dans l'IU de Shopify : - {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-6.png" alt="Activer la solution RUM pour votre boutique Shopify" style="width:50%;">}} + {{< img src="real_user_monitoring/guide/enable-rum-shopify-store/enable-rum-shopify-6.png" alt="Activez RUM sur votre boutique Shopify" style="width:50%;">}} Pour plus d'informations sur l'édition du code du thème, consultez la [documentation de Shopify][2]. -## Commencer à explorer +## Commencez à explorer {#start-exploring} Une fois que vous avez initialisé le SDK RUM Browser, vous pouvez commencer à utiliser le Real User Monitoring avec votre boutique Shopify. Vous pouvez par exemple : -- Obtenir des informations précieuses sur le comportement de vos clients en +- Obtenez des informations précieuses sur le comportement de vos clients en prenant des décisions fondées sur des données pour améliorer votre magasin -- Augmenter la conversion en observant les sessions enrichies des enregistrements des navigateurs avec [Session Replay][3]. -- Utiliser [l'analyse d'entonnoir][4] pour mieux comprendre le parcours du client, ou -- [Générer des métriques][5] à partir de ces sessions nouvellement capturées +- Augmentez le taux de conversion en visionnant les sessions enrichies d'enregistrements de navigateur grâce à [Session Replay][3]. +- [Générez des métriques][5] à partir des sessions nouvellement capturées -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} -[1]: /fr/real_user_monitoring/browser/setup/#choose-the-right-installation-method/ +[1]: /fr/real_user_monitoring/application_monitoring/browser/setup/#choose-the-right-installation-method/ [2]: https://help.shopify.com/en/manual/online-store/themes/theme-structure/extend/edit-theme-code -[3]: /fr/real_user_monitoring/session_replay/browser/ -[4]: /fr/product_analytics/journeys/funnel_analysis +[3]: /fr/session_replay/ [5]: /fr/real_user_monitoring/platform/generate_metrics/ \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/guide/mobile-sdk-upgrade.md b/hugo/content/fr/real_user_monitoring/guide/mobile-sdk-upgrade.md index 3ae8f50dba0..6bf53de8c26 100644 --- a/hugo/content/fr/real_user_monitoring/guide/mobile-sdk-upgrade.md +++ b/hugo/content/fr/real_user_monitoring/guide/mobile-sdk-upgrade.md @@ -1,4 +1,7 @@ --- +description: Guide de migration pour la mise à niveau entre les versions majeures + des SDK mobiles RUM, Logs et Trace, avec des changements incompatibles et de nouvelles + fonctionnalités. further_reading: - link: /real_user_monitoring/explorer tag: Documentation @@ -6,65 +9,590 @@ further_reading: - link: /real_user_monitoring/guide/mobile-sdk-deprecation-policy tag: Documentation text: Politique d'obsolescence des SDK Mobile Datadog - title: Mettre à niveau les SDK RUM Mobile --- +## Présentation {#overview} + +Suivez ce guide pour migrer entre les versions majeures des SDK Mobile RUM, Logs et Trace. Consultez la documentation de chaque SDK pour plus de détails sur ses fonctionnalités et ses capacités. + + +**Migrations les plus courantes** : +- [**v2 vers v3**](#from-v2-to-v3) : Mettant l'accent sur la suppression d'Open Tracing et les mises à jour de l'API +- [**v1 vers v2**](#from-v1-to-v2) : Changements architecturaux majeurs en vue d'une conception modulaire + +## De la v2 à la v3 {#from-v2-to-v3} +{{< tabs >}} +{{% tab "Android" %}} + +La transition de la version 2 à la version 3 se concentre sur la suppression de la prise en charge du projet Open Tracing hérité, améliorant ainsi la stabilité et la cohérence du SDK. + +{{% /tab %}} + +{{% tab "iOS" %}} + +La migration de la v2 vers la v3 se concentre sur la rationalisation des modules, l'affinement des valeurs par défaut et l'amélioration de la fiabilité des fonctionnalités du produit. + +Tous les produits SDK (RUM, Trace, Logs, Session Replay, etc.) restent modulaires et séparés en bibliothèques distinctes. Le changement principal est que le module `DatadogObjc` a été supprimé, son contenu ayant été intégré aux modules de produit correspondants. + +{{% /tab %}} + +{{% tab "React Native" %}} + +La migration de la v2 vers la v3 se concentre sur l'alignement de la configuration avec le comportement du SDK modulaire v3 et sur la consolidation de la propriété de la configuration entre `CoreConfiguration`, `RumConfiguration`, `LogsConfiguration` et `TraceConfiguration`. + +Veuillez lire [le guide MIGRATION.md][1] dans le dépôt officiel React Native pour obtenir la liste complète des changements. + +
+Important : Contrairement à la v2.x (qui activait toujours tous les modules de fonctionnalités lors de l'initialisation du SDK), la v3 n'initialise et n'active aucun module de fonctionnalité à moins que vous ne transmettiez explicitement sa configuration. +
+ +[1]: https://github.com/DataDog/dd-sdk-reactnative/blob/develop/MIGRATION.md + +{{% /tab %}} +{{< /tabs >}} + +### Modules {#modules} +{{< tabs >}} +{{% tab "Android" %}} + +
+Datadog suit la politique de version des bibliothèques AndroidX de Google pour les AndroidX bibliothèques, de sorte que le niveau d'API Android minimum pris en charge par le SDK v3 est 23. +
+ +**Prérequis** : +- Kotlin 1.9 est requis +- La dépendance `Open Tracing` a été supprimée car elle est obsolète + + +{{% /tab %}} + +{{% tab "iOS" %}} + +Les bibliothèques continuent d'être modularisées dans la v3. Adoptez les bibliothèques suivantes : + +- `DatadogCore` +- `DatadogCrashReporting` +- `DatadogLogs` +- `DatadogRUM` +- `DatadogSessionReplay` +- `DatadogTrace` +- `DatadogWebViewTracking` + +
+ SPM (Recommandé) + + ```swift +let package = Package( + ... + dependencies: [ + .package(url: "https://github.com/DataDog/dd-sdk-ios", from: "3.0.0") + ], + targets: [ + .target( + ... + dependencies: [ + .product(name: "DatadogCore", package: "dd-sdk-ios"), + .product(name: "DatadogCrashReporting", package: "dd-sdk-ios"), + .product(name: "DatadogLogs", package: "dd-sdk-ios"), + .product(name: "DatadogRUM", package: "dd-sdk-ios"), + .product(name: "DatadogSessionReplay", package: "dd-sdk-ios"), + .product(name: "DatadogTrace", package: "dd-sdk-ios"), + .product(name: "DatadogWebViewTracking", package: "dd-sdk-ios"), + ] + ), + ] +) + ``` + +
+ +
+ CocoaPods + + ```ruby + pod 'DatadogCore' + pod 'DatadogCrashReporting' + pod 'DatadogLogs' + pod 'DatadogRUM' + pod 'DatadogSessionReplay' + pod 'DatadogTrace' + pod 'DatadogWebViewTracking' + ``` +
+ +
+ Carthage + +Le `Cartfile` reste le même : + ``` + github "DataDog/dd-sdk-ios" + ``` + +Dans Xcode, vous **devez** lier les frameworks suivants : + ``` + DatadogInternal.xcframework + DatadogCore.xcframework + ``` + +Ensuite, vous pouvez sélectionner les modules que vous souhaitez utiliser : + ``` + DatadogCrashReporting.xcframework + DatadogLogs.xcframework + DatadogRUM.xcframework + DatadogSessionReplay.xcframework + DatadogTrace.xcframework + DatadogWebViewTracking.xcframework + ``` +
+ +{{% /tab %}} + +{{% tab "React Native" %}} + +Consultez [le guide MIGRATION.md][1] dans le dépôt officiel React Native pour connaître les étapes de mise à niveau recommandées et les mises à jour de dépendances requises. + +
+Important : Dans la v3, les modules de fonctionnalités ne sont activés que si vous transmettez leur configuration lors de l'initialisation (par exemple, RUM / Logs / Trace). Si vous omettez une configuration de fonctionnalité, cette fonctionnalité n'est ni initialisée ni activée. +
+ +[1]: https://github.com/DataDog/dd-sdk-reactnative/blob/develop/MIGRATION.md + +{{% /tab %}} + +{{< /tabs >}} + +### Modifications requises et mises à jour de l'API {#required-changes-and-api-updates} +{{< tabs >}} +{{% tab "Android" %}} + +### Core {#core} + +
+Action requise : Dans le SDK v3, l'ID des informations utilisateur devient obligatoire, et la null La valeur ne peut plus être fournie. +
+ +Modifications de l'API : + +| `2.x` | `3.0` | +|---------------------------------------------------------------|--------------------------------------------------------------------| +| `Datadog.setUserInfo(null, "Jane Smith", "jane@example.com")` | `Datadog.setUserInfo("user123", "Jane Smith", "jane@example.com")` | + +### RUM {#rum} + +Nous avons apporté des améliorations mineures aux modules RUM. Ils ne nécessitent pas de changements importants dans votre code, mais il est utile de vérifier si vous pouvez refactoriser certains paramètres redondants. + +L'URL fournie dans la méthode `useCustomEndpoint` doit être l'URL complète de l'endpoint +(`https://example.com/rum/upload`), et non seulement le nom d'hôte : + +```kotlin +Rum.enable( + RumConfiguration.Builder(...) + .useCustomEndpoint("https://example.com/rum/upload") + .build() +) +``` + +Modifications de l'API : + +| `2.x` | `3.0` | +|-------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------| +| `DatadogRumMonitor.startResource(String, String, String,Map)` | Utilisez la méthode `startResource` qui prend `RumHttpMethod` comme paramètre `method` au lieu de | +L'objet | `com.datadog.android.rum.GlobalRum` | `GlobalRum` a été renommé en `com.datadog.android.rum.GlobalRumMonitor` | +| `com.datadog.android.rum.RumMonitor.addAction()` | Le paramètre `attributes: Map` est facultatif | +| `com.datadog.android.rum.RumMonitor.startAction()` | Le paramètre `attributes: Map` est facultatif | +| `com.datadog.android.rum.RumMonitor.stopResource()` | Le paramètre `attributes: Map` est facultatif | +| `com.datadog.android.rum.RumMonitor.addError()` | Le paramètre `attributes: Map` est facultatif | +| `com.datadog.android.rum.RumMonitor.addErrorWithStacktrace()` | Le paramètre `attributes: Map` est facultatif | +| `com.datadog.android.rum.internal.monitor.AdvancedNetworkRumMonitor.stopResource()` | Le paramètre `attributes: Map` est facultatif | +| `com.datadog.android.rum.internal.monitor.AdvancedNetworkRumMonitor.stopResource()` | Le paramètre `attributes: Map` est facultatif | + +### Logs {#logs} + +Le produit Logs ne signale plus les erreurs fatales. Pour activer Error Tracking pour les plantages, Crash Reporting doit être activé conjointement avec RUM. + +L'URL fournie dans la méthode `useCustomEndpoint` doit être l'URL complète de l'endpoint +(`https://example.com/logs/upload`), et non seulement le nom d'hôte : + +```kotlin +Logs.enable( + LogsConfiguration.Builder() + .useCustomEndpoint("https://example.com/logs/upload") + .build() +) +``` + +### Trace {#trace} + +L'URL fournie dans la méthode `useCustomEndpoint` doit être l'URL complète de l'endpoint +(par ex. : `https://example.com/trace/upload`), et non seulement le nom d'hôte, c'est-à-dire : + +```kotlin +Trace.enable( + TraceConfiguration.Builder() + .useCustomEndpoint(`https://example.com/trace/upload`) + .build() +) +``` + +Le projet [`Open Tracing`](https://opentracing.io/) a été marqué comme archivé et n'est plus pris en charge. Les dépendances `Open Tracing` ont été supprimées du SDK v3. + +Le SDK Datadog prend déjà en charge [`Open Telemetry`](https://opentelemetry.io/), qui est la méthode recommandée pour utiliser l'API de fonctionnalité de traçage. + +**Notez** que la bibliothèque de spécification `Open Telemetry` [ nécessite](https://github.com/open-telemetry/opentelemetry-java?tab=readme-ov-file#requirements) que le desugaring soit activé pour les projets avec un `minSdk` < 26. + +#### Migration du traçage de `Open Tracing` vers `Open Telemetry` (recommandé) {#migrating-tracing-from-open-tracing-to-open-telemetry-recommended} + +1. Ajoutez la dépendance `Open Telemetry` à votre `build.gradle.kts` : + +```kotlin +implementation(project("com.datadoghq:dd-sdk-android-trace-otel:x.x.x")) +``` -## Présentation +2. Remplacez la configuration `Open Tracing` : + +```kotlin +GlobalTracer.registerIfAbsent( + AndroidTracer.Builder() + .setService(BuildConfig.APPLICATION_ID) + .build() +) +``` + +par la configuration `Open Telemetry` : + +```kotlin +GlobalOpenTelemetry.set( + DatadogOpenTelemetry(BuildConfig.APPLICATION_ID) +) +``` + +Pour accéder à l'objet traceur pour un traçage manuel (personnalisé), utilisez `io.opentelemetry.api.GlobalOpenTelemetry.get()` au lieu de `io.opentracing.util.GlobalTracer.get()`. +Exemple : + +```kotlin +val tracer: Tracer = GlobalOpenTelemetry + .get() + .getTracer("SampleApplicationTracer") + +val span = tracer + .spanBuilder("Executing operation") + .startSpan() + +// Code that should be instrumented + +span.end() +``` -Suivez les instructions de ce guide pour passer d'une version majeure à une autre des SDK RUM Mobile, Logs et Trace. Consultez la documentation de chaque SDK pour obtenir plus d'informations sur ses fonctionnalités. +Consultez la `Open Telemetry`[documentation](https://opentelemetry.io/docs/) officielle pour plus de détails. -## De la version 1 à la version 2 +#### Migration du traçage de `Open Tracing` vers `DatadogTracing` (période de transition) {#migrating-tracing-from-open-tracing-to-datadogtracing-transition-period} + +
Cette option a été ajoutée pour la compatibilité et pour simplifier la transition d'Open Tracing vers Open Telemetry, mais elle pourrait ne pas être disponible dans les futures versions majeures. Datadog recommande d'utiliser Open Telemetry comme standard pour les tâches de traçage. Cependant, s'il n'est pas possible d'activer le « desugaring » dans votre projet pour une raison quelconque, vous pouvez utiliser cette méthode.
+Remplacez la configuration `Open Tracing` : + +```kotlin +GlobalTracer.registerIfAbsent( + AndroidTracer.Builder() + .setService(BuildConfig.APPLICATION_ID) + .build() +) +``` + +par la configuration `DatadogTracing` : + +```kotlin +GlobalDatadogTracer.registerIfAbsent( + DatadogTracing.newTracerBuilder() + .build() +) +``` + +Pour un traçage manuel (personnalisé), utilisez `com.datadog.android.trace.GlobalDatadogTracer.get()` au lieu de `io.opentracing.util.GlobalTracer.get()` pour accéder à l'objet traceur. +Exemple : + +```kotlin +val tracer = GlobalDatadogTracer.get() + +val span = tracer + .buildSpan("Executing operation") + .start() + +// Code that should be instrumented + +span.finish() +``` +Consultez la [documentation](https://docs.datadoghq.com/fr/tracing/trace_collection/automatic_instrumentation/dd_libraries/android?tab=kotlin) Datadog pour plus de détails. + +Modifications de l'API : + +| `2.x` | `3.0` `Open Telemetry` | `3.0` `Datadog API` | +|-------------------------------------------|--------------------------------------------|---------------------------------------------------------| +| `io.opentracing.util.GlobalTracer` | `io.opentelemetry.api.GlobalOpenTelemetry` | `com.datadog.android.trace.GlobalDatadogTracer` | +| `com.datadog.android.trace.AndroidTracer` | `io.opentelemetry.api.trace.Tracer` | `com.datadog.android.trace.api.tracer.DatadogTracer` | +| `io.opentracing.Span` | `io.opentelemetry.api.trace.Span` | `com.datadog.android.trace.api.span.DatadogSpan` | +| `io.opentracing.Scope` | `io.opentelemetry.context.Scope` | `com.datadog.android.trace.api.scope.DatadogScope` | +| `io.opentracing.SpanContext` | `io.opentelemetry.api.trace.SpanContext` | `com.datadog.android.trace.api.span.DatadogSpanContext` | + +Conseils de remplacement : + +| `2.x` | `3.0` `Open Telemetry` | `3.0` `Datadog API` | +|-----------------------------------------------|-------------------------------------------------------|---------------------------------------------------| +| `AndroidTracer.Builder().build()` | | `DatadogTracing.newTracerBuilder().build()` | +| `AndroidTracer.setPartialFlushThreshold(Int)` | `OtelTracerProvider.setPartialFlushThreshold()` | `DatadogTracerBuilder.withPartialFlushMinSpans()` | +| `io.opentracing.SpanContext.toTraceId()` | `io.opentelemetry.api.trace.SpanContext.getTraceId()` | `DatadogSpanContext.traceId.toString()` | +| `io.opentracing.Span.setError()` | `io.opentelemetry.api.trace.recordException()` | `DatadogSpan.addThrowable()` | + +### Instrumentation OkHttp {#okhttp-instrumentation} + +L'instrumentation OkHttp (`com.datadoghq:dd-sdk-android-okhttp:x.x.x`) ne nécessite pas la prise en charge du « desugaring ». Cependant, quelques actions de migration peuvent être nécessaires. + +Modifications de l'API : + +| `2.x` | `3.0` | +|----------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------| +| `TracingInterceptor(String, List, TracedRequestListener,Sampler)` | Utilisez `TracingInterceptor.Builder()` à la place. | +| `TracingInterceptor(String?,Map>, TracedRequestListener, Sampler)` | Utilisez `TracingInterceptor.Builder()` à la place. | +| `TracingInterceptor(String?,TracedRequestListener,Sampler)` | Utilisez `TracingInterceptor.Builder()` à la place. | +| `DatadogInterceptor(String?, Map>,TracedRequestListener, RumResourceAttributesProvider, Sampler)` | Utilisez `DatadogInterceptor.Builder()` à la place. | +| `DatadogInterceptor(String?,List,TracedRequestListener,RumResourceAttributesProvider,Sampler)` | Utilisez `DatadogInterceptor.Builder()` à la place. | +| `DatadogInterceptor(String?,TracedRequestListener,RumResourceAttributesProvider,Sampler) ` | Utilisez `DatadogInterceptor.Builder()` à la place. | + + +### Session Replay {#session-replay} + +L'URL fournie dans la méthode `useCustomEndpoint` doit être l'URL complète de l'endpoint +(par ex. : `https://example.com/session_replay/upload`), et non seulement le nom d'hôte, c'est-à-dire : + +```kotlin +SessionReplay.enable( + SessionReplayConfiguration.Builder(...) + .useCustomEndpoint("https://example.com/session_replay/upload") + .build() +) +``` + +{{% /tab %}} +{{% tab "iOS" %}} + +Le SDK doit être initialisé le plus tôt possible dans le cycle de vie de l'application, spécifiquement dans le rappel `application(_:didFinishLaunchingWithOptions:)` de `AppDelegate`. Cela garantit une mesure précise de toutes les métriques, y compris la durée de démarrage de l'application. Pour les applications créées avec SwiftUI, utilisez `@UIApplicationDelegateAdaptor` pour accéder à `AppDelegate`. + +```swift +import DatadogCore + +Datadog.initialize( + with: Datadog.Configuration( + clientToken: "", + env: "", + service: "" + ), + trackingConsent: .granted +) +``` + +**Remarque** : L'initialisation du SDK ailleurs (par exemple plus tard lors du chargement de la vue) peut entraîner des données de télémétrie inexactes ou manquantes, en particulier concernant les performances de démarrage de l'application. + +
+Action requise : L'API pour définir les informations utilisateur nécessite le id le paramètre, qui était facultatif dans la version 2.x. +
+ +| `2.x` | `3.0` | +|-------------------------------------|------------------------------------| +| `Datadog.setUserInfo(id: nil, name: "Jane Smith", email: "jane@example.com")` | `Datadog.setUserInfo(id: "user123", name: "Jane Smith", email: "jane@example.com")` | + +### RUM {#rum-1} + +Les attributs au niveau de la vue RUM sont automatiquement propagés à tous les événements enfants associés, y compris les ressources, les actions utilisateur, les erreurs et les tâches longues. Cela garantit la cohérence des métadonnées entre les événements, facilitant ainsi le filtrage et la corrélation des données sur les tableaux de bord Datadog. + +Pour gérer plus efficacement les attributs au niveau de la vue, de nouvelles API ont été ajoutées : +- `Monitor.addViewAttribute(forKey:value:)` +- `Monitor.addViewAttributes(_:)` +- `Monitor.removeViewAttribute(forKey:)` +- `Monitor.removeViewAttributes(forKeys:)` + +Autres changements notables : +- Toutes les API RUM Objective-C sont incluses dans `DatadogRUM`. Le module `DatadogObjc` séparé n'est plus disponible. +- Les blocages d'application et les arrêts par le watchdog ne sont plus signalés depuis les extensions d'application ou les widgets. +- Une nouvelle propriété `trackMemoryWarnings` a été ajoutée à `RUM.Configuration` pour signaler les avertissements de mémoire en tant qu'erreurs RUM. + +Modifications de l'API : + +|`2.x`|`3.0`| +|---|---| +|-|`RUM.Configuration.trackMemoryWarnings`| +|`RUMView(path:attributes:)`|`RUMView(name:attributes:isUntrackedModal:)`| +|-|`Monitor.addViewAttribute(forKey:value:)`| +|-|`Monitor.addViewAttributes(:)`| +|-|`Monitor.removeViewAttribute(forKey:)`| +|-|`Monitor.removeViewAttributes(forKeys:)`| + +### Logs {#logs-1} + +Le produit Logs ne signale plus les erreurs fatales. Pour activer Error Tracking pour les plantages, Crash Reporting doit être activé conjointement avec RUM. + +De plus, toutes les Objective-C Logs APIs sont incluses dans `DatadogLogs`. Le module `DatadogObjc` séparé n'est plus disponible. + +### Trace {#trace-1} + +L'échantillonnage des traces est désormais déterministe lorsqu'il est utilisé avec RUM. Il utilise le RUM `session.id` pour garantir un échantillonnage cohérent. + +Également : +- La configuration `Trace.Configuration.URLSessionTracking.FirstPartyHostsTracing` définit l'échantillonnage pour toutes les requêtes par défaut et le contexte de trace est injecté uniquement dans les requêtes échantillonnées. +- Toutes les Objective-C Trace APIs sont incluses dans `DatadogTrace`. Le module `DatadogObjc` séparé n'est plus disponible. + +**Remarque** : Une configuration similaire existe dans `RUM.Configuration.URLSessionTracking.FirstPartyHostsTracing`. + +### Session Replay {#session-replay-1} + +Les paramètres de confidentialité sont plus granulaires. Le paramètre `defaultPrivacyLevel` précédent a été remplacé par : +- `textAndInputPrivacyLevel` +- `imagePrivacyLevel` +- `touchPrivacyLevel` + +En savoir plus sur les [niveaux de confidentialité][1]. + +Modifications de l'API : + +|`2.x`|`3.0`| +|---|---| +|`SessionReplay.Configuration(replaySampleRate:defaultPrivacyLevel:startRecordingImmediately:customEndpoint:)`|`SessionReplay.Configuration(replaySampleRate:textAndInputPrivacyLevel:imagePrivacyLevel:touchPrivacyLevel:startRecordingImmediately:customEndpoint:featureFlags:)`| +|`SessionReplay.Configuration(replaySampleRate:defaultPrivacyLevel:startRecordingImmediately:customEndpoint:)`|`SessionReplay.Configuration(replaySampleRate:textAndInputPrivacyLevel:imagePrivacyLevel:touchPrivacyLevel:startRecordingImmediately:customEndpoint:featureFlags:)`| + +### URLSession Instrumentation {#urlsession-instrumentation} + +Pour activer l'instrumentation URLSession, assurez-vous également d'activer RUM et/ou Trace pour effectuer des rapports vers ces produits respectifs. + +Les types de délégués hérités ont été remplacés par une API d'instrumentation unifiée : + +|`2.x`|`3.0`| +|---|---| +|`DatadogURLSessionDelegate()`|`URLSessionInstrumentation.enable(with:)`| +|`DDURLSessionDelegate()`|`URLSessionInstrumentation.enable(with:)`| +|`DDNSURLSessionDelegate()`|`URLSessionInstrumentation.enable(with:)`| + +[1]: /fr/session_replay/privacy_options?platform=ios + +{{% /tab %}} + +{{% tab "React Native" %}} + +Veuillez lire [le guide MIGRATION.md][1] dans le dépôt officiel React Native. + +
+Important : Contrairement à la v2.x (qui activait toujours tous les modules de fonctionnalités lors de l'initialisation du SDK), la v3 n'initialise et n'active aucun module de fonctionnalité à moins que vous ne transmettiez explicitement sa configuration. +
+ +### Modifications de configuration {#configuration-changes} + +Certaines propriétés de configuration ont été déplacées, renommées, supprimées ou divisées : + +| Propriété | Nouvel emplacement | Modifications | +| :--- | :--- | :--- | +| `sampleRate` | *Supprimé* | Propriété obsolète supprimée. | +| `sessionSamplingRate` | `RumConfiguration` | Déplacé et renommé en `sessionSampleRate`. | +| `resourceTracingSamplingRate` | `RumConfiguration` | Déplacé et renommé en `resourceTraceSampleRate`. | +| `proxyConfig` | `CoreConfiguration` | Renommé en `proxyConfiguration`. | +| `serviceName` | `CoreConfiguration` | Renommé en `service`. | +| `customEndpoints` | *Divisé* | Divisé en `customEndpoint` au sein de `RumConfiguration`, `LogsConfiguration` et `TraceConfiguration`. | +| *(Nouvelle propriété)* | `CoreConfiguration` | `attributeEncoders` ajoutée. | +| *(Nouvelle propriété)* | `RumConfiguration` | `trackMemoryWarnings` ajoutée. | +| `nativeCrashReportEnabled` | `RumConfiguration` | Déplacé. | +| `nativeViewTracking` | `RumConfiguration` | Déplacé. | +| `nativeInteractionTracking` | `RumConfiguration` | Déplacé. | +| `firstPartyHosts` | `RumConfiguration` | Utilisation forcée du type `FirstPartyHost[]` et déplacé. | +| `telemetrySampleRate` | `RumConfiguration` | Déplacé. | +| `nativeLongTaskThresholdMs` | `RumConfiguration` | Déplacé. | +| `longTaskThresholdMs` | `RumConfiguration` | Déplacé. | +| `vitalsUpdateFrequency` | `RumConfiguration` | Déplacé. | +| `trackFrustrations` | `RumConfiguration` | Déplacé. | +| `trackBackgroundEvents` | `RumConfiguration` | Déplacé. | +| `bundleLogsWithRum` | `LogsConfiguration` | Déplacé. | +| `bundleLogsWithTraces` | `LogsConfiguration` | Déplacé. | +| `trackNonFatalAnrs` | `RumConfiguration` | Déplacé. | +| `appHangThreshold` | `RumConfiguration` | Déplacé. | +| `initialResourceThreshold` | `RumConfiguration` | Déplacé. | +| `trackWatchdogTerminations` | `RumConfiguration` | Déplacé. | +| `actionNameAttribute` | `RumConfiguration` | Déplacé. | +| `logEventMapper` | `LogsConfiguration` | Déplacé. | +| `errorEventMapper` | `RumConfiguration` | Déplacé. | +| `resourceEventMapper` | `RumConfiguration` | Déplacé. | +| `actionEventMapper` | `RumConfiguration` | Déplacé. | +| `useAccessibilityLabel` | `RumConfiguration` | Déplacé. | +| `trackInteractions` | `RumConfiguration` | Déplacé. | +| `trackResources` | `RumConfiguration` | Déplacé. | +| `trackErrors` | `RumConfiguration` | Déplacé. | + +### Structures renommées {#renamed-structures} + +| `2.x` | `3.x` | +|---|---| +| `DdSdkConfiguration` | `CoreConfiguration` | + +### Mises à jour de l'API {#api-updates} + +En plus des changements de propriété de configuration (configurations Core vs feature), plusieurs types publics et API ont été renommés ou déplacés pour correspondre à la conception modulaire de la v3. Consultez [le guide MIGRATION.md][1] pour obtenir la liste officielle et des exemples de code. + +[1]: https://github.com/DataDog/dd-sdk-reactnative/blob/develop/MIGRATION.md + +{{% /tab %}} + +{{< /tabs >}} + +## De la v1 à la v2 {#from-v1-to-v2} {{< tabs >}} {{% tab "Android" %}} -Le passage de la version 1 à la version 2 correspond à une transition d'un SDK monolithique vers une architecture modulaire. Les SDK RUM, Trace, Logs ou encore Session Replay possèdent chacun des modules individuels vous permettant d'intégrer uniquement les éléments nécessaires dans votre application. +La migration de la v1 vers la v2 représente une migration d'un SDK monolithique vers une architecture modulaire. RUM, Trace, Logs, Session Replay, etc. possèdent chacun des modules individuels, vous permettant d'intégrer uniquement ce qui est nécessaire dans votre application. + +Le SDK v2 offre une disposition d'API unifiée et un alignement des noms entre le SDK iOS, le SDK Android et les autres produits Datadog. -La version 2 du SDK harmonise la disposition de l'API ainsi que les différents noms entre le SDK iOS, le SDK Android et les autres solutions Datadog. +Le SDK v2 permet l'utilisation de [Mobile Session Replay][2] sur les applications Android et iOS. -Avec la version 2 du SDK, vous pouvez utiliser [Session Replay sur mobile][1] dans les applications Android et iOS. +[2]: /fr/session_replay/?platform=android {{% /tab %}} {{% tab "iOS" %}} -Le passage de la version 1 à la version 2 correspond à une transition d'un SDK monolithique vers une architecture modulaire. Les SDK RUM, Trace, Logs ou encore Session Replay possèdent chacun des modules individuels vous permettant d'intégrer uniquement les éléments nécessaires dans votre application. +La migration de la v1 vers la v2 représente une migration d'un SDK monolithique vers une architecture modulaire. RUM, Trace, Logs, Session Replay, etc. possèdent chacun des modules individuels, vous permettant d'intégrer uniquement ce qui est nécessaire dans votre application. -La version 2 du SDK harmonise la disposition de l'API ainsi que les différents noms entre le SDK iOS, le SDK Android et les autres solutions Datadog. +Le SDK v2 offre une disposition d'API unifiée et un alignement des noms entre le SDK iOS, le SDK Android et les autres produits Datadog. -Avec la version 2 du SDK, vous pouvez utiliser [Session Replay sur mobile][1] dans les applications Android et iOS. +Le SDK v2 permet l'utilisation de [Mobile Session Replay][3] sur les applications Android et iOS. + +[3]: /fr/session_replay/?platform=ios {{% /tab %}} {{% tab "React Native" %}} -La version 2 offre des performances supérieures par rapport à la version 1. +La migration vers la version 2 offre des performances supérieures par rapport à la version 1. {{% /tab %}} {{% tab "Flutter" %}} -La version 2 offre des performances supérieures par rapport à la version 1. De plus, les SDK Native v2 proposent des fonctionnalités supplémentaires. +La migration vers la version 2 offre des performances supérieures par rapport à la version 1. De plus, les SDK Native v2 proposent des fonctionnalités supplémentaires. {{% /tab %}} {{< /tabs >}} -### Modules + +### Modules {#modules-1} {{< tabs >}} {{% tab "Android" %}} -Dans la version 2, les artefacts sont modularisés. Adoptez les artefacts suivants : +Les artefacts sont modularisés dans la v2. Adoptez les artefacts suivants : -* RUM : `com.datadoghq:dd-sdk-android-rum:x.x.x` -* Logs : `com.datadoghq:dd-sdk-android-logs:x.x.x` -* Trace : `com.datadoghq:dd-sdk-android-trace:x.x.x` -* Session Replay : `com.datadoghq:dd-sdk-android-session-replay:x.x.x` -* Suivi des vues Web : `com.datadoghq:dd-sdk-android-webview:x.x.x` -* Instrumentation OkHttp : `com.datadoghq:dd-sdk-android-okhttp:x.x.x` +* RUM : `com.datadoghq:dd-sdk-android-rum:x.x.x` +* Logs : `com.datadoghq:dd-sdk-android-logs:x.x.x` +* Trace : `com.datadoghq:dd-sdk-android-trace:x.x.x` +* Session Replay : `com.datadoghq:dd-sdk-android-session-replay:x.x.x` +* WebView Tracking : `com.datadoghq:dd-sdk-android-webview:x.x.x` +* OkHttp instrumentation : `com.datadoghq:dd-sdk-android-okhttp:x.x.x` -**Remarque** : si vous utilisez les rapports de crash NDK et le suivi des vues Web, vous devez ajouter les artefacts RUM et Logs pour transmettre respectivement des événements à RUM et à la solution de logs. +**Remarque** : Si vous utilisez NDK Crash Reporting et WebView Tracking, vous devez ajouter les artefacts RUM et Logs pour signaler les événements à RUM et Logs respectivement. -La référence à l'artefact `com.datadoghq:dd-sdk-android` doit être supprimée du script du build Gradle, étant donné que cet artefact n'existe plus. +La référence à l'artefact `com.datadoghq:dd-sdk-android` doit être supprimée de votre script de build Gradle, car cet artefact n'existe plus. -**Remarque** : les coordonnées Maven de tous les autres artefacts demeurent les mêmes. +**Remarque** : Les coordonnées Maven de tous les autres artefacts restent les mêmes. -
La version 2 ne prend pas en charge l'API 19 (KitKat) d'Android. Le SDK minimum pris en charge est désormais l'API 21 (Lollipop). Kotlin 1.7 est requis. Puisque Le SDK est compilé avec Kotlin 1.8, un compilateur de Kotlin 1.6 et versions antérieures ne peut pas lire les métadonnées des classes du SDK.
+
v2 ne prend pas en charge l'API Android 19 (KitKat). Le SDK minimum pris en charge est désormais l'API 21 (Lollipop). Kotlin 1.7 est requis. Le SDK lui-même est compilé avec Kotlin 1.8, donc un compilateur Kotlin 1.6 ou inférieur ne peut pas lire les métadonnées des classes du SDK.
Si jamais vous rencontrez une erreur semblable à ce qui suit : @@ -73,7 +601,7 @@ A failure occurred while executing com.android.build.gradle.internal.tasks.Check Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt found in modules kotlin-stdlib-1.8.10 (org.jetbrains.kotlin:kotlin-stdlib:1.8.10) and kotlin-stdlib-jdk8-1.7.20 (org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.20) ``` -Ajoutez les règles suivantes au script de votre build (voir ce [fil Stack Overflow][2] pour obtenir plus d'informations) : +Ajoutez les règles suivantes à votre script de build (plus de détails dans le [problème Stack Overflow][4] correspondant) : ```kotlin dependencies { @@ -88,15 +616,15 @@ dependencies { } ``` -Consultez l'[extrait d'application Android][3] pour obtenir un exemple de configuration du SDK. +Consultez l'[exemple d'application Android][5] pour savoir comment configurer le SDK. -[2]: https://stackoverflow.com/a/75298544 -[3]: https://github.com/DataDog/dd-sdk-android/tree/develop/sample +[4]: https://stackoverflow.com/a/75298544 +[5]: https://github.com/DataDog/dd-sdk-android/tree/develop/sample {{% /tab %}} {{% tab "iOS" %}} -Dans la version 2, les bibliothèques sont modularisées. Adoptez les bibliothèques suivantes : +Les bibliothèques sont modularisées dans la v2. Adoptez les bibliothèques suivantes : - `DatadogCore` - `DatadogLogs` @@ -105,10 +633,10 @@ Dans la version 2, les bibliothèques sont modularisées. Adoptez les biblioth - `DatadogRUM` - `DatadogWebViewTracking` -Elles complètent les bibliothèques `DatadogCrashReporting` et `DatadogObjc` existantes. +Celles-ci s'ajoutent aux `DatadogCrashReporting` et `DatadogObjc` existantes.
- SPM + SPM (Recommandé) ```swift let package = Package( @@ -153,18 +681,18 @@ let package = Package(
Carthage - Le `Cartfile` reste le même : +Le `Cartfile` reste le même : ``` github "DataDog/dd-sdk-ios" ``` - Dans Xcode, vous **devez** associer les frameworks suivants : +Dans Xcode, vous **devez** lier les frameworks suivants : ``` DatadogInternal.xcframework DatadogCore.xcframework ``` - Ensuite, vous pouvez sélectionner les modules que vous voulez utiliser : +Ensuite, vous pouvez sélectionner les modules que vous souhaitez utiliser : ``` DatadogLogs.xcframework DatadogTrace.xcframework @@ -176,33 +704,33 @@ let package = Package( ```
-**Remarque** : si vous utilisez les rapports de crash et le suivi des vues Web, vous devez ajouter les modules RUM et Logs pour transmettre respectivement des événements à RUM et à la solution de logs. +**Remarque** : Lorsque vous utilisez Crash Reporting et WebView Tracking, vous devez ajouter les modules RUM et Logs pour signaler les événements à RUM et Logs respectivement. {{% /tab %}} -{{% tab "React Native" %}} +{{% tab "React Native" %}} -Mettez à jour `@datadog/mobile-react-native` dans votre package.json : +Mettez à jour `@datadog/mobile-react-native` dans votre package.json : ```json "@datadog/mobile-react-native": "2.0.0" ``` -Mettez à jour vos pods iOS : +Mettez à jour vos pods iOS : ```bash (cd ios && bundle exec pod update) ``` -Si vous utilisez une version de React Native ultérieure à la version `0.67`, utilisez la version 17 de Java. Si vous utilisez la version `0.67` ou une version antérieure de React Native, utilisez la version 11 de Java. Pour vérifier quelle version de Java vous utilisez, exécutez ce qui suit dans un terminal : +Si vous utilisez une version de React Native strictement supérieure à `0.67`, utilisez la version 17 de Java. Si vous utilisez une version de React Native égale ou inférieure à `0.67`, utilisez la version 11 de Java. Pour vérifier votre version de Java, exécutez la commande suivante dans un terminal : ```bash java --version ``` -### Pour les versions de React Native antérieures à la v0.73 +### Pour React Native < 0.73 {#for-react-native-073} -Dans votre fichier `android/build.gradle`, spécifiez la `kotlinVersion` pour éviter les conflits entre les dépendances Kotlin : +Dans votre fichier `android/build.gradle`, spécifiez `kotlinVersion` pour éviter les conflits entre les dépendances Kotlin : ```groovy buildscript { @@ -213,9 +741,9 @@ buildscript { } ``` -### Pour les versions de React Native antérieures à la v0.68 +### Pour React Native < 0.68 {#for-react-native-068} -Dans votre fichier `android/build.gradle`, spécifiez la `kotlinVersion` pour éviter les conflits entre les dépendances Kotlin : +Dans votre fichier `android/build.gradle`, spécifiez `kotlinVersion` pour éviter les conflits entre les dépendances Kotlin : ```groovy buildscript { @@ -226,17 +754,17 @@ buildscript { } ``` -Si vous utilisez une version de `com.android.tools.build:gradle` antérieure à la version `5.0` dans votre `android/build.gradle`, ajoutez ce qui suit dans votre fichier `android/gradle.properties` : +Si vous utilisez une version de `com.android.tools.build:gradle` inférieure à `5.0` dans votre `android/build.gradle`, ajoutez dans votre fichier `android/gradle.properties` : ```properties android.jetifier.ignorelist=dd-sdk-android-core ``` -### Dépannage +### Dépannage {#troubleshooting} -#### Échec du build Android avec l'erreur `Unable to make field private final java.lang.String java.io.File.path accessible` +#### Le build Android échoue avec `Unable to make field private final java.lang.String java.io.File.path accessible` {#android-build-fails-with-unable-to-make-field-private-final-javalangstring-javaiofilepath-accessible} -Si une erreur d'échec de votre build Android similaire à ce qui suit s'affiche : +Si votre build Android échoue avec une erreur telle que : ``` FAILURE: Build failed with an exception. @@ -246,11 +774,11 @@ Execution failed for task ':app:processReleaseMainManifest'. > Unable to make field private final java.lang.String java.io.File.path accessible: module java.base does not "opens java.io" to unnamed module @1bbf7f0e ``` -Vous utilisez Java 17, qui n'est pas compatible avec votre version de React Native. Repassez à Java 11 pour résoudre le problème. +Vous utilisez Java 17, qui n'est pas compatible avec votre version de React Native. Passez à Java 11 pour résoudre le problème. -#### Échec du build Android avec l'erreur `Unsupported class file major version 61` +#### La compilation Android échoue avec `Unsupported class file major version 61` {#android-build-fails-with-unsupported-class-file-major-version-61} -Si une erreur d'échec de votre build Android similaire à ce qui suit s'affiche : +Si votre build Android échoue avec une erreur telle que : ``` FAILURE: Build failed with an exception. @@ -263,15 +791,15 @@ Could not determine the dependencies of task ':app:lintVitalRelease'. > Failed to transform '/Users/me/.gradle/caches/modules-2/files-2.1/com.datadoghq/dd-sdk-android-core/2.0.0/a97f8a1537da1de99a86adf32c307198b477971f/dd-sdk-android-core-2.0.0.aar' using Jetifier. Reason: IllegalArgumentException, message: Unsupported class file major version 61. (Run with --stacktrace for more details.) ``` -Vous utilisez une version d'Android Gradle Plugin antérieure à la `5.0`. Pour résoudre le problème, ajoutez ce qui suit à votre fichier `android/gradle.properties` : +Vous utilisez une version du plugin Android Gradle inférieure à `5.0`. Pour résoudre le problème, ajoutez dans votre fichier `android/gradle.properties` : ```properties android.jetifier.ignorelist=dd-sdk-android-core ``` -#### Échec du build Android avec l'erreur `Duplicate class kotlin.collections.jdk8.*` +#### La compilation Android échoue avec `Duplicate class kotlin.collections.jdk8.*` {#android-build-fails-with-duplicate-class-kotlincollectionsjdk8} -Si une erreur d'échec de votre build Android similaire à ce qui suit s'affiche : +Si votre build Android échoue avec une erreur telle que : ``` FAILURE: Build failed with an exception. @@ -283,7 +811,7 @@ Execution failed for task ':app:checkReleaseDuplicateClasses'. Duplicate class kotlin.internal.jdk7.JDK7PlatformImplementations found in modules jetified-kotlin-stdlib-1.8.10 (org.jetbrains.kotlin:kotlin-stdlib:1.8.10) and jetified-kotlin-stdlib-jdk7-1.7.20 (org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.7.20) ``` -Vous devez définir une version Kotlin pour votre projet afin d'éviter les conflits entre les dépendances Kotlin. Dans votre fichier `android/build.gradle`, spécifiez la `kotlinVersion` : +Vous devez définir une version de Kotlin pour votre projet afin d'éviter les conflits entre les dépendances Kotlin. Dans votre fichier `android/build.gradle`, spécifiez le `kotlinVersion` : ```groovy buildscript { @@ -294,7 +822,7 @@ buildscript { } ``` -Sinon, vous pouvez ajouter les règles suivantes au script de votre build dans votre fichier `android/app/build.gradle` : +Alternativement, vous pouvez ajouter les règles suivantes à votre script de compilation dans votre fichier `android/app/build.gradle` : ```groovy dependencies { @@ -312,29 +840,29 @@ dependencies { {{% /tab %}} {{% tab "Flutter" %}} -Mettez à jour `datadog_flutter_plugin` dans votre fichier pubspec.yaml : +Mettez à jour `datadog_flutter_plugin` dans votre pubspec.yaml : ```yaml dependencies: 'datadog_flutter_plugin: ^2.0.0 ``` -## Dépannage +## Dépannage {#troubleshooting-1} -### Double interface (iOS) +### Interface en double (iOS) {#duplicate-interface-ios} -Si, après avoir installé la version 2.0 de `datadog_flutter_plugin`, vous rencontrez l'erreur suivante lors du build iOS : +Si vous voyez cette erreur lors de la compilation iOS après la mise à niveau vers `datadog_flutter_plugin` v2.0 : ``` Semantic Issue (Xcode): Duplicate interface definition for class 'DatadogSdkPlugin' /Users/exampleuser/Projects/test_app/build/ios/Debug-iphonesimulator/datadog_flutter_plugin/datadog_flutter_plugin.framework/Headers/DatadogSdkPlugin.h:6:0 ``` -Essayez d'exécuter `flutter clean` && `flutter pub get`, puis relancez l'étape de build. Cela devrait résoudre le problème. +Essayez d'effectuer `flutter clean && flutter pub get` et de recompiler. Cela résout généralement le problème. -### Double classe (Android) +### Classes dupliquées (Android) {#duplicate-classes-android} -Si, après avoir installé la version 2.0 de `datadog_flutter_plugin`, vous rencontrez l'erreur suivante lors du build Android : +Si vous voyez cette erreur lors de la compilation d'Android après la mise à niveau vers `datadog_flutter_plugin` v2.0 : ``` FAILURE: Build failed with an exception. @@ -344,32 +872,32 @@ Execution failed for task ':app:checkDebugDuplicateClasses'. > A failure occurred while executing com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable ``` -Vérifiez que vous utilisez au minimum la version 1.8 de Kotlin dans votre fichier `build.gradle`. +Assurez-vous d'avoir mis à jour votre version de Kotlin vers au moins 1.8 dans votre fichier `build.gradle`. {{% /tab %}} {{< /tabs >}} -### Initialisation du SDK +### Initialisation du SDK {#sdk-initialization} {{< tabs >}} {{% tab "Android" %}} -Compte tenu de l'extraction de différentes solutions dans des modules indépendants, la configuration du SDK est organisée par module. +Avec l'extraction de différents produits dans des modules indépendants, la configuration du SDK est organisée par module. -La classe `com.datadog.android.core.configuration.Configuration.Builder` présente les modifications suivantes : +`com.datadog.android.core.configuration.Configuration.Builder` La classe présente les changements suivants : -* Le token client, le nom de l'environnement, le nom de la variante (la valeur par défaut est une chaîne vide) et le nom du service (la valeur par défaut est l'ID de l'application extrait du manifeste) doivent être fournis par le constructeur. -* La classe `com.datadog.android.core.configuration.Credentials` a été supprimée. -* `logsEnabled`, `tracesEnabled` et `rumEnabled` sont supprimés du constructeur au profit de la configuration individuelle des solutions (voir ci-dessous). -* L'argument de constructeur `crashReportsEnabled` a été supprimé. Vous pouvez activer ou désactiver les rapports de crash JVM à l'aide de la méthode `Configuration.Builder.setCrashReportsEnabled`. Par défaut, les rapports de crash JVM sont activés. -* Les méthodes de configuration des solutions RUM, de logs et de tracing sont supprimées de `Configuration.Builder` au profit d'une configuration individuelle des solutions (voir ci-dessous). +* Le jeton client, le nom de l'environnement, le nom de la variante (la valeur par défaut est une chaîne vide) et le nom du service (la valeur par défaut est l'ID d'application extrait du manifeste) doivent être fournis dans le constructeur. +* La classe `com.datadog.android.core.configuration.Credentials` est supprimée. +* `logsEnabled`, `tracesEnabled` et `rumEnabled` sont supprimés du constructeur au profit d'une configuration de produit individuelle (voir ci-dessous). +* `crashReportsEnabled` L'argument du constructeur est supprimé. Vous pouvez activer ou désactiver le rapport de plantage JVM avec la méthode `Configuration.Builder.setCrashReportsEnabled`. Par défaut, le rapport de plantage JVM est activé. +* Les méthodes de configuration des produits RUM, Logs et Trace sont supprimées de `Configuration.Builder` au profit de la configuration de produit individuelle (voir ci-dessous). -La classe `Credentials` a été supprimée de la liste d'arguments de la méthode `Datadog.initialize`. +La méthode `Datadog.initialize` n'inclut plus la classe `Credentials` dans la liste des arguments. -Le package `com.datadog.android.plugin` et toutes les classes/méthodes qui lui sont associées sont supprimés. +Le package `com.datadog.android.plugin` et toutes les classes/méthodes associées sont supprimés. -### Logs +### Logs {#logs-2} -Toutes les classes associées à la solution de logs sont contenues exclusivement dans le package `com.datadog.android.log`. +Toutes les classes liées au produit Logs sont strictement contenues dans le package `com.datadog.android.log`. Pour utiliser la fonctionnalité de logs, importez l'artefact suivant : @@ -377,7 +905,7 @@ Pour utiliser la fonctionnalité de logs, importez l'artefact suivant : implementation("com.datadoghq:dd-sdk-android-logs:x.x.x") ``` -Vous pouvez activer la solution de logs avec l'extrait de code suivant : +Vous pouvez activer le produit Logs avec l'extrait suivant : ```kotlin val logsConfig = LogsConfiguration.Builder() @@ -399,21 +927,21 @@ Modifications de l'API : |`com.datadog.android.core.configuration.Configuration.Builder.useCustomLogsEndpoint`|`com.datadog.android.log.LogsConfiguration.Builder.useCustomEndpoint`| |`com.datadog.android.log.Logger.Builder.setLoggerName`|`com.datadog.android.log.Logger.Builder.setName`| |`com.datadog.android.log.Logger.Builder.setSampleRate`|`com.datadog.android.log.Logger.Builder.setRemoteSampleRate`| -|`com.datadog.android.log.Logger.Builder.setDatadogLogsEnabled`|Cette méthode a été supprimée. Utilisez à la place `com.datadog.android.log.Logger.Builder.setRemoteSampleRate(0f)` pour désactiver l'envoi de logs à Datadog.| +|`com.datadog.android.log.Logger.Builder.setDatadogLogsEnabled`|Cette méthode a été supprimée. Utilisez `com.datadog.android.log.Logger.Builder.setRemoteSampleRate(0f)` à la place pour désactiver l'envoi de logs à Datadog.| |`com.datadog.android.log.Logger.Builder.setServiceName`|`com.datadog.android.log.Logger.Builder.setService`| |`com.datadog.android.log.Logger.Builder.setDatadogLogsMinPriority`|`com.datadog.android.log.Logger.Builder.setRemoteLogThreshold`| -### Trace +### Trace {#trace-2} -Toutes les classes associées à la solution de tracing sont contenues exclusivement dans le package `com.datadog.android.trace` (ce qui signifie que toutes les classes précédemment situées dans `com.datadog.android.tracing` ont été déplacées). +Toutes les classes liées au produit Trace sont strictement contenues dans le package `com.datadog.android.trace` (cela signifie que toutes les classes résidant auparavant dans `com.datadog.android.tracing` ont été déplacées). -Pour utiliser la solution de tracing, importez l'artefact suivant : +Pour utiliser le produit Trace, importez l'artefact suivant : ```kotlin implementation("com.datadoghq:dd-sdk-android-trace:x.x.x") ``` -Vous pouvez activer la solution de tracing avec l'extrait de code suivant : +Vous pouvez activer le produit Trace avec l'extrait suivant : ```kotlin val traceConfig = TraceConfiguration.Builder() @@ -438,11 +966,11 @@ Modifications de l'API : |`com.datadog.android.tracing.AndroidTracer.Builder.setSamplingRate`|`com.datadog.android.trace.AndroidTracer.Builder.setSampleRate`| |`com.datadog.android.tracing.AndroidTracer.Builder.setServiceName`|`com.datadog.android.trace.AndroidTracer.Builder.setService`| -### RUM +### RUM {#rum-2} -Toutes les classes associées à la solution RUM sont contenues exclusivement dans le package `com.datadog.android.rum`. +Toutes les classes liées au produit RUM sont strictement contenues dans le package `com.datadog.android.rum`. -Pour utiliser la solution RUM, importez l'artefact suivant : +Pour utiliser le produit RUM, importez l'artefact suivant : ```kotlin implementation("com.datadoghq:dd-sdk-android-rum:x.x.x") @@ -485,11 +1013,11 @@ Modifications de l'API : |`com.datadog.android.rum.GlobalRum.addAttribute`|`com.datadog.android.rum.RumMonitor.addAttribute`| |`com.datadog.android.rum.GlobalRum.removeAttribute`|`com.datadog.android.rum.RumMonitor.removeAttribute`| -### Rapports de crash NDK +### Rapport de crash NDK {#ndk-crash-reporting} -Le nom de l'artefact reste le même qu'avant : `com.datadoghq:dd-sdk-android-ndk:x.x.x`. +Le nom de l'artefact reste le même qu'auparavant : `com.datadoghq:dd-sdk-android-ndk:x.x.x`. -Vous pouvez activer les rapports de crash NDK avec l'extrait de code suivant : +Vous pouvez activer le rapport de crash NDK avec l'extrait suivant : ```kotlin NdkCrashReports.enable() @@ -497,45 +1025,45 @@ NdkCrashReports.enable() Cette configuration remplace l'appel `com.datadog.android.core.configuration.Configuration.Builder.addPlugin`. -**Remarque** : vous devez avoir activé la solution RUM et la solution de logs afin de recevoir des rapports de crash NDK dans les interfaces RUM et Logs respectivement. +**Note** : Vous devez avoir activé les produits RUM et Logs pour recevoir les rapports de crash NDK dans RUM et Logs respectivement. -### Suivi des vues Web +### Suivi WebView {#webview-tracking} -Le nom de l'artefact reste le même qu'avant : `com.datadoghq:dd-sdk-android-webview:x.x.x`. +Le nom de l'artefact reste le même qu'auparavant : `com.datadoghq:dd-sdk-android-webview:x.x.x` -Vous pouvez activer le suivi des vues Web avec l'extrait de code suivant : +Vous pouvez activer le suivi WebView avec l'extrait suivant : ```kotlin WebViewTracking.enable(webView, allowedHosts) ``` -**Remarque** : vous devez avoir activé la solution RUM et la solution de logs afin de recevoir les événements provenant des vues Web dans les interfaces RUM et Logs respectivement. +**Note** : Vous devez avoir activé les produits RUM et Logs pour recevoir les événements provenant de WebView dans RUM et Logs respectivement. Modifications de l'API : |`1.x`|`2.0`| |---|---| -|`com.datadog.android.webview.DatadogEventBridge`|Cette méthode est devenue une classe `internal`. Utilisez à la place `WebViewTracking`.| -|`com.datadog.android.rum.webview.RumWebChromeClient`|Cette classe a été supprimée. Utilisez à la place `WebViewTracking`.| -|`com.datadog.android.rum.webview.RumWebViewClient`|Cette classe a été supprimée. Utilisez à la place `WebViewTracking`.| +|`com.datadog.android.webview.DatadogEventBridge`|Cette méthode est devenue une classe `internal`. Utilisez `WebViewTracking` à la place.| +|`com.datadog.android.rum.webview.RumWebChromeClient`|Cette classe a été supprimée. Utilisez `WebViewTracking` à la place.| +|`com.datadog.android.rum.webview.RumWebViewClient`|Cette classe a été supprimée. Utilisez `WebViewTracking` à la place.| -### Suivi OkHttp +### Suivi OkHttp {#okhttp-tracking} -Pour utiliser le suivi OkHttp, importez l'artefact suivant : +Pour utiliser le suivi OkHttp, importez l'artefact suivant : ```kotlin implementation("com.datadoghq:dd-sdk-android-okhttp:x.x.x") ``` -L'instrumentation OkHttp prend en charge l'initialisation du SDK Datadog après le client OkHttp, ce qui vous permet de créer `com.datadog.android.okhttp.DatadogEventListener`, `com.datadog.android.okhttp.DatadogInterceptor` et `com.datadog.android.okhttp.trace.TracingInterceptor` avant le SDK Datadog. L'instrumentation OkHttp commence à transmettre des événements à Datadog après l'initialisation du SDK Datadog. +L'instrumentation OkHttp prend en charge l'initialisation du SDK Datadog après le client OkHttp, ce qui vous permet de créer `com.datadog.android.okhttp.DatadogEventListener`, `com.datadog.android.okhttp.DatadogInterceptor` et `com.datadog.android.okhttp.trace.TracingInterceptor` avant d'initialiser le SDK Datadog. L'instrumentation OkHttp commence à signaler les événements à Datadog une fois que le SDK Datadog est initialisé. -`com.datadog.android.okhttp.DatadogInterceptor` et `com.datadog.android.okhttp.trace.TracingInterceptor` vous permettent de contrôler l'échantillonnage de manière dynamique par le biais de l'intégration à un système de configuration à distance. +`com.datadog.android.okhttp.DatadogInterceptor` et `com.datadog.android.okhttp.trace.TracingInterceptor` vous permettent tous deux de contrôler l'échantillonnage de manière dynamique grâce à l'intégration avec un système de configuration à distance. -Pour ajuster l'échantillonnage de manière dynamique, fournissez votre propre implémentation de l'interface `com.datadog.android.core.sampling.Sampler` dans le constructeur `com.datadog.android.okhttp.DatadogInterceptor`/`com.datadog.android.okhttp.trace.TracingInterceptor`. Celle-ci est interrogée pour chaque requête afin de choisir ou non de procéder à un échantillonnage. +Pour ajuster dynamiquement l'échantillonnage, fournissez votre propre implémentation de l'interface `com.datadog.android.core.sampling.Sampler` dans le constructeur `com.datadog.android.okhttp.DatadogInterceptor`/`com.datadog.android.okhttp.trace.TracingInterceptor`. Il est interrogé pour chaque requête afin de prendre la décision d'échantillonnage. -### Suppression du module `dd-sdk-android-ktx` +### `dd-sdk-android-ktx` suppression du module {#dd-sdk-android-ktx-module-removal} -Pour améliorer la granularité des bibliothèques du SDK Datadog utilisées, le module `dd-sdk-android-ktx` a été supprimé. Le code est distribué entre les autres modules afin de fournir des méthodes d'extension pour les fonctionnalités RUM et de tracing. +Pour améliorer la granularité des SDK Datadog utilisés, le module `dd-sdk-android-ktx` est supprimé. Le code est réparti entre les autres modules pour fournir des méthodes d'extension pour les fonctionnalités RUM et Trace. | `1.x` | '2.0' | Nom du module | |-------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|-----------------------------------| @@ -555,22 +1083,23 @@ Pour améliorer la granularité des bibliothèques du SDK Datadog utilisées, le | `com.datadog.android.ktx.rum#java.io.InputStream.asRumResource` | `com.datadog.android.rum.resource#java.io.InputStream.asRumResource` | `dd-sdk-android-rum` | | `com.datadog.android.ktx.tracing#okhttp3.Request.Builder.parentSpan` | `com.datadog.android.okhttp.trace#okhttp3.Request.Builder.parentSpan` | `dd-sdk-android-okhttp` | -### Session Replay +### Session Replay {#session-replay-2} -Pour découvrir comment configurer Session Replay sur mobile, consultez la section [Installation et configuration de Session Replay sur mobile][4]. +Pour obtenir des instructions sur la configuration de Mobile Session Replay, consultez [Mobile Session Replay Setup and Configuration][6]. -[4]: /fr/real_user_monitoring/session_replay/mobile/setup_and_configuration/?tab=android +[6]: /fr/session_replay/setup_and_configuration/?platform=android {{% /tab %}} {{% tab "iOS" %}} -Compte tenu de l'extraction de différentes solutions dans des modules indépendants, la configuration du SDK est organisée par module. +Avec l'extraction de différents produits dans des modules indépendants, la configuration du SDK est organisée par module. + +> Le SDK doit être initialisé avant d'activer tout produit. -> Le SDK doit être initialisé avant d'activer toute solution. +Le modèle Builder de l'initialisation du SDK a été supprimé au profit de définitions de structures. L'exemple suivant montre comment une initialisation `1.x` se traduirait en `2.0`. -Le pattern Builder de l'initialisation du SDK a été supprimé au profit de définitions de structure. L'exemple suivant illustre les différences d'initialisation entre la version `1.x` et la version `2.0`. +**Initialisation V1** -**Initialisation (v1)** ```swift import Datadog @@ -579,21 +1108,22 @@ Datadog.initialize( trackingConsent: .granted, configuration: Datadog.Configuration .builderUsing( - clientToken: "", - environment: "" + clientToken: "", + environment: "" ) - .set(serviceName: "") + .set(serviceName: "") .build() ``` -**Initialisation (v2)** +**Initialisation V2** + ```swift import DatadogCore Datadog.initialize( with: Datadog.Configuration( - clientToken: "", - env: "", - service: "" + clientToken: "", + env: "", + service: "" ), trackingConsent: .granted ) @@ -611,9 +1141,9 @@ Modifications de l'API : |`Datadog.Configuration.Builder.set(serverDateProvider:)`|`Datadog.Configuration.serverDateProvider`| |`Datadog.AppContext(mainBundle:)`|`Datadog.Configuration.bundle`| -### Logs +### Logs {#logs-3} -Toutes les classes associées à la solution de logs sont contenues exclusivement dans le module `DatadogLogs`. Vous devez d'abord activer la solution : +Toutes les classes liées aux Logs se trouvent strictement dans le module `DatadogLogs`. Vous devez d'abord activer le produit : ```swift import DatadogLogs @@ -627,7 +1157,7 @@ Vous pouvez ensuite créer votre instance de logger : import DatadogLogs let logger = Logger.create( - with: Logger.Configuration(name: "") + with: Logger.Configuration(name: "") ) ``` @@ -646,9 +1176,9 @@ Modifications de l'API : |`Logger.Builder.set(datadogReportingThreshold:)`|`Logger.Configuration.remoteLogThreshold`| |`Logger.Builder.printLogsToConsole(_:, usingFormat)`|`Logger.Configuration.consoleLogFormat`| -### Trace +### Trace {#trace-3} -Toutes les classes associées à la solution de tracing sont contenues exclusivement dans le module `DatadogTrace`. Vous devez d'abord activer la solution : +Toutes les classes liées à Trace se trouvent strictement dans le module `DatadogTrace`. Vous devez d'abord activer le produit : ```swift import DatadogTrace @@ -658,7 +1188,7 @@ Trace.enable( ) ``` -Vous pouvez ensuite accéder à l'instance Tracer partagée : +Ensuite, vous pouvez accéder à l'instance partagée du Tracer : ```swift import DatadogTrace @@ -679,19 +1209,19 @@ Modifications de l'API : |`Tracer.Configuration.bundleWithRUM`|`Trace.Configuration.bundleWithRumEnabled`| |`Tracer.Configuration.samplingRate`|`Trace.Configuration.sampleRate`| -### RUM +### RUM {#rum-3} -Toutes les classes associées à la solution RUM sont contenues exclusivement dans le module `DatadogRUM`. Vous devez d'abord activer la solution : +Toutes les classes liées à RUM se trouvent strictement dans le module `DatadogRUM`. Vous devez d'abord activer le produit : ```swift import DatadogRUM RUM.enable( - with: RUM.Configuration(applicationID: "") + with: RUM.Configuration(applicationID: "") ) ``` -Vous pouvez ensuite accéder à l'instance de monitor RUM partagée : +Ensuite, vous pouvez accéder à l'instance partagée du monitor RUM : ```swift import DatadogRUM @@ -720,9 +1250,9 @@ Modifications de l'API : |`Datadog.Configuration.Builder.set(mobileVitalsFrequency:)`|`RUM.Configuration.vitalsUpdateFrequency`| |`Datadog.Configuration.Builder.set(sampleTelemetry:)`|`RUM.Configuration.telemetrySampleRate`| -### Rapports de crash +### Rapports de crash {#crash-reporting} -Pour activer les rapports de crash, veillez à activer la transmission des rapports aux solutions RUM et de logs respectivement. +Pour activer les rapports de crash, assurez-vous d'activer RUM et les Logs pour qu'ils rapportent respectivement à ces produits. ```swift import DatadogCrashReporting @@ -734,9 +1264,9 @@ CrashReporting.enable() |---|---| |`Datadog.Configuration.Builder.enableCrashReporting()`|`CrashReporting.enable()`| -### Suivi des vues Web +### Suivi WebView {#webview-tracking-1} -Pour activer le suivi des vues Web, veillez à activer également la transmission des rapports aux solutions RUM et de logs respectivement. +Pour activer le suivi WebView, assurez-vous également d'activer RUM et les Logs pour qu'ils rapportent respectivement à ces produits. ```swift import WebKit @@ -750,22 +1280,22 @@ WebViewTracking.enable(webView: webView) |---|---| |`WKUserContentController.startTrackingDatadogEvents`|`WebViewTracking.enable(webView:)`| -### Session Replay +### Session Replay {#session-replay-3} -Pour découvrir comment configurer Session Replay sur mobile, consultez la section [Installation et configuration de Session Replay sur mobile][5]. +Pour obtenir des instructions sur la configuration de Mobile Session Replay, consultez [Mobile Session Replay Setup and Configuration][7]. -[5]: /fr/real_user_monitoring/session_replay/mobile/setup_and_configuration/?tab=ios +[7]: /fr/session_replay/setup_and_configuration/?platform=ios {{% /tab %}} {{% tab "React Native" %}} -Aucune modification ne doit être apportée à l'initialisation du SDK. +Aucun changement dans l'initialisation du SDK n'est nécessaire. {{% /tab %}} {{% tab "Flutter" %}} -## Modifications de configuration des SDK +## Modifications de la configuration du SDK {#sdk-configuration-changes} Certaines propriétés de configuration ont été déplacées ou renommées, afin de prendre en charge la modularité dans les SDK natifs de Datadog. @@ -774,16 +1304,16 @@ Les structures suivantes ont été renommées : | `1.x` | `2.x` | |-------|-------| | `DdSdkConfiguration` | `DatadogConfiguration` | -| `LoggingConfiguartion` | `DatadogLoggingConfiguration` | +| `LoggingConfiguration` | `DatadogLoggingConfiguration` | | `RumConfiguration` | `DatadogRumConfiguration` | | `DdSdkExistingConfiguration` | `DatadogAttachConfiguration` | Les propriétés suivantes ont été modifiées : -| 1.x | 2.x | Remarques | +| 1.x | 2.x | Notes | |-------|-------|-------| -| `DdSdkConfiguration.trackingConsent`| Options supprimées | Intégré à `Datadog.initialize` | | -| `DdSdkConfiguration.customEndpoint` | Options supprimées | Désormais configuré au niveau de chaque fonctionnalité | | +| `DdSdkConfiguration.trackingConsent`| Supprimé | Fait partie de `Datadog.initialize` | | +| `DdSdkConfiguration.customEndpoint` | Supprimé | Désormais configuré par fonctionnalité | | | `DdSdkConfiguration.serviceName` | `DatadogConfiguration.service` | | | `DdSdkConfiguration.logEventMapper` | `DatadogLoggingConfiguration.eventMapper` | | | `DdSdkConfiguration.customLogsEndpoint` | `DatadogLoggingConfiguration.customEndpoint` | | @@ -791,19 +1321,19 @@ Les propriétés suivantes ont été modifiées : De plus, les API suivantes ont été modifiées : -| 1.x | 2.x | Remarques | +| 1.x | 2.x | Notes | |-------|-------|-------| -| `Verbosity` | Options supprimées | Voir `CoreLoggerLevel` ou `LogLevel` | -| `DdLogs DatadogSdk.logs` | `DatadogLogging DatadogSdk.logs` | Changement de type | -| `DdRum DatadogSdk.rum` | `DatadogRum DatadogSdk.rum` | Changement de type +| `Verbosity` | Supprimé | Voir `CoreLoggerLevel` ou `LogLevel` | +| `DdLogs DatadogSdk.logs` | `DatadogLogging DatadogSdk.logs` | Type modifié | +| `DdRum DatadogSdk.rum` | `DatadogRum DatadogSdk.rum` | Type modifié | `Verbosity DatadogSdk.sdkVerbosity` | `CoreLoggerLevel DatadogSdk.sdkVerbosity` | -| `DatadogSdk.runApp` | `DatadogSdk.runApp` | Paramètre `trackingConsent` ajouté | -| `DatadogSdk.initialize` | `DatadogSdk.initialize` | Paramètre `trackingConsent` ajouté | +| `DatadogSdk.runApp` | `DatadogSdk.runApp` | Ajout du paramètre `trackingConsent`| +| `DatadogSdk.initialize` | `DatadogSdk.initialize` | Ajout du paramètre `trackingConsent`| | `DatadogSdk.createLogger` | `DatadogLogging.createLogger` | Déplacé | -## Modifications apportées à Flutter Web +## Modifications de Flutter Web {#flutter-web-changes} -Les clients reposant sur Flutter Web doivent mettre à jour leur configuration afin d'utiliser la version 5 du SDK Browser Datadog. Modifiez l'importation suivante dans votre fichier `index.html` : +Les clients utilisant Flutter Web doivent passer au SDK Datadog Browser v5. Modifiez l'importation suivante dans votre `index.html` : ```diff - @@ -812,41 +1342,41 @@ Les clients reposant sur Flutter Web doivent mettre à jour leur configuration a + ``` -**Remarque** : Datadog fournit un lot CDN par site. Consultez le fichier [README du SDK Browser](https://github.com/DataDog/browser-sdk/#cdn-bundles) pour obtenir la liste de toutes les URL de site. +**Remarque** : Datadog fournit un bundle CDN par site. Consultez le [README du SDK Browser](https://github.com/DataDog/browser-sdk/#cdn-bundles) pour obtenir la liste de toutes les URL de site. -## Modifications apportées à la fonctionnalité de logs +## Modifications du produit Logs {#logs-product-changes} -Comme pour la v1, la journalisation Datadog peut être activée à l'aide du membre `DatadogConfiguration.loggingConfiguration`. Toutefois, Datadog ne crée plus le logger à votre place. `DatadogSdk.logs` est désormais une instance de `DatadogLogging`. Vous pouvez vous en servir pour créer vos logs. Un grand nombre d'options ont été déplacées vers `DatadogLoggerConfiguration`, afin que les développeurs puissent contrôler plus précisément chaque logger. +Comme pour la v1, la journalisation Datadog peut être activée en définissant le membre `DatadogConfiguration.loggingConfiguration`. Cependant, contrairement à la v1, Datadog ne crée pas de logger par défaut pour vous. `DatadogSdk.logs` est désormais une instance de `DatadogLogging`, qui peut être utilisée pour créer des logs. De nombreuses options ont été déplacées vers `DatadogLoggerConfiguration` pour offrir aux développeurs un contrôle plus granulaire sur les loggers individuels. Les API suivantes ont été modifiées : -| 1.x | 2.x | Remarques | +| 1.x | 2.x | Notes | |-------|-------|-------| -| `LoggingConfiguration` | `DatadogLoggingConfiguration` | La plupart des membres renommés se trouvent désormais dans `DatadogLoggerConfiguration` | +| `LoggingConfiguration` | `DatadogLoggingConfiguration` | Renommés, la plupart des membres se trouvent désormais sur `DatadogLoggerConfiguration` | | `LoggingConfiguration.sendNetworkInfo` | `DatadogLoggerConfiguration.networkInfoEnabled` | | | `LoggingConfiguration.printLogsToConsole` | `DatadogLoggerConfiguration.customConsoleLogFunction` | | -| `LoggingConfiguration.sendLogsToDatadog` | Supprimé, utiliser plutôt `remoteLogThreshold` | | +| `LoggingConfiguration.sendLogsToDatadog` | Supprimé. Utilisez `remoteLogThreshold` à la place | | | `LoggingConfiguration.datadogReportingThreshold` | `DatadogLoggerConfiguration.remoteLogThreshold` | | | `LoggingConfiguration.bundleWithRum` | `DatadogLoggerConfiguration.bundleWithRumEnabled` | | | `LoggingConfiguration.bundleWithTrace` | `DatadogLoggerConfiguration.bundleWithTraceEnabled` | | | `LoggingConfiguration.loggerName` | `DatadogLoggerConfiguration.name` | | | `LoggingConfiguration.sampleRate` | `DatadogLoggerConfiguration.remoteSampleRate` | | -## Modifications apportées à la solution RUM +## Modifications du produit RUM {#rum-product-changes} Les API suivantes ont été modifiées : -| 1.x | 2.x | Remarques | +| 1.x | 2.x | Notes | |-------|-------|-------| -| `RumConfiguration` | `DatadogRumConfiguration` | Changement de nom du type | -| `RumConfiguration.vitalsUpdateFrequency` | `DatadogRumConfiguration.vitalsUpdateFrequency` | Définir sur `null` pour désactiver la mise à jour des signaux essentiels | +| `RumConfiguration` | `DatadogRumConfiguration` | Type renommé | +| `RumConfiguration.vitalsUpdateFrequency` | `DatadogRumConfiguration.vitalsUpdateFrequency` | Définissez sur `null` pour désactiver les mises à jour des indicateurs vitaux | | `RumConfiguration.tracingSampleRate` | `DatadogRumConfiguration.traceSampleRate` | | `RumConfiguration.rumViewEventMapper` | `DatadogRumConfiguration.viewEventMapper` | | `RumConfiguration.rumActionEventMapper` | `DatadogRumConfiguration.actionEventMapper` | | `RumConfiguration.rumResourceEventMapper` | `DatadogRumConfiguration.resourceEventMapper` | | `RumConfiguration.rumErrorEventMapper` | `DatadogRumConfiguration.rumErrorEventMapper` | | `RumConfiguration.rumLongTaskEventMapper` | `DatadogRumConfiguration.longTaskEventMapper` | -| `RumUserActionType` | `RumActionType` | Changement de nom du type | +| `RumUserActionType` | `RumActionType` | Type renommé | | `DdRum.addUserAction` | `DdRum.addAction` | | | `DdRum.startUserAction` | `DdRum.startAction` | | | `DdRum.stopUserAction` | `DdRum.stopAction` | | @@ -854,7 +1384,7 @@ Les API suivantes ont été modifiées : | `DdRum.stopResourceLoading` | `DdRum.stopResource` | | | `DdRum.stopResourceLoadingWithError` | `DdRum.stopResourceWithError` | | -De plus, il n'est plus possible de modifier le nom des vues des mappers d'événements. Pour renommer une vue, utilisez plutôt un [`ViewInfoExtractor`](https://pub.dev/documentation/datadog_flutter_plugin/latest/datadog_flutter_plugin/ViewInfoExtractor.html) personnalisé. +De plus, les mappeurs d'événements ne vous permettent plus de modifier leurs noms de vue. Pour renommer une vue, utilisez plutôt un [`ViewInfoExtractor`](https://pub.dev/documentation/datadog_flutter_plugin/latest/datadog_flutter_plugin/ViewInfoExtractor.html) personnalisé. {{% /tab %}} @@ -862,8 +1392,6 @@ De plus, il n'est plus possible de modifier le nom des vues des mappers d'évén {{< /tabs >}} -## Pour aller plus loin - -{{< partial name="whats-next/whats-next.html" >}} +## Pour aller plus loin {#further-reading} -[1]: /fr/real_user_monitoring/session_replay/mobile/ \ No newline at end of file +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/guide/send-rum-custom-actions.md b/hugo/content/fr/real_user_monitoring/guide/send-rum-custom-actions.md index f91f7eee26b..d9115381084 100644 --- a/hugo/content/fr/real_user_monitoring/guide/send-rum-custom-actions.md +++ b/hugo/content/fr/real_user_monitoring/guide/send-rum-custom-actions.md @@ -1,4 +1,7 @@ --- +algolia: + tags: + - addaction aliases: - /fr/real_user_monitoring/guide/send-custom-user-actions/ beta: true @@ -8,21 +11,23 @@ further_reading: - link: /real_user_monitoring/explorer tag: Documentation text: Visualiser vos données RUM dans le RUM Explorer - +- link: https://learn.datadoghq.com/courses/custom-data-rum-javascript + tag: Centre d'apprentissage + text: Collectez des données personnalisées avec RUM pour les applications Web JavaScript private: true title: Envoyer des actions RUM personnalisées --- -## Présentation +## Présentation {#overview} -La solution Real User Monitoring [recueille automatiquement des actions][1] effectuées sur vos applications Web. Vous pouvez également recueillir des événements et des durées supplémentaires, par exemple pour le remplissage de formulaires et les transactions opérationnelles. +Le Real User Monitoring [collecte automatiquement les actions][1] sur votre application Web. Vous pouvez collecter des événements supplémentaires et des durées, tels que la soumission de formulaires et les transactions commerciales. -Les actions RUM personnalisées vous permettent de surveiller des événements pertinents tout en disposant de tous les éléments de contexte pertinents associés. Le SDK Browser de Datadog peut par exemple recueillir des informations sur le paiement d'un utilisateur (telles que le nombre d'articles dans le panier, la liste des articles et le montant des différents articles) lorsque celui-ci valide un paiement sur un site Web d'e-commerce. +Les actions RUM personnalisées vous permettent de surveiller des événements intéressants avec tout le contexte pertinent associé. Par exemple, le Datadog Browser SDK peut collecter les informations de checkout d'un utilisateur (telles que le nombre d'articles dans le panier, la liste des articles et la valeur totale des articles du panier) lorsqu'il clique sur le bouton de checkout sur un site e-commerce. -## Instrumenter votre code +## Instrumentez votre code {#instrument-your-code} -Créez une action RUM à l'aide de l'API `addAction`. Attribuez un nom à l'action et ajoutez-lui des attributs de contexte sous la forme d'un objet JavaScript. +Créez une action RUM à l'aide de `addAction` l'API. Donnez un nom à votre action et joignez des attributs de contexte sous la forme d'un objet JavaScript. -L'exemple suivant permet de créer une action `checkout` incluant des informations à propos du panier de l'utilisateur lorsqu'il clique sur le bouton de paiement. +L'exemple suivant crée une action `checkout` avec des détails sur le panier de l'utilisateur lorsque celui-ci clique sur le bouton de checkout. {{< tabs >}} {{% tab "NPM" %}} @@ -32,40 +37,40 @@ import { datadogRum } from '@datadog/browser-rum'; function onCheckoutButtonClick(cart) { datadogRum.addAction('checkout', { - 'value': cart.value, // par exemple, 42,12 - 'items': cart.items, // par exemple, ['tomate', 'fraises'] + 'value': cart.value, // for example, 42.12 + 'items': cart.items, // for example, ['tomato', 'strawberries'] }) } ``` {{% /tab %}} -{{% tab "CDN asynchrone" %}} +{{% tab "CDN async" %}} -Assurez-vous d'incorporer l'appel API avec le rappel `onReady` : +Assurez-vous d'encapsuler l'appel d'API avec le rappel `onReady` : ```javascript function onCheckoutButtonClick(cart) { window.DD_RUM.onReady(function() { window.DD_RUM.addAction('checkout', { - 'value': cart.value, // par exemple, 42.12 - 'items': cart.items, // par exemple, ['tomato', 'strawberries'] + 'value': cart.value, // for example, 42.12 + 'items': cart.items, // for example, ['tomato', 'strawberries'] }) }) } ``` {{% /tab %}} -{{% tab "CDN synchrone" %}} +{{% tab "CDN sync" %}} -Assurez-vous de vérifier `window.DD_RUM` avant de procéder à l'appel API : +Assurez-vous de vérifier `window.DD_RUM` avant l'appel d'API : ```javascript -window.DD_RUM && window.DD_RUM.addAction('', ''); +window.DD_RUM && window.DD_RUM.addAction('', ''); function onCheckoutButtonClick(cart) { window.DD_RUM && window.DD_RUM.addAction('checkout', { - 'value': cart.value, // par exemple, 42.12 - 'items': cart.items, // par exemple, ['tomato', 'strawberries'] + 'value': cart.value, // for example, 42.12 + 'items': cart.items, // for example, ['tomato', 'strawberries'] }) } ``` @@ -75,32 +80,32 @@ function onCheckoutButtonClick(cart) { Tout le contexte RUM, comme les informations sur l'affichage de la page en cours, les données geoIP et les informations sur le navigateur, est automatiquement associé. De plus, des attributs supplémentaires sont fournis via l'[API de contexte global][2]. -## Créer des facettes et des mesures sur les attributs +## Créez des facettes et des mesures sur les attributs {#create-facets-and-measures-on-attributes} -Après avoir déployé le code qui crée vos actions personnalisées, ces dernières s'affichent dans l'onglet **Actions** du [RUM Explorer][3]. +Après avoir déployé le code qui crée vos actions personnalisées, celles-ci apparaissent dans l'onglet {{< ui >}}Actions{{< /ui >}} du RUM Explorer [3]. -Pour filtrer vos actions personnalisées, utilisez l'attribut `Action Target Name` : `@action.target.name:`. +Pour filtrer vos actions personnalisées, utilisez l'attribut `Action Target Name` : `@action.target.name:`. -Dans l'exemple ci-dessous, le filtre `@action.target.name:checkout` est appliqué. +L'exemple ci-dessous utilise le filtre suivant : `@action.target.name:checkout`. -{{< img src="real_user_monitoring/guide/send-custom-user-actions/facet-from-user-action.mp4" alt="Créer une facette pour des actions RUM personnalisées" video=true style="width:100%;">}} +{{< img src="real_user_monitoring/guide/send-custom-user-actions/facet-from-user-action-3.mp4" alt="Créez une facette pour les actions RUM personnalisées" video=true style="width:100%;">}} -Lorsque vous cliquez sur une action, un volet latéral présentant des métadonnées s'affiche. Les attributs de vos actions se trouvent à la section **Custom Attributes**. Cliquez sur un attribut pour créer une facette ou une mesure. +Après avoir cliqué sur une action, un panneau latéral contenant des métadonnées s'affiche. Vous pouvez trouver les attributs de votre action dans la section {{< ui >}}Custom Attributes{{< /ui >}} et créer des facettes ou des mesures pour ces attributs en cliquant dessus. -Les facettes permettent d'utiliser des valeurs distinctives (comme des ID), tandis que les mesures sont dédiées aux valeurs quantitatives (comme des durées ou une latence). Vous pouvez par exemple créer une facette pour les articles du panier et une mesure pour la valeur du panier. +Utilisez des facettes pour les valeurs distinctives (ID) et des mesures pour les valeurs quantitatives telles que les durées et la latence. Par exemple, créez une facette pour les articles du panier et une mesure pour la valeur du panier. -## Utiliser des attributs dans le RUM Explorer +## Utilisez des attributs dans le RUM Explorer {#use-attributes-in-the-rum-explorer} Vous pouvez utiliser des attributs d'action, ainsi que des facettes et mesures, dans le [RUM Explorer][3] pour créer des widgets de dashboard, des monitors et des requêtes avancées. -L'exemple suivant permet d'afficher la valeur moyenne du panier par pays au cours des deux derniers jours. Cliquez sur le bouton **Export** pour exporter la requête de recherche au sein d'un widget de dashboard ou d'un monitor. +L'exemple suivant affiche la valeur moyenne du panier par pays au cours des deux derniers jours. Cliquez sur le bouton {{< ui >}}Export{{< /ui >}} pour exporter la requête de recherche vers un widget de dashboard ou un monitor. -{{< img src="real_user_monitoring/guide/send-custom-user-actions/custom-action-analytics.png" alt="Utiliser des actions RUM dans le RUM Explorer" style="width:100%;">}} +{{< img src="real_user_monitoring/guide/send-custom-user-actions/custom-action-analytics-2.png" alt="Utilisez les actions RUM dans le RUM Explorer" style="width:100%;">}} -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} -[1]: /fr/real_user_monitoring/browser/data_collected/?tab=useraction#automatic-collection-of-actions -[2]: /fr/real_user_monitoring/browser/modifying_data_and_context/#replace-global-context +[1]: /fr/real_user_monitoring/application_monitoring/browser/data_collected/?tab=useraction#action-attributes +[2]: /fr/real_user_monitoring/application_monitoring/browser/advanced_configuration/#replace-global-context [3]: /fr/real_user_monitoring/explorer \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/guide/session-replay-for-solutions.md b/hugo/content/fr/real_user_monitoring/guide/session-replay-for-solutions.md new file mode 100644 index 00000000000..e6e319899a9 --- /dev/null +++ b/hugo/content/fr/real_user_monitoring/guide/session-replay-for-solutions.md @@ -0,0 +1,75 @@ +--- +description: Apprenez à adopter RUM et Session Replay dans votre organisation Solutions + ou Support. +further_reading: +- link: /real_user_monitoring/correlate_with_other_telemetry/apm/ + tag: Documentation + text: Apprenez à connecter RUM avec les traces APM. +- link: /session_replay/ + tag: Documentation + text: En savoir plus sur Session Replay +- link: /session_replay/dev_tools + tag: Documentation + text: Découvrez les outils de développement du navigateur +title: Intégrer Session Replay à vos workflows d'assistance +--- +## Présentation {#overview} + +Vous pouvez permettre à vos équipes de solutions techniques et de support de mieux résoudre les problèmes des clients en utilisant [Session Replay][1]. Avec RUM et Session Replay, vous pouvez localiser des sessions utilisateur spécifiques, observer les parcours utilisateur et accéder aux outils de développement pour voir les événements, les logs, les erreurs et les attributs. + +Ce guide décrit un workflow que les organisations peuvent reproduire et utiliser comme atout pour que leurs équipes de solutions techniques l'intègrent dans leurs processus. + +{{< img src="real_user_monitoring/guide/session-replay/session-replay-recording.png" alt="Enregistrement d'une session utilisateur avec Session Replay dans l'application Shopist" style="width:100%;">}} + +## Évaluez les problèmes utilisateur {#assess-user-issues} + +Supposons qu'un client rencontre un problème en utilisant Datadog. Votre équipe de solutions techniques peut utiliser une solution de support, telle que Zendesk ou ServiceNow, qui crée un ticket lorsque ce client signale qu'il ne peut pas mettre à jour ou enregistrer un test API à plusieurs étapes Synthetics. + +L'équipe peut demander plus d'informations au client (telles que l'ID spécifique du test et un enregistrement d'écran avec les [Browser Dev Tools][2] ouverts) qui pourraient fournir un contexte supplémentaire sur le fait que le test du client ne se met pas à jour ou ne s'enregistre pas. Si aucune erreur de console n'a été enregistrée, l'équipe n'aurait aucun indice pour commencer à enquêter sur le problème du test API à plusieurs étapes. + +L'équipe de solutions techniques peut essayer de comprendre les questions suivantes : + +- Quelle est l'erreur exacte que rencontre le client ? +- Le client voit-il une notification dans l'application qui indique un problème particulier (tel qu'une erreur de console ou un message d'erreur) ? +- Sur quels boutons le client a-t-il cliqué, et dans quel ordre ? Une action inattendue s'est-elle produite avant que le client ne clique sur un bouton ? + +## Rechercher la cause première {#investigate-the-root-cause} + +S'il existait un moyen de visualiser le parcours utilisateur du client dans Datadog et de voir les requêtes backend associées, l'équipe de solutions techniques aurait une meilleure compréhension de ce qui pourrait causer ce problème. + +{{< img src="real_user_monitoring/guide/session-replay/apm-traces-in-session-replay.png" alt="Une trace de pile APM associée à une action de vue RUM" style="width:100%;">}} + +Grâce à l'intégration APM, vous pouvez connecter les requêtes de votre application web aux traces backend correspondantes pour accéder aux données de trace APM à partir d'un événement RUM et découvrir toute erreur backend dans l'onglet {{< ui >}}Errors{{< /ui >}}. + +Pour plus d'informations, consultez [Connecter RUM et les traces][3]. + +## Regardez les sessions utilisateur dans Session Replay {#watch-user-sessions-in-session-replay} + +L'équipe de solutions techniques peut disposer d'outils internes qui connectent une plateforme de support, comme Zendesk, aux produits Datadog, tels que RUM & Session Replay. Par exemple, un lien contextuel dans Zendesk peut vous rediriger vers l'[Explorer RUM][4] et remplir automatiquement l'ID utilisateur dans la requête de recherche. Filtrez les sessions utilisateur individuelles à partir de la liste des événements. + +L'équipe de solutions techniques peut utiliser Session Replay pour voir une réplique du parcours utilisateur dans Datadog et utiliser les outils de développement du navigateur pour accéder aux erreurs supplémentaires qui peuvent apparaître dans le frontend. Avec l'accès aux erreurs du frontend et aux traces backend, votre équipe de solutions techniques est en mesure d'utiliser l'intégration RUM & Session Replay et APM pour aider à résoudre les problèmes des clients. + +Cliquez sur une session utilisateur avec un enregistrement de relecture pour observer le comportement de l'utilisateur sur la plateforme Datadog. En utilisant Session Replay, vous pouvez localiser les événements RUM correspondants et identifier l'action `click` spécifique pour enregistrer le test API à plusieurs étapes. Cliquer sur {{< ui >}}Save{{< /ui >}} dans l'interface utilisateur déclenche l'appel backend pour enregistrer la configuration du test. + +## Découvrez les erreurs dans les traces backend {#uncover-errors-in-backend-traces} + +Lors de l'examen des erreurs dans la trace APM des tests API à plusieurs étapes, l'équipe de solutions techniques peut rencontrer une `APIInvalidInputError` liée à la `maxLength` d'une configuration `​​https://properties.steps.items.properties.name/`, qui semble être la cause première de l'échec de l'enregistrement du test. + +{{< img src="real_user_monitoring/guide/session-replay/view-traces.png" alt="Une trace de pile APM associée à une action de vue RUM" style="width:100%;">}} + +Le test API à plusieurs étapes ne s'est pas enregistré en raison d'une limite de caractères dans le nom de l'étape. + +## Résolvez les problèmes des utilisateurs {#resolve-user-problems} + +Pour résoudre ce problème client, l'équipe de solutions techniques peut demander à l'équipe Produit de mettre à jour le workflow du test API à plusieurs étapes avec une aide contextuelle pour les cas où un test ne peut pas être enregistré. + +L'équipe Frontend peut également être encouragée à implémenter un message d'erreur dans l'interface utilisateur qui garantit que les utilisateurs sont avertis lorsqu'ils dépassent la limite maximale de caractères pour le nom de l'étape du test. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/session_replay/ +[2]: /fr/session_replay/dev_tools +[3]: /fr/real_user_monitoring/connect_rum_and_traces +[4]: https://app.datadoghq.com/rum/explorer \ No newline at end of file diff --git a/hugo/content/fr/real_user_monitoring/guide/session-replay-service-worker.md b/hugo/content/fr/real_user_monitoring/guide/session-replay-service-worker.md index 69c8f59c71a..4781f3cd7f5 100644 --- a/hugo/content/fr/real_user_monitoring/guide/session-replay-service-worker.md +++ b/hugo/content/fr/real_user_monitoring/guide/session-replay-service-worker.md @@ -1,38 +1,38 @@ --- aliases: - /fr/real_user_monitoring/faq/session_replay_service_worker/ +description: Configurez les autorisations de service worker tiers pour Session Replay + afin de garantir des performances optimales et la sécurité des données. further_reading: -- link: /real_user_monitoring/session_replay/browser/ +- link: /session_replay/ tag: Documentation text: En savoir plus sur Session Replay - title: Autoriser les workers de services tiers pour Session Replay --- +## Présentation {#overview} -## Présentation - -La solution Session Replay a recours à un worker de service sur le domaine `session-replay-datadoghq.com` pour optimiser votre expérience ainsi que protéger votre confidentialité et vos données. +Session Replay utilise un service worker dans un autre domaine `session-replay-datadoghq.com` pour offrir la meilleure expérience possible tout en protégeant votre vie privée et en garantissant la sécurité de vos données. Si vous avez bloqué les cookies tiers dans les paramètres de votre navigateur, ou si votre navigateur les bloque par défaut, le worker de service ne peut pas s'enregistrer correctement. -### Ajouter une exception +### Autoriser une exception {#allow-an-exception} Datadog vous recommande d'ajouter une exception à votre liste de blocage des cookies tiers, afin que le worker de service de Session Replay puisse fonctionner correctement. -Si vous utilisez Google Chrome, suivez les instructions ci-dessous. Le processus est similaire pour Firefox et les autres navigateurs de bureau, notamment Brave et Edge. +Si vous utilisez Google Chrome, suivez les instructions ci-dessous. Ce workflow d'exception s'applique également à Firefox et aux autres navigateurs de bureau, notamment Brave et Edge. -1. Dans votre navigateur Web, cliquez sur l'icône en forme de **cadenas** à gauche de l'URL de la page. -2. Cliquez sur **Cookies**. Une fenêtre contextuelle s'affiche alors. +1. Dans votre navigateur web, cliquez sur l'icône {{< ui >}}Lock{{< /ui >}} à gauche de l'URL de la page. +2. Cliquez sur {{< ui >}}Cookies{{< /ui >}}. Une fenêtre modale contextuelle apparaît. - {{< img src="real_user_monitoring/session_replay/allow-3p-serviceworker-1.png" alt="Autoriser le worker de service tiers pour Session Replay" >}} + {{< img src="real_user_monitoring/session_replay/allow-3p-serviceworker-1.png" alt="Autoriser le service worker tiers de Session Replay" >}} -3. Accédez à l'onglet **Blocked** et sélectionnez `session-replay-datadoghq.com` dans la liste des pages. -4. Cliquez sur **Allow** et sur **Done**. +3. Accédez à l'onglet {{< ui >}}Blocked{{< /ui >}} et sélectionnez `session-replay-datadoghq.com` dans la liste des pages. +4. Cliquez sur {{< ui >}}Allow{{< /ui >}} et {{< ui >}}Done{{< /ui >}}. - {{< img src="real_user_monitoring/session_replay/allow-3p-serviceworker-2.png" alt="Autoriser le worker de service tiers pour Session Replay" >}} + {{< img src="real_user_monitoring/session_replay/allow-3p-serviceworker-2.png" alt="Autoriser le service worker tiers de Session Replay" >}} Après avoir modifié vos paramètres de cookies, actualisez la page. -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/agentic_onboarding.md b/hugo/content/fr/security/application_security/agentic_onboarding.md new file mode 100644 index 00000000000..b971f31f78a --- /dev/null +++ b/hugo/content/fr/security/application_security/agentic_onboarding.md @@ -0,0 +1,6 @@ +--- +description: Instrumentez vos applications avec App and API Protection en utilisant + AI Setup CLI ou Datadog MCP Server. +title: Agentic Onboarding for App and API Protection +--- +{{< include-markdown "agentic_onboarding/setup" >}} \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/api_posture/api_findings.md b/hugo/content/fr/security/application_security/api_posture/api_findings.md index ee89cecb4e9..63b10e48799 100644 --- a/hugo/content/fr/security/application_security/api_posture/api_findings.md +++ b/hugo/content/fr/security/application_security/api_posture/api_findings.md @@ -3,13 +3,7 @@ description: Le triage a détecté des risques API dans les définitions, les pa et le trafic en direct. title: API Findings --- -{{< site-region region="gov" >}} -
-App and API Protection est en préversion sur le site Datadog Government US1-FED. -
-{{< /site-region >}} - -L'explorateur [API Findings][1] fournit une vue de triage centralisée des risques API détectés dans vos définitions, passerelles et trafic en direct. Les règles par défaut détectent les vulnérabilités et les erreurs de configuration courantes. Vous pouvez également ajouter des [règles personnalisées][2] pour des cas d'utilisation spécifiques. +L'Explorer [API Findings][1] fournit une vue de triage centralisée des risques API détectés dans vos définitions, passerelles et trafic en direct. Les règles par défaut détectent les vulnérabilités et les erreurs de configuration courantes. Vous pouvez également ajouter des [règles personnalisées][2] pour des cas d'utilisation spécifiques. Colonnes des **API Findings** : @@ -27,7 +21,7 @@ Cliquez sur une découverte pour afficher ses détails et effectuer un workflow - Examinez {{< ui >}}What Happened{{< /ui >}} et {{< ui >}}Detected In{{< /ui >}} pour confirmer que la détection est exacte (service, endpoint, méthode). - Dans {{< ui >}}Next Steps{{< /ui >}}, choisissez de {{< ui >}}Mute{{< /ui >}}, {{< ui >}}Create Ticket{{< /ui >}} ou {{< ui >}}Run Workflow{{< /ui >}} selon la propriété et l'impact. 2. Enquêter: - - Utilisez l'onglet {{< ui >}}Context{{< /ui >}} pour examiner l'instantané et les attributs du endpoint (méthode, chemin, indicateurs d'authentification, balises). + - Utilisez l'onglet {{< ui >}}Context{{< /ui >}} pour examiner l'instantané et les attributs du endpoint (méthode, chemin, indicateurs d'authentification, tags). - {{< ui >}}Detected In{{< /ui >}} fournit des informations pour le routage de la propriété et de la remédiation. - Dans {{< ui >}}Detection Rule Query{{< /ui >}}, vous pouvez modifier une règle de découverte d'API en cliquant sur {{< ui >}}See Detection Rule{{< /ui >}}. 3. Corriger: diff --git a/hugo/content/fr/security/application_security/api_posture/api_inventory/api_endpoints.md b/hugo/content/fr/security/application_security/api_posture/api_inventory/api_endpoints.md new file mode 100644 index 00000000000..55d48e12086 --- /dev/null +++ b/hugo/content/fr/security/application_security/api_posture/api_inventory/api_endpoints.md @@ -0,0 +1,253 @@ +--- +description: Surveillez le trafic des API pour évaluer le risque des endpoints, l'authentification, + les flux de données sensibles et l'exposition. +title: Endpoints API +--- +L'Explorer [API Endpoints][1] surveille le trafic des API pour offrir une visibilité sur la posture de sécurité de vos API, notamment : + +- **Authentification** : Si l'API impose une authentification. +- **Méthode d'authentification** : Type d'authentification utilisé, tel que l'authentification de base (Basic Auth) et la clé d'API. +- **Exposition publique** : Si l'API traite du trafic provenant d'Internet. +- **Flux de données sensibles** : Données sensibles traitées par l'API et les flux entre les API. +- **Exposition aux attaques** : Si l'endpoint est ciblé par des attaques. +- **Logique métier** : Logique métier et suggestions de logique métier associées pour cette API. +- **Vulnérabilités** : Si l'endpoint contient une vulnérabilité (propulsé par [Code Security][2] et [Software Composition Analysis][3]). +- **Résultats** : Résultats de sécurité identifiés sur cette API. +- **Dépendances** : APIs et bases de données dont dépend l'API. + +En utilisant les endpoints API, vous pouvez : + +- Voir quels endpoints traitent des données sensibles, sont authentifiés, présentent des vulnérabilités ou des résultats, ou sont accessibles publiquement. +- Voir quels endpoints sont à risque et basculer directement vers le service [Threat Monitoring and Protection][4] pour une enquête ou une réponse plus approfondie. +- Voir quels endpoints sont associés à la logique métier de votre entreprise et trouver des suggestions de logique métier basées sur l'historique du trafic de votre endpoint. + +## Configuration {#configuration} + +Pour afficher les endpoints d'API sur vos services, **vous devez avoir activé la fonctionnalité App and API Protection Threat Detection**. + +Pour l'intégration d'Amazon Web Services (AWS) API Gateway, vous devez configurer ce qui suit : + +- [Amazon Web Services][5] +- [Amazon API Gateway Integration][6] + +Les endpoints API sont découverts à partir du catalogue Datadog et plus précisément à partir des définitions d'API [téléversées sur Datadog][7]. Pour obtenir des instructions sur le téléversement des définitions d'API, consultez [Créer des entités][8]. + +Pour plus d'informations sur les versions de bibliothèque compatibles avec l'inventaire des API, consultez [Activation de la protection des applications et des API][9]. [Remote Configuration][10] est requis. + +|Technologie|Version minimale du traceur| Prise en charge de l'analyse des données sensibles | +|----------|----------|----------| +|Python | v2.1.6 | Requêtes et réponses | +|Java | v1.31.0 | Requêtes uniquement | +|PHP | v0.98.0 | Requêtes et réponses | +|.NET Core | v2.42.0 | Requêtes et réponses | +|.NET Fx | v2.47.0 | Requêtes et réponses | +|Ruby | v1.15.0 | Requêtes uniquement | +|Golang | v1.59.0 | Requêtes uniquement | +|Node.js | v3.51.0, v4.30.0 ou v5.6.0 | Requêtes et réponses | + +**Remarque** : Sur les traceurs .NET Core et .NET Fx, vous devez définir la variable d'environnement `DD_API_SECURITY_ENABLED=true` pour que les fonctionnalités de sécurité des API fonctionnent correctement. + +## Fonctionnement {#how-it-works} + +API Endpoints collecte des métadonnées de sécurité sur le trafic API en utilisant le SDK Datadog avec App and API Protection activé, ainsi que les configurations d'Amazon API Gateway et les définitions d'API téléversées. Ces données incluent le schéma d'API découvert, les types de données sensibles (PII) traitées et le schéma d'authentification utilisé. Les informations sur l'API sont évaluées en continu, ce qui permet de garantir une vue complète et à jour de toute votre surface d'attaque API. + +API Endpoints utilise [Remote Configuration][10] pour gérer et configurer les règles d'analyse qui détectent les données sensibles et l'authentification. + +Pour vérifier si les endpoints découverts sont accessibles publiquement et nécessitent une authentification, activez l'[Analyse des endpoints][11]. L'analyse des endpoints analyse activement les endpoints éligibles et enrichit l'inventaire des API avec l'accessibilité publique vérifiée, le statut d'authentification, le statut de réponse HTTP et les dernières données d'évaluation. + +Les risques suivants sont calculés pour chaque endpoint. + +## Sources de données {#data-sources} + +Dans l'Explorer [API Endpoints][1], les {{< ui >}}Data Sources{{< /ui >}} indiquent l'origine de la visibilité. + +Les sources de données suivantes sont explorées. + +### Amazon API Gateway {#amazon-api-gateway} + +
Pour désactiver cette intégration pour une API spécifique, ajoutez le dd_skip_endpoint:true tag à la ressource.
+ +Le service Amazon API Gateway définit formellement la structure de votre API. L'intégration AWS de Datadog lit cette configuration prédéfinie depuis Amazon API Gateway, puis Datadog utilise cette configuration pour créer des entrées d'endpoint d'API dans {{< ui >}}Inventory{{< /ui >}}. + +Utilisez {{< ui >}}AWS API Gateway{{< /ui >}} dans {{< ui >}}Data Source{{< /ui >}} pour obtenir une visibilité sur ces endpoints exposés. Vous pouvez également utiliser la requête `datasource:aws_apigateway`. + +### Catalog {#catalog} + +La source de données {{< ui >}}Catalog{{< /ui >}} affiche les endpoints d'API que Datadog a identifiés à partir de la spécification formelle téléchargée dans Datadog. La spécification d'API est jointe à, ou enregistrée en tant que, composant d'API dédié au sein de l'entité de service IDP. + +Cette source garantit que votre inventaire d'API est complet en incluant tous les endpoints prévus et formellement documentés. + +### Traces APM {#apm-traces} + +La source de données {{< ui >}}Spans{{< /ui >}} affiche le trafic réel et l'exposition des données. La remédiation doit être effectuée immédiatement dans le code, la configuration ou les contrôles d'accès. + +Les mesures que vous prenez dépendent de la surface d'attaque : + +- **Vulnérabilités :** Corrigez toutes les bibliothèques vulnérables mises en évidence par SCA ou Runtime Code Analysis, puis redéployez le service. +- **Résultats d'API découverts :** Examinez chaque problème dans le contexte du service tracé, corrigez tout code ou configuration, puis validez à l'aide de nouvelles traces. +- **Traitement des données sensibles :** Confirmez que le traitement des données est conforme à la politique, nettoyez ou chiffrez les PII et limitez l'accès aux services nécessaires. +- **Endpoint non authentifié :** Si l'endpoint n'est pas intentionnellement public, appliquez l'authentification et mettez à jour les configurations du service. + +### Découverte statique d'endpoints {#static-endpoint-discovery} + +
La découverte statique d'endpoints est en préversion.
+ +{{< site-region region="gov,gov2" >}} +
La découverte statique d'endpoints n'est pas disponible pour le {{< region-param key="dd_site_name" >}} site.
+{{< /site-region >}} + +La source de données {{< ui >}}Source Code{{< /ui >}} affiche les endpoints d'API découverts directement à partir de votre code source. Cela complète la découverte basée sur l'exécution en faisant apparaître les endpoints plus tôt dans le cycle de vie du développement, y compris les endpoints qui peuvent ne pas recevoir de trafic en direct. + +Pour utiliser cette source de données, configurez l'[Intégration du code source][12] avec GitHub, GitLab ou Azure DevOps. Les langages et frameworks suivants sont pris en charge : + +| Langage | Framework | +|----------|-----------| +| Python | FastAPI, Flask, Tornado | +| Java | Spring | +| Go | Beego, Chi, Echo, Fiber, Gin, Gorilla Mux, fasthttp, go-zero | +| C# | ASP.NET Core MVC | +| Node.js | Express, Fastify | + +Pour filtrer les endpoints du code source, utilisez {{< ui >}}Source Code{{< /ui >}} dans la facette {{< ui >}}Data Source{{< /ui >}} ou la requête `datasource:source_code`. Les analyses sont exécutées lorsque le code est envoyé vers la branche par défaut et selon un planning récurrent de 8 heures. Les endpoints découverts sont supprimés après 12 heures s'ils ne sont pas redécouverts lors d'une analyse ultérieure. + +#### Mapper les endpoints du code source aux services {#map-source-code-endpoints-to-services} + +La découverte statique d'endpoints utilise des heuristiques pour déduire à quel service appartient un endpoint. Pour un mappage plus précis, définissez explicitement les relations service-code en utilisant le champ `codeLocations` dans votre [définition de service de catalogue (schéma v3)][13] : + +```yaml +apiVersion: v3 +kind: service +metadata: + name: my-service + owner: my-team +datadog: + codeLocations: + - repositoryURL: https://github.com/org/myrepo.git + paths: + - path/to/service/code/** +``` + +Sans `codeLocations` explicite, les endpoints peuvent ne pas fusionner correctement avec les données provenant d'autres sources. + +## Afficher et comparer les schémas des endpoints {#view-and-compare-endpoint-schemas} + +API Posture construit un schéma OpenAPI pour chaque endpoint à partir du trafic qu'il observe. Ce schéma **déduit** décrit ce que votre API expose en production : ses chemins, ses paramètres, ses corps de requête et de réponse, ainsi que son authentification. Lorsque votre équipe publie également un schéma **déclaré**, une définition OpenAPI enregistrée dans le Datadog Software Catalog, vous pouvez comparer les deux pour découvrir où l'API en cours d'exécution a divergé de sa documentation. + +### Afficher le schéma d'un endpoint {#view-an-endpoints-schema} + +Dans [API Endpoints][1], cliquez sur un endpoint pour ouvrir son panneau de détails. La section **Définition** affiche les paramètres de requête, le corps de la requête et les réponses de l'endpoint. Les champs contenant des données sensibles sont marqués avec le type de données sensibles observé. + +{{< img src="/security/application_security/api/api_endpoint_definition_schema_cropped.png" alt="La section Définition du panneau de détails d'un endpoint, affichant ses paramètres de requête ainsi que les boutons Voir le schéma brut et Voir les schémas déduits" style="width:100%;" >}} + +Lorsque l'endpoint est associé à une API dans le Datadog Software Catalog, la section **Définition** affiche la spécification OpenAPI déclarée. Sinon, elle affiche le schéma déduit du trafic en direct. + +Dans la section **Définition**, vous pouvez : + +- {{< ui >}}View Raw Schema{{< /ui >}} : Voir le schéma affiché sous forme de YAML brut. +- {{< ui >}}View Inferred Schemas{{< /ui >}} : Voir le schéma déduit du trafic en direct sous forme d'aperçu ou de YAML, même lorsqu'un schéma déclaré est disponible. Le schéma déduit peut être exporté en tant que fichier OpenAPI au format YAML ou JSON. + +Pour réduire le bruit, le schéma déduit n'inclut que les champs observés au moins trois fois et supprime les champs qui n'ont pas été observés à nouveau dans les 7 jours. Cela évite que le trafic ponctuel, tel qu'une requête mal formée unique ou un attaquant sondant un endpoint avec un champ inattendu, ne pollue le schéma déduit. Sinon, cela pourrait apparaître comme une dérive lors de la comparaison avec le schéma déclaré. + +### Comparer les schémas déclarés et déduits {#compare-declared-and-inferred-schemas} + +Pour comparer les schémas déduits et déclarés, vous devez : + +- [Activer la protection des applications et des API][9] sur le service afin que les endpoints soient découverts à partir du trafic en direct. +- Enregistrez la définition OpenAPI du schéma déclaré dans le Datadog Software Catalog. Voir [Créer des entités][8]. + +Les différences de schéma apparaissent directement dans la vue du schéma de l'endpoint, mises en évidence selon leur gravité : + +| Gravité | Signification | +|----------|---------| +| Breaking | La modification risque de rompre la compatibilité avec les clients qui dépendent du contrat déclaré, par exemple lorsqu'un champ devient requis ou lorsque le type de paramètre est modifié. | +| Avertissement | La modification présente une dérive qui mérite d'être examinée, telle qu'un champ non déclaré détecté dans le trafic ou un paramètre devenu optionnel. | +| Info | La différence présente un faible risque, comme un endpoint déclaré mais pour lequel aucun trafic n'a été observé. | + +Les différences peuvent apparaître dans les zones suivantes du schéma : + +- **Paramètres** : un paramètre ajouté, supprimé ou modifié d'optionnel à requis (ou l'inverse). +- **Corps de la requête** : un corps de requête ajouté, supprimé ou modifié d'optionnel à requis (ou l'inverse). +- **Propriétés du schéma** : une propriété ajoutée, supprimée, modifiée d'optionnel à requis (ou l'inverse), ou dont le type, le format, la nullabilité ou les valeurs d'énumération ont été modifiés. +- **Contraintes de valeur** : une limite numérique ou de longueur (`minimum`, `maximum`, `minLength`, `maxLength`), un motif ou une contrainte d'unicité modifiés. +- **Composition du schéma** : une inadéquation introduite dans la composition `oneOf` ou `allOf`, ou dans un discriminateur. +- **Réponses** : un code d'état, un en-tête de réponse ou un type de contenu ajouté ou supprimé. + +Pour réduire le bruit, certaines différences sont exclues car elles ne représentent pas une dérive significative du contrat : + +- **Paramètres d'en-tête de requête et de cookie :** ils contiennent souvent des valeurs telles que des jetons d'authentification ou des identifiants de session qui ne font pas partie du contrat d'API. +- **Modifications de type sur les paramètres de requête :** les paramètres de requête sont toujours observés sous forme de chaînes dans le trafic, même lorsqu'ils sont déclarés comme un autre type, tel qu'un entier ou un booléen. +- **Codes d'état supprimés :** Le schéma déduit n'inclut que les codes d'état observés dans le trafic, donc un code d'état déclaré qui ne s'est pas encore produit pendant l'observation apparaît toujours comme supprimé. +- **`anyOf` inadéquations de composition :** Les schémas déclarés et déduits peuvent utiliser `anyOf` à différents niveaux du schéma tout en restant équivalents. + +## Traitement des données sensibles {#processing-sensitive-data} + +App and API Protection détecte et classifie les données sensibles traitées par vos endpoints, en marquant chaque endpoint avec la catégorie et le type de données trouvés. Pour voir quels endpoints traitent des données sensibles et pour créer des scanners de données API personnalisés, consultez [Sensitive Data][16]. + +## Logique métier {#business-logic} + +Ces tags (`users.login.success`, `users.login.failure`, etc.) sont déterminés par la présence de traces de logique métier associées à l'endpoint. + +
Datadog peut suggérer un tag de logique métier pour votre endpoint en fonction de sa méthode HTTP, de ses codes de statut de réponse et de son URL.
+ +## Accessible publiquement {#publicly-accessible} + +Datadog marque un endpoint comme public si l'adresse IP du client est en dehors de ces plages : + +- 10.0.0.0/8 +- 172.16.0.0/12 +- 192.168.0.0/16 +- 169.254.1.0/16 + +Consultez [Configuring a client IP header][14] pour plus d'informations sur la configuration de la bibliothèque requise. + +## Authentification d'endpoint {#endpoint-authentication} + +L'authentification est déterminée par : + +- La présence d'en-têtes `Authorization`, `Token` ou `X-Api-Key`. +- La présence d'un identifiant utilisateur dans la trace (par exemple, l'attribut APM `@usr.id`). +- Un code de statut 401 ou 403 renvoyé par l'endpoint. +- Règles personnalisées de [Endpoint Tagging][15] que vous avez configurées + + +Lorsque le type d'authentification est disponible, Datadog le signale dans un en-tête via la facette {{< ui >}}Authentication Method{{< /ui >}}. + +### Méthodes d'authentification prises en charge {#supported-authentication-methods} + +| Catégorie | Facette de catégorie | +|---------------------------------------------------|------------------| +| Jeton Web JSON (JWT) | `json_web_token` | +| Jetons porteur (trouvés dans les en-têtes `Authorization`) | `bearer_token` | +| Authentification de base | `basic_auth` | +| Authentification par accès digest | `digest_auth` | + +### Prise en charge de l'authentification personnalisée {#custom-authentication-support} + +La détection de l'authentification personnalisée est possible en configurant les [Règles de marquage d'endpoint][15]. Ces règles nécessitent les versions minimales de traceur suivantes : + +|Technologie| Version minimale du traceur | +|----------|------------------------| +|Java | v1.55.0 | +|.NET | À venir | +|Node.js | v5.76.0 | +|Python | v3.17.0 | +|Ruby | v2.23.0 | +|PHP | v1.15.0 | +|Golang | v2.4.0 | + +[1]: https://app.datadoghq.com/security/appsec/inventory/apis +[2]: /fr/security/code_security/iast/ +[3]: /fr/security/code_security/software_composition_analysis/ +[4]: /fr/security/application_security/ +[5]: /fr/integrations/amazon-web-services +[6]: /fr/integrations/amazon-api-gateway +[7]: /fr/internal_developer_portal/catalog/entity_model/native_entities/?tab=api#native-entity-types +[8]: /fr/internal_developer_portal/catalog/set_up/create_entities/#through-the-datadog-ui +[9]: /fr/security/application_security/setup/ +[10]: /fr/tracing/guide/remote_config/ +[11]: /fr/security/application_security/api_posture/endpoint_scanning/ +[12]: /fr/integrations/guide/source-code-integration/ +[13]: /fr/internal_developer_portal/catalog/entity_model/ +[14]: /fr/security/application_security/policies/library_configuration/#configuring-a-client-ip-header +[15]: https://app.datadoghq.com/security/configuration/asm/trace-tagging +[16]: /fr/security/application_security/api_posture/sensitive_data/ \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/how-it-works/threat-intelligence.md b/hugo/content/fr/security/application_security/how-it-works/threat-intelligence.md new file mode 100644 index 00000000000..7302d712fc7 --- /dev/null +++ b/hugo/content/fr/security/application_security/how-it-works/threat-intelligence.md @@ -0,0 +1,79 @@ +--- +aliases: +- /fr/security/application_security/threats/threat-intelligence +further_reading: +- link: https://www.datadoghq.com/blog/cloud-siem-enterprise-security + tag: Blog + text: 'Datadog Cloud SIEM : stimuler l''innovation dans les opérations de sécurité' +title: Renseignements sur les menaces +--- +## Présentation {#overview} + +Cette rubrique décrit l'[intelligence des menaces][1] pour la protection des applications et des API (AAP). + +Datadog fournit des [jeux de données][1] d'intelligence des menaces intégrés pour AAP. Cela fournit des preuves supplémentaires lors de l'intervention sur une activité de sécurité et réduit les seuils de détection pour certaines détections de logique métier. + +De plus, AAP prend en charge *l'utilisation de votre propre intelligence des menaces*. Cette fonctionnalité enrichit les détections avec de l'intelligence des menaces spécifique à l'entreprise. + +## Bonnes pratiques {#best-practices} + +Datadog recommande les méthodes suivantes pour consommer l'intelligence des menaces : + +1. Réduire les seuils des règles de détection pour des menaces liées à la logique métier, telles que le credential stuffing. Les utilisateurs peuvent cloner la règle par défaut [Credential Stuffing][6] et la modifier pour répondre à leurs besoins. +2. Utiliser l'intelligence des menaces comme indicateur de réputation avec une activité de sécurité. + +Datadog déconseille _ce qui suit_ : +1. Bloquer les traces d'intelligence des menaces sans activité de sécurité correspondante. Les adresses IP peuvent avoir de nombreux hosts derrière elles. La détection d'un proxy résidentiel signifie que l'activité associée a été observée par un host derrière cette IP. Cela ne garantit pas que le host exécutant le logiciel malveillant ou le proxy est le même host que celui qui communique avec vos services. +2. Le blocage sur toutes les catégories d'intelligence des menaces, car cela inclut le trafic légitime provenant de VPN d'entreprise et bloque le trafic non malveillant. + +## Filtrer sur l'intelligence des menaces dans AAP {#filtering-on-threat-intelligence-in-aap} + +Les utilisateurs peuvent filtrer l'intelligence des menaces dans le Signals Explorer et le Trace Explorer à l'aide de facettes et de la barre de recherche. + +Pour rechercher toutes les traces signalées par une source spécifique, utilisez la requête suivante avec le nom de la source : + + @threat_intel.results.source.name: + +Pour rechercher toutes les traces contenant de l'intelligence des menaces provenant de n'importe quelle source, utilisez la requête suivante : + + @appsec.threat_intel:true + +## Apportez votre propre intelligence des menaces {#bring-your-own-threat-intelligence} + +{{< site-region region="gov,gov2" >}} +
L'utilisation de votre propre intelligence des menaces n'est pas prise en charge dans {{< region-param key="dd_site_name" >}}.
+{{< /site-region >}} + +AAP prend en charge l'enrichissement et la recherche de traces avec des indicateurs de compromission issus de l'intelligence des menaces stockés dans les tables de référence Datadog. [Les tables de référence][2] vous permettent de combiner des métadonnées avec des informations déjà présentes dans Datadog. + +Pour plus d'informations, consultez le guide [Bring Your Own Threat Intelligence][14]. + + +## Intelligence des menaces dans l'interface utilisateur {#threat-intelligence-in-the-user-interface} + +Lors de la visualisation des traces dans l'AAP Traces Explorer, vous pouvez voir les données d'intelligence des menaces sous l'attribut `@appsec`. Les attributs `category` et `security_activity` sont tous deux définis. + + + +Sous `@threat_intel.results`, vous pouvez toujours voir l'intégralité des détails concernant ce qui a été identifié ainsi que la source correspondante. + + + +## Pour en savoir plus + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/threat_intelligence/#threat-intelligence-sources +[2]: /fr/integrations/guide/reference-tables +[3]: /fr/security/threat_intelligence/#threat-intelligence-facets +[4]: https://app.datadoghq.com/reference-tables/create +[5]: https://app.datadoghq.com/security/configuration/threat-intel +[6]: https://app.datadoghq.com/security/appsec/detection-rules?query=type%3Aapplication_security%20defaultRuleId%3Adef-000-yk4 +[7]: /fr/security/threat_intelligence#threat-intelligence-categories +[8]: /fr/security/threat_intelligence#threat-intelligence-intents +[9]: https://app.datadoghq.com/security/appsec/traces +[10]: /fr/integrations/guide/reference-tables/?tab=manualupload#create-a-reference-table +[11]: /fr/integrations/guide/reference-tables/?tab=amazons3#create-a-reference-table +[12]: /fr/integrations/guide/reference-tables/?tab=azurestorage#create-a-reference-table +[13]: /fr/integrations/guide/reference-tables/?tab=googlecloudstorage#create-a-reference-table +[14]: /fr/security/guide/byoti_guide \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/aws/waf/_index.md b/hugo/content/fr/security/application_security/setup/aws/waf/_index.md index 37bbc61d0ef..e5afaab719d 100644 --- a/hugo/content/fr/security/application_security/setup/aws/waf/_index.md +++ b/hugo/content/fr/security/application_security/setup/aws/waf/_index.md @@ -17,12 +17,6 @@ further_reading: text: Surveiller les applications WAF AWS avec Datadog title: Activation de la protection des applications et des API pour AWS WAF --- -{{< site-region region="gov" >}} -
-App and API Protection est en préversion sur le site Datadog Government US1-FED. -
-{{< /site-region >}} - La protection des applications et des API s'intègre à AWS Web Application Firewall (WAF) en : 1. Convertissant les logs en traces pour obtenir une visibilité sur les requêtes surveillées et bloquées diff --git a/hugo/content/fr/security/application_security/setup/compatibility/gcp-service-extensions.md b/hugo/content/fr/security/application_security/setup/compatibility/gcp-service-extensions.md new file mode 100644 index 00000000000..f54b03dfdcc --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/compatibility/gcp-service-extensions.md @@ -0,0 +1,39 @@ +--- +aliases: +- /fr/security/application_security/threats/setup/compatibility/gcp-service-extensions +code_lang: gcp-service-extensions +code_lang_weight: 40 +title: Exigences de compatibilité des extensions de service GCP pour App and API Protection +type: multi-code-lang +--- +Le tableau suivant répertorie les fonctionnalités d'App and API Protection pour les extensions de service GCP, selon la version d'image de callout des extensions de service Datadog spécifiée : + +| Capacité d'App and API Protection| Version minimale de l'image de callout des App and API Protection Service Extensions| +|------------------------------------------|--------------------------------------------------------------------------| +| Détection des menaces | 1.71.0 | +| Protection contre les menaces | 1.71.0 | +| Personnalisation de la réponse aux requêtes bloquées | 1.71.0 | +| Sécurité des API | v2.2.2 | +| App and API Protection Standalone| v2.2.2| +| Suivi automatique des événements d'activité utilisateur | non pris en charge | + +Veuillez consulter les [limitations][1] de l'intégration des extensions de service GCP pour App and API Protection. + +### Prise en charge du traitement du corps de requête {#body-processing-support} + +Le callout des extensions de service Datadog prend en charge le traitement des corps de requête et de réponse pour les types de charge utile suivants : + +| Type de charge utile| Version minimale de l'image de callout des App and API Protection Service Extensions| +|--------------|--------------------------------------------------------------------------| +| JSON | v2.2.2 | + +## Prise en charge des App and API Protection GCP Service Extensions{#app-and-api-protection-gcp-service-extensions-support} + +
App and API Protection GCP Service Extensions est en version préliminaire.
+ +
Si vous souhaitez voir le support ajouté pour l'une des +fonctionnalités non prises en charge, faites-le-nous savoir ! Remplissez ce court formulaire pour envoyer +détails.
+ +[1]: /fr/security/application_security/setup/gcp/service-extensions \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/envoy.md b/hugo/content/fr/security/application_security/setup/envoy.md new file mode 100644 index 00000000000..f94762ddf64 --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/envoy.md @@ -0,0 +1,178 @@ +--- +aliases: +- /fr/security/application_security/threats/setup/threat_detection/envoy +- /fr/security/application_security/threats_detection/envoy +- /fr/security/application_security/setup/threat_detection/envoy +- /fr/security/application_security/setup/standalone/envoy +code_lang: envoy +code_lang_weight: 50 +further_reading: +- link: https://github.com/DataDog/dd-trace-go/tree/main/contrib/envoyproxy/go-control-plane/cmd/serviceextensions + tag: Code source + text: Code source de l'intégration Envoy +- link: /security/default_rules/?category=cat-application-security + tag: Documentation + text: Règles de protection des applications et des API prêtes à l'emploi +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépannage de la protection des applications et des API +title: Activation de la protection des applications et des API pour Envoy +--- +Vous pouvez activer la protection des applications et des API pour le proxy Envoy. L'intégration Datadog Envoy prend en charge la détection et le blocage des menaces. + +## Prérequis {#prerequisites} + +- Le [Datadog Agent][1] est installé et configuré pour le système d'exploitation, le conteneur, le cloud ou l'environnement virtuel de votre application. +- [Configurez l'Agent avec Remote Configuration][2] pour bloquer les attaquants via l'interface utilisateur Datadog. + +## Activation de la détection des menaces {#enabling-threat-detection} +### Démarrer {#get-started} + +L'intégration Envoy de protection des applications et des API utilise le filtre de traitement externe Envoy. + +1. Déployez un nouveau conteneur avec l'image Docker du processeur externe Datadog. L'image est disponible sur le [registre GitHub de Datadog][5]. + + Ce service est un serveur gRPC avec lequel Envoy communique pour faire analyser les requêtes et les réponses par la protection des applications et des API. + + Le processeur externe Datadog expose certains paramètres : + | Variable d'environnement | Valeur par défaut | Description | + |-------------------------------------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------| + | `DD_SERVICE_EXTENSION_HOST` | `0.0.0.0` | Adresse d'écoute du serveur gRPC. | + | `DD_SERVICE_EXTENSION_PORT` | `443` | Port du serveur gRPC. | + | `DD_SERVICE_EXTENSION_HEALTHCHECK_PORT` | `80` | Port du serveur HTTP pour les checks de santé. | + | `DD_APPSEC_BODY_PARSING_SIZE_LIMIT` | `0` | Taille maximale des corps à traiter en octets. S'il est défini sur `0`, les corps ne sont pas traités. La valeur recommandée est `10000000` (10 Mo). (Pour activer complètement le traitement du corps, l'option `allow_mode_override` doit également être définie dans la configuration du filtre de traitement externe) | + | `DD_SERVICE_EXTENSION_OBSERVABILITY_MODE` | `false` | Activer l'analyse asynchrone. Cela désactive également les capacités de blocage. (Pour activer complètement le mode d'observabilité, cette option doit également être définie dans la configuration du filtre de traitement externe) | + | `DD_SERVICE` | `serviceextensions` | Nom du service affiché dans l'interface utilisateur Datadog. | + + Configurez le Datadog Agent pour recevoir les traces du processeur externe en utilisant les variables d'environnement suivantes : + + | Variable d'environnement | Valeur par défaut | Description | + |----------------------------------------|---------------|----------------------------------------------------------------------------------| + | `DD_AGENT_HOST` | `localhost` | Nom de host ou adresse IP de votre Datadog Agent. | + | `DD_TRACE_AGENT_PORT` | `8126` | Port du Datadog Agent pour la collecte des traces. | + +2. Mettez à jour votre configuration Envoy pour ajouter le [filtre de traitement externe][3] à votre liste `http_filters`, et définissez le cluster gRPC correspondant dans votre section `clusters`. Exemple : + +#### Section des filtres HTTP + + ```yaml + http_filters: + # This filter should be the first filter in the filter chain + - name: envoy.filters.http.ext_proc + typed_config: + "@type": type.googleapis.com/envoy.extensions.filters.http.ext_proc.v3.ExternalProcessor + grpc_service: + envoy_grpc: + cluster_name: datadog_aap_ext_proc_cluster + + ## Mandatory: Correctly show the service as an Envoy proxy in the UI. + initial_metadata: + - key: x-datadog-envoy-integration + value: '1' + + ## A timeout configuration for the grpc connection exist but is not useful in our case. + ## This timeout is for all the request lifetime. A timeout on the route is preferred. + #timeout: 0s + + ## Optional: Enable fail open mode. Default is false. + ## Normally, if the external processor fails or times out, the filter fails and Envoy + ## returns a 5xx error to the downstream client. Setting this to true allows requests + ## to continue without error if a failure occurs. + failure_mode_allow: true # It won't cause 5xx error if an error occurs. + + ## Mandatory: Only enable the request and response header modes. + ## If you want to enable body processing, please see the section below. + processing_mode: + request_header_mode: SEND + response_header_mode: SEND + + ## Optional for headers analysis only but **mandatory** for body processing. + ## The external processor can dynamically override the processing mode as needed instructing + ## Envoy to forward request and response bodies to the external processor. Body processing is + ## enabled when DD_APPSEC_BODY_PARSING_SIZE_LIMIT is set on the external processor container. + allow_mode_override: true + + ## Optional: Set a timeout by processing message. Default is 200ms. + ## There is a maxium of 2 messages per requests with headers only and 4 messages maximum + ## with body processing enabled. + ## Note: This timeout also includes the data communication between Envoy and the external processor. + ## Optional: When the body processing is enabled, the timeout should be adjusted to accommodate + ## the additional possible processing time. Larger payloads will require a longer timeout. + #message_timeout: 200ms + + ## Optional: Enable asynchronous mode analysis. Default is false. + ## This mode will disable all blocking capabilities. The external processor should also be + ## configured with the DD_SERVICE_EXTENSION_OBSERVABILITY_MODE environment variable. + ## Beware, there is no flow control implemented in Envoy + ## (cf https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/http/ext_proc/v3/ext_proc.proto#envoy-v3-api-field-extensions-filters-http-ext-proc-v3-externalprocessor-observability-mode) + #observability_mode: true + ## Optional: When in asynchronous mode, the message_timeout is not used. This deferred + ## timeout starts when the http request is finished, to let the External Processor + ## process all processing messages. Default is 5s. + #deferred_close_timeout: 5s + + # ... other filters + ``` + +#### Section des clusters + + ```yaml + clusters: + # ... other clusters + - name: datadog_aap_ext_proc_cluster + type: STRICT_DNS + lb_policy: ROUND_ROBIN + http2_protocol_options: {} + transport_socket: + name: envoy.transport_sockets.tls + typed_config: + "@type": type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.UpstreamTlsContext + sni: "localhost" + load_assignment: + cluster_name: datadog_aap_ext_proc_cluster + endpoints: + - lb_endpoints: + - endpoint: + address: + socket_address: + address: 12.0.0.1 # Replace with the host address of the Datadog External Processor docker image (configured in the next step) + port_value: 443 + ``` + + **Remarque** : Veuillez lire attentivement l'exemple de configuration fourni et l'adapter à votre infrastructure et à votre environnement. Vous trouverez d'autres options de configuration disponibles dans la [documentation du processeur externe Envoy][4]. + +3. Validation. + +{{% appsec-getstarted-2-plusrisk %}} + +{{< img src="/security/application_security/appsec-getstarted-threat-and-vuln_2.mp4" alt="Vidéo montrant le Signals Explorer et ses détails, ainsi que le Vulnerabilities Explorer et ses détails." video="true" >}} + +## Intégration de Datadog Go Tracer et d'Envoy {#datadog-go-tracer-and-envoy-integration} + +Le processeur externe est construit sur le [Datadog Go Tracer][6] et hérite de toutes les variables d'environnement du Datadog Go Tracer. Consultez [Configuration du SDK Go][7] et [Configuration de la bibliothèque de protection des applications et des API][8]. + +
+ Remarque : Comme le Datadog External Processor est construit sur le Datadog Go Tracer, il suit généralement le même processus de publication que ce dernier, et ses images Docker sont marquées avec la version correspondante du tracer (par exemple, v2.2.2). Dans certains cas, des versions préliminaires peuvent être publiées entre les versions officielles du Datadog Go Tracer, et ces images sont marquées avec un suffixe tel que -docker.1. +
+ +## Limitations {#limitations} + +L'intégration Envoy présente les limitations suivantes : + +* L'inspection des corps de requête et de réponse est prise en charge lors de l'utilisation de l'image du Datadog External Processor version `v2.2.2` ou ultérieure. + +Pour plus de détails sur les compatibilités de l'intégration Envoy, consultez la [page de compatibilité de l'intégration Envoy][9]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/account/settings#agent +[2]: /fr/tracing/guide/remote_config +[3]: https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/ext_proc_filter +[4]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/http/ext_proc/v3/ext_proc.proto +[5]: https://github.com/DataDog/dd-trace-go/pkgs/container/dd-trace-go%2Fservice-extensions-callout +[6]: https://github.com/DataDog/dd-trace-go +[7]: /fr/tracing/trace_collection/library_config/go/ +[8]: /fr/security/application_security/policies/library_configuration/ +[9]: /fr/security/application_security/setup/compatibility/envoy \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/gcp/cloud-run/ruby.md b/hugo/content/fr/security/application_security/setup/gcp/cloud-run/ruby.md new file mode 100644 index 00000000000..a073bae332d --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/gcp/cloud-run/ruby.md @@ -0,0 +1,124 @@ +--- +further_reading: +- link: /security/application_security/how-it-works/ + tag: Documentation + text: Fonctionnement de la protection des applications et des API +- link: /security/default_rules/?category=cat-application-security + tag: Documentation + text: Règles de protection des applications et des API prêtes à l'emploi +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépannage de la protection des applications et des API +- link: /security/application_security/threats/ + tag: Documentation + text: App and API protection +- link: https://www.datadoghq.com/blog/datadog-security-google-cloud/ + tag: Blog + text: Datadog Security propose davantage de fonctionnalités de conformité et de + protection contre les menaces pour Google Cloud +title: Activation de la protection des applications et des API pour les fonctions + Google Cloud Run en Ruby +--- +
La prise en charge d'AAP pour Google Cloud Run est en version préliminaire.
+ +## Fonctionnement {#how-it-works} + +L'application `serverless-init` encapsule votre processus et l'exécute en tant que sous-processus. Il démarre un DogStatsD listener pour les métriques et un Trace Agent listener pour les traces. Il collecte les logs en encapsulant les flux stdout/stderr de votre application. Après l'amorçage, `serverless-init` lance ensuite votre commande en tant que sous-processus. + +Pour obtenir une instrumentation complète, assurez-vous d'appeler `datadog-init` comme première commande exécutée dans votre conteneur Docker. Vous pouvez le faire en le définissant comme point d'entrée, ou en le définissant comme premier argument dans CMD. + +## Compatibilité {#compatibility} + +
La prise en charge de Google Cloud Run pour la protection sans serveur des applications et des API est en version préliminaire.
+ +**Remarque** : la protection contre les menaces via Remote Configuration n'est pas prise en charge. Utilisez [Workflows][5] pour bloquer les adresses IP dans votre [WAF][6]. + +## Démarrez {#get-started} + +[Installez manuellement][1] le traceur Ruby avant de déployer votre application. Consultez l'[exemple d'application][2]. + +Ajoutez les instructions et arguments suivants à votre fichier Docker. + +```dockerfile +COPY --from=datadog/serverless-init:1 /datadog-init /app/datadog-init +ENV DD_SERVICE=datadog-demo-run-ruby +ENV DD_ENV=datadog-demo +ENV DD_VERSION=1 +ENV DD_APPSEC_ENABLED=1 +ENV DD_TRACE_PROPAGATION_STYLE=datadog +ENTRYPOINT ["/app/datadog-init"] +CMD ["rails", "server", "-b", "0.0.0.0"] +``` + +### Explication {#explanation} + +1. Copiez le Datadog `serverless-init` dans votre image Docker. + ```dockerfile + COPY --from=datadog/serverless-init:1 /datadog-init /app/datadog-init + ``` + +2. (Facultatif) ajoutez des tags Datadog + ```dockerfile + ENV DD_SERVICE=datadog-demo-run-ruby + ENV DD_ENV=datadog-demo + ENV DD_APPSEC_ENABLED=1 + ENV DD_VERSION=1 + ``` + +3. Cette variable d'environnement est nécessaire pour que la propagation des traces fonctionne correctement dans Cloud Run. Assurez-vous de définir cette variable pour tous les services en aval instrumentés par Datadog. + ```dockerfile + ENV DD_TRACE_PROPAGATION_STYLE=datadog + ``` + +4. Modifiez le point d'entrée pour encapsuler votre application dans le processus Datadog `serverless-init`. + **Remarque** : si vous avez déjà défini un point d'entrée dans votre Dockerfile, consultez la [configuration alternative](#alt-ruby). + ```dockerfile + ENTRYPOINT ["/app/datadog-init"] + ``` + +5. Exécutez votre application binaire encapsulée dans le point d'entrée. Adaptez cette ligne à vos besoins. + ```dockerfile + CMD ["rails", "server", "-b", "0.0.0.0"] + ``` +### Configuration alternative {#alt-ruby} +Si vous avez déjà défini un point d'entrée dans votre fichier Docker, vous pouvez choisir de modifier lʼargument CMD. + +{{< highlight dockerfile "hl_lines=7" >}} +COPY --from=datadog/serverless-init:1 /datadog-init /app/datadog-init +ENV DD_SERVICE=datadog-demo-run-ruby +ENV DD_ENV=datadog-demo +ENV DD_VERSION=1 +ENV DD_APPSEC_ENABLED=1 +ENV DD_TRACE_PROPAGATION_STYLE=datadog +CMD ["/app/datadog-init", "rails", "server", "-b", "0.0.0.0"] +{{< /highlight >}} + +Si vous avez également besoin que votre point d'entrée soit instrumenté, vous pouvez inverser votre point d'entrée et vos arguments CMD. Pour plus d'informations, consultez [Comment fonctionne `serverless-init`](#how-serverless-init-works). + +{{< highlight dockerfile "hl_lines=7-8" >}} +COPY --from=datadog/serverless-init:1 /datadog-init /app/datadog-init +ENV DD_SERVICE=datadog-demo-run-ruby +ENV DD_ENV=datadog-demo +ENV DD_VERSION=1 +ENV DD_APPSEC_ENABLED=1 +ENV DD_TRACE_PROPAGATION_STYLE=datadog +ENTRYPOINT ["/app/datadog-init"] +CMD ["your_entrypoint.sh", "rails", "server", "-b", "0.0.0.0"] +{{< /highlight >}} + +Tant que votre commande à exécuter est transmise en tant qu'argument à `datadog-init`, vous bénéficierez d'une instrumentation complète. + +[1]: /fr/tracing/trace_collection/dd_libraries/ruby/?tab=containers#instrument-your-application +[2]: https://github.com/DataDog/crpb/tree/main/ruby-on-rails + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/services?query=type%3Afunction%20&env=prod&groupBy=&hostGroup=%2A&lens=Security&sort=-attackExposure&view=list +[2]: /fr/serverless/distributed_tracing/ +[3]: https://app.datadoghq.com/security/appsec +[4]: /fr/security/application_security/serverless/compatibility +[5]: /fr/actions/workflows/ +[6]: /fr/security/application_security/waf-integration/ +[apm-lambda-tracing-setup]: https://docs.datadoghq.com/serverless/aws_lambda/distributed_tracing/ \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/haproxy.md b/hugo/content/fr/security/application_security/setup/haproxy.md new file mode 100644 index 00000000000..077a147236c --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/haproxy.md @@ -0,0 +1,171 @@ +--- +code_lang: haproxy +code_lang_weight: 40 +further_reading: +- link: https://github.com/DataDog/dd-trace-go/tree/main/contrib/haproxy/stream-processing-offload/cmd/spoa + tag: Code source + text: Code source de l'intégration HAProxy +- link: https://github.com/DataDog/dd-trace-go/pkgs/container/dd-trace-go%2Fhaproxy-spoa + tag: Image de conteneur + text: Image Docker du SPOA HAProxy +- link: /security/default_rules/?category=cat-application-security + tag: Documentation + text: Règles de protection des applications et des API prêtes à l'emploi +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépannage de la protection des applications et des API +title: Activation de la protection des applications et des API pour HAProxy +--- +{{< callout url="https://www.datadoghq.com/product-preview/haproxy-integration/">}} +La protection des applications et des API pour HAProxy est en version préliminaire. Pour vous inscrire, cliquez sur Demander l'accès et remplissez le formulaire. +{{< /callout >}} + +Vous pouvez activer la protection des applications et des API pour vos instances HAProxy. L'intégration Datadog HAProxy tire parti du Stream Processing Offload Engine (SPOE) de HAProxy pour inspecter et protéger le trafic afin de détecter les menaces à la périphérie de votre infrastructure. + +## Prérequis {#prerequisites} + +- Le [Datadog Agent][1] est installé et configuré pour votre environnement (host, conteneur ou orchestrateur). +- [Configurez l'Agent avec Remote Configuration][2] dans l'interface utilisateur Datadog pour bloquer les attaquants. + +## Activation de la détection des menaces {#enabling-threat-detection} + +### Démarrer {#get-started} + +L'intégration HAProxy pour la protection des applications et des API utilise le [Stream Processing Offload Engine][3] (SPOE) de HAProxy pour appeler un Datadog Stream Processing Offload Agent (SPOA). Le SPOA analyse les requêtes et les réponses. + +Pour activer la protection des applications et des API pour HAProxy, procédez comme suit : +1. Déployez le conteneur SPOA Datadog pour HAProxy. +2. Mettez à jour vos fichiers de configuration HAProxy pour les intégrer au SPOA + +### Conteneur SPOA {#spoa-container} + +Déployez l'image SPOA Datadog pour HAProxy disponible dans le [Datadog GitHub Container Registry][4]. Le SPOA écoute les connexions SPOE provenant de HAProxy et envoie des événements de sécurité à votre Datadog Agent. + +Consultez [Configuration](#configuration) pour connaître les options de configuration disponibles pour le conteneur SPOA. + +### Fichiers de configuration HAProxy {#haproxy-configuration-files} + +Tous les fichiers de configuration HAProxy requis sont disponibles dans le [dossier du dépôt][8]. Pour plus d'informations sur les mises à jour et les modifications de la configuration, consultez le [log des modifications de configuration][9]. + +Les fichiers suivants sont nécessaires pour votre installation : + +- `spoe.cfg` : Fichier de configuration du moteur SPOE principal. +- `global-config.cfg` : Lignes de configuration à inclure dans votre section `global`. +- `frontend-config.cfg` : Lignes de configuration à ajouter en haut de chaque `frontend` que vous souhaitez protéger. +- `backend.cfg` : Définit le backend SPOA utilisé par le moteur SPOE. +- `datadog_aap_blocking_response.lua` : Script Lua pour bloquer les réponses. + +Des conseils pour la configuration de chaque fichier sont fournis ci-dessous. + +#### spoe.cfg {#spoecfg} + +Le fichier `spoe.cfg` est responsable de la déclaration de l'agent SPOE et de sa configuration. Ce fichier doit être enregistré sur le disque, par exemple dans `/usr/local/etc/haproxy/spoe.cfg`. L'emplacement de ce fichier est référencé via la variable d'environnement `DD_SPOA_SPOA_CONF_FILE`, qui est configurée dans la section `global`. + +Il est important qu'aucune modification personnalisée ne soit apportée à ce fichier. + +#### global-config.cfg {#global-configcfg} + +Le fichier `global-config.cfg` charge le script Lua requis et configure les variables nécessaires à l'intégration. Son contenu doit être incorporé dans la section `global` de votre fichier de configuration `haproxy.cfg`. + +Vous pouvez ajuster les valeurs selon les besoins de votre environnement. Consultez les commentaires dans le fichier pour obtenir des conseils supplémentaires sur chaque paramètre. + +#### frontend-config.cfg {#frontend-configcfg} + +Le fichier `frontend-config.cfg` attache le filtre SPOE à votre frontend. Cette section doit être placée tout en haut de chaque section `frontend` que vous souhaitez protéger, avant les autres filtres et le routeur. + +Cette section garantit que : +- Les événements de requête et de réponse sont envoyés au SPOA +- Les en-têtes de traçage Datadog sont injectés le cas échéant +- L'assistant Lua est invoqué de manière conditionnelle pour le blocage + +Il est important qu'aucune modification personnalisée ne soit apportée à cette partie de la configuration. + +#### backend.cfg {#backendcfg} + +Le fichier `backend.cfg` définit le `spoa-backend` utilisé par le moteur SPOE et pour les checks de santé. Cette configuration doit être ajoutée vers la fin de votre fichier `haproxy.cfg`. + +Assurez-vous de modifier la ligne `server spoa1 :` afin qu'elle référence votre instance de conteneur SPOA déployée. + +
+ Remarque : Pour une haute disponibilité et une redondance, vous pouvez configurer plusieurs serveurs d'agent SPOA en ajoutant des lignes supplémentaires. server lignes (par exemple, server spoa1 ..., server spoa2 ..., etc.). HAProxy équilibrera automatiquement la charge et basculera entre ces agents SPOA, assurant une protection continue même si un agent devient indisponible. +
+ +#### datadog_aap_blocking_response.lua {#datadog-aap-blocking-responselua} + +Le script `datadog_aap_blocking_response.lua` est chargé d'envoyer une réponse de blocage personnalisée lorsque le SPOA demande à HAProxy de bloquer une requête. Ce script pourrait être stocké dans un emplacement tel que `/etc/haproxy/lua/datadog_aap_blocking_response.lua`, et la directive `lua-load` dans la section `global` devrait référencer ce chemin. + +Il est important qu'aucune modification personnalisée ne soit apportée à ce fichier. + +
+ Remarque : Ce script Lua n'est pas invoqué à chaque requête traitée par HAProxy. Il est uniquement invoqué lorsqu'une requête est bloquée par App and API Protection. Cette conception assure des performances optimales en évitant la surcharge liée à l'exécution de code Lua pour toutes les requêtes. +
+ +### Validation {#validation} + +{{% appsec-getstarted-2-plusrisk %}} + +{{< img src="/security/application_security/appsec-getstarted-threat-and-vuln_2.mp4" alt="Vidéo montrant le Signals Explorer et ses détails, ainsi que le Vulnerabilities Explorer et ses détails." video="true" >}} + +## Configuration {#configuration} + +Le conteneur Datadog HAProxy SPOA prend en charge les paramètres de configuration suivants : + +| Variable d'environnement | Valeur par défaut | Description | +| ----------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------- | +| `DD_HAPROXY_SPOA_HOST` | `0.0.0.0` | Host sur lequel le SPOA et le serveur de santé HTTP écoutent. | +| `DD_HAPROXY_SPOA_PORT` | `3000` | Port utilisé par le SPOA qui accepte la communication avec HAProxy. | +| `DD_HAPROXY_SPOA_HEALTHCHECK_PORT` | `3080` | Port utilisé pour le serveur HTTP pour les checks de santé. | +| `DD_APPSEC_BODY_PARSING_SIZE_LIMIT` | `0` | Taille maximale des corps à traiter en octets. Si `0`, les corps ne sont pas traités. Recommandé : `10000000` (10 Mo). | +| `DD_SERVICE` | `spoa` | Nom du service affiché dans l'interface utilisateur Datadog. | + +Configurez le SPOA pour envoyer des traces à votre Datadog Agent en utilisant les variables d'environnement suivantes : + +| Variable d'environnement | Valeur par défaut | Description | +| --------------------- | ------------- | -------------------------------- | +| `DD_AGENT_HOST` | `localhost` | Host d'un Datadog Agent en cours d'exécution. | +| `DD_TRACE_AGENT_PORT` | `8126` | Port d'un Datadog Agent en cours d'exécution. | + +### Intégration Datadog Go Tracer et HAProxy {#datadog-go-tracer-and-haproxy-integration} + +L'intégration HAProxy est construite sur le [Datadog Go Tracer][5] et hérite de toutes les variables d'environnement du traceur. Consultez [Configuration du SDK Go][6] et [Configuration de la bibliothèque de protection des applications et des API][7]. + +
+ Remarque : Comme le SPOA Datadog est construit sur le Datadog Go Tracer, il suit généralement le même processus de publication que le traceur, et ses images Docker sont marquées avec la version correspondante du traceur (par exemple, v2.4.0). Dans certains cas, des versions préliminaires peuvent être publiées entre les versions officielles du Datadog Go Tracer, et ces images sont marquées avec un suffixe tel que -docker.1. +


+ +## Maintenir votre configuration à jour {#keeping-your-configuration-up-to-date} + +Comme l'intégration SPOE de HAProxy implique à la fois un composant d'exécution (l'image de conteneur SPOA) et une configuration HAProxy, les mises à niveau peuvent nécessiter des modifications aux deux endroits. + +La configuration HAProxy de référence et un log des modifications associé sont disponibles pour vous aider à surveiller et à suivre les mises à jour : +- [Répertoire de configuration HAProxy de référence][8] (moteur SPOE, global, extraits frontend/backend, Lua) +- [Log des modifications de configuration][9] + +### Pratiques de mise à niveau recommandées {#recommended-upgrade-practices} + +- Fixez votre image SPOA à une version spécifique et effectuez la mise à niveau intentionnellement après avoir examiné le log des modifications de configuration. +- Centralisez la configuration Datadog afin qu'elle soit facilement mise à jour. +- Suivez la configuration de référence et le log des modifications, et comparez votre configuration à celle-ci lors des mises à niveau. + +## Limitations {#limitations} + +L'intégration HAProxy présente les limitations suivantes : + +- Le mode asynchrone (observabilité) n'est actuellement pas pris en charge. + +Pour plus de détails sur les compatibilités de l'intégration HAProxy, reportez-vous à la [page de compatibilité de l'intégration HAProxy][10]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/account/settings#agent +[2]: /fr/remote_configuration/ +[3]: https://www.haproxy.com/blog/extending-haproxy-with-the-stream-processing-offload-engine +[4]: https://github.com/DataDog/dd-trace-go/pkgs/container/dd-trace-go%2Fhaproxy-spoa +[5]: https://github.com/DataDog/dd-trace-go +[6]: /fr/tracing/trace_collection/library_config/go/ +[7]: /fr/security/application_security/policies/library_configuration/ +[8]: https://github.com/DataDog/dd-trace-go/tree/main/contrib/haproxy/stream-processing-offload/cmd/spoa/haproxyconf/ +[9]: https://github.com/DataDog/dd-trace-go/blob/main/contrib/haproxy/stream-processing-offload/cmd/spoa/haproxyconf/CHANGELOG.md +[10]: /fr/security/application_security/setup/compatibility/haproxy \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/java/linux.md b/hugo/content/fr/security/application_security/setup/java/linux.md new file mode 100644 index 00000000000..10d53df061c --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/java/linux.md @@ -0,0 +1,119 @@ +--- +code_lang: linux +code_lang_weight: 30 +further_reading: +- link: /security/application_security/how-it-works/ + tag: Documentation + text: Fonctionnement de la protection des applications et des API +- link: /security/default_rules/?category=cat-application-security + tag: Documentation + text: Règles de protection des applications et des API prêtes à l'emploi +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépannage de la protection des applications et des API +title: Configurez App and API Protection pour Java sur Linux +type: multi-code-lang +--- +{{% app_and_api_protection_java_setup_options platform="linux" %}} + +{{% app_and_api_protection_java_overview %}} + +## Prérequis {#prerequisites} + +- Système d'exploitation Linux +- Application Java +- Privilèges root ou sudo +- Systemd (pour la gestion des services) +- Votre clé d'API Datadog +- SDK Java Datadog (voir les exigences de version [ici][1]) + +## 1. Installation du Datadog Agent {#1-installing-the-datadog-agent} + +Installez le Datadog Agent en suivant les [instructions d'installation pour les hosts Linux][3]. + +## 2. Activation de la surveillance de la protection des applications et des API {#2-enabling-app-and-api-protection-monitoring} + +{{% app_and_api_protection_navigation_menu %}} +{{% appsec-remote-config-activation %}} + +### Activation manuelle de la surveillance de la protection des applications et des API {#manually-enabling-app-and-api-protection-monitoring} + +Téléchargez la dernière version de la bibliothèque Java Datadog : + +```bash +wget -O dd-java-agent.jar 'https://dtdg.co/latest-java-tracer' +``` + +{{% collapse-content title="Traçage APM activé" level="h4" %}} +{{< tabs >}} +{{% tab "Utilisation des propriétés système" %}} + +Démarrez votre application Java avec le Datadog Agent et App and API Protection activé en utilisant les propriétés système : + +```bash +java -javaagent:/path/to/dd-java-agent.jar -Ddd.appsec.enabled=true -Ddd.service= -Ddd.env= -jar path/to/app.jar +``` + +{{% /tab %}} +{{% tab "Utilisation des variables d'environnement" %}} + +Définissez les variables d'environnement requises et démarrez votre application Java : + +```bash +export DD_APPSEC_ENABLED=true +export DD_SERVICE= +export DD_ENV= + +java -javaagent:/path/to/dd-java-agent.jar -jar path/to/app.jar +``` + +{{% /tab %}} +{{< /tabs >}} +{{% /collapse-content %}} + +{{% collapse-content title="Traçage APM désactivé" level="h4" %}} +Pour désactiver le traçage APM tout en conservant la protection des applications et des API activée, vous devez définir la variable de traçage APM sur false. +{{< tabs >}} +{{% tab "Utilisation des propriétés système" %}} + +Démarrez votre application Java avec le Datadog Agent et App and API Protection activé en utilisant les propriétés système : + +```bash +java -javaagent:/path/to/dd-java-agent.jar -Ddd.appsec.enabled=true -Ddd.apm.tracing.enabled=false -Ddd.service= -Ddd.env= -jar path/to/app.jar +``` + +{{% /tab %}} +{{% tab "Utilisation des variables d'environnement" %}} + +Définissez les variables d'environnement requises et démarrez votre application Java : + +```bash +export DD_APPSEC_ENABLED=true +export DD_APM_TRACING_ENABLED=false +export DD_SERVICE= +export DD_ENV= + +java -javaagent:/path/to/dd-java-agent.jar -jar path/to/app.jar +``` + +{{% /tab %}} +{{< /tabs >}} +{{% /collapse-content %}} + +## 3. Exécutez votre application {#3-run-your-application} + +Démarrez votre application Java avec les paramètres ci-dessus. + +{{% aap/aap_and_api_protection_verify_setup %}} + +## Dépannage {#troubleshooting} + +Si vous rencontrez des problèmes lors de la configuration d'App and API Protection pour votre application Java, consultez le [Java App and API Protection troubleshooting guide][2]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/application_security/setup/compatibility/java +[2]: /fr/security/application_security/setup/java/troubleshooting +[3]: /fr/agent/?tab=Linux \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/nodejs/aws-fargate.md b/hugo/content/fr/security/application_security/setup/nodejs/aws-fargate.md new file mode 100644 index 00000000000..5964297b135 --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/nodejs/aws-fargate.md @@ -0,0 +1,168 @@ +--- +code_lang: aws-fargate +code_lang_weight: 60 +further_reading: +- link: /security/application_security/how-it-works/ + tag: Documentation + text: Fonctionnement de la protection des applications et des API +- link: /security/default_rules/?category=cat-application-security + tag: Documentation + text: Règles de protection des applications et des API prêtes à l'emploi +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépannage de la protection des applications et des API +title: Configurer la protection des applications et des API pour Node.js sur AWS Fargate +type: multi-code-lang +--- +{{% aap/aap_and_api_protection_nodejs_overview %}} + +## Prérequis {#prerequisites} + +- Environnement AWS Fargate +- Application Node.js conteneurisée avec Docker +- AWS CLI configuré avec les autorisations appropriées +- Votre clé d'API Datadog +- SDK Datadog Node.js (voir [exigences de version][1]) + +## 1. Installation du Datadog Agent {#1-installing-the-datadog-agent} + +Installez le Datadog Agent dans votre définition de tâche Fargate : + +```json +{ + "containerDefinitions": [ + { + "name": "datadog-agent", + "image": "public.ecr.aws/datadog/agent:latest", + "environment": [ + { + "name": "DD_API_KEY", + "value": "" + }, + { + "name": "DD_APM_ENABLED", + "value": "true" + }, + { + "name": "DD_APM_NON_LOCAL_TRAFFIC", + "value": "true" + } + ] + } + ] +} +``` + +## 2. Activation de la surveillance de la protection des applications et des API {#2-enabling-app-and-api-protection-monitoring} + +{{% aap/aap_and_api_protection_nodejs_navigation_menu %}} + +{{% aap/aap_and_api_protection_nodejs_remote_config_activation %}} + +### Activation manuelle de la surveillance de la protection des applications et des API {#manually-enabling-app-and-api-protection-monitoring} + +Assurez-vous que votre Dockerfile inclut la bibliothèque Datadog Node.js : + +```dockerfile +FROM node:18-alpine + +# Install the Datadog Node.js library +RUN npm install dd-trace + +# Copy your application files +COPY package*.json ./ +COPY . . +RUN npm install + +# Start the application with the Datadog SDK +CMD ["node", "--require", "dd-trace/init", "app.js"] +``` + +{{% collapse-content title="Traçage APM activé" level="h4" %}} + +Mettez à jour votre définition de tâche pour inclure le conteneur d'application Node.js avec la configuration de la protection des applications et des API : + +```json +{ + "containerDefinitions": [ + { + "name": "your-nodejs-app", + "image": "your-nodejs-app-image", + "environment": [ + { + "name": "DD_APPSEC_ENABLED", + "value": "true" + }, + { + "name": "DD_SERVICE", + "value": "" + }, + { + "name": "DD_ENV", + "value": "" + } + ] + } + ] +} +``` + +{{% /collapse-content %}} + +{{% collapse-content title="Traçage APM désactivé" level="h4" %}} +Pour désactiver le traçage APM tout en conservant la protection des applications et des API activée, vous devez définir la variable de traçage APM sur false. + +Mettez à jour votre définition de tâche pour inclure le conteneur d'application Node.js avec la configuration de la protection des applications et des API : + +```json +{ + "containerDefinitions": [ + { + "name": "your-nodejs-app", + "image": "your-nodejs-app-image", + "environment": [ + { + "name": "DD_APPSEC_ENABLED", + "value": "true" + }, + { + "name": "DD_APM_TRACING_ENABLED", + "value": "false" + }, + { + "name": "DD_SERVICE", + "value": "" + }, + { + "name": "DD_ENV", + "value": "" + } + ] + } + ] +} +``` + +{{% /collapse-content %}} + +## 3. Exécutez votre application {#3-run-your-application} + +Déployez votre tâche Fargate avec la configuration mise à jour : + +```bash +aws ecs register-task-definition --cli-input-json file://task-definition.json +aws ecs run-task --cluster your-cluster --task-definition your-task-definition +``` + +{{% aap/aap_and_api_protection_verify_setup %}} + +## Dépannage {#troubleshooting} + +Si vous rencontrez des problèmes lors de la configuration de la protection des applications et des API pour votre application Node.js, consultez le [guide de dépannage de la protection des applications et des API Node.js][2]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/application_security/setup/compatibility/nodejs +[2]: /fr/security/application_security/setup/nodejs/troubleshooting \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/php/aws-fargate.md b/hugo/content/fr/security/application_security/setup/php/aws-fargate.md new file mode 100644 index 00000000000..24e87988740 --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/php/aws-fargate.md @@ -0,0 +1,177 @@ +--- +code_lang: aws-fargate +code_lang_weight: 60 +further_reading: +- link: /security/application_security/how-it-works/ + tag: Documentation + text: Fonctionnement de la protection des applications et des API +- link: /security/default_rules/?category=cat-application-security + tag: Documentation + text: Règles de protection des applications et des API prêtes à l'emploi +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépannage de la protection des applications et des API +title: Configurez la protection des applications et des API pour PHP sur AWS Fargate +type: multi-code-lang +--- +{{% app_and_api_protection_php_overview %}} + +## Prérequis {#prerequisites} + +- Environnement AWS Fargate +- Application PHP conteneurisée avec Docker +- AWS CLI configuré avec les autorisations appropriées +- Votre clé d'API Datadog +- SDK PHP Datadog (voir [exigences de version][1]) + +## 1. Installation du Datadog Agent {#1-installing-the-datadog-agent} + +Installez le Datadog Agent dans votre définition de tâche Fargate : + +```json +{ + "containerDefinitions": [ + { + "name": "datadog-agent", + "image": "public.ecr.aws/datadog/agent:latest", + "environment": [ + { + "name": "DD_API_KEY", + "value": "" + }, + { + "name": "DD_APM_ENABLED", + "value": "true" + }, + { + "name": "DD_APM_NON_LOCAL_TRAFFIC", + "value": "true" + }, + { + "name": "DD_SITE", + "value": "{{< region-param key=\"dd_site\" >}}" + } + ] + } + ] +} +``` + +## 2. Activation de la surveillance de la protection des applications et des API {#2-enabling-app-and-api-protection-monitoring} + +{{% app_and_api_protection_php_navigation_menu %}} +{{% appsec-remote-config-activation %}} + +### Activation manuelle de la surveillance de la protection des applications et des API {#manually-enabling-app-and-api-protection-monitoring} + +Assurez-vous que votre Dockerfile inclut la bibliothèque PHP Datadog : + +Ajoutez ce qui suit à votre Dockerfile : + +```dockerfile +# Install dd-trace-php +RUN curl -LO https://github.com/DataDog/dd-trace-php/releases/latest/download/datadog-setup.php +RUN php datadog-setup.php --php-bin=all +# Enable appsec +ENV DD_APPSEC_ENABLED=true +# Configure your service +ENV DD_SERVICE= +ENV DD_ENV= +``` + +{{% collapse-content title="Traçage APM activé" level="h4" %}} + +Mettez à jour votre définition de tâche pour inclure le conteneur d'application PHP avec la configuration de la protection des applications et des API : + +```json +{ + "containerDefinitions": [ + { + "name": "your-php-app", + "image": "your-php-app-image", + "environment": [ + { + "name": "DD_APPSEC_ENABLED", + "value": "true" + }, + { + "name": "DD_SERVICE", + "value": "" + }, + { + "name": "DD_ENV", + "value": "" + }, + { + "name": "DD_SITE", + "value": "{{< region-param key=\"dd_site\" >}}" + } + ] + } + ] +} +``` + +{{% /collapse-content %}} + +{{% collapse-content title="Traçage APM désactivé" level="h4" %}} +Pour désactiver le traçage APM tout en conservant la protection des applications et des API activée, vous devez définir la variable de traçage APM sur false. + +Mettez à jour votre définition de tâche pour inclure le conteneur d'application PHP avec la configuration de la protection des applications et des API : + +```json +{ + "containerDefinitions": [ + { + "name": "your-php-app", + "image": "your-php-app-image", + "environment": [ + { + "name": "DD_APPSEC_ENABLED", + "value": "true" + }, + { + "name": "DD_APM_TRACING_ENABLED", + "value": "false" + }, + { + "name": "DD_SERVICE", + "value": "" + }, + { + "name": "DD_ENV", + "value": "" + }, + { + "name": "DD_SITE", + "value": "{{< region-param key=\"dd_site\" >}}" + } + ] + } + ] +} +``` + +{{% /collapse-content %}} + +## 3. Exécution de votre application {#3-running-your-application} + +Déployez votre tâche Fargate avec la configuration mise à jour : + +```bash +aws ecs register-task-definition --cli-input-json file://task-definition.json +aws ecs run-task --cluster your-cluster --task-definition your-task-definition +``` + +{{% aap/aap_and_api_protection_verify_setup %}} + +## Dépannage {#troubleshooting} + +Si vous rencontrez des problèmes lors de la configuration de la protection des applications et des API pour votre application PHP, consultez le [guide de dépannage de la protection des applications et des API PHP][2]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/application_security/setup/compatibility/php +[2]: /fr/security/application_security/setup/php/troubleshooting \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/setup/python/kubernetes.md b/hugo/content/fr/security/application_security/setup/python/kubernetes.md new file mode 100644 index 00000000000..6ee37a78ccd --- /dev/null +++ b/hugo/content/fr/security/application_security/setup/python/kubernetes.md @@ -0,0 +1,125 @@ +--- +code_lang: kubernetes +code_lang_weight: 20 +further_reading: +- link: /security/application_security/how-it-works/ + tag: Documentation + text: Fonctionnement de la protection des applications et des API +- link: /security/default_rules/?category=cat-application-security + tag: Documentation + text: Règles de protection des applications et des API prêtes à l'emploi +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépannage de la protection des applications et des API +title: Configurer la protection des applications et des API pour Python dans Kubernetes +type: multi-code-lang +--- +{{% app_and_api_protection_python_setup_options platform="kubernetes" %}} + +{{% app_and_api_protection_python_overview %}} + +## Prérequis {#prerequisites} + +- Cluster Kubernetes +- Application Python conteneurisée avec Docker +- kubectl configuré pour accéder à votre cluster +- Helm (recommandé pour l'installation de l'Agent) +- Votre clé d'API Datadog +- SDK Datadog pour Python (voir [exigences de version][1]) + +## 1. Installation du Datadog Agent {#1-installing-the-datadog-agent} + +Installez le Datadog Agent en suivant les [instructions de configuration pour Kubernetes](/agent/?tab=cloud_and_container). + +## 2. Activation de la surveillance de la protection des applications et des API {#2-enabling-app-and-api-protection-monitoring} + +{{% app_and_api_protection_python_navigation_menu %}} +{{% appsec-remote-config-activation %}} + +### Activation manuelle de la surveillance de la protection des applications et des API {#manually-enabling-app-and-api-protection-monitoring} + +Installez le SDK Datadog pour Python à l'aide d'un conteneur d'initialisation ou dans le Dockerfile de votre application : + +```dockerfile +RUN pip install ddtrace +``` + +Configurez et exécutez votre service avec Datadog : + +{{% collapse-content title="Traçage APM activé" level="h4" %}} + +Démarrez votre application Python avec la protection des applications et des API activée à l'aide de variables d'environnement : + +```yaml +apiVersion: apps/v1 +kind: Deployment +metadata: + name: your-python-app +spec: + template: + spec: + containers: + - name: your-python-app + image: your-python-app-image + env: + - name: DD_APPSEC_ENABLED + value: "true" + - name: DD_SERVICE + value: "" + - name: DD_ENV + value: "" + command: ["ddtrace-run", "python", "app.py"] +``` + +{{% /collapse-content %}} + +{{% collapse-content title="Traçage APM désactivé" level="h4" %}} +Pour désactiver le traçage APM tout en conservant la protection des applications et des API activée, vous devez définir la variable de traçage APM sur false. + +Démarrez votre application Python avec la protection des applications et des API activée à l'aide de variables d'environnement : + +```yaml +apiVersion: apps/v1 +kind: Deployment +metadata: + name: your-python-app +spec: + template: + spec: + containers: + - name: your-python-app + image: your-python-app-image + env: + - name: DD_APPSEC_ENABLED + value: "true" + - name: DD_APM_TRACING_ENABLED + value: "false" + - name: DD_SERVICE + value: "" + - name: DD_ENV + value: "" + command: ["ddtrace-run", "python", "app.py"] +``` + +{{% /collapse-content %}} + +## 3. Exécutez votre application {#3-run-your-application} + +Appliquez votre déploiement mis à jour : + +```bash +kubectl apply -f your-deployment.yaml +``` + +{{% aap/aap_and_api_protection_verify_setup %}} + +## Dépannage {#troubleshooting} + +Si vous rencontrez des problèmes lors de la configuration de la protection des applications et des API pour votre application Python, consultez le [guide de dépannage de la protection des applications et des API Python][2]. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/application_security/setup/compatibility/python +[2]: /fr/security/application_security/setup/python/troubleshooting \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/terms.md b/hugo/content/fr/security/application_security/terms.md new file mode 100644 index 00000000000..9f5a0da7cb9 --- /dev/null +++ b/hugo/content/fr/security/application_security/terms.md @@ -0,0 +1,145 @@ +--- +disable_toc: false +further_reading: +- link: /security/application_security/how-it-works + tag: Documentation + text: Fonctionnement de la protection des applications et des API +- link: /security/application_security + tag: Documentation + text: App and API protection +- link: https://www.datadoghq.com/blog/datadog-threat-intelligence/ + tag: Blog + text: Accélérez les enquêtes de sécurité avec Datadog Threat Intelligence +title: Termes et concepts +--- +Datadog App and API Protection surveille les menaces et assure une protection contre les attaques au niveau des applications visant à exploiter des vulnérabilités au niveau du code. Il tire parti du contexte d'exécution du code au moment de l'exécution, des données de trace et d'erreur, ainsi que de l'attribution des utilisateurs. + +## Termes généraux d'App and API Protection {#general-app-and-api-protection-terms} + +tentative d'attaque +: Quelle règle de sécurité a été déclenchée par la trace. + +Bibliothèque Datadog +: _également_ tracer, SDK +: Une bibliothèque spécifique à un langage de programmation intégrée dans les applications web. Datadog App and API Protection utilise la bibliothèque pour surveiller et protéger. APM utilise la même bibliothèque pour instrumenter le code à des fins de télémétrie de traçage. + +règle de détection +: Une définition de logique conditionnelle appliquée aux données ingérées et aux configurations cloud. Lorsqu'au moins un cas défini dans une règle correspond à un événement sur une période donnée, Datadog génère un _signal de sécurité_. +: Voir [Règles de détection][10]. + +liste d'autorisation (anciennement filtre d'exclusion) +: Un mécanisme permettant de supprimer les traces de sécurité signalées par la bibliothèque Datadog App and API Protection et les règles In-App WAF. La liste d'autorisation est appliquée au fur et à mesure que les requêtes sont ingérées dans Datadog (intake). La liste d'autorisation aide à gérer les faux positifs et les coûts d'ingestion. +: Voir [Filtres d'exclusion][11] dans l'application. + +Règles WAF intégrées (anciennement règles d'événement) +: Un ensemble de règles exécutées dans les bibliothèques Datadog pour détecter une activité de sécurité. Il s'agit notamment de modèles Web Application Firewall (WAF) qui surveillent les tentatives d'exploitation de vulnérabilités connues. +: Voir [Règles WAF intégrées][12]. + +Remote Configuration +: Un mécanisme de la plateforme Datadog qui permet de mettre à jour la configuration de l'Agent à distance. Utilisé par Datadog App and API Protection pour mettre à jour les règles In-App WAF, activer le produit et bloquer les attaquants. +: Voir [Fonctionnement de Remote Configuration][8]. + +service +: Une application web, un microservice, une API ou une fonction unique. Remplit généralement une fonction métier. + +signal +: Une détection d'une attaque d'application qui impacte vos services. Les signaux identifient des menaces significatives que vous devez examiner et qui doivent être triées avec une priorité élevée. +: Voir [Signals Explorer][13] dans l'application. + +gravité +: Un indicateur de la rapidité avec laquelle une tentative d'attaque doit être triée et traitée. Basé sur une combinaison de facteurs, notamment l'impact potentiel et le risque de l'attaque. Les valeurs sont Critical, High, Medium, Low, Info. + +trace de sécurité +: Une trace distribuée pour laquelle une activité de sécurité a été signalée par les règles WAF intégrées. La trace sous-jacente est partagée avec APM, permettant des investigations plus approfondies et plus rapides. + +requête suspecte +: Une trace distribuée pour laquelle une activité de sécurité a été signalée par les règles WAF intégrées. La trace sous-jacente est partagée avec APM, permettant des investigations plus approfondies et plus rapides. + +attribution utilisateur +: Un mécanisme qui associe les requêtes suspectes aux utilisateurs connus dans vos systèmes. +: Voir [Suivi de l'activité utilisateur][14]. + +vulnérabilité +: Risque passif au sein d'une application. D'après [OWASP][1]: « Une vulnérabilité est une faille ou une faiblesse dans l'application, qui peut être un défaut de conception ou un bug d'implémentation, permettant à un attaquant de causer du tort aux parties prenantes d'une application. Les parties prenantes incluent le propriétaire de l'application, les utilisateurs de l'application et d'autres entités qui dépendent de l'application. » + +qualification de trace +: Le processus par lequel Datadog aide à comprendre l'impact des traces, en les étiquetant +comme `Harmful Safe or Unknown`. +: Voir [Qualification des traces][15]. + +renseignements sur les menaces +: Un ensemble de règles exécutées dans les bibliothèques Datadog pour détecter les menaces. Il s'agit notamment de modèles Web Application Firewall (WAF) qui surveillent les tentatives d'exploitation de vulnérabilités connues. +: Voir [Renseignements sur les menaces][16] + +attaquants suspects +: Un précurseur des adresses IP signalées. Les adresses IP suspectes ont atteint un seuil minimal de trafic d'attaque pour être classées comme suspectes, mais pas le seuil pour être signalées. Les seuils ne sont pas configurables par l'utilisateur. +: Voir [Attackers Explorer][17] + +attaquants signalés +: Adresses IP qui envoient de grandes quantités de trafic d'attaque. Nous recommandons d'examiner et de bloquer les adresses IP signalées. Les seuils ne sont pas configurables par l'utilisateur. +: Voir [Attackers Explorer][17] + +empreinte d'attaquant +: Identifiants calculés à partir des caractéristiques de la requête pour suivre un attaquant à travers plusieurs requêtes. +: Voir [Empreinte d'attaquant][18] + +cluster d'attaquants +: Un ensemble d'attributs identifiant un attaquant à travers une attaque distribuée. +: Voir [Regroupement d'attaquants][19] + +## Termes relatifs aux attaques et aux vulnérabilités connues {#attacks-and-known-vulnerabilities-terms} + +Open Web Application Security Project (OWASP) +: Une fondation à but non lucratif avec plusieurs projets visant à améliorer la sécurité des applications web. L'OWASP est surtout connu pour l'[OWASP Top 10][2], un large consensus sur les risques de sécurité les plus critiques pour les applications web. + +Scripts intersites (XSS) +: Un type d'attaque par injection dans lequel des scripts malveillants sont injectés dans des sites web par ailleurs fiables. +: Voir [XSS sur l'OWASP][3]. + +Injection de langage de requête structuré (SQLi, injection SQL) : +: Un type d'attaque par injection dans lequel une requête SQL est exécutée via les données d'entrée du client vers l'application. Des commandes SQL sont injectées dans les données d'entrée du plan de données afin d'affecter l'exécution de commandes SQL prédéfinies. Une exploitation réussie d'injection SQL peut lire des données sensibles de la base de données, modifier des données de la base de données (Insertion/Mise à jour/Suppression), exécuter des opérations d'administration sur la base de données (telles que l'arrêt du SGBD), récupérer le contenu d'un fichier donné présent sur le système de fichiers du SGBD, et dans certains cas, émettre des commandes vers le système d'exploitation. +: **Connexe :**: Injection de langage de requête Cassandra (CQLi), injection NoSQL (NoSQLi) — similaire à SQLi mais pour le langage de requête Cassandra et NoSQL. +: Voir [Injection SQL sur OWASP][4]. + +Falsification de requête côté serveur (SSRF) +: Une vulnérabilité où une application web récupère une ressource distante sans valider l'URL fournie par l'utilisateur. Elle permet à un attaquant de contraindre l'application à envoyer une requête conçue vers une destination inattendue, même lorsqu'elle est protégée par un pare-feu, un VPN ou un autre type de liste de contrôle d'accès (ACL) réseau. +: Voir [Falsification de requête côté serveur sur OWASP][5]. + +Inclusion de fichier local (LFI) +: Une vulnérabilité qui permet à un attaquant d'inclure un fichier présent localement sur le serveur lors du traitement de la requête. Dans la plupart des cas, cela permet à l'attaquant de lire des informations sensibles stockées dans des fichiers sur le serveur. Dans des cas plus graves, l'exploitation peut conduire à du cross-site scripting ou à une exécution de code à distance. +: Voir [Test de LFI sur OWASP][6]. + +Inclusion de fichier distant (RFI) +: Une vulnérabilité similaire à l'inclusion de fichier local, mais qui permet à un attaquant d'inclure un fichier distant lors du traitement de la requête. Les fichiers utilisés dans les attaques par inclusion de fichier distant contiennent le plus souvent du code malveillant pour PHP, JSP ou des technologies similaires. + +Exécution de code à distance (RCE) +: Une vulnérabilité qui permet à un attaquant d'exécuter du code à distance sur une machine. + +Injection du langage de navigation dans les graphes d'objets (OGNLi) +: Une vulnérabilité qui permet à un attaquant d'exécuter sa propre expression OGNL dans une application Java, menant le plus souvent à une exécution de code à distance. +: Voir [OGNLi dans l'OWASP Top 10][7]. + + + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://owasp.org/www-community/vulnerabilities/ +[2]: https://owasp.org/www-project-top-ten/ +[3]: https://owasp.org/www-community/attacks/xss/ +[4]: https://owasp.org/www-community/attacks/SQL_Injection +[5]: https://owasp.org/Top10/A10_2021-Server-Side_Request_Forgery_%28SSRF%29/ +[6]: https://owasp.org/www-project-web-security-testing-guide/v42/4-Web_Application_Security_Testing/07-Input_Validation_Testing/11.1-Testing_for_Local_File_Inclusion +[7]: https://owasp.org/www-project-top-ten/2017/A1_2017-Injection +[8]: /fr/remote_configuration +[10]: /fr/security/detection_rules/ +[11]: https://app.datadoghq.com/security/appsec/exclusions +[12]: /fr/security/application_security/policies/inapp_waf_rules/ +[13]: https://app.datadoghq.com/security/appsec/signals?query=%40workflow.rule.type%3A%22Application%20Security%22&view=signal +[14]: /fr/security/application_security/how-it-works/add-user-info/ +[15]: /fr/security/application_security/how-it-works/trace_qualification/ +[16]: /fr/security/application_security/how-it-works/threat-intelligence/ +[17]: /fr/security/application_security/security_signals/attacker-explorer/ +[18]: /fr/security/application_security/security_signals/attacker_fingerprint/ +[19]: /fr/security/application_security/security_signals/attacker_clustering/ \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/threat_protection/_index.md b/hugo/content/fr/security/application_security/threat_protection/_index.md new file mode 100644 index 00000000000..11d21c71127 --- /dev/null +++ b/hugo/content/fr/security/application_security/threat_protection/_index.md @@ -0,0 +1,36 @@ +--- +description: Détectez, effectuez des investigations et bloquez les attaques contre + les applications et les API en temps réel grâce à la protection contre les menaces + dans App and API Protection. +further_reading: +- link: https://www.datadoghq.com/blog/datadog-exploit-prevention/ + tag: Blog + text: Protégez vos applications contre les attaques zero-day avec Datadog Exploit + Prevention +title: Protection contre les menaces +--- +Utilisez la protection contre les menaces dans [App and API Protection][1] (AAP) pour détecter les attaques contre vos applications et les API, effectuer des investigations et bloquer le trafic malveillant en temps réel. + +Pour commencer, [configurez AAP][2] sur vos services afin qu'ils rapportent des traces de sécurité. AAP détecte ensuite les menaces provenant du trafic en direct de vos applications et vous permet d'y répondre. + +## Comment fonctionne la protection contre les menaces {#how-threat-protection-works} + +La protection contre les menaces rassemble plusieurs fonctionnalités, toutes basées sur les données de trafic des applications en direct. Avec la protection contre les menaces, vous pouvez : + +- Détectez et effectuez des investigations sur les menaces avec les [Security Signals][3]. Datadog crée un signal de sécurité lorsqu'il détecte une menace à partir d'une règle de détection, afin que vous puissiez trier, filtrer et effectuer des investigations sur les attaques dans le Signals Explorer. +- Bloquez les attaques et les attaquants avec les [Policies][4]. Bloquez les adresses IP et les utilisateurs malveillants en temps réel depuis l'interface utilisateur de Datadog, manuellement ou via des règles automatisées. +- Arrêtez les tentatives d'exploitation dans le code avec [Exploit Prevention][5]. Détectez et bloquez les tentatives d'exploitation de vulnérabilités, y compris les attaques zero-day, depuis l'application en cours d'exécution. +- Étendez la protection au périmètre avec les [intégrations WAF][6]. Combinez la protection intégrée aux applications avec des défenses de périmètre telles qu'AWS WAF pour une approche de défense en profondeur. +- Défendez les comptes utilisateurs avec [Account Takeover Protection][7]. Détectez et atténuez les attaques de prise de contrôle de compte, telles que le credential stuffing, et désactivez les utilisateurs compromis. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/application_security/ +[2]: /fr/security/application_security/setup/ +[3]: /fr/security/application_security/threat_protection/security_signals/ +[4]: /fr/security/application_security/threat_protection/policies/ +[5]: /fr/security/application_security/threat_protection/exploit-prevention/ +[6]: /fr/security/application_security/threat_protection/waf-integration/ +[7]: /fr/security/application_security/threat_protection/account_takeover_protection/ \ No newline at end of file diff --git a/hugo/content/fr/security/application_security/threat_protection/policies/custom_rules.md b/hugo/content/fr/security/application_security/threat_protection/policies/custom_rules.md new file mode 100644 index 00000000000..981b2ca782a --- /dev/null +++ b/hugo/content/fr/security/application_security/threat_protection/policies/custom_rules.md @@ -0,0 +1,120 @@ +--- +aliases: +- /fr/security/application_security/policies/custom_rules/ +- /fr/security_platform/application_security/custom_rules +- /fr/security/application_security/custom_rules +- /fr/security/application_security/threats/attacker_fingerprint +further_reading: +- link: /security/application_security/ + tag: Documentation + text: Protégez contre les menaces avec Datadog App and API Protection +- link: /security/application_security/threat_protection/policies/inapp_waf_rules/ + tag: Documentation + text: Création de règles WAF dans l'application +- link: /security/application_security/troubleshooting + tag: Documentation + text: Dépanner les problèmes courants de Datadog App and API Protection +- link: /security/notifications/variables/ + tag: Documentation + text: En savoir plus sur les variables de notification de Security +- link: /tracing/trace_explorer/query_syntax/ + tag: Documentation + text: Syntaxe pour définir la requête AAP +title: Règles de détection personnalisées +--- +## Présentation {#overview} + +App and API Protection (AAP) est fourni avec un ensemble de [règles de détection prêtes à l'emploi][1] qui visent à détecter les tentatives d'attaque, les vulnérabilités découvertes par les attaquants et les abus de logique métier qui impactent vos systèmes de production. + +Cependant, il existe des situations où vous pourriez vouloir personnaliser une règle en fonction de votre environnement ou de votre charge de travail. Par exemple, vous pourriez vouloir personnaliser une règle de détection qui identifie les utilisateurs effectuant des actions sensibles depuis une géolocalisation où votre entreprise n'opère pas. + +Un autre exemple est la personnalisation d'une règle pour exclure un scanner de sécurité interne. AAP détecte son activité comme prévu. Cependant, vous ne souhaitez peut-être pas être notifié de son scan régulier. + +Dans ces situations, une règle de détection personnalisée peut être créée pour exclure de tels événements. Ce guide vous montre comment créer une règle de détection personnalisée pour AAP. + +## Règle de détection d'abus de logique métier {#business-logic-abuse-detection-rule} + +AAP propose des règles prêtes à l'emploi pour détecter les abus de logique métier (par exemple, la réinitialisation d'un mot de passe par force brute). Ces règles nécessitent [d'ajouter des informations de logique métier aux traces][7]. + +Les SDK Datadog récents tentent de détecter et d'envoyer automatiquement les événements de connexion et d'inscription des utilisateurs sans avoir besoin de modifier le code. Si nécessaire, vous pouvez [désactiver le suivi automatique des événements d'activité utilisateur][8]. + +Vous pouvez filtrer les règles et identifier la logique métier dont vous souhaitez commencer le suivi. De plus, vous pouvez utiliser ces règles comme modèle pour créer des règles personnalisées basées sur votre propre logique métier. + +Consultez la section ci-dessous pour savoir comment configurer vos règles. + +## Configuration {#configuration} + +Pour personnaliser une règle de détection prête à l'emploi, vous devez d'abord cloner une règle existante. Accédez à vos [Règles de détection][2] et sélectionnez une règle. Faites défiler jusqu'en bas de la règle et cliquez sur le bouton {{< ui >}}Clone Rule{{< /ui >}}. Cela vous permet désormais de modifier la règle existante. + +### Définir une requête AAP {#define-an-aap-query} + +Construisez une requête AAP en utilisant la [même syntaxe de requête que dans l'AAP Trace Explorer][3]. Par exemple, créez une requête pour surveiller les connexions réussies depuis l'extérieur des États-Unis : `@appsec.security_activity:business_logic.users.login.success -@actor.ip_details.country.iso_code:US`. + +Optionnellement, définissez un compte unique et un regroupement de signaux. Comptez le nombre de valeurs uniques observées pour un attribut dans un laps de temps donné. Le regroupement défini génère un signal pour chaque valeur de regroupement. Généralement, le regroupement est une entité (comme un utilisateur, une adresse IP ou un service). Le regroupement est également utilisé pour [joindre les requêtes entre elles](#joining-queries). + +Utilisez la section de prévisualisation pour voir quelles traces AAP correspondent à la requête de recherche. Vous pouvez également ajouter des requêtes supplémentaires avec le bouton {{< ui >}}Add Query{{< /ui >}}. + +##### Joindre des requêtes {#joining-queries} + +Joindre des requêtes pour couvrir une période peut augmenter la confiance ou la gravité du signal de sécurité. Par exemple, pour détecter une attaque réussie, les déclencheurs réussis et infructueux peuvent être corrélés pour un service. + +Les requêtes sont corrélées entre elles en utilisant une valeur `group by`. La valeur `group by` est généralement une entité (par exemple, `IP` ou `Service`), mais peut être n'importe quel attribut. + +Par exemple, créez des requêtes opposées qui recherchent la même activité `business_logic.users.login.success`, mais ajoutez des requêtes de chemin HTTP opposées pour les tentatives réussies et infructueuses : + +Requête 1 : `@appsec.security_activity:business_logic.users.login.success @actor.ip_details.country.iso_code:US`. + +Requête 2 : `@appsec.security_activity:business_logic.users.login.success -@actor.ip_details.country.iso_code:US`. + +Dans ce cas, les requêtes jointes détiennent techniquement la même valeur d'attribut : la valeur doit être la même pour que le cas soit satisfait. Si une valeur `group by` n'existe pas, le cas ne sera jamais satisfait. Un signal de sécurité est généré pour chaque valeur `group by` unique lorsqu'un cas correspond. + +### Exclure l'activité bénigne avec des requêtes de suppression {#exclude-benign-activity-with-suppression-queries} + +Dans le champ {{< ui >}}Only generate a signal if there is a match{{< /ui >}}, vous avez la possibilité de saisir une requête afin qu'un déclencheur ne soit généré que lorsqu'une valeur est atteinte. + +Dans le champ {{< ui >}}This rule will not generate a signal if there is a match{{< /ui >}}, vous avez la possibilité de saisir des requêtes de suppression afin qu'un déclencheur ne soit pas généré lorsque les valeurs sont atteintes. Par exemple, si un service déclenche un signal, mais que l'action est bénigne et que vous ne souhaitez plus que des signaux soient déclenchés par ce service, créez une requête qui exclut `service`. + +### Définir un cas de règle {#set-a-rule-case} + +#### Déclencheur {#trigger} + +Les cas de règle, tels que `successful login > 0`, sont évalués comme des instructions de cas. Ainsi, le premier cas correspondant génère le signal. Créez un ou plusieurs cas de règle, puis cliquez sur la zone grise à côté d'eux pour les faire glisser et réorganiser leur ordre. + +Un cas de règle contient des opérations logiques (`>, >=, &&, ||`) pour déterminer si un signal doit être généré en fonction des nombres d'événements dans les requêtes précédemment définies. + +**Remarque** : L'étiquette de la requête doit précéder l'opérateur. Par exemple, `a > 3` est autorisé ; `3 < a` n'est pas autorisé. + +Donnez un nom à chaque cas de règle. Ce nom est ajouté au nom de la règle lorsqu'un signal est généré. + +#### Gravité et notification {#severity-and-notification} + +{{% security-rule-severity-notification %}} + +### Fenêtres temporelles {#time-windows} + +{{% security-rule-time-windows %}} + +Cliquez sur {{< ui >}}Add Case{{< /ui >}} pour ajouter des cas supplémentaires. + +**Remarque** : Le `evaluation window` doit être inférieur ou égal au `keep alive` et au `maximum signal duration`. + +### Indiquez ce qui se passe {#say-whats-happening} + +{{% security-rule-say-whats-happening %}} + +Utilisez le menu déroulant {{< ui >}}Tag resulting signals{{< /ui >}} pour ajouter des tags à vos signaux. Par exemple, `attack:sql-injection-attempt`. + +**Remarque** : Le tag `security` est spécial. Ce tag est utilisé pour classer le signal de sécurité. Les options recommandées sont : `attack`, `threat-intel`, `compliance`, `anomaly` et `data-leak`. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/security/default_rules/?category=cat-application-security +[2]: https://app.datadoghq.com/security/appsec/signals-rules +[3]: /fr/tracing/trace_explorer/query_syntax/ +[4]: /fr/monitors/notify/?tab=is_alert#integrations +[5]: /fr/security/notifications/variables/ +[6]: /fr/security/notifications/variables/#template-variables +[7]: /fr/security/application_security/how-it-works/add-user-info/?tab=set_user#adding-business-logic-information-login-success-login-failure-any-business-logic-to-traces +[8]: /fr/security/application_security/how-it-works/add-user-info/?tab=set_user#disabling-automatic-user-activity-event-tracking \ No newline at end of file diff --git a/hugo/content/fr/security/code_security/dev_tool_int/ide_plugins/_index.md b/hugo/content/fr/security/code_security/dev_tool_int/ide_plugins/_index.md new file mode 100644 index 00000000000..47ed11127cf --- /dev/null +++ b/hugo/content/fr/security/code_security/dev_tool_int/ide_plugins/_index.md @@ -0,0 +1,32 @@ +--- +aliases: +- /fr/code_analysis/ide_plugins/ +description: Apprenez à configurer les plugins IDE Datadog pour une sécurité du code + et une assurance qualité renforcées dans votre environnement de développement. +disable_toc: false +title: Datadog IDE Plugins pour Code Security +--- +## Présentation {#overview} + +[Code Security][1] s'intègre à VS Code, Cursor et aux IDE JetBrains pour fournir des retours en temps réel sur la sécurité et la qualité du code. La prise en charge varie selon l'IDE : + +| Fonctionnalité | Visual Studio Code & Cursor | IDE JetBrains | +|---|---|---| +| [Static Code Analysis (SAST)][2] | Pris en charge | Pris en charge | +| [Software Composition Analysis (SCA)][3] | Pris en charge | Pris en charge | +| [Runtime Code Analysis (IAST)][4] | Pris en charge | Pris en charge | +| [Secret Scanning][5] | Pris en charge | Pris en charge | +| [Infrastructure as Code (IaC) Scanning (IaC)][6] | Pris en charge | Non pris en charge | + +{{< whatsnext desc="Consultez la documentation pour obtenir des informations sur les intégrations suivantes :">}} + {{< nextlink href="ide_plugins/idea/" >}}IDE JetBrains : IntelliJ IDEA, GoLand, PyCharm, RubyMine, WebStorm et PhpStorm{{< /nextlink >}} + {{< nextlink href="ide_plugins/vscode/" >}}Visual Studio Code & Cursor{{< /nextlink >}} +{{< /whatsnext >}} + + +[1]: /fr/security/code_security/ +[2]: /fr/security/code_security/static_analysis/ +[3]: /fr/security/code_security/software_composition_analysis/ +[4]: /fr/security/code_security/iast/ +[5]: /fr/security/code_security/secret_scanning/ +[6]: /fr/security/code_security/iac_security/ \ No newline at end of file diff --git a/hugo/content/fr/security/code_security/static_analysis/_index.md b/hugo/content/fr/security/code_security/static_analysis/_index.md new file mode 100644 index 00000000000..24fda211950 --- /dev/null +++ b/hugo/content/fr/security/code_security/static_analysis/_index.md @@ -0,0 +1,191 @@ +--- +algolia: + tags: + - static analysis + - datadog static analysis + - code quality + - SAST +aliases: +- /fr/code_analysis/static_analysis +description: Découvrez Datadog Static Code Analysis pour analyser votre code à la + recherche de problèmes de qualité et de vulnérabilités de sécurité avant qu'il n'atteigne + la production. +further_reading: +- link: https://www.datadoghq.com/blog/secure-your-github-ecosystem/ + tag: Blog + text: 'Sécurité CI/CD : comment sécuriser votre écosystème GitHub' +- link: https://www.datadoghq.com/blog/bitsai-dev-agent-code-security + tag: Blog + text: Présentation de Bits Code pour Code Security +- link: https://www.datadoghq.com/blog/code-security-secret-scanning + tag: Blog + text: Détectez et bloquez les identifiants exposés avec Datadog Secret Scanning. +- link: https://www.datadoghq.com/blog/using-llms-to-filter-out-false-positives/ + tag: Blog + text: Utiliser des LLMs pour filtrer les faux positifs de l'analyse de code statique +is_beta: false +title: Static Code Analysis (SAST) +--- +{{% site-region region="gov,gov2" %}} +
+ Code Security n'est pas disponible pour le {{< region-param key="dd_site_name" >}} site. +
+{{% /site-region %}} + + +## Présentation {#overview} + +Static Code Analysis est la fonctionnalité de Static Application Security Testing (SAST) de Datadog. Le SAST est une technique de test logiciel en boîte blanche qui analyse le code pré-production d'un programme sans avoir besoin de l'exécuter. + +Static Code Analysis vous aide à identifier les vulnérabilités de sécurité et les problèmes de maintenabilité tôt dans le cycle de vie du développement logiciel (SDLC) pour garantir que seul le code le plus sécurisé et de la plus haute qualité arrive en production. Elle offre aux organisations les avantages suivants : + +* Les applications sont moins vulnérables aux failles de sécurité au fil du temps, car les nouvelles vulnérabilités sont détectées par les analyses SAST avant que le code n'atteigne la production. +* Élimine les incertitudes liées au respect des normes de code d'une organisation, permettant à votre équipe de développement de livrer du code conforme sans impact significatif sur la vélocité des développeurs. +* Intégrez les développeurs plus rapidement, car Static Code Analysis permet à une organisation de maintenir une base de code plus lisible au fil du temps. + +## Configurer Static Code Analysis {#set-up-static-code-analysis} + +Static Code Analysis prend en charge la recherche de vulnérabilités de sécurité et de mauvaises pratiques de codage dans les langages et technologies suivants : + +{{< card-grid card_width="130px" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Python" src="integrations_logos/python_avatar.svg" alt="python" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=JavaScript" src="integrations_logos/javascript_large.png" alt="javascript" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=TypeScript" src="integrations_logos/typescript_large.svg" alt="typescript" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Java" src="integrations_logos/java_avatar.svg" alt="java" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=CSharp" src="integrations_logos/dotnet_avatar.svg" alt="c sharp" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Go" src="integrations_logos/golang-avatar.png" alt="go" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Ruby" src="integrations_logos/ruby_avatar.svg" alt="ruby" image_width="60" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=PHP" src="integrations_logos/php_opcache.png" alt="php" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Docker" src="integrations_logos/docker_avatar.svg" alt="docker" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=YAML" src="integrations_logos/yaml.png" alt="yaml" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Kotlin" src="integrations_logos/kotlin.png" alt="kotlin" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Elixir" src="integrations_logos/elixir.png" alt="elixir" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Apex" src="integrations_logos/salesforce_large.svg" alt="apex" >}} + {{< image-card href="/security/code_security/static_analysis/static_analysis_rules?languages=Swift" src="integrations_logos/swift_large.svg" alt="swift" >}} + {{< image-card href="/security/code_security/static_analysis/setup/?tab=circleciorbs#upload-third-party-static-analysis-results-to-datadog" src="integrations_logos/datadog_avatar.svg" alt="autre" >}} +{{< /card-grid >}} + +Les analyses peuvent être exécutées via vos pipelines CI/CD ou directement dans Datadog avec l'analyse hébergée. +Pour commencer, accédez à la [{{< ui >}}Code Security{{< /ui >}} page de configuration][12] ou consultez la [documentation de configuration][9]. + +## Intégrer au cycle de vie du développement {#integrate-into-the-development-lifecycle} + +### Gestion du code source {#source-code-management} +{{< whatsnext desc="Lors des revues de code, Datadog peut automatiquement signaler les violations de Static Code Analysis dans les pull requests en ajoutant des commentaires de revue en ligne sur la ou les lignes de code concernées. Ceci est pris en charge pour les dépôts GitHub, GitLab et Azure DevOps (hébergés dans le cloud). Le cas échéant, Datadog fournit également des suggestions de correctifs qui peuvent être appliquées directement dans la pull request." >}} + {{< nextlink href="static_analysis/github_pull_requests" >}}Pull requests{{< /nextlink >}} +{{< /whatsnext >}} + +### IDEs {#ides} +{{< whatsnext desc="Vous pouvez identifier les vulnérabilités du code en temps réel lorsque vous modifiez un fichier dans votre environnement de développement intégré (IDE). Consultez la documentation spécifique à l'intégration pour plus d'informations :">}} + {{< nextlink href="ide_plugins/idea/code_security/" >}}Plugin Datadog pour les IDE JetBrains{{< /nextlink >}} + {{< nextlink href="ide_plugins/vscode/code_security/" >}}Extension Datadog pour Visual Studio Code et Cursor{{< /nextlink >}} +{{< /whatsnext >}} + +## Rechercher et filtrer les résultats {#search-and-filter-results} +Après la configuration de Static Code Analysis, une analyse est effectuée à chaque commit sur un dépôt analysé. Les violations sont résumées par dépôt sur la [{{< ui >}}Code Security Repositories{{< /ui >}} page][1]. Cliquez sur un dépôt pour analyser les résultats {{< ui >}}Code Vulnerabilities{{< /ui >}} et {{< ui >}}Code Quality{{< /ui >}} de Static Code Analysis. + +* L'onglet {{< ui >}}Code Vulnerabilities{{< /ui >}} contient les violations trouvées par les règles de Datadog dans la [catégorie Security][2]. +* L'onglet {{< ui >}}Code Quality{{< /ui >}} contient les violations trouvées par les règles de Datadog dans les [catégories Best Practices, Code Style, Error Prone ou Performance][3]. + +Pour filtrer vos résultats, utilisez les facettes à gauche de la liste, ou effectuez une recherche. Les résultats peuvent être [filtrés par facettes de service ou d'équipe][13]. + +Chaque ligne représente une violation. Chaque violation est associée au commit et à la branche spécifiques sélectionnés dans les filtres en haut de la page (par défaut, les résultats sont affichés pour le dernier commit sur la branche par défaut du dépôt que vous consultez). + +Cliquez sur une violation pour ouvrir un panneau latéral contenant des informations sur l'étendue de la violation et son origine. + + + +Le contenu de la violation est réparti dans plusieurs onglets : + +- {{< ui >}}Details{{< /ui >}} : Une description de la violation et des lignes de code qui l'ont provoquée. Pour voir l'extrait de code incriminé, configurez l'intégration de code source appropriée pour votre fournisseur ([GitHub][4], [GitLab][5], Azure[6]). +- {{< ui >}}Remediation{{< /ui >}} : Une ou plusieurs corrections de code permettant de résoudre la violation, avec des options de remédiation. +- {{< ui >}}Event{{< /ui >}} : Métadonnées JSON concernant la violation. + +### Exclure les faux positifs {#filter-out-false-positives} +Pour un sous-ensemble de vulnérabilités SAST, Bits AI peut examiner le contexte et évaluer s'il s'agit plus probablement d'un vrai ou d'un faux positif, accompagné d'une brève explication du raisonnement. + +Pour plus d'informations, consultez [Static Code Analysis amélioré par l'IA][17]. + +## Personnalisez votre configuration {#customize-your-configuration} +Pour personnaliser les règles de Static Code Analysis configurées dans vos dépôts ou dans l'ensemble de votre organisation, consultez la [documentation de configuration][8]. + +## Liez les résultats aux services et équipes Datadog {#link-findings-to-datadog-services-and-teams} +Pour lier les résultats aux services et équipes Datadog, consultez la [documentation de configuration][13]. + +## Appliquer les corrections suggérées {#apply-suggested-fixes} + + +Dans Datadog Static Code Analysis, il existe deux types de corrections suggérées : + +1. **Correction suggérée déterministe :** Pour les violations simples comme les problèmes de linting, l'analyseur de règles fournit automatiquement des corrections basées sur des modèles. +2. **Correctif suggéré par l'IA :** Pour les violations complexes, les correctifs ne sont généralement pas disponibles à l'avance. Au lieu de cela, vous pouvez utiliser les correctifs suggérés par l'IA, qui utilisent GPT-4 d'OpenAI pour générer un correctif suggéré. Vous pouvez choisir entre les correctifs {{< ui >}}Text{{< /ui >}} et {{< ui >}}Unified Diff{{< /ui >}}, qui produisent respectivement des instructions en texte brut ou une modification de code pour résoudre la violation. + + + +### Corrigez une vulnérabilité ou un problème de qualité directement depuis Datadog {#fix-a-vulnerability-or-quality-issue-directly-from-datadog} + + + +Si GitHub est votre gestionnaire de code source, vous pouvez envoyer une modification de code pour corriger un problème SAST directement depuis Datadog de deux manières. + +#### Ouvrez une pull request {#open-a-pull-request} +Si l'autorisation {{< ui >}}Pull Requests{{< /ui >}} de votre application GitHub est définie sur {{< ui >}}Read & Write{{< /ui >}}, la remédiation en un clic est activée pour toutes les violations de Static Code Analysis disposant d'un correctif suggéré. + +Suivez ces étapes pour corriger une vulnérabilité et ouvrir une pull request : +1. Affichez un résultat SAST spécifique dans Code Security. +2. Cliquez sur {{< ui >}}Fix Violation{{< /ui >}} dans le panneau latéral du résultat. +3. Sélectionnez {{< ui >}}Open a Pull Request{{< /ui >}}. +4. Saisissez un titre de pull request et un message de validation. +5. Cliquez sur {{< ui >}}Create PR{{< /ui >}}. + +#### Validez directement sur la branche actuelle {#commit-directly-to-the-current-branch} +Vous pouvez également corriger une vulnérabilité en validant directement sur la branche où le résultat a été trouvé. + +Pour valider un correctif suggéré : + +1. Affichez un résultat SAST spécifique dans Code Security. +2. Cliquez sur {{< ui >}}Fix Violation{{< /ui >}} dans le panneau latéral du résultat. +3. Cliquez sur {{< ui >}}Commit to current branch{{< /ui >}}. + +### Fix with Cursor {#fix-with-cursor} +Vous pouvez confier la remédiation d'une violation SAST à un agent de codage IA tel que Cursor. + +1. Affichez un résultat SAST spécifique dans Code Security. +2. Dans la section {{< ui >}}Next Steps{{< /ui >}} > {{< ui >}}Remediation{{< /ui >}} du panneau latéral, cliquez sur {{< ui >}}Remediate with AI{{< /ui >}}. +3. Sélectionnez l'onglet {{< ui >}}Coding agent{{< /ui >}}. +4. Sous {{< ui >}}Generate your fix directly from Claude Code, Codex, or Cursor{{< /ui >}}, cliquez sur {{< ui >}}Open{{< /ui >}} à côté de {{< ui >}}Fix with Cursor{{< /ui >}}. Datadog ouvre Cursor avec une invite de remédiation adaptée à la violation. Examinez les modifications suggérées avant de les valider. + +Pour utiliser un autre agent de codage IA, cliquez sur {{< ui >}}Copy{{< /ui >}} à côté de {{< ui >}}Copy fix prompt{{< /ui >}} et collez l'invite dans l'agent de votre choix. + +Pour gérer le lien profond Cursor, installez l'extension [Datadog extension for VS Code and Cursor](/ide_plugins/vscode/?tab=cursor). + +{{< img src="code_security/static_analysis/fix-with-cursor.png" alt="La boîte de dialogue Remediate with AI avec l'onglet Coding agent sélectionné, affichant les options Fix with Cursor et Copy fix prompt" style="width:100%;" >}} + +## Signaler des faux positifs {#report-false-positives} +Si vous pensez qu'une violation spécifique est un faux positif, vous pouvez la signaler comme telle en indiquant le motif, ce qui envoie un rapport directement à Datadog. Les soumissions sont examinées régulièrement afin d'améliorer la qualité de l'ensemble des règles au fil du temps. + + + +## + +[1]: https://app.datadoghq.com/ci/code-analysis +[2]: /fr/security/code_security/static_analysis_rules?categories=Security +[3]: /fr/security/code_security/static_analysis_rules?categories=Best+Practices&categories=Code+Style&categories=Error+Prone&categories=Performance +[4]: /fr/integrations/github/ +[5]: /fr/integrations/gitlab-source-code/ +[6]: https://en.wikipedia.org/wiki/Camel_case +[7]: https://en.wikipedia.org/wiki/Snake_case +[8]: /fr/security/code_security/static_analysis/setup/#customize-your-configuration +[9]: /fr/security/code_security/static_analysis/setup +[10]: /fr/security/code_security/dev_tool_int/github_pull_requests/ +[11]: /fr/getting_started/code_security/ +[12]: https://app.datadoghq.com/security/configuration/code-security/setup +[13]: /fr/security/code_security/static_analysis/setup/?tab=github#link-findings-to-datadog-services-and-teams +[14]: /fr/account_management/teams/ +[15]: /fr/integrations/github/#connect-github-teams-to-datadog-teams +[16]: /fr/integrations/azure-devops-source-code/ +[17]: /fr/security/code_security/static_analysis/ai_enhanced_sast/ \ No newline at end of file diff --git a/hugo/content/fr/security/workload_protection/_index.md b/hugo/content/fr/security/workload_protection/_index.md index 7e31e40b2b1..ae6c766a6ab 100644 --- a/hugo/content/fr/security/workload_protection/_index.md +++ b/hugo/content/fr/security/workload_protection/_index.md @@ -29,6 +29,12 @@ cascade: description: Détectez et répondez aux menaces à l'exécution sur vos hosts, conteneurs et charges de travail serverless avec Datadog Workload Protection. further_reading: +- link: https://learn.datadoghq.com/courses/workload-protection-detect-compromises + tag: Centre d'apprentissage + text: Détectez les compromissions de hosts et de conteneurs avec Workload Protection +- link: https://learn.datadoghq.com/courses/workload-protection-enable-manage + tag: Centre d'apprentissage + text: Activez et gérez Workload Protection - link: https://www.datadoghq.com/blog/workload-protection-investigation/ tag: Blog text: Transformez des signaux d'exécution fragmentés en scénarios d'attaque cohérents @@ -37,12 +43,6 @@ further_reading: tag: Blog text: Identifiez et corrigez les problèmes de posture à l'exécution avec Workload Protection Findings -- link: https://learn.datadoghq.com/courses/workload-protection-detect-compromises - tag: Centre d'apprentissage - text: Détectez les compromissions de hosts et de conteneurs avec Workload Protection -- link: https://learn.datadoghq.com/courses/workload-protection-enable-manage - tag: Centre d'apprentissage - text: Activez et gérez Workload Protection title: Workload Protection --- Datadog Workload Protection offre une visibilité et une défense en temps réel pour votre infrastructure en surveillant en continu l'activité des fichiers, du réseau et des processus dans vos environnements. Il détecte les menaces au moment où elles surviennent, générant des signaux de sécurité et des constatations. Utilisez-les pour identifier, enquêter et arrêter les comportements malveillants avant qu'ils n'impactent vos charges de travail. @@ -53,11 +53,11 @@ Workload Protection fait partie de la plateforme Datadog Security. Les signaux s Workload Protection ne se limite pas à la détection des menaces à l'exécution. De nombreuses organisations l'utilisent dans divers cas d'utilisation opérationnels et de sécurité : -- **Validation de la conformité :** Workload Protection vous aide à valider la conformité avec des cadres réglementaires tels que PCI, FedRAMP et SOC 2 en surveillant en continu l'activité à l'exécution pour détecter les violations de politiques, les configurations risquées et les changements non autorisés. +- **Validation de la conformité :** Workload Protection vous aide à valider la conformité avec des cadres réglementaires tels que PCI, FedRAMP et SOC 2 en surveillant en continu l'activité à l'exécution pour détecter les violations de politiques, les configurations risquées et les changements non autorisés. -- **Posture de sécurité à l'exécution :** Workload Protection améliore votre posture de sécurité en identifiant les pratiques d'exécution non sécurisées et les dérives de configuration sensibles, vous aidant à détecter les faiblesses avant qu'elles ne puissent être exploitées. +- **Posture de sécurité à l'exécution :** Workload Protection améliore votre posture de sécurité en identifiant les pratiques d'exécution non sécurisées et les dérives de configuration sensibles, vous aidant à détecter les faiblesses avant qu'elles ne puissent être exploitées. -- **Surveillance de l'infrastructure :** Workload Protection suit tout type de comportement à l'exécution, qu'il soit lié à la sécurité ou non. Du débogage de charges de travail personnalisées à la surveillance des processus au niveau du système et des sessions utilisateur à distance, il offre une visibilité en temps réel sur le fonctionnement de vos environnements. +- **Infrastructure Monitoring :** Workload Protection suit tout type de comportement à l'exécution, qu'il soit lié à la sécurité ou non. Du débogage de charges de travail personnalisées à la surveillance des processus au niveau du système et des sessions utilisateur à distance, il offre une visibilité en temps réel sur le fonctionnement de vos environnements. {{< img src="security/workload_protection/k8s_remote_access.png" alt="Répartition des sessions utilisateur à distance Kubernetes" width="100%">}} @@ -150,4 +150,8 @@ Utilisez [Coverage][5] pour obtenir une vue unifiée et en temps réel de la pos [13]: /fr/security/workload_protection/detect_and_monitor/threat_intelligence [14]: /fr/security/workload_protection/detect_and_monitor/agent_rules/policy_management [15]: /fr/actions/workflows/ -[16]: /fr/security/workload_protection/investigate_and_triage/security_signals/actions \ No newline at end of file +[16]: /fr/security/workload_protection/investigate_and_triage/security_signals/actions + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file diff --git a/hugo/content/fr/serverless/guide/opentelemetry.md b/hugo/content/fr/serverless/guide/opentelemetry.md index 87e5142f00a..ab64df5e6e1 100644 --- a/hugo/content/fr/serverless/guide/opentelemetry.md +++ b/hugo/content/fr/serverless/guide/opentelemetry.md @@ -3,25 +3,25 @@ further_reading: - link: /opentelemetry/ tag: Documentation text: OpenTelemetry dans Datadog -title: Surveillance sans serveur et OpenTelemetry +- link: https://www.datadoghq.com/architecture/enhancing-observability-in-aws-lambda-with-otel/ + tag: Architecture Center + text: Amélioration de l'observabilité des applications dans AWS Lambda avec Datadog + et OpenTelemetry +title: Serverless et OpenTelemetry --- - [OpenTelemetry][1] est un framework d'observabilité open source qui fournit aux équipes informatiques des protocoles et des outils normalisés pour recueillir et acheminer des données de télémétrie. -Si votre code fait l'objet d'une instrumentation personnalisée avec l'[API OpenTelemetry][2], ou si vous souhaitez écrire du code d'instrumentation personnalisée indépendant de tout fournisseur, vous pouvez le configurer de manière à générer des spans et traces utilisables par Datadog. Il est alors possible de traiter ces spans et traces pour votre langage via la bibliothèque de tracing Datadog et de transmettre les données à Datadog. - -### AWS Lambda - -La bibliothèque de tracing Datadog, qui est incluse dans l'extension Lambda Datadog lors de l'installation, accepte les spans et traces générées par le code instrumenté par OpenTelemetry, traite les données de télémétrie et les transmet à Datadog. +Si votre code est instrumenté de manière personnalisée avec l'[API OpenTelemetry][2], ou si vous souhaitez écrire du code d'instrumentation personnalisé agnostique vis-à-vis du fournisseur, vous pouvez le configurer pour générer des spans et des traces de style Datadog. Vous pouvez ensuite traiter ces spans et ces traces avec le SDK Datadog pour votre langage, et envoyer les données à Datadog. -Vous pouvez par exemple utiliser cette approche si votre code a déjà été instrumenté avec l'API OpenTelemetry, ou si vous souhaitez effectuer une instrumentation avec du code indépendant de tout fournisseur à l'aide de l'API OpenTelemetry tout en exploitant les bibliothèques de tracing Datadog. +### AWS Lambda {#aws-lambda} -Pour instrumenter AWS Lambda avec l'API OpenTelemetry, définissez la variable d'environnement `DD_TRACE_OTEL_ENABLED` sur `true`. Consultez la section [Instrumentation personnalisée avec l'API OpenTelemetry][3] pour en savoir plus. +Voir [AWS Lambda et OpenTelemetry][4]. -## Pour aller plus loin +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} [1]: https://opentelemetry.io/ [2]: https://opentelemetry.io/docs/reference/specification/trace/api -[3]: /fr/tracing/trace_collection/otel_instrumentation/ \ No newline at end of file +[3]: /fr/tracing/trace_collection/otel_instrumentation/ +[4]: /fr/serverless/aws_lambda/opentelemetry \ No newline at end of file diff --git a/hugo/content/fr/synthetics/guide/rum-to-synthetics.md b/hugo/content/fr/synthetics/guide/rum-to-synthetics.md new file mode 100644 index 00000000000..3993c7cbcfc --- /dev/null +++ b/hugo/content/fr/synthetics/guide/rum-to-synthetics.md @@ -0,0 +1,47 @@ +--- +further_reading: +- link: https://www.datadoghq.com/blog/create-browser-tests-from-datadog-rum-session-replay/ + tag: Blog + text: Créez des tests de navigateur directement à partir d'une Session Replay Datadog + RUM +- link: synthetics/browser_tests + tag: Documentation + text: Configurer un test de navigateur +- link: real_user_monitoring/application_monitoring/browser + tag: Documentation + text: Surveillance Browser avec RUM +title: Générez des tests de navigateur Synthetic à partir d'une Session Replay RUM + de Datadog +--- +## Présentation {#overview} + +[Real User Monitoring (RUM)][1] vous offre une visibilité de bout en bout sur l'activité et l'expérience en temps réel des utilisateurs individuels. Les [tests de navigateur Synthetic][2] vous permettent d'observer les performances de vos systèmes et applications à l'aide de requêtes et d'actions simulées provenant du monde entier. + +{{< img src="synthetics/guide/rum_to_synthetics/generate_test_modal.png" alt="Générez un test de navigateur avec votre modal Session Replay" style="width:70%" >}} + +Vous pouvez créer des tests de navigateur Synthetic à partir de vos Session Replays dans RUM pour suivre les performances en fonction du comportement réel des utilisateurs. + +## Générez un test à partir d'une Session Replay {#generate-a-test-from-a-session-replay} + +Accédez à l'[Explorer RUM][3] et sélectionnez une session avec une [Session Replay][4] disponible à partir de laquelle vous souhaitez créer un test de navigateur. Cliquez sur {{< ui >}}Generate Synthetic Browser Test{{< /ui >}} au-dessus de la chronologie des événements. + +{{< img src="synthetics/guide/rum_to_synthetics/test_recording.png" alt="Une session utilisateur dans l'Explorer RUM" style="width:100%" >}} + +Cela clone automatiquement les événements capturés lors d'une Session Replay, tels que les clics utilisateur et les chargements de page, en étapes individuelles pour un nouveau test de navigateur. + +Par exemple, dans la capture d'écran suivante, le test de navigateur généré a cloné la session d'un utilisateur sur la page d'achat, y compris sa navigation vers celle-ci et son clic sur le bouton {{< ui >}}Add to cart{{< /ui >}}. + +{{< img src="synthetics/guide/rum_to_synthetics/example_test.png" alt="Enregistreur de test de navigateur rempli automatiquement avec les données RUM" style="width:100%" >}} + +Personnalisez davantage vos tests et vos étapes de test pour répondre à vos besoins, tout comme vous le feriez pour [n'importe quel autre test de navigateur][6]. Par exemple, vous pouvez ajouter des [étapes de test][5] supplémentaires (telles que des assertions), ajuster la fréquence d'exécution de votre test et personnaliser sa notification. + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/real_user_monitoring/ +[2]: /fr/synthetics/browser_tests +[3]: https://app.datadoghq.com/rum/sessions +[4]: /fr/session_replay/ +[5]: /fr/synthetics/browser_tests/test_steps +[6]: /fr/synthetics/browser_tests/?tab=requestoptions#test-configuration \ No newline at end of file diff --git a/hugo/content/fr/synthetics/platform/test_coverage/_index.md b/hugo/content/fr/synthetics/platform/test_coverage/_index.md new file mode 100644 index 00000000000..d9a716b3206 --- /dev/null +++ b/hugo/content/fr/synthetics/platform/test_coverage/_index.md @@ -0,0 +1,96 @@ +--- +aliases: +- /fr/synthetics/dashboards/testing_coverage +- /fr/synthetics/test_coverage +description: Évaluez la couverture de votre collection de tests pour les actions de + navigateur. +further_reading: +- link: https://www.datadoghq.com/blog/test-coverage-monitoring-datadog/ + tag: Blog + text: Suivez la couverture des tests avec Datadog RUM et Synthetic Monitoring +- link: /synthetics/browser_tests + tag: Documentation + text: En savoir plus sur les tests de navigateurs Synthetic +- link: /real_user_monitoring/application_monitoring/browser/tracking_user_actions + tag: Documentation + text: En savoir plus sur les actions RUM +- link: /real_user_monitoring/session_replay + tag: Documentation + text: En savoir plus sur Session Replay +title: Couverture des tests +--- +## Présentation {#overview} + +Explorez la couverture des tests Synthetic de votre collection de tests concernant les actions de navigateur RUM sur la [{{< ui >}}Test Coverage{{< /ui >}} page][1], que vous trouverez sous {{< ui >}}Digital Experience{{< /ui >}} > {{< ui >}}Synthetic Monitoring & Testing{{< /ui >}}. + +La [{{< ui >}}Test Coverage{{< /ui >}} page][1] fournit des informations exploitables sur la couverture globale des tests de vos [applications RUM][2]. Elle utilise les [données collectées à partir du SDK RUM pour navigateur][3] et les [résultats des tests de navigateur Synthetic][4]. + +{{< img src="synthetics/test_coverage/browser_actions.png" alt="Page Couverture des tests avec une section Vue d'ensemble, une section Actions non testées et une section Actions testées" style="width:100%" >}} + +La page Couverture des tests présente les informations suivantes : + +- Les pages web les plus visitées +- Le pourcentage d'[actions RUM][5] testées +- Le nombre d'actions testées et le nombre total d'actions +- Le nombre de tests de navigateur couvrant les actions +- Le nombre d'interactions réelles des utilisateurs + +## Étudiez la couverture des tests pour une application ou une vue {#investigate-test-coverage-for-an-application-or-view} + +Construisez une collection de tests plus complète et précise en identifiant les actions non testées et en les associant aux interactions réelles des utilisateurs sur la page Couverture des tests. + +Pour identifier les zones de votre application ou de vos vues où vous devriez créer des tests de navigateur : + +1. Sélectionnez une application RUM dans le {{< ui >}}Application{{< /ui >}} menu déroulant ou une vue dans le {{< ui >}}View Name{{< /ui >}} menu déroulant. +2. Cliquez sur {{< ui >}}Custom{{< /ui >}} pour filtrer les données sur les [actions personnalisées][5], qui sont uniques et offrent des résultats de couverture plus précis que les actions générées. Si vous souhaitez inclure les actions générées dans l'analyse de la couverture des tests, sélectionnez {{< ui >}}All Actions{{< /ui >}}. +3. Identifiez les lacunes dans votre couverture de tests en examinant les informations présentées dans les sections suivantes : + + {{< ui >}}Test Coverage Overview{{< /ui >}} + : Affiche le pourcentage d'actions testées, le pourcentage d'actions testées pondéré par le nombre d'interactions réelles des utilisateurs, ainsi qu'une liste des vues principales avec leur nombre de sessions utilisateur et de tests de navigateur, et le pourcentage d'actions testées. + + {{< ui >}}Untested Actions{{< /ui >}} + : Affiche le nombre d'actions utilisateur non testées, le nombre total d'actions collectées et une liste des principales actions avec lesquelles les utilisateurs réels interagissent le plus mais qui _ne sont pas_ testées. + + {{< ui >}}Tested Actions{{< /ui >}} + : Affiche le nombre de tests de navigateur couvrant les actions des utilisateurs, le nombre d'interactions réelles des utilisateurs et une liste des principales actions avec lesquelles les utilisateurs réels interagissent le plus et qui _sont_ testées. + +La [page Couverture des tests][1] renseigne les actions qui sont largement utilisées et masque les actions qui sont moins couramment utilisées dans votre application. Pour plus d'informations sur les données affichées, consultez [Métriques Synthetic Monitoring][6]. + +## Voir les replays et ajouter des tests {#view-replays-and-add-tests} + +Utilisez les informations de la [page Couverture des tests][1] pour répondre aux questions suivantes : + +- Quelles actions ne sont pas testées dans votre application ? +- Quelles vues sont les plus populaires auprès de vos utilisateurs ? +- Quelles actions nécessitent davantage de tests de navigateur ? +- Quel pourcentage de tests de navigateur couvre les actions des utilisateurs ? + +### Voir les Session Replays {#view-session-replays} + +Cliquez sur l'icône {{< ui >}}Play{{< /ui >}} à côté d'une action dans le tableau {{< ui >}}Untested Actions{{< /ui >}} pour examiner un [enregistrement de l'interaction réelle de l'utilisateur][7] dans [Session Replay][8]. + +### Examiner les actions {#examine-actions} + +Cliquez sur une action pour accéder au nombre de tests, de vues, de sessions, ainsi qu'à un sous-ensemble de ces tests, vues et sessions qui incluent l'action sélectionnée. + +{{< img src="synthetics/test_coverage/tested_action.png" alt="Un panneau latéral d'action avec des onglets affichant les tests Synthetic, les vues RUM et les Session Replays associés" style="width:100%" >}} + +Ajoutez les sections les plus populaires de votre application à un test de navigateur, nouveau ou existant, afin d'être alertés lorsque les parcours utilisateur clés de votre application sont affectés négativement par une modification de code. + + Pour créer un test, cliquez sur {{< ui >}}+ New Test{{< /ui >}} en haut à droite de la [page Couverture des tests][1]. Vous pouvez exécuter des tests [directement dans vos pipelines CI/CD][9] pour vous assurer qu'aucune régression ne se produit avant de publier du code en production. + +[1]: https://app.datadoghq.com/synthetics/test-coverage/browser +[2]: /fr/synthetics/guide/explore-rum-through-synthetics/ +[3]: /fr/real_user_monitoring/application_monitoring/browser/data_collected/ +[4]: /fr/synthetics/browser_tests/ +[5]: /fr/real_user_monitoring/guide/send-rum-custom-actions/ +[6]: /fr/synthetics/metrics/ +[7]: /fr/session_replay/ +[8]: https://app.datadoghq.com/rum/explorer/ +[9]: /fr/continuous_testing/ + +## Pour aller plus loin {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/synthetics/test-coverage/browser \ No newline at end of file diff --git a/hugo/content/fr/tests/test_parallelization/_index.md b/hugo/content/fr/tests/test_parallelization/_index.md new file mode 100644 index 00000000000..b057f3b7d8f --- /dev/null +++ b/hugo/content/fr/tests/test_parallelization/_index.md @@ -0,0 +1,52 @@ +--- +description: Réduisez le temps de test CI en répartissant les fichiers de test sur + des nœuds ou des workers CI grâce aux données Test Optimization. +title: Parallélisation des tests +--- +## Présentation {#overview} + +La parallélisation des tests vous aide à réduire le temps de test CI en répartissant les fichiers de test sur des nœuds CI ou des workers locaux. Elle utilise les données Test Optimization pour détecter les fichiers de test à exécuter, estimer leur durée et créer un plan d'exécution. + +La parallélisation des tests est conçue pour fonctionner avec [Test Impact Analysis][1]. Test Impact Analysis ignore les tests qui ne sont pas affectés par une modification du code. La parallélisation des tests répartit uniformément les fichiers de test restants sur les nœuds CI sélectionnés. + +Utilisez la parallélisation des tests lorsque votre collection de tests prend beaucoup de temps à s'exécuter. Lorsqu'elle est utilisée avec Test Impact Analysis, la parallélisation des tests n'exécute que les fichiers contenant des tests non ignorés. Cela permet également de réduire les coûts de CI en ne choisissant que le nombre de nœuds CI nécessaires, ce qui peut diminuer le nombre total de minutes CPU. + +## Configuration {#setup} + +Avant de configurer la parallélisation des tests, configurez [Test Optimization][2]. Configurez également, si vous le souhaitez, [Test Impact Analysis][1] si vous prévoyez de l'utiliser avec la parallélisation des tests. Suivez ensuite [Set Up Test Parallelization][3] pour installer `ddtest` et configurer votre fournisseur CI. + +## Compatibilité {#compatibility} + +La parallélisation des tests est prise en charge pour les langages et frameworks suivants : + +| Langage | Frameworks | Version minimale de la bibliothèque | +| -------- | ---------- | ----------------------- | +| Ruby | RSpec, Minitest | `datadog-ci` gem `1.31.0` ou version ultérieure | +| Python | pytest | `ddtrace` package `4.11.0` ou version ultérieure | +| JavaScript | Cucumber.js, Cypress, Jest, Mocha, Playwright, Vitest | `dd-trace` package `5.111.0` ou version ultérieure pour `v5` et `6.0.0` ou version ultérieure pour `v6` | + +Pour JavaScript, `ddtest` nécessite Cypress 12 ou version ultérieure, Mocha 8 ou version ultérieure, Playwright 1.18 ou version ultérieure, et Vitest 1.6 ou version ultérieure. La prise en charge de Cucumber.js est testée avec les versions 7 à 13. Ces frameworks nécessitent `ddtest` 1.6.0 ou version ultérieure. La version de votre framework doit également répondre aux [`dd-trace` exigences de compatibilité][4]. + +## Fonctionnement {#how-it-works} + +La parallélisation des tests utilise la `ddtest` CLI pour planifier et exécuter les tests : + +1. Exécutez `ddtest plan` une fois pour créer un plan `.testoptimization/` réutilisable. +2. Partagez le répertoire `.testoptimization/` avec chaque job CI qui exécute des tests. +3. Exécutez `ddtest run --ci-node ` dans chaque job CI pour n'exécuter que les fichiers assignés à ce nœud CI. + +Pour des exemples à nœud unique et multi-nœuds, consultez [Set Up Test Parallelization][3]. + +## Étapes suivantes {#next-steps} + +{{< whatsnext desc="Installez ddtest, configurez votre fournisseur CI et personnalisez la façon dont la parallélisation des tests divise les fichiers de test." >}} +{{< nextlink href="/tests/test_parallelization/setup/" >}}Configurez la parallélisation des tests{{< /nextlink >}} +{{< nextlink href="/tests/test_parallelization/configuration/" >}}Configurez la parallélisation des tests{{< /nextlink >}} +{{< nextlink href="/tests/test_parallelization/best_practices/" >}}Bonnes pratiques pour la parallélisation des tests.{{< /nextlink >}} +{{< nextlink href="/tests/test_parallelization/troubleshooting/" >}}Dépannage de la parallélisation des tests{{< /nextlink >}} +{{< /whatsnext >}} + +[1]: /fr/tests/test_impact_analysis/ +[2]: /fr/tests/setup/ +[3]: /fr/tests/test_parallelization/setup/ +[4]: /fr/tests/setup/javascript/#compatibility \ No newline at end of file diff --git a/hugo/content/fr/tracing/_index.md b/hugo/content/fr/tracing/_index.md index 5bde3687cac..7e4c43a6a8a 100644 --- a/hugo/content/fr/tracing/_index.md +++ b/hugo/content/fr/tracing/_index.md @@ -18,52 +18,41 @@ cascade: rank: 70 description: Instrumenter votre code pour améliorer ses performances further_reading: -- link: https://app.datadoghq.com/release-notes?category=APM - tag: Notes de version - text: Découvrez les dernières versions de Datadog APM ! (Connexion à l'application - requise) +- link: https://www.datadoghq.com/architecture/observability-in-event-driven-architecture/ + tag: Architecture Center + text: Observabilité dans les architectures pilotées par les événements - link: https://learn.datadoghq.com/courses/getting-started-apm tag: Centre d'apprentissage - text: Commencer avec les métriques et les traces APM -- link: https://www.datadoghq.com/blog/monitor-rust-otel/ - tag: Blog - text: Comment surveiller vos applications Rust avec OpenTelemetry + text: Démarrer avec les métriques et les traces APM +- link: https://dtdg.co/fe + tag: Validation des bases + text: Participer à une session interactive pour maîtriser la solution APM - link: https://www.datadoghq.com/blog/span-based-metrics/ tag: Blog text: Générez des métriques basées sur les spans pour suivre les tendances historiques - de la performance des applications. + des performances des applications - link: https://www.datadoghq.com/blog/apm-security-view/ tag: Blog text: Gagner en visibilité sur les risques, vulnérabilités et attaques avec la vue Security d'APM -- link: https://www.datadoghq.com/blog/monitor-azure-app-service-linux/ - tag: Blog - text: Surveillez vos applications web Linux sur Azure App Service avec Datadog. -- link: https://www.datadoghq.com/blog/monitor-apis-datadog-api-catalog/ - tag: Blog - text: Gérez la performance, la sécurité et la propriété des API avec Datadog API - Catalog. -- link: https://www.datadoghq.com/blog/software-catalog/ - tag: Blog - text: Améliorez l'expérience des développeurs et la collaboration grâce à Software - Catalog. -- link: https://www.datadoghq.com/blog/datadog-csi-driver/ - tag: Blog - text: Apportez une observabilité haute performance aux environnements Kubernetes - sécurisés avec Datadog's CSI driver. -- link: https://dtdg.co/fe - tag: Validation des bases - text: Participer à une session interactive pour maîtriser la solution APM -- link: https://www.datadoghq.com/blog/gitlab-source-code-integration - tag: Blog - text: Résolvez les problèmes plus rapidement avec l'intégration du code source GitLab - dans Datadog. - link: https://www.datadoghq.com/blog/pubsub-cloud-run-tracing tag: Blog - text: Tracez les charges de travail Google Pub/Sub dans Cloud Run avec Datadog. + text: Tracez les charges de travail Google Pub/Sub dans Cloud Run avec Datadog - link: https://www.datadoghq.com/blog/analyzing-roundtrip-query-latency tag: Blog - text: Analyse de la latence des requêtes aller-retour + text: Analyse de la latence aller-retour des requêtes +- link: https://www.datadoghq.com/blog/boomi-observability-opentelemetry-datadog/ + tag: Blog + text: Instrumentez et surveillez les flux d'intégration Boomi avec OpenTelemetry + et Datadog +- link: https://www.datadoghq.com/blog/dbm-supabase/ + tag: Blog + text: Surveillez et optimisez les performances des requêtes Supabase avec Datadog + Database Monitoring +- link: https://app.datadoghq.com/release-notes?category=APM + tag: Notes de version + text: Découvrez les dernières versions de Datadog APM ! (Connexion à l'application + requise) title: APM --- {{< vimeo url="https://player.vimeo.com/progressive_redirect/playback/381554158/rendition/1080p/file.mp4?loc=external&signature=e19b4e64632c3b1a42b11cb27fca2682dfadecd4690774c005ba2f5079b6a416" poster="/images/poster/tracing.png" >}} @@ -71,40 +60,40 @@ title: APM
-{{< learning-center-callout header="Participez à une session de webinaire de formation." hide_image="true" btn_title="Inscrivez-vous." btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=APM">}} - Participez à une session de formation d’introduction ou intermédiaire pour découvrir comment Datadog APM propose un traçage distribué au niveau du code, alimenté par l’IA, depuis les applications web et mobiles jusqu’aux services backend et aux bases de données. +{{< learning-center-callout header="Rejoignez une session de webinaire de formation" hide_image="true" btn_title="S'inscrire" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=APM">}} + Rejoignez une session d'initiation ou de niveau intermédiaire pour en savoir plus sur la manière dont Datadog Application Performance Monitoring (APM) fournit un traçage distribué au niveau du code, optimisé par l'IA, depuis les applications de navigateur et mobiles jusqu'aux services backend et aux bases de données. {{< /learning-center-callout >}} -## Aperçu {#overview} +## Présentation {#overview} -La solution Application Performance Monitoring (APM) de Datadog vous permet dʼanalyser vos applications en détail, et ainsi d'identifier les goulets d'étranglement, de résoudre les problèmes et d'optimiser vos services. Avec le traçage distribué, des tableaux de bord prêts à l'emploi et une corrélation transparente avec d'autres données de télémétrie, Datadog APM aide à garantir la meilleure performance et expérience utilisateur possible pour vos applications. +Datadog Application Performance Monitoring (APM) vous permet d'analyser vos applications en détail, et ainsi d'identifier les goulets d'étranglement, de résoudre les problèmes et d'optimiser vos services. Grâce au traçage distribué, aux tableaux de bord prêts à l'emploi et à la corrélation transparente avec d'autres données de télémétrie, Datadog APM contribue à garantir les meilleures performances et la meilleure expérience utilisateur possibles pour vos applications. -Pour découvrir la terminologie en lien avec la solution APM Datadog, consultez la section [Termes et concepts d'APM][1]. +Pour découvrir la terminologie en lien avec la solution Datadog APM, consultez la section [Termes et concepts d'APM][1]. -## Commencer {#getting-started} +## Mise en route {#getting-started} -La manière la plus simple de démarrer avec Datadog APM consiste à utiliser Single Step Instrumentation. Cette approche installe l'Agent Datadog et instrumente votre application en une seule étape, sans étapes de configuration supplémentaires requises. Pour en savoir plus, lisez [Single Step Instrumentation][27]. +Le moyen le plus simple de commencer avec Datadog APM est d'utiliser l'instrumentation en une seule étape (Single Step Instrumentation). Cette approche installe Datadog Agent et instrumente votre application en une seule étape, sans aucune étape de configuration supplémentaire requise. Pour en savoir plus, lisez [Instrumentation en une seule étape][27]. -Pour les configurations nécessitant davantage de personnalisation, Datadog prend en charge l'instrumentation personnalisée avec les Datadog SDKs et [Dynamic Instrumentation][30] dans l'interface utilisateur de Datadog. Pour en savoir plus, lisez [Application Instrumentation][2]. +Pour les configurations nécessitant plus de personnalisation, Datadog prend en charge l'instrumentation personnalisée avec les SDK Datadog et [Dynamic Instrumentation][30] dans l'interface utilisateur Datadog. Pour en savoir plus, lisez [Application Instrumentation][2]. -
Si vous êtes nouveau dans Datadog APM, lisez Getting Started with APM pour apprendre à envoyer votre première trace à Datadog.
+
Si vous débutez avec Datadog APM, lisez Getting Started with APM pour apprendre à envoyer votre première trace à Datadog.
## Cas d'utilisation {#use-cases} -Découvrez comment la solution APM de Datadog peut vous permettre de répondre à vos cas d'utilisation : +Découvrez comment la solution Datadog APM peut vous permettre de répondre à vos cas d'utilisation : -| Vous souhaitez...| Comment Datadog APM peut aider | +| Vous souhaitez...| Comment Datadog APM peut vous aider | | ----------- | ----------- | -| Comprendre comment les requêtes circulent dans votre système. | Utilisez le [Trace Explorer][21] pour interroger et visualiser les traces de bout en bout à travers des services distribués. | -| Surveillez la santé et la performance des services individuels. | Utilisez les [pages de service][26] et [pages de ressources][28] pour évaluer la santé des services en analysant les métriques de performance, en suivant les déploiements et en identifiant les ressources problématiques. | -| Corrélez les traces avec DBM, RUM, les journaux, les synthétiques et les profils. | Corrélation des traces avec d'autres données de télémétrie | -| Contrôlez comment les données entrent dans Datadog. | Utilisez les [Contrôles d'Ingestion][6] pour ajuster la configuration d'ingestion et les taux d'échantillonnage par service et ressource. Utilisez les [Filtres de rétention][7] pour choisir quelles spans conserver pendant 15 jours. | +| Comprenez comment les requêtes circulent dans votre système. | Utilisez le [Trace Explorer][21] pour interroger et visualiser les traces de bout en bout à travers les services distribués. | +| Surveillez l'état de santé et les performances des services individuels. | Utilisez les [pages de service][26] et les [pages de ressources][28] pour évaluer l'état de santé des services en analysant les métriques de performance, en suivant les déploiements et en identifiant les ressources problématiques. | +| Corrélez les traces avec DBM, RUM, les logs, les tests Synthetic et les profils. | [Corrélez les données APM avec d'autres données de télémétrie][20] pour donner du contexte à vos données et obtenir une analyse plus complète. | +| Contrôlez la manière dont les données circulent dans Datadog. | Utilisez les [contrôles d'ingestion][6] pour ajuster la configuration de l'ingestion et les taux d'échantillonnage par service et par ressource. Utilisez les [filtres de rétention][7] pour choisir les spans à conserver pendant 15 jours. | -### Trace Explorer {#trace-explorer} +### Trace Explorer{#trace-explorer} -Le [Trace Explorer][21] vous permet de rechercher et d'analyser vos traces en temps réel. Identifiez les goulets d'étranglement de performance, dépannez les erreurs et passez aux journaux et métriques connexes pour comprendre le contexte complet autour de tout problème. +[Trace Explorer][21] vous permet de rechercher et d'analyser vos traces en temps réel. Identifiez les goulots d'étranglement de performance, dépannez les erreurs et pivotez vers les logs et métriques associés pour comprendre le contexte complet de tout problème. -{{< img src="/tracing/trace_explorer/trace_explorer.png" alt="Vue de l'explorateur de traces." style="width:100%;" >}} +{{< img src="/tracing/trace_explorer/trace_explorer.png" alt="Vue de Trace Explorer." style="width:100%;" >}} ### Page de service {#service-page} @@ -112,29 +101,29 @@ La [page des services][26] vous aide à surveiller les performances de vos servi {{< img src="tracing/deployment_tracking/VersionComparison.png" alt="Versions sur la page de service" style="width:100%;">}} -### Corréler les traces avec d'autres télémetries {#correlating-traces-with-other-telemetry} +### Corrélation des traces avec d'autres données de télémétrie {#correlating-traces-with-other-telemetry} -La solution APM de Datadog s'intègre parfaitement aux logs, à la surveillance des utilisateurs réels (RUM), à la surveillance Synthetic, entre autres : +La solution Datadog APM s'intègre parfaitement aux logs, à la surveillance des utilisateurs réels (RUM), au Synthetic Monitoring, entre autres : -- [Affichez vos journaux d'application côte à côte avec les traces][9] pour trouver des journaux pour des requêtes, services ou versions spécifiques. -- [Associez les sessions RUM avec les traces backend][10] pour comprendre comment la performance backend affecte l'expérience utilisateur. -- [Associez les tests synthétiques avec les traces][11] pour résoudre les échecs à travers les requêtes frontend et backend. +- [Affichez vos logs d'application côte à côte avec les traces][9] pour trouver les logs correspondant à des requêtes, services ou versions spécifiques. +- [Associez les sessions RUM aux traces backend][10] pour comprendre comment les performances backend affectent l'expérience utilisateur. +- [Associez les tests Synthetic aux traces][11] pour dépanner les échecs sur l'ensemble des requêtes frontend et backend. -{{< img src="tracing/index/ConnectLogsWithTraces.png" alt="Connectez les journaux et les traces." style="width:100%;">}} +{{< img src="tracing/index/ConnectLogsWithTraces.png" alt="Connectez les logs et les traces" style="width:100%;">}} ### Contrôles d'ingestion et filtres de rétention {#ingestion-controls-and-retention-filters} Les traces démarrent dans vos applications instrumentées et circulent dans Datadog. -Datadog APM fournit des outils pour gérer le volume et la rétention de vos données de trace. Utilisez [Contrôles d'ingestion][6] pour ajuster les taux d'échantillonnage et [filtres de rétention][7] pour contrôler quelles spans sont stockées. +Datadog APM fournit des outils pour gérer le volume et la rétention de vos données de trace. Utilisez les [contrôles d'ingestion][6] pour ajuster les taux d'échantillonnage et les [filtres de rétention][7] pour contrôler les spans qui sont stockés. -{{< img src="/tracing/apm_lifecycle/apm_lifecycle_0.png" alt="Flux de données à travers Datadog APM." style="width:100%;" >}} +{{< img src="/tracing/apm_lifecycle/apm_lifecycle_0.png" alt="Flux de données via Datadog APM." style="width:100%;" >}} ## Dépannage {#troubleshooting} En cas de problème, vous pouvez consulter le guide [Dépannage d'APM][29]. -## Lectures complémentaires {#further-reading} +## Pour aller plus loin {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/ja/actions/agents/_index.md b/hugo/content/ja/actions/agents/_index.md index bb049c32474..59335b289b0 100644 --- a/hugo/content/ja/actions/agents/_index.md +++ b/hugo/content/ja/actions/agents/_index.md @@ -19,6 +19,9 @@ further_reading: - link: https://www.datadoghq.com/blog/bits-agent-builder/ tag: ブログ text: 'Bits Agent Builder の紹介: アラート対応と修復のためのエージェントワークフローを構築する' +- link: https://www.datadoghq.com/blog/build-datadog-workflows-ai-agents/ + tag: ブログ + text: Bits ChatやAIエージェントからDatadogワークフローを構築し、実行してください。 title: Bits Agent Builder --- ## 概要 {#overview} diff --git a/hugo/content/ja/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md b/hugo/content/ja/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md index 0ba6889354e..cd25ef090d3 100644 --- a/hugo/content/ja/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md +++ b/hugo/content/ja/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md @@ -101,7 +101,7 @@ Span Input: {{span_input}} 右側のパネル (スパンスコープでは [{{< ui >}}Filtered Spans{{< /ui >}}] (フィルターされたスパン)、トレーススコープでは [{{< ui >}}Filtered Traces{{< /ui >}}] (フィルターされたトレース)、セッションスコープでは [{{< ui >}}Filtered Sessions{{< /ui >}}] (フィルターされたセッション) を使用して、スパンデータを変数として追加することもできます。 1. アカウントとアプリケーションを選択して、スパン、トレース、またはセッションを右側に表示します。 2. 右側のスパンのいずれかを選択して、その JSON を表示します。 - 3. [{{< ui >}}+{{< /ui >}}] を選択して、JSON をユーザープロンプトに追加します。 + 3. [{{< ui >}}\+{{< /ui >}}] を選択して、JSON をユーザー・プロンプトに追加します。 {{< img src="llm_observability/evaluations/custom_llm_judge_2-5.png" alt="カスタム評価設定の右ペインにある JSON ビューのメニューの内容。メッセージに変数を追加するオプションが表示されています。" style="width:40%;" >}} diff --git a/hugo/content/ja/mcp_server/code_execution.md b/hugo/content/ja/mcp_server/code_execution.md new file mode 100644 index 00000000000..4d7f0c2ada3 --- /dev/null +++ b/hugo/content/ja/mcp_server/code_execution.md @@ -0,0 +1,80 @@ +--- +algolia: + rank: 65 + tags: + - mcp + - mcp server + - code execution + - code-exec +description: エージェントが作成したJavaScriptをDatadog APIに対して、単一のDatadog MCP Serverツール呼び出しで実行し、複数のDatadog製品にまたがる問題を調査します。 +further_reading: +- link: mcp_server + tag: ドキュメント + text: Datadog MCP サーバー +- link: mcp_server/setup + tag: ドキュメント + text: Datadog MCP Server を設定する +- link: mcp_server/tools + tag: ドキュメント + text: Datadog MCP Server ツール +title: Datadog MCP Serverによるコード実行 +--- +## 概要 {#overview} + +Datadog MCP Serverの`code-exec`ツールセットを使用すると、AIエージェントはAPIリクエストごとにツールを呼び出すのではなく、単一のDatadog MCP Serverツール呼び出しでDatadog APIに対してJavaScriptを作成および実行できます。エージェントが生成したコードは、Datadogが管理するサンドボックス内で実行されます。エージェントに送り返されるデータは、コードが返す値のみです。これにより、大規模なAPIレスポンスがモデルのコンテキストに含まれるのを防ぎます。 + +複数のDatadog製品にまたがる調査や、複数の呼び出しからのデータを結合、フィルタリング、または要約する必要がある調査には、コード実行を使用してください。例として、同じサービスおよび時間枠のエラーログとAPMレイテンシーを関連付けることが挙げられます。 + +## なぜコード実行を使用するのか {#why-use-code-execution} + +コード実行がない場合、エラーが最も多いサービスにAPMレイテンシーデータを付与するよう指示されたエージェントは、サービスごとに個別のツール呼び出しを行う必要があります。また、結果を結合するために追加のターンも必要になります。それらの呼び出しやターンはそれぞれ、コンテキストウィンドウのスペースを消費します。 + +コード実行を使用すると、エージェントは同じ調査を単一のスクリプトとして表現できます。 + +1. 特定の期間内にエラーログが最も多いサービスについてログをクエリします。 +1. 返された各サービスについて、レイテンシーデータのスパンをクエリします。 +1. 2つの結果セットを結合し、コンパクトなオブジェクトを返します。 + +Datadog MCP Serverがスクリプトを実行し、結合された結果のみを返します。エージェントは、サービスごとに1回ではなく、1回のツール呼び出しで調査を完了します。 + +## 利用可能なツール{#available-tools} + +`code-exec`ツールセットは以下を提供します。 + +- **`execute_code`**: エージェントが作成したJavaScriptをサンドボックス内で実行し、構造化された結果を返します。権限とプロンプトの例については、MCP Server Tools リファレンスの [`execute_code`][1] を参照してください。 +- **`search_datadog_sdk`**: エージェントがスクリプトを作成するために利用可能な SDK 関数と API メソッドを検索します。MCP Server Tools リファレンスの [`search_datadog_sdk`][2] を参照してください。 + +生成されるコードは、公開されている [Datadog API Client for TypeScript][3] に基づく JavaScript です。 + +## サンドボックスがアクセスできるもの {#what-the-sandbox-can-access} + +`code-exec` ツールセットによって実行されるコードは、ユーザーのアイデンティティを使用して Datadog API に対して実行されます。エージェントは、ユーザーがアクセス権を持つデータのみを読み取ることができます。その他のアクセス制限は以下の通りです。 + +- サンドボックスは分離されています。スクリプトは、ローカルマシン、ファイルシステム、任意のネットワーク宛先、または Datadog の生の認証情報にアクセスできません。 +- サンドボックスは、読み取り専用の Datadog API 呼び出しのみを公開します。エージェントは `execute_code` を使用して、モニターの作成やダッシュボードの更新などの書き込みアクションを実行することはできません。 +- スクリプトから行われる API 呼び出しには、既存の [ロール権限][4] が適用されます。データセットへのアクセス権がない場合、エージェントは `execute_code` を通じてもそのデータセットをクエリすることはできません。 +- 生の API レスポンスは、スクリプトによる処理中、サンドボックス内に留まります。エージェントに送り返されるデータは、コードが返す値のみです。ログに保存されている顧客データなど、基盤となるデータが機密性の高いものである場合は、スクリプトが何を返すかを確認してください。 + +## コード実行を有効にする {#enable-code-execution} + +コード実行を有効にするには、AI クライアントを Datadog MCP Server に接続する際に、`code-exec` クエリパラメータに `toolsets` を含めます。クライアント固有の接続手順については、[Datadog MCP Server のセットアップ][5] を参照してください。 + +{{< site-region region="us,us3,us5,eu,ap1,ap2,uk1" >}} +たとえば、選択した [Datadog サイト][6] に基づいて ({{< region-param key="dd_site_name" >}})、このURLにより、コード実行と併せてコアツールセットが有効になります。 + +
{{< region-param key="mcp_server_endpoint" >}}?toolsets=core,code-exec
+ +`code-exec`は`toolsets=all`に含まれているため、一般的に利用可能なすべてのツールセットを既に有効にしている場合は、個別に追加する必要はありません。 + +[6]: /ja/getting_started/site/ +{{< /site-region >}} + +## 参考資料 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /ja/mcp_server/tools/#execute_code +[2]: /ja/mcp_server/tools/#search_datadog_sdk +[3]: https://github.com/DataDog/datadog-api-client-typescript +[4]: /ja/account_management/rbac/permissions/ +[5]: /ja/mcp_server/setup \ No newline at end of file diff --git a/hugo/content/ja/security/application_security/agentic_onboarding.md b/hugo/content/ja/security/application_security/agentic_onboarding.md new file mode 100644 index 00000000000..77bee2ade12 --- /dev/null +++ b/hugo/content/ja/security/application_security/agentic_onboarding.md @@ -0,0 +1,5 @@ +--- +description: AI Setup CLIまたはDatadog MCP Serverを使用して、App and API Protectionでアプリケーションに計装してください。 +title: App and API Protectionのagentic onboarding +--- +{{< include-markdown "agentic_onboarding/setup" >}} \ No newline at end of file diff --git a/hugo/content/ko/actions/agents/_index.md b/hugo/content/ko/actions/agents/_index.md index 94358d6f057..d4b14e3a0a5 100644 --- a/hugo/content/ko/actions/agents/_index.md +++ b/hugo/content/ko/actions/agents/_index.md @@ -19,6 +19,9 @@ further_reading: - link: https://www.datadoghq.com/blog/bits-agent-builder/ tag: 블로그 text: 'Bits Agent Builder 소개: 경보 대응 및 해결을 위한 에이전틱 워크플로 구축' +- link: https://www.datadoghq.com/blog/build-datadog-workflows-ai-agents/ + tag: 블로그 + text: Bits Chat 또는 AI 에이전트에서 Datadog 워크플로우를 빌드하고 실행하십시오. title: Bits Agent Builder --- ## 개요 {#overview} diff --git a/hugo/content/ko/api/latest/security-monitoring/create-an-inbox-rule/index.md b/hugo/content/ko/api/latest/security-monitoring/create-an-inbox-rule/index.md new file mode 100644 index 00000000000..bcdf4297641 --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/create-an-inbox-rule/index.md @@ -0,0 +1,3 @@ +--- +title: 받은 편지함 규칙 생성하기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/delete-an-inbox-rule/index.md b/hugo/content/ko/api/latest/security-monitoring/delete-an-inbox-rule/index.md new file mode 100644 index 00000000000..b3bc3dab3b5 --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/delete-an-inbox-rule/index.md @@ -0,0 +1,3 @@ +--- +title: 받은 편지함 규칙 삭제하기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/disable-a-default-inbox-rule/index.md b/hugo/content/ko/api/latest/security-monitoring/disable-a-default-inbox-rule/index.md new file mode 100644 index 00000000000..40359d0ac84 --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/disable-a-default-inbox-rule/index.md @@ -0,0 +1,3 @@ +--- +title: 기본 받은 편지함 규칙 비활성화하기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/enable-a-default-inbox-rule/index.md b/hugo/content/ko/api/latest/security-monitoring/enable-a-default-inbox-rule/index.md new file mode 100644 index 00000000000..34e087569ad --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/enable-a-default-inbox-rule/index.md @@ -0,0 +1,3 @@ +--- +title: 기본 받은 편지함 규칙 활성화하기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/get-a-default-inbox-rule/index.md b/hugo/content/ko/api/latest/security-monitoring/get-a-default-inbox-rule/index.md new file mode 100644 index 00000000000..ae000230751 --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/get-a-default-inbox-rule/index.md @@ -0,0 +1,3 @@ +--- +title: 기본 받은 편지함 규칙 가져오기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/get-all-default-inbox-rules/index.md b/hugo/content/ko/api/latest/security-monitoring/get-all-default-inbox-rules/index.md new file mode 100644 index 00000000000..7384e15d16c --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/get-all-default-inbox-rules/index.md @@ -0,0 +1,3 @@ +--- +title: 기본 받은 편지함 규칙을 모두 가져오기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/get-all-inbox-rules/index.md b/hugo/content/ko/api/latest/security-monitoring/get-all-inbox-rules/index.md new file mode 100644 index 00000000000..71b5442c9c0 --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/get-all-inbox-rules/index.md @@ -0,0 +1,3 @@ +--- +title: 받은 편지함 규칙을 모두 가져오기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/reorder-inbox-rules/index.md b/hugo/content/ko/api/latest/security-monitoring/reorder-inbox-rules/index.md new file mode 100644 index 00000000000..4f4ec75e4d9 --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/reorder-inbox-rules/index.md @@ -0,0 +1,3 @@ +--- +title: 받은 편지함 규칙 재정렬하기 +--- diff --git a/hugo/content/ko/api/latest/security-monitoring/update-an-inbox-rule/index.md b/hugo/content/ko/api/latest/security-monitoring/update-an-inbox-rule/index.md new file mode 100644 index 00000000000..89cdd99a71f --- /dev/null +++ b/hugo/content/ko/api/latest/security-monitoring/update-an-inbox-rule/index.md @@ -0,0 +1,3 @@ +--- +title: 받은 편지함 규칙 업데이트 +--- diff --git a/hugo/content/ko/database_monitoring/setup_postgres/rds/quick_install.md b/hugo/content/ko/database_monitoring/setup_postgres/rds/quick_install.md index 14f064aae96..32e01c89c6b 100644 --- a/hugo/content/ko/database_monitoring/setup_postgres/rds/quick_install.md +++ b/hugo/content/ko/database_monitoring/setup_postgres/rds/quick_install.md @@ -5,29 +5,31 @@ further_reading: text: Postgres 설정 - link: /database_monitoring/setup_postgres/rds tag: 설명서 - text: Amazon RDS 관리형 Postgres에서 데이터베이스 모니터링 설정 + text: Amazon RDS 관리형 Postgres에서 Database Monitoring 설정 +- link: https://www.datadoghq.com/architecture/dbm-quick-install-aws-rds-postgres/ + tag: 아키텍처 센터 + text: AWS RDS용 Datadog DBM 빠른 설치 title: Postgres RDS용 Database Monitoring 빠른 설치 --- +RDS용 Database Monitoring 빠른 설치는 RDS Postgres 인스턴스를 모니터링하기 위해 Agent를 빠르게 설정할 수 있는 기능입니다. 몇 가지 옵션을 지정하면 Datadog에서 모니터링을 위해 인스턴스를 구성하는 CloudFormation 템플릿을 생성하고, Amazon ECS를 사용하여 권장 DBM 구성으로 RDS 인스턴스에 Agent를 배포합니다. -RDS용 Database Monitoring 빠른 설치로 Agent를 빠르게 설정하여 RDS Postgres 인스턴스를 모니터링합니다. 몇 가지 옵션을 지정하면, Datadog은 모니터링할 수 있도록 인스턴스를 구성하는 CloudFormation 템플릿을 생성합니다. 또한 Amazon ECS를 사용하여 Agent를 권장 DBM 구성으로 RDS 인스턴스에 배포합니다. +## 전제 조건 {#prerequisites} -## 사전 필수 조건 +- 인스턴스의 VPC에서 들어오는 연결과 인터넷으로 나가는 연결을 허용하는 방식으로 인스턴스에 보안 그룹을 구성해야 합니다. +- RDS 인스턴스의 관리자 액세스 권한을 가진 사용자 이름과 암호는 AWS Secrets Manager 내 AWS Secret에 저장해야 합니다. Datadog이 설정 및 운영 과정에서 자격 증명에 액세스할 때 사용하므로, 이 시크릿의 Amazon Resource Name(ARN)을 기록해 두세요. -- 인스턴스의 VPC 인바운드 연결과 인터넷 아웃바운드 연결을 허용하려면 인스턴스에서 보안 그룹을 구성해야 합니다. -- RDS 인스턴스의 관리자 액세스 사용자 이름과 비밀번호는 AWS Secrets Manager의 AWS Secret에 저장해야 합니다. Datadog은 설정 및 운영 중 자격 증명에 액세스하는 데 이 시크릿을 사용하므로, 해당 시크릿의 Amazon Resource Name(ARN)을 기록해 두세요. +
Datadog은 관리자 자격 증명을 저장하지 않습니다. 이 자격 증명은 Agent 연결을 위해 일시적으로 사용되며, 프로세스 완료 후에는 데이터를 보관하지 않습니다.
-
Datadog은 관리자 자격 증명을 저장하지 않습니다. Agent에 연결하기 위해 일시적으로만 사용하며, 프로세스가 완료된 후에는 데이터를 보관하지 않습니다.
- -## 설치 +## 설치 {#installation} 1. [Database Monitoring Setup][1] 페이지로 이동합니다. -1. **Unmonitored Hosts** 탭에서 Agent를 설치하려는 RDS 인스턴스의 **Add Agent**를 클릭합니다. -1. 계정 및 리전에 ECS 클러스터가 설치되어 있지 않은 경우 **Create Cluster**를 클릭합니다. -1. **Security Group** 드롭다운 목록에서 보안 그룹을 선택합니다. -1. **Select API Key**를 클릭하고 목록에서 API 키를 선택한 후 **Use API Key**를 클릭합니다. -1. **Launch CloudFormation Stack in AWS Console**를 클릭합니다. 그러면 AWS CloudFormation 화면이 표시된 새 페이지가 열립니다. 제공된 CloudFormation 템플릿을 사용하여 스택을 생성합니다. 해당 템플릿에는 Agent를 배포하여 RDS 인스턴스를 모니터링하는 데 필요한 구성이 포함됩니다. +1. {{< ui >}}Unmonitored Hosts{{< /ui >}} 탭에서 Agent를 설치하려는 RDS 인스턴스의 {{< ui >}}Add Agent{{< /ui >}}를 클릭합니다. +1. 계정 및 리전에 ECS 클러스터를 설치하지 않은 경우 {{< ui >}}Create Cluster{{< /ui >}}를 클릭합니다. +1. {{< ui >}}Security Group{{< /ui >}} 드롭다운 목록에서 보안 그룹을 선택합니다. +1. {{< ui >}}Select API Key{{< /ui >}}를 클릭하고 목록에서 API 키를 선택한 다음 {{< ui >}}Use API Key{{< /ui >}}를 클릭합니다. +1. {{< ui >}}Launch CloudFormation Stack in AWS Console{{< /ui >}}를 클릭합니다. 새 페이지가 열리고 AWS CloudFormation 화면이 표시됩니다. 제공된 CloudFormation 템플릿을 사용하여 스택을 생성합니다. 이 템플릿은 RDS 인스턴스 모니터링을 위한 Agent 배포에 필요한 구성을 포함하고 있습니다. -## 참고 자료 +## 추가 자료 {#further-reading} {{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/ko/deployment_gates/setup/jit.md b/hugo/content/ko/deployment_gates/setup/jit.md index 24cd2de4af5..a1123ca0626 100644 --- a/hugo/content/ko/deployment_gates/setup/jit.md +++ b/hugo/content/ko/deployment_gates/setup/jit.md @@ -4,14 +4,14 @@ description: 평가 요청에 규칙을 인라인으로 전송하여 Deployment further_reading: - link: /deployment_gates/setup/preconfigured tag: 설명서 - text: 사전 구성된 Deployment Gates 설정 + text: 사전 구성된 Deployment Gates 설정하기 - link: /deployment_gates/explore tag: 설명서 text: Deployment Gates 탐색기에 대해 알아보기 - link: /api/latest/deployment-gates tag: API 참조 text: Deployment Gates API 참조 -title: JIT(Just-In-Time) Deployment Gates 설정 +title: JIT(Just-In-Time) Deployment Gates 설정하기 --- {{< callout url="http://datadoghq.com/product-preview/deployment-gates" >}} Deployment Gates는 미리 보기로 제공되고 있습니다. 이 기능에 관심이 있다면 양식을 작성하여 액세스 권한을 요청하세요. @@ -60,20 +60,22 @@ Datadog UI, API 또는 Terraform에서 관리되는 영구 게이트가 필요 전체 스키마 및 사용 가능한 모든 옵션은 [Deployment Gates API 참조][4]를 참조하세요. {{< tabs >}} -{{% tab "모니터링" %}} -모니터링 규칙은 구성 가능한 기간 동안 모니터링 세트의 상태를 평가합니다. 평가 기간 중 언제든지 다음 상황이 발생하면 실패합니다. +{{% tab "Monitor" %}} +Monitor 규칙은 구성 가능한 기간 동안 모니터 집합의 상태를 평가합니다. `query` 또는 `monitor_ids` 중 하나를 사용하여 모니터를 선택합니다. 두 가지 옵션은 상호 배타적입니다. 평가 기간 중 언제든지 다음 상황이 발생하면 규칙 실패로 이어질 수 있습니다. -- 쿼리와 일치하는 모니터링이 없습니다. -- 50개 이상의 모니터링이 쿼리와 일치합니다. -- 일치하는 모니터링이 `ALERT` 또는 `NO_DATA` 상태입니다. +- 구성된 선택 항목과 일치하는 모니터 그룹이 존재하지 않습니다. +- 명시적인 모니터 ID가 존재하지 않거나 조직에서 사용할 수 없습니다. +- 구성된 선택 항목과 일치하는 모니터가 300개를 초과합니다. +- 일치하는 모니터 그룹 중 하나라도 `ALERT` 또는 `NO_DATA` 상태입니다. **옵션**: -- `query`: [모니터링 검색 구문][1]을 기반으로 하는 모니터링 검색 쿼리입니다. 다음과 같은 모니터링 태그를 기준으로 필터링할 수 있습니다. - - 모니터링 정적 태그: `service:transaction-backend` - - 모니터링 쿼리 내 태그: `scope:"service:transaction-backend"` - - [모니터링 그룹화][2] 내 태그: `group:"service:transaction-backend"` -- `duration`: 일치하는 모니터링을 평가할 기간(초)입니다. 기본값은 0입니다(모니터링이 즉시 평가됨). 최댓값은 7,200초(2시간)입니다. +- `query`: [모니터 검색 구문][1]을 기반으로 하는 모니터 검색 쿼리입니다. 다음 모니터 태그를 기준으로 필터링할 수 있습니다. + - 모니터 정적 태그: `service:transaction-backend` + - 모니터 쿼리 내 태그: `scope:"service:transaction-backend"` + - [모니터 그룹][2] 내 태그: `group:"service:transaction-backend"` +- `monitor_ids`: 특정 모니터 목록입니다. 각 항목에는 10진수 모니터 `id`와 정확한 그룹 이름 `groups` 배열이 포함되어 있습니다. 비어 있는 `groups` 배열은 해당 모니터의 모든 그룹을 평가합니다. +- `duration`: 선택한 모니터를 평가할 기간(초)입니다. 기본값은 0입니다. 이 경우 모니터가 즉시 평가됩니다. 최댓값은 7,200초(2시간)입니다. 인라인 규칙 예시: @@ -88,15 +90,30 @@ Datadog UI, API 또는 Terraform에서 관리되는 영구 게이트가 필요 } ``` +```json +{ + "type": "monitor", + "name": "Specific monitors", + "options": { + "monitor_ids": [ + {"id": "12345678", "groups": []}, + {"id": "87654321", "groups": ["service:api"]} + ], + "duration": 300 + } +} +``` + **참고**: -- `group` 필터는 일치하는 그룹만 평가합니다. -- 음소거된 모니터링은 평가에서 자동으로 제외됩니다(쿼리에 항상 `muted:false`가 포함됨). +- `group` 쿼리 필터와 `monitor_ids[].groups`는 일치하는 그룹만 평가합니다. +- 명시적인 모니터 ID가 존재하지 않거나 조직에서 사용할 수 없는 경우 규칙 실패로 이어집니다. 모니터가 존재하지만 음소거 상태이거나 선택한 그룹에 데이터가 없어 제외되는 경우, 규칙은 일치하는 그룹 없음 동작을 적용합니다. +- 음소거된 모니터는 두 가지 선택 모드에서 자동으로 제외됩니다. [1]: /ko/monitors/manage/search/ [2]: /ko/monitors/manage/#triggered-monitors {{% /tab %}} -{{% tab "APM 잘못된 배포 탐지" %}} -이 규칙 유형은 Watchdog의 [APM 잘못된 배포 탐지][1] 분석을 사용하여 배포된 버전과 동일한 서비스의 이전 버전을 비교합니다. 분석을 통해 탐지되는 사항은 다음과 같습니다. +{{% tab "APM Faulty Deployment Detection" %}} +이 규칙 유형은 Watchdog의 [APM Faulty Deployment Detection][1] 분석을 사용하여 배포된 버전과 동일한 서비스의 이전 버전을 비교합니다. 분석을 통해 탐지되는 사항은 다음과 같습니다. - 새로운 유형의 오류 - 이전 버전 대비 오류율의 상당한 증가 @@ -105,8 +122,8 @@ Datadog UI, API 또는 Terraform에서 관리되는 영구 게이트가 필요 **옵션**: -- `duration`: 분석이 실행되는 시간(초)입니다. 최적의 분석 신뢰도를 위해 이 값은 배포 시작 후 900초(15분) 이상이어야 합니다. 최댓값은 7,200초(2시간)입니다. -- `allowed_resources` (선택 사항): 분석에 포함할 [APM 리소스][2]입니다. 지정된 경우 나열된 리소스만 분석됩니다. `excluded_resources`와 상호 배타적입니다. +- `duration`: 분석이 실행되는 시간(초)입니다. 최적의 분석 신뢰도를 위해 이 값은 배포 시작 후 900초(15분) 이상으로 설정하는 것이 좋습니다. 최댓값은 7,200초(2시간)입니다. +- `allowed_resources` (선택 사항): 분석에 포함할 [APM 리소스][2]입니다. 지정된 경우 목록에 있는 리소스만 분석됩니다. `excluded_resources`와 상호 배타적입니다. - `excluded_resources` (선택 사항): 무시할 [APM 리소스][2]입니다(예: 낮은 볼륨 또는 낮은 우선순위 엔드포인트). `allowed_resources`와 상호 배타적입니다. 인라인 규칙 예시: @@ -171,22 +188,22 @@ datadog-ci deployment gate --service transaction-backend --env production --vers } ``` -명령: +이 명령은 다음을 수행합니다. -- 게이트 평가를 시작하기 위한 요청을 전송하고 평가가 완료될 때까지 차단합니다. -- 평가를 기다릴 시간에 대한 구성 가능한 제한 시간을 제공합니다. +- 게이트 평가를 시작하기 위한 요청을 전송하고 평가가 완료될 때까지 대기합니다. +- 평가를 기다릴 최대 시간을 구성할 수 있습니다. - 오류에 대한 자동 재시도 기능이 내장되어 있습니다. -- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `--fail-on-error`를 허용합니다. +- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `--fail-on-error`를 지원합니다. `deployment gate` 명령은 datadog-ci 버전 v3.17.0 이상에서 사용할 수 있습니다. `--config` 플래그에는 버전 v5.19.0 이상이 필요합니다. **필수 환경 변수**: -- `DD_API_KEY`: [API 키][2]입니다. -- `DD_APP_KEY`: [애플리케이션 키][3]입니다. +- `DD_API_KEY`: [API 키][2] +- `DD_APP_KEY`: [애플리케이션 키][3] - `DD_BETA_COMMANDS_ENABLED=1`: `deployment gate` 명령은 미리 보기 명령입니다. -전체 구성 옵션 및 사용 예시는 [`deployment gate` 명령 설명서][4]를 참조하세요. +전체 구성 옵션 및 사용 예시는 [`deployment gate` 명령 문서][4]를 참조하세요. [1]: https://github.com/DataDog/datadog-ci [2]: https://app.datadoghq.com/organization-settings/api-keys @@ -195,11 +212,11 @@ datadog-ci deployment gate --service transaction-backend --env production --vers {{% /tab %}} {{% tab "Argo Rollouts" %}} -[AnalysisTemplate][1] 또는 [ClusterAnalysisTemplate][1]을 생성하여 Argo Rollouts Kubernetes 리소스에서 Deployment Gates를 호출하세요. 이 템플릿은 [datadog-ci 배포 게이트 명령][7]을 실행하여 Deployment Gates API와 상호작용합니다. +Argo Rollouts Kubernetes 리소스에서 [AnalysisTemplate][1] 또는 [ClusterAnalysisTemplate][1]을 생성하여 Deployment Gates를 호출하세요. 이 템플릿은 [datadog-ci 배포 게이트 명령][7]을 실행하여 Deployment Gates API와 상호작용합니다. 아래 템플릿을 시작점으로 사용하세요. -- [Datadog 사이트 이름][2]으로 ``를 바꿉니다(예: {{< region-param key="dd_site" code="true" >}}). +- ``를 [Datadog 사이트 이름][2]으로 바꿉니다(예: {{< region-param key="dd_site" code="true" >}}). - [API 키][5] 및 [애플리케이션 키][6]를 환경 변수로 정의합니다. 이 예시에서는 `api-key` 및 `app-key`라는 두 개의 데이터 값을 가진 `datadog`이라는 [Kubernetes 시크릿][3]을 사용합니다. `valueFrom` 대신 `value`를 사용하여 일반 텍스트로 값을 전달할 수도 있습니다. - `--config` 플래그를 지원하는 datadog-ci 이미지 버전(v5.19.0 이상)을 사용합니다. @@ -283,9 +300,9 @@ spec: name: gate-config ``` -- 분석 템플릿은 Rollout 리소스(`service`, `env`, `version`)로부터 인수를 받을 수 있습니다. 자세한 내용은 [공식 Argo Rollouts 설명서][4]를 참조하세요. -- `ttlSecondsAfterFinished` 는 완료된 작업을 5분 후에 제거합니다. -- `backoffLimit` 은 0으로 설정됩니다. 게이트 평가가 실패할 경우 작업이 재시도되어서는 안 되기 때문입니다. +- 분석 템플릿은 Rollout 리소스(`service`, `env`, `version`)로부터 인수를 받을 수 있습니다. 자세한 내용은 [공식 Argo Rollouts 문서][4]를 참조하세요. +- `ttlSecondsAfterFinished`는 완료된 작업을 5분 후에 제거합니다. +- `backoffLimit`은 은 0으로 설정됩니다. 게이트 평가가 실패할 경우 작업이 재시도되어서는 안 되기 때문입니다. 분석 템플릿을 생성한 후 Argo Rollouts 전략에서 이를 참조하세요. @@ -395,17 +412,17 @@ jobs: } ``` -액션: +이 액션은 다음을 수행합니다. -- 게이트 평가를 시작하기 위한 요청을 전송하고 평가가 완료될 때까지 차단합니다. -- 평가를 기다릴 시간에 대한 구성 가능한 제한 시간을 제공합니다. +- 게이트 평가를 시작하기 위한 요청을 전송하고 평가가 완료될 때까지 대기합니다. +- 평가를 기다릴 최대 시간을 구성할 수 있습니다. - 오류에 대한 자동 재시도 기능이 내장되어 있습니다. -- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `fail-on-error`를 허용합니다. +- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `fail-on-error`를 지원합니다. **필수 환경 변수**: -- `DD_API_KEY`: [API 키][2]입니다. -- `DD_APP_KEY`: [애플리케이션 키][3]입니다. +- `DD_API_KEY`: [API 키][2] +- `DD_APP_KEY`: [애플리케이션 키][3] 전체 구성 옵션 및 사용 예시는 [`DataDog/deployment-gate-github-action` 리포지토리][4]를 참조하세요. @@ -419,11 +436,11 @@ jobs: 이 스크립트를 시작점으로 사용하세요. 해당 스크립트는 인라인 JIT 규칙을 사용하여 게이트를 평가합니다. -다음을 바꾸세요. +다음 값을 바꾸세요. -- ``: [Datadog 사이트 이름][1]입니다(예: {{< region-param key="dd_site" code="true" >}}). -- ``: [API 키][2]입니다. -- ``: [애플리케이션 키][3]입니다. +- ``: [Datadog 사이트 이름][1](예: {{< region-param key="dd_site" code="true" >}}) +- ``: [API 키][2] +- ``: [애플리케이션 키][3] ```bash #!/bin/sh @@ -561,22 +578,22 @@ while true; do done ``` -스크립트: +이 스크립트는 다음을 수행합니다. -- `service`, `environment`, `version` 등 세 가지 입력을 받습니다. 하나 이상의 APM 잘못된 배포 탐지 규칙이 평가되는 경우 `version`이 필요합니다. -- 평가를 시작하기 위한 요청을 보내고 `evaluation_id`를 기록합니다. 다음과 같이 HTTP 응답 코드를 처리합니다. - - 5xx: 서버 오류, 지연 후 재시도합니다. +- `service`, `environment`, `version` 세 가지 입력을 받습니다. 하나 이상의 APM Faulty Deployment Detection 규칙이 평가되는 경우 `version`이 필요합니다. +- 평가를 시작하기 위한 요청을 보내고 `evaluation_id`를 기록합니다. HTTP 응답 코드는 다음과 같이 처리합니다. + - 5xx: 서버 오류, 일정 시간 후 재시도합니다. - 4xx: 클라이언트 오류, 평가에 실패합니다. - 2xx: 평가가 시작되었습니다. -- 다음과 같이 평가가 완료될 때까지 `evaluation_id`로 평가 상태 엔드포인트를 폴링합니다. - - 5xx: 서버 오류, 지연 후 재시도합니다. - - 404: 평가가 아직 시작되지 않음, 지연 후 재시도합니다. +- `evaluation_id`를 사용하여 평가가 완료될 때까지 평가 상태 엔드포인트를 폴링합니다. + - 5xx: 서버 오류, 일정 시간 후 재시도합니다. + - 404: 평가가 아직 시작되지 않음, 일정 시간 후 재시도합니다. - 4xx(404 제외): 클라이언트 오류, 평가에 실패합니다. - - 2xx: `gate_status`를 검사하고 완료되지 않은 경우 지연 후 재시도합니다. + - 2xx: `gate_status`를 검사하고 완료되지 않은 경우 일정 시간 후 재시도합니다. - 평가가 완료되거나 최대 폴링 시간(기본값: 10,800초 = 3시간)에 도달할 때까지 15초마다 폴링합니다. -- 초기 요청에 대한 모든 재시도가 소진되면(5xx 응답) 스크립트는 API 실패에 유연하게 대응하기 위해 이를 성공으로 처리합니다. +- 초기 요청에서 모든 재시도가 소진되면(5xx 응답) 스크립트는 API 오류에 유연하게 대응하기 위해 이를 성공으로 처리합니다. -사용 사례에 맞게 스크립트를 조정하세요. 이 스크립트는 `curl`(요청 수행) 및 `jq`(반환된 JSON 처리)를 사용합니다. 이러한 명령을 사용할 수 없는 경우, 스크립트 시작 부분에 설치하세요(예: `apk add --no-cache curl jq` 사용). +사용 사례에 맞게 스크립트를 조정하세요. 이 스크립트는 요청을 수행하는 데 `curl`을 사용하고, 반환된 JSON을 처리하는 데 `jq`를 사용합니다. 이러한 명령을 사용할 수 없는 경우, 스크립트 시작 부분에 설치하세요(예: `apk add --no-cache curl jq` 사용). [1]: /ko/getting_started/site/ [2]: https://app.datadoghq.com/organization-settings/api-keys @@ -588,13 +605,13 @@ done Deployment Gates 평가는 비동기식입니다. 평가를 트리거하면 백그라운드에서 시작되며, API는 진행 상황을 추적하는 데 사용할 수 있는 평가 ID를 반환합니다. - 먼저, Deployment Gates 평가를 요청하면 프로세스가 시작되고 평가 ID가 반환됩니다. -- 그런 다음 평가 ID를 사용하여 주기적으로 평가 상태 엔드포인트를 폴링하여 평가 완료 시 결과를 검색합니다. 10~20초마다 폴링하는 것이 좋습니다. +- 그런 다음 평가 ID를 사용하여 주기적으로 평가 상태 엔드포인트를 폴링하여 평가 완료 시 결과를 검색합니다. 10~20초마다 폴링하는 것을 권장합니다. -다음을 바꾸세요. +다음 값을 바꾸세요. -- ``: [Datadog 사이트 이름][1]입니다(예: {{< region-param key="dd_site" code="true" >}}). -- ``: [API 키][2]입니다. -- ``: [애플리케이션 키][3]입니다. +- ``: [Datadog 사이트 이름][1](예: {{< region-param key="dd_site" code="true" >}}) +- ``: [API 키][2] +- ``: [애플리케이션 키][3] 인라인 규칙과 함께 `configuration`을 전달하세요(API 경계에서 snake_case 사용). @@ -652,9 +669,9 @@ EOF } ``` -`data.attributes.evaluation_id` 필드에는 이 게이트 평가에 대한 고유 식별자가 포함되어 있습니다. +`data.attributes.evaluation_id` 필드에는 이 게이트 평가의 고유 식별자가 포함됩니다. -평가 ID로 상태 엔드포인트를 폴링하여 게이트 평가 상태를 가져오세요. +평가 ID를 사용하여 상태 엔드포인트를 폴링하여 게이트 평가 상태를 가져오세요. ```bash curl -X GET "https://api./api/v2/deployments/gates/evaluation/" \ @@ -690,7 +707,7 @@ curl -X GET "https://api./api/v2/deployments/gates/evaluation/}} Deployment Gates는 미리 보기로 제공되고 있습니다. 이 기능에 관심이 있다면 양식을 작성하여 액세스 권한을 요청하세요. @@ -18,7 +18,7 @@ Deployment Gates는 미리 보기로 제공되고 있습니다. 이 기능에 **사전 구성된** Deployment Gates를 사용하면 게이트와 규칙이 Datadog에 저장되며, 평가 시 서비스 및 환경을 기준으로 참조됩니다. 사전 구성된 게이트는 여러 배포에서 규칙을 공유하거나, Terraform에서 구성을 관리하거나, CI 사용자가 아닌 사용자가 Datadog UI에서 규칙을 편집하도록 하려는 경우에 적합합니다. -배포 구성에서 규칙을 인라인으로 정의하려면 [JIT (Just-In-Time) Deployment Gates][5]를 참조하세요. +배포 구성에서 규칙을 인라인으로 정의하려면 [JIT(Just-In-Time) Deployment Gates][5]를 참조하세요. ## 게이트 생성 {#create-a-gate} @@ -50,19 +50,21 @@ Deployment Gates는 미리 보기로 제공되고 있습니다. 이 기능에 {{< tabs >}} {{% tab "Monitor" %}} -Monitor 규칙은 구성 가능한 기간 동안 모니터 집합의 상태를 평가합니다. 평가 기간 중 언제든지 다음 상황이 발생하면 실패합니다. +Monitor 규칙은 구성 가능한 기간 동안 모니터 집합의 상태를 평가합니다. 검색 쿼리 또는 명시적인 모니터 목록을 통해 모니터를 선택합니다. 이러한 선택 방법은 상호 배타적입니다. 평가 기간 중 언제든지 다음 상황이 발생하면 규칙 실패로 이어질 수 있습니다. -- 쿼리와 일치하는 모니터가 없는 경우 -- 쿼리와 일치하는 모니터가 50개를 초과하는 경우 -- 일치하는 모니터 중 하나라도 `ALERT` 또는 `NO_DATA` 상태인 경우 +- 구성된 선택 항목과 일치하는 모니터 그룹이 존재하지 않습니다. +- 명시적인 모니터 ID가 존재하지 않거나 조직에서 사용할 수 없습니다. +- 구성된 선택 항목과 일치하는 모니터가 300개를 초과합니다. +- 일치하는 모니터 그룹 중 하나라도 `ALERT` 또는 `NO_DATA` 상태입니다. ##### 구성 설정 {#configuration-settings} -- {{< ui >}}Search Query{{< /ui >}}: [Search Monitor 구문][1]을 기반으로 평가할 모니터를 찾는 데 사용되는 쿼리입니다. 다음 모니터 태그를 기준으로 필터링할 수 있습니다. +- {{< ui >}}Monitors matching query{{< /ui >}}: [모니터 검색 구문][1]을(를) 기반으로 쿼리를 입력합니다. 다음 모니터 태그를 기준으로 필터링할 수 있습니다. - 모니터 정적 태그: `service:transaction-backend` - 모니터 쿼리 내 태그: `scope:"service:transaction-backend"` - [모니터 그룹][2] 내 태그: `group:"service:transaction-backend"` -- {{< ui >}}Duration{{< /ui >}}: 일치하는 모니터를 평가할 기간(초)입니다. 기본값은 0입니다. 이 경우 모니터가 즉시 평가됩니다. 최댓값은 7,200초(2시간)입니다. +- {{< ui >}}Specific monitors{{< /ui >}}: 개별 모니터를 선택하고, (선택 사항) 각 모니터별로 평가하려는 정확한 그룹을 선택합니다. 그룹을 선택하지 않으면 해당 모니터의 모든 그룹을 대상으로 평가가 이루어집니다. +- {{< ui >}}Duration{{< /ui >}}: 선택한 모니터를 평가할 기간(초)입니다. 기본값은 0입니다. 이 경우 모니터가 즉시 평가됩니다. 최댓값은 7,200초(2시간)입니다. ##### 쿼리 예시 {#example-queries} @@ -71,9 +73,24 @@ Monitor 규칙은 구성 가능한 기간 동안 모니터 집합의 상태를 - `tag:"use_deployment_gates" team:payment` - `tag:"use_deployment_gates" AND (NOT group:("team:frontend"))` +##### 특정 모니터 API 예시 {#specific-monitors-api-example} + +```json +"options": { + "monitor_ids": [ + {"id": "12345678", "groups": []}, + {"id": "87654321", "groups": ["service:api", "env:prod"]} + ], + "duration": 300 +} +``` + +각 `id`는 10진수 모니터 ID입니다. 그룹 값은 정확한 그룹 이름입니다. `query`와 `monitor_ids`를 함께 전송하지 마세요. + **참고**: -- `group`필터는 일치하는 그룹만 평가합니다. -- 음소거된 모니터는 평가에서 자동으로 제외됩니다. 쿼리에는 항상 `muted:false`가 포함됩니다. +- `group` 쿼리 필터와 `monitor_ids[].groups`는 일치하는 그룹만 평가합니다. +- 명시적인 모니터 ID가 존재하지 않거나 조직에서 사용할 수 없는 경우 규칙 실패로 이어집니다. 모니터가 존재하지만 음소거 상태이거나 선택한 그룹에 데이터가 없어 제외되는 경우, 규칙은 일치하는 그룹 없음 동작을 적용합니다. +- 음소거된 모니터는 두 가지 선택 모드에서 자동으로 제외됩니다. [1]: /ko/monitors/manage/search/ [2]: /ko/monitors/manage/#triggered-monitors @@ -82,14 +99,14 @@ Monitor 규칙은 구성 가능한 기간 동안 모니터 집합의 상태를 이 규칙 유형은 Watchdog의 [APM Faulty Deployment Detection][1] 분석을 사용하여 배포된 버전과 동일한 서비스의 이전 버전을 비교합니다. 분석을 통해 탐지되는 사항은 다음과 같습니다. - 새로운 유형의 오류 -- 이전 버전 대비 오류율이 크게 증가한 경우 +- 이전 버전 대비 오류율의 상당한 증가 이 분석은 모든 APM 계측 서비스에 대해 자동으로 수행되며, 사전 설정이 필요하지 않습니다. ##### 구성 설정 {#configuration-settings-1} - {{< ui >}}Operation Name{{< /ui >}}: 서비스의 [APM 기본 작업][3] 설정에서 자동으로 입력됩니다. -- {{< ui >}}Duration{{< /ui >}}: 분석이 실행되는 시간(초)입니다. 분석 신뢰도를 위해 이 값은 배포 시작 후 900초(15분) 이상으로 설정하는 것이 좋습니다. 최댓값은 7,200초(2시간)입니다. +- {{< ui >}}Duration{{< /ui >}}: 분석이 실행되는 시간(초)입니다. 최적의 분석 신뢰도를 위해 이 값은 배포 시작 후 900초(15분) 이상으로 설정하는 것이 좋습니다. 최댓값은 7,200초(2시간)입니다. - {{< ui >}}Allowed Resources{{< /ui >}} (필요시): 분석에 포함할 쉼표로 구분된 [APM 리소스][2]입니다. 지정된 경우 목록에 있는 리소스만 분석됩니다. {{< ui >}}Excluded Resources{{< /ui >}}와 상호 배타적입니다. - {{< ui >}}Excluded Resources{{< /ui >}} (선택 사항): 무시할 쉼표로 구분된 [APM 리소스][2]입니다(예: 낮은 볼륨 또는 낮은 우선순위 엔드포인트). {{< ui >}}Allowed Resources{{< /ui >}}와 상호 배타적입니다. @@ -124,7 +141,7 @@ Deployment Gate에 APM Faulty Deployment Detection 규칙이 포함된 경우 - 게이트 평가를 시작하기 위한 요청을 전송하고 평가가 완료될 때까지 대기합니다. - 평가를 기다릴 최대 시간을 구성할 수 있습니다. - 오류에 대한 자동 재시도 기능이 내장되어 있습니다. -- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `--fail-on-error`을 지원합니다. +- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `--fail-on-error`를 지원합니다. `deployment gate` 명령은 datadog-ci 버전 v3.17.0 이상에서 사용할 수 있습니다. @@ -193,8 +210,8 @@ spec: ``` - 분석 템플릿은 Rollout 리소스(예: `service`, `env`, `version`)로부터 인수를 받을 수 있습니다. 자세한 내용은 [공식 Argo Rollouts 문서][4]를 참조하세요. -- `ttlSecondsAfterFinished`는 완료된 작업을 5분 후에 제거합니다. -게이트 평가가 실패할 경우 작업을 재시도하지 않아야 하므로 - `backoffLimit`은 0으로 설정됩니다. +- `ttlSecondsAfterFinished` 완료된 작업을 5분 후에 제거합니다. +- `backoffLimit` 은 0으로 설정됩니다. 게이트 평가가 실패할 경우 작업이 재시도되어서는 안 되기 때문입니다. 분석 템플릿을 생성한 후 Argo Rollouts 전략에서 이를 참조하세요. @@ -283,7 +300,7 @@ Deployment Gate에 APM Faulty Deployment Detection 규칙이 포함된 경우 - 게이트 평가를 시작하기 위한 요청을 전송하고 평가가 완료될 때까지 대기합니다. - 평가를 기다릴 최대 시간을 구성할 수 있습니다. - 오류에 대한 자동 재시도 기능이 내장되어 있습니다. -- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `fail-on-error`을 지원합니다. +- 예기치 않은 Datadog 오류 발생 시 동작을 사용자 지정하기 위해 `fail-on-error`를 지원합니다. **필수 환경 변수**: diff --git a/hugo/content/ko/gpu_monitoring/tracing.md b/hugo/content/ko/gpu_monitoring/tracing.md new file mode 100644 index 00000000000..b948aac82e5 --- /dev/null +++ b/hugo/content/ko/gpu_monitoring/tracing.md @@ -0,0 +1,100 @@ +--- +description: 선택한 Kubernetes 워크로드에 대해 GPU 활동 추적을 활성화하세요. +further_reading: +- link: /gpu_monitoring/setup + tag: 설명서 + text: GPU Monitoring 설정 +- link: /gpu_monitoring + tag: GPU Monitoring이란? + text: GPU Monitoring 기능에 대해 자세히 알아보기 +is_beta: true +private: true +title: GPU Monitoring을 통한 지속적인 추적 +--- +{{< beta-callout url="#" btn_hidden="true" >}} +GPU Monitoring을 통한 지속적인 추적은 현재 사전 액세스 단계에 있습니다. +{{< /beta-callout >}} + +## 개요 {#overview} + +GPU Monitoring을 통한 지속적인 추적 기능은 선택한 Kubernetes 워크로드에 대해 간단한 GPU 활동 추적을 활성화합니다. 대규모 분산 워크로드 문제를 해결하는 과정은 번거롭고 시간이 많이 소요될 수 있습니다. GPU Monitoring의 추적 기능을 사용하면 CUDA 및 NCCL 작업을 모델 및 PyTorch 작업과 연결하는 상세한 실행 트레이스를 통해 병목 현상을 식별하고 조사할 수 있습니다. + +{{< img src="gpu_monitoring/gpu-tracing.png" alt="NCCL allgather 작업 및 CUDA 커널 실행 등 GPU 스트림 활동과 정렬된 CPU 스팬을 보여주는 torch.step 트레이스의 플레임 그래프 뷰 화면입니다." style="width:100%;" >}} + +## 설정 {#setup} + +### 전제 조건 {#prerequisites} + +워크로드를 지속적으로 추적하려면 우선 다음 기준을 충족해야 합니다. +- [GPU Monitoring 활성화][1] Datadog Cluster Agent 버전 7.80 이상을 실행 중이어야 합니다. +- 최소 필수 CUDA 및 CUPTI 버전: 13. + +### 1. GPU 추적 구성 {#1-configure-gpu-tracing} + +다음 구성을 기존 `DatadogAgent` 리소스에 병합합니다. + +```yaml +spec: + features: + apm: + enabled: true + instrumentation: + enabled: true + targets: + - name: gpu-monitoring + podSelector: + matchLabels: + admission.datadoghq.com/gpu.enabled: "true" + ddTraceVersions: + c: "0.20.0" + ddTraceConfigs: + - name: DD_INJECT_NATIVE + value: "always" + - name: DD_TRACE_HOOK_MODULES + value: "gpu" +``` + +구성을 적용하고 `DatadogAgent` 롤아웃이 완료될 때까지 기다리세요. + +### 2. GPU 워크로드 레이블 지정 {#2-label-the-gpu-workload} + +컨트롤러의 포드 템플릿에 레이블을 추가합니다. 워크로드는 Agent 네임스페이스 외부에 있어야 합니다. Jobs의 경우 `spec.template.metadata.labels`를 사용합니다. KubeRay의 경우 헤드 및 워커 포드 템플릿에 레이블을 지정합니다. + +```yaml +spec: + template: + metadata: + labels: + admission.datadoghq.com/gpu.enabled: "true" +``` + +리소스를 적용하고 롤아웃이 완료될 때까지 기다리세요. + +### 3. 설정 확인 {#3-verify-setup} + +```shell +# Confirm setup containers completed +kubectl get pod -n \ + -o jsonpath='{range .status.initContainerStatuses[*]}{.name}{" exit="}{.state.terminated.exitCode}{"\n"}{end}' + +# Confirm the GPU tracing settings +kubectl exec -n -- sh -c \ + 'env | grep -E "^(DD_INJECT_NATIVE|DD_TRACE_HOOK_MODULES|DD_SERVICE|DD_ENV)="' +``` + +**설정 컨테이너가 없나요?** 포드 템플릿에 레이블이 지정되어 있는지, 포드가 새로 생성되었는지, 워크로드가 Agent 네임스페이스 외부에 있는지 확인하세요. 그런 다음 Cluster Agent 로그를 확인합니다. + +### 4. 트레이스 탐색 {#4-explore-traces} + +워크로드를 실행한 다음 [APM Trace Explorer][2]에서 쿼리를 진행합니다. + +``` +pod_name: kube_namespace: +``` + +## 추가 자료 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /ko/gpu_monitoring/setup +[2]: /ko/tracing/trace_explorer/ \ No newline at end of file diff --git a/hugo/content/ko/incident_response/incident_management/post_incident/_index.md b/hugo/content/ko/incident_response/incident_management/post_incident/_index.md new file mode 100644 index 00000000000..f84209ea426 --- /dev/null +++ b/hugo/content/ko/incident_response/incident_management/post_incident/_index.md @@ -0,0 +1,69 @@ +--- +description: 인시던트 해결 후 사후 분석 및 후속 작업 관리하기 +further_reading: +- link: /incident_response/incident_management/post_incident/postmortems + tag: 설명서 + text: 사후 분석 보고서 생성 및 관리 +- link: /incident_response/incident_management/setup_and_configuration/templates + tag: 설명서 + text: 사후 분석 및 메시지 템플릿 구성 +- link: /incident_response/incident_management/post_incident/follow-ups + tag: 설명서 + text: 인시던트 후속 작업 관리 +- link: /incident_response/work_management/ + tag: 설명서 + text: Work Management를 통한 후속 작업 추적 +title: 인시던트 이후 +--- +## 개요 {#overview} + +인시던트가 해결되거나 안정적인 상태에 도달하면 인시던트 이후 단계가 시작됩니다. 이 중요한 단계는 발생한 사건을 기록하고, 교훈을 정리하고, 향후 유사한 인시던트를 방지하기 위한 후속 조치를 추적하는 데 중점을 둡니다. 인시던트 이후 워크플로는 인시던트 대응 프로세스의 지속적인 개선을 보장하고 조직 지식을 구축하는 데 도움이 됩니다. + +인시던트 이후 활동을 통해 다음을 수행합니다. + +- 인시던트 세부 정보, 근본 원인, 교훈을 기록하는 사후 분석 보고서를 생성합니다. +- 수정 및 프로세스 개선을 위한 후속 작업을 생성하고 관리합니다. +- 이해관계자에게 인시던트 상태 및 해결에 관한 정보를 전달합니다. +- 인시던트 패턴 및 해결 방법에 관한 지식 베이스를 구축합니다. + +## 사후 분석 보고서 {#postmortems} + +사후 분석 보고서는 인시던트 대응 프로세스의 지속적인 개선을 위해 필수적입니다. 인시던트를 해결한 후 Datadog Notebook, Confluence 페이지, Google Drive 문서를 사용하여 인시던트 정보가 자동으로 채워지는 사후 분석 보고서를 생성할 수 있습니다. + +인시던트 사후 분석 보고서에는 일반적으로 다음 내용이 포함됩니다. + +- **인시던트 요약**: 발생한 사건에 대한 개괄적인 설명 +- **타임라인**: 인시던트 발생 중 사건들을 시간 순으로 배열 +- **근본 원인 분석**: 근본 원인에 대한 상세 조사 +- **영향 평가**: 고객 및 서비스 영향 메트릭 +- **실행 항목**: 재발 방지를 위한 구체적인 작업 +- **교훈**: 조직 차원의 핵심 시사점 + +사후 분석 보고서 생성 및 템플릿 구성에 대한 자세한 내용은 [Incident Postmortems][2]를 참조하세요. + +## 후속 조치 {#follow-ups} + +인시던트 조사 중에 팀은 주의가 필요하지만 즉각적인 문제 해결과 직접적인 관련이 없는 문제를 식별할 수 있습니다. 후속 조치를 통해 서비스를 복구하는 긴박한 상황에서 흐름을 놓치지 않고 나중에 처리할 항목을 기록할 수 있습니다. + +일반적인 예로는 인프라 개선, 기술 부채, 프로세스 격차, 즉각적인 완화 조치에 비해 더 많은 시간이 필요한 근본 원인 수정 등이 있습니다. + +후속 조치는 인시던트 발생 중 또는 이후에 언제든지 인시던트의 **수정** 탭 또는 슬랙에서 생성할 수 있습니다. 해결 후, 후속 조치를 [Jira][3](단방향 동기화) 또는 [Work Management][4](Jira 및 ServiceNow와 양방향 동기화)로 내보내 팀의 기존 워크플로에 통합할 수 있습니다. + +후속 조치 생성, 관리, 내보내기에 대한 자세한 내용은 [Incident Follow-ups][5]를 참조하세요. + +## 상태 페이지 {#status-pages} + +상태 페이지를 통해 이해관계자에게 인시던트 상태 및 해결에 관한 정보를 전달합니다. 인시던트에서 직접 상태 페이지 공지를 생성 및 업데이트하여 고객이나 내부 팀에 서비스 가용성 및 인시던트 세부 정보를 전달할 수 있습니다. 상태 페이지 업데이트를 특정 인시던트 구성 요소에 연결하면 진행 중인 인시던트의 영향을 자동으로 반영할 수 있습니다. + +상태 페이지를 인시던트 워크플로에 통합하는 방법에 대한 자세한 내용은 [Status Pages][6]를 참조하세요. + +## 추가 자료 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/incidents/settings +[2]: /ko/incident_response/incident_management/post_incident/postmortems +[3]: /ko/integrations/jira/ +[4]: /ko/incident_response/work_management/ +[5]: /ko/incident_response/incident_management/post_incident/follow-ups +[6]: /ko/incident_response/status_pages/ \ No newline at end of file diff --git a/hugo/content/ko/integrations/guide/aws-agent-installation-technical-reference.md b/hugo/content/ko/integrations/guide/aws-agent-installation-technical-reference.md new file mode 100644 index 00000000000..ba25d0b1679 --- /dev/null +++ b/hugo/content/ko/integrations/guide/aws-agent-installation-technical-reference.md @@ -0,0 +1,139 @@ +--- +description: Datadog이 AWS 통합을 통해 Amazon EC2에 Datadog Agent를 설치하고 유지 관리하는 방식(생성되는 AWS + 리소스, 설치 메커니즘, 보안 모델, Datadog Agent 수명 주기)에 대해 알아보세요. +further_reading: +- link: https://docs.datadoghq.com/integrations/guide/aws-agent-installation/ + tag: 설명서 + text: AWS 통합을 통한 Datadog Agent 설치 +- link: https://docs.datadoghq.com/integrations/amazon_web_services/ + tag: 설명서 + text: AWS 통합 +- link: https://docs.datadoghq.com/agent/fleet_automation/ + tag: 설명서 + text: Fleet Automation +private: true +title: AWS 통합을 통한 Agent 설치 방법 +--- +이 페이지에서는 Datadog이 AWS 통합을 통해 Amazon EC2에 Datadog Agent를 설치하고 유지 관리하는 방법을 설명합니다. 설정 지침과 Datadog에서 필요한 권한은 [AWS 통합을 통한 Datadog Agent 설치][1]를 참조하세요. + +
이 페이지에서는 Amazon EC2 환경만 다룹니다.
+ +## Datadog이 생성하는 AWS 리소스 {#aws-resources-that-datadog-creates} + +CloudFormation 템플릿을 실행하면 단일 스택 내에서 다음 리소스를 한 번 생성합니다: + +| 리소스 | 이름 | 목적 | +|---|---|---| +| EventBridge 연결 | `datadog-agent-resource-update-intake-connection` | Datadog으로 이벤트를 전송할 수 있도록 Datadog API 및 애플리케이션 키를 보관합니다. | +| EventBridge API 대상 | `datadog-agent-resource-update-intake-destination` | 이벤트를 `https://api./api/unstable/instrumenter/events`로 전송합니다(초당 10개 이벤트로 제한됨). | +| EventBridge 규칙 | `datadog-agent-resource-update-rule-ec2` | 대상 인스턴스에 변경 사항 발생 시 Datadog에 알립니다. | +| IAM 역할 | 자동 명명 | EventBridge가 `datadog-agent-resource-update-intake-destination` API 대상으로 이벤트를 전송하도록 합니다. | +| IAM 역할 | `datadog-eventbridge-cross-region-role` | 다른 리전에서 기본 리전으로 이벤트를 전송하도록 합니다. | + +Datadog은 설치 시 필요에 따라 다음 리소스를 생성합니다. + +| 리소스 | 이름 | 목적 | +|---|---|---| +| Systems Manager 문서 | `datadog-ec2-instrumenter` | 설치 및 제거 스크립트입니다. 계정당 하나의 문서가 있습니다. | +| Secrets Manager 보안 암호 | `/datadog/ec2-instrumenter//` | 인스턴스에서 직접 가져올 수 있도록 Datadog API 키를 보관합니다. 기본 AWS 관리형 키로 암호화됩니다. | +| IAM 역할 및 인스턴스 프로필 | `datadog-ssm-` 및 `datadog-ssm-profile-` | 인스턴스 프로필이 없는 경우에만 IAM 경로 `/datadog-ec2-instrumenter/` 아래에 생성되므로 이를 식별할 수 있습니다. Systems Manager가 인스턴스에 접근할 수 있도록 AWS 관리형 `AmazonSSMManagedInstanceCore` 정책을 적용합니다. | +| 인라인 IAM 정책 | `datadog-ec2-instrumenter-secrets` | 인스턴스의 역할에 추가되었습니다. `/datadog/ec2-instrumenter/` 아래의 시크릿에 대한 읽기 권한만 부여합니다. | +| 다른 리전의 EventBridge 규칙 | 기본 리전 리소스와 동일한 이름 | 변경 이벤트를 기본 리전으로 전달합니다. | + +Datadog은 S3 버킷, 이벤트 버스, 로그 그룹, SSM 파라미터를 생성하지 않으며 인스턴스에 태그를 지정하지 않습니다. + +## Agent 설치 원리{#how-agent-installation-works} + +설치 규칙을 저장하면 Datadog은 규칙과 일치하는 인스턴스를 찾고 시간 경과에 따라 지속적으로 새로운 일치 항목을 확인합니다. Datadog은 대상 인스턴스 각각에 대해 다음 순서로 작업을 실행합니다. 전제 조건(지원되는 플랫폼 포함)은 설정 가이드의 [전제 조건][2]을 참조하세요. + +1. Datadog은 각 대상 인스턴스가 실행 중인지, 지원되는 플랫폼에 있는지, AWS Systems Manager를 통해 연결 가능한지 확인합니다. +2. 인스턴스에 IAM 인스턴스 프로필이 없는 경우, Datadog은 Systems Manager가 인스턴스에 접근할 수 있도록 프로필을 생성합니다. 인스턴스에 이미 프로필이 있는 경우, Datadog은 기존 역할에 SSM 정책과 범위가 지정된 시크릿 읽기 정책을 추가합니다. +3. Datadog은 Agent가 이미 설치되어 있는지 확인합니다. Datadog이 설치하지 않은 Agent가 있는 경우, Datadog은 작업을 중단하고 해당 인스턴스를 그대로 둡니다. +4. Datadog은 `ssm:SendCommand`을 호출하여 한 번에 하나씩 인스턴스에서 `datadog-ec2-instrumenter` 문서를 실행합니다. +5. 인스턴스에서 해당 문서는 인스턴스 자체 IAM 역할을 통해 Secrets Manager에서 API 키를 가져옵니다. 그런 다음 로그 수집 및 APM 호스트 계측이 활성화된 상태로 Datadog의 표준 Agent 설치 프로그램(Linux의 경우 `install_script_agent7.sh`, Windows의 경우 표준 MSI)을 실행합니다. 명령은 6분이 지나면 시간 초과됩니다. + +Datadog은 인스턴스를 재부팅하거나 다시 시작하지 않습니다. Datadog이 관리하는 유일한 서비스는 Datadog Agent 자체이며, 이는 설치 시 시작되고 제거 시 중지됩니다. 사용자의 애플리케이션 및 기타 서비스에 영향을 주지 않습니다. + +### Datadog에서 제외하는 인스턴스 {#instances-that-datadog-excludes} + +Datadog은 다음을 자동으로 제외합니다. + +- 실행되지 않는 인스턴스 +- EKS 워커 노드 +- ECS 컨테이너 인스턴스 +- Datadog에서 설치하지 않은 Agent가 있는 인스턴스 + +## 보안, 감사, 변경 제어 {#security-auditing-and-change-control} + +### Datadog이 액세스 권한을 획득하는 방식 {#how-datadog-gets-access} + +Datadog은 AWS 통합과 동일한 교차 계정 IAM 역할을 사용하며, 이는 외부 ID로 인증됩니다. Datadog은 수명이 짧은 임시 자격 증명을 받고, 각 작업 유형(EC2 읽기, IAM 관리, 명령 전송)은 하나의 광범위한 세션이 아닌 범위가 별도로 지정된 자격 증명 세션을 사용합니다. Datadog은 장기 지속형 AWS 키를 저장하지 않습니다. + +### Datadog의 작업 감사 {#auditing-datadogs-actions} + +Datadog이 수행하는 모든 작업은 표준 AWS API 호출이므로 모든 작업이 AWS CloudTrail에 표시됩니다. Datadog이 생성하는 모든 항목은 이름으로 식별할 수 있습니다. 리소스에는 `datadog-` 접두사가 붙고, 시크릿은 `/datadog/ec2-instrumenter/` 아래에 저장되며, IAM 역할은 변경 불가능한 경로 `/datadog-ec2-instrumenter/`를 사용합니다. IAM 경로는 생성 후 편집이 불가능하므로 경로를 몰래 변경할 수 없습니다. 인스턴스 내 명령 결과는 Systems Manager Run Command 기록에 나타납니다. + +### API 키 처리 방법 {#how-the-api-key-is-handled} + +API 키는 사용자의 Secrets Manager에 저장되며 저장 시 암호화됩니다. 시크릿의 Amazon Resource Name(ARN)만 SSM 명령으로 전달되며, 키 자체는 명령 파라미터나 CloudTrail에 나타나지 않습니다. 인스턴스는 자체 IAM 역할을 통해 단일 경로로 제한된 시크릿을 읽습니다. Datadog은 내부적으로 키 자체가 아닌 키에 대한 참조 값만 저장합니다. + +### 설치 변경 권한이 있는 사용자 {#who-can-change-installations} + +- **AWS**: 사용자의 자체 IAM 정책에 따라 액세스를 관리합니다. 교차 계정 권한을 제거하면 Datadog 작업이 즉시 중지됩니다. +- **Datadog**: 설치 규칙을 확인하려면 **호스트 읽기** 권한이 필요합니다. 규칙을 생성, 편집, 삭제하려면 **Agent 설치** 권한이 필요합니다. 규칙 변경에는 속도 제한이 적용됩니다. + +### 안전 장치{#guardrails} + +- Datadog은 직접 설치하지 않은 Agent는 제거하지 않습니다. +- Datadog은 Agent를 설치한 인스턴스를 추적하므로 자체적으로 수행한 작업만 정리합니다. +- 일부 리전을 나열할 수 없는 경우, Datadog은 대량 제거 위험을 방지하기 위해 이에 대한 정리를 건너뜁니다. + +## Agent 수명 주기와 적용 범위{#agent-life-cycle-and-coverage} + +### 규칙 적용 범위에 대한 지속적인 평가 {#rule-coverage-is-evaluated-over-time} + +규칙은 일치하는 인스턴스를 포함하며, Datadog은 시간 경과에 따라 지속적으로 새로운 일치 항목을 확인합니다. 규칙을 저장한 후 인스턴스가 시작되거나 태그 변경으로 인해 나중에 일치하게 되는 경우, Datadog은 해당 인스턴스를 자동으로 계측합니다. Datadog은 규칙과 일치하지 않는 인스턴스를 계측하지 않습니다. + +적용 범위를 고정된 인스턴스 세트로 지정하려면 해당 인스턴스를 개별적으로 선택합니다. 그러면 규칙은 선택한 인스턴스에 한해서 일치하므로 이후 확인할 때 새로운 인스턴스가 추가되지 않습니다. + +고정 세트가 너무 커서 개별적으로 선택할 수 없다면 `datadog:true` 등 사용자가 제어하는 태그를 일치시킵니다. 해당 태그를 계측하려는 인스턴스에만 적용합니다. 적용 범위는 태그 변경 시에만 변경됩니다. + +### Datadog에서 적용 대상 인스턴스를 동기화 상태로 유지하는 방법 {#how-datadog-keeps-covered-instances-in-sync} + +Datadog은 적용 대상 인스턴스에 대해 사용자가 정의한 상태를 지속적으로 유지합니다. + +- Datadog은 규칙을 정기적으로 확인하고 일치하는 인스턴스를 계측합니다. +- Datadog은 Agent가 없으면 재설치하고, 실패한 설치를 재시도하고, 더 이상 존재하지 않는 인스턴스를 정리합니다. +- 새로운 일치 항목은 일반적으로 1시간 이내, 종종 몇 분 이내에 계측됩니다. +- 이미 Agent가 설치된 인스턴스는 확인 빈도가 낮습니다. + +### 적용 범위 변경 시 조치 {#what-happens-when-coverage-changes} + +적용 범위가 변경되면 Datadog은 규칙의 적용 범위에 어떤 인스턴스가 추가 또는 제거되었는지 판단합니다. 규칙을 편집하거나 인스턴스에 변경 사항이 발생하면 적용 범위가 변경됩니다. Datadog은 적용 범위에 새로 포함된 인스턴스에 Agent를 설치하고, 적용 범위에 속하지 않는 인스턴스에서는 Agent를 제거합니다. 규칙을 삭제하면 해당 규칙을 적용했던 모든 인스턴스에서 Agent가 제거됩니다. + +
+Datadog은 Datadog의 편집이나 AWS에서 인스턴스의 태그를 다시 지정하거나 재구성함에 따라 변경이 발생하여 인스턴스가 더 이상 규칙과 일치하지 않으면 Agent를 제거합니다. 다른 팀이 변경할 수 있는 태그를 기반으로 규칙을 작성할 때는 이 동작을 고려하세요. +
+ +### 종료/중지된 인스턴스 {#terminated-or-stopped-instances} + +Datadog은 종료된 인스턴스를 감지하고 해당 인스턴스에 맞게 생성한 IAM 리소스를 정리합니다. Datadog은 중지된 인스턴스가 다시 시작될 때까지 그대로 둡니다. + +### 설치 실패 시 {#when-an-install-fails} + +Datadog은 지연 시간을 늘려가면서(1시간, 2시간, 최대 하루에 한 번) 다시 시도합니다. 권한이 누락된 경우 **AWS 통합 타일**과 Fleet 설치 페이지에서 문제로 표시됩니다. + +
+누군가 적용 대상 인스턴스에서 Agent를 수동으로 제거하면 Datadog이 다시 설치합니다. 규칙을 기준으로 판단합니다. 적용 대상에서 제외하려면 인스턴스가 더 이상 규칙과 일치하지 않도록 규칙을 변경합니다. +
+ +## Agent 제거 {#uninstall-the-agent} + +제거하면 Datadog Agent, Linux의 `/etc/datadog-agent` 및 `/opt/datadog-agent` 디렉터리(또는 Windows에서 MSI 제거 수행), Datadog이 해당 인스턴스에 맞게 생성한 모든 IAM 역할이나 인스턴스 프로필이 삭제됩니다. Agent를 제거하려면 인스턴스가 더 이상 일치하지 않도록 규칙 쿼리를 편집하거나, 규칙에서 인스턴스를 제거하거나, 규칙을 삭제합니다. + +## 추가 자료 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://docs.datadoghq.com/ko/integrations/guide/aws-agent-installation/ +[2]: https://docs.datadoghq.com/ko/integrations/guide/aws-agent-installation/#prerequisites \ No newline at end of file diff --git a/hugo/content/ko/integrations/guide/aws-agent-installation.md b/hugo/content/ko/integrations/guide/aws-agent-installation.md new file mode 100644 index 00000000000..d05e9fdcbb3 --- /dev/null +++ b/hugo/content/ko/integrations/guide/aws-agent-installation.md @@ -0,0 +1,164 @@ +--- +description: 각 호스트에 연결하거나 호스트별 스크립트를 실행할 필요 없이, AWS 통합에서 직접 Amazon EC2 인스턴스의 Datadog + Agent를 설치하고 관리하세요. +further_reading: +- link: https://docs.datadoghq.com/integrations/guide/aws-agent-installation-technical-reference/ + tag: 설명서 + text: AWS 통합을 통한 Agent 설치 방법 +- link: https://docs.datadoghq.com/integrations/amazon_web_services/ + tag: 설명서 + text: AWS 통합 +- link: https://docs.datadoghq.com/integrations/guide/aws-manual-setup/ + tag: 설명서 + text: AWS 매뉴얼 설정 가이드 +- link: https://docs.datadoghq.com/agent/guide/why-should-i-install-the-agent-on-my-cloud-instances/ + tag: 설명서 + text: 클라우드 인스턴스에 Datadog Agent를 설치하는 이유는 무엇인가요? +- link: https://docs.datadoghq.com/agent/fleet_automation/ + tag: 설명서 + text: Fleet Automation +- link: https://docs.datadoghq.com/agent/configuration/ + tag: 설명서 + text: Agent 구성 +private: true +title: AWS 통합을 통한 Datadog Agent 설치 +--- +## 개요 {#overview} + +[AWS 통합][1]은 호스트에 어떠한 프로그램도 설치하지 않은 상태로 Amazon CloudWatch에서 메트릭, 이벤트, 로그를 수집합니다. Datadog Agent를 설치하면 호스트 수준 메트릭, 분산된 트레이스(APM), Live Processes, 상세 로그 등 CloudWatch만으로 제공할 수 없는 AWS 워크로드 내부의 텔레메트리가 추가됩니다. + +각 호스트에 연결하거나 호스트별 스크립트를 실행할 필요 없이, Datadog에서 직접 Datadog Agent를 Amazon EC2 인스턴스에 배포할 수 있습니다. AWS 통합을 설정하는 과정에서, 또는 설정 후 언제든지 Agent 설치를 활성화합니다. + +Amazon EKS는 지원되지 않습니다. + +## 전제 조건 {#prerequisites} + +시작하기 전에 다음 사항을 확인하세요. + +- **CloudFormation 액세스**: 대상 AWS 계정에서 CloudFormation 스택을 승인할 수 있습니다. 설치 시 계정에 스택이 배포되므로 사용자(또는 팀원)는 이를 검토하고 생성할 권한을 보유해야 합니다. 필요한 권한과 그 이유는 [필수 AWS 권한](#required-aws-permissions) 섹션을 참조하세요. +- **SSM Agent**: [AWS Systems Manager(SSM) Agent][2]가 대상 인스턴스에 이미 설치된 상태여야 합니다. Datadog은 SSM을 통해 Agent를 설치하며 SSM Agent를 대신 설치할 수 없으므로, SSM Agent가 없는 사용자 지정 AMI로 생성된 인스턴스는 대상에서 제외됩니다. Datadog은 해당 인스턴스를 표시하여 사용자가 처리할 수 있도록 합니다. +- **지원 플랫폼**: Linux(x86_64 및 arm64) 및 Windows(x86_64). arm64 기반의 macOS 및 Windows는 지원되지 않습니다. + +## 필수 AWS 권한 {#required-aws-permissions} + +{{% aws-agent-installation %}} + +Datadog은 각 권한을 사용하여 특정 작업을 수행합니다. + +| 권한 | Datadog에서 권한이 필요한 이유| +|---|---| +| `ec2:DescribeInstances` | 인스턴스를 찾고 규칙(상태, 태그, OS, 아키텍처)과 일치하는 인스턴스를 확인합니다. | +| `ssm:DescribeInstanceInformation` | Datadog에서 작업을 시도하기 전에 SSM Agent가 실행 중인지 확인합니다. | +| `ssm:GetDocument`, `ssm:CreateDocument`, `ssm:UpdateDocument`, `ssm:UpdateDocumentDefaultVersion` | 계정에 설치 스크립트를 게시하고 최신 상태로 유지합니다. | +| `ssm:SendCommand`, `ssm:ListCommandInvocations` | 설치를 실행하고 완료되면 설치 상태를 확인합니다. | +| `secretsmanager:DescribeSecret`, `secretsmanager:CreateSecret` | API 키가 명령에 전달되지 않도록 저장합니다. | +| `iam:CreateRole`, `iam:CreateInstanceProfile`, `iam:AddRoleToInstanceProfile`, `iam:AttachRolePolicy`, `iam:PutRolePolicy`, `iam:PassRole`, `ec2:AssociateIamInstanceProfile`, 일치하는 `Get` 및 `List` 읽기 | IAM 역할이 지정되지 않은 경우 인스턴스에 필요한 최소한의 액세스 권한을 부여합니다. Systems Manager를 통해 접근 가능하고 자체 API 키 시크릿을 읽을 수 있어야 합니다. | +| `iam:Detach*`, `iam:Delete*`, `iam:RemoveRoleFromInstanceProfile`, `ec2:Disassociate*`, `ec2:DescribeIamInstanceProfileAssociations` | 제거 시 상기 리소스를 깔끔하게 정리합니다. | +| `ecs:ListClusters`, `ecs:ListContainerInstances` | Amazon Elastic Container Service(ECS) 컨테이너 인스턴스를 인식하여 Datadog에서 이를 건너뛰도록 합니다(클러스터 수준에서 처리). | +| `events:PutRule`, `events:PutTargets`, `events:RemoveTargets`, `events:DeleteRule` | Datadog에서 인스턴스 변경 사항에 대응할 수 있도록 변경 알림을 설정합니다. | + +`iam:CreateRole` 및 `iam:PassRole`은 가장 민감한 권한입니다. `iam:CreateRole`은 계정 내 `datadog-ec2-instrumenter/datadog-ssm-*`과 일치하는 역할 이름으로 제한되며, `iam:PassRole`은 Amazon EC2 서비스에 한해 사용하도록 추가 제한이 적용됩니다. + +## 작동 방식 {#how-it-works} + +에이전트 설치는 **설치 규칙**을 기반으로 작동합니다. 이는 AWS 계정과 포함할 EC2 인스턴스를 설명하는 쿼리가 결합된 형태입니다. Datadog은 시간 경과에 따라 지속적으로 규칙을 다시 확인하고, AWS 계정에서 일치하는 각 인스턴스에 Agent를 설치합니다. + +1. 포함할 EC2 인스턴스를 선택하거나 모든 적격 인스턴스에 대해 옵트인합니다. +1. Datadog은 선택 항목에 포함되는 인스턴스를 식별합니다. +1. Datadog은 AWS Systems Manager를 통해 포함된 각 인스턴스에 Agent를 설치하고 누락된 IAM 구성을 자동으로 추가합니다. +1. Datadog은 시간 경과에 따라 지속적으로 규칙을 다시 확인합니다. 이후 일치하게 되는 인스턴스(새로 시작되거나 새 태그가 지정된 인스턴스)는 자동으로 계측됩니다. + +초기 설정 시 CloudFormation 스택 하나를 한 번만 승인하면 됩니다. 그 후에는 Datadog에서 설치가 자동으로 실행되며, 설치할 때마다 새로운 CloudFormation 템플릿을 시작하지 않아도 됩니다. + +Datadog이 생성하는 AWS 리소스, 설치 메커니즘, Datadog이 인스턴스를 관리하는 방법 등 전체 기술 및 보안 세부 정보는 [AWS 통합을 통한 Agent 설치 방법][6]을 참조하세요. + +{{< img src="integrations/amazon_web_services/aws-agent-installation-how-it-works.png" alt="AWS Agent 설치 프로세스 순서도는 Datadog에서 이루어지는 단계와 AWS 계정 내에서 실행되는 단계를 보여줍니다." style="width:70%;" >}} + +### 규칙이 인스턴스와 일치하는 방식 선택 {#choose-how-your-rule-matches-instances} + +Datadog은 시간 경과에 따라 지속적으로 규칙을 다시 확인하므로, 작성한 쿼리에 따라 인프라 변경 시 적용 범위의 조정 방식이 결정됩니다. + +**표시되는 인스턴스를 포함하려면**, `env:prod`와 같이 인프라에 이미 존재하는 태그 및 속성을 일치시킵니다. 규칙을 저장한 후 시작되거나 태그가 다시 지정된 인스턴스를 비롯하여 일치하는 모든 인스턴스가 계측됩니다. 규칙을 업데이트하지 않고도 새로 일치하는 인스턴스를 자동으로 모니터링하려면 이 방법을 사용합니다. + +**고정된 세트를 포함하려면**, 리소스 목록에서 인스턴스를 개별적으로 선택합니다. 규칙과 일치하는 인스턴스는 선택한 항목으로 제한되므로, 나중에 표시되는 인스턴스는 추가되지 않습니다. + +**고정된 세트가 너무 커서 개별적으로 선택할 수 없다면**, `datadog:true`등 사용자가 제어하는 태그를 일치시킵니다. 해당 태그를 계측하려는 인스턴스에만 적용합니다. 태그를 변경할 때만 적용 범위가 변경되므로, 코드형 인프라에 따라 어떤 인스턴스를 포함할지 결정됩니다. + +
+적용 범위는 양방향으로 작동합니다. 인스턴스가 규칙과 더 이상 일치하지 않으면 Datadog이 해당 인스턴스에서 Agent를 제거합니다. 따라서 AWS에서 태그를 변경하면 Datadog에서 규칙을 수정하지 않아도 인스턴스에 대한 모니터링이 제거될 수 있습니다. +
+ +### 규칙 및 태그 관련 모범 사례 {#best-practices-for-rules-and-tags} + +**팀이 소유한 태그를 일치시킵니다.** 규칙이 다른 팀이 제어하는 태그와 일치하면 해당 팀은 Datadog을 열지 않은 상태에서 태그를 다시 지정하여 모니터링을 추가하거나 제거할 수 있습니다. 태그와 규칙의 소유자를 동일하게 유지할 경우 해당 결정을 내린 사람들이 계속 관리할 수 있습니다. + +**정상적인 운영 과정에서 변경되는 태그는 사용하지 마세요.** 환경 승격, 배포 또는 자동 스케일링 템플릿에 따라 변경되는 태그로 인해 인스턴스가 적용 범위에 속하거나 제외될 수 있습니다. 인스턴스 수명 동안 안정적으로 유지되는 속성을 기준으로 일치시킵니다. + +**규칙을 계정의 전체 구성으로 취급합니다.** 각 AWS 계정에는 리소스 유형당 하나의 규칙이 마련되어 있습니다. 수정할 때마다 기존 적용 범위에 추가하는 대신 해당 리소스 유형에 대해 모든 적용 범위를 다시 지정합니다. 저장하기 전에 일치하는 인스턴스를 검토하세요. + +**제외 설정을 통해 예외를 지정하세요.** 광범위한 규칙이 제외하려는 인스턴스를 포함하는 경우, 개별 선택 목록으로 전환하는 대신 동일한 규칙에서 해당 인스턴스를 제외합니다. 제외 설정을 사용하면 규칙의 가독성을 유지하고 다른 모든 항목에 대한 자동 적용 범위를 보존할 수 있습니다. + +## Agent 설치 {#install-the-agent} + +계측 대상 인스턴스에 대한 제어 수준에 따라 두 가지 진입점에서 Agent 설치를 시작할 수 있습니다. + +- **AWS 통합 설정(모든 적격 인스턴스에 설치)**: [AWS 통합 설정][5] 진행 시 로그 및 리소스 수집과 함께 표시되는 [AWS 통합 페이지][7]에서 Agent 설치 토글을 활성화합니다. Agent는 모든 적격 EC2 인스턴스에 설치됩니다. +- **Fleet Automation(특정 인스턴스에 설치)**: 언제든지 [AWS Agent 설치 페이지][8]를 열어 원하는 특정 EC2 인스턴스를 선택합니다. + + + +설정 과정에서 Agent 설치 토글이 나타납니다. + +{{< img src="integrations/amazon_web_services/aws-agent-installation-setup-toggle.png" alt="AWS 설정의 Datadog Agent 설치 단계로, 설치 토글이 활성화되어 있고 호스트 (EC2) 워크로드 토글이 켜진 상태입니다." style="width:80%;" >}} + +AWS Agent 설치 페이지에서 설치하기 + +1. 모든 적격 인스턴스에 대해 옵트인하거나 리소스 목록에서 특정 EC2 인스턴스를 선택합니다. +1. 생성된 CloudFormation 스택을 검토한 다음 AWS로 이동하여 생성합니다. Datadog은 이 작업을 한 번만 요청합니다. +1. Datadog으로 돌아갑니다. 설치가 자동으로 진행되며, Agent가 온라인 상태가 되면 Datadog이 진행 상황을 보고합니다. + + + +## 설치 확인 {#verify-the-installation} + +설치를 완료한 후에는 + +- 새로 설치된 Agent가 [인프라 목록][3] 및 호스트 맵에 표시됩니다. +- Fleet Automation은 Fleet View에 동일한 Agent를 나열합니다. + + + +## 설치된 Agent 관리 {#manage-installed-agents} + +Fleet Automation의 [AWS Agent 설치 페이지][8]에서 AWS 통합을 통해 설치한 Agent를 관리합니다. + +이 페이지에서 다음을 수행할 수 있습니다. + +- 설치된 Agent와 Agent 상태를 확인합니다. +- AWS 환경의 새 인스턴스에 Agent를 설치합니다. +- 모니터링을 중단하려는 인스턴스에서 Agent를 제거합니다. + +적용 대상에서 제외하려면 인스턴스가 더 이상 규칙과 일치하지 않도록 규칙을 업데이트합니다. 적용 대상 인스턴스에서 Agent를 수동으로 제거하면 Datadog이 다시 설치합니다. [Fleet Automation][4]을 통해 Agent 구성 및 버전 업그레이드를 관리합니다. + +## 문제 해결 {#troubleshooting} + +### EC2 인스턴스에 SSM Agent가 존재하지 않습니다 {#the-ssm-agent-is-not-present-on-an-ec2-instance} + +EC2에 Agent를 설치하려면 AWS Systems Manager(SSM) Agent가 필요하며, Datadog에서 이를 대신 설치할 수 없습니다. Datadog은 사용자 지정 AMI로 빌드된 인스턴스를 포함하여 SSM Agent가 없는 모든 인스턴스를 '부적격'으로 표시합니다. SSM Agent를 인스턴스에 설치한 후 다시 시도하세요. AWS 설명서의 [Working with SSM Agent][2]를 참조하세요. + +### 권한 또는 IAM 오류 발생 {#a-permission-or-iam-error-occurs} + +권한이 없어 설치를 완료할 수 없는 경우, Datadog은 새로운 권한이 필요한 CloudFormation 리소스로 연결되는 알림을 표시합니다. 기존 스택을 업데이트하여 [필수 권한](#required-aws-permissions)을 부여합니다. 스택을 새로 생성할 필요는 없습니다. + +## 추가 자료 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://docs.datadoghq.com/ko/integrations/amazon_web_services/ +[2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent.html +[3]: https://app.datadoghq.com/infrastructure +[4]: https://docs.datadoghq.com/ko/agent/fleet_automation/ +[5]: https://docs.datadoghq.com/ko/getting_started/integrations/aws/ +[6]: https://docs.datadoghq.com/ko/integrations/guide/aws-agent-installation-technical-reference/ +[7]: https://app.datadoghq.com/integrations/amazon-web-services +[8]: https://app.datadoghq.com/fleet/install-agent/latest?platform=aws \ No newline at end of file diff --git a/hugo/content/ko/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md b/hugo/content/ko/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md index 17bfb827612..0aa05926f8b 100644 --- a/hugo/content/ko/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md +++ b/hugo/content/ko/llm_observability/investigate/evaluations/llm_as_a_judge_evaluations/_index.md @@ -38,7 +38,7 @@ title: 사용자 지정 LLM-as-a-Judge 평가 Agent Observability의 [평가 페이지][1]에서 사용자 지정 평가를 생성하고 관리할 수 있습니다. 평가 설명을 제공하여 평가를 생성하거나, 당사에서 제공하는 기존 [LLM-as-a-judge 평가 템플릿][7]을 사용 및 확장하거나, 처음부터 직접 만들 수도 있습니다. 트레이싱을 활성화하여 평가에서 트레이스를 확인할 수 있습니다. -
SDK에 이미 LLMJudge 가 정의되어 있다면 UI에서 구성을 다시 만들지 않고 Datadog에 직접 게시할 수 있습니다. 자세한 내용은 Datadog 관리형 평가로서 LLMJudge 게시하기를 참조하십시오.
+
SDK에 이미 LLMJudge 가 정의되어 있다면 UI에서 구성을 다시 만들지 않고 Datadog에 직접 게시할 수 있습니다. LLMJudge를 Datadog 관리형 평가로 게시하기를 참조하세요.
[호환성 요구 사항][6]에 대해 자세히 알아보세요. @@ -102,7 +102,7 @@ Span Input: {{span_input}} 오른쪽 패널({{< ui >}}Filtered Spans{{< /ui >}}은 스팬 범위, {{< ui >}}Filtered Traces{{< /ui >}}는 트레이스 범위, {{< ui >}}Filtered Sessions{{< /ui >}}은 세션 범위)을 사용하여 스팬 데이터를 변수로 추가할 수도 있습니다. 1. 스팬, 트레이스 또는 세션이 오른쪽에 표시되도록 계정과 애플리케이션을 선택하세요. 2. 오른쪽에 있는 스팬 중 하나를 선택하여 해당 JSON을 확인하세요. - 3. 사용자 프롬프트에 JSON을 추가하려면 {{< ui >}}+{{< /ui >}}를 선택하세요. + 3. 사용자 프롬프트에 JSON을 추가하려면 {{< ui >}}\+{{< /ui >}}를 선택하세요. {{< img src="llm_observability/evaluations/custom_llm_judge_2-5.png" alt="사용자 지정 평가 구성 오른쪽 창에 있는 JSON 뷰의 메뉴 콘텐츠로, '메시지에 변수 추가' 옵션이 표시되어 있습니다." style="width:40%;" >}} diff --git a/hugo/content/ko/logs/explorer/findings.md b/hugo/content/ko/logs/explorer/findings.md new file mode 100644 index 00000000000..15dbe9927f2 --- /dev/null +++ b/hugo/content/ko/logs/explorer/findings.md @@ -0,0 +1,123 @@ +--- +description: Log Explorer에서 로그 조사를 수행하는 동안 중요한 컨텍스트를 캡처, 정리, 재사용하세요. +further_reading: +- link: logs/explorer/ + tag: 설명서 + text: Log Explorer에서 로그 검색 및 분석 +- link: logs/explorer/saved_views/ + tag: 설명서 + text: Log Explorer 자동 구성 +- link: bits_ai/bits_chat/ + tag: 설명서 + text: Bits AI 채팅으로 데이터에 대해 질문하기 +- link: notebooks/ + tag: 설명서 + text: Notebooks를 사용하여 조사 보고서 작성 및 공유 +private: false +title: 로그 발견 사항 +--- +## 개요 {#overview} + +발견 사항은 [로그 탐색기][1]에서 조사를 수행하는 동안 중요한 컨텍스트를 캡처, 정리, 재사용하는 데 도움이 됩니다. + +발견 사항을 사용하여 증거를 수집하고, 결과를 비교하고, 조사가 진행됨에 따라 컨텍스트를 구축합니다. 발견 사항을 체크포인트로 저장하여 유용한 쿼리와 로그로 다시 돌아갑니다. 발견 사항을 정렬해 조사 경로를 시각화하고 기억해 두고, 발견 사항에 메모를 추가하여 관찰한 내용을 기록합니다. 또한 발견 사항을 컨텍스트로 활용하여 [Bits에 질문][2]하거나 [Notebook][3]에 추가하여 다른 사람들과 공유할 보고서를 작성할 수 있습니다. + +**발견 사항 추가** 버튼 또는 **Cmd**/**Ctrl** + **S** 키보드 단축키를 사용하여 로그 라인, 시각화, 쿼리를 발견 사항으로 저장합니다. **더블 클릭**하거나 **로그 탐색기에서 열기** 기능을 사용하여 발견 사항으로 돌아갑니다. 이전 관찰 내용이나 조사 경로를 놓치지 않고 새로운 질문으로 넘어가세요. + +{{< img src="logs/explorer/findings_demo-2.mp4" alt="로그 탐색기의 발견 사항 데모" video=true style="width:100%;" >}} + +## 발견 사항 패널 {#findings-panel} + +발견 사항은 로그 탐색기 왼쪽의 측면 패널에 표시됩니다. 페이지 열기 + +1. [로그 탐색기][1]로 이동합니다. +2. 왼쪽 상단의 **발견 사항** 탭을 클릭합니다. + +발견 사항 패널에서 발견 사항을 정리하고, 로그 탐색기에서 다시 열고, 다른 위치로 보낼 사항을 선택할 수 있습니다. 이 패널은 발견 사항을 삭제할 때까지 페이지를 새로 고침하거나 브라우저 세션을 다시 시작해도 발견 사항과 해당 레이아웃을 유지합니다. + +## 발견 사항 캡처{#capture-a-finding} + +로그 탐색기의 어떤 위치에서든 **Cmd**/**Ctrl** + **S**를 눌러 발견 사항을 추가할 수 있습니다. 이렇게 하면 쿼리, 돌아가려는 페이지, 조회 중인 절대 시간 범위가 캡처됩니다. 기본 제목을 변경하려면 발견 사항 패널에 있는 발견 사항 카드의 오른쪽 상단 모서리의 {{< ui >}}Edit{{< /ui >}}을 클릭합니다. 또한 발견 사항 카드 하단에서 각 발견 사항에 메모를 추가할 수 있습니다. + +### 쿼리 및 시각화{#queries-and-visualizations} + +결과 위의 도구 모음에서 {{< ui >}}Add Finding{{< /ui >}} 버튼을 클릭하거나 **Cmd**/**Ctrl** + **S**를 누릅니다. 또한 발견 사항 패널에서 {{< ui >}}Add current page as a finding{{< /ui >}}를 클릭할 수 있습니다. + +**발견 사항 추가** 버튼은 모든 시각화 메뉴에서 같은 위치에 나타납니다. + +발견 사항 패널에는 검색 쿼리, 시간 범위, 구성한 그룹화 및 집계를 포함한 [시각화][4]가 저장됩니다. + +{{< img src="logs/explorer/findings/add_finding_timeseries_viz.png" alt="결과 도구 모음의 발견 사항 추가 버튼(키보드 단축키를 보여주는 툴팁)" style="width:80%;" >}} + +### 개별 로그 이벤트 {#individual-log-events} + +결과 페이지에서 로그 이벤트를 클릭하여 [로그 측면 패널][5]을 엽니다. **로그 메시지** 섹션 위에 마우스를 올리고 {{< ui >}}Add a finding{{< /ui >}} 버튼을 클릭하거나 **Cmd**/**Ctrl** + **S**를 누릅니다. 이렇게 하면 나중에 다시 확인할 수 있도록 전체 로그 이벤트 측면 패널이 캡처됩니다. + +로그 이벤트를 캡처하면 로그 측면 패널을 생성한 쿼리도 함께 캡처됩니다. 발견 사항으로 돌아오면 백그라운드에서 해당 쿼리와 함께 로그 측면 패널이 다시 열립니다. + +{{< img src="logs/explorer/findings/add_finding_log_message.png" alt="로그 측면 패널의 로그 메시지 섹션에 위치한 발견 사항 추가 버튼" style="width:80%;" >}} + +### 로그 메시지 또는 속성의 특정 텍스트{#specific-text-in-a-log-message-or-attributes} + +로그 메시지의 일부를 캡처하려면 **로그 메시지** 섹션에서 텍스트를 선택하고 **Cmd**/**Ctrl** + **S**를 누릅니다. 또한 선택한 텍스트와 함께 나타나는 컨텍스트 메뉴에서 {{< ui >}}Add Finding{{< /ui >}}을 선택할 수 있습니다. + +속성 값을 캡처하려면 텍스트를 선택하고 **Cmd**/**Ctrl** + **S**를 누릅니다. + +두 경우 모두 발견 사항에 선택한 텍스트가 저장됩니다. 발견 사항을 통해 로그 이벤트 측면 패널로 돌아갈 수 있습니다. + +## 발견 사항으로 돌아가기 {#return-to-a-finding} + +**발견 사항을 더블 클릭**하여 로그 탐색기에서 발견 사항으로 돌아가거나, 발견 사항 위에 마우스를 올리고 {{< ui >}}Open in Explorer{{< /ui >}}를 클릭합니다. 로그 탐색기는 발견 사항이 캡처될 때 사용된 쿼리, 시간 범위, 시각화를 다시 로드합니다. + +각 발견 사항은 쿼리와 절대 시간 범위를 유지합니다. 필요 시 로그 탐색기에서 검색 조건을 변경할 수 있습니다. 쿼리를 다시 작성할 필요 없이 이전 발견 사항으로 돌아갈 수 있습니다. + +## 발견 사항을 Bits AI 및 Notebooks로 전송 {#send-findings-to-bits-ai-and-notebooks} + +{{% site-region region="gov,gov2" %}} +
+Bits AI는 Datadog 사이트에서 사용할 수 없습니다({{< region-param key="dd_site_name" >}}). 발견 사항을 Notebook에 계속 추가할 수 있습니다. +
+{{% /site-region %}} + +하나 이상의 발견 사항을 선택하여 다음 작업을 함께 수행합니다. + +- 발견 사항에 대해 [Bits Chat][2]에 질문하려면 선택 막대에 질문을 입력하고 {{< ui >}}Ask Bits{{< /ui >}}를 클릭합니다. 또한 발견 사항을 선택한 후 발견 사항 패널 하단의 메뉴에서 {{< ui >}}Ask Bits{{< /ui >}}를 클릭할 수 있습니다. 선택한 발견 사항이 컨텍스트로 첨부된 상태로 Bits Chat이 열립니다. +- 발견 사항을 [Notebook][3]에 추가하려면 {{< ui >}}Open in Notebooks{{< /ui >}}를 클릭합니다. 새 노트북 또는 기존 노트북을 선택합니다. + +질문과 관련이 있는 발견 사항만 전송합니다. 예를 들어, 패널의 발견 사항 8개 중 3개가 질문하려는 오류와 관련이 있다면 해당하는 발견 사항 3개를 선택합니다. 발견 사항에 대한 메모도 함께 전송됩니다. + +## 발견 사항 정리 {#organize-your-findings} + +발견 사항을 드래그하여 이동하거나 크기를 조정합니다. Datadog은 사용자가 구성한 레이아웃을 저장하므로, 다음에 패널을 열 때 동일한 구성이 표시됩니다. + +구성을 재설정하려면 발견 사항을 쿼리별로 그룹화하는 자동 정리 옵션을 사용합니다. 동일한 쿼리로 다른 시각화를 생성하거나 해당 쿼리에서 특정 로그 라인을 저장한 경우, 해당 발견 사항이 함께 그룹화됩니다. 발견 사항 이동, 크기 조정, 삭제를 실행하면 배경의 시각적 그룹화 표시가 제거됩니다. + +## 발견 사항 삭제 {#delete-findings} + +발견 사항 하나를 삭제하려면 해당 항목 위에 마우스를 올리고 카드 오른쪽 상단 모서리의 삭제 버튼을 클릭합니다. 또한 발견 사항을 선택하고 **삭제** 키를 누를 수 있습니다. 여러 개의 발견 사항을 한 번에 삭제하려면 해당 사항을 선택하고 **삭제**를 누릅니다. 모든 발견 사항을 선택하려면 **Cmd**/**Ctrl** + **A**를 누릅니다. + +발견 사항 패널의 모두 지우기 버튼을 누르면 모든 발견 사항이 삭제됩니다. + +삭제한 발견 사항을 복원하려면 나타나는 메시지에서 {{< ui >}}Undo{{< /ui >}}를 클릭하거나 **Cmd**/**Ctrl** + **Z**를 누릅니다. + +## 키보드 단축키 {#keyboard-shortcuts} + +| 작업 | 단축키 | +| ------ | -------- | +| 발견 사항 추가 | **Cmd**/**Ctrl** + **S** | +| 모든 발견 사항 선택 | **Cmd**/**Ctrl** + **A** | +| 선택한 발견 사항 삭제 | **Delete** | +| 실행 취소 | **Cmd**/**Ctrl** + **Z** | +| 다시 실행 | **Cmd**/**Ctrl** + **Shift** + **Z** | +| 이동 | **Space** + **drag** | +| 자동 정리(쿼리 기준) | **Cmd**/**Ctrl** + **O** | + +## 추가 자료 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /ko/logs/explorer/ +[2]: /ko/bits_ai/bits_chat/ +[3]: /ko/notebooks/ +[4]: /ko/logs/explorer/visualize/ +[5]: /ko/logs/explorer/side_panel/ \ No newline at end of file diff --git a/hugo/content/ko/logs/log_configuration/indexes.md b/hugo/content/ko/logs/log_configuration/indexes.md index 972e3f7bd44..0ab8b93a9d8 100644 --- a/hugo/content/ko/logs/log_configuration/indexes.md +++ b/hugo/content/ko/logs/log_configuration/indexes.md @@ -2,8 +2,11 @@ aliases: - /ko/logs/dynamic_volume_control - /ko/logs/indexes/ -description: Datadog로 인덱싱된 로그 볼륨 제어 +description: Datadog으로 인덱싱된 로그 볼륨 제어 further_reading: +- link: https://www.datadoghq.com/architecture/a-guide-to-log-management-indexing-strategies-with-datadog/ + tag: 아키텍처 센터 + text: Datadog을 사용한 Log Management 인덱싱 전략 가이드 - link: /logs/explorer/#visualize tag: 설명서 text: 로그 분석 실행하기 @@ -41,7 +44,7 @@ Log Explorer는 [여러 인덱스를 대상으로 한 쿼리][7]를 지원합니 ### 인덱스 추가 {#add-indexes} -“New Index” 버튼을 사용하여 새 인덱스를 생성합니다. 각 계정에 대해 만들 수 있는 인덱스의 최대 개수는 100개이며 기본적으로 100개로 설정되어 있습니다. +{{< ui >}}New Index{{< /ui >}} 버튼을 사용하여 새 인덱스를 생성합니다. 각 계정에서 생성할 수 있는 인덱스 수에는 상한이 있으며, 기본 상한은 100개입니다. {{< img src="logs/indexes/add-index.png" alt="인덱스 추가" style="width:70%;">}} @@ -53,7 +56,7 @@ Log Explorer는 [여러 인덱스를 대상으로 한 쿼리][7]를 지원합니 ### 인덱스 삭제 {#delete-indexes} -조직에서 인덱스를 삭제하려면 인덱스 액션 트레이에서 “Delete” 아이콘을 사용합니다. 이 기능은 `Logs delete data` 권한을 가진 사용자만 사용할 수 있습니다. +조직에서 인덱스를 삭제하려면 인덱스 액션 트레이에서 {{< ui >}}Delete{{< /ui >}} 아이콘을 사용합니다. 이 기능은 `Logs delete data` 권한을 가진 사용자만 사용할 수 있습니다. {{< img src="logs/indexes/delete-index.png" alt="인덱스 삭제" style="width:70%;">}} @@ -71,11 +74,11 @@ Log Explorer는 [여러 인덱스를 대상으로 한 쿼리][7]를 지원합니 {{< img src="logs/indexes/multi_index.png" alt="여러 인덱스" style="width:70%;">}} -**참고**: **로그는 필터와 일치하는 첫 번째 인덱스로 전달되고**, 사용 사례에 따라 인덱스 목록에서 드래그 앤 드롭을 사용하여 순서를 재배열 수 있습니다. +**참고**: **로그는 필터와 일치하는 첫 번째 인덱스로 전달**되며, 사용 사례에 맞게 인덱스 목록에서 드래그 앤 드롭하여 순서를 변경할 수 있습니다. ## 제외 필터 {#exclusion-filters} -기본적으로 로그 인덱스에는 제외 필터가 없습니다. 즉, 인덱스 필터와 일치하는 모든 로그 인덱스가 색인화됩니다. +기본적으로 로그 인덱스에는 제외 필터가 없습니다. 즉, 인덱스 필터와 일치하는 모든 로그가 인덱싱됩니다. 그러나 로그가 모두 똑같이 가치 있는 것은 아니므로 제외 필터는 색인에서 어떤 로그를 제거할지 제어합니다. 제외된 로그는 인덱스에서 삭제되지만 [Livetail][8]을 통해 계속 흐르며 [메트릭 생성][9] 및 [아카이브][10]에 사용될 수 있습니다. @@ -83,13 +86,13 @@ Log Explorer는 [여러 인덱스를 대상으로 한 쿼리][7]를 지원합니 1. [로그 인덱스][11]로 이동합니다. 2. 제외 필터를 추가하려는 인덱스를 펼칩니다. -3. **Add an Exclusion Filter**를 클릭합니다. +3. {{< ui >}}Add an Exclusion Filter{{< /ui >}}를 클릭합니다. 제외 필터는 쿼리, 샘플링 규칙 및 활성/비활성 토글로 정의됩니다. * 기본 **쿼리**는 `*`입니다. 즉, 인덱스로 유입되는 모든 로그가 제외 대상이 됩니다. [로그 쿼리를 사용][12]하여 제외 필터의 범위를 특정 로그 집합으로 제한할 수 있습니다. * 기본 **샘플링 규칙**은 쿼리와 일치하는 `Exclude 100% of logs`입니다. 샘플링 비율을 0%에서 100%까지 조정하고 샘플링 비율을 개별 로그에 적용할지, 아니면 속성의 고유 값으로 정의된 로그 그룹에 적용할지 결정합니다. - * 샘플링 비율이 개별 로그에 적용되는 경우, 로그에 존재하는 트레이스 ID의 존재 여부에 따라 샘플링이 진행됩니다. 이 경우 샘플링된 로그는 샘플링된 트레이스와 연관될 가능성이 높아지므로, 통합 텔레메트리 데이터 유지에 도움이 됩니다.. + * 샘플링 비율이 개별 로그에 적용되는 경우, 로그에 존재하는 트레이스 ID의 존재 여부에 따라 샘플링이 진행됩니다. 이 경우 샘플링된 로그는 샘플링된 트레이스와 연관될 가능성이 높아지므로, 통합 텔레메트리 데이터 유지에 도움이 됩니다. * 트레이스 ID의 고유 값을 기준으로 샘플링하는 경우에도 동작 방식은 개별 로그 샘플링과 동일합니다. * 기본 **토글** 상태는 활성입니다. 즉, 인덱스로 유입되는 로그는 제외 필터 설정에 따라 실제로 삭제됩니다. 토글을 비활성으로 전환하면 새로 유입되는 로그에 대해 해당 제외 필터가 적용되지 않습니다. @@ -103,7 +106,7 @@ Log Explorer는 [여러 인덱스를 대상으로 한 쿼리][7]를 지원합니 #### 끄기, 켜기 {#switch-off-switch-on} -플랫폼에 인시던트가 발생하거나 애플리케이션의 중요 버전 배포를 중요한 버전 배포를 면밀히 관찰하고 싶을 때까지는 DEBUG 로그가 필요하지 않을 수 있습니다. `status:DEBUG`에서 100% 제외 필터를 설정하고 필요한 경우 Datadog UI 또는 [API][13]를 통해 켜고 끕니다. +플랫폼에 인시던트가 발생하거나 애플리케이션의 중요 버전 배포를 면밀히 관찰하고 싶을 때까지는 DEBUG 로그가 필요하지 않을 수 있습니다. `status:DEBUG`에서 100% 제외 필터를 설정하고 필요한 경우 Datadog UI 또는 [API][13]를 통해 켜고 끕니다. {{< img src="logs/indexes/enable_index_filters.png" alt="인덱스 필터 활성화" style="width:80%;">}} diff --git a/hugo/content/ko/mobile/_index.md b/hugo/content/ko/mobile/_index.md index 937ac69f59f..0c73b3eaa7f 100644 --- a/hugo/content/ko/mobile/_index.md +++ b/hugo/content/ko/mobile/_index.md @@ -56,17 +56,17 @@ SAML 로그인 시 기본 iOS/Android 브라우저를 사용하여 SAML 공급 ##### QR 코드 {#qr-code} -1. 브라우저에서 [Datadog 계정 개인 설정 조직][4] 페이지로 이동하고 현재 로그인한 조직의 **Log in to Mobile App**을 클릭합니다. QR 코드가 표시됩니다. +1. 브라우저에서 [Datadog 계정 개인 설정 조직][4] 페이지로 이동하고 현재 로그인한 조직의 {{< ui >}}Log in to Mobile App{{< /ui >}}을 클릭합니다. QR 코드가 표시됩니다. 2. 휴대폰 기본 카메라 앱을 사용해 QR 코드를 스캔한 다음, 연결되는 링크를 누르면 Datadog 앱이 실행됩니다. 자동으로 로그인됩니다. -**참고**: 현재 로그인하지 않은 조직의 **Log in to Mobile App** 버튼을 클릭하면 조직 UUID가 로그인 화면에 자동으로 삽입됩니다. 표준 방법을 사용하여 인증을 제공해야 합니다. +**참고**: 현재 로그인하지 않은 조직의 {{< ui >}}Log in to Mobile App{{< /ui >}} 버튼을 클릭하면 조직 UUID가 로그인 화면에 자동으로 삽입됩니다. 표준 방법을 사용하여 인증을 제공해야 합니다. ##### 수동 입력 {#manual-entry} -1. 수동으로 SAML ID를 입력하려면 Datadog 모바일 앱을 열고 'Using Single Sign-On (SAML)?' 버튼을 누릅니다. -2. 'Use another method to login' 버튼을 누르고 SAML ID를 직접 입력합니다. +1. 수동으로 SAML ID를 입력하려면 Datadog 모바일 앱을 열고 {{< ui >}}Using Single Sign-On (SAML)?{{< /ui >}} 버튼을 누릅니다. +2. {{< ui >}}Use another method to login{{< /ui >}} 버튼을 누르고 SAML ID를 수동으로 입력합니다. -로그인 시 **Authorize**를 클릭하면 사용 중인 모바일 기기가 계정에 연동됩니다. 보안을 위해 1개월에 한 번씩 이 절차를 진행해야 합니다. +로그인 시 {{< ui >}}Authorize{{< /ui >}}를 클릭하면 사용 중인 모바일 기기가 계정에 연동됩니다. 보안을 위해 한 달에 한 번씩 이 절차를 진행해야 합니다. ##### IdP 시작 SAML 로그인 {#saml-idp-initiated-login} @@ -79,28 +79,28 @@ SAML 로그인 시도 중에 계속 오류가 발생하는 경우, ID 제공자 ### 조직 전환 {#switch-organizations} -조직을 전환하려면 모바일 앱의 **Settings** 페이지로 이동하여 **Organization**을 클릭하세요. +조직을 전환하려면 Datadog 모바일 앱의 {{< ui >}}Settings{{< /ui >}} 페이지로 이동하여 {{< ui >}}Organization{{< /ui >}}을 클릭합니다. **참고**: 조직을 전환할 때 재인증이 필요할 수 있습니다. ### 로그아웃 {#log-out} -로그아웃하려면 모바일 앱의 **Settings** 페이지로 이동하여 **Log Out**을 클릭하세요. **Yes**를 클릭해 확인합니다. +로그아웃하려면 Datadog 모바일 앱의 {{< ui >}}Settings{{< /ui >}} 페이지로 이동하여 {{< ui >}}Log Out{{< /ui >}}을 클릭합니다. {{< ui >}}Yes{{< /ui >}}를 클릭해 확인합니다. ## On-Call {#on-call} {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/on_call_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="교대 근무, 일정 및 에스컬레이션 옵션을 보여주는 iOS on-call 페이지">}} +{{< img src="mobile/on_call_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="교대 근무, 일정 및 에스컬레이션 옵션을 보여주는 iOS on-call 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_On_Call.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="교대 근무, 일정 및 에스컬레이션 옵션을 보여주는 Android on-call 페이지">}} +{{< img src="mobile/Android_On_Call.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="교대 근무, 일정 및 에스컬레이션 옵션을 보여주는 Android on-call 페이지">}} {{% /tab %}} {{< /tabs >}} -On-Call 페이지는 온콜 교대 근무, 일정, 페이지 및 에스컬레이션 정책에 대한 포괄적인 뷰를 제공합니다. 사용자, 팀, 긴급성, 상태 또는 날짜별로 정보를 필터링하여 관련 세부정보를 빠르게 찾을 수 있습니다. **Escalate**를 누르면 다음 정책 수준으로의 에스컬레이션을 확인하라는 메시지가 표시됩니다. **Declare Incident**를 누르면 제목을 입력하고 관련 인시던트 특성을 제공하라는 메시지가 표시됩니다. +On-Call 페이지는 온콜 교대 근무, 일정, 페이지 및 에스컬레이션 정책에 대한 포괄적인 뷰를 제공합니다. 사용자, 팀, 긴급성, 상태 또는 날짜별로 정보를 필터링하여 관련 세부정보를 빠르게 찾을 수 있습니다. {{< ui >}}Escalate{{< /ui >}}를 누르면 다음 정책 수준으로의 에스컬레이션을 확인하라는 메시지가 표시됩니다. {{< ui >}}Declare Incident{{< /ui >}}를 누르면 제목을 입력하고 관련 인시던트 특성을 제공하라는 메시지가 표시됩니다. 개인 또는 팀에 페이지를 시작할 수 있으며, 재정의하려는 교대 근무를 눌러 기존 교대 근무를 덮어쓸 수 있습니다. Bits Investigation 모니터링 조사를 통해 초기 발견 및 결론을 확인할 수 있습니다. 자세한 내용은 [Datadog On-Call][20]을 참조하세요. @@ -115,34 +115,34 @@ On-Call 페이지는 온콜 교대 근무, 일정, 페이지 및 에스컬레이 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/incident_may_2025.png" alt="Datadog On-call 모바일 앱의 Incidents 페이지" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} +{{< img src="mobile/incident_may_2025.png" alt="Datadog On-call 모바일 앱의 Incidents 페이지" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_Incident.png" alt="Datadog On-call 모바일 앱의 Incidents 페이지" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} +{{< img src="mobile/Android_Incident.png" alt="Datadog On-call 모바일 앱의 Incidents 페이지" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} {{% /tab %}} {{< /tabs >}} -Incidents 페이지에서는 Datadog 계정에서 액세스할 수 있는 모든 인시던트를 보고, 검색하고, 필터링하여 어디서나 응답 및 해결을 보장할 수 있습니다. 또한 Slack, Zoom 등과의 통합을 통해 인시던트를 선언 및 편집하고, 팀과 원활하게 소통할 수 있습니다. 인시던트에 대한 자세한 내용은 [Datadog 인시던트 관리][12]를 참조하세요. +Incidents 페이지에서는 Datadog 계정에서 액세스할 수 있는 모든 인시던트를 보고, 검색하고, 필터링하여 어디서나 응답 및 해결을 보장할 수 있습니다. 또한 Slack, Zoom 등과의 통합을 통해 인시던트를 선언 및 편집하고, 팀과 원활하게 소통할 수 있습니다. 인시던트에 대한 자세한 내용은 [Datadog Incident Management][12]를 참조하세요. ### 인시던트 생성 {#create-an-incident} -1. 하단 바에 있는 Incidents 탭을 눌러 인시던트 목록으로 이동합니다. -2. 오른쪽 상단 모서리의 **+** 버튼을 누릅니다. -3. 인시던트의 제목, 심각도 및 커맨더를 지정합니다. +1. 하단 바에 있는 {{< ui >}}Incidents{{< /ui >}} 탭을 눌러 인시던트 목록으로 이동합니다. +2. 오른쪽 상단 모서리의 {{< ui >}}\+{{< /ui >}} 버튼을 누릅니다. +3. 인시던트의 제목, 중요도, 커맨더를 설정합니다. ## Notification Center {#notification-center} {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/ios_notification_center.png" alt="Datadog 모바일 앱의 ios Notification center" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} +{{< img src="mobile/ios_notification_center.png" alt="iOS용 Datadog 모바일 앱의 Notification Center" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/android_notification_center.png" alt="Datadog 모바일 앱의 Android Notification center" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} +{{< img src="mobile/android_notification_center.png" alt="Android용 Datadog 모바일 앱의 Notification Center" responsive="true" style="width:100%; background:none; border:none; box-shadow:none;">}} {{% /tab %}} {{< /tabs >}} @@ -154,19 +154,19 @@ Notification Center는 수신된 모든 푸시 알림을 나열하여 알림의 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/dashboard_may_2025_v2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 대시보드 목록을 보여주는 iOS 대시보드 페이지">}} +{{< img src="mobile/dashboard_may_2025_v2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 대시보드 목록을 보여주는 iOS 대시보드 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_Dashboards.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 대시보드 목록을 보여주는 Android 대시보드 페이지">}} +{{< img src="mobile/Android_Dashboards.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 대시보드 목록을 보여주는 Android 대시보드 페이지">}} {{% /tab %}} {{< /tabs >}} -Dashboards 페이지에서는 Datadog 조직에서 액세스할 수 있는 모든 대시보드를 보고 검색할 수 있으며, Datadog 웹 앱에서 설정한 동일한 템플릿 변수를 사용하여 필터링할 수 있습니다. 템플릿 변수 저장된 뷰를 사용하여 여러 대시보드를 빠르게 필터링합니다. 템플릿 변수 저장된 뷰에 대한 자세한 내용은 [대시보드 저장된 뷰][9]를 참조하세요. 개별 대시보드를 클릭하여 확인합니다. 대시보드 범위를 사용자 정의하려면 오른쪽 하단의 시간 범위를 클릭하세요. +Dashboards 페이지에서는 Datadog 조직에서 액세스할 수 있는 모든 대시보드를 보고 검색할 수 있으며, Datadog 웹 앱에서 설정한 동일한 템플릿 변수를 사용하여 필터링할 수 있습니다. 템플릿 변수 저장된 뷰를 사용하여 여러 대시보드를 빠르게 필터링합니다. 템플릿 변수 저장된 뷰에 대한 자세한 내용은 [Dashboard Saved Views][9]를 참조하세요. 개별 대시보드를 클릭하여 확인합니다. 대시보드 범위를 사용자 정의하려면 오른쪽 하단의 시간 범위를 클릭하세요. -**참고**: +**참고**: - 대시보드를 설정하거나 편집하려면 [Datadog 브라우저 앱에 로그인][10]해야 합니다. 자세한 내용은 [대시보드][11]를 참조하세요. - UTC로 구성된 대시보드 링크는 모바일 앱에서 UTC로 열립니다. 자세한 내용은 [대시보드 구성][24]을 참조하세요. - 모든 위젯 유형을 이용할 수 있는 것은 아니므로 모바일 앱에서 데이터가 표시되지 않습니다. 여기에는 토폴로지 맵, 목록 위젯(모든 데이터 소스), 레거시 트리맵 위젯 및 SLO 요약 위젯이 포함됩니다. @@ -176,12 +176,12 @@ Dashboards 페이지에서는 Datadog 조직에서 액세스할 수 있는 모 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/monitor_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 모니터링 목록을 보여주는 iOS monitors 페이지">}} +{{< img src="mobile/monitor_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 모니터링 목록을 보여주는 iOS monitors 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_Monitors.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 모니터링 목록을 보여주는 Android monitors 페이지">}} +{{< img src="mobile/Android_Monitors.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 모니터링 목록을 보여주는 Android monitors 페이지">}} {{% /tab %}} {{< /tabs >}} @@ -197,12 +197,12 @@ Monitors 페이지에서는 소속 Datadog 조직 내에서 액세스 가능한 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/notebook_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터핑 옵션과 함께 Notebooks 목록을 보여주는 iOS notebooks 페이지">}} +{{< img src="mobile/notebook_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터핑 옵션과 함께 노트북 목록을 보여주는 iOS 노트북 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_Notebooks.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터핑 옵션과 함께 Notebooks 목록을 보여주는 Android notebooks 페이지">}} +{{< img src="mobile/Android_Notebooks.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터핑 옵션과 함께 노트북 목록을 보여주는 Android 노트북 페이지">}} {{% /tab %}} {{< /tabs >}} @@ -216,12 +216,12 @@ Notebooks 페이지에서는 Datadog 조직에서 접근할 수 있는 모든 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/trace_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 트레이스 목록을 보여주는 iOS traces 페이지">}} +{{< img src="mobile/trace_may_2025.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 트레이스 목록을 보여주는 iOS traces 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_Traces.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 트레이스 목록을 보여주는 Android traces 페이지">}} +{{< img src="mobile/Android_Traces.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 트레이스 목록을 보여주는 Android traces 페이지">}} {{% /tab %}} {{< /tabs >}} @@ -238,12 +238,12 @@ Traces 페이지에서는 소속 Datadog 조직 내에서 액세스 가능한 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/iOS_logs_v2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 로그 목록을 보여주는 iOS logs 페이지">}} +{{< img src="mobile/iOS_logs_v2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 로그 목록을 보여주는 iOS Logs 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_Logs.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 로그 목록을 보여주는 Android logs 페이지">}} +{{< img src="mobile/Android_Logs.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 로그 목록을 보여주는 Android Logs 페이지">}} {{% /tab %}} {{< /tabs >}} @@ -262,12 +262,12 @@ Logs 페이지에서는 Datadog 조직에서 액세스할 수 있는 모든 로 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/service_may_2025_v2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 서비스 목록을 보여주는 iOS services 페이지">}} +{{< img src="mobile/service_may_2025_v2.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 서비스 목록을 보여주는 iOS services 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/Android_Services.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 서비스 목록을 보여주는 Android services 페이지">}} +{{< img src="mobile/Android_Services.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="검색 및 필터 옵션과 함께 서비스 목록을 보여주는 Android services 페이지">}} {{% /tab %}} {{< /tabs >}} @@ -279,28 +279,28 @@ Services 페이지에서는 Datadog 모바일 앱을 통해 Datadog 계정에서 {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/ios_bits_chat.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="사용자가 서비스에 대해 질문하는 ios에서의 Bits AI 챗봇 인터페이스">}} +{{< img src="/mobile/bits_chat_ios_2026.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="서비스에 대한 사용자 쿼리가 포함된 iOS Datadog 모바일 앱의 Bits AI 채팅 페이지">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/android_bits_chat.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="사용자가 서비스에 대해 질문하는 Android에서의 Bits AI 챗봇 인터페이스">}} +{{< img src="mobile/bits_chat_android_2026.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="서비스에 대한 사용자 쿼리가 포함된 Android Datadog 모바일 앱의 Bits AI 채팅 페이지">}} {{% /tab %}} {{< /tabs >}} -Bits AI 홈페이지에서 조직의 시스템 상태에 대한 질문을 할 수 있습니다. Bits AI는 로그 및 APM 트레이스에 대한 자연어 쿼리를 지원합니다. 자세한 내용은 [Bits 채팅][27]을 참조하세요. +Bits AI 홈페이지에서 시스템 또는 활성 인시던트에 대한 질문을 할 수 있습니다. Bits Chat 페이지는 Datadog 공개 설명서, 텔레메트리, 소유권에 대한 컨텍스트를 제시합니다. 자세한 내용은 [Bits Chat][27]을 참조하세요. ### Bits Investigation {#bits-investigation} {{< tabs >}} {{% tab "iOS" %}} -{{< img src="service_management/mobile/ios_bits_sre.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="On-Call 페이지에 표시된 Bits Investigation 결과">}} +{{< img src="mobile/ios_bits_sre.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="On-Call 페이지에 표시된 Bits Investigation 결과">}} {{% /tab %}} {{% tab "Android" %}} -{{< img src="service_management/mobile/android_bits_sre.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="On-Call 페이지에 표시된 Bits Investigation 결과">}} +{{< img src="mobile/android_bits_sre.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="On-Call 페이지에 표시된 Bits Investigation 결과">}} {{% /tab %}} {{< /tabs >}} @@ -309,7 +309,7 @@ Bits AI 홈페이지에서 조직의 시스템 상태에 대한 질문을 할 ## 자주 묻는 질문 {#frequently-asked-question} ### 모바일 앱에서 계속 로그인 상태를 유지하려면 어떻게 해야 하나요? {#how-do-i-remain-logged-into-the-mobile-app} -모바일 앱에서 성공적으로 인증을 마치면 90일 동안 로그인 상태를 유지합니다. +모바일 앱에서 성공적으로 인증을 마치면 90일 동안 로그인 상태를 유지합니다. **참고**: 알림이 활성화된 경우, 토큰 만료 10일 전에 사전 알림이 전송됩니다. @@ -319,10 +319,10 @@ Bits AI 홈페이지에서 조직의 시스템 상태에 대한 질문을 할 **참고**: 앱에서 수동으로 로그아웃하면 알림 수신이 중단됩니다. ### 왜 알림을 받지 못하나요? {#why-am-i-not-receiving-notifications} -기기 앱 설정에서 Datadog 앱에 대한 알림이 활성화되어 있는지 확인하세요. 알림이 방해 금지 모드를 우회하도록 하려면, 중요 알림이 켜져 있는지 확인하세요. +기기 앱 설정에서 Datadog 앱에 대한 알림이 활성화되어 있는지 확인하세요. 알림이 Do Not Disturb 모드를 우회하도록 하려면, Critical Alerts가 켜져 있는지 확인하세요. ### 내가 로그인한 모든 조직에 대해 알림을 받을 수 있나요? {#will-i-receive-notifications-for-all-organizations-that-i-am-signed-into} -네, 전환하는 조직에 관계없이 로그인한 모든 조직에 대한 알림을 받습니다. 여기에는 중요한 푸시 알림이 포함됩니다. +네, 전환하는 조직에 관계없이 로그인한 모든 조직에 대한 알림을 받습니다. 여기에는 중요한 푸시 알림이 포함됩니다. ### 사용자가 비활성화되면 어떻게 되나요? {#what-happens-if-a-user-is-disabled} 모바일 앱 토큰이 무효화되어 사용자가 로그아웃됩니다. @@ -362,6 +362,6 @@ Bits AI 홈페이지에서 조직의 시스템 상태에 대한 질문을 할 [24]: /ko/dashboards/configure/#configuration-actions [25]: /ko/logs/explorer/watchdog_insights/ [26]: /ko/watchdog/insights/?tab=logmanagement -[27]: /ko/bits_ai/bits_assistant/ -[28]: /ko/bits_ai/bits_ai_sre/ +[27]: /ko/bits_ai/bits_chat/ +[28]: /ko/bits_ai/bits_investigation/ [29]: /ko/account_management/multi_organization/#custom-sub-domains \ No newline at end of file diff --git a/hugo/content/ko/monitors/configuration/_index.md b/hugo/content/ko/monitors/configuration/_index.md index c8f6772ed8c..a6c93171b35 100644 --- a/hugo/content/ko/monitors/configuration/_index.md +++ b/hugo/content/ko/monitors/configuration/_index.md @@ -1,11 +1,11 @@ --- aliases: - /ko/monitors/create/configuration -description: 모니터 생성 페이지에 대해 설명합니다. +description: Datadog의 모니터 생성 페이지를 통해 모니터를 구성하고 사용자 지정하는 방법을 알아보세요. further_reading: - link: /monitors/notify/ tag: 설명서 - text: 모니터 알림 + text: 모니터링 알림 - link: /monitors/manage/ tag: 설명서 text: 모니터 관리 @@ -17,17 +17,17 @@ further_reading: text: Datadog Teams를 사용하여 모니터를 더욱 효율적으로 관리하기 - link: https://learn.datadoghq.com/courses/alert-monitor-notifications tag: 학습 센터 - text: 경보 사용자 지정 모니터 알림 + text: 경보 모니터링 알림 사용자 지정하기 title: 모니터 구성 --- ## 개요 {#overview} 모니터 구성을 시작하려면 다음 단계를 완료하세요. -* **검색 쿼리 정의:** 이벤트 수를 집계하고, 메트릭을 측정하고, 하나 이상의 차원을 기준으로 그룹화하는 등의 작업을 수행할 수 있도록 쿼리를 작성합니다. -* **경보 조건 설정:** 경보 및 경고 임계값, 평가 시간 범위를 정의하고 고급 경보 옵션을 구성합니다. -* **알림 및 자동화 구성:** 변수를 사용하여 사용자 지정 알림 제목과 메시지를 작성합니다. 알림을 팀에 전송하는 방법(이메일, Slack 또는 PagerDuty)을 선택합니다. 경보 알림에 워크플로 자동화 또는 케이스를 포함합니다. -* **권한 및 감사 알림 정의:** 세분화된 액세스 제어를 구성하고 모니터를 편집할 수 있는 특정 역할 및 사용자를 지정합니다. 모니터가 수정될 경우 알림을 받을 수 있도록 감사 알림을 활성화합니다. +* {{< ui >}}Define the search query{{< /ui >}}: 이벤트 수를 집계하고, 메트릭을 측정하고, 하나 이상의 차원을 기준으로 그룹화하는 등의 작업을 수행할 수 있도록 쿼리를 작성합니다. +* {{< ui >}}Set alert conditions{{< /ui >}}: 경보 및 경고 임계값, 평가 시간 범위를 정의하고 고급 경보 옵션을 구성합니다. +* {{< ui >}}Configure notifications and automations{{< /ui >}}: 변수를 사용하여 사용자 지정 알림 제목과 메시지를 작성합니다. 알림을 팀에 전송하는 방법(이메일, Slack 또는 PagerDuty)을 선택합니다. 경보 알림에 워크플로 자동화 또는 케이스를 포함합니다. +* {{< ui >}}Define permissions and audit notifications{{< /ui >}}: 세분화된 액세스 제어를 구성하고 모니터를 편집할 수 있는 특정 역할 및 사용자를 지정합니다. 모니터가 수정될 경우 알림을 받을 수 있도록 감사 알림을 활성화합니다. ## 검색 쿼리 정의 {#define-the-search-query} @@ -42,13 +42,13 @@ title: 모니터 구성 {{< img src="/monitors/configuration/evaluated_data_preview_high_error_rate.png" alt="Evaluated Data 미리 보기 그래프" style="width:100%;" >}} -Evaluated Data 그래프는 현재 쿼리와 임계값을 기준으로 모니터가 데이터를 어떻게 평가했을지를 보여줍니다. 평가 미리 보기를 사용하면 다음을 수행할 수 있습니다. +{{< ui >}}Evaluated Data{{< /ui >}} 그래프는 현재 쿼리와 임계값을 기준으로 모니터가 데이터를 어떻게 평가했을지를 보여줍니다. 평가 미리 보기를 사용하면 다음을 수행할 수 있습니다. - 과거 상태 전환 확인(예: `OK` → `ALERT`) - 모니터가 어떻게 동작했을지 이해 - 누가 알림을 받게 되는지 미리 확인(알림 규칙에 따른 대상 포함) - 저장하기 전에 구성 오류를 빠르게 발견 -이 기능은 Metrics, Logs, APM, RUM, Events, Audit, Database, LLM Observability 및 Deployment 모니터에서 지원됩니다. +이 기능은 Metrics, Logs, APM, RUM, Events, Audit, Database, Agent Observability 및 Deployment 모니터에서 지원됩니다. {{% /tab %}} @@ -56,13 +56,13 @@ Evaluated Data 그래프는 현재 쿼리와 임계값을 기준으로 모니터 {{< img src="/monitors/configuration/source_data_graph_high_error_rate.png" alt="Source Data 미리 보기 그래프" style="width:100%;" >}} -Source Data 그래프는 임계값 평가나 경보 로직을 적용하지 않은 상태에서 모니터의 원본 시계열 또는 쿼리 출력 결과를 표시합니다. 이를 통해 다음을 수행할 수 있습니다. +{{< ui >}}Source Data{{< /ui >}} 그래프는 임계값 평가나 경보 로직을 적용하지 않은 상태에서 모니터의 원본 시계열 또는 쿼리 출력 결과를 표시합니다. 이를 통해 다음을 수행할 수 있습니다. - 모니터가 평가하는 기본 데이터를 시각화. - 경보 상태 변경과 실제 데이터 추세 간의 상관관계 확인. - 경보 조건을 구성하기 전에 데이터의 이상, 누락 구간 또는 예상치 못한 패턴 식별. -소스 데이터 그래프를 사용하여 쿼리가 예상한 결과를 반환하는지 확인하고, 경보 임계값과 평가 윈도우를 보다 정확하게 조정할 수 있습니다. +{{< ui >}}Source Data{{< /ui >}} 그래프를 사용하여 쿼리가 예상한 결과를 반환하는지 확인하고, 경보 임계값과 평가 기간을 보다 정확하게 조정할 수 있습니다. {{% /tab %}} {{< /tabs >}} @@ -74,9 +74,9 @@ Source Data 그래프는 임계값 평가나 경보 로직을 적용하지 않 {{< tabs >}} {{% tab "임계값 알림" %}} -* 메트릭의 `average`, `max`, `min` 또는 `sum`이 -임계값과 비교하여 * `above`, `above or equal to`, `below` 또는 `below or equal to`이고 -* 지난 `5 minutes`, `15 minutes`, `1 hour` 또는 `custom`(1분~48시간 범위 설정 가능, 메트릭 모니터의 경우 1개월) 동안의 기간에 속한 경우 트리거합니다. +* 메트릭의 {{< ui >}}average{{< /ui >}}, {{< ui >}}max{{< /ui >}}, {{< ui >}}min{{< /ui >}} 또는 {{< ui >}}sum{{< /ui >}}이 +* {{< ui >}}above{{< /ui >}}, {{< ui >}}above or equal to{{< /ui >}}, {{< ui >}}below{{< /ui >}} 또는 {{< ui >}}below or equal to{{< /ui >}} 임계값과 비교하여 +* 지난 {{< ui >}}5 minutes{{< /ui >}}, {{< ui >}}15 minutes{{< /ui >}}, {{< ui >}}1 hour{{< /ui >}} 또는 {{< ui >}}custom{{< /ui >}}(1분~48시간 범위 설정 가능, 메트릭 모니터의 경우 1개월) 동안의 기간에 속한 경우 트리거합니다. ### 집계 방식 {#aggregation-method} @@ -84,12 +84,14 @@ Source Data 그래프는 임계값 평가나 경보 로직을 적용하지 않 | 옵션 | 설명 | |-------------------------|--------------------------------------------------------| -| average | 시계열의 값을 평균하여 단일 값을 생성한 후 임계값과 비교합니다. 모니터 쿼리에 `avg()` 함수를 추가합니다. | -| max | 생성된 시계열 내의 값 중 하나라도 임계값을 초과하면 경보가 트리거됩니다. 모니터 쿼리에 `max()` 함수를 추가합니다.* | -| min | 쿼리의 평가 윈도우 내 모든 데이터 포인트가 임계값을 초과하면 경보가 트리거됩니다. 모니터 쿼리에 `min()` 함수를 추가합니다.* | -| sum | 시계열의 모든 데이터 포인트 합계가 임계값을 초과하면 경보가 트리거됩니다. 모니터 쿼리에 `sum()` 함수를 추가합니다. | +| {{< ui >}}average{{< /ui >}} | 시계열의 값을 평균하여 단일 값을 생성한 후 임계값과 비교합니다. 모니터 쿼리에 `avg()` 함수를 추가합니다. | +| {{< ui >}}max{{< /ui >}} | 생성된 시계열 내의 값 중 하나라도 임계값을 초과하면 경보가 트리거됩니다. 모니터 쿼리에 `max()` 함수를 추가합니다.* | +| {{< ui >}}min{{< /ui >}} | 쿼리의 평가 기간 내 모든 데이터 포인트가 임계값을 초과하면 경보가 트리거됩니다. 모니터 쿼리에 `min()` 함수를 추가합니다.* | +| {{< ui >}}sum{{< /ui >}} | 시계열의 모든 데이터 포인트 합계가 임계값을 초과하면 경보가 트리거됩니다. 모니터 쿼리에 `sum()` 함수를 추가합니다. | -\* 위의 max 및 min 설명은 메트릭이 임계값을 _초과_할 때 경보가 발생하는 경우를 가정합니다. 메트릭이 임계값 _미만_일 때 경보가 발생하도록 설정된 모니터에서는 max와 min의 동작이 반대로 적용됩니다. 추가 예시는 [모니터 애그리게이터][1] 가이드를 참조하세요. +\* 위의 max 및 min 설명은 메트릭이 임계값을 _초과_할 때 경보가 발생하는 경우를 가정합니다. 메트릭이 임계값 _미만_일 때 경보가 발생하도록 설정된 모니터에서는 max와 min의 동작이 반대로 적용됩니다. + +
각 집계 방법의 작동 원리에 대한 자세한 내용과 예시는 모니터 집계 도구 가이드를 참조하세요.
**참고**: `as_count()`를 사용할 경우 동작 방식이 달라질 수 있습니다. 자세한 내용은 [모니터 평가의 as_count()][2]를 참조하세요. @@ -103,20 +105,20 @@ Source Data 그래프는 임계값 평가나 경보 로직을 적용하지 않 #### 롤링 시간 윈도우 {#rolling-time-windows} -롤링 시간 윈도우는 고정된 크기를 가지며 시간이 지남에 따라 시작 지점이 이동합니다. 모니터는 최근 `5 minutes`, `15 minutes`, `1 hour` 또는 최대 1개월까지의 사용자 지정 시간 윈도우를 기준으로 데이터를 조회할 수 있습니다. +롤링 시간 윈도우는 고정된 크기를 가지며 시간이 지남에 따라 시작 지점이 이동합니다. 모니터는 최근 {{< ui >}}5 minutes{{< /ui >}}, {{< ui >}}15 minutes{{< /ui >}}, {{< ui >}}1 hour{{< /ui >}} 또는 최대 1개월까지의 사용자 지정 시간 윈도우를 기준으로 데이터를 조회할 수 있습니다. **참고**: [로그 모니터][6]의 최대 롤링 시간 윈도우는 `2 days`입니다. #### 누적 시간 윈도우 {#cumulative-time-windows} 누적 시간 윈도우는 시작 시점이 고정되어 있으며 시간이 지남에 따라 범위가 확장됩니다. 모니터는 다음 세 가지 누적 시간 윈도우를 지원합니다. -- `Current hour`: 한 시간 중 구성 가능한 분에 시작하며, 최대 1시간 길이의 시간 윈도우입니다. 예를 들어 매시 정각(0)분에 시작하여 1시간 동안 HTTP 엔드포인트가 수신한 호출 수를 모니터링할 수 있습니다. -- `Current day`: 하루 중 구성 가능한 시간과 분에 시작하며, 최대 24시간 길이의 시간 윈도우입니다. 예를 들어 `current day` 시간 윈도우를 사용하고 시작 시간을 UTC 오후 2시로 설정하여 [일일 로그 인덱스 할당량][3]을 모니터링할 수 있습니다. -- `Current month`: 매월 지정된 날짜의 특정 시각과 분부터 시작하여 현재 월을 기준으로 데이터를 조회합니다. 이 옵션은 월 누계 시간 윈도우를 나타내며 메트릭 모니터에서만 사용할 수 있습니다. +- {{< ui >}}Current hour{{< /ui >}}: 한 시간 중 구성 가능한 분에 시작하며, 최대 1시간 길이의 시간 윈도우입니다. 예를 들어 매시 정각(0)분에 시작하여 1시간 동안 HTTP 엔드포인트가 수신한 호출 수를 모니터링할 수 있습니다. +- {{< ui >}}Current day{{< /ui >}}: 하루 중 구성 가능한 시간과 분에 시작하며, 최대 24시간 길이의 시간 윈도우입니다. 예를 들어 {{< ui >}}Current day{{< /ui >}} 시간 윈도우를 사용하고 시작 시간을 UTC 오후 2시로 설정하여 [일일 로그 인덱스 할당량][3]을 모니터링할 수 있습니다. +- {{< ui >}}Current month{{< /ui >}}: 매월 지정된 날짜의 특정 시각과 분부터 시작하여 현재 월을 기준으로 데이터를 조회합니다. 이 옵션은 월 누계 시간 윈도우를 나타내며 메트릭 모니터에서만 사용할 수 있습니다. {{< img src="/monitors/create/cumulative_window_example_more_options.png" alt="Datadog 인터페이스에서 누적 윈도우가 구성된 방법에 대한 스크린샷. 사용자는 aws.sqs.number_of_messages_received를 검색했습니다. 옵션은 CURRENT MONTH 동안 쿼리의 SUM을 평가하도록 설정되어 있습니다." style="width:100%;">}} -누적 시간 윈도우는 최대 기간에 도달하면 재설정됩니다. 예를 들어 `current month`를 기준으로 하는 누적 시간 윈도우는 매월 1일 UTC 자정에 재설정됩니다. 또한 30분에 시작하는 `current hour` 누적 시간 윈도우는 매시간 재설정됩니다. 예를 들어 오전 6시 30분, 오전 7시 30분, 오전 8시 30분에 재설정됩니다. +누적 시간 윈도우는 최대 기간에 도달하면 재설정됩니다. 예를 들어 {{< ui >}}Current month{{< /ui >}}를 기준으로 하는 누적 시간 윈도우는 매월 1일 UTC 자정에 재설정됩니다. 또한 30분에 시작하는 {{< ui >}}Current hour{{< /ui >}} 누적 시간 윈도우는 매시간 재설정됩니다. 예를 들어 오전 6시 30분, 오전 7시 30분, 오전 8시 30분에 재설정됩니다. ### 평가 빈도 {#evaluation-frequency} @@ -142,10 +144,10 @@ Datadog은 두 가지 유형의 알림(경보 및 경고)을 제공합니다. | 옵션 | 설명 | |------------------------------------------|--------------------------------| -| 경보 임계값 **(필수)** | 경보 알림을 트리거하는 데 사용되는 값입니다. | -| 경고 임계값 | 경고 알림을 트리거하는 데 사용되는 값입니다. | -| 경보 복구 임계값 | 경보 복구를 위한 추가 조건을 지정하는 선택적 임계값입니다. | -| 경고 복구 임계값 | 경고 복구를 위한 추가 조건을 지정하는 선택적 임계값입니다. | +| {{< ui >}}Alert threshold{{< /ui >}} (필수) | 경보 알림을 트리거하는 데 사용되는 값입니다. | +| {{< ui >}}Warning threshold{{< /ui >}} | 경고 알림을 트리거하는 데 사용되는 값입니다. | +| {{< ui >}}Alert recovery threshold{{< /ui >}} | 경보 복구를 위한 추가 조건을 지정하는 선택적 임계값입니다. | +| {{< ui >}}Warning recovery threshold{{< /ui >}} | 경고 복구를 위한 추가 조건을 지정하는 선택적 임계값입니다. | 임계값을 변경하면 편집기의 미리 보기 그래프에 기준 지점을 나타내는 마커가 표시됩니다. @@ -201,50 +203,56 @@ Datadog은 두 가지 유형의 알림(경보 및 경고)을 제공합니다. {{< img src="/monitors/create/on_missing_data.png" alt="데이터 없음 옵션" style="width:70%;">}} -- `Evaluate as zero` / `Show last known status` -- `Show NO DATA` -- `Show NO DATA and notify` -- `Show OK`. +- {{< ui >}}Evaluate as zero{{< /ui >}}/{{< ui >}}Show last known status{{< /ui >}} +- {{< ui >}}Show NO DATA{{< /ui >}} +- {{< ui >}}Show NO DATA and notify{{< /ui >}} +- {{< ui >}}Show OK{{< /ui >}}. -선택한 동작은 모니터의 쿼리가 어떠한 데이터도 반환하지 않을 때 적용됩니다. `Do not notify` 옵션과 달리, 데이터 누락 윈도우는 구성할 수 **없습니다** +선택한 동작은 모니터의 쿼리가 어떠한 데이터도 반환하지 않을 때 적용됩니다. {{< ui >}}Do not notify{{< /ui >}} 옵션과 달리, 데이터 누락 윈도우는 구성할 수 **없습니다** | 옵션 | 모니터 상태 및 알림 | |---------------------------|---------------------------------------------------------------------------| -| `Evaluate as zero` | 빈 결과를 0으로 대체한 후 경보/경고 임계값과 비교합니다. 예를 들어 경보 임계값이 `> 10`으로 설정된 경우, 값 0은 해당 조건을 충족하지 않으므로 모니터링 상태는 `OK`로 설정됩니다. | -| `Show last known status` | 그룹 또는 모니터의 마지막으로 알려진 상태가 설정됩니다. | -| `Show NO DATA` | 모니터 상태가 `NO DATA`로 설정됩니다. | -| `Show NO DATA and notify` | 모니터 상태가 `NO DATA`로 설정되며 알림이 전송됩니다. | -| `Show OK` | 모니터가 해결됨으로 처리되고 상태가 `OK`로 설정됩니다. | +| {{< ui >}}Evaluate as zero{{< /ui >}} | 빈 결과를 0으로 대체한 후 경보/경고 임계값과 비교합니다. 예를 들어 경보 임계값이 `> 10`으로 설정된 경우, 값 0은 해당 조건을 충족하지 않으므로 모니터링 상태는 `OK`로 설정됩니다. | +| {{< ui >}}Show last known status{{< /ui >}} | 그룹 또는 모니터의 마지막으로 알려진 상태가 설정됩니다. | +| {{< ui >}}Show NO DATA{{< /ui >}} | 모니터 상태가 `NO DATA`로 설정됩니다. | +| {{< ui >}}Show NO DATA and notify{{< /ui >}} | 모니터 상태가 `NO DATA`로 설정되며 알림이 전송됩니다. | +| {{< ui >}}Show OK{{< /ui >}} | 모니터가 해결됨으로 처리되고 상태가 `OK`로 설정됩니다. | -`Evaluate as zero` 및 `Show last known status` 옵션은 쿼리 유형에 따라 표시됩니다. +쿼리에서 default_zero()를 사용하면 데이터 누락 동작이 해당 쿼리 유형의 기본값으로 고정되며 다른 옵션은 비활성화 상태로 전환됩니다. -- **Evaluate as zero:** 이 옵션은 `default_zero()` 함수가 없는 `Count` 쿼리를 사용하는 모니터에서 사용할 수 있습니다. -- **Show last known status:** 이 옵션은 `Count`를 제외한 모든 쿼리 유형(예: `Gauge`, `Rate`, `Distribution`)과 `default_zero()`가 포함된 `Count` 쿼리에서 사용할 수 있습니다. +- `default_zero()`가 포함된 쿼리의 경우 데이터 누락은 항상 0으로 평가되며, 다른 데이터 누락 동작은 사용할 수 없습니다. +- `default_zero()`가 포함되지 않은 쿼리의 경우, `Count` 쿼리는 기본적으로 {{< ui >}}Evaluate as zero{{< /ui >}}로 설정되고 다른 쿼리 유형은 기본적으로 {{< ui >}}Show last known status{{< /ui >}}로 설정됩니다. 모든 데이터 누락 동작은 계속 사용할 수 있습니다. #### 자동 해결 {#auto-resolve} -`[Never]`, `After 1 hour`, `After 2 hours` 등의 상태를 트리거된 상태에서 자동으로 해결합니다. +{{< ui >}}[Never]{{< /ui >}}, {{< ui >}}After 1 hour{{< /ui >}}, {{< ui >}}After 2 hours{{< /ui >}} 등의 상태를 트리거된 상태에서 자동으로 해결합니다. 자동 해결은 데이터가 더 이상 제출되지 않을 때 작동합니다. 데이터가 계속 보고되는 경우 모니터는 ALERT 또는 WARN 상태에서 자동으로 해결되지 않습니다. 데이터가 계속 제출되는 경우에는 [다시 알리기][2] 기능을 사용하여 문제가 아직 해결되지 않았음을 팀에 알릴 수 있습니다. 주기적으로 보고되는 일부 메트릭의 경우, 트리거된 경보가 일정 시간이 지나면 자동으로 해결되도록 설정하는 것이 적절할 수 있습니다. 예를 들어 오류가 기록될 때만 값을 보고하는 카운터가 있다고 가정해 보겠습니다. 이 경우 메트릭은 오류 수가 `0`임을 보고하지 않으므로 경보가 영구적으로 해결되지 않습니다. 이러한 경우에는 메트릭에 일정 시간 동안 활동이 없으면 경보가 해결되도록 설정할 수 있습니다. **참고**: 모니터가 자동 해결된 후 다음 평가 시점에 쿼리 값이 복구 임계값을 충족하지 못하면 모니터는 다시 경보를 트리거합니다. -대부분의 경우 이 설정은 크게 유용하지 않습니다. 일반적으로는 실제로 문제가 해결된 경우에만 경보가 해제되기를 원하기 때문입니다. 따라서 일반적으로는 이 값을 `[Never]`로 유지하여 메트릭이 설정된 임계값 위 또는 아래로 이동했을 때만 경보가 해결되도록 하는 것이 적절합니다. +대부분의 경우 이 설정은 크게 유용하지 않습니다. 일반적으로는 실제로 문제가 해결된 경우에만 경보가 해제되기를 원하기 때문입니다. 따라서 일반적으로는 이 값을 {{< ui >}}[Never]{{< /ui >}}로 유지하여 메트릭이 설정된 임계값 위 또는 아래로 이동했을 때만 경보가 해결되도록 하는 것이 적절합니다. #### 그룹 보존 시간 {#group-retention-time} -데이터가 누락된 상태가 `N`시간 지속되면 해당 그룹을 모니터 상태에서 제거할 수 있습니다. 보존 시간은 최소 1시간에서 최대 72시간까지 설정할 수 있습니다. 다중 경보 모니터의 경우 **Remove the non-reporting group after `N (length of time)`**를 선택하세요. +그룹 보존은 데이터 보고가 중단된 후 특정 모니터 그룹을 모니터 상태에 얼마나 오래 유지할지를 제어합니다. 보존 기간이 지나면 해당 그룹은 만료되어 모니터 상태에서 제거됩니다. + +기본적으로 그룹은 상태를 24시간 동안 유지한 후 제거됩니다. 데이터 누락 시 알림을 전송하는 호스트 모니터 및 서비스 확인은 48시간 동안 상태를 유지합니다. + +사용자 지정 보존을 지원하는 다중 경보 모니터 유형의 경우 1시간~72시간 사이로 값을 설정할 수 있습니다. {{< ui >}}Remove the non-reporting group after N (length of time){{< /ui >}}을 선택합니다. {{< img src="/monitors/create/group_retention_time.png" alt="그룹 보존 시간 옵션" style="width:70%;">}} -[자동 해결 옵션][3]과 마찬가지로 그룹 보존 시간은 데이터가 더 이상 제출되지 않을 때 적용됩니다. 이 옵션은 데이터 보고가 중단된 후 해당 그룹을 모니터 상태에 얼마나 오래 유지할지를 제어합니다. 기본적으로 그룹은 상태를 24시간 동안 유지한 후 제거됩니다. 모니터 쿼리가 더 이상 데이터를 반환하지 않게 되는 시점부터 그룹 보존 시간과 자동 해결 옵션의 시작 시점은 **동일합니다**. +[자동 해결 옵션][3]과 마찬가지로 그룹 보존 시간은 데이터가 더 이상 제출되지 않을 때 적용됩니다. 모니터 쿼리가 더 이상 데이터를 반환하지 않게 되는 시점부터 그룹 보존 시간과 자동 해결 옵션의 시작 시점은 **동일합니다**. 그룹 보존 시간을 설정하는 대표적인 사용 사례는 다음과 같습니다. - 데이터 보고가 중단된 즉시 또는 짧은 시간 후에 그룹을 제거하려는 경우 - 일반적으로 문제 해결에 소요되는 기간만큼 그룹 상태를 유지하려는 경우 -**참고**: 그룹 보존 시간 옵션은 [`On missing data`][4] 옵션을 지원하는 다중 경보 모니터에서만 사용할 수 있습니다. 해당 모니터 유형에는 APM Trace Analytics, Audit Logs, CI Pipelines, Error Tracking, Events, Logs 및 RUM 모니터가 포함됩니다. +**참고**: 사용자 지정 그룹 보존 시간 옵션은 [`On missing data`][4] 옵션을 지원하는 다중 경보 모니터에서만 사용할 수 있습니다. 해당 모니터 유형에는 APM Trace Analytics, Audit Logs, CI Pipelines, Error Tracking, Events, Logs 및 RUM 모니터가 포함됩니다. + +
미리 보기: 동적 그룹 보존

동적 그룹 보존은 미리 보기로 제공되며 새로 생성된 모니터에 적용됩니다. 그룹 수가 많은 모니터의 경우, Datadog은 데이터 보고가 중단된 후 그룹 유지 기간을 자동으로 단축합니다. 그룹이 생성되고 사라지는 빈도가 높을수록 이 기간이 짧아지며, 이를 통해 모니터의 속도와 효율성이 유지됩니다. 이는 데이터 보고가 중단된 그룹에 한해서 영향을 미치며, 데이터 보고가 활발히 이루어지는 그룹은 제거되지 않습니다.

#### 새 그룹 지연 {#new-group-delay} @@ -282,30 +290,30 @@ Datadog은 두 가지 유형의 알림(경보 및 경고)을 제공합니다.
모니터 태그는 Agent 또는 통합에서 전송하는 태그와는 별개입니다. 자세한 내용은 모니터 관리 설명서를 참조하세요.
-1. **Tags** 드롭다운을 사용하여 모니터에 [태그][8]를 연결합니다. -1. **Teams** 드롭다운을 사용하여 모니터에 [Teams][9]를 연결합니다. -1. **Priority**를 선택합니다. +1. {{< ui >}}Tags{{< /ui >}} 드롭다운을 사용하여 모니터에 [태그][8]를 연결합니다. +1. {{< ui >}}Teams{{< /ui >}} 드롭다운을 사용하여 모니터에 [Teams][9]를 연결합니다. +1. {{< ui >}}Priority{{< /ui >}}를 선택합니다. ### 경보 집계 설정 {#set-alert-aggregation} -경보는 쿼리에서 선택한 집계 방식(예: `avg by service`)에 따라 자동으로 그룹화됩니다. 쿼리에 그룹화가 없는 경우 기본값은 `Simple Alert`입니다. 쿼리가 어떤 차원으로든 그룹화된 경우에는 그룹화가 `Multi Alert`으로 변경됩니다. +경보는 쿼리에서 선택한 집계 방식(예: `avg by service`)에 따라 자동으로 그룹화됩니다. 쿼리에 그룹화가 없는 경우 기본값은 {{< ui >}}Simple Alert{{< /ui >}}입니다. 쿼리가 어떤 차원으로든 그룹화된 경우에는 그룹화가 {{< ui >}}Multi Alert{{< /ui >}}으로 변경됩니다. -{{< img src="/monitors/create/notification-aggregation.png" alt="모니터 알림 집계 구성 옵션" style="width:100%;">}} +{{< img src="/monitors/create/notification-aggregation.png" alt="모니터링 알림 집계 구성 옵션" style="width:100%;">}} #### 단순 경고 {#simple-alert} -`Simple Alert` 모드는 모든 보고 소스를 집계하여 하나의 알림을 트리거합니다. 집계된 값이 설정된 조건을 충족하면 **하나의 경보**를 받게 됩니다. 예를 들어 모든 서버의 평균 CPU 사용량이 특정 임계값을 초과할 때 알림을 받도록 모니터를 설정할 수 있습니다. 이 경우 해당 임계값이 충족되면, 임계값을 초과한 개별 서버 수와 관계없이 하나의 알림만 수신합니다. 이는 시스템 전반의 추세나 동작을 모니터링하는 데 유용합니다. +{{< ui >}}Simple Alert{{< /ui >}} 모드는 모든 보고 소스를 집계하여 하나의 알림을 트리거합니다. 집계된 값이 설정된 조건을 충족하면 **하나의 경보**를 받게 됩니다. 예를 들어 모든 서버의 평균 CPU 사용량이 특정 임계값을 초과할 때 알림을 받도록 모니터를 설정할 수 있습니다. 이 경우 해당 임계값이 충족되면, 임계값을 초과한 개별 서버 수와 관계없이 하나의 알림만 수신합니다. 이는 시스템 전반의 추세나 동작을 모니터링하는 데 유용합니다. -{{< img src="/monitors/create/simple-alert.png" alt="단순 경고 모드에서 모니터 알림이 전송되는 방식을 보여주는 다이어그램" style="width:90%;">}} +{{< img src="/monitors/create/simple-alert.png" alt="단순 경고 모드에서 모니터링 알림이 전송되는 방식을 보여주는 다이어그램" style="width:90%;">}} #### 다중 경보 {#multi-alert} -`Multi Alert` 모니터는 경보 임계값을 충족하는 각 엔터티에 대해 개별 알림을 트리거합니다. +{{< ui >}}Multi Alert{{< /ui >}} 모니터는 경보 임계값을 충족하는 각 엔터티에 대해 개별 알림을 트리거합니다. -{{< img src="/monitors/create/multi-alert.png" alt="다중 경보 모드에서 모니터 알림이 전송되는 방식을 보여주는 다이어그램" style="width:90%;">}} +{{< img src="/monitors/create/multi-alert.png" alt="다중 경보 모드에서 모니터링 알림이 전송되는 방식을 보여주는 다이어그램" style="width:90%;">}} -예를 들어 서비스별로 집계한 P99 지연 시간이 특정 임계값을 초과할 때 알림을 받도록 모니터를 설정한 경우, 임계값을 초과한 각 서비스마다 **별도의** 경보를 받게 됩니다. 이는 시스템 또는 애플리케이션의 특정 문제를 식별하고 해결하는 데 유용합니다. 보다 세부적인 수준에서 문제를 추적할 수 있습니다. +예를 들어 서비스별로 집계한 P99 지연 시간이 특정 임계값을 초과할 때 알림을 받도록 모니터를 설정한 경우, P99 지연 시간이 임계값을 초과한 각 서비스에 대해 **별도**의 경보를 받게 됩니다. 이는 시스템 또는 애플리케이션의 특정 문제를 식별하고 해결하는 데 유용합니다. 보다 세부적인 수준에서 문제를 추적할 수 있습니다. ##### 알림 그룹화 {#notification-grouping} @@ -313,7 +321,7 @@ Datadog은 두 가지 유형의 알림(경보 및 경고)을 제공합니다. {{< img src="/monitors/create/multi-alert-aggregated.png" alt="다중 경보에서 특정 차원 기준으로 알림이 전송되는 방식을 보여주는 다이어그램" style="width:90%;">}} -`Multi Alert` 모드에서 알림을 집계하는 경우, 집계되지 않은 차원은 UI에서 `Sub Groups`가 됩니다. +{{< ui >}}Multi Alert{{< /ui >}} 모드에서 알림을 집계하는 경우, 집계되지 않은 차원은 UI에서 {{< ui >}}Sub Groups{{< /ui >}}가 됩니다. **참고**: 메트릭이 `host` 태그만 보고하고 `service` 태그는 보고하지 않는 경우, 해당 메트릭은 모니터에서 감지되지 않습니다. 반면 `host` 태그와 `service` 태그가 모두 있는 메트릭은 모니터에서 감지됩니다. @@ -335,23 +343,23 @@ Datadog은 두 가지 유형의 알림(경보 및 경고)을 제공합니다. ### 세분화된 액세스 제어 {#granular-access-controls} [세분화된 액세스 제어][16]를 사용하여 모니터를 편집할 수 있는 팀, 역할 또는 사용자를 제한할 수 있습니다. -1. 모니터를 편집하거나 구성하는 동안 **권한 및 감사 알림 정의** 섹션을 찾습니다. +1. 모니터를 편집하거나 구성하는 동안 {{< ui >}}Define permissions and audit notifications{{< /ui >}} 섹션을 찾습니다. {{< img src="monitors/configuration/define_permissions_audit_notifications.png" alt="권한 정의를 위한 모니터 구성 옵션" style="width:70%;" >}} -1. **Edit Access**를 클릭합니다. -1. **Restrict Access**를 클릭합니다. -1. 대화 상자가 업데이트되며 조직 구성원은 기본적으로 **Viewer** 권한을 갖는 것으로 표시됩니다. +1. {{< ui >}}Edit Access{{< /ui >}}를 클릭합니다. +1. {{< ui >}}Restrict Access{{< /ui >}}를 클릭합니다. +1. 대화 상자가 업데이트되어 조직 구성원이 기본적으로 {{< ui >}}Viewer{{< /ui >}} 액세스 권한이 있는 것으로 표시됩니다. 1. 드롭다운을 사용하여 모니터를 편집할 수 있는 하나 이상의 팀, 역할 또는 사용자를 선택합니다. -1. **Add**를 클릭합니다. -1. 대화 상자가 업데이트되며 선택한 역할에 **Editor** 권한이 부여된 것으로 표시됩니다. -1. **Done**을 클릭합니다. +1. {{< ui >}}Add{{< /ui >}}를 클릭합니다. +1. 대화 상자가 업데이트되어 선택한 역할에 {{< ui >}}Editor{{< /ui >}} 권한이 있는 것으로 표시됩니다. +1. {{< ui >}}Done{{< /ui >}}을 클릭합니다. **참고:** 모니터에 대한 편집 권한을 유지하려면 저장하기 전에 자신이 속한 역할 또는 팀을 최소 하나 이상 포함해야 합니다. 액세스가 제한된 모니터를 다시 모든 사용자가 접근할 수 있도록 하려면 다음 단계를 따르세요. -1. 모니터를 보는 동안 **More** 드롭다운 메뉴를 클릭합니다. -1. **Permissions**를 선택합니다. -1. **Restore Full Access**를 클릭합니다. -1. **Save**를 클릭합니다. +1. 모니터를 보는 동안 {{< ui >}}More{{< /ui >}} 드롭다운 메뉴를 클릭합니다. +1. {{< ui >}}Permissions{{< /ui >}}를 선택합니다. +1. {{< ui >}}Restore Full Access{{< /ui >}}를 클릭합니다. +1. {{< ui >}}Save{{< /ui >}}를 클릭합니다. ## 추가 자료 {#further-reading} diff --git a/hugo/content/ko/monitors/notify/variables.md b/hugo/content/ko/monitors/notify/variables.md index dd9c4f2dd1a..a0febe55f53 100644 --- a/hugo/content/ko/monitors/notify/variables.md +++ b/hugo/content/ko/monitors/notify/variables.md @@ -1,5 +1,5 @@ --- -description: 변수를 사용하여 모니터 알림 사용자 지정 +description: 변수를 사용하여 모니터링 알림 사용자 지정하기 further_reading: - link: /monitors/guide/template-variable-evaluation/ tag: 가이드 @@ -15,7 +15,7 @@ further_reading: text: 모니터 관리 - link: https://learn.datadoghq.com/courses/alert-monitor-notifications tag: 학습 센터 - text: 코스를 듣고 경보 모니터 알림 사용자 지정 + text: 코스를 수강하여 경보 모니터링 알림 사용자 지정하기 - link: https://www.datadoghq.com/blog/monitor-notification-rules/ tag: 블로그 text: Datadog 모니터 알림 규칙을 사용해 모니터 경보 라우팅 @@ -31,31 +31,32 @@ title: 변수 | 조건 변수 | 텍스트 표시 조건 | |----------------------------|--------------------------------------------------------------------| -| `{{#is_alert}}` | The monitor alerts | -| `{{^is_alert}}` | The monitor does not alert | -| `{{#is_match}}` | The context matches the provided substring. If a numeric value is used, it is converted to a string.| -| `{{^is_match}}` | The context does not match the provided substring | -| `{{#is_exact_match}}` | The context exactly matches the provided string.
If a number is used, the numeric value is considered, regardless of its type. This means that as long as two numbers have the same value, they are considered equal by the function. | -| `{{^is_exact_match}}` | The context does not exactly match the provided string | -| `{{#is_no_data}}` | The monitor is triggered for missing data | -| `{{^is_no_data}}` | The monitor is not triggered for missing data | -| `{{#is_warning}}` | The monitor warns | -| `{{^is_warning}}` | The monitor does not warn | -| `{{#is_recovery}}` | The monitor recovers from `ALERT`, `WARNING`, `UNKNOWN`, or `NO DATA` | -| `{{^is_recovery}}` | The monitor does not recover from `ALERT`, `WARNING`, `UNKNOWN`, or `NO DATA` | -| `{{#is_warning_recovery}}` | The monitor recovers from `WARNING` to `OK` | -| `{{^is_warning_recovery}}` | The monitor does not recover from `WARNING` to `OK` | -| `{{#is_alert_recovery}}` | The monitor recovers from `ALERT` to `OK` | -| `{{^is_alert_recovery}}` | The monitor does not recover from an ALERT to OK | -| `{{#is_alert_to_warning}}` | The monitor transitions from `ALERT` to `WARNING` | -| `{{^is_alert_to_warning}}` | The monitor does not transition from `ALERT` to `WARNING` | -| `{{#is_no_data_recovery}}` | The monitor recovers from `NO DATA` | -| `{{^is_no_data_recovery}}` | The monitor does not recover from `NO DATA` | -| `{{#is_priority 'value'}}` | The monitor has priority `value`. Value ranges from `P1` to `P5` | -| `{{#is_unknown}}` | The monitor is in the unknown state | -| `{{^is_unknown}}` | The monitor is not in the unknown state | -| `{{#is_renotify}}` | The monitor is renotifying | -| `{{^is_renotify}}` | 모니터가 다시 알리지 않습니다. | +| `{{#is_alert}}` | 모니터가 경보 상태입니다. | +| `{{^is_alert}}` | 모니터가 경보 상태가 아닙니다. | +| `{{#is_match}}` | 컨텍스트가 제공된 하위 문자열과 일치합니다. 숫자 값을 사용하면 문자열로 변환됩니다.| +| `{{^is_match}}` | 컨텍스트가 제공된 하위 문자열과 일치하지 않습니다. | +| `{{#is_exact_match}}` | 컨텍스트가 제공된 문자열과 정확히 일치합니다. +숫자를 사용하면 숫자 형식과 관계없이 숫자 값 자체를 기준으로 판단합니다. 즉, 두 숫자의 값이 같으면 이 함수는 두 숫자를 동일한 것으로 간주합니다. | +| `{{^is_exact_match}}` | 컨텍스트가 제공된 문자열과 정확히 일치하지 않습니다. | +| `{{#is_no_data}}` | 데이터 누락으로 인해 모니터가 트리거됩니다. | +| `{{^is_no_data}}` | 데이터 누락이 있지만 모니터가 트리거되지 않습니다. | +| `{{#is_warning}}` | 모니터가 경고 상태입니다. | +| `{{^is_warning}}` | 모니터가 경고 상태가 아닙니다. | +| `{{#is_recovery}}` | 모니터가 `ALERT`, `WARNING`, `UNKNOWN` 또는 `NO DATA` | 상태에서 복구됩니다. +| `{{^is_recovery}}` | 모니터가 `ALERT`, `WARNING`, `UNKNOWN` 또는 `NO DATA` | 상태에서 복구되지 않습니다. +| `{{#is_warning_recovery}}` | 모니터가 `WARNING` 상태에서 `OK` | 상태로 복구됩니다. +| `{{^is_warning_recovery}}` | 모니터가 `WARNING` 상태에서 `OK` | 상태로 복구되지 않습니다. +| `{{#is_alert_recovery}}` | 모니터가 `ALERT` 상태에서 `OK` 상태로 복구됩니다.
**참고**: `ALERT` 상태에서 `WARNING` 상태로 전환될 때 `{{#is_alert_recovery}}` 수신자에게는 메시지 본문 없이 알림이 전송됩니다. 메시지를 포함하려면 `{{#is_alert_to_warning}}`을 사용하세요. | +| `{{^is_alert_recovery}}` | 모니터가 `ALERT` 상태에서 `OK` 상태로 복구되지 않습니다. | +| `{{#is_alert_to_warning}}` | 모니터가 `ALERT` 상태에서 `WARNING` 상태로 전환됩니다. | +| `{{^is_alert_to_warning}}` | 모니터가 `ALERT` 상태에서 `WARNING` 상태로 전환되지 않습니다. | +| `{{#is_no_data_recovery}}` | 모니터가 `NO DATA` 상태에서 복구됩니다. | +| `{{^is_no_data_recovery}}` | 모니터가 `NO DATA` 상태에서 복구되지 않습니다. | +| `{{#is_priority 'value'}}` | 모니터의 우선순위가 `value`입니다. 값의 범위는 `P1`~`P5`입니다. | +| `{{#is_unknown}}` | 모니터가 알 수 없음 상태입니다. | +| `{{^is_unknown}}` | 모니터가 알 수 없음 상태가 아닙니다. | +| `{{#is_renotify}}` | 모니터가 다시 알림을 전송하고 있습니다. | +| `{{^is_renotify}}` | 모니터가 다시 알림을 전송하고 있지 않습니다. | ### 예시 {#examples} @@ -231,7 +232,7 @@ This part is generic and sent both for the first trigger and the escalation mess ``` -모니터 다시 알리기가 발생하면 사용자에게 다음과 같은 에스컬레이션 메시지가 발송됩니다. +모니터 재알림이 발생하면 사용자에게 다음과 같은 에스컬레이션 메시지가 발송됩니다. ``` This part is generic and sent both for the first trigger and the escalation message. @@ -256,7 +257,7 @@ This is the escalation message @dev-team@company.com 태그 : 자동으로 연결되거나(예: 호스트 이름, 컨테이너 이름, 로그 파일 이름, 서버리스 함수 이름 등) 사용자 지정 태그를 통해 추가됩니다(담당 팀, 환경, 애플리케이션 또는 버전). -속성 +특성 : 로그 내용을 따르며 참조표에서 조회하여 구문 분석되거나 추가됩니다(예: geoip). **참고**: 모니터가 데이터 없음 조건에서 복구되도록 구성된 경우(예를 들어 쿼리와 일치하는 이벤트가 없을 때), 복구 메시지에 아무런 데이터가 포함되지 않습니다. 복구 메시지에 정보를 계속 유지하려면 추가적인 태그 기준으로 그룹화하세요. 여기에는 `{{tag.name}}`으로 액세스할 수 있습니다. @@ -265,8 +266,7 @@ This is the escalation message @dev-team@company.com 다중 경보 그룹 박스에서 선택한 디멘션에 따라 [다중 경보 모니터][1]에서 다중 경보 변수를 구성합니다. 알림을 강화하려면 각 경보의 그룹화 기준 디멘션과 연결된 값을 포함하세요. -**참고**: 집계에 `group_by` 필드를 사용하는 경우, 모니터에서 추가적인 태그 및 경보가 자동으로 상속될 수 있습니다. 다시 말해 모니터링되는 엔드포인트에 설정된 모든 경보 또는 구성이 집계로 인해 발생하는 각 그룹에 적용될 수 있습니다. - +**참고**: 집계에 `group_by` 필드를 사용하는 경우 모니터의 추가 태그와 경보가 자동으로 상속될 수 있으므로, 모니터링 대상 엔드포인트에 설정된 모든 경보나 구성이 집계 결과로 생성된 각 그룹에 적용될 수 있습니다. [예약된 태그 키][21]는 예외입니다. 선택한 그룹화 기준과 관계없이 모든 경보에서 사용할 수 있습니다. {{< tabs >}} {{% tab "태그 기준으로 그룹화" %}} @@ -315,7 +315,7 @@ This alert was triggered on {{ @machine_id.name }} #### 그룹 기준으로 알림 사용자 지정 {#customize-the-notification-based-on-the-group} -쿼리가 특정 디멘션을 기준으로 그룹화되는 경우, 그룹과 연결된 동적 메타데이터를 사용해 알림을 강화할 수 있습니다. 태그 선택에 따른 태그 변수 목록을 보려면 **구성 알림 및 자동화** 섹션 아래에 있는 **메시지 템플릿 변수 사용**을 클릭하세요. 다음 예시 참조: +쿼리가 특정 디멘션을 기준으로 그룹화되는 경우, 그룹과 연결된 동적 메타데이터를 사용해 알림을 강화할 수 있습니다. 태그 선택에 따른 태그 변수 목록을 보려면 {{< ui >}}Configure notifications & automations{{< /ui >}} 섹션의 {{< ui >}}Use message template variables{{< /ui >}}를 클릭합니다. 다음 예시 참조: {{% collapse-content title="호스트 기준 쿼리 그룹" level="h5" %}} @@ -364,7 +364,7 @@ This alert was triggered on {{ @machine_id.name }} {{% collapse-content title="서비스 기준 쿼리 그룹" level="h5" %}} -모니터가 각 `service`에 대해 경보를 트리거하는 경우, [Software Catalog][10]에 정의된 대로 서비스의 일부 속성에 액세스할 수 있습니다. +모니터가 각 `service`에 대해 경보를 트리거하는 경우, [Catalog][10]에 정의된 대로 서비스의 일부 속성에 액세스할 수 있습니다. 서비스 메타데이터 변수: @@ -380,11 +380,43 @@ This alert was triggered on {{ @machine_id.name }} ``` {{% /collapse-content %}} + +{{% collapse-content title="device_ip 및 device_namespace 기준 쿼리 그룹" level="h5" %}} + +모니터가 각 `device_ip` 및 `device_namespace`에 대해 경보를 트리거하는 경우, 네트워크 장치의 모든 속성에 액세스할 수 있습니다. + +네트워크 장치 메타데이터 변수: +- 표준 ID: `{{network_device.canonical_id}}` +- 설명: `{{network_device.description}}` +- 장치 유형: `{{network_device.device_type}}` +- 장치 ID: `{{network_device.device_id}}` +- ID 태그: `{{network_device.id_tags}}` +- 통합: `{{network_device.integrations}}` +- IP 주소: `{{network_device.ip_address}}` +- 위치: `{{network_device.location}}` +- 모델: `{{network_device.model}}` +- 이름: `{{network_device.name}}` +- 네임스페이스: `{{network_device.namespace}}` +- OS 호스트 이름: `{{network_device.os_hostname}}` +- OS 이름: `{{network_device.os_name}}` +- OS 버전: `{{network_device.os_version}}` +- 핑 상태: `{{network_device.ping_status}}` +- 제품 이름: `{{network_device.product_name}}` +- 프로필: `{{network_device.profile}}` +- 일련번호: `{{network_device.serial_number}}` +- 상태: `{{network_device.status}}` +- 서브넷: `{{network_device.subnet}}` +- Sys 객체 ID: `{{network_device.sys_object_id}}` +- 태그: `{{network_device.tags}}` +- 벤더: `{{network_device.vendor}}` +- 버전: `{{network_device.version}}` +{{% /collapse-content %}} + ### 일치하는 속성/태그 변수 {#matching-attributetag-variables} 모니터 쿼리와 일치하는 로그, 트레이스 스팬, RUM 이벤트, CI 파이프라인 또는 CI 테스트 이벤트의 속성 또는 태그를 아무것이나 포함할 수 있습니다. 다음 테이블에 다양한 모니터 유형에서 추가할 수 있는 속성 및 변수의 예를 표시했습니다. -
모니터에 사용할 수 있는 변수 전체 목록을 보려면 알림 구성 맨 아래에서 {{ 변수 추가를 클릭하고 확장된 메뉴 옵션 중에서 선택하세요.
+
모니터에 사용할 수 있는 전체 변수 목록을 보려면 알림 구성 하단의 {{< ui >}}{{ Add Variable{{< /ui >}}을 클릭하고 확장된 메뉴 옵션 중에서 선택합니다.
| 모니터 유형 | 변수 구문 | |--------------------------|--------------------------------------------------------| @@ -622,7 +654,7 @@ https://app.datadoghq.com/infrastructure/map?filter=service:{{service.name}} | `sizeby` | `sizeby=avg:` | 호스트 육각형의 크기. | {{% /tab %}} -{{% tab "모니터" %}} +{{% tab "Monitors" %}} `{{host.name}}` [태그 변수](#attribute-and-tag-variables)를 사용하여 특정 호스트와 관련된 모든 모니터로 이동하는 링크 제공: @@ -673,7 +705,7 @@ https://app.datadoghq.com/logs?from_ts={{eval "last_triggered_at_epoch-10*60*100 ### Raw 형식 {#raw-format} -경보 메시지가 중괄호 두 개, 예를 들어 `{{ }}`, use `{{{{raw}}}}` 형식을 보내야 하는 경우입니다. 예를 들면 다음과 같습니다. +경보 메시지에서 `{{ }}`와 같은 이중 중괄호를 전송해야 하는 경우, `{{{raw}}}}` 형식을 사용합니다. 예를 들면 다음과 같습니다. ```text {{{{raw}}}} @@ -687,7 +719,7 @@ https://app.datadoghq.com/logs?from_ts={{eval "last_triggered_at_epoch-10*60*100 {{ }} {{ }} ``` -[조건 변수](#conditional-variables)에 사용된 `^|#` 도우미는 `{{{{raw}}}}` formatting and must be removed. For instance, to output raw text with the `{{is_match}}` conditional variable use the following template: +[조건 변수](#conditional-variables)에 사용되는 `^|#` 도우미는 `{{{{raw}}}}` 형식과 함께 사용할 수 없으므로 제거해야 합니다. 예를 들어 `{{is_match}}` 조건 변수로 원시 텍스트를 출력하려면 다음 템플릿을 사용합니다. ```text {{{{is_match "host.name" ""}}}} @@ -705,7 +737,7 @@ https://app.datadoghq.com/logs?from_ts={{eval "last_triggered_at_epoch-10*60*100 경보 메시지에 URL로 인코딩해야 하는 정보가 포함된 경우(예를 들어 리디렉션용으로) `{{ urlencode ""}}` 구문을 사용하세요. -**예**: 모니터 메시지에 특정 서비스로 필터링된 Software Catalog로 이동하는 URL이 포함된 경우, `service` [태그 변수](#attribute-and-tag-variables)를 사용하고 URL에 `{{ urlencode ""}}` 구문을 추가하세요. +**예**: 모니터 메시지에 특정 서비스로 필터링된 카탈로그로 이동하는 URL이 포함된 경우, `service` [태그 변수](#attribute-and-tag-variables)를 사용하고 URL에 `{{ urlencode ""}}` 구문을 추가하세요. ``` https://app.datadoghq.com/services/{{urlencode "service.name"}} @@ -724,8 +756,8 @@ https://app.datadoghq.com/services/{{urlencode "service.name"}} [7]: /ko/monitors/guide/template-variable-evaluation/ [8]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones [9]: /ko/monitors/types/error_tracking/ -[10]: /ko/software_catalog/service_definitions/ -[11]: https://docs.datadoghq.com/ko/software_catalog/service_definitions/v2-2/#example-yaml +[10]: /ko/internal_developer_portal/catalog/entity_model/ +[11]: https://docs.datadoghq.com/ko/internal_developer_portal/catalog/entity_model/ [12]: /ko/monitors/types/log/ [13]: /ko/monitors/types/apm/?tab=analytics [14]: /ko/monitors/types/error_tracking/ @@ -734,4 +766,5 @@ https://app.datadoghq.com/services/{{urlencode "service.name"}} [17]: /ko/monitors/types/ci/?tab=tests [18]: /ko/monitors/types/ci/?tab=pipelines [19]: /ko/monitors/types/database_monitoring/ -[20]: /ko/synthetics/notifications/template_variables/ \ No newline at end of file +[20]: /ko/synthetics/notifications/template_variables/ +[21]: /ko/getting_started/tagging/ \ No newline at end of file diff --git a/hugo/content/ko/opentelemetry/config/otlp_receiver.md b/hugo/content/ko/opentelemetry/config/otlp_receiver.md new file mode 100644 index 00000000000..388a15c4c45 --- /dev/null +++ b/hugo/content/ko/opentelemetry/config/otlp_receiver.md @@ -0,0 +1,203 @@ +--- +aliases: +- /ko/opentelemetry/collector_exporter/otlp_receiver +further_reading: +- link: /opentelemetry/collector_exporter/ + tag: 설명서 + text: OpenTelemetry Collector 설정하기 +- link: /opentelemetry/otlp_ingest_in_the_agent/ + tag: 설명서 + text: Datadog Agent에 의한 OTLP 수집 +- link: https://www.datadoghq.com/architecture/datadog-agent-otlp-receiver-in-kubernetes/ + tag: 아키텍처 센터 + text: Kubernetes의 Datadog Agent OTLP 수신기 +title: OTLP 수신기 +--- +## 개요 {#overview} + +메트릭, 로그, 트레이스를 수집하려면 컬렉터(Collector)에서 [OTLP 수신기][1]를 설정하세요. + +자세한 내용은 [OTLP 수신기][1]에 대한 OpenTelemetry 프로젝트 설명서를 참조하세요. + +## 설정 {#setup} + +Collector 구성에 다음 줄을 추가합니다. + +{{% otel-endpoint-note %}} + +```yaml +receivers: + otlp: + protocols: + http: + endpoint: "0.0.0.0:4318" + grpc: + endpoint: "0.0.0.0:4317" +``` + +## 수집된 데이터 {#data-collected} + +트레이스, 메트릭, 로그입니다. + +## 전체 설정 예시 {#full-example-configuration} + +Datadog 내보내기를 사용한 전체 작업 예시 설정은 [`otlp.yaml`][2]을 참조하세요. + +## 로깅 출력 예시 {#example-logging-output} + +``` +ResourceSpans #0 +Resource SchemaURL: https://opentelemetry.io/schemas/1.6.1 +Resource attributes: + -> k8s.node.name: Str(ip-192-168-61-208.ec2.internal) + -> process.command_args: Slice(["/app/shippingservice"]) + -> k8s.namespace.name: Str(otel-gateway) + -> process.pid: Int(1) + -> service.name: Str(shippingservice) + -> service.namespace: Str(opentelemetry-demo) + -> os.type: Str(linux) + -> k8s.pod.ip: Str(192.168.57.77) + -> deployment.environment: Str(otel-gateway) + -> service.instance.id: Str(82323d5f-0e47-4ae6-92b6-583dc1fa33a1) + -> k8s.pod.name: Str(opentelemetry-demo-shippingservice-7f9b565549-4p2pj) + -> cloud.provider: Str(aws) + -> cloud.platform: Str(aws_ec2) + -> cloud.region: Str(us-east-1) + -> cloud.account.id: Str(XXXXXXXXX) + -> cloud.availability_zone: Str(us-east-1c) + -> host.id: Str(i-0e0b580bbe11883dc) + -> host.image.id: Str(ami-06f28e19c3ba73ef7) + -> host.type: Str(m5.large) + -> host.name: Str(ip-192-168-61-208.ec2.internal) + -> k8s.pod.start_time: Str(2023-11-13T15:03:50Z) + -> k8s.replicaset.uid: Str(537d3c30-fe3d-4999-be1a-51227c90a5e4) + -> kube_app_name: Str(opentelemetry-demo-shippingservice) + -> kube_app_instance: Str(opentelemetry-demo) + -> k8s.pod.uid: Str(82323d5f-0e47-4ae6-92b6-583dc1fa33a1) + -> k8s.replicaset.name: Str(opentelemetry-demo-shippingservice-7f9b565549) + -> kube_app_component: Str(shippingservice) +ScopeSpans #0 +ScopeSpans SchemaURL: +InstrumentationScope opentelemetry-otlp 0.11.0 +Span #0 + Trace ID : c4f6d4a8831a5d7b95727da5443ad8a4 + Parent ID : c7e98372030f17b1 + ID : f226428843050d12 + Name : reqwest-http-client + Kind : Client + Start time : 2023-11-20 12:56:26.401728438 +0000 UTC + End time : 2023-11-20 12:56:26.403518138 +0000 UTC + Status code : Unset + Status message : +Attributes: + -> http.host: Str(opentelemetry-demo-quoteservice) + -> http.url: Str(http://opentelemetry-demo-quoteservice:8080/getquote) + -> http.status_code: Int(200) + -> thread.name: Str(tokio-runtime-worker) + -> busy_ns: Int(199789) + -> code.namespace: Str(reqwest_tracing::reqwest_otel_span_builder) + -> code.lineno: Int(128) + -> thread.id: Int(3) + -> http.method: Str(POST) + -> http.user_agent: Str() + -> idle_ns: Int(1588692) + -> code.filepath: Str(/usr/local/cargo/registry/src/github.com-1ecc6299db9ec823/reqwest-tracing-0.4.0/src/reqwest_otel_span_builder.rs) + -> net.host.port: Str(8080) + -> http.scheme: Str(http) +ResourceMetrics #0 +Resource SchemaURL: https://opentelemetry.io/schemas/1.6.1 +Resource attributes: + -> service.name: Str(opentelemetry-collector) + -> net.host.name: Str(192.168.38.72) + -> service.instance.id: Str(192.168.38.72:8888) + -> net.host.port: Str(8888) + -> http.scheme: Str(http) + -> k8s.pod.ip: Str(192.168.38.72) + -> cloud.provider: Str(aws) + -> cloud.platform: Str(aws_ec2) + -> cloud.region: Str(us-east-1) + -> cloud.account.id: Str(XXXXXXXXX) + -> cloud.availability_zone: Str(us-east-1c) + -> host.id: Str(i-0fb30793f89bd81ab) + -> host.image.id: Str(ami-0cbbb5a8c6f670bb6) + -> host.type: Str(m5.large) + -> host.name: Str(ip-192-168-37-51.ec2.internal) + -> os.type: Str(linux) + -> k8s.pod.uid: Str(01f039fa-abf3-4ab1-8683-923dcf94b391) + -> k8s.namespace.name: Str(otel-ds-gateway) + -> k8s.pod.start_time: Str(2023-11-20T12:53:40Z) + -> k8s.daemonset.uid: Str(694b994d-3488-418a-9f94-284792f1f8da) + -> k8s.daemonset.name: Str(opentelemetry-collector-agent) + -> k8s.node.name: Str(ip-192-168-37-51.ec2.internal) + -> kube_app_name: Str(opentelemetry-collector) + -> kube_app_instance: Str(opentelemetry-collector) + -> k8s.pod.name: Str(opentelemetry-collector-agent-4dm92) +ScopeMetrics #0 +ScopeMetrics SchemaURL: +InstrumentationScope otelcol/prometheusreceiver 0.88.0-dev +Metric #0 +Descriptor: + -> Name: otelcol_exporter_queue_capacity + -> Description: Fixed capacity of the retry queue (in batches) + -> Unit: + -> DataType: Gauge +NumberDataPoints #0 +Data point attributes: + -> exporter: Str(otlp) + -> service_instance_id: Str(ab73126a-0eff-4678-922d-a96b1fdabcdc) + -> service_name: Str(otelcontribcol) + -> service_version: Str(0.88.0-dev) +StartTimestamp: 1970-01-01 00:00:00 +0000 UTC +Timestamp: 2023-11-20 13:01:26.074 +0000 UTC +Value: 1000.000000 + +ResourceLog #0 +Resource SchemaURL: https://opentelemetry.io/schemas/1.6.1 +Resource attributes: + -> k8s.container.name: Str(loadgenerator) + -> k8s.namespace.name: Str(otel-staging) + -> k8s.pod.name: Str(opentelemetry-demo-loadgenerator-d8c4d699d-ztt98) + -> k8s.container.restart_count: Str(1) + -> k8s.pod.uid: Str(92bf09ed-0db9-4f69-a9d6-1dadf12e01aa) + -> k8s.pod.ip: Str(192.168.55.78) + -> cloud.provider: Str(aws) + -> cloud.platform: Str(aws_ec2) + -> cloud.region: Str(us-east-1) + -> cloud.account.id: Str(XXXXXXXXX) + -> cloud.availability_zone: Str(us-east-1c) + -> host.id: Str(i-0368add8e328c28f7) + -> host.image.id: Str(ami-08a2e6a8e82737230) + -> host.type: Str(m5.large) + -> host.name: Str(ip-192-168-53-115.ec2.internal) + -> os.type: Str(linux) + -> k8s.daemonset.uid: Str(6d6fef61-d4c7-4226-9b7b-7d6b893cb31d) + -> k8s.daemonset.name: Str(opentelemetry-collector-agent) + -> k8s.node.name: Str(ip-192-168-53-115.ec2.internal) + -> kube_app_name: Str(opentelemetry-collector) + -> kube_app_instance: Str(opentelemetry-collector) + -> k8s.pod.start_time: Str(2023-11-20T12:53:23Z) +ScopeLogs #0 +ScopeLogs SchemaURL: +InstrumentationScope +LogRecord #0 +ObservedTimestamp: 2023-11-20 13:02:04.332021519 +0000 UTC +Timestamp: 2023-11-20 13:01:46.095736502 +0000 UTC +SeverityText: +SeverityNumber: Unspecified(0) +Body: Str( return wrapped_send(self, request, **kwargs)) +Attributes: + -> log.file.path: Str(/var/log/pods/otel-staging_opentelemetry-demo-loadgenerator-d8c4d699d-ztt98_92bf09ed-0db9-4f69-a9d6-1dadf12e01aa/loadgenerator/1.log) + -> time: Str(2023-11-20T13:01:46.095736502Z) + -> logtag: Str(F) + -> log.iostream: Str(stderr) +Trace ID: +Span ID: +Flags: 0 +``` + +## 추가 자료 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://github.com/open-telemetry/opentelemetry-collector/blob/main/receiver/otlpreceiver/README.md +[2]: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/exporter/datadogexporter/examples/otlp.yaml \ No newline at end of file diff --git a/hugo/content/ko/opentelemetry/setup/collector_exporter/_index.md b/hugo/content/ko/opentelemetry/setup/collector_exporter/_index.md new file mode 100644 index 00000000000..6db7fd937aa --- /dev/null +++ b/hugo/content/ko/opentelemetry/setup/collector_exporter/_index.md @@ -0,0 +1,63 @@ +--- +description: OpenTelemetry 데이터를 OpenTelemetry Collector 및 Datadog Exporter로 전송하기 +further_reading: +- link: /opentelemetry/setup/ddot_collector/install/ + tag: 설명서 + text: DDOT Collector 설치(권장) +- link: /opentelemetry/compatibility/ + tag: 설명서 + text: 기능 호환성 +- link: https://www.datadoghq.com/architecture/opentelemetry-collector-in-kubernetes/ + tag: 아키텍처 센터 + text: Kubernetes의 OpenTelemetry Collector +title: OpenTelemetry Collector 설치 및 구성 +--- +## 개요 {#overview} + +이 페이지에서는 텔레메트리 데이터를 Datadog으로 전송하기 위한 독립형 OpenTelemetry Collector 설치 및 구성 가이드를 제공합니다. + +이 방법은 OpenTelemetry 오픈 소스 커뮤니티의 OTel Collector 배포판을 사용하려는 사용자나 다른 설정에서 제공하지 않는 고급 처리 기능이 필요한 사용자에게 가장 적합합니다. 대부분의 사용 사례에서는 [Datadog Distribution of OTel Collector (DDOT)][1]를 권장합니다. + +## 설정 {#setup} + +시작하려면 OpenTelemetry Collector를 설치한 다음 Datadog Exporter로 구성합니다. 이 가이드는 보다 구체적인 구성 주제로 넘어가기 전에 필요한 초기 설정을 안내합니다. + +{{< whatsnext desc=" " >}} + {{< nextlink href="/opentelemetry/setup/collector_exporter/install" >}} +

Install and Configure the Collector

+ Follow the initial setup steps to get a Collector running with the Datadog Exporter. + {{< /nextlink >}} +{{< /whatsnext >}} + +## 구성 {#configuration} + +Collector를 실행한 후 이 가이드를 활용하여 텔레메트리 데이터를 수집하고 보강하는 데 필요한 특정 수신기 및 프로세서를 구성합니다. + +{{< whatsnext desc=" " >}} + {{< nextlink href="/opentelemetry/setup/collector_exporter/deploy" >}} +

Deploy the Collector

+ Learn how to run the Collector in various environments, including on a host, in Docker, or as a DaemonSet or Gateway in Kubernetes. + {{< /nextlink >}} + {{< nextlink href="/opentelemetry/config/hostname_tagging" >}} +

Configure Hostname and Tagging

+ Use resource detection and Kubernetes attributes processors to ensure proper hostname resolution and apply critical tags for correlating telemetry in Datadog. + {{< /nextlink >}} + {{< nextlink href="/opentelemetry/config/log_collection" >}} +

Set up Log Collection

+ Configure the filelog receiver to collect logs from files and forward them to Datadog, enabling unified logs, metrics, and traces. + {{< /nextlink >}} + {{< nextlink href="/opentelemetry/config/otlp_receiver" >}} +

Enable the OTLP Receiver

+ Configure the OTLP receiver to accept traces, metrics, and logs from your OpenTelemetry-instrumented applications over gRPC or HTTP. + {{< /nextlink >}} + {{< nextlink href="/opentelemetry/config/collector_batch_memory" >}} +

Tune Batch and Memory Settings

+ Optimize your Collector's performance and resource consumption by configuring the batch processor and memory limiter. + {{< /nextlink >}} +{{< /whatsnext >}} + +## 추가 자료 {#further-reading} + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /ko/opentelemetry/setup/ddot_collector/install/ \ No newline at end of file diff --git a/hugo/content/ko/serverless/azure_app_service/linux_code.md b/hugo/content/ko/serverless/azure_app_service/linux_code.md new file mode 100644 index 00000000000..4162a5235f4 --- /dev/null +++ b/hugo/content/ko/serverless/azure_app_service/linux_code.md @@ -0,0 +1,780 @@ +--- +aliases: +- /ko/serverless/azure_app_services/azure_app_services_linux +further_reading: +- link: https://www.datadoghq.com/blog/monitor-azure-app-service-linux/ + tag: 블로그 + text: Datadog을 통해 Azure App Service에서 Linux 웹 앱 모니터링 +title: Azure App Service - Linux 코드 +--- +## 개요 {#overview} + +이 페이지에서는 Datadog Agent를 사용해 Linux Azure App Service 애플리케이션을 계측하는 방법을 설명합니다. 이 페이지에 명시된 절차는 사이드카 컨테이너와 Linux Azure App Service 애플리케이션 설정을 통해 애플리케이션을 계측하고 구성을 관리합니다. + +사이드카 접근 방법을 사용하지 않으려는 경우(권장하지 않음), 대신 [Datadog 래퍼를 사용한 Azure App Service - Linux 코드 배포 계측][1] 안내를 따를 수 있습니다. + +**지원 런타임**: Java, Node.js, .NET, PHP, Python + +## 설정 {#setup} + +### Azure 통합 {#azure-integration} + +아직 설치하지 않았다면 [Datadog Azure 통합][10]을 설치하여 메트릭과 로그를 수집하세요. + +### 애플리케이션 {#application} + +사용 중인 언어에 맞는 SDK를 설치하세요. + +{{< tabs >}} +{{% tab "Java" %}} + +Java는 명령줄 인수 `javaagent`를 사용하여 계측 코드를 추가하는 기능을 지원합니다. + +1. [Datadog Java SDK 최신 버전][101]을 다운로드합니다. +1. SDK를 프로젝트 내부에 배치합니다. 배포 시 반드시 포함해야 합니다. + `azure-webapp-maven` 플러그인을 사용하는 경우, Java SDK를 `lib` 유형의 리소스 항목으로 추가할 수 있습니다. +1. 환경 변수 `JAVA_OPTS`를 `--javaagent:/home/site/lib/dd-java-agent.jar`로 설정합니다. 애플리케이션이 배포되면 Java 트레이서가 `/home/site/lib/dd-java-agent.jar`로 복사됩니다. + +애플리케이션이 실행되면 계측이 시작됩니다. + +[101]: https://dtdg.co/latest-java-tracer + +{{% /tab %}} +{{% tab "Node.js" %}} + +1. `dd-trace` 패키지를 설치합니다. + ``` + npm install dd-trace + ``` +2. Node.js 트레이서를 `NODE_OPTIONS` 환경 변수로 초기화합니다. + ``` + NODE_OPTIONS='--require dd-trace/init' + ``` + +{{% /tab %}} +{{% tab ".NET" %}} + +`Datadog.Trace.Bundle` Nuget 패키지를 프로젝트에 추가합니다. 자세한 내용은 [Nuget 패키지 페이지][102]를 참조하세요. + +예: + +```shell +dotnet add package Datadog.Trace.Bundle --version 3.21.0 +``` + +[102]: https://www.nuget.org/packages/Datadog.Trace.Bundle#readme-body-tab + +{{% /tab %}} +{{% tab "PHP" %}} + +다음 스크립트를 실행하여 Datadog PHP SDK를 설치합니다. +startup.sh: + +```bash +#!/usr/bin/env bash + +echo "Setting up Datadog tracing for PHP" +DD_PHP_TRACER_VERSION=1.8.3 +DD_PHP_TRACER_URL=https://github.com/DataDog/dd-trace-php/releases/download/${DD_PHP_TRACER_VERSION}/datadog-setup.php + +echo "Installing PHP tracer from ${DD_PHP_TRACER_URL}" +if curl -LO --fail "${DD_PHP_TRACER_URL}"; then + eval "php datadog-setup.php --php-bin=all" +else + echo "Downloading the tracer was unsuccessful" + return +fi + +# This line is can be uncommented if the project contains an nginx configuration in the project root +# cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload + +service nginx reload +``` + +이 bash 스크립트는 시작 명령으로 실행되도록 구성되었으며, PHP에 추적 모듈을 설치한 다음 NGINX 서비스를 다시 시작합니다. + +{{% /tab %}} +{{% tab "Python" %}} + +1. 프로젝트에 `ddtrace`를 추가합니다. +1. 시작 명령을 수정합니다. 새 명령은 이전 명령을 인수로 사용하여 `ddtrace-run`을 실행해야 합니다. 즉, 시작 명령이 `foo`인 경우, `ddtrace-run foo`를 실행하도록 수정합니다. + + 예: + ```ssh + ddtrace-run gunicorn --bind=0.0.0.0 --timeout 600 quickstartproject.wsgi + ``` + +{{% /tab %}} +{{< /tabs >}} + +### 계측 {#instrumentation} + +{{< tabs >}} +{{% tab "Datadog CLI" %}} + +#### 로컬 {#locally} + +[Datadog CLI][201] 설치 + +```shell +npm install -g @datadog/datadog-ci @datadog/datadog-ci-plugin-aas +``` + +[Azure CLI][202]를 설치하고 `az login`으로 인증합니다. + +그런 다음, 아래의 명령어를 실행하여 사이드카 컨테이너를 설정합니다. + +```shell +export DD_API_KEY= +export DD_SITE= +datadog-ci aas instrument -s -g -n +``` + +Datadog 사이트를 다음과 같이 설정합니다. {{< region-param key="dd_site" code="true" >}}기본값은 `datadoghq.com`입니다. + +`--service` 및 `--env`와 같은 추가 플래그를 사용하여 서비스 및 환경 태그를 설정할 수 있습니다. 전체 옵션 목록을 보려면 `datadog-ci aas instrument --help`를 실행합니다. + +`datadog-ci aas instrument` 계측 설정 시 한 번만 실행하면 됩니다. 코드를 배포할 때마다 다시 실행할 필요는 없으며, Datadog 구성 변경 시에만 다시 실행합니다. + +#### Azure Cloud Shell {#azure-cloud-shell} + +[Azure Cloud Shell][203]에서 Datadog CLI를 사용하려면 클라우드 셸을 열고 `DD_API_KEY` 및 `DD_SITE` 환경 변수에 API 키와 사이트를 설정한 다음, `npx`를 사용하여 CLI를 직접 실행합니다. + +```shell +export DD_API_KEY= +export DD_SITE= +npx @datadog/datadog-ci aas instrument -s -g -n +``` + + +[201]: https://github.com/DataDog/datadog-ci#how-to-install-the-cli +[202]: https://learn.microsoft.com/en-us/cli/azure/install-azure-cli +[203]: https://portal.azure.com/#cloudshell/ + +{{% /tab %}} +{{% tab "Terraform" %}} + +[Linux Web Apps용 Datadog Terraform 모듈][1]은 [azurerm_linux_web_app][2] 리소스를 래핑하고 필수 환경 변수 및 serverlessinit 사이드카를 추가하여 Datadog Serverless Monitoring을 위해 웹 앱을 자동으로 구성합니다. + +Terraform을 아직 설정하지 않은 경우, [Terraform을 설치][3]하고 새 디렉터리를 만들고 `main.tf`라는 파일을 생성합니다. + +그런 다음, 필요에 따라 업데이트하여 Terraform 구성에 다음을 추가합니다. + +```tf +variable "datadog_api_key" { + description = "Your Datadog API key" + type = string + sensitive = true +} + +provider "azurerm" { + features {} + subscription_id = "00000000-0000-0000-0000-000000000000" // Replace with your subscription ID +} + +resource "azurerm_service_plan" "my_asp" { + name = "my-app-service-plan" // Replace with your app service plan name + resource_group_name = "my-resource-group" // Replace with your resource group name + os_type = "Linux" + location = "eastus" + sku_name = "P1v2" +} + +module "my_web_app" { + source = "DataDog/web-app-datadog/azurerm//modules/linux" + version = "~> 1.0" + + name = "my-web-app" // Replace with your web app name + resource_group_name = "my-resource-group" // Replace with your resource group name + service_plan_id = azurerm_service_plan.my_asp.id + location = "eastus" + + datadog_api_key = var.datadog_api_key + datadog_service = "my-service" // Replace with your service name + datadog_env = "prod" // Replace with your environment (e.g. prod, staging) + datadog_version = "0.0.0" // Replace with your application version + + site_config = { + application_stack = { + python_version = "3.13" // change for your specific runtime + } + } + app_settings = { + DD_TRACE_ENABLED = "true" // Example setting + } +} +``` + +마지막으로 `terraform apply`를 실행하고 프롬프트를 따릅니다. + +[Datadog Linux Web App 모듈][4]은 Web App 리소스만 배포하므로, [코드 배포][5] 작업은 별도로 수행해야 합니다. + +[1]: https://registry.terraform.io/modules/DataDog/web-app-datadog/azurerm/latest/submodules/linux +[2]: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/linux_web_app +[3]: https://developer.hashicorp.com/terraform/install +[4]: https://registry.terraform.io/modules/DataDog/web-app-datadog/azurerm/latest/submodules/linux +[5]: https://learn.microsoft.com/en-us/azure/app-service/getting-started + +{{% /tab %}} +{{% tab "Bicep" %}} + +다음과 같이 기존 웹 앱을 업데이트하여 필요한 Datadog 앱 설정과 사이드카를 포함하세요. + +```bicep +resource webApp 'Microsoft.Web/sites@2025-03-01' = { + // ... + properties: { + // ... + siteConfig: { + // ... + appSettings: concat(datadogAppSettings, [ + //... Your existing app settings + ]) + } + } +} + +@secure() +param datadogApiKey string + +var datadogAppSettings = [ + { name: 'DD_API_KEY', value: datadogApiKey } + { name: 'DD_SITE', value: 'datadoghq.com' } // Replace with your Datadog site + { name: 'DD_SERVICE', value: 'my-service' } // Replace with your service name + { name: 'DD_ENV', value: 'prod' } // Replace with your environment (e.g. prod, staging) + { name: 'DD_VERSION', value: '0.0.0' } // Replace with your application version + { name: 'WEBSITES_ENABLE_APP_SERVICE_STORAGE', value: 'true' } + // Uncomment for .NET applications + // { name: 'DD_DOTNET_TRACER_HOME', value: '/datadog/tracer' } + // { name: 'CORECLR_ENABLE_PROFILING', value: '1' } + // { name: 'CORECLR_PROFILER', value: '{846F5F1C-F9AE-4B07-969E-05C26BC060D8}' } + // { name: 'CORECLR_PROFILER_PATH', value: '/datadog/tracer/Datadog.Trace.ClrProfiler.Native.so' } + { name: 'DD_LOGS_INJECTION', value: 'true' } + { name: 'DD_TRACE_ENABLED', value: 'true' } + // Add any additional options here +] + +resource sidecar 'Microsoft.Web/sites/sitecontainers@2025-03-01' = { + parent: webApp + name: 'datadog-sidecar' + properties: { + image: 'index.docker.io/datadog/serverless-init:latest' + isMain: false + targetPort: '8126' + environmentVariables: [for v in datadogAppSettings: { name: v.name, value: v.name }] + } +} +``` + +업데이트된 템플릿을 다시 배포합니다. + +```shell +az deployment group create --resource-group --template-file