From 5cca3ffabec8a4c69fb01b29010cab4945ee8ad5 Mon Sep 17 00:00:00 2001 From: svc-docs-eng-opensource-bot Date: Sun, 2 Nov 2025 12:05:06 +0000 Subject: [PATCH 01/22] chore: add translations --- .../add-on-billing.mdx | 28 + .../data-ingest-billing.mdx | 354 +++++ .../notification-integrations.mdx | 12 +- ...ompatibility-requirements-nodejs-agent.mdx | 22 +- ...gent-requirements-supported-frameworks.mdx | 96 +- .../introdution.mdx | 6 +- .../transaction-workloads.mdx | 169 ++- .../advanced-session-replay.mdx | 162 +++ .../integrations-managed-policies.mdx | 192 +-- .../no-data-appears-aws-integrations.mdx | 8 +- .../find-unusual-logs-log-patterns.mdx | 43 +- .../apm-monitoring/opentelemetry-apm-ui.mdx | 8 +- .../docs-release-notes/docs-10-25-2025.mdx | 71 + .../docs-release-notes/docs-8-01-2025.mdx | 99 ++ .../docs-release-notes/docs-8-08-2025.mdx | 60 + .../docs-release-notes/docs-8-14-2025.mdx | 112 ++ .../docs-release-notes/docs-8-21-2025.mdx | 56 + .../docs-release-notes/docs-9-12-2025.mdx | 94 ++ .../new-relic-infrastructure-agent-1710.mdx | 15 + .../kubernetes-integration-3-48-0.mdx | 13 + .../flutter-agent-1116.mdx | 18 + .../browser-agent-v1.295.mdx | 39 + .../browser-agent-v1.296.mdx | 34 + .../node-api-runtime-1.2.mdx | 10 + .../node-browser-runtime-3.0.mdx | 10 + .../ping-runtime-1.53.mdx | 10 + .../ping-runtime-1.54.mdx | 10 + .../vulnerability-management/overview.mdx | 2 +- .../create-your-own.mdx | 707 ++++++++++ .../managing-workflow.mdx | 164 +++ .../start-schedule.mdx | 237 ++++ .../use-a-template.mdx | 284 ++++ .../introduction-to-workflow.mdx | 148 ++ .../workflow-best-practices.mdx | 326 +++++ .../limitations-and-faq/workflow-limits.mdx | 201 +++ .../actions-catalog/actions-catalog.mdx | 41 + .../actions-catalog/communication.mdx | 704 ++++++++++ .../actions-catalog/http.mdx | 1103 +++++++++++++++ .../actions-catalog/new-relic.mdx | 1212 +++++++++++++++++ .../actions-catalog/others.mdx | 684 ++++++++++ .../create-destinations.mdx | 91 ++ .../set-up-aws-credentials.mdx | 465 +++++++ .../workflow-automation/troubleshooting.mdx | 386 ++++++ .../create-schedule.mdx | 33 + .../create-workflow-definition.mdx | 34 + .../definition-schema.mdx | 697 ++++++++++ .../delete-schedule.mdx | 44 + .../delete-workflow-definition.mdx | 32 + .../get-action-definitions.mdx | 158 +++ .../workflow-automation-apis/get-schedule.mdx | 29 + .../get-schedules.mdx | 41 + .../get-workflow-definition.mdx | 35 + .../get-workflow-definitions.mdx | 38 + .../signal-workflow-run.mdx | 75 + .../start-workflow-run.mdx | 35 + .../stop-workflow-run.mdx | 26 + .../update-workflow-definition.mdx | 30 + .../using-workflow-automation-api.mdx | 81 ++ .../validate-workflow-definition.mdx | 34 + .../workflow-run-info.mdx | 32 + .../workflow-automation/workflow-examples.mdx | 244 ++++ .../add-on-billing.mdx | 28 + .../data-ingest-billing.mdx | 354 +++++ .../notification-integrations.mdx | 12 +- ...ompatibility-requirements-nodejs-agent.mdx | 22 +- ...gent-requirements-supported-frameworks.mdx | 96 +- .../introdution.mdx | 6 +- .../transaction-workloads.mdx | 169 ++- .../advanced-session-replay.mdx | 162 +++ .../integrations-managed-policies.mdx | 2 +- .../no-data-appears-aws-integrations.mdx | 2 +- .../find-unusual-logs-log-patterns.mdx | 4 +- .../apm-monitoring/opentelemetry-apm-ui.mdx | 8 +- .../docs-release-notes/docs-10-25-2025.mdx | 71 + .../docs-release-notes/docs-8-08-2025.mdx | 60 + .../docs-release-notes/docs-8-14-2025.mdx | 112 ++ .../docs-release-notes/docs-9-12-2025.mdx | 94 ++ .../new-relic-infrastructure-agent-1710.mdx | 15 + .../kubernetes-integration-3-48-0.mdx | 13 + .../flutter-agent-1116.mdx | 18 + .../browser-agent-v1.295.mdx | 39 + .../browser-agent-v1.296.mdx | 34 + .../node-api-runtime-1.2.mdx | 6 +- .../node-browser-runtime-3.0.mdx | 6 +- .../ping-runtime-1.53.mdx | 10 + .../ping-runtime-1.54.mdx | 10 + .../vulnerability-management/overview.mdx | 2 +- .../create-your-own.mdx | 707 ++++++++++ .../managing-workflow.mdx | 164 +++ .../start-schedule.mdx | 237 ++++ .../use-a-template.mdx | 284 ++++ .../introduction-to-workflow.mdx | 148 ++ .../workflow-best-practices.mdx | 326 +++++ .../limitations-and-faq/workflow-limits.mdx | 201 +++ .../actions-catalog/actions-catalog.mdx | 41 + .../actions-catalog/communication.mdx | 704 ++++++++++ .../actions-catalog/http.mdx | 1103 +++++++++++++++ .../actions-catalog/new-relic.mdx | 1212 +++++++++++++++++ .../actions-catalog/others.mdx | 684 ++++++++++ .../create-destinations.mdx | 91 ++ .../set-up-aws-credentials.mdx | 465 +++++++ .../workflow-automation/troubleshooting.mdx | 386 ++++++ .../create-schedule.mdx | 33 + .../create-workflow-definition.mdx | 34 + .../definition-schema.mdx | 697 ++++++++++ .../delete-schedule.mdx | 44 + .../delete-workflow-definition.mdx | 32 + .../get-action-definitions.mdx | 158 +++ .../workflow-automation-apis/get-schedule.mdx | 29 + .../get-schedules.mdx | 41 + .../get-workflow-definition.mdx | 35 + .../get-workflow-definitions.mdx | 38 + .../signal-workflow-run.mdx | 75 + .../start-workflow-run.mdx | 35 + .../stop-workflow-run.mdx | 26 + .../update-workflow-definition.mdx | 30 + .../using-workflow-automation-api.mdx | 81 ++ .../validate-workflow-definition.mdx | 34 + .../workflow-run-info.mdx | 32 + .../workflow-automation/workflow-examples.mdx | 244 ++++ .../notification-integrations.mdx | 12 +- ...gent-requirements-supported-frameworks.mdx | 96 +- .../introdution.mdx | 6 +- .../transaction-workloads.mdx | 169 ++- .../advanced-session-replay.mdx | 162 +++ .../integrations-managed-policies.mdx | 2 +- .../no-data-appears-aws-integrations.mdx | 8 +- .../find-unusual-logs-log-patterns.mdx | 39 +- .../apm-monitoring/opentelemetry-apm-ui.mdx | 8 +- .../docs-release-notes/docs-10-25-2025.mdx | 71 + .../docs-release-notes/docs-8-08-2025.mdx | 60 + .../docs-release-notes/docs-8-14-2025.mdx | 112 ++ .../docs-release-notes/docs-9-12-2025.mdx | 94 ++ .../new-relic-infrastructure-agent-1710.mdx | 15 + .../kubernetes-integration-3-48-0.mdx | 13 + .../flutter-agent-1116.mdx | 18 + .../browser-agent-v1.295.mdx | 39 + .../ping-runtime-1.54.mdx | 10 + .../vulnerability-management/overview.mdx | 2 +- .../create-your-own.mdx | 707 ++++++++++ .../managing-workflow.mdx | 164 +++ .../start-schedule.mdx | 237 ++++ .../use-a-template.mdx | 284 ++++ .../introduction-to-workflow.mdx | 148 ++ .../workflow-best-practices.mdx | 326 +++++ .../limitations-and-faq/workflow-limits.mdx | 201 +++ .../actions-catalog/actions-catalog.mdx | 41 + .../actions-catalog/communication.mdx | 704 ++++++++++ .../actions-catalog/http.mdx | 1103 +++++++++++++++ .../actions-catalog/new-relic.mdx | 1210 ++++++++++++++++ .../actions-catalog/others.mdx | 684 ++++++++++ .../create-destinations.mdx | 91 ++ .../set-up-aws-credentials.mdx | 465 +++++++ .../workflow-automation/troubleshooting.mdx | 386 ++++++ .../create-schedule.mdx | 33 + .../create-workflow-definition.mdx | 34 + .../definition-schema.mdx | 697 ++++++++++ .../delete-schedule.mdx | 44 + .../delete-workflow-definition.mdx | 32 + .../get-action-definitions.mdx | 158 +++ .../workflow-automation-apis/get-schedule.mdx | 29 + .../get-schedules.mdx | 41 + .../get-workflow-definition.mdx | 35 + .../get-workflow-definitions.mdx | 38 + .../signal-workflow-run.mdx | 75 + .../start-workflow-run.mdx | 35 + .../stop-workflow-run.mdx | 26 + .../update-workflow-definition.mdx | 30 + .../using-workflow-automation-api.mdx | 81 ++ .../validate-workflow-definition.mdx | 34 + .../workflow-run-info.mdx | 32 + .../workflow-automation/workflow-examples.mdx | 244 ++++ .../add-on-billing.mdx | 28 + .../data-ingest-billing.mdx | 354 +++++ .../notification-integrations.mdx | 12 +- ...ompatibility-requirements-nodejs-agent.mdx | 22 +- ...gent-requirements-supported-frameworks.mdx | 96 +- .../introdution.mdx | 6 +- .../transaction-workloads.mdx | 169 ++- .../advanced-session-replay.mdx | 162 +++ .../integrations-managed-policies.mdx | 2 +- .../no-data-appears-aws-integrations.mdx | 8 +- .../find-unusual-logs-log-patterns.mdx | 39 +- .../apm-monitoring/opentelemetry-apm-ui.mdx | 8 +- .../docs-release-notes/docs-10-25-2025.mdx | 71 + .../docs-release-notes/docs-8-01-2025.mdx | 99 ++ .../docs-release-notes/docs-8-08-2025.mdx | 60 + .../docs-release-notes/docs-8-14-2025.mdx | 112 ++ .../docs-release-notes/docs-8-21-2025.mdx | 56 + .../docs-release-notes/docs-9-12-2025.mdx | 94 ++ .../new-relic-infrastructure-agent-1710.mdx | 15 + .../kubernetes-integration-3-48-0.mdx | 13 + .../flutter-agent-1116.mdx | 18 + .../browser-agent-v1.295.mdx | 39 + .../browser-agent-v1.296.mdx | 34 + .../browser-agent-v1.297.mdx | 28 +- .../node-api-runtime-1.2.mdx | 7 +- .../node-browser-runtime-3.0.mdx | 10 +- .../ping-runtime-1.53.mdx | 10 + .../ping-runtime-1.54.mdx | 10 + .../vulnerability-management/overview.mdx | 2 +- .../create-your-own.mdx | 707 ++++++++++ .../managing-workflow.mdx | 164 +++ .../start-schedule.mdx | 237 ++++ .../use-a-template.mdx | 284 ++++ .../introduction-to-workflow.mdx | 148 ++ .../workflow-best-practices.mdx | 326 +++++ .../limitations-and-faq/workflow-limits.mdx | 201 +++ .../actions-catalog/actions-catalog.mdx | 41 + .../actions-catalog/communication.mdx | 704 ++++++++++ .../actions-catalog/http.mdx | 1103 +++++++++++++++ .../actions-catalog/new-relic.mdx | 1210 ++++++++++++++++ .../actions-catalog/others.mdx | 684 ++++++++++ .../create-destinations.mdx | 91 ++ .../set-up-aws-credentials.mdx | 465 +++++++ .../workflow-automation/troubleshooting.mdx | 386 ++++++ .../create-schedule.mdx | 33 + .../create-workflow-definition.mdx | 34 + .../definition-schema.mdx | 697 ++++++++++ .../delete-schedule.mdx | 44 + .../delete-workflow-definition.mdx | 32 + .../get-action-definitions.mdx | 158 +++ .../workflow-automation-apis/get-schedule.mdx | 29 + .../get-schedules.mdx | 41 + .../get-workflow-definition.mdx | 35 + .../get-workflow-definitions.mdx | 38 + .../signal-workflow-run.mdx | 75 + .../start-workflow-run.mdx | 35 + .../stop-workflow-run.mdx | 26 + .../update-workflow-definition.mdx | 30 + .../using-workflow-automation-api.mdx | 81 ++ .../validate-workflow-definition.mdx | 34 + .../workflow-run-info.mdx | 32 + .../workflow-automation/workflow-examples.mdx | 244 ++++ .../add-on-billing.mdx | 28 + .../data-ingest-billing.mdx | 354 +++++ .../notification-integrations.mdx | 12 +- ...ompatibility-requirements-nodejs-agent.mdx | 22 +- ...gent-requirements-supported-frameworks.mdx | 96 +- .../introdution.mdx | 6 +- .../transaction-workloads.mdx | 169 ++- .../advanced-session-replay.mdx | 162 +++ .../cci/configure-cci/general-setting.mdx | 10 +- .../integrations-managed-policies.mdx | 2 +- .../no-data-appears-aws-integrations.mdx | 8 +- .../find-unusual-logs-log-patterns.mdx | 41 +- .../apm-monitoring/opentelemetry-apm-ui.mdx | 8 +- .../docs-release-notes/docs-10-25-2025.mdx | 71 + .../docs-release-notes/docs-8-01-2025.mdx | 99 ++ .../docs-release-notes/docs-8-08-2025.mdx | 60 + .../docs-release-notes/docs-8-14-2025.mdx | 112 ++ .../docs-release-notes/docs-8-21-2025.mdx | 56 + .../docs-release-notes/docs-9-12-2025.mdx | 94 ++ .../new-relic-infrastructure-agent-1710.mdx | 15 + .../kubernetes-integration-3-48-0.mdx | 13 + .../flutter-agent-1116.mdx | 18 + .../browser-agent-v1.295.mdx | 39 + .../browser-agent-v1.296.mdx | 34 + .../browser-agent-v1.297.mdx | 28 +- .../node-api-runtime-1.2.mdx | 6 +- .../node-browser-runtime-3.0.mdx | 6 +- .../ping-runtime-1.53.mdx | 10 + .../ping-runtime-1.54.mdx | 10 + .../vulnerability-management/overview.mdx | 2 +- .../create-your-own.mdx | 707 ++++++++++ .../managing-workflow.mdx | 164 +++ .../start-schedule.mdx | 237 ++++ .../use-a-template.mdx | 284 ++++ .../introduction-to-workflow.mdx | 148 ++ .../workflow-best-practices.mdx | 326 +++++ .../limitations-and-faq/workflow-limits.mdx | 201 +++ .../actions-catalog/actions-catalog.mdx | 41 + .../actions-catalog/communication.mdx | 704 ++++++++++ .../actions-catalog/http.mdx | 1103 +++++++++++++++ .../actions-catalog/new-relic.mdx | 1212 +++++++++++++++++ .../actions-catalog/others.mdx | 684 ++++++++++ .../create-destinations.mdx | 91 ++ .../set-up-aws-credentials.mdx | 465 +++++++ .../workflow-automation/troubleshooting.mdx | 386 ++++++ .../create-schedule.mdx | 33 + .../create-workflow-definition.mdx | 34 + .../definition-schema.mdx | 697 ++++++++++ .../delete-schedule.mdx | 44 + .../delete-workflow-definition.mdx | 32 + .../get-action-definitions.mdx | 158 +++ .../workflow-automation-apis/get-schedule.mdx | 29 + .../get-schedules.mdx | 41 + .../get-workflow-definition.mdx | 35 + .../get-workflow-definitions.mdx | 38 + .../signal-workflow-run.mdx | 75 + .../start-workflow-run.mdx | 35 + .../stop-workflow-run.mdx | 26 + .../update-workflow-definition.mdx | 30 + .../using-workflow-automation-api.mdx | 81 ++ .../validate-workflow-definition.mdx | 34 + .../workflow-run-info.mdx | 32 + .../workflow-automation/workflow-examples.mdx | 244 ++++ 297 files changed, 48634 insertions(+), 836 deletions(-) create mode 100644 src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx create mode 100644 src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx create mode 100644 src/i18n/content/es/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx create mode 100644 src/i18n/content/es/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx create mode 100644 src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx create mode 100644 src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx create mode 100644 src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx create mode 100644 src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx create mode 100644 src/i18n/content/es/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx create mode 100644 src/i18n/content/es/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx create mode 100644 src/i18n/content/es/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx create mode 100644 src/i18n/content/es/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx create mode 100644 src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx create mode 100644 src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx create mode 100644 src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx create mode 100644 src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx create mode 100644 src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx create mode 100644 src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/introduction-to-workflow.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/setup-and-configuration/create-destinations.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/troubleshooting.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx create mode 100644 src/i18n/content/es/docs/workflow-automation/workflow-examples.mdx create mode 100644 src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx create mode 100644 src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx create mode 100644 src/i18n/content/fr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx create mode 100644 src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/introduction-to-workflow.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/troubleshooting.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx create mode 100644 src/i18n/content/fr/docs/workflow-automation/workflow-examples.mdx create mode 100644 src/i18n/content/jp/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx create mode 100644 src/i18n/content/jp/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/introduction-to-workflow.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/create-destinations.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/troubleshooting.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx create mode 100644 src/i18n/content/jp/docs/workflow-automation/workflow-examples.mdx create mode 100644 src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx create mode 100644 src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx create mode 100644 src/i18n/content/kr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx create mode 100644 src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/introduction-to-workflow.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/troubleshooting.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx create mode 100644 src/i18n/content/kr/docs/workflow-automation/workflow-examples.mdx create mode 100644 src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx create mode 100644 src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx create mode 100644 src/i18n/content/pt/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx create mode 100644 src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/introduction-to-workflow.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/create-destinations.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/troubleshooting.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx create mode 100644 src/i18n/content/pt/docs/workflow-automation/workflow-examples.mdx diff --git a/src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx b/src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx new file mode 100644 index 00000000000..8f3bfc6661b --- /dev/null +++ b/src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx @@ -0,0 +1,28 @@ +--- +title: Facturación adicional (opcional) +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: Add-ons are an optional billing factor +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +Además de los factores de facturación principales de GB Ingested y usuario facturable, también puedes usar complementos facturables opcionales para ampliar tu experiencia con New Relic. + +* **Advanced Compute (anteriormente Add-on Compute)**: este complemento se aplica a la facturación basada en el uso de las acciones que ejecuta relacionadas con CodeStream, Live Archives y otras funciones disponibles. Se le mide y factura en función de su uso de [CCU avanzadas](/docs/licenses/license-information/product-definitions/new-relic-one-pricing-definitions/#compute-capacity-unit). + + + Su uso de CodeStream bajo Calcular avanzado generará cargos de CCU, independientemente del tipo de usuario. Esto significa que el usuario básico gratis puede acceder a Calcular característica avanzada y generar cargos por CCU avanzadas. + + +* **EU Data Center for Original Data or Data Plus**: Este complemento se aplica a su opción de datos (Datos Originales o Datos Plus) cuando selecciona la Unión Europea como su región de datos, según disponibilidad. + +* **Extended Retention for Original Data or Data Plus**: este complemento se aplica si excede el tiempo predeterminado durante el cual se conservan sus datos. Esto se aplica a todos sus datos, no solo a los logs, y es una buena opción si necesita realizar muchas consultas pequeñas o consultas sobre grandes volúmenes de datos. + +* **Live Archives**: amplíe la duración del almacenamiento de logs hasta siete años. Live Archives también requiere Calcular avanzado. + +* **New Relic Synthetic Checks**: este complemento se aplica si tus controles exceden la cantidad predeterminada de controles de monitoreo sintético. + +* **Security RX**: Esta característica está incluida con Data Plus, pero el complemento aplica si usas la característica Security RX sin Data Plus. \ No newline at end of file diff --git a/src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx b/src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx new file mode 100644 index 00000000000..0871a750e10 --- /dev/null +++ b/src/i18n/content/es/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx @@ -0,0 +1,354 @@ +--- +title: 'Datos: Facturación y reglas' +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: 'For New Relic pricing, an explanation of how data ingest is calculated for billing purposes.' +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +Para los precios de New Relic, los datos ingeridos por su organización de New Relic son un factor de facturación. + +## Más información sobre los costos [#costs] + +Si aún no es cliente de New Relic y tiene curiosidad sobre los costos, primero consulte [nuestra página principal de precios](https://newrelic.com/pricing). Si ya es cliente, siga leyendo para conocer detalles sobre la facturación de la ingesta de datos. + +## Ver la ingesta de datos en la UI [#ui] + +Para saber cómo encontrar información de uso y facturación en la UI, consulte [UI de facturación](/docs/accounts/accounts-billing/general-account-settings/introduction-account-settings). + +Para saber cómo ver y administrar su ingesta de datos, consulte [Administrar la ingesta](/docs/data-apis/manage-data/manage-data-coming-new-relic). + +## Opciones de datos: Data Plus y original [#data-prices] + +El precio de su organización por GB de datos ingeridos varía según la opción de datos que tenga su organización: **Data Plus** o nuestra opción **Original Data** . La opción Data Plus ofrece capacidades de datos avanzadas para optimizar el rendimiento, la escala, la seguridad y la gobernanza. Una organización New Relic solo puede tener una opción a la vez. + +Aquí hay una tabla con comparaciones de las dos opciones. Los precios y límites son mensuales y los precios están en USD. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Característica/habilidad + + **Original Data** opción + + **Data Plus** opción + + Más detalles característicos +
+ [Ediciones](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#editions) + + Todas las ediciones + + Requiere Standard, Pro o Enterprise + + (Anotamos a continuación si una característica es específica de una edición) + +
+ Límite de datos libres + + 100 GB ingeridos + + 100 GB ingeridos + +
+ Precio de los datos
(más allá del límite libre) + 		+ $0,40/GB ingerido + + $0,60/GB ingerido + +
+ Límite gratuito de retención de datos
([varía según el tipo de datos](/docs/data-apis/manage-data/manage-data-retention)) + 		+ Incumplimiento de al menos 8 días + + 90 días adicionales sobre el incumplimiento + +
+ Precio por cada 30 días adicionales de retención
(más allá del límite gratuito) + 		+ +$0.05/GB + + +$0.05/GB + +
+ Precio adicional para almacenar datos en [el centro de datos de la UE](/docs/accounts/accounts-billing/account-setup/choose-your-data-center)
+ 		+ +$0.05/GB + + +$0.05/GB + + Los datos se almacenan en el centro de datos de EE. UU. de forma predeterminada. +
+ [Límite máximo de consultas](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-limits) + + Hasta 20 mil millones de puntos de datos por minuto + + Hasta 60 mil millones de puntos de datos por minuto + +
+ [Duración máxima de la consulta](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-duration) + + 1 minuto + + Hasta 10 minutos + +
+ Elección del proveedor de la nube + + Proveedor único de nube + + Azure o múltiples proveedores de nube + + Elija su proveedor de nube preferido para su carga de trabajo de observabilidad para alinear su almacenamiento de telemetría con su modelo de despliegue de ingeniería y preferencia de nube. +
+ [Ofuscación de logs](/docs/logs/ui-data/obfuscation-ui/) + + Enmascarar [automáticamente](/docs/logs/get-started/new-relics-log-management-security-privacy/#log-obfuscation) patrones conocidos de tarjetas de crédito y números de Seguro Social en los logs. + + Cree y realice un seguimiento de reglas directamente en laUI y [enmascarar o aplicar hash](/docs/logs/ui-data/obfuscation-ui/) a datos log sensibles. + +
+ [New Relic Gestión de vulnerabilidades](/docs/vulnerability-management/overview)
(solo usuario de plataforma completa) + 		+ +$0.10/GB
(más allá del límite gratuito) + 		+ Standard, Pro, y Enterprise + + Identifique vulnerabilidades y aborde los riesgos en cada etapa del ciclo de vida del software. +
+ Elegibilidad [FedRAMP Moderate](/docs/security/security-privacy/compliance/fedramp-compliant-endpoints) y [HIPAA](/docs/security/security-privacy/compliance/hipaa-readiness-new-relic) + + + + Empresa + + Logre el cumplimiento de la seguridad a través de configuraciones que lo ayuden a cumplir con los requisitos de FedRAMP e HIPAA. +
+ [Exportación de streaming de datos](/docs/apis/nerdgraph/examples/nerdgraph-streaming-export) + + + + Standard, Pro, y Enterprise + + Configure reglas para exportar simultáneamente telemetry data al almacenamiento de AWS o Azure de su elección. Se aplicarán tarifas de exportación adicionales al proveedor de la nube. +
+ [Exportación de datos históricos](/docs/apis/nerdgraph/examples/nerdgraph-historical-data-export) + + + + Standard, Pro, y Enterprise + + Ejecute consultas más amplias sin tiempo de espera para análisis y modelado históricos, almacenamiento a largo plazo e integración con otras plataformas de análisis de datos. +
+ Servicio New Relic nativa de Azure + + + + Standard, Pro, y Enterprise
([con algunas limitaciones](#azure-native-data-plus)) + 		+
+ +Para ver una comparación lado a lado de Data Plus y nuestra opción de datos original, consulte [nuestra hoja de datos de Data Plus](https://newrelic.com/resources/datasheets/data-plus). + +¿Interesado en Datos Plus? Consulte [Actualizar a Data Plus](#upgrade-data-plus). + +### Detalles del servicio Azure Native New Relic [#azure-native-data-plus] + +Con el [servicio Azure Native New Relic](/docs/infrastructure/microsoft-azure-integrations/get-started/azure-native), puede recopilar y almacenar sus telemetry data para aplicaciones e infraestructura directamente en Azure. Esta característica está incluida con Data Plus, pero con estas limitaciones: + +* Disponible solo en la región del centro de datos de EE. UU. +* Elegibilidad para FedRAMP Moderado/HIPAA no disponible +* Exportación de datos históricos no disponible + +## Actualice a Datos Plus [#upgrade-data-plus] + +Para actualizar a Data Plus, vaya a la [UI**Data retention** ](/docs/data-apis/manage-data/manage-data-retention/#adjust-retention)en el centro de administración de datos y haga clic en **Upgrade retention**. + +* Nota: Es posible que veas un botón **Edit data retention**, pero es diferente del botón **Upgrade retention**. +* Para ver el botón **Upgrade retention** , debes tener [permisos de facturación](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts/#admin-settings). Si cumple con los requisitos y aún no ve la opción **Upgrade retention** , hable con su representante de cuenta de New Relic. + +## ¿Qué se considera GB ingeridos facturables? [#usage-calculation] + +En el contexto del [plan de precios de New Relic](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing), "datos ingeridos" se refiere a los datos guardados en New Relic por su organización después de que aplicamos varias reglas de recorte y transformación de datos. En otras palabras, no es la cantidad de datos sin procesar enviados a New Relic, sino el tamaño de los datos que realmente terminan almacenándose. + +En general, los datos que generamos para proporcionar nuestra función no cuentan para sus GB ingeridos. Algunos ejemplos de datos de características y relacionados con ellas que no cuentan para GB ingeridos incluyen: + +* [Funcionalidad de alerta básica](/docs/alerts-applied-intelligence/new-relic-alerts/learn-alerts/alerts-concepts-workflow). Por ejemplo, `NrAiIncident`, un evento empleado para generar estas características, no cuenta para los GB ingeridos. +* Datos creados a partir de datos brutos agregados (por ejemplo, [datos de infraestructura agregados](/docs/data-apis/manage-data/manage-data-retention/#infrastructure-data) o [datos métricos dimensionales](/data-apis/manage-data/manage-data-retention/#dimensional-metrics)). +* [Métricas doradas](/docs/apis/nerdgraph/examples/golden-metrics-entities-nerdgraph-api-tutorial) (para más información sobre métricas doradas, consulte nuestras [definiciones de entidad](https://github.com/newrelic/entity-definitions)). +* Check de monitoreo sintético. Para obtener detalles sobre la facturación de Sintético, consulte [Límites y precios de Sintético](/docs/synthetics/synthetic-monitoring/using-monitors/monitor-limits). +* Datos de seguimiento de uso y facturación (por ejemplo, `NrConsumption`). +* Datos relacionados con la administración de la cuenta (por ejemplo, `NrIntegrationError`, `NrAuditEvent`). + +Para comprender su uso, consulte la [UI de uso](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing#usage-ui). + +## Otros detalles de cálculo [#calculation-details] + +* En el contexto de nuestro modelo de precios, un GB se define como mil millones de bytes. +* Los GB ingeridos mensualmente se redondean al número entero más cercano. Por ejemplo, si su organización emplea 100,9 GB durante un mes, eso se cuenta como 100 GB. + +## Edición gratuita [#free-tier-limits] + +Para obtener detalles sobre GB Ingested para nuestra edición gratis, consulte [Edición gratis](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#free). + +## Aprende más [#related-docs] + +* Para obtener más información sobre cómo gestionar GB ingeridos, consulte [Gestionar la ingesta de datos](/docs/data-apis/manage-data/manage-data-coming-new-relic). +* Para saber cómo consultar el uso, consulte [consulta y alerta de uso](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/usage-queries-alerts). \ No newline at end of file diff --git a/src/i18n/content/es/docs/alerts/get-notified/notification-integrations.mdx b/src/i18n/content/es/docs/alerts/get-notified/notification-integrations.mdx index d57ab672e9e..25495d54a91 100644 --- a/src/i18n/content/es/docs/alerts/get-notified/notification-integrations.mdx +++ b/src/i18n/content/es/docs/alerts/get-notified/notification-integrations.mdx @@ -179,13 +179,13 @@ Lea más sobre cada una de nuestras notificaciones específicas de integración. * Si una dirección de email ya está asociada a un destino existente, será un símbolo el que podrá fusionarlos. Seleccione **Merge** para combinar destinos. * Si agregó una nueva dirección de email, el destinatario recibirá un email de verificación. El destinatario deberá completar el proceso de verificación para comenzar a recibir notificaciones. - - Límites de destino del email: + + Límites de destino del email: - * **Cuentas gratis**: Cada destino puede tener un máximo de 5 direcciones de email. - * **Cuentas de pago**: cada destino puede tener un máximo de 150 direcciones de email. - * **Límite de organización**: se pueden agregar 1000 direcciones de email únicas por organización de clientes cada 24 horas (se aplica a todos los usuarios). - + * **Cuentas gratis**: Cada destino puede tener un máximo de 5 direcciones de email. + * **Cuentas de pago**: cada destino puede tener un máximo de 150 direcciones de email. + * **Límite de organización**: se pueden agregar 1000 direcciones de email únicas por organización de clientes cada 24 horas (se aplica a todos los usuarios). + 10. Personaliza el mensaje de correo electrónico. diff --git a/src/i18n/content/es/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx b/src/i18n/content/es/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx index a7f51ee26e9..6c4f9cc4c62 100644 --- a/src/i18n/content/es/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx +++ b/src/i18n/content/es/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx @@ -268,21 +268,21 @@ Luego de la instalación, el agente se instrumenta automáticamente con nuestro | Nombre del paquete | Versión mínima admitida | Última versión publicada | Introducido en\* | | --------------------------------- | ----------------------- | ------------------------ | -------------------------------------- | | `@apollo/gateway` | 2.3.0 | 2.11.3 | `@newrelic/apollo-server-plugin@1.0.0` | -| `@apollo/server` | 4.0.0 | 5.0.0 | `@newrelic/apollo-server-plugin@2.1.0` | -| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.914.0 | 11.13.0 | -| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/client-sns` | 3.0.0 | 3.915.0 | 8.7.1 | -| `@aws-sdk/client-sqs` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.914.0 | 8.7.1 | +| `@apollo/server` | 4.0.0 | 5.1.0 | `@newrelic/apollo-server-plugin@2.1.0` | +| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.918.0 | 11.13.0 | +| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sns` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sqs` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.918.0 | 8.7.1 | | `@aws-sdk/smithy-client` | 3.47.0 | 3.374.0 | 8.7.1 | | `@azure/functions` | 4.7.0 | 4.8.0 | 12.18.0 | | `@elastic/elasticsearch` | 7.16.0 | 9.2.0 | 11.9.0 | -| `@google/genai` | 1.1.0 | 1.26.0 | 12.21.0 | +| `@google/genai` | 1.1.0 | 1.27.0 | 12.21.0 | | `@grpc/grpc-js` | 1.4.0 | 1.14.0 | 8.17.0 | | `@hapi/hapi` | 20.1.2 | 21.4.3 | 9.0.0 | | `@koa/router` | 12.0.1 | 14.0.0 | 3.2.0 | -| `@langchain/core` | 0.1.17 | 1.0.1 | 11.13.0 | -| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.1 | 13.2.0 | +| `@langchain/core` | 0.1.17 | 1.0.2 | 11.13.0 | +| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.2 | 13.2.0 | | `@nestjs/cli` | 9.0.0 | 11.0.10 | 10.1.0 | | `@opensearch-project/opensearch` | 2.1.0 | 3.5.1 | 12.10.0 | | `@prisma/client` | 5.0.0 | 6.18.0 | 11.0.0 | @@ -298,7 +298,7 @@ Luego de la instalación, el agente se instrumenta automáticamente con nuestro | `generic-pool` | 3.0.0 | 3.9.0 | 0.9.0 | | `ioredis` | 4.0.0 | 5.8.2 | 1.26.2 | | `kafkajs` | 2.0.0 | 2.2.4 | 11.19.0 | -| `koa` | 2.0.0 | 3.0.3 | 3.2.0 | +| `koa` | 2.0.0 | 3.1.1 | 3.2.0 | | `koa-route` | 3.0.0 | 4.0.1 | 3.2.0 | | `koa-router` | 12.0.1 | 14.0.0 | 3.2.0 | | `memcached` | 2.2.0 | 2.2.2 | 1.26.2 | @@ -306,7 +306,7 @@ Luego de la instalación, el agente se instrumenta automáticamente con nuestro | `mysql` | 2.16.0 | 2.18.1 | 1.32.0 | | `mysql2` | 2.0.0 | 3.15.3 | 1.32.0 | | `next` | 13.4.19 | 16.0.0 | 12.0.0 | -| `openai` | 4.0.0 | 6.6.0 | 11.13.0 | +| `openai` | 4.0.0 | 6.7.0 | 11.13.0 | | `pg` | 8.2.0 | 8.16.3 | 9.0.0 | | `pg-native` | 3.0.0 | 3.5.2 | 9.0.0 | | `pino` | 8.0.0 | 10.1.0 | 8.11.0 | diff --git a/src/i18n/content/es/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx b/src/i18n/content/es/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx index 9dce968cbaa..3b04e91e2d9 100644 --- a/src/i18n/content/es/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx +++ b/src/i18n/content/es/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx @@ -998,6 +998,68 @@ New Relic está ampliando su soporte para biblioteca AI/ML. +## Biblioteca de registro + +El agente puede reenviar registros de las siguientes bibliotecas para [los logs APM en contexto](/docs/logs/logs-context/get-started-logs-context/). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Biblioteca** + + **Nombre de la gema** + + **Soportado** + + **Notas** +
+ **Logger** + + `logger` + + + + Soporte para reenvío de logs APM empleando la biblioteca de de Logger de Rubyy cualquier biblioteca de logging que herede del Logger de Ruby, como ActiveSupport::BroadcastLogger. +
+ **Logstaher** + + `logstasher` + + 1.xx y superiores + + Soporte para reenvío de logs de APM. +
+ ## Otras bibliotecas y tecnologías [#other\_libraries][#other_libraries] @@ -1134,40 +1196,6 @@ New Relic está ampliando su soporte para biblioteca AI/ML. - - - - - - - - - - - - - - - - - -
- **Logger** - - `logger` - - - - Soporte para reenvío de logs de APM usando la biblioteca de Logger de Ruby. -
- **Logstaher** - - `logstasher` - - 1.xx y superiores - - Soporte para reenvío de logs de APM. -
**Raya** diff --git a/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/introdution.mdx b/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/introdution.mdx index f3841811eff..f5cacd82e29 100644 --- a/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/introdution.mdx +++ b/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/introdution.mdx @@ -20,6 +20,8 @@ Las características clave de Transaction 360 incluyen: * **Descubrimiento automático**: mapeo dinámico de relaciones de servicio y visualización del flujo de transacciones en tiempo real. * **Visibilidad integral**: monitoreo de todo el stack, seguimiento de transacciones entre servicios e infraestructura para visibilidad del browser. +* **Monitoreo de base de datos**: información valiosa y profunda sobre el rendimiento de la base de datos, análisis de consultas y estado de la conexión en toda su transacción de carga de trabajo. +* **Seguimiento de función sin servidor**: visibilidad completa del rendimiento sin servidor de función, arranques en frío y utilización de recursos. * **Análisis histórico**: acceso a semanas de datos históricos, lo que permite el análisis de tendencias y el reconocimiento de patrones. @@ -33,5 +35,7 @@ Para comenzar a emplear Transacción 360, debe habilitar el rastreo distribuido ## Que sigue - Aprenda a emplear Transaction 360 para solucionar problemas de rendimiento de aplicaciones + + Aprenda a emplear Transacción 360 para cuestiones de rendimiento de la aplicación, incluida la base de datos y el monitoreo sin servidor. + \ No newline at end of file diff --git a/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx b/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx index a53c64cb789..bbc66c3bdf2 100644 --- a/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx +++ b/src/i18n/content/es/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx @@ -3,88 +3,173 @@ title: Resolución rápida de problemas con Transaction 360 tags: - transaction workloads - dynamic workload monitoring -metaDescription: Learn about the detailed page breakdown in New Relic's Transaction 360 feature. +metaDescription: Learn how Transaction 360 provides comprehensive workload visibility for faster troubleshooting and performance optimization. freshnessValidatedDate: never translationType: machine --- -Cuando surgen problemas de rendimiento de la aplicación, es fundamental tener un enfoque sistemático para identificar y resolver la causa raíz. Esta guía lo guiará para ver los problemas de rendimiento de la aplicación mediante Transaction 360. +Transacción 360 captura y correlaciona automáticamente todas las entidades y datos relacionados con una transacción específica, brindando una vista integral de su carga de trabajo distribuida. Este enfoque holístico incluye flujos de transacciones, relaciones de servicio y métricas de rendimiento en toda su stack, lo que le permite identificar y resolver problemas rápidamente. -Dado que Transaction 360 captura y correlaciona automáticamente todas las entidades y datos relacionados con un problema o pregunta específicos, proporciona una visión integral de la carga de trabajo. Esta vista incluye el flujo de transacciones, las relaciones de servicio y el rendimiento métrico, lo que le permite identificar y resolver problemas rápidamente. +## Lo que te muestra Transacción 360 -## Vaya a la vista Transacción 360 +Transacción 360 proporciona tres vistas principales para ayudarlo a comprender su carga de trabajo: -Para acceder a la vista de carga de trabajo de la transacción, siga estos pasos: +* **Dashboard descripción general**: resumen de alto nivel con recuentos de entidades, problemas y seguimiento de cambios +* **Mapa de flujo dinámico**: representación visual de rutas de transacción y dependencia del servicio. +* **Desglose de entidad**: Rendimiento métrico detallado para todos los componentes participantes. -1. Vaya a **[one.newrelic.com](https://one.newrelic.com)> APM and Services**. -2. Desde la página de resumen de APM, haga clic en **Transactions > Transaction Details > View transaction 360 workload**. +## Acceso Transacción 360 -La vista Transacción 360 proporciona un desglose detallado de la carga de trabajo de la transacción, incluidos los siguientes componentes: +1. Visite **[one.newrelic.com](https://one.newrelic.com) > APM and Services** +2. Seleccione su servicio en la página de resumen de APM. +3. Ir a **Transactions > Transaction Details > View transaction 360 workload** -* **Descripción general de Transaction 360**: muestra el resumen de carga de trabajo de la transacción, incluido el número de entidades involucradas, alertas y seguimiento de cambios. + + Las secciones base de datos y monitoreo sin servidor están actualmente disponibles en entornos de prueba. Cerciorar de tener las licencias de cuenta adecuados y la instrumentación apropiada para acceder a estas características. + -* **Mapa de flujo dinámico**: visualiza el flujo de transacciones, mostrando los servicios involucrados y el tiempo que toma cada servicio. +## Mapa de flujo dinámico -* **Entidad participante**: Enumera los servicios involucrados en la transacción carga de trabajo, junto con su rendimiento métrico. + -## Descripción general de Transaction 360 +El mapa de flujo visualiza el recorrido de su transacción a través de sus sistemas distribuidos: -transaction-360-overview.webp +* **Conexiones de servicio**: Vea cómo se comunican los servicios y la dependencia entre ellos. +* **Rendimiento bottlenecks**: Identificar componentes lentos que afectan el tiempo general de transacción +* **Relaciones de traza**: Haga clic en los pares de servicios para ver las métricas de traza detalladas entre ellos. -La sección Descripción general de Transaction 360 proporciona el siguiente resumen de alto nivel de la carga de trabajo de transacciones asociadas: +### Características de colaboración -* **Entidad dependiente:** El número total de entidades involucradas en la transacción carga de trabajo que proporciona información valiosa, como el número de entidades instrumentadas y no instrumentadas, y el número de entidades con alertas. Además, puede hacer clic en la entidad instrumentada para ver su rendimiento métrico detallado y los servicios relacionados. También puede hacer clic en la entidad no instrumentada para ver la lista de entidades que no están instrumentadas, lo que le permitirá identificar la entidad que requiere instrumentación. De manera similar, puede hacer clic en la entidad con alertas para ver la lista de entidades con alertas, lo que le permitirá priorizar su investigación según la gravedad de las alertas. +* **Asignación de equipo**: Asigne equipos a la transacción carga de trabajo para una respuesta más rápida a los incidentes. +* **Tagging**: Entidad relacionada con el grupo para agilizar la investigación y organización -* **Problemas:** la cantidad de problemas detectados en la carga de trabajo de la transacción, incluidas las alertas y los marcadores de seguimiento de cambios. Haga clic en **View details** para ver la lista de problemas e identificar las entidades directamente afectadas por los problemas de rendimiento. +## desglose del rendimiento de la entidad -* **Seguimiento de cambios:** El número de marcadores de seguimiento de cambios detectados en la transacción carga de trabajo, que indican cambios en el rendimiento de la carga de trabajo. Haga clic en **View details** para ver los marcadores de seguimiento de cambios e identificar las entidades que se ven directamente afectadas por los cambios de rendimiento. +Esta sección proporciona métricas detalladas para cada tipo de componente en su transacción carga de trabajo: -## Mapa de flujo dinámico +### Servicios de APM -El mapa de Flujo Dinámico visualiza el flujo de transacciones, mostrando los servicios involucrados y el tiempo que toma cada servicio. El mapa proporciona una descripción general de alto nivel de la transacción carga de trabajo, lo que le permite identificar problemas de cuello de botella y rendimiento. + -dynamic-map.webp +Monitorear los servicios de su aplicación con: -Puedes seleccionar servicios relacionados para ver el seguimiento métrico entre ellos. Además, también puede asignar un equipo a la carga de trabajo de transacción para facilitar la colaboración y la resolución de problemas, o agrupar entidades relacionadas mediante etiquetas para agilizar el proceso de investigación. +**Tabla métrica de servicio:** -El mapa de flujo dinámico lo ayuda a identificar los servicios que se ven directamente afectados por problemas de rendimiento, lo que le permite centrar su investigación en la causa raíz. +* **Rendimiento**: Solicitudes por minuto para cada servicio +* **Tasa de errores**: Porcentaje de requestsfallidas +* **Tiempo de respuesta**: Latencia media por servicio +* **Gravedad del problema**: Crítico, advertencia y alertas informativas para priorizar las correcciones. -## Entidad participante y de apoyo +**análisis:** -### Entidad APM +* **Cambios en el rendimiento**: Transacciones con los mayores cambios en el tiempo de respuesta +* **Detalles de la traza**: Haga clic en cualquier transacción para ver su flujo de traza completo -La sección de entidad participante proporciona un desglose detallado de los servicios involucrados en la transacción de carga de trabajo, tales como servicios APM , aplicaciones de browser, aplicación móvil, función serverless o infraestructura de entidad. +### entidad de infraestructura -partcipating-services.webp + -* **Rendimiento métrico:** La tabla de servicios APM muestra el rendimiento métrico de cada servicio, incluido el rendimiento, la tasa de errores, la latencia y los problemas con niveles de gravedad, como crítico, advertencia e información, para priorizar su investigación. +Ver rendimiento de infraestructura para hosts, contenedor y clúster de Kubernetes: -* **Tabla de transacciones:** también puede emplear la tabla de Transacciones para identificar las transacciones con el mayor porcentaje de cambio en el tiempo de respuesta, lo que le permitirá centrar su investigación en las transacciones más afectadas. Además, puede seleccionar una transacción específica para ver su traza de flujo y rendimiento métrico. +**Recurso métrico:** -### entidad de infraestructura +* **Uso de CPU**: Utilización del procesador en toda la infraestructura +* **Consumo de memoria**: Uso de RAM y posibles limitaciones +* **I/O de disco**: rendimiento de almacenamiento y cuello de botella +* **Actividad de la red**: Velocidades de transferencia de datos y problemas de red + +**Análisis del host:** + +* **Clasificación de recursos**: Identifica los hosts con mayor consumo de recursos. +* **Servicios relacionados**: Consulta qué aplicaciones se ejecutan en cada host + +### Aplicación Browser + + + +Monitorear el rendimiento del frontend y la experiencia del usuario: + +**Métrica de rendimiento:** + +* **Tiempo de carga de la página**: Rendimiento de carga y renderizado frontend +* **Errores de JavaScript**: Errores del lado del cliente que afectan la experiencia del usuario +* **Visualizaciones de página**: Patrones Traffic e interacción del usuario + +**herramientas de experiencia del usuario:** + +* **Repetición de la sesión**: observe las sesiones de los usuarios para comprender el impacto del rendimiento en el usuario real +* Haz clic en las sesiones para ver datos detallados de interacción del usuario. +* Para obtener más detalles, consulte [la documentación Session Replay.](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/) + +### Monitoreo de bases de datos + +Realice un seguimiento del rendimiento de la base de datos con métricas integrales: + +**Visualización del rendimiento:** + +* **Gráfico de rendimiento**: Operaciones de base de datos por minuto a lo largo del tiempo +* **Gráfico de tiempos de consulta**: tendencias de tiempo de respuesta y patrones de rendimiento + +**Tabla de análisis de consulta:** + +* **Operaciones de base de datos**: recuento de llamadas, duración y sincronización métrica por consulta +* **Clasificación de rendimiento**: tiempos de ejecución máximo, medio y total. +* **Optimización de consultas**: Identificar las consultas más lentas y frecuentes. + +**tabla de impacto:** + +* **Dependencia de la base de datos**: Muestra qué transacciones dependen más de las operaciones de base de datos. +* **Asignación de tiempo**: Porcentaje del tiempo de transacción dedicado a las llamadas a la base de datos. +* **Objetivo de optimización**: Transacciones con la mayor sobrecarga de datos base. + +**Análisis interactivo en detalle:** + +* Haz clic en «Recuento de consultas» para ver todas las consultas empleadas por una transacción específica. +* Haga clic en los nombres de las transacciones para filtrar la consulta por esa transacción. +* Acceda a la ruta del stack a través de los detalles de consulta individual + +### función sin servidor + +Monitorear AWS Lambda y otros componentes sin servidor: + +**Gráficos de rendimiento personalizables:** + +* **Patrones de invocación**: Frecuencia de ejecución de la función a lo largo del tiempo +* **Métrica de duración**: Tiempos de ejecución y tendencias de rendimiento +* **Utilización de memoria**: Patrones de consumo de recursos +* **Seguimiento de costos**: Gastos asociados a las invocaciones de funciones -Si instrumentó su entidad de infraestructura, puede ver el rendimiento métrico de su entidad de infraestructura en la vista Transaction 360. La sección de infraestructura proporciona un desglose detallado de la entidad de infraestructura involucrada en la transacción carga de trabajo, como hosts, contenedor y clúster de Kubernetes. +**Análisis funcional:** -infrastructure-entities.webp +* **Relaciones de transacciones**: vea qué transacciones activan la función serverless +* **Impacto en el rendimiento**: cómo el rendimiento de la función afecta la velocidad general de la transacción. +* **Eficiencia de los recursos**: Asignación de memoria frente al uso real -* **rendimiento métrico:** La tabla de entidad de infraestructura muestra el rendimiento métrico para cada entidad, incluido el uso de CPU, uso de memoria, I/O de disco y I/O de red, para identificar el rendimiento cuello de botella y las limitaciones de recursos. +### aplicación móvil -* **Tabla de hosts:** también puede emplear la tabla de hosts para encontrar la lista de entidades de infraestructura e identificar los hosts con el mayor uso de CPU, uso de memoria, I/O de disco y I/O de red, lo que le permite centrar su investigación en los hosts más afectados. Además, puede seleccionar un host específico para ver su rendimiento métrico y servicios relacionados. +Realice un seguimiento del rendimiento de la aplicación móvil dentro de su flujo de transacciones: -### Entidad Browser +* **Rendimiento de la aplicación**: tiempo de respuesta y experiencia del usuario métrica. +* **Tasa de fallas**: Rastreo de errores específico para dispositivos móviles +* **Métrica de dispositivo**: rendimiento en diferentes dispositivos móviles -Si instrumentó la aplicación de su browser, puede ver el rendimiento métrico de la entidad de su browser en la vista Transaction 360. La sección de entidad del browser proporciona un desglose detallado de la aplicación del browser involucrada en la transacción carga de trabajo. +### Monitoreo de IA/LLM -browser-entities.webp +Monitorear el rendimiento y costos del modelo de lenguaje extenso: -* **Rendimiento métrico:** La tabla de entidades Browser muestra el rendimiento métrico de cada entidad, incluido el tiempo de carga de la página, las visitas a la página y los errores de JavaScript, para identificar el rendimiento del cuello de botella y los problemas de experiencia del usuario. +* **Rendimiento del modelo**: tiempo de respuesta y precisión métrica para servicios de IA +* **Seguimiento de costos**: uso de tokens y costos asociados +* **Tasa de errores**: Fallos en requests IA y problemas de tiempo de espera -* **Reproducción de sesión:** también puede emplear la característica Reproducción de sesión para reproducir sesiones de usuario e identificar interacciones de usuario que conducen a problemas de rendimiento. Además, puede seleccionar una sesión específica para ver su rendimiento métrico y servicios relacionados. Para obtener más información, consulte [Session Replay](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/). +Para obtener una configuración detallada del monitoreo de IA, consulte [la documentación de monitoreo de IA](/docs/ai-monitoring/intro-to-ai-monitoring/). -### Entidad móvil +## Próximos pasos -Si instrumentó su aplicación móvil, puede ver el rendimiento métrico de su entidad móvil en la vista Transaction 360. La sección de entidad móvil proporciona un desglose detallado de la aplicación móvil involucrada en la transacción carga de trabajo. +Luego de identificar problemas en Transacción 360: -### Monitoreo de IA +1. **Priorizar las correcciones**: Empezar por las alertas críticas y los problemas de rendimiento de mayor impacto. +2. **Brechas de instrumentos**: agregue monitoreo a entidades no instrumentadas para una visibilidad completa. +3. **Configurar monitoreo proactivo**: Crear alertas para transacción clave rendimiento umbral +4. **Colaborar**: Emplear las asignaciones de equipo y las etiquetas para coordinar los esfuerzos de resolución. -Si su aplicación realiza llamadas a un modelo de lenguaje extenso (LLM) y está instrumentada con el agente APM, puede ver el rendimiento métrico de su entidad AI en la vista de Transaction 360. La sección AI entidad proporciona un desglose detallado del modelo de IA involucrado en la transacción carga de trabajo. Para obtener más información, consulte [monitoreo de IA](/docs/ai-monitoring/intro-to-ai-monitoring/). \ No newline at end of file +Transacción 360 le proporciona la visión integral que necesita para comprender, diagnosticar y resolver rápidamente problemas en toda su carga de trabajo distribuida. \ No newline at end of file diff --git a/src/i18n/content/es/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx b/src/i18n/content/es/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx new file mode 100644 index 00000000000..9dc15a684ef --- /dev/null +++ b/src/i18n/content/es/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx @@ -0,0 +1,162 @@ +--- +title: Característica de repetición de sesión avanzada +metaDescription: Manage session replay & modify capabilities depending on the role +freshnessValidatedDate: '2024-12-19T00:00:00.000Z' +redirect: + - /docs/browser/browser-monitoring/browser-pro-features/session-replay/sequence-filtering +translationType: machine +--- + +Este documento proporciona información sobre cómo puede emplear Session Replay para realizar análisis en profundidad que permitan investigar y comprender de forma eficiente el comportamiento del usuario. Ahora puedes aprovechar New Relic AI para resumir automáticamente la traza de evento de Session Replay, usar el filtrado de secuencias para identificar repeticiones con patrones de interacción de usuario específicos y recortar grabaciones para centrarte en la parte más relevante de una sesión y compartirla con el equipo o la persona responsable. + +## Resumen de New Relic AI [#new-relic-ai] + +Puede emplear New Relic AI (NRAI) para ayudarlo a resumir y mapear los datos de seguimiento de eventos de Session Replay para que pueda comprender mejor los errores y éxitos del recorrido browser de su usuario. + +Para emplear NRAI para resumir los datos de Session Replay, debes tener [NRAI habilitado](/docs/agentic-ai/new-relic-ai/#enable) para tu cuenta. Una vez que NRAI esté habilitado en su cuenta, realice lo siguiente para que aparezca su resumen: + +1. Vaya a **[one.newrelic.com > All Capabilities](https://one.newrelic.com/all-capabilities) > Browser**. + +2. Seleccione la aplicación de su browser . + +3. En el menú de la izquierda, desplácese hacia abajo y haga clic en **Session replay**. + +4. Haga clic en la repetición para ver los detalles de la sesión que desea resumir. + + screenshot of the session replay page in browser + +5. Haga clic en **Summarize**. Se genera un resumen de la sesión en el panel de enfoque. + + screenshot of the session replay page in browser + +## Filtrado de secuencias [#sequence-filtering] + +La función **de filtrado de secuencia** lo ayuda a filtrar la reproducción de sesión en función de una secuencia específica de eventos registrados durante la interacción del usuario. Esta funcionalidad está diseñada para ayudarlo a navegar de manera eficiente a través de numerosas grabaciones de sesiones en la página de **Session Listing** , lo que facilita la búsqueda de repeticiones relevantes. + +### Característica clave + +* **Filtrado de secuencia de eventos**: puede filtrar repeticiones especificando una secuencia de eventos en un orden particular, como cuando un usuario realiza una búsqueda y luego agrega un artículo a su carrito. +* **Filtros personalizables**: puede seleccionar atributos, operadores y valores para definir sus filtros de secuencia. +* **Admite múltiples acciones**: puede especificar hasta cinco acciones en una secuencia. +* **Filtrado flexible**: los filtros se pueden aplicar en cualquier orden, lo que permite combinar filtros de secuencia con otros tipos de filtros, como la duración. + +### Personalizar la vista + +De forma predeterminada, la **Sequence** se establece en **All**. Puede personalizar la vista seleccionando el filtro **Sequence = All** y haciendo clic en el cuadro de diálogo **Set up a filtering sequence** para definir sus filtros de secuencia. + +1. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**. +2. Seleccione el filtro **Sequence = All** , aparece la opción **Set up a filtering sequence** . +3. La opción **Set up a filtering sequence** le permite crear un filtro de secuencia especificando hasta 5 acciones en un orden particular. Puede definir la secuencia seleccionando el siguiente atributo: + + + Debes agregar al menos dos pasos al formulario de filtro. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Acción + + Descripción +
+ Atributo + + Seleccione un atributo: + + * **URL vista**: Filtra los datos en función de la URL de la página vista por el usuario. + + * **Acción de la página**: filtrar los datos en función de la interacción del usuario con la página. + + * **Entrada de teclado**: filtra los datos según la entrada del teclado del usuario. Puede ampliar aún más la búsqueda seleccionando las siguientes opciones: + + * **Objetivo**: Selecciona el elemento de destino donde se realizó la entrada del teclado. + * **ID del objetivo**: Seleccione el ID del objetivo donde se realizó la entrada del teclado. + * **Clase objetivo**: Seleccione la clase objetivo donde se realizó la entrada del teclado. + + * **Clics del usuario**: filtra los datos en función de los clics del usuario. +
+ Operador + + Seleccione un operador de las siguientes opciones: + + * **=**: Donde el valor proporcionado es igual al valor del atributo del incidente. + * **Como**: Donde el valor proporcionado es similar al valor del atributo del incidente. +
+ Valor + + Busque o ingrese un valor. +
+ +4. Haga clic en **Apply**. + + Screenshot of session replay details + +## Repetición de la sesión recortada [#trimmed-session-replay] + +La función de **Trimmed session replay** \[reproducción de sesión recortada] le permite extraer y compartir segmentos específicos de las grabaciones de sesión, centrar en los eventos relevantes para un análisis objetivo y una resolución de problemas más rápida. En lugar de compartir grabaciones largas y completas, puedes crear clips específicos que destaquen los momentos exactos en que ocurren los problemas. + +### Crea una repetición de sesión recortada + +1. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**. + +2. Seleccione la repetición de la sesión que desea recortar. + +3. Haz clic en **Share a clip** en los controles de reproducción de sesión. + +4. Seleccione los límites de su clip empleando los controles de la línea de tiempo: + + * Arrastra la flecha izquierda para establecer la hora de inicio de tu clip. + * Arrastra la flecha derecha para establecer el tiempo final de tu clip. + +5. Complete el formulario de detalles del clip: + + * Elija cuánto tiempo debe permanecer activo el enlace del clip empleando el menú desplegable **Availability**. + * Agrega un mensaje (opcional): proporciona contexto sobre lo que muestra el video. + * Agrega direcciones de email para compartir el clip directamente con miembros específicos del equipo. + +6. Revise su selección. La sección resaltada muestra lo que se incluirá en su video. + +7. Haz clic en **Share this clip** para generar tu segmento recortado. + +### Acceso a clips compartidos + +Cuando recibes una repetición de sesión recortada de un miembro del equipo: + +1. **Mediante notificación por email**: Si fuiste agregado como destinatario, recibirás un email con el enlace del video y cualquier mensaje proporcionado por el remitente. +2. **A través de la URL compartida**: Haga clic en el enlace compartido del panel de discusión para abrir la grabación de la sesión recortada en su navegador. + + + En Safari, la URL compartida no se puede copiar automáticamente. Deberás copiar manualmente el enlace generado y compartirlo con los destinatarios. + + +3. **Ver el video**: El video se reproduce automáticamente y muestra solo el segmento seleccionado, junto con cualquier mensaje de contexto del remitente. + +4. **Disponibilidad de clips**: Los clips tienen fechas de caducidad establecido por el remitente. Consulta la ventana **Availability** si no puedes acceder a un clip compartido previamente. + + screenshot of the session replay page in browser \ No newline at end of file diff --git a/src/i18n/content/es/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx b/src/i18n/content/es/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx index 70a00926dfa..c43b481394c 100644 --- a/src/i18n/content/es/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx +++ b/src/i18n/content/es/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx @@ -1,5 +1,5 @@ --- -title: Integración y políticas gestionadas +title: Conceder permisos de New Relic con políticas administradas de AWS tags: - Integrations - Amazon integrations @@ -14,7 +14,7 @@ Para utilizar [infraestructura integración](/docs/infrastructure/integrations), ## Política recomendada [#recommended] - **Recommendation:** Conceda una [política administrada](http://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) `ReadOnlyAccess` para toda la cuenta desde AWS. AWS actualiza automáticamente esta política cuando se agregan nuevos servicios o se modifican servicios existentes. La integración New Relic Infrastructure se ha diseñado para funcionar con políticas `ReadOnlyAccess`. Para obtener instrucciones, consulte [Conectar la integración AWS a la infraestructura](/docs/infrastructure/infrastructure-integrations/getting-started/connect-aws-integrations-infrastructure). + Recomendación: Asigne una [política gestionada](http://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) `ReadOnlyAccess` a nivel de cuenta desde AWS. AWS actualiza automáticamente esta política cuando se agregan servicios nuevos o se modifican los existentes. La integración de New Relic Infrastructure se diseñó para funcionar con políticas `ReadOnlyAccess`. Para obtener instrucciones, consulte [Conectar la integración AWS a la infraestructura](/docs/infrastructure/infrastructure-integrations/getting-started/connect-aws-integrations-infrastructure). **Exception:** La integración [de Trusted Advisor](/docs/integrations/amazon-integrations/aws-integrations-list/aws-trusted-advisor-integration) no está cubierta por la política `ReadOnlyAccess` . Requiere la política administrada `AWSSupportAccess` adicional. Esta es también la única integración que requiere permisos de acceso completo (`support:*`) para funcionar correctamente. Notificamos a Amazon sobre esta limitación. Una vez que se resuelva, actualizaremos la documentación con permisos más específicos necesarios para esta integración. @@ -36,11 +36,8 @@ Nuestra plantilla CloudFormation contiene todos los permisos para toda nuestra i Se puede utilizar un usuario distinto de `root` en la política administrada. - - ``` + + ```yml AWSTemplateFormatVersion: 2010-09-09 Outputs: NewRelicRoleArn: @@ -63,7 +60,7 @@ Se puede utilizar un usuario distinto de `root` en la política administrada. Statement: - Effect: Allow Principal: - AWS: !Sub 'arn:aws:iam::754728514883:root' + AWS: !Sub 'arn:aws:iam::253490767857:root' Action: 'sts:AssumeRole' Condition: StringEquals: @@ -220,24 +217,13 @@ Se puede utilizar un usuario distinto de `root` en la política administrada. Para crear su propia política utilizando los permisos disponibles: -1. [Agregue los permisos para](#all-permissions) - - - [**all**](#all-permissions) - - - [integración](#all-permissions). - +1. [Agregue los permisos para **all** integración](#all-permissions). 2. Agregue permisos que sean específicos de la integración que necesita New Relic utiliza los siguientes permisos para recuperar datos para una integración AWS específica: - + Si una integración no aparece en esta página, estos permisos son todo lo que necesita. @@ -284,7 +270,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac
- APIde etiquetas de recursos + API de etiquetas de recursos @@ -295,10 +281,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac
- + Permisos [ALB](/docs/aws-alb-integration) adicionales: * `elasticloadbalancing:DescribeLoadBalancers` @@ -313,19 +296,13 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `elasticloadbalancing:DescribeLoadBalancerPolicyTypes` - + Permisos adicionales [de API Gateway](/docs/infrastructure/amazon-integrations/amazon-integrations/aws-api-gateway-monitoring-integration) : * `apigateway:GET` - + [Permisos adicionales de Auto Scaling:](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-auto-scaling-monitoring-integration) * `autoscaling:DescribeLaunchConfigurations` @@ -335,19 +312,13 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `autoscaling:DescribeAccountLimits` - + [Permiso de facturación adicional:](/docs/infrastructure/amazon-integrations/amazon-integrations/aws-billing-integration) * `budgets:ViewBudget` - + Permisos adicionales [de CloudFront](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-cloudfront-integration) : * `cloudfront:ListDistributions` @@ -355,19 +326,13 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `cloudfront:ListTagsForResource` - + Permisos adicionales [de CloudTrail](/docs/integrations/amazon-integrations/aws-integrations-list/aws-cloudtrail-monitoring-integration) : * `cloudtrail:LookupEvents` - + Permisos adicionales [de DynamoDB](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-dynamodb-integration) : * `dynamodb:DescribeLimits` @@ -378,10 +343,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `dynamodb:ListTagsOfResource` - + Permisos adicionales [de EBS](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-ebs-integration) : * `ec2:DescribeVolumeStatus` @@ -389,20 +351,14 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `ec2:DescribeVolumeAttribute` - + Permisos [EC2](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-ec2-integration) adicionales: * `ec2:DescribeInstanceStatus` * `ec2:DescribeInstances` - + Permisos [ECS/ECR](/docs/infrastructure/amazon-integrations/amazon-integrations/aws-ecsecr-integration) adicionales: * `ecs:ListServices` @@ -414,30 +370,21 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `ecs:DescribeContainerInstances` - + Permisos [EFS](/docs/integrations/amazon-integrations/aws-integrations-list/aws-efs-monitoring-integration) adicionales: * `elasticfilesystem:DescribeMountTargets` * `elasticfilesystem:DescribeFileSystems` - + Permisos adicionales [de ElastiCache](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-elasticache-integration) : * `elasticache:DescribeCacheClusters` * `elasticache:ListTagsForResource` - + Permisos adicionales [de ElasticSearch](/docs/infrastructure/amazon-integrations/amazon-integrations/aws-elasticsearch-integration) : * `es:ListDomainNames` @@ -446,10 +393,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `es:ListTags` - + Permisos adicionales [de Elastic Beanstalk](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-elastic-beanstalk-monitoring-integration) : * `elasticbeanstalk:DescribeEnvironments` @@ -457,19 +401,13 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `elasticbeanstalk:DescribeConfigurationSettings` - + Permisos [ELB](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-elb-integration) adicionales: * `elasticloadbalancing:DescribeLoadBalancers` - + Permisos [EMR](/docs/aws-emr-monitoring-integration) adicionales: * `elasticmapreduce:ListInstances` @@ -479,10 +417,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `elasticmapreduce:ListInstanceFleets` - + Permisos [de salud](/docs/aws-health-integration) adicionales: * `health:DescribeAffectedEntities` @@ -490,10 +425,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `health:DescribeEvents` - + Permisos [IAM](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-iam-integration) adicionales: * `iam:ListSAMLProviders` @@ -504,10 +436,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `iam:GetAccountSummary` - + Permisos adicionales [de IoT](/docs/aws-iot-monitoring-integration) : * `iot:ListTopicRules` @@ -515,20 +444,14 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `iot:ListThings` - + Permisos adicionales [de Kinesis Firehose](/docs/infrastructure/amazon-integrations/amazon-integrations/aws-kinesis-firehose-integration) : * `firehose:DescribeDeliveryStream` * `firehose:ListDeliveryStreams` - + Permisos adicionales [de Kinesis Streams](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-kinesis-integration) : * `kinesis:ListStreams` @@ -536,10 +459,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `kinesis:ListTagsForStream` - + Permisos [Lambda](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-lambda-integration) adicionales: * `lambda:GetAccountSettings` @@ -549,10 +469,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `lambda:ListEventSourceMappings` - + Permisos de monitoreo adicionales [de RDS](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-rds-integration) y [RDS mejorado](/docs/aws-rds-enhanced-monitoring-integration) : * `rds:ListTagsForResource` @@ -560,20 +477,14 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `rds:DescribeDBClusters` - + Permisos adicionales [de desplazamiento al rojo](/docs/aws-redshift-integration) : * `redshift:DescribeClusters` * `redshift:DescribeClusterParameters` - + Permisos adicionales [de la Ruta 53](/docs/infrastructure/amazon-integrations/amazon-integrations/aws-route-53-integration) : * `route53:ListHealthChecks` @@ -583,10 +494,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `route53:ListTagsForResources` - + Permisos [S3](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-s3-integration) adicionales: * `s3:GetLifecycleConfiguration` @@ -609,10 +517,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `s3:GetInventoryConfiguration` - + Permisos [SES](/docs/integrations/amazon-integrations/aws-integrations-list/aws-simple-email-service-ses-monitoring-integration) adicionales: * `ses:ListConfigurationSets` @@ -624,20 +529,14 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `ses:DescribeReceiptRuleSet` - + Permisos [SNS](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-sns-integration) adicionales: * `sns:GetTopicAttributes` * `sns:ListTopics` - + Permisos [SQS](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-sqs-integration) adicionales: * `sqs:ListQueues` @@ -645,10 +544,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `sqs:ListQueueTags` - + Permisos adicionales [de Trusted Advisor](/docs/integrations/amazon-integrations/aws-integrations-list/aws-trusted-advisor-integration) : * `support:*` @@ -656,10 +552,7 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac Consulte también la nota sobre la integración de Trusted Advisor y [las políticas recomendadas](#recommended). - + Permisos [de VPC](/docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-vpc-integration) adicionales: * `ec2:DescribeInternetGateways` @@ -676,13 +569,10 @@ New Relic utiliza los siguientes permisos para recuperar datos para una integrac * `ec2:DescribeVpnConnections` - + Permisos adicionales [de monitoreo de rayos X](/docs/integrations/amazon-integrations/aws-integrations-list/aws-x-ray-monitoring-integration) : * `xray:BatchGet*` * `xray:Get*` - + \ No newline at end of file diff --git a/src/i18n/content/es/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx b/src/i18n/content/es/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx index d0ad2d5ef3a..11cba42d65e 100644 --- a/src/i18n/content/es/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx +++ b/src/i18n/content/es/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx @@ -21,10 +21,10 @@ Si no ve datos después de esperar al menos 10 minutos, pruebe estas sugerencias 1. Asegúrese de que el agente de infraestructura esté [instalado y ejecutándose correctamente](/docs/infrastructure/new-relic-infrastructure/troubleshooting/no-data-appears-infrastructure). Debe instalar el agente de infraestructura **first** y luego conectarse a su cuenta de AWS. - Si ve nombres de atributos, pero no datos, en **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events** o **Infrastructure > Settings > Agents**, es posible que no haya instalado el agente de infraestructura. + Si ve nombres de atributos, pero no datos, en **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events** o **Infrastructure > Settings > Agents**, es posible que no haya instalado el agente de infraestructura. -2. Corrija cualquier error que vea en el panel de estado de la cuenta. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS** y seleccione el **Account status dashboard** para cada una de sus cuentas. +2. Corrija cualquier error que vea en el dashboard de estado de la cuenta. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS** y seleccione el **Account status dashboard** para cada una de sus cuentas. Si ve informes **Role errors** o **Permission errors**, consulte nuestras [políticas administradas y de integración](/docs/integrations/amazon-integrations/getting-started/integrations-managed-policies) y verifique que haya otorgado New Relic los permisos necesarios para leer los datos relevantes de su cuenta. @@ -52,7 +52,7 @@ Si no ve datos después de esperar al menos 10 minutos, pruebe estas sugerencias - `754728514883` + `253490767857` @@ -82,4 +82,4 @@ Si no ve datos después de esperar al menos 10 minutos, pruebe estas sugerencias -3. Asegúrese de [buscar sus datos en el lugar correcto](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric) . Puedes encontrar todos los datos de integración en [métrica y evento](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer). +3. Asegúrese de [buscar sus datos en el lugar correcto](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric) . Puedes encontrar todos los datos de integración en [métrica y evento](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer). \ No newline at end of file diff --git a/src/i18n/content/es/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx b/src/i18n/content/es/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx index c95a7732e6e..fb684acf711 100644 --- a/src/i18n/content/es/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx +++ b/src/i18n/content/es/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx @@ -13,14 +13,10 @@ Los patrones de registros son la forma más rápida de descubrir valor en los da Los datos log son telemetría de gran volumen con un valor bajo por registro individual. La búsqueda puede conducir rápidamente a registros que proporcionen una explicación de la causa raíz, pero la mayoría de los datos son repetitivos y difíciles de contextualizar al navegar. Los patrones pueden hacer que los datos log sean detectables sin perder mucho tiempo leyendo datos de bajo valor. -Screenshot of Log patterns UI +Screenshot of Log patterns UI
- **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: los patrones de registros lo ayudan a detectar picos o caídas sospechosas en el mensaje de registro sin tener que dedicar más tiempo a buscar. + **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: los patrones de registros lo ayudan a detectar picos o caídas sospechosas en el mensaje de registro sin tener que dedicar más tiempo a buscar.
## Resumen técnico [#overview] @@ -67,11 +63,11 @@ Si ve **Patterns are turned off** en su UI de registro, haga clic en - Cuentas HITRUST + Cuentas HIPAA - La característica patrones de registros no cumple con FedRAMP. FedRAMP u otras cuentas HITRUST no son elegibles para usar patrones. + La característica patrones de logs no cumple con FedRAMP. FedRAMP u otras cuentas HIPAA no son elegibles para usar patrones. @@ -81,7 +77,7 @@ Si ve **Patterns are turned off** en su UI de registro, haga clic en - Disponemos de un sistema de límites de seguridad en memoria y recursos de CPU a la hora de hacer coincidir log con patrones. Estos límites de coincidencia pueden tener un impacto en el porcentaje de logs que se pueden agrupar en patrones de logs. Sin embargo, la coincidencia de patrones de registros es un proceso de "mejor esfuerzo": no es un error si no todos sus registros tienen la oportunidad de agruparse por patrones. Aún obtendrá valor de la agrupación que se puede realizar dentro de los límites de recursos. + Disponemos de un sistema de límites de seguridad en memoria y recursos de CPU a la hora de hacer coincidir log con patrones. Estos límites de coincidencia pueden tener un impacto en el porcentaje de logs que se pueden agrupar en patrones de logs. Sin embargo, la coincidencia de patrones de registros es un proceso de "mejor esfuerzo": no es un error si no todos sus registros tienen la oportunidad de agruparse por patrones. Aún obtendrá valor de la agrupación que se puede realizar dentro de los límites de recursos. @@ -91,21 +87,8 @@ Si ve **Patterns are turned off** en su UI de registro, haga clic en Para comenzar a examinar patrones: -1. Vaya a - - - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs** - - - y utilice el selector de cuentas desplegable para seleccionar la cuenta objetivo donde desea explorar patrones. - -2. En la navegación izquierda de la UI del registro, haga clic en - - - **Patterns** - - - . +1. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs** y utilice el selector de cuentas desplegable para seleccionar la cuenta objetivo donde desea explorar patrones. +2. En la navegación izquierda de la UI del registro, haga clic en **Patterns**. La log UI principal cambia para mostrar patrones que coinciden con la consulta en la barra de consulta. Para ver el registro de un período de tiempo específico, haga clic en ese punto (o haga clic y arrastre un área) en el gráfico, o use el selector de tiempo. @@ -222,12 +205,6 @@ Aquí hay algunas razones por las que tiene patrones habilitados pero no ve ning Los patrones son un valor que se enriquece en el mensaje de registro existente como un nuevo atributo llamado `newrelic.logPattern`. Todo lo que puedas hacer con log generalmente se puede hacer con patrones de logs, como por ejemplo: -* Cree su propio [panel](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards) con patrones para monitor un patrón específico o un grupo de patrones que le interesen. - -* Cree - - - - para patrones agregando [alertas NRQL](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions). - -* Utilice [condición de alerta de anomalía](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions) para detectar anomalías en patrones de registros conocidos. +* Cree su propio [dashboard](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards) con patrones para monitor un patrón específico o un grupo de patrones que le interesen. +* Cree para patrones agregando [alertas NRQL](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions). +* Utilice [condición de alerta de anomalía](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions) para detectar anomalías en patrones de registros conocidos. \ No newline at end of file diff --git a/src/i18n/content/es/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx b/src/i18n/content/es/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx index f57340080df..b1c4caebc76 100644 --- a/src/i18n/content/es/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx +++ b/src/i18n/content/es/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx @@ -204,7 +204,13 @@ La página de tiempo de ejecución de Go proporciona herramientas para identific La página de tiempo de ejecución de Go muestra señales doradas junto con métricas de tiempo de ejecución de Go para correlacionar los problemas de tiempo de ejecución con el uso del servicio. -La consulta supone que los datos son producidos por la [biblioteca de instrumentación en tiempo de ejecuciónOpenTelemetry Go](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/). Tenga en cuenta que actualmente no existen convenciones semánticas para la métrica del tiempo de ejecución de Go. +La consulta supone que los datos son producidos por la [biblioteca de instrumentación en tiempo de ejecuciónOpenTelemetry Go](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/). + + + Las [convenciones semánticas](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/runtime/go-metrics.md) para las métricas de tiempo de ejecución de Go aún están en desarrollo. La página de tiempo de ejecución de Go está dirigida a una versión anterior de las convenciones. Debe habilitar las convenciones antiguas habilitando la variable de entorno `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS`. Para obtener más información, consulte la [documentación](https://github.com/open-telemetry/opentelemetry-go-contrib/blob/9a6e0bf68e1da495be52faf152b5b4e6fb09d475/instrumentation/runtime/internal/x/README.md) de la instrumentación. + + New Relic acabará dando soporte a las nuevas convenciones una vez que se estabilicen. + ### Logs [#logs-page] diff --git a/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx new file mode 100644 index 00000000000..ed0101eff04 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx @@ -0,0 +1,71 @@ +--- +subject: Docs +releaseDate: '2025-10-25' +version: 'October 19 - October 24, 2025' +translationType: machine +--- + +### Nuevos documentos + +* Se agregó Inteligencia de costos en la nube [Azure](/docs/cci/azure-cci) y [Google Cloud Platform (GCP)](/docs/cci/gcp-cci) para brindar una guía completa para conectar la integración de facturación Azure y GCP con New Relic para el monitoreo y la optimización de costos. + +### Cambios importantes + +* [Reporte actualizado de compatibilidad del agente Node.js.](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent) +* [Introducción actualizada a NRQL](/docs/nrql/get-started/introduction-nrql-new-relics-query-language) con contenido optimizado para una mejor experiencia del usuario. +* Se agregó compatibilidad con ConfigMap para el agente de Java al [operador del agente Kubernetes ](/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator). + +### Cambios menores + +* Se corrigieron enlaces rotos para [Establecer umbral condición de alerta](/docs/alerts/create-alert/set-thresholds/set-thresholds-alert-condition). +* Documentación [de introducción al generador de consultas](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) mejorada con elementos visuales mejorados. +* Se agregó soporte para la representación de ecuaciones matemáticas en toda la documentación. +* [Funcionalidad de pausa](/docs/browser/new-relic-browser/browser-apis/pauseReplay) Session Replay mejorada y documentación [de funcionalidad de grabación](/docs/browser/new-relic-browser/browser-apis/recordReplay) con guía mejorada. +* Se actualizaron los requisitos del agente del navegador rastreando distribuido en varias páginas de documentación para mayor claridad. +* [Configuración actualizada del administrador de trabajos sintéticos](/docs/synthetics/synthetic-monitoring/private-locations/job-manager-configuration/#kubernetes-sizing) con una ecuación matemática mejorada para consideraciones de tamaño para Docker, Podman, Kubernetes y OpenShift. +* Se corrigieron los problemas de MDX que afectaban la representación de documentos. + +### Notas de la versión + +* Mantener actualizado con nuestros últimos lanzamientos: + + * [Agente de Browser v1.300.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.300.0): + + * Se eliminó el uso de la función de marcas y medidas para todos los usuarios. + * Tasa de falso positivo del atributo hasReplay reducida. + * Se actualizaron los tipos de API de interacción para reflejar el parámetro waitForEnd. + * Se corrigieron problemas de requisitos dinámicos con acumulación.js. + + * [Agente Browser v1.301.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.301.0): + + * Se cambió al uso de la versión bifurcada de rrweb de New Relic para Session Replay. + * Atributo de agente conservado para carga de log con manejo de precedencia adecuado. + + * [Integración Kubernetes v3.47.0](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-47-0): + + * Capacidades de monitoreo mejoradas para entornos Kubernetes. + * Recopilación de recursos mejorada y optimizaciones de rendimiento. + + * [Agente deNode.js v13.5.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-5-0): + + * Se actualizó fastify instrumentación para suscribir a evento emitido. + * Instrumentación pg y pg-native actualizada para mejorar la base de datos de monitoreo. + * Los temporizadores setTimeout y timers.setInterval están deshabilitados de forma predeterminada para un mejor rendimiento. + * Se agregó una nueva clase base de diagnóstico para mejorar la resolución de problemas. + + * [Agente iOS v7.5.11](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-7511): + + * Se corrigieron problemas de rendimiento con la interacción Tracing. + * Se corrigió de los mensaje de log el rastreo distribuido incorrectos. + + * [AgenteAndroid v7.6.10](/docs/release-notes/mobile-release-notes/android-release-notes/android-7610): + + * Se agregó compatibilidad con Gradle 9 para mejorar la compatibilidad de compilación. + + * [agente de infraestructura v1.69.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1690): + + * Capacidades mejoradas de monitoreo del sistema y corrección de errores. + + * [agente de infraestructura v1.70.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1700): + + * Mejoras adicionales de rendimiento y mejoras de monitoreo. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx new file mode 100644 index 00000000000..168add677e4 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx @@ -0,0 +1,99 @@ +--- +subject: Docs +releaseDate: '2025-08-01' +version: 'July 25 - August 01, 2025' +translationType: machine +--- + +### Nuevos documentos + +* Se agregó [documentación de Cotizaciones de Calcular](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) para brindarle un mecanismo para monitorear y alertar sobre el uso de su Unidad de Consumo de Calcular (CCU). + +### Cambios importantes + +* [Compatibilidad y requisitos](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent) actualizados para el agente Node.js. + +* [Compatibilidad y requisitos actualizados para Alpine Linux](/docs/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements) para el agente PHP. + +* Se actualizaron los requisitos específicos del agente para [el control de tuberías](/docs/new-relic-control/pipeline-control/modify-agent-configuration). + +* Se actualizó el JFR relacionado con los requisitos de configuración para [el agente de Java](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file#jfr-harvest-interval). + +* Se actualizó la información de precios y facturación de New Relic en: + + * [Datos: Facturación y reglas](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing) + * [Consultas y alertas relacionadas con el uso](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/usage-queries-alerts) + * [Plan de uso de New Relic](/docs/licenses/license-information/usage-plans/new-relic-usage-plan) + +### Cambios menores + +* Se aclaró el lenguaje en el agente .NET para capturar el parámetro SQL en el documento [de compatibilidad del agente y requisitos de .NET](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements). +* Se perfeccionó el lenguaje en [Oracle base de datos monitoreo integración](/docs/infrastructure/host-integrations/host-integrations-list/oracle-database-monitoring-integration). + +### Notas de la versión + +* Consulta nuestras publicaciones de Novedades: + + * [Calcular Cotizaciones ahora disponibles de forma general](/whats-new/2025/07/whats-new-7-30-compute-budgets). + * [Mejorar la experiencia del usuario: aprovechar Session Replay para optimizar los elementos esenciales de la web](/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser). + +* Mantener actualizado con nuestros últimos lanzamientos: + + * [AgenteAndroid v7.6.8](/docs/release-notes/mobile-release-notes/android-release-notes/android-768): + + * Se solucionó un problema en el que el rastreo de stack para errores de Unity no se mostraba correctamente. + * Se solucionó un problema que impedía que se registrara el resumen métrico cuando la aplicación volvía al primer plano luego de su lanzamiento inicial. + * Se solucionó un problema por el cual un JSON no válido en las entradas de registro podía provocar errores. + + * [CLI de diagnóstico (nrdiag) v3.4.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-341): + * Se agregó `K8s/AgentControl/agent-control-install-job-logs` para recopilar los logs generados por la instalación del control del agente. + + * [Administrador de trabajos v451](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-451): + + * Se corrigieron vulnerabilidades relacionadas con `common-lang3` Java y Ubuntu para abordar problemas de seguridad en SJM. + * Se implementaron cambios en la migración de la cola del procesador relacionados con la migración de nuestra arquitectura de servicio interna. + * Se solucionó un problema para incluir detalles completos de la excepción para proporcionar un mejor contexto para la resolución de problemas en los logs de SJM. + + * [Aplicación móvil para Android v5.30.1](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5301): + * Se mejoró la experiencia de inicio de sesión. + + * [Aplicación móvil para iOS v7.5.8](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-758): + + * Construí el agente usando Xcode 16.4. + * Se solucionó un problema que podía provocar que rastreo distribuido no tuviera toda la información de cuenta requerida al inicio de una sesión. + * Se solucionó un problema que podía provocar un bloqueo al iniciar el agente. + + * [Tiempo de ejecución de la API de nodo](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.122): + * Se corrigieron las vulnerabilidades de datos de formulario y las vulnerabilidades subyacentes de Ubuntu para abordar vulnerabilidades de seguridad en los tiempos de ejecución de Node API. + + * [Node browser runtime](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.39): + * Se corrigieron las vulnerabilidades de datos de formulario y las vulnerabilidades subyacentes de Ubuntu para abordar vulnerabilidades de seguridad en los tiempos de ejecución de Node Browser. + + * [Tiempo de ejecución de ping](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.0): + * Se corrigieron vulnerabilidades relacionadas con `common-lang3` Java y Ubuntu para abordar problemas de seguridad en el tiempo de ejecución de Ping. + + * [Agente de Python v10.15.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101500): + + * Se agregó soporte para [`oracledb`](https://pypi.org/project/oracledb/) + * Se corrigió un error en la instrumentación `MessageBroker` donde los métodos serializar buscaban el atributo `destination_name` en `MessageTransaction` y no existía. + * Se solucionó el problema de metadatos de utilización de AWS al ejecutar AWS y K8s juntos. + + * [AgenteRuby v9.20.0](/docs/release-notes/agent-release-notes/ruby-release-notes/ruby-agent-9-20-0): + + * Se agregó soporte para registrar el ID de Docker cuando se ejecuta en el entorno AWS ECS Fargate. + * Se agregó un nuevo método auxiliar para simplificar la comparación de versiones. + * Se agregó el atributo `code.stacktrace` a los intervalos de almacenamiento de datos cuando la duración excede el umbral configurado. + * Se corrigieron los `Brewfile` enlaces de origen. + * Se corrigió un error que ocurre cuando se usa `HTTPX 1.5.0` para almacenar la respuesta. + * Se mejoró la información registrada en el nivel de depuración por el agente cuando el agente lee una fuente de configuración. + + * [Agente de Unity v1.4.8](/docs/release-notes/mobile-release-notes/unity-release-notes/unity-agent-148): + + * Se actualizó el agente nativo de Android a v7.6.7. + * Se actualizó el agente nativo de iOS a v7.5.6. + + * [Agente de Unity v1.4.9](/docs/release-notes/mobile-release-notes/unity-release-notes/unity-agent-149): + + * Se actualizó el agente nativo de Android a v7.6.8. + * Se actualizó el agente nativo de iOS a v7.5.8. + * Se solucionó el problema de rastreo de stack de excepciones de Unity cuando se emplean espacios de nombres. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx new file mode 100644 index 00000000000..01456861c55 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx @@ -0,0 +1,60 @@ +--- +subject: Docs +releaseDate: '2025-08-08' +version: 'August 01 - August 07, 2025' +translationType: machine +--- + +### Nuevos documentos + +* Se agregó [el tutorial de NerdGraph: Crear un rol personalizado para Teams](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) para guiarlo en el uso de la API de NerdGraph de New Relic para crear y gestionar roles personalizados para Teams. + +### Cambios menores + +* Se modificó el [umbral de alerta de evento por condición](/docs/alerts/admin/rules-limits-alerts) a 1k por minuto. +* Se actualizaron las últimas [versiones y requisitos compatibles del agente .Net](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements) verificados. +* Se actualizó la información de versión y soporte de versión acerca del agente de servicio para [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-service-broker-integration). +* Se actualizó la información de soporte de la versión sobre el paquete de compilación de integración NGINX de New Relic para [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-nginx-buildpack-integration). +* Se actualizó la información de versión y soporte de versiones de New Relic Nozzle para [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-firehose-nozzle-integration/#product-snapshot). + +### Notas de la versión + +* Consulta nuestras publicaciones de Novedades: + + * [Errors Inbox ahora está integrada dentro de carga de trabajo](/whats-new/2025/08/whats-new-08-06-workloads-errors-inbox). + +* Mantener actualizado con nuestros últimos lanzamientos: + + * [Administrador de trabajos v452](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-452): + * Se agregaron mejoras internas para el manejo de excepciones al procesar mensajes de la cola. + + * [IntegraciónKubernetes v3.43.3](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-43-3): + * Se agregó un gráfico Helm para implementar la solución de monitoreo Kubernetes New Relic. + + * [Control de tuberías Gateway v1.1.0](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-08-05): + + * Se implementó una nueva funcionalidad para descartar selectivamente datos y atributos de `SqlTrace` y `TransactionTrace` incluso usando reglas de descartado. + + * Se abordaron vulnerabilidades en el paquete `golang.org/x/net`, incluido un problema de script entre sitios y una omisión de proxy HTTP relacionada con los ID de zona IPv6. + + * Se actualizó a Go `1.24` y las siguientes dependencias se actualizan para mejorar la seguridad e incorporar correcciones recientes: + + * `golang.org/x/net to v0.38.0` + * `golang.org/x/sys to v0.31.0` + * `golang.org/x/text to v0.23.0` + + * [Aplicación móvil para iOS v6.9.11](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6101): + * Se redujo el flujo de inicio de sesión en dos pasos al almacenar el dominio de autenticación de un usuario y redirigirlo directamente a su página de inicio de sesión. + + * [Agente deFlutter v1.1.13](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1113): + + * Agente nativo Android mejorado actualizado a la versión 7.6.8 + * Agente nativo de iOS mejorado actualizado a la versión 7.5.8 + + * [Agente .NET MAUI v1.1.11](/docs/release-notes/mobile-release-notes/net-maui-release-notes/net-maui-agent-1111) + + * Agente nativo Android mejorado actualizado a la versión 7.6.8 + * Agente nativo de iOS mejorado actualizado a la versión 7.5.8 + + * [agente de infraestructura v1.65.5](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1655): + * Se modificó el soporte de montaje de AWS EFS en muestras de almacenamiento. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx new file mode 100644 index 00000000000..aa561dae04a --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx @@ -0,0 +1,112 @@ +--- +subject: Docs +releaseDate: '2025-08-15' +version: 'August 08 - August 14, 2025' +translationType: machine +--- + +### Nuevos documentos + +* Se agregó [soporte para funciones NRQL en reglas de puerta de enlace](/docs/new-relic-control/pipeline-control/nrql-functions) para delinear las funciones NRQL admitidas en las reglas de puerta de enlace de Control de pipelines. +* Se agregaron pasos de resolución de problemas para resolver [Frequent Fluent Bit Restart Events](/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/frequent-fluent-bit-restart-events) ajustando la configuración de resolución del nombre del host en la configuración del agente de New Relic Infrastructure. + +### Cambios importantes + +* [Plan de uso](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/#list-price) actualizado con la última información de precios. +* Se agregó **Errors Inbox** a [la UIde carga de trabajo](/docs/new-relic-solutions/new-relic-one/workloads/use-workloads/#errors). +* Se agregó la desactivación selectiva del agente en función de la clase principal de inicio o el jar ejecutable a través de variables de entorno, junto con configuraciones de seguridad mejoradas para [la configuración del agente de Java ](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file/#skip-applications). +* Se agregó soporte para [la configuración de repositorio privado](/docs/new-relic-control/agent-control/configuration/#private-repository-configuration) en el control de agente, lo que permite la implementación de agente gestionado con autenticación a través de métodos de certificado básico o TLS. +* Se agregó soporte para [la gestión de secretos](/docs/new-relic-control/agent-control/configuration/#secrets-management) en el control de agente, para gestionar datos confidenciales, como contraseñas y claves de API, recuperándolos del proveedor de secretos dedicado. + +### Cambios menores + +* Se agregaron restricciones de etiqueta de entidad para la cláusula `WHERE` en [Descartar datos mediante reglas cloud de Control de canalizaciones](/docs/new-relic-control/pipeline-control/cloud-rules-api/#restrictions). +* Se agregaron [las mejores prácticas para optimizar el contenido de su fuente de conocimiento](/docs/agentic-ai/knowledge-integration/overview/#configure) para el conector de conocimiento de New Relic AI. + +### Notas de la versión + +* Consulta nuestras publicaciones de Novedades: + + * [El modo de alta precisión de UniqueCount y el mayor soporte de argumentos ahora están disponibles de manera general](/whats-new/2025/08/whats-new-8-13-high-precision-uniquecount). + +* Mantener actualizado con nuestros últimos lanzamientos: + + * [AgenteCordova v7.0.8](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-708/): + + * Actualizar el agente nativo de Android a la versión 7.6.8 + * Actualizar el agente nativo de iOS a la versión 7.5.8 + + * [Agente Cordova v7.0.9](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-709/): + + * Actualizar el agente nativo de Android a la versión 7.6.6 + * Actualizar el agente nativo de iOS a la versión 7.5.5 + + * [Agente de Capacitor v1.5.8](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-158/): + + * Actualizar el agente nativo de Android a la versión 7.6.6 + * Actualizar el agente nativo de iOS a la versión 7.5.5 + + * [Agente de Capacitor v1.5.9](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-159/): + * Fallo de señal de aborto fijo + + * [Agente de Capacitor v1.5.10](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-1510/): + + * Actualizar el agente nativo de Android a la versión 7.6.8 + * Actualizar el agente nativo de iOS a la versión 7.5.8 + + * [CLI de diagnóstico (nrdiag) v3.5.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-350/): + * se actualizó la comprobación de compatibilidad de la versión `Java/Appserver/JbossEapCheck` + + * [Agente .NET v10.44.0](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-0/): + + * Samplers de rendimiento métrica habilitados en modo Serverless + * Se excluyó el proceso de host sitio web de Azure Functions (Linux) de la instrumentación. + + * [NRDOT v1.3.0](/docs/release-notes/nrdot-release-notes/nrdot-2025-08-13/): + + * Se actualizaron las versiones de los componentes del hotel de v0.128.0 a v0.131.0 + * Se introdujo la distribución principal de nrdot + + * [Agente de Node.js v13.1.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-1-0/): + + * Se agregó soporte para la API de logs de OTEL + * Se agregó compatibilidad con métricas cuando se deshabilitó la instrumentación para un paquete + * Instrumentación de temporizadores deshabilitados por defecto en la configuración de muestra. + * Ofuscación fija `transaction.url` + + * [Administrador de trabajos v454](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-454/): + * Se corrigieron las vulnerabilidades subyacentes de Ubuntu para abordar las vulnerabilidades de seguridad en SJM. + + * [Tiempo de ejecución de la API de nodo v1.2.124](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.124/): + * Se corrigieron las vulnerabilidades subyacentes de Ubuntu para abordar vulnerabilidades de seguridad en los tiempos de ejecución de Node API. + + * [Runtime del navegador de nodos v3.0.41](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.41/): + * Se corrigieron las vulnerabilidades temporales `CVE-2025-54798` y las vulnerabilidades subyacentes de Ubuntu para abordar vulnerabilidades de seguridad en los tiempos de ejecución de Node Browser . + + * [Tiempo de ejecución de ping v1.54.0](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.0/): + * Se corrigieron vulnerabilidades relacionadas con Ubuntu para abordar problemas de seguridad en el tiempo de ejecución de Ping. + + * [Agente de Java v8.23.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8230/): + + * Actualizado para soportar v24 de graphql. + * Se agregó instrumentación de lechuga 6.5. + * Se actualizó la versión de Commons Lang a 3.18.0 + + * [Reenviador de logs AWS Lambda v1.1.1](/docs/release-notes/aws-lambda-log-forwarder-release-notes/lambda-25-07-25/): + * Se mejoró la postura de seguridad al actualizar la versión Go a 1.24.4 en los sistemas. + + * [Agente PHP v12.0.0.25](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-0-0-25/): + + * Logging de errores del mapa de gancho de Drupal mejorado. + * Se corrigieron problemas de detección de paquetes legacy para Security RX. + + * [agente de infraestructura v1.66.1](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1661/): + * Se revirtió el soporte para montajes de AWS EFS en muestras de almacenamiento. + + * [Aplicación móvil para Android v5.30.6](docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5306/): + * Compatibilidad mejorada con claves de acceso para inicios de sesión SAML y sociales. + + * [Agente del navegador v1.295.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.0/): + + * Se agregó detección de causa de error. + * Se agregaron advertencias sobre parches para monos. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx new file mode 100644 index 00000000000..e554b9e74bb --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx @@ -0,0 +1,56 @@ +--- +subject: Docs +releaseDate: '2025-08-22' +version: 'August 15 - August 21, 2025' +translationType: machine +--- + +### Cambios importantes + +* Reporte actualizado de compatibilidad [del agente Node.js.](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent/) +* [Agente .NET](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements/) actualizado con las últimas versiones de biblioteca compatibles verificadas. + +### Cambios menores + +* Se actualizó el sistema operativo [Debian](/docs/infrastructure/infrastructure-agent/linux-installation/package-manager-install/) a la versión 12 ("bookworm") para soportar el [agente de infraestructura](/docs/infrastructure/infrastructure-agent/requirements-infrastructure-agent/#os) para Linux. +* Se actualizó la función [`accountId()`](/docs/data-apis/manage-data/query-limits/) para consultar los límites de datos. +* [Instalador MSIWindows ](/docs/infrastructure/infrastructure-agent/windows-installation/windows-msi-installer/#install-windows)actualizado para soportar Windows de 64 bits (Intel/AMD). + +### Notas de la versión + +* Se anunció el 7 de enero de 2026 como la fecha de fin de vida útil de las reglas de lanzamiento a través de la [UI de monitoreo de IA](/docs/ai-monitoring/drop-sensitive-data/). + +* [Agente iOS v7.5.9](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-759/) + + * Se solucionó un problema que podía provocar que rastreo distribuido no tuviera toda la información de cuenta requerida al inicio de una sesión. + * Se solucionó un problema que podía provocar un bloqueo al iniciar el agente. + +* [Agente de Python v10.16.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101600/) + + * Se agregó soporte para nuevas funciones [de Redis](https://pypi.org/project/redis/). + * Se convirtieron todas las rutas internas de `os.path` a `pathlib.Path`. + * Problema corregido con la codificación JSON PosixPath. + +* [Integración Kubernetes v3.44.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-44-1/) + + * Esta integración está incluida en las siguientes versiones de gráficos: + + * [infraestructura newrelic-3.49.1](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.49.1) + * [paquete nri-6.0.10](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.10) + +* [Agente .NET v10.44.1](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-1/) + + * Se corrigió el manejo de excepciones en el contenedor de instrumentación de Service Bus. + * Se excluyó el proceso de host sitio web de Azure Functions (Linux) de la instrumentación. + +* [Agente de Node.js v13.2.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-2-0/) + + * Se agregó la capacidad de registrar `Supportability/Features/Instrumentation/OnRequire/` métrica para instrumentación basada en suscriptores. + * Se agregó el gancho de carga esm y el parche commonjs para trabajar con orchestrion-js. + * Se agregó instrumentación para las llamadas de cliente `@modelcontextprotocol/sdk` `client.callTool`, `client.readResource` y `client.getPrompt`. + * Se corrigió la lógica en torno a la detección de paquetes OTEL. + * Se actualizó `shimmer.setupSubscribers` para configurar y omitir correctamente los suscriptores que están deshabilitados. + +* [Agente de Node.js v13.2.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-2-1/) + + * Agente actualizado para emplear `@apm-js-collab/tracing-hooks` para el registro CJS/ESM para rastrear instrumentación basada en canales. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx new file mode 100644 index 00000000000..cc764eedf32 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx @@ -0,0 +1,94 @@ +--- +subject: Docs +releaseDate: '2025-09-14' +version: 'September 08 - September 12, 2025' +translationType: machine +--- + +### Nuevos documentos + +* Se agregó documentación integral [del Modelo de madurez de observabilidad](/docs/new-relic-solutions/observability-maturity/) para brindar orientación para medir y mejorar las prácticas de observabilidad en cuatro áreas clave: tiempo de actividad empresarial, experiencia digital, excelencia en ingeniería y observabilidad inteligente. + +### Cambios importantes + +* [Configuración de agente PHP](/docs/apm/agents/php-agent/configuration/php-agent-configuration/) actualizada con amplias opciones de configuración nuevas para controles de ejemplificación e instrumentación del controlador de excepciones framework. + +### Cambios menores + +* [Introducción a los dashboards](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) actualizada con orientación mejorada para dashboard uso. +* Documentación [de gestión de dashboard](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/) mejorada con contenido simplificado para la gestión de JSON. +* Se corrigieron los enlaces rotos en la documentación [del plan de uso de New Relic](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/). +* Se corrigió la configuración de depuración en la documentación [del agente resolución de problemas de .NET](/docs/apm/agents/net-agent/troubleshooting/debugging-net-windows/). + +### Notas de la versión + +* Mantener actualizado con nuestros últimos lanzamientos: + + * [Agente de Browser v1.297.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.0/): + + * Se evitaron cosechas tempranas durante el periodo de reintento para un mejor manejo de la limitación de velocidad. + * Se eliminó el meta atributo newrelic de la carga de repetición saliente para reducir los bytes facturables. + * Se corrigieron excepciones para cuerpos nulos que surgen de cosechas vacías. + + * [Agente PHP v12.1.0.26](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-1-0-26/): + + * Se agregaron controles de ejemplificación basados en la decisión de ejemplificación de trazas de w3c ascendente. + * Se agregó una opción de configuración para omitir la instrumentación de los controladores de excepciones framework. + * Se solucionó una posible pérdida de memoria al llamar `newrelic_end_transaction(true)`. + * Se actualizó la versión de Golang a 1.25.1 para realizar mejoras de seguridad. + + * [Agente de Python v10.17.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101700/): + + * Se agregó soporte para tareas personalizadas en Celery. + * Se agregó soporte para monitoreo Graphene-Django. + * Se agregó soporte para filtrado de middleware en Django. + * Se agregó soporte para la API de AWS Bedrock Converse. + * Se agregó soporte para el indicador de ejemplificación del encabezado W3CTraceParent. + + * [Agente de Java v8.24.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8240/): + + * Se agregó soporte para MongoDB Reactive Streams 5.2.0 y posteriores. + * Se agregó soporte para Jedis 6. + * Se solucionó el problema de instrumentación doble de CouchBase. + * Se solucionó el problema de ajuste del encabezado de Spring WebClient 5.x. + + * [Agente de Node.js v13.3.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-0/): + + * Se agregó soporte para MCP `StreamableHTTPClientTransport`. + + * [Agente de Node.js v13.3.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-1/): + + * Se solucionó el fallo al establecer de forma predeterminada `requestParameters` en un objeto en `transaction.addRequestParameters`. + + * [Agente de Node.js v13.3.2](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-2/): + + * Se agregó código defensivo para obtener `protocol` en llamadas http salientes. + + * [Integración Kubernetes v3.45.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-45-1/): + + * Actualizado con las últimas mejoras y correcciones de errores. + + * [Administrador de trabajos v464](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-464/): + + * Se solucionó el problema en el que los clientes no podían extraer imágenes de un registro personalizado usando podman. + + * [Tiempo de ejecución del navegador de nodos v3.0.43](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.43/): + + * Se corrigieron las vulnerabilidades subyacentes de Ubuntu para abordar vulnerabilidades de seguridad. + + * [Aplicación móvil para iOS v6.9.12](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6102/): + + * Se corrigieron problemas de enlaces profundos para el panel y las alertas. + * Se solucionó el problema de identificación del tablero de CCU. + + * [Aplicación móvil para Android v5.30.7](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5307/): + + * Se agregaron correcciones de errores y mejoras. + + * [Agente de Flutter v1.1.14](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1114/): + + * Se agregaron mejoras de estabilidad adicionales y correcciones de errores. + + * [Control de Pipeline Gateway v25.09.01](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-09-01/): + + * Se agregó una nueva versión con capacidades mejoradas de control de tuberías. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx b/src/i18n/content/es/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx new file mode 100644 index 00000000000..c03c3308966 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx @@ -0,0 +1,15 @@ +--- +subject: Infrastructure agent +releaseDate: '2025-10-27' +version: 1.71.0 +translationType: machine +--- + +Se lanzó una nueva versión del agente. Siga los procedimientos estándar para [actualizar el agente de infraestructura](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent). New Relic recomienda que actualices el agente periódicamente y como mínimo cada 3 meses. En esta versión, la versión más antigua compatible es [el agente de infraestructura 1.55.2](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1552/). + +## Cambió + +* Agregar soporte para Suse 15.7 [#2139](https://github.com/newrelic/infrastructure-agent/pull/2139) +* Agregar soporte para Debian 13 (Trixie) [#2140](https://github.com/newrelic/infrastructure-agent/pull/2140) +* Se actualizó la dependencia newrelic/nri-winservices a la versión 1.4.0 [#2143](https://github.com/newrelic/infrastructure-agent/pull/2143) +* Se actualizó la dependencia newrelic/nri-prometheus a la versión 2.27.2 [#2130](https://github.com/newrelic/infrastructure-agent/pull/2130) \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx b/src/i18n/content/es/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx new file mode 100644 index 00000000000..d6e9acd934c --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx @@ -0,0 +1,13 @@ +--- +subject: Kubernetes integration +releaseDate: '2025-10-28' +version: 3.48.0 +translationType: machine +--- + +Para obtener una descripción detallada de los cambios, consulte las [notas de la versión](https://github.com/newrelic/nri-kubernetes/releases/tag/v3.48.0). + +Esta integración está incluida en las siguientes versiones de gráficos: + +* [newrelic-infraestructura-3.53.0](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.53.0) +* [nri-bundle-6.0.19](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.19) \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx b/src/i18n/content/es/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx new file mode 100644 index 00000000000..c85297d2d42 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx @@ -0,0 +1,18 @@ +--- +subject: Flutter agent +releaseDate: '2025-10-24' +version: 1.1.16 +downloadLink: 'https://pub.dev/packages/newrelic_mobile/versions/1.1.16' +translationType: machine +--- + +## Corrección de errores + +* Se solucionó un problema por el cual `NewRelicNavigationObserver` se bloqueaba al manejar rutas sin un parámetro clave, como hojas inferiores y cuadros de diálogo modales. +* Se resolvieron errores de seguimiento de navegación para rutas que no se extienden `PageRoute`. + +## Mejoras + +* Se mejoró la seguridad de tipos en `NewRelicNavigationObserver` al eliminar todos los tipos dinámicos. +* Se agregó soporte para tipos de rutas adicionales, incluidos `CupertinoPage` y `NoTransitionPage` desde `go_router`. +* Código de observador de navegación refactorizado para una mejor facilidad de mantenimiento y legibilidad. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx b/src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx new file mode 100644 index 00000000000..0f31403d612 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx @@ -0,0 +1,39 @@ +--- +subject: Browser agent +releaseDate: '2025-08-04' +version: 1.295.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Add error cause detection +bugs: + - Add monkey-patching warnings + - Calculate first and last timestamps from raw data +security: [] +translationType: machine +--- + +## v1.295.0 + +### Característica + +#### Agregar detección de causa de error + +Detectar y reportar la causa del atributo en el evento JavaScriptError capturado. Si la causa es una instancia de un Error, se capturará el rastreo de la stack, de lo contrario se informará el contenido en cadena de la causa. Esto se podrá consultar en JavaScriptError incluso bajo el atributo `cause`. + +### Corrección de errores + +#### Agregar advertencias sobre parches de mono + +Se agregó detección y advertencias para cuando los valores globales esperados fueron parcheados antes de que el agente se ejecutó en la página. Esto puede provocar comportamientos inesperados y la intención es informar a los clientes sobre este comportamiento. + +#### Calcular la primera y la última marca de tiempo a partir de datos sin procesar + +Cerciorar de que el agente calcule manualmente la primera y la última marca de tiempo de una carga de SessionReplay antes de la recolección para ayudar a mejorar la consistencia en el reproductor UI. + +## Declaración de apoyo + +New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Las versiones anteriores ya no recibirán soporte cuando lleguen [al final de su vida útil](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/). Las fechas de lanzamiento reflejan la fecha de publicación original de la versión del agente. + +Las nuevas versiones del agente del browser se lanzan a los clientes en pequeñas etapas a lo largo de un periodo de tiempo. Debido a esto, la fecha en que el lanzamiento esté disponible en su cuenta puede no coincidir con la fecha de publicación original. Consulte este [dashboard de estado](https://newrelic.github.io/newrelic-browser-agent-release/) para obtener más información. + +De acuerdo con nuestra [política de compatibilidad de navegadores](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), la versión 1.295.0 del agente del navegador se creó y probó con estos navegadores y rangos de versiones: Chrome 128-138, Edge 128-138, Safari 17-19 y Firefox 130-140. Para dispositivos móviles, la versión v1.295.0 fue creada y probada para Android OS 16 e iOS Safari 17-26. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx b/src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx new file mode 100644 index 00000000000..d281b28d57c --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx @@ -0,0 +1,34 @@ +--- +subject: Browser agent +releaseDate: '2025-08-19' +version: 1.296.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Harvest traces early +bugs: + - Remove event buffer inspection event +security: [] +translationType: machine +--- + +## versión 1.296.0 + +### Característica + +#### Cosecha temprana de traza + +Actualice el agente para manejar el rastreo de sesión de la misma manera que otras características manejan los datos a partir de [1.294.0](https://docs.newrelic.com/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.294.0/). permitiendo cosechas de 16kb de tamaño. + +### Corrección de errores + +#### Eliminar la inspección del búfer de eventos + +Elimina la inspección del búfer de eventos para evitar una pérdida de memoria al usar console.log con el detector de eventos de la ventana `newrelic`. + +## Declaración de apoyo + +New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Las versiones anteriores ya no recibirán soporte cuando lleguen [al final de su vida útil](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/). Las fechas de lanzamiento reflejan la fecha de publicación original de la versión del agente. + +Las nuevas versiones del agente del browser se lanzan a los clientes en pequeñas etapas a lo largo de un periodo de tiempo. Debido a esto, la fecha en que el lanzamiento esté disponible en su cuenta puede no coincidir con la fecha de publicación original. Consulte este [dashboard de estado](https://newrelic.github.io/newrelic-browser-agent-release/) para obtener más información. + +De acuerdo con nuestra [política de compatibilidad de navegadores](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), la versión 1.296.0 del agente del navegador se creó y probó con estos navegadores y rangos de versiones: Chrome 129-139, Edge 129-139, Safari 17-19 y Firefox 131-141. Para dispositivos móviles, la versión v1.296.0 fue creada y probada para Android OS 16 e iOS Safari 17-18.1. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx new file mode 100644 index 00000000000..06eefb60757 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx @@ -0,0 +1,10 @@ +--- +subject: Node API runtime +releaseDate: '2025-07-29' +version: 1.2.122 +translationType: machine +--- + +### Correcciones + +* Se corrigieron las vulnerabilidades de datos de formulario y las vulnerabilidades subyacentes de Ubuntu para abordar vulnerabilidades de seguridad en los tiempos de ejecución de Node API. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx new file mode 100644 index 00000000000..fdfdc17442f --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx @@ -0,0 +1,10 @@ +--- +subject: Node browser runtime +releaseDate: '2025-07-29' +version: 3.0.39 +translationType: machine +--- + +### Mejoras + +* Se corrigieron las vulnerabilidades de datos de formulario y las vulnerabilidades subyacentes de Ubuntu para abordar vulnerabilidades de seguridad en los tiempos de ejecución de Node Browser. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx new file mode 100644 index 00000000000..ec1e32db231 --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-07-29' +version: 1.53.0 +translationType: machine +--- + +### Mejoras + +* Se corrigieron vulnerabilidades relacionadas con `common-lang3` Java y Ubuntu para abordar problemas de seguridad en el tiempo de ejecución de Ping. \ No newline at end of file diff --git a/src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx new file mode 100644 index 00000000000..65d952ef7ac --- /dev/null +++ b/src/i18n/content/es/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-08-13' +version: 1.54.0 +translationType: machine +--- + +### Mejoras + +* Se corrigieron vulnerabilidades relacionadas con Ubuntu para abordar problemas de seguridad en el tiempo de ejecución de Ping. \ No newline at end of file diff --git a/src/i18n/content/es/docs/vulnerability-management/overview.mdx b/src/i18n/content/es/docs/vulnerability-management/overview.mdx index f35a8cbc825..44295407a05 100644 --- a/src/i18n/content/es/docs/vulnerability-management/overview.mdx +++ b/src/i18n/content/es/docs/vulnerability-management/overview.mdx @@ -17,7 +17,7 @@ El software moderno se compone de miles de componentes, y las ofertas de segurid Con Security RX, obtienes: -* Una vista panorámica de todas las vulnerabilidades, incluidas aquellas detectadas por la plataforma New Relic y nuestros socios de integración, como [FOSSA](docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](docs/vulnerability-management/integrations/snyk/), [Dependabot](install/vm/) y más. +* Una visión general de todas las vulnerabilidades, incluidas las detectadas por la plataforma New Relic y nuestros socios de integración como [FOSSA](/docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](/docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](/docs/vulnerability-management/integrations/snyk/), [Dependabot](/install/vm/) y más. * Visibilidad continua del tiempo de ejecución de vulnerabilidades en su aplicación e infraestructura. diff --git a/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx new file mode 100644 index 00000000000..b546fb812c7 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx @@ -0,0 +1,707 @@ +--- +title: Crea tu propio flujo de trabajo +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic +metaDescription: Build custom workflows from scratch using drag-and-drop actions. Learn by example with a real-world EC2 automation scenario. +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Cuando las plantillas no se ajustan a tus necesidades, [Crea la tuya propia](https://onenr.io/0OQM47KgxjG) te permite crear un flujo de trabajo personalizado. Emplee la interfaz de arrastrar y soltar para encadenar acciones del [catálogo de acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) en una automatización que se ajuste a su proceso. + +## Cómo usar esta guía + +Esta guía te muestra cómo construir un flujo de trabajo empleando conceptos y un ejemplo completo. Elige tu ruta de aprendizaje: + +* **Primero aprende los conceptos básicos** → Lee [los conceptos básicos](#core-concepts) y [los patrones de flujo de trabajo](#workflow-patterns) para comprender los fundamentos y luego aplícalos. + +* **Siga el ejemplo** → Vaya al [tutorial del ejemplo](#example-walkthrough) para crear paso a paso un flujo de trabajo de redimensionamiento automático de EC2 + +* **Patrones de referencia** → Emplee la sección de [patrones de flujo de trabajo](#workflow-patterns) como referencia rápida al crear su propio flujo de trabajo. + + + **¿Eres nuevo en el flujo de trabajo?** Empieza por los conceptos básicos y luego sigue el ejemplo. El flujo de trabajo de EC2 demuestra todos los patrones clave en un escenario del mundo real. + + +## ¿Por qué crear un flujo de trabajo personalizado? + +Crea tu propio flujo de trabajo para: + +* **Implemente una lógica de negocio única** que las plantillas no admitan. +* **Integrar múltiples sistemas** más allá de las plantillas estándar +* **Gestionar decisiones complejas** con ramificación condicional +* **Adapta el proceso de aprobación y notificación a las necesidades de tu equipo**. + +## Conceptos básicos [#core-concepts] + +Comprenda estos fundamentos antes de construir: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Concepto** + + **Qué hace** + + **Ejemplo** +
+ Entradas y secretos + + parámetro para credenciales y configuración + + `${{ :secrets:awsKeyId }}` para credenciales, `${{ .inputs.region }}` para configuración. +
+ Catálogo de acciones + + Integración prediseñada (AWS, Slack, base de datos, API) + + Arrastra `aws.ec2.stopInstances` al lienzo del flujo de trabajo +
+ Flujo de datos + + Pasar las salidas entre pasos + + `${{ .steps.getAlert.outputs.entityGuid }}` +
+ Interruptores + + Crea diferentes rutas en función de las condiciones + + `Route by CPU > 90% vs. 70-90% vs. < 70%` +
+ Bucles + + Procesar listas o encuestar para su finalización + + Emplee `type: loop` con `for` y `in` para iterar sobre colecciones. +
+ Puertas de aprobación + + Pausa para las decisiones humanas + + Reacciones lentas antes de operaciones destructivas +
+ Manejo de errores + + Detectar fallos y ejecutar la limpieza + + Patrones try-catch con procedimientos de reversión +
+ + + **Aprende haciendo:** Cada concepto se demuestra en el [ejemplo práctico que aparece](#example-walkthrough) a continuación. Verás entradas, interruptores, bucles y puertas de aprobación funcionando conjuntamente en un flujo de trabajo real. + + +Para conocer patrones detallados de manejo de errores, consulte [mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices#error-handling). + +## Inicio rápido [#quick-start] + +Crea tu primer flujo de trabajo en cinco pasos: + +1. Navegue a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** y seleccione **[Create Your Own](https://onenr.io/0OQM47KgxjG)** +2. Defina el parámetro para las credenciales (del administrador de secretos: `${{ :secrets:keyName }}`), configuración (regiones, tipo de instancia) y datos de tiempo de ejecución (ID de cuenta, ID de alerta) +3. Arrastra acciones del [catálogo](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) y conéctalas con la sintaxis `${{ .steps.stepName.outputs.field }}` para pasar datos. +4. Inserte interruptores para bifurcación condicional, bucles para procesar listas o realizar sondeos, y puertas de aprobación para decisiones humanas. +5. Correr el programa luego de cada sección para detectar errores a tiempo y, a continuación, [inicia o programa](/docs/workflow-automation/create-a-workflow-automation/start-schedule) tu flujo de trabajo. + + + Empieza con 3 pasos, realiza pruebas exhaustivas y luego amplía. Un flujo de trabajo de 5 pasos que funciona correctamente supera un flujo de trabajo de 20 pasos que no funciona. + + +## Patrones clave del flujo de trabajo [#workflow-patterns] + +Cuatro patrones esenciales permiten gestionar la mayoría de los escenarios de automatización. Cada patrón se muestra en el [ejemplo](#example-walkthrough) a continuación. + +### Ramificación condicional con interruptores + +**Emplee interruptores cuando:** Los resultados varíen en función de los datos (comprobaciones de umbral, respuestas de la API, decisiones del usuario). + +**Sintaxis clave:** + +```yaml +- name: hasCompleted + type: switch + switch: + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}" + next: displayError + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}" + next: displaySuccess + next: displayUnexpected # Default path when no condition matches +``` + +**Véalo en acción:** las secciones ["Gestionar la respuesta del equipo"](#handle-team-response) y ["Verificar y limpiar"](#verify-and-clean-up) muestran el enrutamiento de los conmutadores en función de las reacciones de Slack y el estado de AWS SSM. + +### Bucles para procesar listas + +**Emplee bucles cuando:** procese varios elementos o repita acciones. + +**Sintaxis clave:** + +```yaml +# Send progress updates using range loop +- name: progressLoop + type: loop + for: + in: "${{ [range(1; 5)] }}" # Loop 5 times + steps: + - name: wait + type: wait + seconds: 10 + - name: progressMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "${{ .workflowInputs.channel }}" + text: "Resizing in progress..." +``` + +**Véalo en acción:** [Ejecute la sección de redimensionamiento](#execute-the-resize) que emplea `progressLoop` para las actualizaciones de estado. + +### Puertas de aprobación y espera + +**Emplee puntos de aprobación cuando:** se requiera criterio humano antes de operaciones destructivas o se necesite la aprobación de cumplimiento. + +**Sintaxis clave:** + +```yaml +- name: requestApproval + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "#approvals" + text: "Approve? React with :thumbsup: or :thumbsdown:" + +- name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: "${{ .workflowInputs.slackToken }}" + channelID: "${{ .steps.requestApproval.outputs.channelID }}" + threadTs: "${{ .steps.requestApproval.outputs.threadTs }}" + timeout: 300 # Wait 5 minutes for reaction + +- name: checkApproval + type: switch + switch: + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}' + next: handleApproval + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}' + next: handleRejection +``` + +**Para retrasos simples:** + +```yaml +- name: waitBeforeRetry + type: wait + seconds: 60 # Wait 60 seconds before continuing +``` + +**Véalo en acción:** La sección [de solicitud de aprobación del equipo](#request-team-approval) implementa el flujo de trabajo completo de aprobación de Slack. + +### Pasar datos entre pasos + +**Emplee el paso de datos cuando:** La salida de un paso se convierte en la entrada de otro (la base de todo flujo de trabajo). + +**Sintaxis clave:** + +```yaml +# Reference previous step outputs +awsRegion: "${{ .inputs.region }}" +instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}" +``` + +**Véalo en acción:** Todas las secciones demuestran la transferencia de datos; cada paso se basa en los resultados anteriores. + + + **¿Quieres ejemplos de patrones completos?** Consulte [ejemplos de flujo de trabajo](/docs/workflow-automation/workflow-examples) para conocer patrones adicionales que incluyen manejo de errores, reintentos e integración compleja. + + +## Ejemplo práctico: Redimensionamiento automático de EC2 con aprobación [#example-walkthrough] + +Este ejemplo completo muestra cómo crear un flujo de trabajo que redimensione automáticamente las instancias EC2 cuando se produzcan picos de uso de CPU, tras obtener la aprobación del equipo a través de Slack. Muestra la recopilación de datos, la lógica condicional, la integración externa y el manejo de errores en un escenario del mundo real. + + + **¿Eres nuevo en el flujo de trabajo?** Este ejemplo emplea AWS, Slack y lógica de aprobación. Si estás empezando, prueba primero [a enviar el reporte a Slack](/docs/workflow-automation/create-a-workflow-automation/use-a-template#send-report-to-slack). + + +### Requisitos previos [#prerequisites] + +Antes de crear este flujo de trabajo, cerciorar de tener lo siguiente: + +* **AWS**: Credenciales con licencias de EC2 y Systems Manager +* **Slack**: token de bot y canal de notificación +* **New Relic**: condición de alerta monitoreo CPU EC2 +* **Gestor de secretos**: Configurado (ver [gestión de secretos](/docs/infrastructure/host-integrations/installation/secrets-management/)) + +### Descripción general del flujo de trabajo [#workflow-overview] + +**Flujo de alto nivel:** + +1. **Recopilar datos**: Obtener detalles de alertas e instancias de New Relic +2. **Aplicar aprobación**: Enviar mensaje por Slack, esperar respuesta del equipo +3. **Ejecutar cambio de tamaño**: Emplee AWS Systems Manager para cambiar el tamaño de las instancias EC2. +4. **Verificar y limpiar**: Comprobar los resultados, notificar al equipo, eliminar los recursos temporales. + +Este ejemplo muestra patrones clave que empleará en un flujo de trabajo personalizado: consultas a API, ramificación condicional, integración externa, bucles de sondeo y manejo de errores. + +### Entradas del flujo de trabajo [#workflow-inputs] + + + **Si solo lees para comprender los conceptos, puedes saltarte esta parte.** Esta tabla detalla los 12 parámetros que emplea este flujo de trabajo. Puedes consultarlo al construir, pero no es esencial para comprender el flujo. + + +Este flujo de trabajo requiere credenciales, configuración y contexto de tiempo de ejecución como entradas. Los valores confidenciales provienen del administrador de secretos empleando la sintaxis `${{ :secrets:keyName }}`. + +**Categorías de entrada:** + +* **Autenticación**: credenciales de AWS y Slack del administrador de secretos +* **Contexto de la alerta**: ID de cuenta e ID de incidencia de New Relic +* **Configuración**: Región, tipo de instancia, zona horaria, canal Slack + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Nombre del parámetro** + + **Tipo** + + **Valor por defecto** + + **Descripción** +
+ `awsAccessKeyId` + + Cadena + + `${{ :secrets:awsAccessKeyId }}` + + ID de clave de acceso de AWS recuperada del administrador de secretos para la autenticación con los servicios de AWS. +
+ `awsSecretAccessKey` + + Cadena + + `${{ :secrets:awsSecretAccessKey }}` + + Clave de acceso secreta de AWS recuperada del administrador de secretos. Se empareja con el ID de la clave de acceso. +
+ `awsSessionToken` + + Cadena + + `${{ :secrets:awsSessionToken }}` + + token de sesión para credenciales temporales AWS (opcional, se usa con roles de IAM). +
+ `slackToken` + + Cadena + + `${{ :secrets:slackToken }}` + + token del bot para publicar mensajes y leer reacciones en Slack. +
+ `accountId` + + En t + + Requerido + + Tu ID de cuenta de New Relic. Se emplea para consultar detalles de alertas y datos de entidades. +
+ `issueId` + + Cadena + + Requerido + + El ID del problema de la alerta de New Relic que desencadenó este flujo de trabajo. Se proporciona automáticamente cuando se ejecuta el flujo de trabajo a partir de una alerta. +
+ `awsRegion` + + Cadena + + `us-east-2` + + Región AWS donde se ejecutan sus instancias EC2 (por ejemplo, `us-east-1`, `us-west-2`, `eu-west-1`). +
+ `InstanceType` + + Cadena + + `t4g.nano` + + objetivo EC2 tipo de instancia para cambiar el tamaño. Elige en función de tus necesidades de rendimiento y cotización. +
+ `timestampUnit` + + Cadena + + `MILLISECONDS` + + Unidad de tiempo para la timestamp de la alerta. Normalmente `MILLISECONDS` o `SECONDS`. +
+ `timezoneId` + + Cadena + + `America/Los_Angeles` + + Zona horaria para mostrar la hora de activación de la alerta en los mensajes de Slack (por ejemplo, `America/New_York`, `Europe/London`, `Asia/Tokyo`). +
+ `pattern` + + Cadena + + `MM-dd-yyyy HH:mm` + + Formato de fecha y hora para mostrar la marca de tiempo. Emplea patrones SimpleDateFormat de Java. +
+ `channel` + + Cadena + + Requerido + + ID del canal de Slack (no el nombre) donde se publican las notificaciones. Puedes encontrarlo en los detalles del canal de Slack. +
+ + + +## Crea el flujo de trabajo paso a paso [#step-by-step-workflow] + +Ahora vamos a construir cada parte del flujo de trabajo. Cada paso incluye las acciones específicas que se deben agregar y los patrones de flujo de trabajo que demuestran. + + + + ### Recopilar contexto de alerta [#gather-alert-context] + + Consulta las API y la base de datos antes de tomar medidas. Esto garantiza que tengas el contexto completo. + + El flujo de trabajo recopila información de alertas e instancias EC2 mediante tres acciones: + + * **`getAlertDetails`**: Llama a API de NerdGraph ( API GraphQL de New Relic) para obtener los metadatos de la alerta: hora de activación, nombre de la condición y entidad afectada. + + * **`activatedDateTime`**: Convierte la timestamp a un formato legible como "01-24-2025 14:30" para los mensajes de Slack. + + * **`impactedEC2Instance`**: consulta NRDB (New Relic base de datos) para encontrar el ID de instancias EC2 y el tipo actual. + + Workflow diagram showing three steps: getAlertDetails queries NerdGraph API, activatedDateTime converts timestamp, and impactedEC2Instance retrieves instance details from NRDB + + **Por qué esto es importante:** Sin estos detalles, no se pueden crear mensajes de Slack significativos ni dirigir a las instancias EC2 correctas. + + + + ### Aplicar aprobación del equipo [#request-team-approval] + + Conectar a herramientas de colaboración como Slack, PagerDuty o ServiceNow para puntos de decisión humana. + + El flujo de trabajo envía los detalles a Slack y espera una respuesta: + + * **`IssueDetected`**: Publica detalles de alerta, tipo de instancia actual y cambio de tamaño propuesto en Slack. Aplicar al equipo que reaccione con `:+1:` (aprobar) o `:-1:` (cancelar). + + * **`GetUserReaction`**: Hace una pausa de 5 minutos (300 segundos) esperando una reacción. + + * **`checkQuery` (Interruptor)**: Rutas basadas en la reacción: + + * **`:+1:`** → Comienza a redimensionar + * **`:-1:`** → Detener flujo de trabajo + * **Otro** → símbolo para reacción válida, bucle de retorno + + Workflow diagram showing user approval process: IssueDetected posts Slack message, GetUserReaction waits for response, checkQuery evaluates reactions with three conditions for approval, cancellation, or unexpected responses + + + **Problema común:** emplee **el ID** del canal de Slack (`C01234ABCD`), no el nombre del canal. Lo encontrarás en los detalles del canal de Slack. Ver [resolución de problemas](#common-issues) para más. + + + + + ### Gestionar la respuesta del equipo [#handle-team-response] + + Emplee interruptores para crear diferentes rutas en función de los valores de los datos o la entrada del usuario. + + Las ramificaciones del flujo de trabajo se basan en la reacción: + + * **`unexpectedReaction`**: Explica las reacciones válidas y vuelve a esperar. + * **`gotCancelReaction`**: Confirma la cancelación, pasa a la finalización. Sin cambios en la infraestructura. + * **`gotYesReaction`**: Confirma la aprobación, procede a cambiar el tamaño. + + + **Patrón de puertas de aprobación:** Emplee interruptores como este cuando necesite criterio humano antes de realizar cambios arriesgados. Este patrón funciona con reacciones de Slack, confirmaciones de PagerDuty, respuestas por email o webhooks personalizados. + + + + + ### Ejecutar el cambio de tamaño [#execute-the-resize] + + Emplee un token único para evitar operaciones duplicadas. Emplee bucles para comprobar el estado de las operaciones de larga duración. + + El flujo de trabajo redimensiona la instancia a través de AWS Systems Manager (SSM): + + * **`createSsmDocument`**: Crea un documento de automatización de SSM que detiene la instancia, modifica el tipo y la resetear. + * **`generateIdempotencyToken`**: Crea un UUID único. Evita cambios de tamaño duplicados si el flujo de trabajo se ejecuta dos veces. + * **`startResizing`**: Ejecuta el documento SSM con ID de la instancia y nuevo tipo. + * **`progressLoop` (Bucle)**: Publica actualizaciones de Slack cada 10 segundos (5 veces en total). + * **`waitForCompletion`**: Consulta el estado de SSM con un tiempo de espera de 2 minutos. + + + **¿Por qué SSM?** Systems Manager proporciona manejo de errores, verificación de estado y logs de auditoría de CloudTrail. Mejor que una llamada directa a API de EC2. + + + + **Problema común:** Cerciorar de que las credenciales de AWS tengan licencias `ec2:StopInstances`, `ec2:ModifyInstanceAttribute`, `ec2:StartInstances` y `ssm:*`. Las licencias faltantes provocan un fallo silencioso. + + + + + ### Verificar y limpiar [#verify-and-clean-up] + + Planee para los fracasos y gestione los recursos temporales independientemente del resultado. + + El flujo de trabajo comprueba los resultados y elimina los recursos temporales: + + * **`hasCompleted` (Interruptor)**: Se ramifica según el estado de SSM (éxito/fallo/tiempo de espera agotado). + * **`displaySuccess`**: Registra el éxito en New Relic. + * **`sendSuccessMessage`**: Confirma la finalización en Slack. + * **`displayError`**: Registra los detalles del error para la resolución de problemas. + * **`displayUnexpected`**: Registra estados inusuales (cancelación manual, etc.). + * **`cleanupSsmDocument`**: Elimina el documento SSM temporal. + * **`sendSSMCleanMessage`**: Confirma la limpieza en Slack. + * **`workflowCompleted`**: Mensaje de finalización final (se ejecuta en caso de éxito o cancelación). + + + * **Siempre limpia.** Estructura el flujo de trabajo para que la limpieza se ejecute incluso cuando fallen los pasos anteriores. Esto evita fugas de recursos y cargos inesperados de AWS. + * **Problema común:** Si SSM agota el tiempo de espera, las instancias EC2 aún pueden estar en transición entre estados. Consulte AWS Console para verificar el estado real de la instancia antes de volver a ejecutarla. + + + + +## Próximos pasos + +### Ejecutar y gestionar + +* **[Iniciar y programar el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: Activar manualmente o programar automáticamente. +* **[Gestionar el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: editar, versionar, clonar o desactivar el flujo de trabajo. + +### Mejorar + +* **[mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Manejo de errores, gestión de secretos, rendimiento, testing. +* **[Catálogo de acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: AWS, Azure, GCP, HTTP, transformaciones de datos. +* **[Ejemplos de flujo de trabajo](/docs/workflow-automation/workflow-examples)**: más escenarios de automatización del mundo real. + +### Escala + +* **[flujo de trabajo API de automatización](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: desplegar vía API para infraestructura como código. +* **[Límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Tiempos de espera, límites de acciones, restricciones de carga útil. \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx new file mode 100644 index 00000000000..761c276ef46 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx @@ -0,0 +1,164 @@ +--- +title: Gestionar la automatización del flujo de trabajo +tags: + - Workflow Automation + - workflow + - build a workflow using New Relic +metaDescription: 'Navigate the workflow dashboard to view, edit, duplicate, delete, and monitor workflows in New Relic.' +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +El [dashboardde automatización de flujo de trabajo](https://onenr.io/0gR7XE8LXjo) proporciona una ubicación central para ver, gestionar y monitorear todo el flujo de trabajo en su cuenta. Emplee el dashboard para editar la configuración, realizar un seguimiento del historial de versiones, gestionar los horarios de ejecución y solucionar problemas. + +## Tareas comunes + +Acceso rápido a las operaciones de gestión del flujo de trabajo: + +* **[Ver flujo de trabajo](#view-workflows)** - Acceder dashboard y filtrar flujo de trabajo +* **[Editar un flujo de trabajo](#edit-a-workflow)** : actualizar la configuración o los ajustes +* **[Gestionar versiones](#manage-versions)** : comprender el control de versiones automático y fijar versiones para la programación. +* **[Duplicar un flujo de trabajo](#duplicate-a-workflow)** - Copiar flujo de trabajo al adaptar plantillas +* **[Eliminar un flujo de trabajo](#delete-a-workflow)** - Eliminar flujo de trabajo permanentemente + +## Antes de que empieces + +Antes de gestionar el flujo de trabajo, cerciorar de tener: + +* Una cuenta activa New Relic con acceso a flujo de trabajo Automation. +* Al menos un flujo de trabajo en su cuenta (a partir de una plantilla o uno personalizado). +* Editar y eliminar licencias para flujo de trabajo. + +**¿Eres nuevo en el flujo de trabajo?** Empieza por [usar una plantilla](/docs/workflow-automation/create-a-workflow-automation/use-a-template) o [crear tu propio flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/create-your-own) para construir tu primer flujo de trabajo. + +## Ver flujo de trabajo [#view-workflows] + +El dashboard flujo de trabajo muestra todos los flujos de trabajo de su cuenta con información clave para ayudarlo a gestionarlos. + +### Acceder al dashboard + +1. Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + +2. El dashboard muestra todo el flujo de trabajo con la siguiente información: + + * **Nombre**: identificador de flujo de trabajo que asignaste durante la creación + * **Descripción**: Propósito o función del flujo de trabajo + * **Estado**: Estado actual (Activo, Inactivo, Fallido) + * **Versión**: Número de versión actual para el seguimiento de cambios + * **Última ejecución**: marca de tiempo de la ejecución más reciente + * **Creado por**: usuario que creó el flujo de trabajo + +### Filtrar y buscar flujo de trabajo + +Emplee las opciones de búsqueda y filtro para localizar un flujo de trabajo específico: + +* **Barra de búsqueda**: Introduzca el nombre del flujo de trabajo o palabras clave de la descripción. +* **Filtro de estado**: Mostrar solo flujos de trabajo activos, inactivos o fallidos +* **Opciones de clasificación**: Ordenar por nombre, último tiempo de ejecución o fecha de creación + +## Editar un flujo de trabajo [#edit-a-workflow] + +Actualizar el nombre, la descripción o la configuración del flujo de trabajo. Acceda a las opciones de gestión del flujo de trabajo a través del menú "Más opciones" (tres puntos verticales) situado junto al nombre de cada flujo de trabajo. + +1. Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + +2. Seleccione su flujo de trabajo de la lista. + +3. Actualizar los detalles del flujo de trabajo: + + * **Nombre**: Cambiar el identificador del flujo de trabajo + * **Descripción**: Modificar la descripción del propósito del flujo de trabajo + * **Configuración**: Ajustar parámetros de entrada, acciones o lógica + +4. Haz clic en **Save** + +## Gestionar versiones [#manage-versions] + +La automatización de flujo de trabajo crea automáticamente una nueva versión cada vez que actualiza una definición de flujo de trabajo. Todas las versiones anteriores siguen estando disponibles como referencia. + +### Fijación de versiones para la programación + +Al programar un flujo de trabajo, debe vincularlo a una versión específica. Este requisito garantiza que las ejecuciones programadas continúen ejecutando la misma versión probada incluso cuando se actualiza la definición del flujo de trabajo. + +**Fijación de versión de soporte de inicio y programación de flujo de trabajo:** + +* Al programar un flujo de trabajo, especifique qué versión ejecutar. +* Al iniciar manualmente la ejecución de un flujo de trabajo, seleccione la versión que desea ejecutar. +* Los horarios existentes seguirán empleando su versión fijada hasta que los actualices. + +Esto te permite: + +* Actualizar el flujo de trabajo sin afectar los horarios de ejecución +* Prueba manualmente las nuevas versiones antes de actualizar los horarios. +* Mantener la estabilidad para la producción flujo de trabajo. + +## Duplicar un flujo de trabajo [#duplicate-a-workflow] + +Duplicar flujo de trabajo cuando necesite adaptar una plantilla o un flujo de trabajo existente para un propósito diferente, manteniendo intacto el original. + +1. Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Localiza el flujo de trabajo que deseas duplicar +3. Haz clic en los puntos suspensivos (tres puntos verticales). +4. Seleccionar **Duplicate** +5. El sistema crea una copia con "(Copia)" añadido al nombre +6. Renombra y personaliza el flujo de trabajo duplicado según tus necesidades. + +**Escenarios comunes de duplicación:** + +* Adaptar una plantilla de flujo de trabajo a su caso de uso específico +* Crear un flujo de trabajo para un equipo diferente con requisitos similares +* Experimentar con cambios significativos conservando el original + + + **Evite duplicaciones innecesarias:** No duplique el flujo de trabajo para fines de control de versiones o reversión; el sistema crea automáticamente versiones cuando actualiza el flujo de trabajo. La duplicación excesiva puede provocar que alcances los límites del flujo de trabajo. Consulte [la sección "Gestionar versiones"](#manage-versions) para obtener información sobre el control de versiones automático. + + +## Eliminar un flujo de trabajo [#delete-a-workflow] + +Elimina el flujo de trabajo que ya no necesitas. + +1. Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Localiza el flujo de trabajo que deseas eliminar +3. Haz clic en el menú de más opciones (tres puntos verticales). +4. Seleccionar **Delete** +5. Confirma la eliminación en el cuadro de diálogo + + + Eliminar un flujo de trabajo borra todas las versiones y el historial de ejecución. Esta acción no se puede deshacer. Si prevés necesitar el flujo de trabajo más adelante, considera desactivarlo en lugar de eliminarlo. + + +**Lo que se elimina:** + +* Todas las versiones del flujo de trabajo +* Todo el historial de ejecución y los logs +* Todas las ejecuciones programadas asociadas con el flujo de trabajo + +**Antes de eliminar, verifique:** + +* Ninguna automatización crítica depende de este flujo de trabajo. +* Tienes una copia de seguridad por si la necesitas más adelante. +* Todos los recorridos programados están identificados y contabilizados. + +## Próximos pasos + +Tras familiarizarte con el dashboard del flujo de trabajo, explora estos recursos: + +**Ejecutar y monitorear el flujo de trabajo:** + +* **[Iniciar y programar flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: active el flujo de trabajo manualmente o configure horarios automatizados + +**Mejora tu flujo de trabajo:** + +* **[Mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Patrones para manejo de errores, rendimiento y confiabilidad. +* **[Límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprender las restricciones de tiempo de espera, acción y carga útil. + +**Crear más flujo de trabajo:** + +* **[Emplee una plantilla](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: desplegar flujo de trabajo prediseñado para escenarios comunes +* **[Crea tu propio flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: Crea automatizaciones personalizadas desde cero. \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx new file mode 100644 index 00000000000..a7b2fd3f9a5 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx @@ -0,0 +1,237 @@ +--- +title: Inicio y programación flujo de trabajo +tags: + - workflow automation + - workflow + - start a workflow automation + - start workflow automation on demand + - schedule workflows +metaDescription: Trigger workflows manually or schedule them to run automatically at specified times using NerdGraph APIs. +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Una vez que creaste un flujo de trabajo, puedes ejecutarlo manualmente cuando lo necesites o programarlo para que se ejecute automáticamente en momentos específicos. Ambos métodos emplean la [API de NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) para activar la ejecución del flujo de trabajo. + +## Elige tu método de activación + +Seleccione el enfoque adecuado para su caso de uso: + +| **Emplear bajo demanda** | **Uso programado** | +| ---------------------------------- | ------------------------------------------- | +| Probando nuevo flujo de trabajo | revisiones médicas periódicas | +| Aprobación manual flujo de trabajo | Procesamiento periódico de datos | +| respuestas activadas por alertas | Reportes diarios/semanales | +| tareas de mantenimiento ad hoc | ventanas de mantenimiento programado | +| Operaciones únicas | Copias de seguridad o limpiezas recurrentes | + +## Antes de que empieces + +Antes de activar el flujo de trabajo, cerciorar de tener: + +* **Flujo de trabajo creado**: una definición de flujo de trabajo ya implementada en su cuenta (a partir de [una plantilla](/docs/workflow-automation/create-a-workflow-automation/use-a-template) o [personalizada](/docs/workflow-automation/create-a-workflow-automation/create-your-own)). +* **ID de cuenta**: Su ID de cuenta de New Relic (que se encuentra en [la configuración de la cuenta](/docs/accounts/accounts-billing/account-structure/account-id)). +* **Nombre de flujo de trabajo**: El nombre exacto de su definición de flujo de trabajo. +* **Datos de entrada requeridos**: Valores para cualquier parámetro que espere su flujo de trabajo. +* **Secretos configurados**: credenciales AWS, token de Slack u otros secretos almacenados en [el administrador de secretos](/docs/infrastructure/host-integrations/installation/secrets-management/). + + + **¿Eres nuevo en el flujo de trabajo?** Crea tu primer flujo de trabajo antes de intentar activarlo. Comience con [Emplee una plantilla](/docs/workflow-automation/create-a-workflow-automation/use-a-template) para flujo de trabajo prediseñado. + + +## Ejecutar flujo de trabajo bajo demanda [#on-demand] + +Activa el flujo de trabajo manualmente usando la [APIStartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run). Esto ejecuta el flujo de trabajo inmediatamente con los datos de entrada que proporcione. + +### Ejemplo: invocar una función Lambda AWS + +La siguiente definición de flujo de trabajo invoca una función Lambda AWS y registra la salida. Reemplace `12345678` con su ID de cuenta de New Relic. + +```yaml + name: lambda1 + + workflowInputs: + username: + type: String + defaultValue: "User" + key: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_ACCESS_KEY_ID }}" + access: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SECRET_ACCESS_KEY }}" + token: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SESSION_TOKEN }}" + region: + type: String + defaultValue: us-east-1 + + steps: + - name: invoke1 + type: action + action: aws.lambda.invoke + version: 1 + inputs: + awsAccessKeyId: ${{ .workflowInputs.key }} + awsSecretAccessKey: ${{ .workflowInputs.access }} + awsSessionToken: ${{ .workflowInputs.token }} + region: ${{ .workflowInputs.region }} + functionName: hello-you + payload: + user: ${{ .workflowInputs.username }} + + - name: logOutput + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'The lambda function message output is:${{ .steps.invoke1.outputs.payload.body }}' +``` + +Para iniciar este flujo de trabajo, emplee la siguiente mutación de NerdGraph. Antes de ejecutar esta mutación, cerciorar de almacenar sus credenciales de AWS empleando la mutación `secretsManagementCreateSecret`. Para obtener más información, consulte [Introducción a la gestión de secretos](/docs/apis/nerdgraph/examples/nerdgraph-secrets-management). + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "Julien"} + ] + ) { + runId + } +} +``` + +**Explicación del parámetro:** + +* `scope`: El ID de la cuenta donde se almacena la definición de su flujo de trabajo +* `definition`: El nombre del flujo de trabajo a ejecutar (debe coincidir con el campo `name` de la definición de su flujo de trabajo). +* `workflowInputs`: pares de valores principales que anulan los valores predeterminados en la sección `workflowInputs` de su definición de flujo de trabajo + +La mutación devuelve un `runId` (por ejemplo, `7bd25287-2af8-42e1-b783-80f4e760a40b`). Emplee este ID para consultar los logs y ver la salida: + +Workflow automation logs showing the Lambda function output + +## Horario de trabajo [#scheduled] + +Programe el flujo de trabajo para que se ejecute automáticamente en momentos específicos empleando la [APICreateSchedule](/docs/workflow-automation/workflow-automation-apis). El flujo de trabajo programado ejecuta tareas recurrentes sin intervención manual. + +**Cuándo programar el flujo de trabajo:** + +* revisiones médicas periódicas +* Procesamiento periódico de datos +* Reportes diarios/semanales +* ventanas de mantenimiento programado +* Copias de seguridad o limpiezas recurrentes + +### Referencia de expresión Cron + +Los horarios usan expresiones cron para definir cuándo se ejecuta el flujo de trabajo. Formato: `minute hour day month weekday` + +| **Patrón** | **Descripción** | **Ejemplo de caso de uso** | +| -------------- | --------------------------------------- | --------------------------------------- | +| `0 9 * * *` | Todos los días a las 9:00 AM | controles de salud matutinos diarios | +| `0 9 * * 1-5` | Todos los días laborables a las 9:00 AM | Operaciones del día comercial | +| `0 */6 * * *` | Cada 6 horas | Operaciones de sincronización regulares | +| `0 0 1 * *` | Primer día del mes a medianoche | Reportes mensuales | +| `*/15 * * * *` | Cada 15 minutos | Encuestas frecuentes | +| `0 0 * * 0` | Todos los domingos a medianoche | Tareas de limpieza semanales | + + + **Sintaxis de Cron:** `*` significa "cada", `/` significa "cada n-ésimo", `-` significa "rango". Ejemplo: `0 9 * * 1-5` = En el minuto 0, hora 9, todos los días, todos los meses, de lunes a viernes. + + +### Ejemplo: Programar un chequeo médico diario + +El siguiente ejemplo programa el flujo de trabajo `lambda1` para que se ejecute todos los días a las 9 AM, hora del este: + +```graphql +mutation { + workflowAutomationCreateSchedule( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Configure the schedule + schedule: { + # Cron expression: minute hour day month weekday + # "0 9 * * *" = every day at 9:00 AM + cronExpression: "0 9 * * *" + + # Timezone for the schedule + timezone: "America/New_York" + + # Optional: Schedule name for identification + name: "daily-lambda-health-check" + + # Optional: Add a description + description: "Runs Lambda health check every morning at 9 AM" + } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "HealthCheckBot"} + ] + ) { + scheduleId + } +} +``` + +**Lo que recibes a cambio:** + +* `scheduleId`Identificador único del horario (empléelo para actualizar o eliminar el horario posteriormente). + +### Gestionar horarios + +Luego de crear un horario: + +* **Ver programaciones activas**: Consulte todas las ejecuciones programadas en el [dashboardflujo de trabajo.](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs) +* **Programación de actualizaciones**: Emplee la API UpdateSchedule para cambiar la frecuencia o las entradas. +* **Eliminar programación**: Emplee la API DeleteSchedule para detener las ejecuciones recurrentes. + +Para obtener documentación API completa, consulte [API de automatización de flujo de trabajo](/docs/workflow-automation/workflow-automation-apis). + +## Próximos pasos + +¡Tu flujo de trabajo está funcionando! Esto es lo que debes hacer a continuación: + +**Monitorear y gestionar:** + +* **[Gestionar el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: Ver el historial de ejecución, consultar los logs y solucionar problemas. +* **[Solucionar problemas de flujo de trabajo](/docs/workflow-automation/troubleshooting)**: resolver problemas comunes de ejecución + +**Optimizar para la producción:** + +* **[mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Manejo de errores, rendimiento y patrones de confiabilidad +* **[Límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprenda los límites de tiempo de espera y las restricciones. + +**Amplíe su flujo de trabajo:** + +* **[Catálogo de acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: explora todas las integraciones disponibles. +* **[API de automatización de flujo de trabajo](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: gestión programática del flujo de trabajo \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx new file mode 100644 index 00000000000..f52ca3cd174 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx @@ -0,0 +1,284 @@ +--- +title: Emplee una plantilla para crear una automatización de flujo de trabajo. +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic + - workflow template +metaDescription: 'Jump-start your automation with pre-built workflow templates. Deploy in minutes, customize to your needs, and automate common tasks.' +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Las plantillas proporcionan flujos de trabajo preconfigurados para escenarios comunes: envío de reportes a Slack, reversión de despliegues, cambio de tamaño de instancias EC2 y más. Despliega en minutos y personalízalo para que se ajuste al proceso de tu equipo. + +## ¿Por qué usar plantillas? + +* **Empieza más rápido**: despliega automatizaciones funcionales en minutos. +* **Siga las mejores prácticas**: emplee patrones probados y un manejo adecuado de errores. +* **Aprende con ejemplos**: observa cómo se conectan las acciones y cómo fluyen los datos. +* **Reduzca los errores**: comience con la configuración probada + +## Antes de que empieces + +La mayoría de las plantillas necesitan credenciales e integración: + +* **Plantillas de AWS**: [credenciales de AWS](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials) con licencias (EC2, API Gateway, Systems Manager o SQS). +* **Notificación de Slack**: Aplicación de Slack con token de bot y acceso a canales. +* **Todas las plantillas**: GUID de cuentas y entidades New Relic (identificador único para los recursos monitorizados). + + + **¿Aún no tienes tus credenciales?** Primero, explore las plantillas. Configura las credenciales antes de arruinar. + + +## desplegar una plantilla + + + + ### Encuentra la plantilla adecuada + + Explore la [biblioteca de plantillas](#workflow-automation-templates) a continuación. Cada una muestra qué hace, cuándo usarla, los requisitos y cómo funciona. + + + + ### desplegar y configurar + + 1. Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + 2. Seleccione **Use a Template** + 3. Elige tu plantilla + 4. Complete los insumos (credenciales, GUID de entidad, consulta, canales) + 5. Seleccionar **Deploy** + + Tu flujo de trabajo ya está activo. + + + + ### Probar y verificar + + Prueba antes de su uso en producción: + + 1. Activar manualmente (ver [Iniciar flujo de trabajo bajo demanda](/docs/workflow-automation/create-a-workflow-automation/start-schedule#on-demand)) + 2. Monitorear la ejecución en el historial de ejecución + 3. Revisar los resultados (mensajes de Slack, cambios en AWS, logs). + 4. Revisar errores, ajustar la configuración + + + **Primero, realice pruebas en un entorno que no sea de producción.** Algunas plantillas modifican la infraestructura. Validar antes de su uso en producción. + + + + +## Personaliza tu plantilla + +Modificar flujo de trabajo luego del despliegue: + +* **Agregar lógica condicional**: Omitir pasos según las condiciones +* **Plantillas de cadena**: Emplee salidas como entradas para otros flujos de trabajo. +* **Ajustar notificación**: cambiar formatos, destinatarios, canales +* **Agregar acciones personalizadas**: Incluir requests HTTP o transformaciones de datos. + +Consulte [la sección "Crea tu propio flujo de trabajo"](/docs/workflow-automation/create-a-workflow-automation/create-your-own) para obtener más detalles. + +## plantillas de resolución de problemas + +Si su flujo de trabajo falla o no se comporta como se esperaba: + +1. **Verifique el historial de ejecución**: Vaya a **Workflow Automation > \[Su flujo de trabajo] > Run History** para ver los logs de ejecución y el mensaje de error + +2. **Revisar problemas comunes**: Ver [resolución de problemas flujo de trabajo Automatización](/docs/workflow-automation/troubleshooting) para soluciones a: + + * Errores de credenciales y licencias de AWS + * Problemas de integración de Slack + * Problemas con el GUID de la entidad + * Fallos de consulta NRQL + * Tiempos de espera del flujo de trabajo + * Resolución de problemas específica de la plantilla + + + **Pruebe las plantillas de forma segura**: pruebe siempre primero en un entorno sin producción. Las plantillas que modifican la infraestructura (EC2, API Gateway) pueden afectar la disponibilidad si están mal configuradas. + + +## plantillas de automatización de flujo de trabajo + + + + **Qué hace:** + + Consultar datos New Relic con NRQL (New Relic Query Language), formatear los resultados como CSV y publicarlos en Slack. + + **Cuándo usarlo:** + + Automatiza reportes periódicos: resúmenes diarios de rendimiento, tasa de errores semanal, volúmenes de transacciones por hora o métrica personalizada. + + **Lo que necesitarás:** + + * **Slack**: token de bot con licencias para publicar en el canal + * **New Relic**: Acceso a la cuenta y consulta NRQL válida + + **Cómo funciona:** + + 1. Ejecuta tu consulta NRQL + 2. Convierte los resultados a formato CSV. + 3. Publicaciones en Slack + 4. Registra estado + + + + **Qué hace:** + + Detecta problemas de implementación y revierte AWS API Gateway a la configuración anterior, luego de obtener la aprobación del equipo. + + **Cuándo usarlo:** + + Revertir el mal despliegue que aumenta los errores, rompe la integración o causa incidentes. Red de seguridad para cambios de alto riesgo. + + **Lo que necesitarás:** + + * **AWS**: Licencias de API Gateway y Systems Manager + * **Slack**: Aplicación para notificación y aprobación + * **New Relic**: GUID de entidad de API Gateway + + **Cómo funciona:** + + 1. Recupera el historial de despliegue + 2. Se relaciona con el tema actual + 3. Aplicar aprobación de Slack + 4. Ejecuta la reversión si se aprueba + 5. Avisa al equipo y limpia. + + + **Se requiere aprobación manual.** No se revertirá sin la aprobación del equipo a través de las reacciones de Slack. + + + + + **Qué hace:** + + Redimensiona automáticamente las instancias EC2 cuando se producen picos de uso de CPU o recursos. + + **Cuándo usarlo:** + + Gestionar picos de CPU durante picos de tráfico, escalar instancias que alcanzan límites, gestionar patrones de carga impredecibles. + + **Lo que necesitarás:** + + * **AWS**: Licencias de EC2 y Systems Manager + * **Slack**: Aplicación para notificación y aprobación + * **New Relic**: condición de alerta monitoreo EC2, [AWS CloudWatch Metric Streams](https://docs.newrelic.com/install/aws-cloudwatch/), [integración de monitoreo EC2](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) + + + **Emplee CloudWatch Metric Streams.** Proporciona una cobertura completa de las métricas AWS, incluyendo espacios de nombres personalizados. + + + **Cómo funciona:** + + 1. Recibe una alerta e identifica la instancia. + 2. Aplicar aprobación de Slack + 3. Crea un documento de automatización + 4. Detiene, modifica e inicia la instancia + 5. Actualiza el progreso y realiza limpiezas + + + + **Qué hace:** + + Obtiene JSON de páginas de estado externas, analiza el estado de los componentes y registra la información en New Relic. + + **Cuándo usarlo:** + + Monitorear la dependencia de terceros (procesadores de pago, proveedores de autenticación, servicios de datos), correlacione las interrupciones con sus problemas, cree un dashboard unificado. + + **Lo que necesitarás:** + + * **AccesoAPI **: Estado público extremo que devuelve JSON + * **New Relic**: Cuenta para el logging + + **Cómo funciona:** + + 1. Obtiene JSON de extremo + 2. Analiza el estado de los componentes + 3. Categoriza el estado operativo + 4. Logs en New Relic con filtros + + + **Programar sesiones cada 5-15 minutos** para crear una vista histórica de la fiabilidad de terceros. + + + + + **Qué hace:** + + Monitorear el estado de la aplicación luego de su implementación y envía notificaciones cuando surgen problemas. + + **Cuándo usarlo:** + + Monitorear las nuevas versiones luego del despliegue, detecte problemas exclusivos de producción y active el flujo de trabajo de reversión en caso de degradación del estado. + + **Lo que necesitarás:** + + * **New Relic**: GUID de entidad para monitoreo + * **notificación** (elija una o ambas): licencias de AWS SQS o webhook HTTP extremo + + **Cómo funciona:** + + 1. Monitorea la salud cada 1-5 minutos + 2. Evalúa la gravedad de la alerta + 3. Envía notificación (SQS/webhook) cuando está degradado + 4. Registra todas las comprobaciones de estado. + 5. Continúa hasta que se detiene o se recupera + + + **Úselo con [seguimiento de cambios](/docs/change-tracking/change-tracking-introduction)** para correlacionar problemas con el despliegue. + + + + + **Qué hace:** + + Ejecuta consultas SQL contra el catálogo de datos de New Relic empleando NRLens (herramienta de consulta avanzada). + + **Cuándo usarlo:** + + Análisis complejo más allá de NRQL: uniones de varias tablas, análisis estadístico, reportes personalizados que combinan métricas/eventos/registros. + + **Lo que necesitarás:** + + * **NRLens**: Credenciales para SQL Consulta Gateway + * **New Relic**: ID de organización y cuenta + + **Cómo funciona:** + + 1. Se conecta con NRLens + 2. Ejecuta SQL + 3. Recupera resultados + 4. Registros en New Relic + 5. Admite la programación + + + **NRLens extiende NRQL.** Emplee NRQL para consulta de tiempo real, NRLens SQL para carga de trabajo analítica compleja. + + + + +## Próximos pasos + +### Ejecutar y gestionar + +* **[Iniciar y programar el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: Activar manualmente o programar automáticamente +* **[Gestionar el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: Editar, duplicar o eliminar el flujo de trabajo + +### Construir personalizado + +* **[Crea tu propio flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: Construye desde cero con lógica personalizada. +* **[mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Patrones para automatizaciones confiables y listas para producción + +### Escala + +* **[API de automatización de flujo de trabajo](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: integración con CI/CD o infraestructura como código +* **[Límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: tiempos de espera, límites de velocidad, restricciones \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/introduction-to-workflow.mdx b/src/i18n/content/es/docs/workflow-automation/introduction-to-workflow.mdx new file mode 100644 index 00000000000..12e6ea4e2c2 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/introduction-to-workflow.mdx @@ -0,0 +1,148 @@ +--- +title: Introducción a la automatización del flujo de trabajo. +tags: + - workflow automation + - workflow + - automation +metaDescription: Automate routine tasks and incident responses with Workflow Automation in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +La automatización del flujo de trabajo conecta New Relic con sus herramientas existentes para automatizar la respuesta a incidentes, la gestión de infraestructura y las tareas operativas, sin necesidad de escribir código. Crea flujos de trabajo que respondan a alertas, se integren con AWS y Slack, gestionen aprobaciones y ejecuten lógica de automatización compleja. + +Screenshot showing the workflow automation interface + +## Beneficios clave + +* **Respuesta a incidentes más rápida**: cambie automáticamente el tamaño de las instancias EC2, revierta el despliegue o resetear los servicios cuando se activen alertas; no se requiere intervención manual +* **Conecta tus herramientas**: Integra New Relic con AWS, Slack, Jira, ServiceNow y cualquier API HTTP para enviar datos de alertas enriquecidos a la plataforma de trabajo de tu equipo. +* **Agregar puntos de aprobación**: Incluir supervisión humana en el flujo de trabajo crítico; aplicar confirmación del equipo antes de ampliar la infraestructura de producción o ejecutar reversiones. +* **Gestiona la complejidad**: Emplea lógica condicional, bucles y transformaciones de datos para automatizar tus procesos operativos únicos. + +## Casos de uso comunes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Categoría + + Ejemplos +
+ **respuesta ads** + + Autocorregir problemas, revertir despliegues fallidos, redimensionar la infraestructura en función de las alertas. +
+ **Gestión de infraestructura** + + Escalar servicios según cronogramas, gestionar recursos de AWS, ejecutar runbooks automáticamente. +
+ **Notificación** + + Enviar alertas enriquecidas a Slack, generar reportes programados, formatear datos como CSV. +
+ **Integracion** + + Conectar a cualquier API, sincronice datos entre sistemas, actualice la plataforma de venta de entradas. +
+ +Consulta la página de [ejemplos de flujo de trabajo](/docs/workflow-automation/workflow-examples) para ver escenarios detallados y plantillas listas para usar. + +## Empezar + +Elige tu camino en función de lo que quieras construir: + + + + Usar una plantilla Crear flujo de trabajo personalizado Configurar integración + + + + + Implementar flujos de trabajo preconfigurados para escenarios comunes: envío de reportes a Slack, reversión de despliegues, cambio de tamaño de instancias EC2 y más. + + 1. Explora [las plantillas disponibles](/docs/workflow-automation/create-a-workflow-automation/use-a-template) + 2. Seleccione una plantilla que se ajuste a su caso de uso. + 3. Configurar entradas (credenciales, GUID de entidad, consulta) + 4. desplegar y probar + + + + Crea un flujo de trabajo desde cero empleando la interfaz de arrastrar y soltar. Encadena acciones, agrega lógica condicional e intégralo con tus herramientas. + + 1. Revisa el [ejemplo de redimensionamiento automático de EC2.](/docs/workflow-automation/create-a-workflow-automation/create-your-own) + 2. Comprender los patrones de flujo de trabajo (interruptores, bucles, aprobaciones). + 3. Explora [las acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)disponibles + 4. Construye de forma incremental y prueba cada paso. + + + + Configure las credenciales y el canal de notificación para que el flujo de trabajo pueda interactuar con servicios externos. + + **Flujo de trabajo AWS **: [configurar las credenciales AWS ](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)(roles de IAM, usuario o token de sesión) + + **Notificación**: [Crear destinos](/docs/workflow-automation/setup-and-configuration/create-destinations) (Slack, email, webhooks) + + + + +## Próximos pasos + +Tras crear tu primer flujo de trabajo, aprende a gestionarlo y optimizarlo: + + + + * **[Iniciar y programar el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: Activar manualmente o configurar ejecuciones recurrentes con expresiones cron. + * **[Gestione el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: edite la configuración, duplique para diferentes entornos, monitoree el historial de ejecución + + + + * **[resolución de problemas](/docs/workflow-automation/troubleshooting)**: corrige errores de credenciales, problemas de integración y fallas de flujo de trabajo + * **[Mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Manejo de errores, optimización del rendimiento, estrategias de prueba. + * **[Límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprenda los tiempos de espera, los límites de velocidad y las restricciones. + + + + * **[Catálogo de acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: Explore todas las acciones disponibles de AWS, New Relic y HTTP. + * **[Ejemplos de flujo de trabajo](/docs/workflow-automation/workflow-examples)**: aprenda de escenarios de automatización del mundo real. + * **[API de flujo de trabajo](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: gestione el flujo de trabajo mediante programación para la integración CI/CD + + \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx b/src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx new file mode 100644 index 00000000000..cc59482db4e --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx @@ -0,0 +1,326 @@ +--- +title: flujo de trabajo Automatización mejores prácticas +tags: + - Workflow Automation + - workflow + - best practices + - workflow automation best practices +metaDescription: 'Build reliable, maintainable workflows that handle errors gracefully and scale with your operations.' +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Crea flujos de trabajo confiables que gestionen los errores de forma eficaz, protejan los datos confidenciales y se adapten a tus operaciones. Sigue estos patrones para crear automatizaciones mantenibles. + +## Diseño enfocado al flujo de trabajo. + +Mantenga el flujo de trabajo enfocado en una sola responsabilidad. Agrupa las acciones relacionadas, pero evita combinar tareas no relacionadas. + +### Un flujo de trabajo, un propósito + +**Hacer**: Crear un flujo de trabajo separado para respuesta a incidentes y mantenimiento programado. **No**: combine el cambio de tamaño de EC2, las copias de seguridad de la base de datos y la notificación de Slack en un solo flujo de trabajo. + +### Reutilizar flujo de trabajo con parámetro + +Emplee el parámetro de entrada para hacer que el flujo de trabajo sea reutilizable en todos los entornos en lugar de duplicar el flujo de trabajo. + +**Ejemplo**: Un EC2 redimensiona el flujo de trabajo con región y parámetro de tipo de instancia: + +```yaml +inputs: + awsRegion: us-east-1 + instanceType: t3.medium + instanceId: i-1234567890abcdef0 +``` + +Esto reemplaza la creación de un flujo de trabajo separado para cada región o tipo de instancia. + +### Combinar acciones relacionadas + +Acciones relacionadas que deben ejecutar juntas: + +* **Hacer**: consultar detalles de alerta, formatear mensaje, enviar a Slack en un flujo de trabajo +* **No**: crear un flujo de trabajo separado para "consulta alerta", "formatear mensaje", "enviar a Slack" + +## Manejar errores + +Incluya siempre el manejo de errores para las llamadas a API externas y las operaciones críticas. + +### Agregar acciones de respaldo + +Cuando los pasos críticos puedan fallar, agrega acciones de respaldo que notifiquen a tu equipo. + +**Ejemplo**: Enviar notificación de Slack incluso si falla un paso usando `ignoreErrors`: + +```yaml +- name: sendNotification + type: action + action: aws.execute.api + version: 1 + ignoreErrors: true + inputs: + service: sqs + api: send_message + parameters: + MessageBody: "Rollback notification" + QueueUrl: "${{ .workflowInputs.queueUrl }}" + +- name: logResult + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Notification sent: ${{ .steps.sendNotification.outputs.success }}" +``` + +Emplee `ignoreErrors: true` para continuar la ejecución del flujo de trabajo incluso si falla un paso. + +### Establezca tiempos de espera adecuados. + +Establezca tiempos de espera para API de llamadas externas para evitar que el flujo de trabajo se cuelgue: + +* API de llamada AWS : 30-60 segundos +* consulta de la base de datos: 10-30 segundos +* requests HTTP: 15-30 segundos +* Mensajes de Slack: 10 segundos + +### Registrar errores para la resolución de problemas + +Incluya estos detalles en los logs de errores: + +* Acción que fracasó +* parámetro de entrada +* mensaje de error del servicio +* Timestamp + +## Credenciales seguras + +Almacena todos los valores confidenciales en el administrador de secretos de New Relic. Nunca incluya credenciales codificadas directamente en las definiciones de flujo de trabajo. + +### Emplee el administrador de secretos + +Almacena las credenciales AWS, el token API y las contraseñas: + +```graphql +mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } +} +``` + +Secretos de referencia: `${{ :secrets:awsAccessKeyId }}` + +### Rote las credenciales de manera regular + +Si se emplean claves de acceso de usuario de IAM: + +* Rotar cada 90 días como mínimo +* Configura recordatorios en el calendario +* Prueba las nuevas credenciales antes de eliminar las antiguas. + +**Recomendación**: Emplee roles de IAM en su lugar; estos rotan automáticamente. + +### Emplear licencias de mínimo privilegio + +Conceder solo las licencias necesarias. Comience con licencias de solo lectura y agregue licencias de escritura solo cuando sea necesario. + +**Ejemplo de política de AWS IAM** para SQS: + +```json +{ + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-queue" +} +``` + +Esto restringe el acceso a una cola específica. + +## Prueba antes de la producción + +Pruebe el flujo de trabajo en un entorno de no producción antes de implementarlo en producción. + +### Duplicado para pruebas + +Crear versiones de prueba del flujo de trabajo de producción: + +1. Navegue a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Busque el flujo de trabajo y haga clic en el menú de más opciones. +3. Seleccionar **Duplicate** +4. Actualiza las credenciales para usar las cuentas de prueba. +5. Prueba con recursos que no sean de producción + +### Escenarios de fallo de prueba + +Verificar flujo de trabajo manejar fallas: + +* ¿Qué ocurre si la API de AWS no está disponible? +* ¿Qué ocurre si Slack está caído? +* ¿Qué ocurre si las credenciales caducan? +* ¿Qué ocurre si un recurso necesario no existe? + +### Verificar integración + +Antes de programar, active manualmente el flujo de trabajo y verifique: + +* Las acciones de AWS se ejecutan correctamente +* Los mensajes de Slack aparecen en los canales correctos. +* Las puertas de aprobación esperan respuestas +* El manejo de errores funciona como se esperaba. + +## Optimizar el rendimiento + +Crea flujos de trabajo eficientes que se ejecuten rápidamente. + +### Consulta una vez, reutiliza los resultados + +Almacena los resultados de la consulta y haz referencia a ellos varias veces: + +```yaml +- name: getAlertDetails + action: newrelic.nerdgraph.execute + +- name: sendToSlack + inputs: + text: "${{ .steps.getAlertDetails.outputs.data }}" + +- name: updateJira + inputs: + body: "${{ .steps.getAlertDetails.outputs.data }}" +``` + +**No**: consulte los detalles de alerta por separado para Slack y Jira. + +## Monitorear y mantener + +Monitorear periódicamente la ejecución del flujo de trabajo y mantener actualizado el flujo de trabajo. + +### Revisar el historial de ejecución semanalmente + +Revisión de las carreras de flujo de trabajo: + +1. Navegue a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Seleccione el flujo de trabajo +3. Hacer clic en **Run history** +4. Busque ejecuciones fallidas o tiempos de ejecución cada vez mayores. + +### Configurar alertas de fallos + +Configurar alertas para fallos en el flujo de trabajo: + +1. Crear condición de alerta para fallos en la ejecución del flujo de trabajo +2. Enviar notificación al canal principal del equipo. +3. Incluya el nombre del flujo de trabajo y los detalles del error. + +### Revisar flujo de trabajo trimestralmente + +Configura recordatorios recurrentes en tu calendario para: + +* Eliminar el flujo de trabajo no empleado +* Actualizar credenciales caducadas +* Verifique que los servicios integrados no cambiaron sus API. +* Escenarios de fallo de prueba +* Documentación actualizada + +## Flujo de documentos de trabajo + +Haga que el flujo de trabajo sea fácil de entender. + +### Emplee nombres descriptivos + +* **Ejecutar**: "Redimensionamiento automático de EC2 para alertas de alto uso de CPU" +* **No**: "flujo de trabajo 1" o "EC2 Automation" + +### Escriba descripciones claras + +Explica qué, cuándo y quién: + +``` +Automatically resizes EC2 instances when CPU exceeds 90% for 10 minutes. +Requires approval via Slack before executing changes. +Owner: DevOps Team (devops@example.com) +Last updated: 2025-01-26 +``` + +### Agrega comentarios para la lógica compleja. + +Cuando emplee lógica condicional o bucles, explique la lógica: + +```yaml +- name: checkCPU + # Query CPU for last 10 minutes to avoid false positives + type: action + action: newrelic.nerdgraph.execute + version: 1 + +- name: decideAction + # If CPU > 90%: resize, 70-90%: warn, < 70%: no action + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.result > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.result > 70 }}" + next: sendWarning + next: noAction +``` + +## Seguridad + +Proteger el flujo de trabajo y los recursos a los que acceden. + +### Emplee puertas de aprobación para operaciones destructivas + +Requerir aprobación humana antes de: + +* Eliminando recursos +* Reducción de los servicios de producción +* Retrocediendo despliegue +* Modificar las licencias de IAM + +### cambios en el flujo de trabajo de auditoría + +Emplee el historial de versiones para realizar un seguimiento de los cambios: + +1. Ir a los detalles del flujo de trabajo +2. Hacer clic en **Version history** +3. Revisa los cambios y quién los realizó. + +### Restringir el acceso al flujo de trabajo + +Cerciorar de que solo los miembros autorizados del equipo puedan editar el flujo de trabajo: + +1. Revisar el rol de usuario en la configuración de la cuenta +2. Limitar las licencias de edición al equipo de DevOps +3. Emplee cuentas separadas para producción y pruebas. + +## Próximos pasos + +**Comprender los límites:** + +* **[Límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits)** : restricciones de tiempo de espera, acción y carga útil + +**Solucionar problemas:** + +* **[Resolución de problemas](/docs/workflow-automation/troubleshooting)** - Soluciones a problemas comunes + +**Ver ejemplos:** + +* **[Ejemplos de flujo de trabajo](/docs/workflow-automation/workflow-examples)** : escenarios de automatización del mundo real + +**Gestionar el flujo de trabajo:** + +* **[Gestión del flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)** : editar, duplicar y monitorear el flujo de trabajo \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx b/src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx new file mode 100644 index 00000000000..fde4e786d54 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx @@ -0,0 +1,201 @@ +--- +title: límites de automatización del flujo de trabajo +metaDescription: 'For New Relic Workflow automation, explanations of the Workflow automation limits.' +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Qué + + Mínimo + + máx. +
+ Tamaño de salida de la acción + + + + 100 KB +
+ Intentos de reintento de la acción + + + + 3 +
+ Definición del flujo de trabajo: pasos totales + + 1 + + 100 +
+ Tamaño de la definición del flujo de trabajo + + + + 50 KB +
+ Número de definiciones de flujo de trabajo + + + + 1000 +
+ Duración del flujo de trabajo + + + + 7 días +
+ Pasos totales de ejecución del flujo de trabajo + + + + 5000 +
+ Número de horarios + + + + 10 +
+ Longitud de un valor de entrada de flujo de trabajo + + + + 1000 caracteres +
+ Ejecuciones simultáneas del flujo de trabajo (por cuenta) + + + + 30 +
+ Tamaño de entrada de señal + + + + 10 KB +
+ Número de condiciones en el paso de conmutación + + + + 10 +
+ Número de señales en el paso de espera + + + + 10 +
+ +## ¿Que sigue? + +Usted comprende los límites técnicos. Ahora explore formas programáticas de gestionar su flujo de trabajo a gran escala. + +**Lo siguiente en su viaje**: [API de automatización de flujo de trabajo](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api) : aprenda cómo crear, gestionar y ejecutar flujo de trabajo mediante programación. + +**Recursos adicionales**: + +* [Catálogo de acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) - Referencia completa de todas las acciones +* [mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices) - Revisar técnicas de optimización \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx new file mode 100644 index 00000000000..7d91e4312d7 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx @@ -0,0 +1,41 @@ +--- +title: Descripción general del catálogo de acciones +tags: + - workflow automation + - workflow + - workflow automation actions + - actions catalog +metaDescription: List of available actions catalog for workflow definition +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +El catálogo de acciones New Relic proporciona acciones que se pueden realizar sobre su infraestructura e integración. Puedes orquestar y automatizar tus procesos de extremo a extremo vinculando acciones que realizan tareas en tus proveedores cloud y cuentas New Relic. + +## Catálogos de acciones disponibles [#available-catalogs] + +Los siguientes catálogos de acciones están disponibles para la automatización del flujo de trabajo: + +* [Acciones de AWS](/docs/workflow-automation/setup-and-configuration/actions-catalog/aws) : integración con servicios de AWS, incluidos Lambda, EC2 y Systems Manager. +* [Acciones de comunicación](/docs/workflow-automation/setup-and-configuration/actions-catalog/communication) : enviar notificaciones y mensajes a través de diversos canales de comunicación. +* [Acciones HTTP](/docs/workflow-automation/setup-and-configuration/actions-catalog/http) : realizar requests HTTP a API y servicios externos. +* [AccionesNew Relic ](/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic): interactúa con las características y datos de la plataforma New Relic +* [AccionesPagerDuty ](/docs/workflow-automation/setup-and-configuration/actions-catalog/pagerduty)- Gestionar incidente e integración PagerDuty +* [Acciones de utilidad](/docs/workflow-automation/setup-and-configuration/actions-catalog/others) : realizar operaciones comunes de transformación de datos y de utilidad. + +## ¿Que sigue? + +Ya viste todas las acciones disponibles. Ahora es el momento de unirlos y crear tu primer flujo de trabajo. + +**Siguiente paso en tu recorrido**: [Gestionar el flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) - Aprende cómo crear, gestionar y ejecutar flujos de trabajo en New Relic. + +**Comienza a construir**: + +* [Emplee una plantilla de flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/use-a-template) : inicio rápido con flujo de trabajo prediseñado +* [Crea tu propio flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/create-your-own) - Crea un flujo de trabajo personalizado desde cero \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx new file mode 100644 index 00000000000..80c2e52602f --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx @@ -0,0 +1,704 @@ +--- +title: acciones de comunicación +tags: + - workflow automation + - workflow + - workflow automation actions + - communication actions + - slack actions + - ms teams actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página proporciona una referencia completa de las acciones de comunicación disponibles en el catálogo de acciones de automatización del flujo de trabajo. Estas acciones te permiten integrar la plataforma de comunicación en tus definiciones de flujo de trabajo, incluyendo el envío de mensajes a canales de Slack, la recuperación de reacciones y más. + +## Requisitos previos + +Antes de emplear acciones de comunicación en la automatización del flujo de trabajo, cerciorar de tener: + +* Un espacio de trabajo de Slack con las licencias adecuadas. +* Un token de bot de Slack configurado como secreto en la automatización del flujo de trabajo. +* Acceso a los canales de Slack donde deseas enviar mensajes. + +Consulta [la sección "Agregar configuración de Slack"](/docs/autoflow/overview#add-the-slack-integration) para obtener información sobre cómo configurar la integración de Slack. + +## acciones de comunicación disponibles + +Referencia rápida de todas las acciones de comunicación por plataforma: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Plataforma + + Acción + + Objetivo +
+ **Slack** + + [Publicar mensaje](#slackchatpostmessage) + + Envía mensajes a los canales de Slack con archivos adjuntos opcionales. +
+ **Slack** + + [Obtén reacciones](#slackchatgetreactions) + + Recuperar reacciones con emojis de los mensajes de Slack. +
+ +## Acciones de Slack + + + + Envía un mensaje a un canal de Slack, con un archivo adjunto opcional. + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Ejemplo +
+ **token** + + Requerido + + secreto + + `${{ :secrets:slackToken }}` +
+ **canal** + + Requerido + + cadena + + `my-slack-channel` +
+ **texto** + + Requerido + + cadena + + `Hello World!` +
+ **hilosTs** + + Opcional + + cadena + + `.` +
+ **adjunto** + + Opcional + + mapa + +
+ **archivo adjunto** + + Requerido + + cadena + + `file.txt` +
+ **contenido del archivo adjunto** + + Requerido + + cadena + + `Hello\nWorld!` +
+ + + * **token**: El token del bot de Slack que se va a emplear. Esto debe pasar como una sintaxis secreta. Consulte [la sección "Agregar configuración de Slack"](/docs/autoflow/overview#add-the-slack-integration) para obtener instrucciones sobre cómo configurar un token. + * **channel**: El nombre del canal, o un ID de canal, al que se enviará el mensaje. Consulta [la API de Slack](https://api.slack.com/methods/chat.postMessage#arg_channel/) para obtener más información. + * **text**: El mensaje que se publicará en Slack en el `channel` especificado. + * **threadTs**: marca de tiempo perteneciente al mensaje principal, empleada para crear una respuesta de mensaje en un hilo. + * **attachment**: Permite anexar un archivo con un mensaje al `channel` especificado. + * **attachment.filename**: Especifique el nombre del archivo cargado en Slack. + * **attachment.content**: El contenido del archivo a subir en formato UTF-8. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Ejemplo +
+ **hilosTs** + + cadena + + `.` +
+ **ID de canal** + + cadena + + `` +
+ + + * **threadTs**: marca de tiempo del mensaje. Puede emplear en futuras llamadas a postMessage para publicar una respuesta en un hilo. + * **channelID**: Identificador del canal donde se publica el mensaje. + + + + + **Ejemplo 1: Publicar un mensaje en un canal de Slack** + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: SendMessage + + steps: + - name: send_slack_message + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: ${{ .workflowInputs.channel }} + text: ${{ .workflowInputs.text }} + ``` + + **Entradas esperadas:** + + ```json + { + "inputs": [ + { + "key" : "channel", + "value" : "my-channel" + }, + { + "key" : "text", + "value" : "This is my message *with bold text* and `code backticks`" + } + ] + } + ``` + + **Resultado esperado:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + **Ejemplo 2: Anexar un archivo** + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: SendFileMessage + + steps: + - name: postCsv + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: my-channel + text: "Please find the attached file:" + attachment: + filename: 'file.txt' + content: "Hello\nWorld!" + ``` + + **Resultado esperado:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + + + + + + + + Obtén una reacción a un mensaje del canal de Slack. + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Ejemplo +
+ **token** + + Requerido + + secreto + + `${{ :secrets:slackToken }}` +
+ **ID de canal** + + Requerido + + cadena + + `C063JK1RHN1` +
+ **se acabó el tiempo** + + Opcional + + En t + + 60 +
+ **hilosTs** + + Requerido + + cadena + + `.` +
+ **selectores** + + Opcional + + lista + + `[{\"name\": \"reactions\", \"expression\": \".reactions \"}]` +
+ + + * **token**: El token del bot de Slack que se va a emplear. Esto debe pasar como una sintaxis secreta. Consulte [la sección "Agregar configuración de Slack"](/docs/autoflow/overview#add-the-slack-integration) para obtener instrucciones sobre cómo configurar un token. + * **channelID**: El ID del canal para obtener las reacciones a los mensajes. + * **timeout**: El tiempo en segundos que se debe esperar para obtener alguna respuesta. El valor predeterminado es 60 segundos, el máximo permitido es 600 segundos (10 minutos). + * **threadTs**: marca de tiempo perteneciente al mensaje, empleada para obtener la reacción a ese mensaje. + * **selectors**: Los selectores para obtener como salida el único parámetro especificado. + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Ejemplo +
+ **reacciones** + + lista + + `` +
+ + + * **reactions**: Lista de elementos con todas las reacciones capturadas o una lista vacía si se produjo un tiempo de espera agotado. + + + + + **Ejemplo 1: Slack obtiene reacciones** + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: GetReactions + + steps: + - name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channelID: ${{ .steps.promptUser.outputs.channelID }} + threadTs: ${{ .steps.promptUser.outputs.threadTs }} + timeout: ${{ .workflowInputs.timeout }} + selectors: ${{ .workflowInputs.selectors }} + ``` + + **Entradas esperadas:** + + ```json + { + "inputs": [ + { + "key" : "channelID", + "value" : "C063JK1RHN1" + }, + { + "key" : "threadTs", + "value" : "1718897637.400609" + }, + { + "key" : "selectors", + "value" : "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" + } + ] + } + ``` + + **Resultado esperado:** + + ```json + [ + { + "name": "grinning", + "users": [ + "W222222" + ], + "count": 1 + }, + { + "name": "question", + "users": [ + "W333333" + ], + "count": 1 + } + ] + ``` + + O si se agota el tiempo de espera: + + ```json + [] + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx new file mode 100644 index 00000000000..3b3868df8a7 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx @@ -0,0 +1,1103 @@ +--- +title: Acciones HTTP +tags: + - workflow automation + - workflow + - workflow automation actions + - HTTP actions +metaDescription: A list of available HTTP actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página proporciona una referencia completa de las acciones HTTP disponibles en el catálogo de acciones de automatización de flujo de trabajo. Estas acciones te permiten realizar requests HTTP (GET, POST, PUT, DELETE) a API y servicios externos como parte de tus definiciones de flujo de trabajo. + +## Requisitos previos + +Antes de emplear acciones HTTP en la automatización de flujos de trabajo, cerciorar de tener: + +* Objetivo extremos de URL de API. +* Cualquier credencial de autenticación requerida (clave de API, token, etc.). +* Comprensión de los formatos de solicitud/respuesta de la API. + + + Las acciones HTTP admiten sintaxis secreta para cualquier valor de encabezado, lo que le permite pasar de forma segura datos confidenciales como la clave de API. Consulte [la sección de gestión de secretos](/docs/infrastructure/host-integrations/installation/secrets-management/) para obtener más información. + + +## Acciones HTTP disponibles + +Referencia rápida de todas las acciones HTTP: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Acción + + Objetivo +
+ [solicitud GET](#httpget) + + Recuperar datos de un extremo de API. +
+ [Solicitud POST](#httppost) + + Enviar datos a un extremo de API. +
+ [Solicitud PUT](#httpput) + + Actualizar datos en un extremo de API. +
+ [Solicitud de ELIMINACIÓN](#httpdelete) + + Eliminar datos en los extremos de API. +
+ +## Acciones HTTP + + + + Realizar una llamada HTTP GET para recuperar datos de un extremo de API. + + + Esto admite sintaxis secreta para cualquier valor de encabezado. + + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Descripción +
+ **url** + + Requerido + + Cadena + + La URL de destino para la solicitud. El esquema debe estar incluido: + + `https://example.com` +
+ **parámetros de URL** + + Opcional + + Mapa + + El parámetro consulta que se agregará a la URL. Toma un objeto JSON en formato de cadena. +
+ **encabezados** + + Opcional + + Mapa + + Las cabeceras que se deben agregar a la solicitud. Toma un objeto JSON en formato de cadena. +
+ **selectores** + + Opcional + + Lista + + Los selectores para obtener únicamente el parámetro especificado como resultado. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Descripción +
+ **cuerpo de respuesta** + + Cadena + + El cuerpo de la respuesta. +
+ **código de estado** + + Entero + + El código de estado HTTP de la respuesta. +
+ + + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: httpGetTest + description: 'Performs an HTTP GET request to retrieve data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + steps: + - name: query + type: action + action: http.get + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + next: end + ``` + + **Ejemplos de entradas:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}" + } + ``` + + **Ejemplos de resultados:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + + + Realiza una llamada HTTP POST para enviar datos a un extremo de API. + + + Esto admite sintaxis secreta para cualquier valor de encabezado. + + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Descripción +
+ **url** + + Requerido + + Cadena + + La URL de destino para la solicitud. El esquema debe estar incluido: + + `https://example.com` +
+ **parámetros de URL** + + Opcional + + Mapa + + El parámetro consulta que se agregará a la URL. Toma un objeto JSON en formato de cadena. +
+ **encabezados** + + Opcional + + Mapa + + Las cabeceras que se deben agregar a la solicitud. Toma un objeto JSON en formato de cadena. +
+ **cuerpo** + + Opcional + + Cadena + + El cuerpo de la solicitud. +
+ **selectores** + + Opcional + + Lista + + Los selectores para obtener únicamente el parámetro especificado como resultado. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Descripción +
+ **cuerpo de respuesta** + + Cadena + + El cuerpo de la respuesta. +
+ **código de estado** + + Entero + + El código de estado HTTP de la respuesta. +
+ + + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: httpPostTest + description: 'Performs an HTTP POST request to send data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + steps: + - name: query + type: action + action: http.post + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + next: end + ``` + + **Ejemplos de entradas:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}" + } + ``` + + **Ejemplos de resultados:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + Realiza una solicitud HTTP PUT para actualizar datos en un extremo de API. + + + Si necesita pasar datos confidenciales a una entrada, por ejemplo un encabezado `Api-Key`, puede usar valores almacenados a través de la mutación [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) de NerdGraph. + + Ejemplo: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Descripción +
+ **url** + + Requerido + + Cadena + + La URL de destino para la solicitud. La URL debe incluir el esquema (por ejemplo, https:// o http://). Ejemplo: + + `https://example.com` +
+ **parámetros de URL** + + Opcional + + Mapa + + El parámetro consulta que se agregará a la URL. Toma un objeto JSON en formato de cadena. +
+ **encabezados** + + Opcional + + Mapa + + Las cabeceras que se deben agregar a la solicitud. Toma un objeto JSON en formato de cadena. +
+ **cuerpo** + + Opcional + + Cadena + + El cuerpo de la solicitud. +
+ **selectores** + + Opcional + + Lista + + Los selectores para obtener únicamente el parámetro especificado como resultado. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Descripción +
+ **cuerpo de respuesta** + + Cadena + + El cuerpo de la respuesta. +
+ **código de estado** + + Entero + + El código de estado HTTP de la respuesta. +
+ + + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: httpPutTest + description: 'Performs an HTTP PUT request to update data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.put + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **Ejemplos de entradas:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **Ejemplos de resultados:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + Realiza una solicitud HTTP DELETE para eliminar datos en un extremo de API. + + + Si necesita pasar datos confidenciales a una entrada, por ejemplo un encabezado `Api-Key`, puede usar valores almacenados a través de la mutación [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) de NerdGraph. + + Ejemplo: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Descripción +
+ **url** + + Requerido + + Cadena + + La URL de destino para la solicitud. La URL debe incluir el esquema (por ejemplo, https:// o http://). Ejemplo: + + `https://example.com` +
+ **parámetros de URL** + + Opcional + + Mapa + + El parámetro consulta que se agregará a la URL. Toma un objeto JSON en formato de cadena. +
+ **encabezados** + + Opcional + + Mapa + + Las cabeceras que se deben agregar a la solicitud. Toma un objeto JSON en formato de cadena. +
+ **selectores** + + Opcional + + Lista + + Los selectores para obtener únicamente el parámetro especificado como resultado. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Descripción +
+ **cuerpo de respuesta** + + Cadena + + El cuerpo de la respuesta. +
+ **código de estado** + + Entero + + El código de estado HTTP de la respuesta. +
+ + + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: httpDeleteTest + description: 'Performs an HTTP DELETE request to remove data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.delete + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **Ejemplos de entradas:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **Ejemplos de resultados:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx new file mode 100644 index 00000000000..6b6bfa4c450 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx @@ -0,0 +1,1212 @@ +--- +title: Acciones de New Relic +tags: + - workflow automation + - workflow + - workflow automation actions + - New relic actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página proporciona una referencia completa de las acciones de New Relic disponibles en el catálogo de acciones de automatización de flujo de trabajo. Estas acciones te permiten integrar las capacidades de la plataforma New Relic en tus definiciones de flujo de trabajo, incluyendo el envío de eventos personalizados y logs, la ejecución de consultas NerdGraph, la ejecución de consultas NRQL y el envío de notificaciones. + +## Requisitos previos + +Antes de emplear las acciones New Relic en la automatización del flujo de trabajo, cerciorar de tener lo siguiente: + +* Una cuenta de New Relic con las licencias adecuadas. +* Una clave de licencia de New Relic (si se envían datos a una cuenta diferente). +* Las licencias necesarias para los servicios específicos de New Relic que planea emplear. + +Consulte [la clave de licencia](/docs/apis/intro-apis/new-relic-api-keys/#license-key) para obtener información sobre cómo crear y gestionar su clave de licencia de cuenta de New Relic. + +## Acciones disponibles de New Relic + +Referencia rápida de todas las acciones de New Relic por categoría: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Categoría + + Acción + + Objetivo +
+ **Ingesta de datos** + + [Enviar evento personalizado](#newrelicingestsendevents) + + Enviar evento personalizado a New Relic. +
+ **Ingesta de datos** + + [Enviar logs](#newrelicingestsendlogs) + + Enviar datos de log a New Relic. +
+ **NerdGraph** + + [Ejecutar consulta o mutación GraphQL](#newrelicnerdgraphexecute) + + Ejecutar comandos GraphQL contra la API de NerdGraph. +
+ **Consultar** + + [Ejecutar consulta NRDB](#newrelicnrdbquery) + + Ejecutar consulta NRQL entre cuentas. +
+ **Notificación** + + [Enviar notificación](#newrelicnotificationsend) + + Enviar notificaciones a destinos New Relic. +
+ +## acciones de ingesta de datos + + + + Envía un evento personalizado a New Relic + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Ejemplo +
+ **Atributo** + + Opcional + + mapa + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **evento** + + Requerido + + lista + + `"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]` +
+ **clave de licencia** + + Opcional + + cadena + + `"{{ .secrets.secretName }}"` +
+ **selectores** + + Opcional + + lista + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: Atributo común que forma parte de todos los eventos cuando se proporciona. Se realiza la fusión para cada elemento del evento cuando sea necesario; el elemento del evento anula la definición común. + * **events**: La lista de datos del evento. Tenga en cuenta que el evento requiere el uso de un campo `eventType` que representa el tipo de evento personalizado y el máximo de eventos permitidos por solicitud es 100. + * **licenseKey**: La clave de licencia de New Relic Account que especifica la cuenta objetivo donde se envían los eventos. Si no se proporciona este valor, se asume una clave de licencia predeterminada basada en la cuenta que ejecuta el flujo de trabajo. + * **selectors**: Los selectores para obtener únicamente el parámetro especificado como salida. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Ejemplo +
+ **éxito** + + Booleano + + `true` +
+ **mensaje de error** + + cadena + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: heartbeat_newrelicIngestSendEvents + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendEvents + version: 1 + inputs: + attributes: + colour: red + id: 1234 + events: + - eventType: HeartBeat + test: "OK" + attributes: + foo: bar + - eventType: HeartBeat1234 + test: "OK1234" + attributes: + foo: bar + - eventType: HeartBeat12345 + test: "OK12345" + attributes: + foo: bar + colour: yellow + - eventType: HeartBeat12345678 + test: "OK12345678" + selectors: + - name: success + expression: ".success" + ``` + + **Resultado esperado:** + + ```yaml + { + "success": true + } + ``` + + **Recuperar evento:** + + Tras ejecutar correctamente un flujo de trabajo, puede recuperar el evento asociado ejecutando una consulta en la cuenta que ejecutó el flujo de trabajo: + + ```sql + SELECT * FROM HeartBeat + ``` +
+ + + + + + + + + Enviar log a New Relic + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidad + + Tipo + + Ejemplo +
+ **Atributo** + + Opcional + + mapa + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **logs** + + Requerido + + lista + + `"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"` +
+ **clave de licencia** + + Opcional + + cadena + + `"{{ .secrets.secretName }}"` +
+ **selectores** + + Opcional + + lista + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: Atributo común incluido en todos los logs cuando se proporciona. Si un elemento de log especifica el mismo atributo, anula la definición común. + * **logs**: La lista de datos de log. Tenga en cuenta que el número máximo de logs permitidos por solicitud es 100. + * **licenseKey**: La clave de licencia de New Relic Account que especifica la cuenta objetivo a la que se envían los logs. Si no se proporciona, se asume una clave de licencia predeterminada basada en la cuenta que ejecuta el flujo de trabajo. Consulte [la clave de licencia](/docs/apis/intro-apis/new-relic-api-keys/#license-key) para obtener más información. + * **selectors**: Los selectores para obtener únicamente el parámetro especificado como salida. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de salida + + Tipo + + Ejemplo +
+ **éxito** + + Booleano + + `true` +
+ **mensaje de error** + + cadena + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ Ejemplo de flujo de trabajo +
+ ```yaml + name: heartbeat_newrelicIngestSendLogs + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + attributes: + colour: red + id: 1234 + logs: + - message: 'Heartbeat sendLogs Action Test Message' + attributes: + foo: bar + - message: 'HeartBeat1234' + attributes: + foo: bar + - message: 'HeartBeat12345' + attributes: + foo: bar + colour: yellow + - message: 'HeartBeat12345678' + selectors: + - name: success + expression: ".success" + ``` + + **Resultado esperado:** + + ```yaml + { + "success": true + } + ``` + + **Recuperar logs:** + + Tras ejecutar correctamente un flujo de trabajo, puede recuperar el log asociado ejecutando una consulta en la cuenta que ejecutó el flujo de trabajo: + + ```sql + SELECT * FROM Log + ``` +
+ + + + + + +## Acciones de NerdGraph + + + + Ejecuta un comando Graphql contra la API NerdGraph de New Relic. El comando puede ser una consulta o una mutación. + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Aporte + + Opcionalidad + + Tipo + + Descripción + + Ejemplo +
+ **Graphql** + + Requerido + + cadena + + Sintaxis GraphQL. Deberías usar GraphiQL para construir y probar tu comando. + +
+ **variables** + + Requerido + + map[string]any + + Variables de pares principales de valor para usar con la declaración GraphQL. + +
+ **selectores** + + Opcional + + lista + + Los selectores para obtener como resultado el único parámetro especificado. + + ```yaml + { + "data": { + "actor": { + "user": { + "name": "" + } + } + } + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Producción + + Tipo + + Ejemplo +
+ **datos** + + map[string]any: Contenido de la propiedad + + `data` + + de una respuesta de NerdGraph. + + ```yaml + steps: + - name: currentUserId + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + graphql: | + query userId { + currentUser { + id + } + } + - name: sayHello + type: action + action: example.messaging.sayHello + version: 1 + inputs: + name: ${{ .steps.currentUserId.outputs.data.currentUser.id }} + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Ejemplo + + Producción + + Recuperar evento +
+ ```json + name: testLog + + steps: + - name: logStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'Hello World' + ``` + + ```yaml + { + "success": true + } + ``` + + Puede recuperar el evento asociado ejecutando una consulta en la cuenta que ejecutó el flujo de trabajo. + + ```yaml + SELECT message FROM Log WHERE allColumnSearch('Hello World', insensitive: true) SINCE 30 minutes ago + ``` +
+ + + + + + +## Acciones de consulta + + + + Ejecuta una consulta NRQL entre cuentas a través de la API de NerdGraph. + + + + + Entradas + + + + Salidas + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Aporte + + Opcionalidad + + Tipo + + Descripción + + Ejemplo +
+ **consulta** + + Requerido + + cadena + + La instrucción de consulta NRQL. + +
+ **ID de cuenta** + + Opcional + + lista de int + + El campo + + **New Relic Account ID** + + es una lista de ID de objetivo que le permite especificar las cuentas objetivo contra las que se ejecuta la consulta. Si no se proporciona este valor como entrada, la consulta se ejecutará automáticamente en la cuenta asociada con la cuenta de ejecución del flujo de trabajo. + +
+ **selectores** + + Opcional + + lista + + Los selectores para obtener como resultado el único parámetro especificado. + + ```json + steps: + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + accountIds: [12345] + query: FROM Log SELECT * WHERE message LIKE 'DEMO%' + selectors: + - name: resultsAsString + expression: '.results | tostring' + ``` +
+ + + + + + + + + + + + + + + + + + + + + +
+ Producción + + Tipo + + Ejemplo +
+ **results** + + : Una matriz de objetos que contiene los resultados de la consulta. + + + + ```yaml + { + results=[ + { message=[INFO] - Workflow: test has ended, messageId=39af98 }, + { message=[INFO] - Workflow: test - Step query has started, messageId=649c612 }, + ... + ] + } + ``` +
+ + + + + + +## acciones de notificación + + + + Envía un mensaje a un canal, integrado con destinos como por ejemplo Slack. + + + + + Entradas + + + + Salidas + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Aporte + + Opcionalidad + + Tipo + + Descripción + + Ejemplo +
+ **tipo** + + Requerido + + cadena + + Tipo de destino de New Relic + + `slack` +
+ **ID de destino** + + Requerido + + Cadena + + DestinationId asociado con el destino de New Relic. + + `123e4567-e89b-12d3-a456-426614174000` +
+ **parámetro** + + Requerido + + mapa + + Campos obligatorios para enviar notificaciones al tipo de destino seleccionado. + + `{\"channel\": \"${{ YOUR_CHANNEL }}\", \"text\": \"Enter your text here\"}` +
+ **selectores** + + Opcional + + lista + + Los selectores para obtener como resultado el único parámetro especificado. + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Producción + + Tipo + + Ejemplo +
+ éxito + + booleano + + `true/false` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx new file mode 100644 index 00000000000..0d48be3049a --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx @@ -0,0 +1,684 @@ +--- +title: acciones de utilidad +tags: + - workflow automation + - workflow + - workflow automation actions + - utility actions +metaDescription: A list of available utility actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + +Esta página proporciona una referencia para las acciones de utilidad disponibles en el catálogo de acciones de automatización de flujo de trabajo. Estas acciones le permiten realizar operaciones comunes de transformación de datos y utilidades en las definiciones de su flujo de trabajo. + +## Acciones de utilidad disponibles + +Referencia rápida de todas las acciones de utilidad: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Acción + + Objetivo +
+ [Actualiza la fecha y hora desde la época](#utils.datetime.fromEpoch) + + Transformar timestamp Unix a formato de fecha/hora. +
+ [Transformar a CSV](#utils.transform.toCSV) + + Convertir datos a formato CSV. +
+ [Generar UUID](#utils.uuid.generate) + + Generar un UUID V4 compatible con RFC. +
+ +## acciones de utilidad + + + + Esta acción se emplea para transformar timestamp Unix a fecha/hora. Posibles referencias: + + * [https://en.wikipedia.org/wiki/list\_of\_tz\_database\_time\_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) + * [https://docs.oracle.com/javase/8/docs/api/java/time/zoneid.html#SHORT\_IDS](https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT_IDS) + + Consulte [FromEpoch](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html) para obtener más información. + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Aporte + + Opcionalidad + + Tipo + + Descripción +
+ **timestamp** + + Requerido + + En t + + Un número entero que representa timestamp de la época. Tenga en cuenta que las épocas UNIX son el número de segundos transcurridos desde el 1 de enero de 1970, medianoche UTC (00:00). +
+ **marca de tiempoUnidad** + + Opcional + + cadena + + Una cadena que representa la unidad de timestamp proporcionada. Valores aceptables: SEGUNDOS, MILISEGUNDOS (PREDETERMINADO) +
+ **ID de zona horaria** + + Opcional + + cadena + + Cadena de texto que representa la zona horaria para la fecha y hora deseadas; por defecto: UTC +
+ **patrón** + + Opcional + + cadena + + Cadena que representa el patrón para la fecha y hora deseadas; por defecto: ISO-8601 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo + + Opcionalidad + + Tipo de datos + + Descripción +
+ **fecha** + + Requerido + + cadena + + Una representación en cadena de texto de una fecha. +
+ **tiempo** + + Requerido + + cadena + + Una representación en cadena del tiempo. +
+ **fecha y hora** + + Requerido + + cadena + + Una representación en cadena de texto de una fecha y hora. +
+ **zona horaria** + + Requerido + + mapa + + Representación cartográfica del ID de zona horaria y su abreviatura. +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Ejemplo + + Entrada del flujo de trabajo + + Salidas +
+ ```yaml + name: from_epoch + + workflowInputs: + timestamp: + type: Int + timestampUnit: + type: String + timezoneId: + type: String + pattern: + type: String + + steps: + - name: epochTime + type: action + action: utils.datetime.fromEpoch + version: 1 + inputs: + timestamp: ${{ .workflowInputs.timestamp }} + timezoneId: ${{ .workflowInputs.timezoneId }} + pattern: ${{ .workflowInputs.pattern }} + timestampUnit: ${{ .workflowInputs.timestampUnit }} + ``` + + ```json + mutation { + workflowAutomationStartWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { name: "from_epoch" } + workflowInputs: [ + {key: "timestamp", value: "1738236424003"} + {key: "timestampUnit", value: "MILLISECONDS"} + {key: "pattern", value: "yyyy-mm-dd HH:SS"} + {key: "timezoneId", value: "Asia/Kolkata"} + ] + ) { + runId + } + } + ``` + + ```json + { + "date": "2025-01-30", + "time": "16:57:04.003" + "datetime": "2025-01-30 16:00", + "timezone": { + "abbreviation": "IST", + "id": "Asia/Kolkata" + } + } + ``` +
+ + + + + + + + + Esta acción se emplea para transformar varios tipos de entrada (JSON, mapa) a formato CSV. + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Aporte + + Opcionalidad + + Tipo + + Descripción +
+ **datos** + + Requerido + + cualquier + + Una cadena que representa datos para transformar a CSV, normalmente una cadena JSON o un mapa. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo + + Opcionalidad + + Tipo de datos + + Descripción +
+ **csv** + + Requerido + + cadena + + Una representación CSV de los datos recibidos. +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Ejemplo + + Entrada del flujo de trabajo + + Salidas +
+ ```json + name: nrqltocsv + + steps: + - name: queryForLog + type: action + action: newrelic.nrql.query + version: 1 + inputs: + accountIds: ['${{ .workflowInputs.accountId }}'] + query: ${{ .workflowInputs.nrql }} + + - name: csv1 + type: action + action: utils.transform.toCSV + version: 1 + inputs: + data: ${{ .steps.queryForLog.outputs.results | tostring }} + ``` + + ```json + mutation { + startWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { + name: "nrqltocsv", + } + workflowInputs: [ + {key: "accountId" value: "12345678"} + {key: "nrql" value: "FROM TransactionError SELECT error.message, error.class, transactionName, request.uri, query WHERE appName like 'my-app-1%' AND error.expected IS FALSE SINCE 1 hour ago LIMIT 50"} + ] + ) + { runId } + } + ``` + +
+ + + + + + + + + Generar un UUID V4 compatible con RFC. + + + + + Entradas + + + + Salidas + + + + Ejemplo + + + + + + + + + + + + + + + + + + + + + + +
+ Aporte + + Opcionalidad + + Tipo de datos + + Descripción +
+ + + + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Campo + + Tipo de datos + + Descripción +
+ **uuid** + + cadena + +
+ + + + + + + + + + + + + + + + + + + + + +
+ Ejemplo + + Entrada del flujo de trabajo + + Salidas +
+ + + nombre: generarUUID
pasos: + + * nombre: generarUUID tipo: acción acción: utils.uuid.generate versión: 1 + 		+ ```json + { + "uuid": "c76bd606-5eaa-42bb-a847-4221fb49f83c", + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/create-destinations.mdx b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/create-destinations.mdx new file mode 100644 index 00000000000..66987ee426d --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/create-destinations.mdx @@ -0,0 +1,91 @@ +--- +title: Enviar notificación de flujo de trabajo +tags: + - workflow automation + - workflow + - notifications + - slack + - pagerduty +metaDescription: 'Configure workflows to send notifications via Slack, PagerDuty, email, or webhooks when automation tasks complete or fail.' +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +flujo de trabajo puede enviar notificaciones a su equipo a través de Slack, PagerDuty, email o webhooks personalizados. Emplee notificaciones para alertar a los equipos cuando el flujo de trabajo se complete, falle o requiera aprobación. + +## Elige tu canal de notificación + +Seleccione el canal adecuado para su caso de uso: + +| **Canal** | **Ideal para** | **Complejidad de configuración** | **Característica** | +| ---------------------- | ------------------------------------ | -------------------------------- | ---------------------------------------- | +| **Slack** | Colaboración en equipo, aprobaciones | Fácil: requiere token de bot | Mensajes enriquecidos, reacciones, hilos | +| **PagerDuty** | gestión de equipos, de guardia | Fácil - requiere clave de API | Políticas de escalamiento, seguimiento | +| **Correo electrónico** | Notificación formal, reportes | Fácil: configuración SMTP | Archivos adjuntos, formato HTML | +| **Webhooks** | Integración personalizada | Medio - requiere extremo | Carga flexible, cualquier sistema | + +## Antes de que empieces + +Antes de configurar la notificación, cerciorar de tener: + +* Un flujo de trabajo creado en su cuenta (a partir de [una plantilla](/docs/workflow-automation/create-a-workflow-automation/use-a-template) o [uno personalizado](/docs/workflow-automation/create-a-workflow-automation/create-your-own)). +* Credenciales para su canal de notificación ( token de bot de Slack, clave de API de PagerDuty, etc.). +* Las credenciales se almacenan en [el administrador de secretos](/docs/infrastructure/host-integrations/installation/secrets-management/). + +## Configurar un destino [#set-the-destination] + +1. Navegue a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Destinations** y seleccione **Workflow Automation**. + +2. Para configurar la Automatización del flujo de trabajo, ingrese la información requerida, como el **nombre de destino de la Automatización del flujo de trabajo** (un nombre único para la Automatización del flujo de trabajo) y la **API Key**. + +3. Haz clic en **Save destination**. + + Image of the Workflow Automation destination page. + +## Crear un flujo de trabajo de notificación [#create-the-notification-workflow] + +1. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Notification Workflows** y seleccione **+ Add a workflow**. + +2. Para configurar su flujo de notificación de trabajo, en la página Configurar su flujo de notificación de trabajo, proporcione la información requerida: + + * Introduce un nombre único que puedas reconocer. + * Seleccione **Tag**, **Policy** y el atributo **Priority** de sus respectivos menús desplegables en la opción de filtro **Basic** para recibir notificaciones sobre un incidente, u opte por la opción de filtro **Advanced** para elegir **Attributes**, **Operators** y **Values** para obtener notificaciones de incidentes más detalladas. + * Haz clic en **Additional settings** para enriquecer tus datos creando [una consultaNRQL ](/docs/alerts/get-notified/incident-workflows/#enrichments)para recopilar datos relacionados de toda tu plataforma New Relic. Para ver ejemplos de enriquecimiento, consulte [Enriquecimiento de datos de flujo de trabajo](/docs/alerts/get-notified/custom-variables-incident-workflows/#enrichment-examples). + +3. Para especificar los destinos de notificación, en la sección **Notify**, elija uno o más [**destinos**](/docs/alerts/get-notified/destinations). + +4. Aquí tienes un ejemplo: para enviar una notificación a un grupo [de Slack](/docs/alerts/get-notified/notification-integrations/#slack), selecciona **Slack** como tipo de destino. + + 1. Seleccione **Slack destination** de la lista desplegable. + 2. Elige el **Channel** de la lista desplegable y marca la casilla **Receive notification updates on the channel**. + 3. Opcionalmente, agregue un mensaje personalizado en la sección **Custom Details**. + + + Recomendamos enviar una notificación de prueba empleando la opción **Send test notification**. + + + 4. Seleccione **Save message**. + +5. Para probar la automatización del flujo de trabajo, seleccione **Test workflow**. Esto emplea datos existentes de tu cuenta para verificar la configuración y envía una notificación de muestra para cerciorar que llegue al grupo de Slack. + +6. Seleccione **Activate workflow**. + + Image of how to configure a workflow + +## ¿Que sigue? + +Configuraste tus destinos de notificación. Ahora explore todas las acciones disponibles para construir un flujo de trabajo poderoso. + +**Siguiente paso en su recorrido**: [Catálogo de acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) : explore todas las acciones disponibles para AWS, New Relic e integración. + +**¿Listo para construir?** + +* [Emplee una plantilla de flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/use-a-template) : comience con un flujo de trabajo prediseñado +* [Crea tu propio flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/create-your-own) : construye desde cero. +* [Gestión del flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) : conozca el dashboardflujo de trabajo \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx new file mode 100644 index 00000000000..52312548049 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx @@ -0,0 +1,465 @@ +--- +title: Configurar las credenciales de AWS +metaDescription: 'Configure AWS credentials for workflow automation using IAM roles, IAM users, or temporary session tokens.' +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Autoriza la automatización del flujo de trabajo de New Relic para que realice acciones en tu cuenta de AWS. Configurarás un método de autenticación que permita a flujo de trabajo interactuar de forma segura con servicios de AWS como EC2, SQS, DynamoDB y más, sin codificar las credenciales ni comprometer la seguridad. + +## Requisitos previos + +Antes de configurar las credenciales de AWS, cerciorar de tener lo siguiente: + +* Una cuenta AWS con licencia para crear roles o usuarios de IAM. +* Su [ID de cuenta de New Relic](/docs/accounts/accounts-billing/account-structure/account-id). +* Acceso de administrador a la [consola de AWS IAM](https://console.aws.amazon.com/iam/). + +## Comprender las licencias necesarias [#required-permissions] + +Antes de crear las credenciales, comprenda qué licencias necesita su flujo de trabajo. Otorgue únicamente las licencias que su flujo de trabajo realmente emplee; esto sigue el principio de mínimo privilegio y minimiza el riesgo de seguridad. + +### Licencias comunes del flujo de trabajo + +| **Tipo de flujo de trabajo** | **Licencias de AWS necesarios** | **Descripción** | +| ---------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | +| **Gestión de EC2** | `ec2:DescribeInstances`
`ec2:StopInstances`
`ec2:StartInstances`
`ec2:ModifyInstanceAttribute` | Detener, iniciar o modificar instancias EC2 en respuesta a alertas | +| **Mensajería SQS** | `sqs:SendMessage`
`sqs:GetQueueAttributes` | Enviar mensajes a las colas SQS para su posterior procesamiento. | +| **Puerta de enlace API** | `apigateway:GET`
`apigateway:PUT` | Revertir el despliegue o configuración de API Gateway | +| **Gerente de sistemas** | `ssm:CreateDocument`
`ssm:DeleteDocument`
`ssm:StartAutomationExecution`
`ssm:GetAutomationExecution` | Ejecutar manuales de automatización | +| **DinamoDB** | `dynamodb:Query`
`dynamodb:GetItem`
`dynamodb:PutItem` | Leer o escribir en tablas de DynamoDB | + + + Comience con licencias de solo lectura (`Describe*`, `Get*`, `List*`), luego agregue licencias de escritura (`Put*`, `Create*`, `Delete*`) solo según sea necesario. Esto evita acciones destructivas accidentales durante las pruebas. + + +Consulte [los ejemplos de políticas](#policy-examples) a continuación para ver plantillas completas de políticas de IAM. + +## Configurar la autenticación + +Elija el método que mejor se ajuste a su caso de uso en la tabla anterior: + + + + Rol de IAM (recomendado) Usuario de IAM con claves de acceso Token de sesión + + + + + Un rol de IAM permite a New Relic asumir credenciales temporales en su cuenta de AWS sin necesidad de claves de acceso permanentes. + + **Características del rol de IAM:** + + * Las credenciales rotan automáticamente + * El acceso está limitado en el tiempo por diseño. + * Todas las acciones se registran en AWS CloudTrail. + * Se alinea con las mejores prácticas de seguridad AWS + + ### Crea el rol en AWS + + 1. Inicia sesión en la [consola de AWS IAM](https://console.aws.amazon.com/iam/) + 2. Navegue a **Roles > Crear rol > Tipo de entidad de confianza** y seleccione **Cuenta de AWS > otra cuenta de AWS** + 3. En el campo **Account ID**, introduzca: `253490767857` + 4. En **Options**, marque la casilla **Require external ID**. + 5. En el campo **External ID**, ingrese su ID de cuenta de New Relic y haga clic en **Next**. + + * ¿No lo tienes? [Encuentra tu ID de cuenta aquí.](/docs/accounts/accounts-billing/account-structure/account-id) + + 6. En la página **Add permissions**, anexe políticas basadas en su flujo de trabajo: + + * Para flujo de trabajo EC2: anexe `AmazonEC2ReadOnlyAccess` o cree una política personalizada + * Para flujo de trabajo SQS: anexe `AmazonSQSFullAccess` o limite a colas específicas + * Para otros servicios: Consulte [las licencias de AWS necesarios](#required-aws-permissions) a continuación. + + 7. Haga clic en **Next**. + 8. Introduzca un nombre para el rol: `NewRelicWorkflowAutomationRole` (o el nombre que prefiera) + 9. Opcionalmente, agregue una descripción: "Permite que la automatización del flujo de trabajo de New Relic realice acciones en AWS", y haga clic en **Create role**. + + ### Verifique la política de confianza + + Tras crear el rol, verifique la relación de confianza: + + 1. En la consola de IAM, seleccione el rol que acaba de crear. + 2. Haz clic en la pestaña **Trust relationships** + 3. Confirme que la política coincide con esta estructura (reemplace `` con su ID de cuenta real): + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sts:AssumeRole", + "Principal": { + "AWS": "arn:aws:iam::253490767857:root" + }, + "Condition": { + "StringEquals": { + "sts:ExternalId": "" + } + } + } + ] + } + ``` + + ### Copia tu ARN de rol + + Necesitarás el ARN del rol para configurar el flujo de trabajo: + + 1. En la consola de IAM, seleccione su rol. + 2. En la sección **Summary**, localice el campo **ARN** + 3. Copia el ARN completo; tiene el siguiente aspecto: `arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole` + 4. Almacene este ARN de forma segura: lo pegará directamente en la configuración de flujo de trabajo + + + **Importante:** Los ARN de rol van directamente en las entradas del flujo de trabajo; no los almacene en el administrador de secretos. No son credenciales confidenciales; son identificadores de recursos. + + + El rol ya está configurado. Emplee el ARN en la configuración de flujo de trabajo que requiera acceso AWS. + + + + Emplee este método para entornos de prueba o cuando no se admitan roles de IAM. Las claves de acceso son credenciales de larga duración que requieren rotación manual. + + **Casos de uso:** + + * Entornos de prueba y desarrollo + * Configuración AWS que no admite la asunción de roles entre cuentas + * Autenticación simplificada flujo de trabajo + + + Las claves de acceso son credenciales de larga duración. Rótelos de manera regular (cada 90 días) y limite las licencias solo a lo que su flujo de trabajo necesita. + + + ### Crea el usuario de IAM + + 1. Inicia sesión en la [consola de AWS IAM](https://console.aws.amazon.com/iam/) + 2. Navegue a **Users > Create user** e ingrese un nombre de usuario: `workflow-automation-user` (o su nombre preferido) + 3. Haga clic en **Next** + 4. En la página **Set permissions**, seleccione **Attach policies directly**. + 5. Busque y seleccione pólizas en función de su flujo de trabajo: + + * Para SQS: Seleccionar `AmazonSQSFullAccess` + * Para EC2: Seleccione `AmazonEC2ReadOnlyAccess` + * O bien, cree una política personalizada con licencias limitadas (recomendado). + + 6. Haz clic en **Next** y luego en** Create user** + + ### Generar claves de acceso + + 1. En la lista de usuarios, seleccione el usuario que acaba de crear. + 2. Haz clic en la pestaña **Security credentials** + 3. En la sección **Access keys**, seleccione **Create access key** + 4. Seleccione **Application running outside AWS** y haga clic en **Next**. + 5. (Opcional) Agregue una etiqueta de descripción: "Automatización del flujo de trabajo de New Relic" + 6. Seleccione **Create access key** + 7. Copie ambas credenciales inmediatamente: + + * **ID de clave de acceso** (comienza con `AKIA...`) + * **Clave de acceso secreta** (se muestra solo una vez) + + + AWS muestra la clave de acceso secreta solo una vez durante la creación. Si no lo almacenas, tendrás que generar un nuevo par de claves. + + + ### Almacena las credenciales de forma segura. + + Nunca codifique las credenciales AWS en el flujo de trabajo. En su lugar, almacénelos en [el administrador de secretos](/docs/infrastructure/host-integrations/installation/secrets-management/) de New Relic. + + 1. Abre el [explorador GraphiQL de NerdGraph](https://one.newrelic.com/nerdgraph-graphiql) + 2. Ejecuta esta mutación para almacenar tu ID de clave de acceso (reemplaza los valores de marcador de posición): + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } + } + ``` + + 3. Ejecuta otra mutación para tu clave de acceso secreta: + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsSecretAccessKey" + description: "AWS Secret Access Key for workflow automation" + value: "YOUR_AWS_SECRET_ACCESS_KEY" + ) { + key + } + } + ``` + + **Haga referencia a estos secretos en el flujo de trabajo** empleando la sintaxis: `${{ :secrets:awsAccessKeyId }}` + + + Emplee el campo `namespace` para organizar los secretos por entorno (`aws-prod`, `aws-staging`) o nombre del equipo. + + + + + El token de sesión proporciona credenciales temporales con caducidad automática. + + **Casos de uso:** + + * Desarrollo y pruebas locales + * Pipeline de CI/CD que requiere rotación de credenciales + * Entornos con requisitos de cumplimiento para el acceso limitado en el tiempo (normalmente de 1 a 12 horas). + + **Prerrequisitos:** + + * [AWS CLI instalado y configurado](https://aws.amazon.com/cli/) + * Un rol de IAM existente que puedes asumir + + ### Generar credenciales temporales + + 1. Abre tu terminal y ejecuta este comando (reemplaza con el ARN de tu rol): + + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` + + Si es la primera vez que emplea la CLI de AWS, es posible que deba configurarla con `aws configure` e ingresar sus credenciales de acceso: + + Image of the Static Access credentials + + 2. AWS devuelve tres valores; necesitas los tres: + + ```json + { + "Credentials": { + "AccessKeyId": "ASIAIOSFODNN7EXAMPLE", + "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", + "SessionToken": "FQoGZXIvYXdzEBk...", + "Expiration": "2025-01-25T12:00:00Z" + } + } + ``` + + 3. Almacena las tres credenciales en el administrador de secretos: + + * `AccessKeyId` almacenar como `awsAccessKeyId` + * `SecretAccessKey` almacenar como `awsSecretAccessKey` + * `SessionToken` almacenar como `awsSessionToken` + + + El token de sesión caduca (normalmente luego de 1 hora). Establece un recordatorio para actualizarlos antes de la timestamp `Expiration`, o tu flujo de trabajo fallará con errores de autenticación. + + + + + +## Usar credenciales en flujo de trabajo [#use-credentials] + +Luego de configurar la autenticación, haga referencia a sus credenciales en la configuración de flujo de trabajo: + +### Rol de IAM (recomendado) + +Pegue el ARN del rol directamente en las entradas del flujo de trabajo; no se necesita ningún administrador de secretos: + +```yaml +awsRoleArn: arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole +``` + + + Los ARN de rol son identificadores de recursos, no credenciales confidenciales. No los almacenes en el administrador de secretos; pégalos directamente en la configuración de flujo de trabajo. + + +### Usuario o token de sesión de IAM + +Gestor de secretos de referencia para claves de acceso: + +```yaml +awsAccessKeyId: ${{ :secrets:awsAccessKeyId }} +awsSecretAccessKey: ${{ :secrets:awsSecretAccessKey }} +awsSessionToken: ${{ :secrets:awsSessionToken }} # Only for session tokens +``` + +New Relic recupera los secretos en tiempo de ejecución, se autentica con AWS y luego los descarta. Tus credenciales nunca aparecen en los logs ni en el historial del flujo de trabajo. + +## Ejemplos de políticas [#policy-examples] + +Emplee estas plantillas completas de políticas IAM para tipos de flujo de trabajo comunes. Cada una sigue el principio de mínimo privilegio al restringir el acceso a recursos específicos. + + + + Restringir el acceso a una cola específica: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + }, + { + "Effect": "Allow", + "Action": "sqs:GetQueueAttributes", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + } + ] + } + ``` + + Reemplace `us-west-2` con su región, `123456789012` con su ID de cuenta de AWS y `my-workflow-queue` con el nombre de su cola. + + + + Restringir el acceso a una instancia específica mediante etiqueta: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ec2:DescribeInstances", + "ec2:DescribeTags" + ], + "Resource": "*" + }, + { + "Effect": "Allow", + "Action": [ + "ec2:StopInstances", + "ec2:StartInstances", + "ec2:ModifyInstanceAttribute" + ], + "Resource": "arn:aws:ec2:us-east-1:123456789012:instance/*", + "Condition": { + "StringEquals": { + "aws:ResourceTag/Environment": "production" + } + } + } + ] + } + ``` + + Esta política permite que el flujo de trabajo detenga/inicie/modifique solo instancias de la etiqueta EC2 con `Environment=production`. + + + + Restringir el acceso a una tabla específica: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "dynamodb:Query", + "dynamodb:GetItem", + "dynamodb:PutItem" + ], + "Resource": "arn:aws:dynamodb:us-east-1:123456789012:table/WorkflowData" + } + ] + } + ``` + + Reemplace `WorkflowData` con el nombre de su tabla. + + + + Restringir el acceso a documentos de automatización específicos: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument" + ], + "Resource": "arn:aws:ssm:us-east-1:123456789012:document/WorkflowAutomation-*" + }, + { + "Effect": "Allow", + "Action": [ + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": [ + "arn:aws:ssm:us-east-1:123456789012:automation-definition/WorkflowAutomation-*:*", + "arn:aws:ssm:us-east-1:123456789012:automation-execution/*" + ] + } + ] + } + ``` + + Esto restringe los documentos de automatización a aquellos que comienzan con `WorkflowAutomation-`. + + + + Restringir el acceso a una API específica: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "apigateway:GET", + "apigateway:PUT" + ], + "Resource": "arn:aws:apigateway:us-west-2::/restapis/abc123xyz/*" + } + ] + } + ``` + + Reemplace `abc123xyz` con su ID de API Gateway. + + + +### Recursos adicionales + +Para obtener referencias completas sobre las licencias de AWS: + +* **[Políticas gestionadas de integraciónAWS ](/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies/)**: Lista completa de licencias AWS por servicio, además de plantillas de CloudFormation que puede adaptar. +* **[Configurar sondeo de API de AWS](/docs/infrastructure/amazon-integrations/connect/set-up-aws-api-polling/)**: Patrones de configuración adicionales + + + Esos recursos emplean el ID de cuenta `754728514883` para la integración en la nube (monitoreo). Para la automatización del flujo de trabajo, emplee siempre `253490767857`. + + +## Próximos pasos + +Luego de configurar las credenciales AWS, puede crear un flujo de trabajo: + +**Crear flujo de trabajo:** + +1. **[Explorar las acciones de AWS](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: Ver las operaciones de AWS disponibles (EC2, SQS, DynamoDB, etc.). +2. **[Emplee una plantilla](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: implementar flujo de trabajo preconfigurado para tareas comunes de automatización AWS +3. **[Cree un flujo de trabajo personalizado](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: cree un flujo de trabajo para sus requisitos específicos + +**Configurar notificación:** + +* **[Configurar destinos](/docs/workflow-automation/setup-and-configuration/create-destinations)**: configurar Slack, PagerDuty, email o notificación de webhook para eventos de flujo de trabajo \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/troubleshooting.mdx b/src/i18n/content/es/docs/workflow-automation/troubleshooting.mdx new file mode 100644 index 00000000000..00018374d67 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/troubleshooting.mdx @@ -0,0 +1,386 @@ +--- +title: Solucionar problemas de automatización de flujo de trabajo +tags: + - workflow automation + - troubleshooting + - workflow errors +metaDescription: 'Common issues and solutions for Workflow Automation including AWS credentials, workflow execution, and dashboard problems.' +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página proporciona soluciones a problemas comunes que puede encontrar al usar la automatización de flujo de trabajo. Para obtener ayuda adicional, consulte el [foro de soporte de New Relic](https://discuss.newrelic.com/) o póngase en contacto con [el soporte de New Relic](https://support.newrelic.com/). + +## Credenciales y autenticación de AWS + + + + **Problema:** Su flujo de trabajo falla con un error de autorización de AWS. + + **Soluciones:** + + 1. **Verifique su ID de cuenta:** Verifique que empleó `253490767857` (no `754728514883`) en la política de confianza. El ID de cuenta de integración en la nube (`754728514883`) es diferente del ID de cuenta de automatización de flujo de trabajo. + 2. **Verificar ID externo:** Confirme que el ID externo en su política de confianza coincide exactamente con el ID de su cuenta de New Relic (que se encuentra en [la configuración de la cuenta](/docs/accounts/accounts-billing/account-structure/account-id)). + 3. **Revisa las licencias:** Cerciórate de que tu rol o usuario de IAM tenga las licencias específicas de AWS que requiere tu flujo de trabajo. Consulta la tabla de [licencias de AWS necesarios](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials#required-aws-permissions). + 4. **Prueba con la CLI de AWS:** Ejecuta `aws sts assume-role` localmente para verificar que el rol sea asumible: + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/NewRelicWorkflowAutomationRole" \ + --role-session-name "TestSession" \ + --external-id "YOUR_NR_ACCOUNT_ID" + ``` + + + +### " tokenno válido" o credenciales caducadas + +**Problema:** el flujo de trabajo falla con errores de vencimiento token. + +**Soluciones:** + +1. **Para el token de sesión:** compruebe la timestampde expiración; el token de sesión suele durar entre 1 y 12 horas. Genera nuevos antes de que caduquen usando: + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` +2. **Para las claves de acceso:** Verifique que tanto el ID de la clave de acceso como la clave de acceso secreta estén almacenados correctamente en el administrador de secretos. Vuelva a comprobar los valores en [el explorador GraphiQL de NerdGraph](https://one.newrelic.com/nerdgraph-graphiql). +3. **Verifique la sintaxis de los secretos:** cerciorar de usar el formato `${{ :secrets:keyName }}`, no `${{ secrets.keyName }}`. El prefijo de dos puntos (`:secrets:`) es obligatorio. + +### No encuentro mi rol ARN + +**Problema:** Necesitas el ARN pero no puedes localizarlo en AWS. + +**Solución:** + +1. Inicia sesión en la [consola de AWS IAM](https://console.aws.amazon.com/iam/) +2. Selecciona **Roles** en el menú de navegación. +3. Busque el nombre de su rol (ej., `NewRelicWorkflowAutomationRole`) +4. Seleccione el rol; el ARN aparece en la sección Resumen. +5. El formato ARN es: `arn:aws:iam:::role/` + +### flujo de trabajo no puede acceder a recursos específicos AWS + +**Problema:** Tu rol tiene licencias, pero el flujo de trabajo aún no puede acceder a ciertos recursos. + +**Soluciones:** + +1. **Licencias a nivel de recurso:** Compruebe si su política de IAM restringe el acceso a ARN de recursos específicos. Es posible que necesite agregar un comodín (`*`) para realizar pruebas y luego restringirlo a recursos específicos. + ```json + { + "Effect": "Allow", + "Action": "ec2:DescribeInstances", + "Resource": "*" // Change from specific ARN to * for testing + } + ``` +2. **Políticas de control de servicios (SCP):** Si se encuentra en una organización de AWS, las SCP podrían bloquear ciertas acciones. Póngase en contacto con su administrador de AWS para revisar las políticas de la organización. +3. **Error de región:** cerciorar de que sus licencias de IAM especifiquen la región correcta de AWS donde se encuentran sus recursos. Actualiza el parámetro `awsRegion` del flujo de trabajo para que coincida con la ubicación de tu recurso. + +## Problemas de ejecución del flujo de trabajo + +### Referencia de resolución rápida de problemas + +Emplee esta tabla para un diagnóstico rápido de problemas comunes en el flujo de trabajo: + +| **Síntoma** | **Controlar** | **Solución** | +| -------------------------------------------------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | +| El flujo de trabajo falla en un paso específico. | Consulte los logs de ejecución para ver el mensaje de error. | Corrija la configuración, las credenciales o los datos de entrada para esa acción. | +| El flujo de trabajo se ejecuta, pero produce resultados incorrectos. | Verificar el paso de datos entre pasos | Verificar la sintaxis de la plantilla `${{ .steps.name.outputs.field }}` | +| El flujo de trabajo programado no se ejecuta. | Revisa el historial de ejecución para ver las ejecuciones omitidas. | Verificar la configuración de la programación y el estado del flujo de trabajo (Activo) | +| El flujo de trabajo agota el tiempo de espera. | Comprobar duración de la ejecución | Reducir la frecuencia de las votaciones o dividirlos en flujos de trabajo más pequeños | +| Los cambios no surten efecto. | Consulta el historial de versiones | Actualizar las ejecuciones programadas para usar la nueva versión | + +Para obtener instrucciones detalladas sobre cómo ver los logs y el historial de ejecución, consulte [Monitorear las ejecuciones del flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs). + +### El flujo de trabajo se muestra con el estado "Fallido". + +**Problema:** Aparece un flujo de trabajo con el estado Fallido en el dashboard. + +**Soluciones:** + +1. **Consulta el historial de ejecución**: + + * Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + * Haz clic en el nombre del flujo de trabajo + * Consulta **Run history** para ver qué ejecución falló. + +2. **Revisar los logs de ejecución**: + + * Haz clic en **View logs** de la ejecución fallida para identificar la acción específica que falló. + * Busque el mensaje de error que indique la causa raíz. + +3. **Causas comunes**: + + * **Credenciales no válidas**: token caducado, sintaxis de secretos incorrecta o claves secretas erróneas. + * **Licencias faltantes**: Licencias insuficientes AWS IAM, ámbitos token de bots de Slack o acceso a API + * **Cambios en los recursos objetivo**: Se eliminaron instancias EC2, se eliminaron canales de Slack o se renombró la base de datos. + * **Se superaron los límites de frecuenciaAPI **: Demasiadas requests a servicios externos (AWS, Slack, etc.). + * **Tiempos de espera de la red**: Las API externas tardan demasiado en responder. + +4. **Solucionar y volver a ejecutar**: Luego de resolver el problema, active manualmente el flujo de trabajo empleando la [API StartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) para verificar que funciona. + +### La ejecución del flujo de trabajo tarda demasiado. + +**Problema:** La ejecución del flujo de trabajo excede la duración o el tiempo de espera esperados. + +**Soluciones:** + +1. **Revisar la secuencia de acciones**: Consultar los logs para identificar las acciones lentas. Busque acciones con tiempos de ejecución superiores a 30 segundos. + +2. **Optimizar consultas**: Si emplea consultas NRQL, optimícelas para obtener un mejor rendimiento: + + * Agrega rangos de tiempo específicos en lugar de consultar todos los datos. + * Emplee `LIMIT` para reducir el tamaño del conjunto de resultados + * Filtrar tempranamente con cláusulas `WHERE` + +3. **Compruebe las API externas**: Las respuestas lentas de los servicios integrados (AWS, Slack) pueden retrasar la ejecución. Pruebe el tiempo de respuesta API por separado. + +4. **Considere los límites del flujo de trabajo**: revise [los límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits) para las restricciones de tiempo de espera (normalmente 15 minutos por flujo de trabajo). + +5. **Divida el flujo de trabajo más pequeño**: divida el flujo de trabajo complejo en automatizaciones más pequeñas y enfocadas que puedan ejecutar en paralelo. + +### Los cambios en el flujo de trabajo no surten efecto. + +**Problema:** Editaste un flujo de trabajo, pero los cambios no se aplican cuando se ejecuta. + +**Soluciones:** + +1. **Verifique que almacenó**: Compruebe que hizo clic en **Save** luego de editar la configuración del flujo de trabajo. + +2. **Comprueba la versión**: + + * Ir a los detalles del flujo de trabajo + * Haz clic en la pestaña **Version history**. + * Cerciórate de que tus últimos cambios aparezcan como una nueva versión. + * Verifique que esta versión esté marcada como activa. + +3. **Actualizar ejecuciones programadas**: Si el flujo de trabajo se ejecuta según una programación, actualice la programación para usar la nueva versión: + + * Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + * Encuentra carreras programadas + * Actualiza el cronograma para que haga referencia a la nueva versión del flujo de trabajo. + +4. **Borrar caché**: El almacenamiento en caché Browser podría mostrar una configuración antigua; actualice la página manualmente (Ctrl+Shift+R o Cmd+Shift+R). + +## Problemas con dashboard de flujo de trabajo + +### No puedo encontrar un flujo de trabajo en el dashboard + +**Problema:** Un flujo de trabajo que creaste no aparece en la lista dashboard. + +**Soluciones:** + +1. **Comprobar filtros**: + + * Haz clic en el menú desplegable del filtro. + * Seleccione "Todos" para los filtros de estado + * Limpiar la barra de búsqueda + +2. **Verificar cuenta**: Confirme que inició sesión en la cuenta correcta de New Relic donde se creó el flujo de trabajo. Comprueba el selector de cuentas en la esquina superior derecha. + +3. **Verificar licencias**: cerciorar de que su rol de usuario tenga acceso para ver el flujo de trabajo. Contacta con tu administrador de New Relic si necesitas licencias de acceso al flujo de trabajo. + +4. **Actualiza la página**: El almacenamiento en caché Browser a veces puede ocultar los cambios recientes. Prueba a realizar una actualización completa (Ctrl+Shift+R o Cmd+Shift+R). + +### No se puede eliminar un flujo de trabajo + +**Problema:** La opción Eliminar aparece deshabilitada o la eliminación falla. + +**Soluciones:** + +1. **Verificar licencias**: Verifique que su rol de usuario tenga licencias de eliminación para flujo de trabajo. Si es necesario, póngase en contacto con el administrador de su cuenta. + +2. **Detener ejecuciones programadas**: Cancele cualquier ejecución programada activa antes de eliminarla: + + * Navegue hasta los detalles del flujo de trabajo + * Ve a la pestaña **Scheduled runs** + * Cancela todos los horarios activos + +3. **Comprobar dependencia**: Algunos flujos de trabajo no se pueden eliminar si otras automatizaciones dependen de ellos. Comprobar si el flujo de trabajo es referenciado por: + + * Otro flujo de trabajo que lo llama + * política de alertas que lo desencadenan + * Sistemas externos que lo inician mediante API + +4. **Contacta con el soporte**: Si el problema persiste luego de intentar lo anterior, contacta con [el soporte de New Relic](https://support.newrelic.com/) para obtener ayuda. + +## Problemas específicos de integración + +### La notificación de holgura no aparece + +**Problema:** El flujo de trabajo se completa correctamente, pero los mensajes de Slack no aparecen. + +**Soluciones:** + +1. **Verifique el ID del canal**: cerciorar de usar el **ID** del canal de Slack (por ejemplo, `C01234ABCD`), no el nombre del canal. Encuentra el ID en Slack: + + * Haz clic derecho en el nombre del canal + * Seleccionar **View channel details**. + * Copia el ID del canal que aparece en la parte inferior. + +2. **Comprobar licencias del bot**: Verifique que su bot de Slack tenga las siguientes licencias: + + * `chat:write` - Publicar mensajes + * `channels:read` - Ver canales públicos + * `groups:read` - Ver canales privados (si corresponde) + +3. **Verificar que el bot esté en el canal**: Agregar el bot al canal objetivo: + + * Escriba `/invite @YourBotName` en el canal + * Confirma que el bot aparece en la lista de miembros + +4. **Comprobar token en secretos**: Verifique que el token de Slack almacenado en el administrador de secretos sea correcto y no caducó. + +### Las operaciones de AWS Systems Manager fallan. + +**Problema:** Los documentos o comandos de automatización de SSM no se ejecutan. + +**Soluciones:** + +1. **Verifique las licencias de SSM**: Cerciorar de que el rol de IAM tenga estas licencias: + ```json + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument", + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": "*" + } + ``` +2. **Comprobar agente SSM**: Verifique que las instancias EC2 de destino tengan el agente SSM instalado y en ejecución: + ```bash + aws ssm describe-instance-information --region us-east-1 + ``` +3. **Verificar perfil de instancia**: Las instancias EC2 necesitan un perfil de instancia IAM con licencias SSM para ejecutar comandos. +4. **Comprobar que el documento existe**: Si emplea un documento SSM existente, verifique que exista en su cuenta y región de AWS. + +## Problemas específicos de la plantilla + +### No se encontró el GUID de la entidad. + +**Problema:** Las plantillas fallan con errores `Entity not found`. + +**Soluciones:** + +1. **Encuentra el GUID de entidad correcto**: + + * Ve a la página del recurso monitorear en New Relic. + * Comprueba la URL o los metadatos de la entidad para obtener el GUID. + * Emplee [la búsqueda de entidades](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic#find) para localizar entidades + +2. **Verifica que la entidad exista en la cuenta correcta**: Confirma que estás empleando la entidad de la misma cuenta donde se desarrolla el flujo de trabajo. + +3. **Confirmar datos de reportes de la entidad**: Compruebe que la entidad muestre ****reciente; es posible que se eliminó una entidad obsoleta. + +4. **Para entidad AWS **: Cerciorar de que [la integración](/docs/infrastructure/amazon-integrations/get-started/introduction-aws-integrations) esté activa + + + **Los GUID de entidad son específicos de cada cuenta.** Mover el flujo de trabajo entre cuentas requiere actualizar todos los GUID de la entidad. + + +### La consulta NRQL no devuelve resultados + +**Problema:** Las plantillas que emplean NRQL consultan completamente pero devuelven conjuntos de datos vacíos. + +**Soluciones:** + +1. **Prueba la consulta primero**: Emplea [el generador de consultas](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) para validar la consulta antes de agregarla a las plantillas. + +2. **Verifique el tipo de datos y los nombres de los eventos**: + + * Use `FROM Transaction`, no `FROM Transactions` + * Comprobar que los nombres de los atributos coincidan exactamente (distinguiendo entre mayúsculas y minúsculas) + +3. **Ajustar rangos de tiempo**: Para datos dispersos, ampliar la ventana de tiempo: + + * Agregue `SINCE 1 hour ago` para datos recientes + * Emplee `SINCE 1 day ago` para tendencias + +4. **Simplifica y prueba de forma incremental**: comienza con una consulta básica y agrega filtros uno a la vez. + +5. **Comprobar [la sintaxis NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language)**: Verificar que la estructura de la consulta cumpla con los requisitos NRQL. + +### Falla el despliegue de la plantilla + +**Problema:** La plantilla no se despliega o muestra errores durante el despliegue. + +**Soluciones:** + +1. **Verifique todos los datos requeridos**: Cerciorar de completar todos los campos obligatorios (credenciales, GUID, consulta). +2. **Verificar formato de credenciales**: Los secretos deben usar el formato `${{ :secrets:keyName }}` con el prefijo de dos puntos. +3. **Prueba las credenciales de forma independiente**: Antes de implementar, prueba las credenciales AWS con la CLI AWS y el token de Slack en APIde Slack. +4. **Revisa los requisitos de la plantilla**: Cada plantilla enumera requisitos previos específicos; verifica que se cumplan todos. +5. **Compruebe si hay caracteres especiales**: Algunos campos (nombres de canales, consulta) pueden presentar problemas con caracteres especiales; emplee caracteres alfanuméricos siempre que sea posible. + +### Aprobación flujo de trabajo no responde + +**Problema:** Las plantillas que requieren aprobación de Slack (reversión de API Gateway, cambio de tamaño de EC2) no detectan reacciones. + +**Soluciones:** + +1. **Verificar los ámbitos token del bot**: + + * `reactions:read` - Requerido para detectar reacciones de emojis + * `chat:write` - Obligatorio publicar mensajes de aprobación + +2. **Formato de reacción**: Emplee el emoji exacto especificado en el flujo de trabajo (normalmente 👍 para aprobar, 👎 para rechazar). + +3. **Verifique la configuración de tiempo de espera**: requests de aprobación caducan luego del tiempo de espera configurado (normalmente de 5 a 10 minutos). + +4. **Cerciórate de que el bot pueda leer los mensajes**: El bot debe estar en el canal y tener licencia para leer el historial de mensajes. + +5. **Prueba con aprobación simple**: Crea un flujo de trabajo de prueba con solo lógica de aprobación para aislar el problema. + +### Problemas de administración de instancias EC2 + +**Problema:** La plantilla EC2 no puede redimensionar ni gestionar la instancia. + +**Soluciones:** + +1. **Verifique [CloudWatch Metric Streams](/install/aws-cloudwatch/) esté configurado**: Requerido para las métricas de EC2 en tiempo real. +2. **Marque [la integración de monitoreo EC2](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) activa**: garantiza que los datos de la instancia fluyan a New Relic +3. **Confirmar estado de la instancia**: la instancia debe estar en estado `running` o `stopped` ; los estados de transición (pendiente, deteniendo) provocan fallos. +4. **Verifique la compatibilidad del tipo de instancia**: no todos los tipos de instancia admiten todas las operaciones de cambio de tamaño; consulte [la documentación del tipo de instanciaAWS](https://aws.amazon.com/ec2/instance-types/) +5. **Comprobar licencias de inicio/parada**: el rol de IAM necesita `ec2:StopInstances` y `ec2:StartInstances` además de `ec2:ModifyInstanceAttribute` + +### La plantilla de análisis JSON no registra los datos. + +**Problema:** La plantilla de análisis JSON se ejecuta correctamente, pero no aparecen datos en los logs New Relic. + +**Soluciones:** + +1. **Verificar extremos de API**: Pruebe la URL de la página de estado en un navegador; cerciorar de que devuelve un JSON válido. +2. **Comprobar la estructura JSON**: La plantilla espera un formato específico; verificar que los campos de estado del componente coincidan con la estructura esperada. +3. **Revisar los filtros de log**: Cerciorar de que la acción de registro emplee el tipo de evento y el atributo correctos. +4. **Prueba con un extremo simple**: Usa un extremo JSON básico (como `https://httpbin.org/json`) para verificar que la mecánica de plantillas funciona. +5. **Comprobar licencias de la cuenta**: Verificar que el flujo de trabajo tenga licencia para escribir logs en New Relic. + +### Falla la autenticación de la consulta SQL de NRLens + +**Problema:** La plantilla NRLens falla con errores de autenticación o conexión. + +**Soluciones:** + +1. **Verificar las credenciales de NRLens**: Confirmar que las credenciales de SQL Consulta Gateway estén actualizadas y almacenadas correctamente en los secretos. +2. **Verifique los ID de organización y cuenta**: cerciorar de que ambos ID coincidan exactamente con su organización de New Relic. +3. **Pruebe la consulta SQL por separado**: emplee la interfaz NRLens para probar la consulta antes de agregarla al flujo de trabajo. +4. **Verifique la sintaxis SQL**: NRLens SQL difiere de NRQL; consulte [la documentación de NRLens](https://docs.newrelic.com/docs/nrlens-overview) para conocer la sintaxis compatible. +5. **Comprueba la complejidad de la consulta**: las uniones muy complejas o los conjuntos de datos grandes pueden agotar el tiempo de espera; simplifica la consulta o agrega límites de tiempo. + +## Próximos pasos + +Si sigues teniendo problemas luego de probar estas soluciones: + +* **[Foro de la comunidad de automatización de flujos de trabajo](https://discuss.newrelic.com/)**: Haz preguntas y obtén ayuda de otros usuarios. +* **[Soporte de New Relic](https://support.newrelic.com/)**: Contacta con soporte para problemas específicos de tu cuenta. +* **[flujo de trabajo mejores prácticas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Aprenda patrones para un flujo de trabajo confiable +* **[Límites del flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprender las restricciones y cuotas del sistema. \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx new file mode 100644 index 00000000000..e2f17190f61 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx @@ -0,0 +1,33 @@ +--- +title: Crear horario +tags: + - workflow automation + - workflow + - CreateSchedule + - workflow automation API +metaDescription: Create a schedule for a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Crea un cronograma para la definición de un flujo de trabajo. + +El número de programaciones y la duración mínima para una programación determinada se definen en [Límites del sistema de flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits). + +## Ejemplo + +Emplee el [generador de consultas](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) para crear y editar un flujo de trabajo. Consulte [el explorador de la API de NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +mutation { + workflowAutomationCreateSchedule( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "healthyHeartbeat", version: 1} + cronExpression: "0 0 * * *" + timezone: "Asia/Kolkata" + options: {logLevel: DEBUG} + ) { + scheduleId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx new file mode 100644 index 00000000000..eda888697fe --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: Crear definición de flujo de trabajo +tags: + - workflow automation + - workflow + - CreateWorkflowDefinition + - workflow automation API +metaDescription: Create a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API se emplea para crear una definición de flujo de trabajo. Devuelve un error si la definición del flujo de trabajo ya existe. + +## Ejemplo + +Emplee el [generador de consultas](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) para crear y editar un flujo de trabajo. Consulte [el explorador de la API de NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphiql + mutation { + workflowAutomationCreateWorkflowDefinition( + scope: { + id: "11933347" + } + definition: { + yaml: "bmFtZTogbXV0YXRpb25fZXhlY3V0ZQoKc3RlcHM6CiAgLSBuYW1lOiBleGVjMQogICAgdHlwZTogYWN0aW9uCiAgICBhY3Rpb246IG5ld3JlbGljLm5lcmRncmFwaC5leGVjdXRlCiAgICB2ZXJzaW9uOiAnMS4wLjAnCiAgICBpbnB1dHM6CiAgICAgIGdyYXBocWw6IHwKICAgICAgICBtdXRhdGlvbiBLZWVwQWxpdmUoJGd1aWQ6IEVudGl0eUd1aWQhKXsKICAgICAgICAgIGVudGl0eUtlZXBBbGl2ZShndWlkczogWyRndWlkXSkgewogICAgICAgICAgICByZWZyZXNoZWRFbnRpdGllcwogICAgICAgICAgfQogICAgICAgIH0KICAgICAgdmFyaWFibGVzOgogICAgICAgIGd1aWQ6ICJ7eyAud29ya2Zsb3dJbnB1dHMuZW50aXR5R3VpZCB9fSIKCiAgLSBuYW1lOiBsb2cxCiAgICB0eXBlOiBhY3Rpb24KICAgIGFjdGlvbjogbmV3cmVsaWMuaW5zdHJ1bWVudGF0aW9uLmxvZwogICAgdmVyc2lvbjogJzEuMC4wJwogICAgaW5wdXRzOgogICAgICBNZXNzYWdlOiAiZW50aXR5R3VpZCByZWZyZXNoZWQge3sgLnN0ZXBzLmV4ZWMxLm91dHB1dHMuZGF0YS5lbnRpdHlLZWVwQWxpdmUucmVmcmVzaGVkRW50aXRpZXMgfX0iCg==" + } + ) { + definition { + name + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx new file mode 100644 index 00000000000..b4af3f29363 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx @@ -0,0 +1,697 @@ +--- +title: Esquema de definición del flujo de trabajo +tags: + - workflow automation + - workflow schems + - workflow automation API +metaDescription: Workflow definitions are written in YAML. Keys use a camelCase naming convention. +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +## Esquema + +Las definiciones de flujo de trabajo se escriben en YAML. Las claves emplean una convención de nomenclatura `camelCase`. + +### **nombre** (Obligatorio) + +* **Tipo**: Cadena +* **Formato**: Debe ajustar a la expresión regular `^[A-Za-z_][A-Za-z0-9_-]*$`. +* **Longitud máxima**: 100 +* **Descripción**: Los valores `name` no distinguen entre mayúsculas y minúsculas. Por ejemplo, `ExampleWorkflow`, `exampleworkflow` y `EXAMPLEWORKFLOW` se consideran que representan la misma definición de flujo de trabajo. + +### **Descripción** (opcional) + +* **Tipo**: Cadena +* **Formato**: Debe ajustar a la expresión regular `^[A-Za-z0-9 _-]*$`. +* **Longitud máxima**: 200 +* **Descripción**: Un `description` del flujo de trabajo que explica su propósito. + +### **workflowInputs** (opcional) + +* **Tipo**: Mapa de mapas +* **Tamaño máximo**: 100 +* **Descripción**: Un mapa de las entradas del flujo de trabajo que acepta el flujo de trabajo. +* **Ejemplo**: + +```java + workflowInputs: + myInput1: + type: String + myInput2: + type: Number + defaultValue: 42 +``` + +* **`workflowInputs.`** (Obligatorio) + + * **Tipo**: Cadena (que se ajusta al [patrón seguro para expresiones]()) + * **Longitud mínima**: 1 + * **Longitud máxima**: 50 + * **Descripción**: El nombre de la entrada del flujo de trabajo. + +* **`workflowInputs..type`** (Obligatorio) + + * **Tipo**: Enumeración (Booleano, Lista, Mapa, Cadena, Entero, flotante) + * **Descripción**: El tipo de datos de la entrada del flujo de trabajo. + +* **`workflowInputs..defaultValue`** (Opcional) + + * **Tipo**: Cualquiera; debe ajustar a `type`. + * **Descripción**: El valor predeterminado para la entrada del flujo de trabajo. + +* **pasos** (Obligatorios) + + * **Tipo**: matriz de mapas + * **Descripción**: Los pasos a realizar cuando se ejecuta la definición del flujo de trabajo. Debe haber al menos un paso. + + + Los pasos se ejecutarán en el orden en que están definidos en la matriz `steps`. + + Si se desea un orden diferente, se puede realizar un “salto” configurando la propiedad `steps[*].next` con el nombre del paso al que se desea saltar. + + + * **`steps[*].name`** (Obligatorio) + + * **Tipo**: Cadena (que se ajusta al [patrón seguro para expresiones](); no puede ser `end`) + * **Longitud máxima**: 100 + * **Descripción**: El nombre del paso al que hará referencia `steps[*].next`. No pueden ser las palabras clave especiales `end`, `continue` o `break`, ya que estas se emplean para indicar un paso de terminación, una continuación de un bucle o para salir de un bucle. + + * **`steps[*].type`** (Obligatorio) + + * **Tipo**: Cadena + * **Descripción**: El tipo de paso, que indica qué hace el paso cuando se ejecuta. Consulte la [sección Tipos de pasos]() para conocer las opciones disponibles. + + * [**`steps[*].next`**](#steps-next) (Opcional) + + * **Tipo**: Cadena (que se ajusta al [patrón seguro para expresiones]()) + + * **Descripción**: + + * El nombre del siguiente paso a ejecutar cuando este paso se complete correctamente. La palabra clave especial `end` se puede emplear para indicar que este paso debe ser el último en ejecutar. + * Si se omite `next`, se empleará la siguiente entrada en la matriz `steps` de la definición como el siguiente paso implícito. Si no hay ninguna entrada siguiente, el flujo de trabajo se completará. + +## Tipos de pasos + +### **acción** + +Un paso que ejecuta una acción específica. Consulte [el Catálogo de Acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) para conocer las opciones disponibles. + +* **`steps[*].action`** (Obligatorio) + + * **Tipo**: Cadena + + * **Descripción**: El nombre completo de la función de acción que se va a ejecutar. Deberá seguir la siguiente convención: + + `..` + + * **Ejemplo**: + + * Acción que emplea los servicios de New Relic (por ejemplo, a través de NerdGraph): `newrelic.dashboards.getDashboard` + * Acción mediante Slack: `slack.chat.postMessage` + +* **`steps[*].version`** (Obligatorio) + + * **Tipo**: Cadena + * **Descripción**: La versión de la función de acción que se va a ejecutar. + +* **`steps[*].inputs`** (Opcional) + + * **Tipo**: Mapa de valores (incluye [expresiones]()) + + * **Descripción**: + + * Los datos de entrada que se pasarán a la función de acción. Las entradas específicas aceptadas se definen para cada acción. + * Las entradas pueden emplear expresiones. Consulte la sección [Cadenas de expresiones]() para obtener más detalles. + + + No se deben pasar datos sensibles (ni claves de API ni secretos, ni PII, PHI ni ningún dato de identificación personal) como argumentos. + + +* **`steps[*].inputs.selectors`** (Opcional) + + * **Tipo**: lista de mapas en la forma `name` con `expression`. + + * **Descripción**: + + * La entrada `selectors` permite redefinir la salida para que solo devuelva los elementos especificados. + * Se puede emplear la expresión. Consulte la sección [Cadenas de expresiones]() para obtener más detalles. + + * **Ejemplo** + + * En el ejemplo dado, estamos obteniendo `pageUrl` y `statusDescription` como respuesta de la acción http.get. + + ```yaml + name: status + description: A workflow for checking the status of New Relic components + + steps: + - name: query1 + type: action + action: http.get + version: 1 + inputs: + url: "https://status.newrelic.com/api/v2/status.json" + selectors: + - name: statusCode + expression: '.statusCode' + - name: pageUrl + expression: '.responseBody | fromjson | .page.url' + - name: statusDescription + expression: '.responseBody | fromjson | .status.description' + + - name: logOutput1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "status is '${{ .steps.query1.outputs.statusDescription }}' details at ${{ .steps.query1.outputs.pageUrl }}" + ``` + +### **bucle** + +Un bucle iterará sobre una colección dada definida por `in` y creará variables de bucle `index` y `element` para cada una de sus iteraciones. Estas variables de bucle son accesibles dentro del bucle solo con la expresión `${{ .steps..loop.element }}` o `${{ .steps..loop.index }` + +Para más detalles, consulte a continuación: + + + + Puedes usar el bucle para iterar a través de una lista, un mapa o una colección. + + * `for` (Requerido) + + * **Tipo**: Constante + * **Descripción**: Señal de inicio de un bucle. + + * `in` (Requerido) + + * **Tipo**: cadena (expresión) + * **Descripción**: Una expresión que debe evaluar como una colección de elementos. + + * `steps` (Requerido) + + * **Descripción**: Pasos a ejecutar en cada iteración del bucle. Un paso puede ser de cualquier tipo, incluyendo otro bucle. + + * **Ejemplos**: A continuación se muestra cómo ejecutar el flujo de trabajo de bucle Inputs. Tenga en cuenta que el resultado debe ser un tipo de colección. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # not exist outside of this loop + index: '${{ .steps.loopStep.loop.index }}' # not exist outside of this loop + ``` + + + * `element` y `index` se asignan automáticamente como parte del bucle. + * `Index` es de base cero. + * El `element` puede ser un tipo complejo si tienes una colección de elementos complejos. + * Todas las variables de bucle y las salidas de los pasos dentro del bucle tienen un ámbito de nivel de bucle. Estas variables se borran luego de salir del bucle y acceder a ellas fuera del bucle dará como resultado un valor nulo. Un bucle puede acceder a variables que están fuera del bucle si se definió previamente. + + + **Bucle for simple con enteros** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: ${{ [range(1; 6)] }} + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [1, 2, 3, 4, 5] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1, 2, 3, 4] + ``` + + **Bucle simple para el mapa** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [ { "key1": "val1" }, { "key2": "val2"} ] }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [{ "key1": "val1" }, { "key2": "val2"}] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1] + ``` + + **Saltar dentro de un bucle** + + Solo se permite saltar entre pasos con nombre que pertenezcan al mismo bucle for. No está permitido entrar o salir de un bucle for, acceder a un bucle interno/externo o alternar entre dos bucles for diferentes. + + ```yaml + name: myWorkflow + steps: + - name: firstStep + type: action + action: example.messaging.sayHello + version: '1.0.0' + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: step3 # Okay within the loop + - name: step2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.step1.outputs.greeting }}' + - name: step3 + type: action + action: example.messaging.sayHello + version: '1.0.0' + next: firstStep # Not okay, first step is not in the loop context + ``` + + **Emplee break/continue en un bucle** + + Para cambiar el flujo de un bucle for, puede usar `next: break` o `next: continue`. Tenga en cuenta que `break` y `continue` son objetivos de salto reservados definidos implícitamente dentro de un bucle. El uso de `next: break` o `next: continue` fuera de un bucle saltará al final de los pasos del flujo de trabajo. + + * El `end` funciona igual que `break` si se usa dentro de un bucle. + * Next se puede emplear tanto en pasos de conmutación como en cualquier tipo de paso. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [range(1; 6)] }}' + steps: + - name: insideLoopStep1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: continue + - name: insideLoopStep2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + - name: loopStepAgain + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: switchStep + type: switch + switch: + - condition: '${{ .steps.loopStepAgain.loop.index >= 0 }}' + next: break + - name: insideLoopStepAgain + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStepAgain.loop.element }}' + ``` + + + +* **`steps[*].for`** (Obligatorio) + + * **Tipo**: constante + * **Descripción**: Señal de inicio de un bucle + +* **`steps[*].in`** (Obligatorio) + + * **Tipo**: cadena (expresión) + + * **Descripción**: Una expresión que debe evaluar como una colección de elementos. + + * **`steps[*].steps`** (Opcional) + + * **Descripción**: Pasos a ejecutar en cada iteración del bucle. Consulte la definición para ver los pasos anteriores. + + * **Ejemplo**: + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: "${{ [range(1; 5)] }}"" + steps: + - name: step1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Loop: ${{ .steps.loopStep.loop.element }}" + ``` + +### **cambiar** + +* Un paso que comprueba varias condiciones y toma la primera rama que se evalúa como verdadera. + +* Un interruptor puede contener cualquier número de elementos de condición en una lista. Comprobará las condiciones en orden y procesará la primera que se evalúe como verdadera. Si ninguna se evalúa como verdadera, ejecutará su siguiente paso como se define en steps\[\*].next + +* **`steps[*].switch`** (Obligatorio) + + * **Tipo**: matriz + * **Descripción**: Una matriz de casos switch, que especifica la lista ordenada de condiciones a evaluar. + +* **`steps[*].switch[*].condition`** (Obligatorio) + + * **Tipo**: cadena (expresión) + * **Descripción**: Estado de la carcasa del interruptor. Si la evaluación es verdadera, se ejecutará el siguiente paso del caso. + +* **`steps[*].switch[*].next`** (Obligatorio) + + * **Tipo**: cadena (que se ajusta al [patrón seguro para expresiones]()) + * **Descripción**: El nombre del paso a ejecutar si la condición del caso se evalúa como verdadera. La palabra clave especial "end" puede emplear para indicar que este paso debe ser el último en ejecutar. + + ```yaml + - name: hasCompleted + type: switch + switch: + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Failed" }} + next: displayError + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Success" }} + next: displaySuccess + next: displayUnexpected + ``` + +### esperar + +Un paso que hace que el flujo de trabajo espere un cierto número de segundos antes de continuar. También puede escuchar una o más señales. Si no se recibe ninguna señal durante la espera, continuará con normalidad. Las señales se definen en una lista. Cada señal debe tener definido un siguiente paso correspondiente. La primera señal que se reciba será la que se procese. El valor recibido para la señal se almacenará en la salida del paso de espera y podrá emplear para el procesamiento lógico en pasos posteriores. + +* Ejemplo: + + ```yaml + name: waitSignalExample + workflowInputs: + steps: + - name: waitStep + type: wait + seconds: 300 + signals: [{name: 'mySignalName', next: 'firstStep'}] + - name: endStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "didn't get signal" + next: end + - name: firstStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.waitStep.outputs.signalInputs.myString }} + ``` + +* **`steps[*].seconds`** (Obligatorio) + + * **Tipo**: número + * **Descripción**: Número de segundos que se deben esperar antes de continuar con la ejecución del flujo de trabajo. + +* **`steps[*].signals`** + + * **Tipo**: matriz + * **Descripción**: Las señales que, al ser recibidas, desviarán el flujo del programa. + +* **`steps[*].signals[*].name`** + + * **Tipo**: cadena + * **Descripción**: El nombre de la señal que se debe escuchar. + +* **`steps[*].signals[*].next`** + + * **Tipo**: cadena + * **Descripción**: Paso a ejecutar si se recibe la señal especificada. + +## Tipos compartidos + +### Cadenas de expresión + +Varias propiedades aceptan valores de cadena con expresiones incrustadas que se evalúan durante la ejecución del flujo de trabajo, lo que permite emplear valores dinámicos dentro de las definiciones del flujo de trabajo. Las cadenas de expresión pueden contener una o varias expresiones, cada una de las cuales está encerrada entre llaves dobles. El contenido dentro de las llaves se evalúa usando jq. + +jq proporciona la capacidad de acceder y operar con valores de muchas maneras. Por ejemplo, la longitud de una cadena de entrada de flujo de trabajo podría lograr con lo siguiente: `${{ .workflowInputs.myString | length }}` + +Esta herramienta se puede emplear para construir y [probar expresiones JQ](https://play.jqlang.org/). + +### Propiedades de expresión + +Se puede acceder a varias propiedades mediante expresiones. Estas propiedades residen en un objeto de “ámbito”, por lo que las expresiones deben comenzar con un punto (.) para acceder a esas propiedades del objeto de ámbito. + +Las propiedades disponibles son: + +* `workflowInputs` - Objeto que contiene las entradas pasadas al flujo de trabajo al inicio. + * Ejemplo: `${{ .workflowInputs.myInput }}` +* `steps` - Objeto que contiene una propiedad para cada paso del flujo de trabajo + * `steps.` - Objeto que contiene propiedades para un paso específico + * `steps..outputs` - Objeto que contiene propiedades de resultado, específicas del paso/acción. + * Ejemplo: `${{ .steps.myStep.outputs.myResult }}` + +### Resultados de la evaluación de la expresión + +Una sola expresión jq puede evaluar como cualquier tipo JSON, pero es importante tener en cuenta que el resultado final de una cadena de expresión completa dependerá del contenido de la cadena (si la hay) que rodea a la(s) expresión(es). + +Si la totalidad de una cadena de expresión consiste en una sola expresión, entonces se evaluará al resultado de la expresión jq, manteniendo el tipo JSON del resultado. Por ejemplo, si a un flujo de trabajo se le pasa una matriz como entrada, la cadena `${{ .workflowInputs.myArray }}` se evaluaría como una matriz. Esto puede resultar útil para transmitir datos complejos dentro de un flujo de trabajo. + +Si la cadena de expresión contiene contenido distinto de una única expresión, se evaluará como un resultado de cadena. Por ejemplo, esto ocurre cuando una expresión tiene contenido antes o después, o si la cadena contiene varias expresiones. Cada expresión dentro de la cadena se evalúa y se convierte a una representación de cadena. + +Ejemplo: + +Para los siguientes ejemplos, suponga que myArray tiene un valor de \[1, 2, 3]. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Cadena de expresión + + Datos de resultados + + Tipo de resultado +
+ `${{ .workflowInputs.myArray }}` + + \[1, 2, 3] + + matriz de números +
+ `${{ .workflowInputs.myArray | length }}` + + 3 + + número +
+ `${{ .workflowInputs.myArray | length > 0 }}` + + verdadero + + booleano +
+ `Input is not empty: ${{ .workflowInputs.myArray | length > 0 }}` + + "La entrada no está vacía: verdadero" + + cadena +
+ `${{ .workflowInputs.myArray }} has length ${{ .workflowInputs.myArray | length }}` + + "tiene una longitud de 3" + + cadena +
+ +### Patrón seguro para expresiones [#expression-safe-pattern] + +Las propiedades que se pueden emplear en expresiones deben ajustar a la siguiente expresión regular: `^[A-Za-z_][A-Za-z0-9_]*$` + +### Referencias secretas + +Los valores secretos se pueden usar en acciones a través de cadenas de referencia que especifican el nombre de un secreto que se buscará en el Servicio de Secretos. Para hacer referencia a un secreto en una definición de flujo de trabajo, emplee la siguiente sintaxis: + +* `${{ :secrets: }}` para un secreto que no está en un `namespace` +* `${{ :secrets:: }}` para un secreto en un `namespace` + +Una cadena de expresión puede contener una mezcla de referencias secretas y expresiones JQ y/o múltiples referencias secretas. + +Ejemplos: + +```yaml + steps: + - name: bearer_auth + type: action + action: http.post + inputs: + headers: + Authorization: Bearer ${{ :secrets: }} +``` + +## Ejemplos + +* Hola Mundo + +```yaml +name: helloWorld +description: 'A hello world workflow' + +workflowInputs: + name: + type: String + defaultValue: World + required: false + validations: + - type: maxLength + errorMessage: "name must be at most 100 characters" + length: 100 + slackTokenSecret: + type: String + defaultValue: "${{ :secrets:SLACK_TOKEN }}" + slackChannel: + type: String + defaultValue: my-channel + validations: + - type: regex + errorMessage: "A slack channel name must be lowercase and can only contain letters, numbers, and hyphens" + pattern: "^[a-z0-9\\-]+$" + required: true + +steps: + - name: init1 + type: assign + inputs: + greeting: Hello ${{ .workflowInputs.name }} + + - name: logName + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.init1.outputs.greeting }} + + - name: waiting1 + type: wait + seconds: 1 + + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + query: >- + FROM Log SELECT * WHERE message LIKE '${{ .steps.init1.outputs.greeting + }}' + + - name: checkResult + type: switch + switch: + - condition: ${{ .steps.queryForLog.outputs.results | length > 0 }} + next: FoundMessage + + - name: waitingMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Waiting for log message... + token: ${{ .workflowInputs.slackTokenSecret }} + next: waiting1 + + - name: FoundMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Found message! ${{ .steps.queryForLog.outputs.results[0].message }} + token: ${{ .workflowInputs.slackTokenSecret }} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx new file mode 100644 index 00000000000..33f8fea5a6a --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx @@ -0,0 +1,44 @@ +--- +title: Eliminar programación +tags: + - workflow automation + - workflow + - Delete Schedule + - workflow automation API +metaDescription: 'Deletes the schedule of a workflow definition. Note, this doesn’t stop already running workflow instance.' +freshnessValidatedDate: never +translationType: machine +--- + +Elimina la programación de una definición de flujo de trabajo. Tenga en cuenta que esto no detiene ninguna ejecución de flujo de trabajo que se esté ejecutando actualmente (use la mutación StopWorkflowRun). + +## Ejemplo [#example] + +Emplee el [generador de consultas](https://one.newrelic.com/nerdgraph-graphiql?state=fc314f67-101e-a54a-169a-191d1fd41fd) para crear y editar un flujo de trabajo. Consulte [el explorador de la API de NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql + mutation { + workflowAutomationDeleteSchedule( + accountId: 11933347 + schedule: {id: "1a71d299-82c2-4b4d-9803-b14523e3a9e7"} + ) { + scheduleId + } + } +``` + +### Ejemplo de error + +En caso de que no se encuentre `schedule.id`, se devuelve la siguiente estructura. + +```graphql +{ + "data": { + "workflowAutomationDeleteSchedule": null + }, + "errors": [{ + "message": "Could not find schedule with ID MTE2NDk5MDB8TkdFUHxXT1JLRkxPV19TQ0hFRFVMRXwwMTk5MGUzYi04NzAyLTc2M2QtOWUzMy01ZTU1ZThmZTYzYjkl", + "path": ["workflowAutomationDeleteSchedule"] + }] +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx new file mode 100644 index 00000000000..6af224a610f --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx @@ -0,0 +1,32 @@ +--- +title: Eliminar definición de flujo de trabajo +tags: + - workflow automation + - workflow + - Delete Workflow Definition + - workflow automation API +metaDescription: Used to delete all the workflow definition versions with the specified name. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API elimina todas las versiones de definición de flujo de trabajo con el nombre especificado. + +Para eliminar una definición, no debe haber ninguna programación que emplee dicha definición. Si la definición está siendo empleada actualmente por una planeación, la eliminación de la definición fallará y devolverá un error en consecuencia. + +Todas las ejecuciones de flujo de trabajo en curso continuarán hasta su finalización incluso si se elimina la definición. + +## Ejemplo + +```graphql +mutation { + workflowAutomationDeleteWorkflowDefinition( + definition: {name: "my-workflow"} + scope: {id: "12345678", type: ACCOUNT} + ) { + definition { + name + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx new file mode 100644 index 00000000000..b537b4733a2 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx @@ -0,0 +1,158 @@ +--- +title: Obtener definiciones de acciones +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: 'Returns all action definitions stored. This operation is behind NerdGraph, under account stitch point.' +freshnessValidatedDate: never +translationType: machine +--- + +\#Devuelve todas las definiciones de acción que se pueden usar para componer una definición de flujo de trabajo. + +## Ejemplo + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + actionDefinitions { + results { + description + inputs { + name + required + secretAllowed + } + name + outputs { + name + } + timeout { + action + } + version + } + } + } + } + } +} +``` + +devuelve lo siguiente + +```graphql +{ + "data": { + "actor": { + "account": { + "workflowAutomation": { + "actionDefinitions": { + "results": [ + { + "description": "Reboot one or more EC2 instances in an AWS account.", + "inputs": [ + { + "name": "awsRoleArn", + "required": false, + "secretAllowed": false + }, + { + "name": "awsAccessKeyId", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSecretAccessKey", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSessionToken", + "required": false, + "secretAllowed": true + }, + { + "name": "region", + "required": true, + "secretAllowed": false + }, + { + "name": "instanceIds", + "required": true, + "secretAllowed": false + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "aws.ec2.rebootInstances", + "outputs": [ + { + "name": "success" + }, + { + "name": "response" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 25 + }, + "version": 1 + }, + { + "description": "Send logs to New Relic.", + "inputs": [ + { + "name": "attributes", + "required": false, + "secretAllowed": false + }, + { + "name": "logs", + "required": true, + "secretAllowed": false + }, + { + "name": "licenseKey", + "required": false, + "secretAllowed": true + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "newrelic.ingest.sendLogs", + "outputs": [ + { + "name": "success" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 20 + }, + "version": 1 + } + # more ... + ] + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx new file mode 100644 index 00000000000..d4e00821fc8 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx @@ -0,0 +1,29 @@ +--- +title: Obtener horario +tags: + - workflow automation + - workflow + - Get Schedule + - workflow automation API +metaDescription: API gets and returns a schedule. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtiene y devuelve un cronograma. + +## Ejemplo [#example] + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedule(id: "schedule-id") { + id + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx new file mode 100644 index 00000000000..4042444b008 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx @@ -0,0 +1,41 @@ +--- +title: Obtener horarios +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Returns information about schedules. +freshnessValidatedDate: never +translationType: machine +--- + +Devuelve información sobre horarios. + +## Ejemplo + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedules { + results { + definition { + name + scope { + id + type + } + version + } + schedule { + id + } + } + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx new file mode 100644 index 00000000000..9de48accca5 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx @@ -0,0 +1,35 @@ +--- +title: Obtener definición de flujo de trabajo +tags: + - workflow automation + - workflow + - Get Workflow Definition + - workflow automation API +metaDescription: Used to get and return a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtiene y devuelve una definición de flujo de trabajo. + +## Ejemplo + +Emplee el [generador de consultas](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) para crear y editar un flujo de trabajo. Consulte [el explorador de la API de NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflow(name: "my-workflow", version: 1) { + definition { + name + version + yaml + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx new file mode 100644 index 00000000000..c5efb1a9c3a --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx @@ -0,0 +1,38 @@ +--- +title: Obtener definiciones de flujo de trabajo +tags: + - workflow automation + - workflow + - Get Workflow Definitions + - workflow automation API +metaDescription: Used to get and return a list of workflow definitions under the user account’s scope. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtiene y devuelve una lista de todos los esquemas de definición de flujo de trabajo dentro del ámbito dado. Nota: la definición interna del flujo de trabajo en formato YAML no está disponible con esta consulta. Una definición de flujo de trabajo en formato YAML solo se devuelve mediante una consulta GetWorkflowDefinition. `/{actor/account(:id)/workflowAutomation/workflow(:name, :version)` + +## Ejemplo + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflows(cursor: "xyz123") { + results { + definition { + name + scope { + id + type + } + version + } + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx new file mode 100644 index 00000000000..91b1b31a200 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx @@ -0,0 +1,75 @@ +--- +title: Ejecución de flujo de trabajo de señal +tags: + - workflow automation + - workflow + - Signal Workflow Run + - workflow automation API +metaDescription: Actions trigger a signal to an existing running workflow. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API activa una señal en un flujo de trabajo en ejecución existente. Esto se puede emplear para enviar una devolución de llamada y que el flujo de trabajo lo evalúe para pasar a diferentes pasos siguientes. + +El parámetro se puede pasar junto con la señal. + +## Ejemplo [#example] + + + + ```yaml + name: signalDemo + + steps: + - name: waitStep + type: wait + seconds: 300 + signals: + - name: approve + next: signalHandler + - name: cancel + next: signalHandler + + - name: NoSignalReceived + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "no signals received" + next: end + + - name: signalHandler + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "signal '${{ .steps.waitStep.outputs.signalName }}' was received with: '${{ .steps.waitStep.outputs.signalInputs | tostring }}'" + ``` + + + +Tras iniciar este flujo de trabajo, este runId se devuelve al inicio. `107e6df2-aa17-41bc-8065-bfa46bde810b` + +El flujo de trabajo puede entonces indicar mediante esta mutación. + +```graphql +mutation { + workflowAutomationSignalWorkflowRun( + accountId: 11933347 + runId: "107e6df2-aa17-41bc-8065-bfa46bde810b" + signalName: "approve" + signalInputs: [ + {key: "foo", value: "bar"} + ] + ) { + runId + } +} +``` + +Lo siguiente puede observar en los logs si el flujo de trabajo se inició con el `options: {logLevel: DEBUG}` + +Screenshot displaying Logs if the workflow was started with the options: {logLevel: DEBUG} \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx new file mode 100644 index 00000000000..212d156b735 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx @@ -0,0 +1,35 @@ +--- +title: Iniciar ejecución del flujo de trabajo +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Start a workflow run for a specified workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API inicia la ejecución de un flujo de trabajo para una definición de flujo de trabajo específica. + +El número de ejecuciones simultáneas del flujo de trabajo y el número de pasos ejecutados en una ejecución determinada se definen en [Límites del sistema de flujo de trabajo](/docs/workflow-automation/limitations-and-faq/workflow-limits). + +## Ejemplo + +Emplee el [generador de consultas](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) para crear y editar un flujo de trabajo. Consulte [el explorador de la API de NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "my-workflow"} + workflowInputs: [ + {key: "foo", value: "bar"}, + {key: "fruit", value: "apple"} + ] + options: {logLevel: DEBUG} + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx new file mode 100644 index 00000000000..ed079aac57d --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx @@ -0,0 +1,26 @@ +--- +title: Detener la ejecución del flujo de trabajo +tags: + - workflow automation + - workflow + - Stop Workflow Run + - workflow automation API +metaDescription: Stops a running workflow instance. +freshnessValidatedDate: never +translationType: machine +--- + +Esto interrumpe un flujo de trabajo en curso. Devuelve un `runId` vacío si no se encuentra el flujo de trabajo. + +## Ejemplo + +```graphql +mutation { + workflowAutomationStopWorkflowRun( + accountId: 11933347 + runId: "7ffbe082-8efa-4d3d-901a-a08bcf22bcd3" + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx new file mode 100644 index 00000000000..67e2052b02c --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx @@ -0,0 +1,30 @@ +--- +title: Actualizar definición de flujo de trabajo +tags: + - workflow automation + - workflow + - Update Workflow Definition + - workflow automation API +metaDescription: Used to update an existing workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Se emplea para actualizar una definición de flujo de trabajo existente. Devuelve un error si la definición del flujo de trabajo no existe previamente. + +## Ejemplo + +```graphql + mutation { + workflowAutomationUpdateWorkflowDefinition( + definition: {yaml: ""} + scope: {id: "11608789", type: ACCOUNT} + ) { + definition { + name + version + yaml + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx new file mode 100644 index 00000000000..3739a3477b3 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx @@ -0,0 +1,81 @@ +--- +title: Referencia API de automatización de flujo de trabajo +tags: + - workflow automation + - workflow + - nerdgraph + - nerdgraph api + - workflow automation api +metaDescription: Complete reference guide for Workflow Automation APIs in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras! + + Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras [políticas de prelanzamiento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +La API de automatización de flujo de trabajo le permite crear, gestionar y ejecutar mediante programación flujo de trabajo en New Relic. Emplee estas API para automatizar tareas repetitivas, orquestar operaciones complejas e integrar el flujo de trabajo en sus procesos de desarrollo y operaciones. + +## Antes de que empieces + +Para emplear las API de automatización del flujo de trabajo, necesitará: + +* Una cuenta de New Relic con las licencias adecuadas. +* Acceso al [explorador de la API de NerdGraph](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) para crear y probar tu APIde llamadas. +* Conocimiento de [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) (la API GraphQL de New Relic) + +Para obtener ayuda adicional: + +* Aprende a usar el IDE de GraphiQL en el [tutorial del explorador de la API de NerdGraph.](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) +* Consulte [la Introducción a las API](/docs/apis/intro-apis/introduction-new-relic-apis) para obtener una descripción general de todas las API de New Relic. + +### Autenticación y secretos + +flujo de trabajo Automation emplea el almacenamiento secreto de los clientes para gestionar información confidencial como clave de API y credenciales. Los secretos se gestionan a través de [nuestra API GraphQL](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph). Para obtener detalles de autenticación relacionados con la gestión de secretos, consulte la [documentación de NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph). + +## Operaciones de API por categoría + +### Crear y gestionar flujo de trabajo. + +Emplee estas API para crear, actualizar, validar y eliminar definiciones de flujo de trabajo: + +* [CrearDefiniciónDeFlujoDeTrabajo](/docs/workflow-automation/workflow-automation-apis/create-workflow-definition) - Crear una nueva definición de flujo de trabajo +* [Actualizar definición de flujo de trabajo](/docs/workflow-automation/workflow-automation-apis/update-workflow-definition) : actualizar una definición de flujo de trabajo existente. +* [ValidateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition) : valida la definición del flujo de trabajo en formato YAML antes de crearlo o actualizarlo. +* [EliminarDefiniciónDeFlujoDeTrabajo](/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition) - Elimina todas las versiones de una definición de flujo de trabajo con el nombre especificado. + +### consulta flujo de trabajo y acciones + +Emplee estas API para recuperar información sobre el flujo de trabajo y las acciones disponibles: + +* [GetWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/get-workflow-definition) - Obtiene y devuelve una definición de flujo de trabajo específica. +* [GetWorkflowDefinitions](/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions) : obtiene y devuelve una lista de definiciones de flujo de trabajo dentro del alcance de su cuenta. +* [GetActionDefinitions](/docs/workflow-automation/workflow-automation-apis/get-action-definitions) - Devuelve todas las definiciones de acción disponibles + +### Flujo de trabajo en ejecución + +Emplee estas API para controlar la ejecución del flujo de trabajo: + +* [IniciarEjecuciónDeFlujoDeTrabajo](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) - Inicia la ejecución de un flujo de trabajo para una definición de flujo de trabajo específica. +* [SignalWorkflowRun](/docs/workflow-automation/workflow-automation-apis/signal-workflow-run) : activa una señal en un flujo de trabajo en ejecución existente. +* [StopWorkflowRun](/docs/workflow-automation/workflow-automation-apis/stop-workflow-run) - Detener una instancia de flujo de trabajo en ejecución + +### Horario de trabajo + +Emplee estas API para crear y gestionar programaciones de flujo de trabajo: + +* [CrearProgramación](/docs/workflow-automation/workflow-automation-apis/create-schedule) - Crea una programación para una definición de flujo de trabajo +* [GetSchedule](/docs/workflow-automation/workflow-automation-apis/get-schedule) - Obtener y devolver detalles del horario +* [GetSchedules](/docs/workflow-automation/workflow-automation-apis/get-schedules) - Devuelve información sobre todos los horarios +* [Eliminar programación](/docs/workflow-automation/workflow-automation-apis/delete-schedule) : elimina la programación de una definición de flujo de trabajo. + + + Eliminar un horario no deja de ejecutar flujo de trabajo instancia. + + +### Documentación de referencia + +* [Esquema de definición](/docs/workflow-automation/workflow-automation-apis/definition-schema) : referencia de la estructura y sintaxis de la definición del flujo de trabajo. \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx new file mode 100644 index 00000000000..5f61e14bfaf --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: ValidarDefiniciónDeFlujoDeTrabajo +tags: + - workflow automation + - workflow + - Validate Workflow Definition + - workflow automation API +metaDescription: Used to validate workflow definition YAML. +freshnessValidatedDate: never +translationType: machine +--- + +Validar la definición del flujo de trabajo en formato YAML. + +## Ejemplo + +```graphql + query workflowDefinitionValidation { + actor { + account(id: 11933347) { + workflowAutomation { + workflowDefinitionValidation( + definition: {yaml: "ICAgICAgICAgICAgICAgIG5hbWU6IG15V29ya2Zsb3cKCiAgICAgICAgICAgICAgICBzdGVwczoKICAgICAgICAgICAgICAgICAgLSBuYW1lOiBvbmx5U3RlcAogICAgICAgICAgICAgICAgICAgIHR5cGU6IHdhaXQKICAgICAgICAgICAgICAgICAgICBzZWNvbmRzOiAtNDIKCiAgICAgICAgICAgICAgICAgIC0gbmFtZTogJycKICAgICAgICAgICAgICAgICAgICB0eXBlOiB3YWl0CiAgICAgICAgICAgICAgICAgICAgc2Vjb25kczogLTQyCgogICAgICAgICAgICAgICAgICAtIG5hbWU6IG9ubHlTdGVwCiAgICAgICAgICAgICAgICAgICAgdHlwZTogYWN0aW9uCiAgICAgICAgICAgICAgICAgICAgYWN0aW9uOiBDb25zb2xlTG9nCiAgICAgICAgICAgICAgICAgICAgdmVyc2lvbjogIiIKICAgICAgICAgICAgICAgICAgICBpbnB1dHM6CiAgICAgICAgICAgICAgICAgICAgICAgZm9vOiAiIg=="} + ) { + errors { + message + } + valid + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx new file mode 100644 index 00000000000..d73152a20b3 --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx @@ -0,0 +1,32 @@ +--- +title: WorkflowRunInfo +tags: + - workflow automation + - workflow + - Workflow Run Info + - workflow automation API +metaDescription: Used to retrieve information about a specific workflow run. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtiene y devuelve el estado de un flujo de trabajo para un runId de flujo de trabajo específico. + +## Ejemplo + +Emplee el [generador de consultas](https://one.newrelic.com/nerdgraph-graphiql?state=03119d23-7b51-7b7a-1c99-d2cd026300e5) para crear y editar un flujo de trabajo. Consulte [el explorador de la API de NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflowRunInfo(runId: "8911c7e4-5a1f-4316-90c8-67adde72dd1c") { + logUrl + status + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/es/docs/workflow-automation/workflow-examples.mdx b/src/i18n/content/es/docs/workflow-automation/workflow-examples.mdx new file mode 100644 index 00000000000..9179fade1fd --- /dev/null +++ b/src/i18n/content/es/docs/workflow-automation/workflow-examples.mdx @@ -0,0 +1,244 @@ +--- +title: Ejemplos de flujo de trabajo +tags: + - workflow automation + - workflow + - automation + - examples +metaDescription: 'Common workflow automation scenarios and examples for incident response, infrastructure management, and integrations.' +freshnessValidatedDate: never +translationType: machine +--- + +Esta página muestra escenarios comunes de automatización que puede crear con la automatización de flujo de trabajo. Emplee estos ejemplos como puntos de partida para su propio flujo de trabajo, o explore la [biblioteca de plantillas](/docs/workflow-automation/create-a-workflow-automation/use-a-template) para encontrar soluciones listas para desplegar. + +## respuesta a incidencias y remediación + +### Reversión de la puerta de enlace API + +Restablece la configuración de la puerta de enlace API a un estado anterior para poder corregir errores y configuraciones incorrectas. + +**Lo que hace este flujo de trabajo:** + +* Detecta implementaciones recientes relacionadas con un problema usando el seguimiento de cambios New Relic +* Envía notificaciones de Slack con botones de aprobación (:+1: o :-1:) +* Tras la aprobación, se crea un documento de AWS Systems Manager para automatizar la reversión. +* Revierte la integración de API Gateway a la versión anterior de Lambda +* Crea un nuevo despliegue para aplicar la reversión. +* Envía notificaciones de éxito o fracaso a Slack. +* Limpia el documento SSM una vez finalizado. + +**Requisitos:** + +* Credenciales de AWS con licencias para API Gateway y Systems Manager +* Una aplicación de Slack configurada para recibir notificaciones y aprobaciones. +* New Relic entidad monitoreo con seguimiento de cambios + +**Acciones clave**: `newrelic.nerdgraph.execute`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument` + +### gestión de instancias EC2 + +Automatice el aprovisionamiento, el escalado y la finalización de instancias EC2 para obtener un rendimiento y un costo óptimos. + +**Lo que hace este flujo de trabajo:** + +* Recibe alertas de alto uso de CPU de New Relic +* Recupera los detalles de la alerta e identifica las instancias EC2 afectadas. +* Envía una notificación de Slack con los detalles de la instancia y requests aprobación para el cambio de tamaño. +* Tras su aprobación, se crea un documento SSM para automatizar el redimensionamiento de la instancia. +* Detiene la instancia, modifica el tipo de instancia y la resetear. +* Envía actualizaciones de progreso a Slack durante el proceso de cambio de tamaño. +* Espera a que se complete la operación y envía un estado de éxito o de fallo. +* Limpia el documento SSM y envía la confirmación final. + +**Requisitos:** + +* Credenciales de AWS con licencias para EC2 y Systems Manager +* Una condición de alerta activa New Relic para EC2 métrica +* Una aplicación de Slack configurada para recibir notificaciones y aprobaciones. + +**Acciones clave**: `newrelic.nerdgraph.execute`, `newrelic.nrdb.query`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument`, `utils.datetime.fromEpoch`, `utils.uuid.generate` + +### despliegue rollback + +Revertir el despliegue si la entidad deja de estar en buen estado y notificar mediante AWS SQS o HTTP. + +**Lo que hace este flujo de trabajo:** + +* Monitorear la gravedad de las alertas de una entidad durante un periodo de tiempo determinado (30 minutos por defecto). +* Comprueba el estado de la entidad cada minuto +* Si la entidad pasa a estado CRÍTICO o de ADVERTENCIA, registra el estado incorrecto. +* Envía una notificación de reversión a través de AWS SQS (si está configurado) con los detalles de la entidad. +* Envía notificación de reversión mediante webhook HTTP (si está configurado). +* Si la entidad permanece en buen estado durante todo el periodo, registra el éxito. +* Detiene el monitoreo si no se encuentra la entidad + +**Requisitos:** + +* New Relic entidad con alerta de monitoreo de severidad +* (Opcional) Cola y rol AWS SQS para recibir la notificación de reversión +* (Opcional) Extremo HTTP para recibir notificación de reversión + +**Acciones clave**: `newrelic.nerdgraph.execute`, `newrelic.ingest.sendLogs`, `aws.execute.api` (sqs.send\_message), `http.post` + +## procesamiento de datos y elaboración de reportes + +### Enviar un reporte a Slack + +Envía el resultado de una consulta NRQL como archivo CSV en Slack. + +**Lo que hace este flujo de trabajo:** + +* Ejecuta una consulta NRQL en la(s) cuenta(s) de New Relic especificada(s). +* Genera un archivo CSV a partir de los resultados de la consulta. +* Publica el archivo CSV en un canal de Slack específico con un mensaje + +**Requisitos:** + +* Una credencial de New Relic y una consulta NRQL funcional +* Una aplicación de Slack configurada con un token y un canal objetivo + +**Acciones clave**: `newrelic.nrdb.query`, `utils.transform.toCSV`, `slack.chat.postMessage` + +### Análisis de JSON + +Analiza el JSON de la API de estado público de New Relic (HTTP) y, opcionalmente, registra los componentes operativos y no operativos. + +**Lo que hace este flujo de trabajo:** + +* Obtiene datos JSON de la API de estado de New Relic. +* Extrae y clasifica los componentes según su estado operativo. +* Registra condicionalmente los componentes operativos (si está habilitado). +* Registra condicionalmente los componentes no operativos (si está habilitado). +* Gestiona los errores HTTP y registra el mensaje de error. + +**Requisitos:** + +* Acceso a la API de estado de New Relic (summary.json) +* Licencias para enviar logs a través de newrelic.ingest.sendLogs + +**Acciones clave**: `http.get`, `newrelic.ingest.sendLogs` + +## Plantilla disponible flujo de trabajo + +Las plantillas enumeradas anteriormente están disponibles directamente en la UI de automatización de flujo de trabajo New Relic. Para acceder a ellos: + +1. Vaya a **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Haz clic en **Create workflow** +3. Seleccione **Use a template** +4. Explore la biblioteca de plantillas y elija un flujo de trabajo que se ajuste a su caso de uso. + +Cada plantilla incluye: + +* Pasos y lógica de flujo de trabajo preconfigurados +* Ejemplo de parámetro de entrada +* Credenciales e integración requeridas +* Documentación de los resultados esperados + +Puede emplear las plantillas tal cual o personalizarlas para adaptarlas a sus necesidades específicas. + +## Pasar datos entre pasos + +Todos los flujos de trabajo pueden hacer referencia a los resultados de pasos anteriores empleando sintaxis de plantillas. Esto te permite encadenar acciones y construir una lógica de automatización compleja. + +### Transmisión de datos básicos + +```yaml +steps: + - name: getAlert + action: newrelic.nerdgraph.execute + inputs: + query: | + { + actor { + account(id: 123456) { + alerts { + violation(id: 789) { + condition + entity { + name + guid + } + } + } + } + } + } + + - name: sendToSlack + action: slack.chat.postMessage + inputs: + channel: "#incidents" + text: "Alert: ${{ .steps.getAlert.outputs.data.actor.account.alerts.violation.condition }}" +``` + +### Emplear datos en bucles + +```yaml +steps: + - name: listInstances + type: action + action: aws.ec2.describeInstances + version: 1 + inputs: + filters: + - name: "tag:Environment" + values: ["production"] + + - name: checkEachInstance + type: loop + for: + in: "${{ .steps.listInstances.outputs.reservations }}" + steps: + - name: getInstanceMetrics + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + query: "SELECT average(cpuPercent) FROM SystemSample WHERE instanceId = '${{ .steps.checkEachInstance.loop.element.instanceId }}'" +``` + +### Lógica condicional con datos + +```yaml +steps: + - name: checkCPU + type: action + action: newrelic.nerdgraph.execute + version: 1 + # ... query configuration + + - name: decideAction + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 70 }}" + next: sendWarning + next: normalOperation + + - name: resizeInstance + type: action + action: aws.ec2.modifyInstanceAttribute + version: 1 + # ... resize configuration + + - name: sendWarning + type: action + action: slack.chat.postMessage + version: 1 + # ... warning message + + - name: normalOperation + type: action + action: newrelic.ingest.sendLogs + version: 1 + # ... log normal status +``` + +## Próximos pasos + +* **[Crea tu propio flujo de trabajo](/docs/workflow-automation/create-a-workflow-automation/create-your-own)** - Guía paso a paso para construir un flujo de trabajo +* **[Catálogo de acciones](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)** - Explore todas las acciones disponibles +* **[Emplee una plantilla](/docs/workflow-automation/create-a-workflow-automation/use-a-template)** : desplegar flujo de trabajo prediseñado +* **[Configurar las credenciales de AWS](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)** : configurar la autenticación de AWS \ No newline at end of file diff --git a/src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx b/src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx new file mode 100644 index 00000000000..6f47050af84 --- /dev/null +++ b/src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx @@ -0,0 +1,28 @@ +--- +title: Facturation complémentaire (en option) +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: Add-ons are an optional billing factor +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +En plus des principaux facteurs de facturation de GB Ingested et d'utilisateurs facturables, vous pouvez également utiliser des modules complémentaires facturables optionels pour étendre votre expérience avec New Relic. + +* **Calculateur avancé (anciennement calculateur complémentaire)**: ce module complémentaire s'applique à la facturation basée sur l'utilisation pour les actions que vous exécutez en relation avec CodeStream, Live Archives et d'autres fonctionnalités mises à disposition. Vous êtes mesuré et facturé en fonction de votre utilisation des [CCU avancés](/docs/licenses/license-information/product-definitions/new-relic-one-pricing-definitions/#compute-capacity-unit). + + + Votre utilisation de CodeStream sous calculateur avancé (Advanced Compute) entraînera des frais CCU, quel que soit le type d'utilisateur. Cela signifie que l'utilisateur de base gratuit peut accéder à la fonctionnalité de calcul avancée et encourir des frais pour les CCU avancés. + + +* **Centre de données de l'UE pour les données d'origine (Original Data) ou les données Plus (Data Plus)**: ce module complémentaire s'applique à votre option de données (données d'origine ou données Plus) lorsque vous sélectionnez l'Union européenne comme région de données, selon les disponibilités. + +* **Conservation prolongée des données d'origine ou des données plus** : ce module complémentaire s'applique si vous dépassez la durée par défaut pendant laquelle vos données sont conservées. Cela s'applique à toutes vos données, pas seulement aux logs, et constitue une bonne option si vous devez effectuer de nombreuses petites requêtes ou effectuer des requêtes sur de gros volumes de données. + +* **Live Archives** : Prolongez la durée de stockage de vos logs jusqu'à sept ans. Live Archives nécessite également Advanced Compute. + +* **New Relic Synthetics Checks** : Ce module complémentaire s'applique si vos contrôles dépassent le nombre par défaut de contrôles de monitoring synthétiques. + +* **Security RX**: cette fonctionnalité est incluse avec Data Plus, mais le module complémentaire s'applique si vous utilisez la fonctionnalité Security RX sans Data Plus. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx b/src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx new file mode 100644 index 00000000000..d92819d86c2 --- /dev/null +++ b/src/i18n/content/fr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx @@ -0,0 +1,354 @@ +--- +title: 'Données : Facturation et règles' +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: 'For New Relic pricing, an explanation of how data ingest is calculated for billing purposes.' +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +Pour la tarification New Relic, les données ingérées par votre organisation New Relic constituent un facteur de facturation. + +## Informez-vous sur les coûts [#costs] + +Si vous n'êtes pas encore client New Relic et que vous êtes curieux de connaître les coûts, consultez d'abord [notre page de tarification principale](https://newrelic.com/pricing). Si vous êtes déjà client, continuez à lire pour en savoir plus sur la facturation de l'ingestion de données. + +## Afficher l'ingestion de données dans l'UI [#ui] + +Pour savoir comment trouver les informations d'utilisation et de facturation dans l'UI, consultez [UI de facturation](/docs/accounts/accounts-billing/general-account-settings/introduction-account-settings). + +Pour savoir comment afficher et gérer votre ingestion de données, consultez [Gérer l'ingestion](/docs/data-apis/manage-data/manage-data-coming-new-relic). + +## Options de données : Données Plus et originales [#data-prices] + +Le prix de votre organisation par Go de données ingérées varie en fonction de l'option de données dont dispose votre organisation : **Data Plus** ou notre option **Original Data**. L'option Data Plus offre des fonctionnalités de données avancées pour des performances, une évolutivité, une sécurité et une gouvernance optimisées. Une organisation New Relic ne peut avoir qu'une seule option à la fois. + +Voici un tableau comparatif des deux options. Les prix et les limites sont mensuels et les prix sont en USD. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Fonctionnalité/aptitude + + **Original Data** option + + **Data Plus** option + + Plus de détails sur la fonctionnalité +
+ [Éditions](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#editions) + + Toutes les éditions + + Nécessite Standard, Pro ou Enterprise + + (Nous notons ci-dessous si une fonctionnalité est spécifique à une édition) + +
+ Limite de données gratuites + + 100 Go ingérés + + 100 Go ingérés + +
+ Prix des données
(au-delà de la limite gratuite) + 		+ 0,40 USD/Go ingéré + + 0,60 USD/Go ingéré + +
+ Limite gratuite de rétention des données
([varie selon le type de données](/docs/data-apis/manage-data/manage-data-retention)) + 		+ Défaut d'au moins 8 jours + + 90 jours supplémentaires en cas de défaut + +
+ Prix pour chaque tranche de 30 jours de rétention supplémentaire
(au-delà de la limite gratuite) + 		+ +0,05$/Go + + +0,05$/Go + +
+ Prix supplémentaire pour stocker des données dans [data centerde l'UE](/docs/accounts/accounts-billing/account-setup/choose-your-data-center)
+ 		+ +0,05$/Go + + +0,05$/Go + + Les données sont stockées par défaut dans le data center américain. +
+ [Limite de requêtes](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-limits)maximale + + Jusqu'à 20 milliards de points de données par minute + + Jusqu'à 60 B de points de données par minute + +
+ [Durée maximale de la requête](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-duration) + + 1 minute + + Jusqu'à 10 minutes + +
+ Choix du fournisseur de cloud + + Fournisseur de cloud unique + + Azure ou plusieurs fournisseurs de cloud + + Choisissez votre fournisseur cloud préféré pour votre charge de travail d'observabilité afin d'aligner votre stockage de télémétrie avec votre modèle de déploiement d'ingénierie et votre préférence cloud . +
+ [Obfuscation des logs](/docs/logs/ui-data/obfuscation-ui/) + + Masquer [automatiquement](/docs/logs/get-started/new-relics-log-management-security-privacy/#log-obfuscation) les modèles de carte de crédit et de numéro de sécurité sociale connus dans les logs. + + Créez et suivez des règles directement dans l'UI et [masquez ou hachez](/docs/logs/ui-data/obfuscation-ui/) les données log sensibles. + +
+ [New Relic gestion des vulnérabilités](/docs/vulnerability-management/overview)
(plateforme utilisateur complète uniquement) + 		+ +0,10 $/Go
(au-delà de la limite gratuite) + 		+ Standard, Pro et Entreprise + + Identifiez les vulnérabilités et traitez les risques à chaque étape du cycle de vie du logiciel. +
+ Admissibilité [au programme FedRAMP Modéré](/docs/security/security-privacy/compliance/fedramp-compliant-endpoints) et [à la loi HIPAA](/docs/security/security-privacy/compliance/hipaa-readiness-new-relic) + + + + Enterprise + + Atteignez la conformité en matière de sécurité grâce à une configuration qui vous aide à répondre à vos exigences FedRAMP et HIPAA. +
+ [données de streaming export](/docs/apis/nerdgraph/examples/nerdgraph-streaming-export) + + + + Standard, Pro et Entreprise + + Configurez des règles pour exporter simultanément des données télémétriques vers le stockage AWS ou Azure de votre choix. Des frais d’exportation supplémentaires vers le fournisseur de cloud s’appliqueront. +
+ [Exportation de données historiques](/docs/apis/nerdgraph/examples/nerdgraph-historical-data-export) + + + + Standard, Pro et Entreprise + + Exécutez des requêtes plus volumineuses sans délai d'expiration pour l'analyse historique et la modélisation, le stockage à long terme et l'intégration avec d'autres plateformes d'analyse de données. +
+ Service natif New Relic d'Azure + + + + Standard, Pro et Entreprise
([avec quelques limitations](#azure-native-data-plus)) + 		+
+ +Pour voir une comparaison côte à côte de Data Plus et de notre option de données originales, consultez [notre fiche technique Data Plus](https://newrelic.com/resources/datasheets/data-plus). + +Intéressé par Data Plus ? Voir [Mise à niveau vers Data Plus](#upgrade-data-plus). + +### Détails du service Azure Native New Relic [#azure-native-data-plus] + +Avec le [serviceAzure Native New Relic ](/docs/infrastructure/microsoft-azure-integrations/get-started/azure-native), vous pouvez collecter et stocker vos données télémétriques pour les applications et infrastructure directement dans Azure. Cette fonctionnalité est incluse avec Data Plus, mais avec les limitations suivantes : + +* Disponible uniquement dans la région data center des États-Unis +* L'éligibilité FedRAMP Modéré/HIPAA n'est pas disponible +* L'exportation des données historiques n'est pas disponible + +## Mise à niveau vers Data Plus [#upgrade-data-plus] + +Pour passer à Data Plus, accédez à l'[UI**Data retention** ](/docs/data-apis/manage-data/manage-data-retention/#adjust-retention)dans le hub de gestion des données et cliquez sur **Upgrade retention**. + +* Remarque : vous pouvez voir un bouton **Edit data retention** , mais il est différent du bouton **Upgrade retention**. +* Pour voir le bouton **Upgrade retention** , vous devez disposer [des autorisations de facturation](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts/#admin-settings). Si vous remplissez les conditions et que vous ne voyez toujours pas l'option **Upgrade retention** , contactez votre représentant de compte New Relic. + +## Qu'est-ce qui est considéré comme des Go ingérés facturables ? [#usage-calculation] + +Dans le contexte du [plan tarifaire New Relic](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing), les « données ingérées » font référence aux données enregistrées dans New Relic par votre organisation après l'application de diverses règles de découpage et de transformation des données. En d’autres termes, ce n’est pas la quantité de données brutes envoyées à New Relic qui compte, mais la taille des données qui finissent par être stockées. + +En général, les données que nous générons pour fournir notre fonctionnalité ne comptent pas dans vos Go ingérés. Voici quelques exemples de fonctionnalités et de données liées aux fonctionnalités qui ne sont pas comptabilisées dans les Go ingérés : + +* [Fonctionnalité d'alerte de base](/docs/alerts-applied-intelligence/new-relic-alerts/learn-alerts/alerts-concepts-workflow). Par exemple, `NrAiIncident`, un événement utilisé pour générer ces fonctionnalités, ne compte pas dans les Go ingérés. +* Données créées à partir de données brutes agrégées (par exemple, [données infrastructure agrégées](/docs/data-apis/manage-data/manage-data-retention/#infrastructure-data) ou [données métriques dimensionnelles](/data-apis/manage-data/manage-data-retention/#dimensional-metrics)). +* [métriques dorées](/docs/apis/nerdgraph/examples/golden-metrics-entities-nerdgraph-api-tutorial) (pour en savoir plus sur les métriques dorées, voir nos [définitions d'entités](https://github.com/newrelic/entity-definitions)). +* Contrôles de monitoring synthétiques. Pour plus de détails sur la facturation des produits synthétiques, consultez [Limites et tarifsSynthetics ](/docs/synthetics/synthetic-monitoring/using-monitors/monitor-limits). +* Données de suivi d’utilisation et de facturation (par exemple, `NrConsumption`). +* Données relatives à l’administration du compte (par exemple, `NrIntegrationError`, `NrAuditEvent`). + +Pour comprendre votre utilisation, consultez l'[ UI d'utilisation](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing#usage-ui). + +## Autres détails de calcul [#calculation-details] + +* Dans le contexte de notre modèle de tarification, un Go est défini comme 1 milliard d’octets. +* Le nombre mensuel de Go ingérés est arrondi à l'entier inférieur le plus proche. Par exemple, si votre organisation utilise 100,9 Go au cours d'un mois, cela est comptabilisé comme 100 Go. + +## Édition gratuite [#free-tier-limits] + +Pour plus de détails sur GB Ingested pour notre édition gratuite, voir [Édition gratuite](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#free). + +## En savoir plus [#related-docs] + +* Pour en savoir plus sur la gestion des Go ingérés, consultez [Gérer l'ingestion de données](/docs/data-apis/manage-data/manage-data-coming-new-relic). +* Pour savoir comment requêter l'utilisation, voir [requête et alerte sur l'utilisation](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/usage-queries-alerts). \ No newline at end of file diff --git a/src/i18n/content/fr/docs/alerts/get-notified/notification-integrations.mdx b/src/i18n/content/fr/docs/alerts/get-notified/notification-integrations.mdx index b0f07c3d295..9913331143a 100644 --- a/src/i18n/content/fr/docs/alerts/get-notified/notification-integrations.mdx +++ b/src/i18n/content/fr/docs/alerts/get-notified/notification-integrations.mdx @@ -179,13 +179,13 @@ En savoir plus sur chacune de nos intégrations notification spécifiques. * Si une adresse e-mail est déjà associée à une destination existante, vous serez invité à les fusionner. Sélectionnez **Merge** pour combiner les destinations. * Si vous avez ajouté une nouvelle adresse e-mail, le destinataire recevra un e-mail de vérification. Le destinataire doit terminer le processus de vérification pour commencer à recevoir la notification. - - Limites de destination des e-mails : + + Limites de destination des e-mails : - * **Comptes gratuits**: Chaque destination peut avoir un maximum de 5 adresses email. - * **Comptes payants**: Chaque destination peut avoir un maximum de 150 adresses email. - * **Limite d'organisation**: 1 000 adresses e-mail uniques peuvent être ajoutées par organisation de clients par 24 heures (s'applique à tous les utilisateurs). - + * **Comptes gratuits**: Chaque destination peut avoir un maximum de 5 adresses email. + * **Comptes payants**: Chaque destination peut avoir un maximum de 150 adresses email. + * **Limite d'organisation**: 1 000 adresses e-mail uniques peuvent être ajoutées par organisation de clients par 24 heures (s'applique à tous les utilisateurs). + 10. Personnaliser le message électronique. diff --git a/src/i18n/content/fr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx b/src/i18n/content/fr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx index e9f3920f5e5..12a0673c5e3 100644 --- a/src/i18n/content/fr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx +++ b/src/i18n/content/fr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx @@ -268,21 +268,21 @@ Après installation, l' agent s'instrumente automatiquement avec notre | nom du paquet | Version minimale prise en charge | Dernière version publiée | Introduit en\* | | --------------------------------- | -------------------------------- | ------------------------ | -------------------------------------- | | `@apollo/gateway` | 2.3.0 | 2.11.3 | `@newrelic/apollo-server-plugin@1.0.0` | -| `@apollo/server` | 4.0.0 | 5.0.0 | `@newrelic/apollo-server-plugin@2.1.0` | -| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.914.0 | 11.13.0 | -| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/client-sns` | 3.0.0 | 3.915.0 | 8.7.1 | -| `@aws-sdk/client-sqs` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.914.0 | 8.7.1 | +| `@apollo/server` | 4.0.0 | 5.1.0 | `@newrelic/apollo-server-plugin@2.1.0` | +| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.918.0 | 11.13.0 | +| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sns` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sqs` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.918.0 | 8.7.1 | | `@aws-sdk/smithy-client` | 3.47.0 | 3.374.0 | 8.7.1 | | `@azure/functions` | 4.7.0 | 4.8.0 | 12.18.0 | | `@elastic/elasticsearch` | 7.16.0 | 9.2.0 | 11.9.0 | -| `@google/genai` | 1.1.0 | 1.26.0 | 12.21.0 | +| `@google/genai` | 1.1.0 | 1.27.0 | 12.21.0 | | `@grpc/grpc-js` | 1.4.0 | 1.14.0 | 8.17.0 | | `@hapi/hapi` | 20.1.2 | 21.4.3 | 9.0.0 | | `@koa/router` | 12.0.1 | 14.0.0 | 3.2.0 | -| `@langchain/core` | 0.1.17 | 1.0.1 | 11.13.0 | -| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.1 | 13.2.0 | +| `@langchain/core` | 0.1.17 | 1.0.2 | 11.13.0 | +| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.2 | 13.2.0 | | `@nestjs/cli` | 9.0.0 | 11.0.10 | 10.1.0 | | `@opensearch-project/opensearch` | 2.1.0 | 3.5.1 | 12.10.0 | | `@prisma/client` | 5.0.0 | 6.18.0 | 11.0.0 | @@ -298,7 +298,7 @@ Après installation, l' agent s'instrumente automatiquement avec notre | `generic-pool` | 3.0.0 | 3.9.0 | 0.9.0 | | `ioredis` | 4.0.0 | 5.8.2 | 1.26.2 | | `kafkajs` | 2.0.0 | 2.2.4 | 11.19.0 | -| `koa` | 2.0.0 | 3.0.3 | 3.2.0 | +| `koa` | 2.0.0 | 3.1.1 | 3.2.0 | | `koa-route` | 3.0.0 | 4.0.1 | 3.2.0 | | `koa-router` | 12.0.1 | 14.0.0 | 3.2.0 | | `memcached` | 2.2.0 | 2.2.2 | 1.26.2 | @@ -306,7 +306,7 @@ Après installation, l' agent s'instrumente automatiquement avec notre | `mysql` | 2.16.0 | 2.18.1 | 1.32.0 | | `mysql2` | 2.0.0 | 3.15.3 | 1.32.0 | | `next` | 13.4.19 | 16.0.0 | 12.0.0 | -| `openai` | 4.0.0 | 6.6.0 | 11.13.0 | +| `openai` | 4.0.0 | 6.7.0 | 11.13.0 | | `pg` | 8.2.0 | 8.16.3 | 9.0.0 | | `pg-native` | 3.0.0 | 3.5.2 | 9.0.0 | | `pino` | 8.0.0 | 10.1.0 | 8.11.0 | diff --git a/src/i18n/content/fr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx b/src/i18n/content/fr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx index 49f869c6eaf..e3c900e3abe 100644 --- a/src/i18n/content/fr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx +++ b/src/i18n/content/fr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx @@ -998,6 +998,68 @@ New Relic étend son support pour la bibliothèque AI/ML. +## Bibliothèque de logging + +L'agent peut transférer les logs des bibliothèques suivantes pour [les logs APM dans le contexte](/docs/logs/logs-context/get-started-logs-context/). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Bibliothèque** + + **Nom de la gemme** + + **Soutenu** + + **Remarques** +
+ **enregistreur** + + `logger` + + + + Prise en charge du transfert de log d'APM à l'aide de la bibliothèque de Logger de Ruby et de toute bibliothèque de logging qui hérite du Logger de Ruby, telle que ActiveSupport::BroadcastLogger. +
+ **Logstasher** + + `logstasher` + + 1.xx et supérieur + + Prise en charge du transfert de log APM. +
+ ## Autres bibliothèques et technologies [#other\_libraries][#other_libraries] @@ -1134,40 +1196,6 @@ New Relic étend son support pour la bibliothèque AI/ML. - - - - - - - - - - - - - - - - - - diff --git a/src/i18n/content/fr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx b/src/i18n/content/fr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx index 6046e719931..001912324f4 100644 --- a/src/i18n/content/fr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx +++ b/src/i18n/content/fr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx @@ -63,11 +63,11 @@ Si vous voyez **Patterns are turned off** dans votre interface utilis diff --git a/src/i18n/content/fr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx b/src/i18n/content/fr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx index ff1475b50a8..2b3a33fc4c8 100644 --- a/src/i18n/content/fr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx +++ b/src/i18n/content/fr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx @@ -204,7 +204,13 @@ La page d'exécution Go fournit des outils permettant d'identifier les La page d'exécution Go affiche les signaux dorés ainsi que les métriques d'exécution Go pour corréler les problèmes d'exécution avec l'utilisation du service. -La requête suppose que les données sont produites par la [bibliothèque d'instrumentation d'exécutionOpenTelemetry Go](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/). Notez qu’il n’existe actuellement aucune convention sémantique pour les métriques d’exécution Go. +La requête suppose que les données sont produites par la [bibliothèque d'instrumentation d'exécutionOpenTelemetry Go](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/). + + + Les [conventions sémantiques](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/runtime/go-metrics.md) pour les métriques d'exécution Go sont encore en cours d'élaboration. La page relative à l'environnement d'exécution Go cible une version plus ancienne des conventions. Vous devez activer les anciennes conventions en activant la variable d'environnement `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS`. Pour plus d'informations, veuillez consulter la [documentation](https://github.com/open-telemetry/opentelemetry-go-contrib/blob/9a6e0bf68e1da495be52faf152b5b4e6fb09d475/instrumentation/runtime/internal/x/README.md) relative à l'instrumentation. + + New Relic prendra en charge les nouvelles conventions une fois qu'elles seront stables. + ### Logs [#logs-page] diff --git a/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx new file mode 100644 index 00000000000..774c57021d0 --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx @@ -0,0 +1,71 @@ +--- +subject: Docs +releaseDate: '2025-10-25' +version: 'October 19 - October 24, 2025' +translationType: machine +--- + +### Nouveaux documents + +* Ajout d'Intelligence Coûts du cloud [Azure](/docs/cci/azure-cci) et [Google Cloud Platform (GCP)](/docs/cci/gcp-cci) pour fournir des conseils complets pour connecter l'intégration de la facturation Azure et GCP avec New Relic pour monitoring et l'optimisation des coûts. + +### Changements majeurs + +* Mise à jour [du rapport de compatibilité d'agentNode.js](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent) +* [Introduction mise à jour à NRQL](/docs/nrql/get-started/introduction-nrql-new-relics-query-language) avec un contenu simplifié pour une meilleure expérience utilisateur. +* Ajout de la prise en charge de ConfigMap pour l'agent Java à [l'opérateur d'agent Kubernetes](/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator). + +### Modifications mineures + +* Correction des liens brisés pour [Set seuil condition d'alerte](/docs/alerts/create-alert/set-thresholds/set-thresholds-alert-condition). +* Documentation [d'introduction au générateur de requêtes](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) améliorée avec des visuels améliorés. +* Ajout de la prise en charge du rendu des équations mathématiques dans la documentation. +* [Fonctionnalité de pause](/docs/browser/new-relic-browser/browser-apis/pauseReplay) Session Replay améliorée et documentation [des fonctionnalités d'enregistrement](/docs/browser/new-relic-browser/browser-apis/recordReplay) avec des instructions améliorées. +* Agent de navigateur mis à jour traçant les exigences distribuées sur plusieurs pages de documentation pour plus de clarté. +* [Configuration du gestionnaire de tâches Synthetics](/docs/synthetics/synthetic-monitoring/private-locations/job-manager-configuration/#kubernetes-sizing) mise à jour avec une équation mathématique améliorée pour les considérations de dimensionnement pour Docker, Podman, Kubernetes et OpenShift. +* Correction des problèmes MDX affectant le rendu des documents. + +### Notes de version + +* Restez au courant de nos dernières sorties : + + * [Agent Browser v1.300.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.300.0): + + * Suppression de l'utilisation de l'indicateur de fonctionnalité des marques et des mesures pour tous les utilisateurs. + * Taux de faux positifs de l'attribut hasReplay réduit. + * Typages d'API d'interaction mis à jour pour refléter le paramètre waitForEnd. + * Correction des problèmes de dynamique requis avec rollup.js. + + * [Agent Browser v1.301.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.301.0): + + * Je suis passé à l'utilisation de la version forkée de rrweb de New Relic pour Session Replay. + * Attribut d'agent préservé pour la charge log avec une gestion de priorité appropriée. + + * [Intégration Kubernetes v3.47.0](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-47-0): + + * Capacités monitoring améliorées pour les environnements Kubernetes. + * Collecte de ressources améliorée et optimisations des performances. + + * [Agent Node.js v13.5.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-5-0): + + * Instrumentation Fastify mise à jour pour vous abonner à l'événement généré. + * Instrumentation pg et pg-native mise à jour pour une meilleure monitoring de la base de données. + * Les timers.setTimeout et timers.setInterval sont désactivés par défaut pour de meilleures performances. + * Ajout d'une nouvelle classe de base de diagnostic pour un dépannage amélioré. + + * [Agent iOS v7.5.11](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-7511) : + + * Problèmes de performances résolus avec le traçage des interactions. + * Correction des messages de log de tracing distribué incorrects. + + * [Agent Android v7.6.10](/docs/release-notes/mobile-release-notes/android-release-notes/android-7610): + + * Prise en charge de Gradle 9 ajoutée pour une meilleure compatibilité de build. + + * [Agent d'infrastructure v1.69.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1690): + + * Capacités améliorées monitoring du système et de débogage. + + * [Agent d'infrastructure v1.70.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1700): + + * Améliorations supplémentaires des performances et améliorations monitoring. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx new file mode 100644 index 00000000000..d1b3ded6ad8 --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx @@ -0,0 +1,60 @@ +--- +subject: Docs +releaseDate: '2025-08-08' +version: 'August 01 - August 07, 2025' +translationType: machine +--- + +### Nouveaux documents + +* [Tutoriel NerdGraph ajouté : Créer un rôle personnalisé pour les équipes](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) pour vous guider dans l’utilisation de l’API New Relic NerdGraph pour créer et gérer des rôles personnalisés pour les équipes. + +### Modifications mineures + +* Modification du [seuil d'alerte événement par condition](/docs/alerts/admin/rules-limits-alerts) à 1k par minutes. +* Mise à jour des dernières [versions et exigences compatibles avec l'agent .Net](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements) vérifiées. +* Mise à jour des informations de version et de prise en charge des versions concernant le courtier de services pour [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-service-broker-integration). +* Mise à jour des informations de prise en charge de la version concernant le buildpack d'intégration New Relic NGINX pour [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-nginx-buildpack-integration). +* Mise à jour des informations de version et de support de version concernant New Relic Nozzle pour [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-firehose-nozzle-integration/#product-snapshot). + +### Notes de version + +* Consultez nos articles Quoi de neuf : + + * [Errors Inbox est désormais intégrée à la charge de travail](/whats-new/2025/08/whats-new-08-06-workloads-errors-inbox). + +* Restez au courant de nos dernières sorties : + + * [Gestionnaire de tâches v452](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-452): + * Améliorations internes ajoutées pour la gestion des exceptions dans le traitement des messages de file d'attente. + + * [IntégrationKubernetes v3.43.3](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-43-3): + * Ajout d'un graphique Helm pour déployer la solution monitoring New Relic Kubernetes. + + * [Contrôle de pipeline Gateway v1.1.0](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-08-05): + + * Implémentation d'une nouvelle fonctionnalité permettant de supprimer de manière sélective les données et les attributs des événements `SqlTrace` et `TransactionTrace` à l'aide de règles de suppression. + + * Des vulnérabilités ont été corrigées dans le package `golang.org/x/net`, notamment un problème de script intersite et un contournement du proxy HTTP lié aux ID de zone IPv6. + + * Mise à niveau vers Go `1.24` et les dépendances suivantes sont mises à jour pour améliorer la sécurité et intégrer les correctifs récents : + + * `golang.org/x/net to v0.38.0` + * `golang.org/x/sys to v0.31.0` + * `golang.org/x/text to v0.23.0` + + * [Application mobile pour iOS v6.9.11](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6101): + * Le flux de connexion a été réduit de deux étapes en stockant le domaine d'authentification d'un utilisateur et en le redirigeant directement vers sa page de connexion. + + * [Agent Flutter v1.1.13](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1113): + + * Agent Android natif amélioré mis à jour vers la version 7.6.8 + * Agent iOS natif amélioré mis à jour vers la version 7.5.8 + + * [Agent .NET MAUI v1.1.11](/docs/release-notes/mobile-release-notes/net-maui-release-notes/net-maui-agent-1111) + + * Agent Android natif amélioré mis à jour vers la version 7.6.8 + * Agent iOS natif amélioré mis à jour vers la version 7.5.8 + + * [Agent d'infrastructure v1.65.5](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1655): + * Modification de la prise en charge des montages AWS EFS dans les exemples de stockage \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx new file mode 100644 index 00000000000..e751e90fd9c --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx @@ -0,0 +1,112 @@ +--- +subject: Docs +releaseDate: '2025-08-15' +version: 'August 08 - August 14, 2025' +translationType: machine +--- + +### Nouveaux documents + +* Ajout [de la prise en charge des fonctions NRQL dans les règles de gateway](/docs/new-relic-control/pipeline-control/nrql-functions) pour décrire les fonctions NRQL prises en charge dans les règles de gateway de Contrôle de pipeline. +* Étapes de dépannage ajoutées pour résoudre [l'événement de redémarrage fréquent Fluent Bit ](/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/frequent-fluent-bit-restart-events)en ajustant les paramètres de résolution du nom d'hôte dans la configuration de l'agent New Relic Infrastructure. + +### Changements majeurs + +* [Plan d'utilisation](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/#list-price) mis à jour avec les dernières informations tarifaires. +* Ajout de **Error inbox** à [l'interface utilisateur de la charge de travail (workloads)](/docs/new-relic-solutions/new-relic-one/workloads/use-workloads/#errors). +* Ajout de la désactivation sélective de l'agent en fonction de la classe principale de démarrage ou du fichier jar exécutable via des variables d'environnement, ainsi que des paramètres de sécurité améliorés pour [la configuration de l'agent Java](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file/#skip-applications). +* Ajout de la prise en charge de [la configuration du référentiel privé](/docs/new-relic-control/agent-control/configuration/#private-repository-configuration) dans Agent Control, permettant le déploiement d'agents gérés avec authentification via des méthodes de certificat de base ou TLS. +* Ajout de la prise en charge de [la gestion des secrets](/docs/new-relic-control/agent-control/configuration/#secrets-management) dans Agent Control, pour la gestion des données sensibles, telles que les mots de passe et l'API de clé, en les récupérant auprès d'un fournisseur de secrets dédié. + +### Modifications mineures + +* Ajout de restrictions de balise d'entité pour la clause `WHERE` dans [Drop data using Contrôle de pipeline cloud rules](/docs/new-relic-control/pipeline-control/cloud-rules-api/#restrictions). +* Ajout [de bonnes pratiques pour optimiser le contenu de votre source de connaissances](/docs/agentic-ai/knowledge-integration/overview/#configure) pour le connecteur New Relic AI Knowledge. + +### Notes de version + +* Consultez nos articles Quoi de neuf : + + * [Le mode haute précision UniqueCount et la prise en charge accrue des arguments sont désormais généralement disponibles](/whats-new/2025/08/whats-new-8-13-high-precision-uniquecount). + +* Restez au courant de nos dernières sorties : + + * [Agent Cordova v7.0.8](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-708/): + + * Mettre à jour l'agent Android natif vers la version 7.6.8 + * Mettre à jour l'agent iOS natif vers la version 7.5.8 + + * [Agent Cordova v7.0.9](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-709/): + + * Mettre à jour l'agent Android natif vers la version 7.6.6 + * Mettre à jour l'agent iOS natif vers la version 7.5.5 + + * [Agent Capacitor v1.5.8](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-158/): + + * Mettre à jour l'agent Android natif vers la version 7.6.6 + * Mettre à jour l'agent iOS natif vers la version 7.5.5 + + * [Agent Capacitor v1.5.9](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-159/): + * Correction du crash du signal d'abandon + + * [Agent Capacitor v1.5.10](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-1510/): + + * Mettre à jour l'agent Android natif vers la version 7.6.8 + * Mettre à jour l'agent iOS natif vers la version 7.5.8 + + * [CLI de diagnostic (nrdiag) v3.5.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-350/): + * mise à jour de la vérification de compatibilité de la version `Java/Appserver/JbossEapCheck` + + * [Agent .NET v10.44.0](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-0/): + + * Activation des échantillonneurs de performances métriques en mode Serverless + * Processus d'hôte Web Azure Function (Linux) exclu de l'instrumentation. + + * [NRDOT v1.3.0](/docs/release-notes/nrdot-release-notes/nrdot-2025-08-13/): + + * Mise à jour des versions des composants de l'hôtel de la v0.128.0 à la v0.131.0 + * Introduction de la distribution principale nrdot + + * [Agent Node.js v13.1.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-1-0/): + + * Ajout de la prise en charge de l'API de logs OTEL + * Ajout de mesures de prise en charge lorsque l'instrumentation a été désactivée pour un package + * Instrumentation des minuteries désactivée par défaut dans la configuration de l'échantillon + * Correction de l'obfuscation `transaction.url` + + * [Gestionnaire de tâches v454](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-454/): + * Correction des vulnérabilités sous-jacentes d'Ubuntu pour résoudre les vulnérabilités de sécurité dans SJM. + + * [Exécution de l'API Node v1.2.124](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.124/): + * Correction des vulnérabilités sous-jacentes d'Ubuntu pour résoudre les vulnérabilités de sécurité dans les environnements d'exécution de l'API Node. + + * [Exécution du navigateur de nœuds v3.0.41](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.41/): + * Correction des vulnérabilités tmp `CVE-2025-54798` et des vulnérabilités Ubuntu sous-jacentes pour résoudre les vulnérabilités de sécurité dans les environnements d'exécution Browser Node. + + * [Ping Runtime v1.54.0](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.0/): + * Correction de vulnérabilités liées à Ubuntu pour résoudre les problèmes de sécurité dans l'environnement d'exécution Ping. + + * [Agent Java v8.23.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8230/): + + * Mis à jour pour prendre en charge la version 24 de graphql. + * Ajout de l'instrumentation de la laitue 6.5. + * Version commons-lang mise à jour vers 3.18.0 + + * [AWS Lambda redirecteur de logs v1.1.1](/docs/release-notes/aws-lambda-log-forwarder-release-notes/lambda-25-07-25/): + * Posture de sécurité améliorée en mettant à niveau la version Go vers 1.24.4 dans système. + + * [Agent PHP v12.0.0.25](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-0-0-25/): + + * Logging des erreurs de la carte des hooks Drupal améliorée. + * Problèmes de détection package legacy corrigés pour Security RX. + + * [Agent d'infrastructure v1.66.1](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1661/): + * Prise en charge rétablie des montages AWS EFS dans les exemples de stockage. + + * [Application mobile pour Android v5.30.6](docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5306/): + * Prise en charge améliorée des clés de passe pour les connexions SAML et sociales. + + * [Agent Browser v1.295.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.0/): + + * Ajout de la détection des causes d'erreur. + * Ajout d'avertissements concernant les correctifs de singe. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx new file mode 100644 index 00000000000..bb5a9bec1bb --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx @@ -0,0 +1,94 @@ +--- +subject: Docs +releaseDate: '2025-09-14' +version: 'September 08 - September 12, 2025' +translationType: machine +--- + +### Nouveaux documents + +* Ajout d'une documentation complète [sur le modèle de maturité d'observabilité](/docs/new-relic-solutions/observability-maturity/) pour fournir des conseils pour mesurer et améliorer les pratiques d'observabilité dans quatre domaines clés : temps de disponibilité des entreprises, expérience numérique, excellence en ingénierie et observabilité intelligente. + +### Changements majeurs + +* [Configuration de l'agent PHP](/docs/apm/agents/php-agent/configuration/php-agent-configuration/) mise à jour avec de nouvelles options de configuration étendues pour les contrôles d'échantillonnage et l'instrumentation du gestionnaire d'exceptions du framework. + +### Modifications mineures + +* [Introduction aux dashboards](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) mise à jour avec des conseils améliorés pour l'utilisation dashboard. +* Documentation [de gestion de dashboard](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/) améliorée avec un contenu simplifié pour la gestion JSON. +* Liens brisés corrigés dans la documentation [du plan d'utilisation de New Relic](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/). +* Configuration de débogage fixe dans la documentation [de dépannage de l'agent .NET](/docs/apm/agents/net-agent/troubleshooting/debugging-net-windows/). + +### Notes de version + +* Restez au courant de nos dernières sorties : + + * [Agent Browser v1.297.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.0/): + + * Prévention des récoltes précoces lors de la période de réessai pour une meilleure gestion limitant le taux. + * L'attribut méta newrelic a été supprimé des frais de relecture sortants pour réduire les octets facturables. + * Exceptions corrigées pour les corps nuls résultant de récoltes vides. + + * [Agent PHP v12.1.0.26](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-1-0-26/): + + * Ajout de contrôles d'échantillonnage basés sur la décision d'échantillonnage de tracew3c en amont. + * Option de configuration ajoutée pour ignorer l'instrumentation des gestionnaires d'exceptions du framework. + * Fuite de mémoire potentielle corrigée lors de l'appel de `newrelic_end_transaction(true)`. + * La version de Golang a été mise à jour vers la version 1.25.1 pour des améliorations de sécurité. + + * [Agent Python v10.17.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101700/): + + * Ajout de la prise en charge des tâches personnalisées dans Celery. + * Ajout de la prise en charge de monitoring Graphene-Django. + * Ajout de la prise en charge du filtrage middleware dans Django. + * Prise en charge ajoutée pour l'API AWS Bedrock Converse. + * Prise en charge ajoutée pour l'indicateur d'échantillonnage de l'en-tête W3CTraceParent. + + * [Agent Java v8.24.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8240/): + + * Prise en charge ajoutée pour MongoDB Reactive Streams 5.2.0 et versions ultérieures. + * Ajout du support Jedis 6. + * Correction du problème de double instrumentation de CouchBase. + * Correction du problème d'encapsulation de l'en-tête Spring WebClient 5.x. + + * [Agent Node.js v13.3.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-0/): + + * Prise en charge MCP `StreamableHTTPClientTransport` ajoutée. + + * [Agent Node.js v13.3.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-1/): + + * Correction du crash en définissant par défaut `requestParameters` sur un objet dans `transaction.addRequestParameters`. + + * [Agent Node.js v13.3.2](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-2/): + + * Code défensif ajouté pour obtenir `protocol` dans les appels http sortants. + + * [Intégration Kubernetes v3.45.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-45-1/): + + * Mis à jour avec les dernières améliorations et débogage. + + * [Gestionnaire de tâches v464](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-464/): + + * Problème résolu où les clients ne pouvaient pas extraire des images d'un registre personnalisé à l'aide de podman. + + * [Exécution du navigateur de nœuds v3.0.43](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.43/): + + * Correction des vulnérabilités sous-jacentes d'Ubuntu pour résoudre les vulnérabilités de sécurité. + + * [Application mobile pour iOS v6.9.12](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6102/): + + * Problèmes de liens profonds corrigés pour le tableau de bord et les alertes. + * Problème d'ID du tableau de bord CCU corrigé. + + * [Application mobile pour Android v5.30.7](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5307/): + + * Ajout du débogage et des améliorations. + + * [Agent Flutter v1.1.14](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1114/): + + * Ajout d'améliorations de stabilité supplémentaires et de débogage. + + * [Contrôle de pipeline Gateway v25.09.01](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-09-01/): + + * Ajout d'une nouvelle sortie avec des capacités de contrôle pipeline améliorées. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx b/src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx new file mode 100644 index 00000000000..22497694a2b --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx @@ -0,0 +1,15 @@ +--- +subject: Infrastructure agent +releaseDate: '2025-10-27' +version: 1.71.0 +translationType: machine +--- + +Une nouvelle version de l'agent a été sortie. Suivez les procédures standard pour [mettre à jour l'agent d'infrastructure](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent). New Relic vous recommande de mettre à niveau l'agent régulièrement et au moins tous les 3 mois. Au moment de cette sortie, la version la plus ancienne prise en charge est [l'agent d'infrastructure 1.55.2](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1552/). + +## Modifié + +* Ajout de la prise en charge de Suse 15.7 [#2139](https://github.com/newrelic/infrastructure-agent/pull/2139) +* Ajout de la prise en charge de Debian 13 (Trixie) [#2140](https://github.com/newrelic/infrastructure-agent/pull/2140) +* Dépendance newrelic/nri-winservices mise à jour vers la version 1.4.0 [#2143](https://github.com/newrelic/infrastructure-agent/pull/2143) +* Mise à jour de la dépendance newrelic/nri-Prometheus vers la version 2.27.2 [#2130](https://github.com/newrelic/infrastructure-agent/pull/2130) \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx b/src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx new file mode 100644 index 00000000000..f03405b7cb8 --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx @@ -0,0 +1,13 @@ +--- +subject: Kubernetes integration +releaseDate: '2025-10-28' +version: 3.48.0 +translationType: machine +--- + +Pour une description détaillée des changements, voir les [notes de sortie](https://github.com/newrelic/nri-kubernetes/releases/tag/v3.48.0). + +Cette intégration est incluse dans les versions de graphiques suivantes : + +* [infrastructure New Relic 3.53.0](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.53.0) +* [nri-bundle-6.0.19](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.19) \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx b/src/i18n/content/fr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx new file mode 100644 index 00000000000..6cdcf153a93 --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx @@ -0,0 +1,18 @@ +--- +subject: Flutter agent +releaseDate: '2025-10-24' +version: 1.1.16 +downloadLink: 'https://pub.dev/packages/newrelic_mobile/versions/1.1.16' +translationType: machine +--- + +## Débogage + +* Correction d'un problème où le `NewRelicNavigationObserver` plantait lors de la gestion d'itinéraires sans paramètre clé, tels que les feuilles inférieures et les boîtes de dialogue modales. +* Échecs de suivi de navigation résolus pour les itinéraires qui ne s'étendent pas sur `PageRoute`. + +## Améliorations + +* Sécurité de type améliorée dans `NewRelicNavigationObserver` en supprimant tous les types dynamiques. +* Prise en charge ajoutée pour des types d'itinéraires supplémentaires, notamment `CupertinoPage` et `NoTransitionPage` à partir de `go_router`. +* refactorisation du code de l'observateur de navigation pour une meilleure maintenabilité et lisibilité. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx b/src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx new file mode 100644 index 00000000000..e635be395dd --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx @@ -0,0 +1,39 @@ +--- +subject: Browser agent +releaseDate: '2025-08-04' +version: 1.295.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Add error cause detection +bugs: + - Add monkey-patching warnings + - Calculate first and last timestamps from raw data +security: [] +translationType: machine +--- + +## v1.295.0 + +### Caractéristiques + +#### Ajouter une détection de cause d'erreur + +Détecter et signaler l'attribut de cause sur l'événement JavaScriptError capturé. Si la cause est une instance d'une erreur, la trace des appels sera capturée, sinon le contenu stringifié de la cause sera signalé. Cela sera interrogeable dans l'événement JavaScriptError sous l'attribut `cause`. + +### Débogage + +#### Ajouter des avertissements de mise à jour de singe + +Ajout d'une détection et d'avertissements lorsque les variables globales attendues ont été corrigées avant que l'agent ne soit exécuté sur la page. Cela peut entraîner des comportements inattendus et l’objectif est d’informer les clients de ce comportement. + +#### Calculer le premier et le dernier horodatage à partir des données brutes + +Assurez-vous que l'agent calcule manuellement le premier et le dernier horodatage d'une charge SessionReplay avant la récolte pour aider à améliorer la cohérence sur le lecteur d'interface utilisateur. + +## Déclaration de soutien + +New Relic vous recommande de mettre à niveau l'agent régulièrement pour vous assurer de bénéficier des dernières fonctionnalités et avantages en termes de performances. Les sorties plus anciennes ne seront plus prises en charge lorsqu'elles atteindront [la fin de leur vie](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/). Les dates de sortie reflètent la date de publication originale de la version de l'agent. + +Les nouveaux agents de navigation sont déployés auprès des clients par petites étapes sur une période donnée. De ce fait, la date à laquelle la sortie devient accessible sur votre compte peut ne pas correspondre à la date de publication d'origine. Veuillez consulter ce [dashboard d'état](https://newrelic.github.io/newrelic-browser-agent-release/) pour plus d'informations. + +Conformément à notre [politique de prise en charge des navigateurs](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), la version 1.295.0 de l'agent de Browser a été conçue et testée sur ces navigateurs et plages de versions : Chrome 128-138, Edge 128-138, Safari 17-19 et Firefox 130-140. Pour les appareils mobiles, la version 1.295.0 a été créée et testée pour Android OS 16 et iOS Safari 17-26. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx b/src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx new file mode 100644 index 00000000000..1c13b3f0f23 --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx @@ -0,0 +1,34 @@ +--- +subject: Browser agent +releaseDate: '2025-08-19' +version: 1.296.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Harvest traces early +bugs: + - Remove event buffer inspection event +security: [] +translationType: machine +--- + +## v1.296.0 + +### Caractéristiques + +#### Traces de récolte précoces + +Mettre à jour l'agent pour gérer la trace de session de la même manière que les autres fonctionnalités gèrent les données à partir de [la version 1.294.0](https://docs.newrelic.com/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.294.0/), en permettant des récoltes à une taille de 16 ko. + +### Débogage + +#### Supprimer le tampon d'événement inspection événement + +Supprime l'événement d'inspection du tampon d'événements pour éviter une fuite de mémoire lors de l'utilisation de la console.log avec l'écouteur d'événements de fenêtre `newrelic`. + +## Déclaration de soutien + +New Relic vous recommande de mettre à niveau l'agent régulièrement pour vous assurer de bénéficier des dernières fonctionnalités et avantages en termes de performances. Les sorties plus anciennes ne seront plus prises en charge lorsqu'elles atteindront [la fin de leur vie](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/). Les dates de sortie reflètent la date de publication originale de la version de l'agent. + +Les nouveaux agents de navigation sont déployés auprès des clients par petites étapes sur une période donnée. De ce fait, la date à laquelle la sortie devient accessible sur votre compte peut ne pas correspondre à la date de publication d'origine. Veuillez consulter ce [dashboard d'état](https://newrelic.github.io/newrelic-browser-agent-release/) pour plus d'informations. + +Conformément à notre [politique de prise en charge des navigateurs](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), la version 1.296.0 de l'agent Browser a été conçue et testée sur ces navigateurs et plages de versions : Chrome 129-139, Edge 129-139, Safari 17-19 et Firefox 131-141. Pour les appareils mobiles, la version 1.296.0 a été créée et testée pour Android OS 16 et iOS Safari 17-18.1. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx index acae61448df..2170b7cf12c 100644 --- a/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx +++ b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx @@ -1,10 +1,10 @@ --- subject: Node API runtime -releaseDate: '2025-08-13' -version: 1.2.124 +releaseDate: '2025-07-29' +version: 1.2.122 translationType: machine --- ### Corrections -* Correction des vulnérabilités sous-jacentes d'Ubuntu pour résoudre les vulnérabilités de sécurité dans les environnements d'exécution de l'API Node. +* Correction des vulnérabilités des données de formulaire et des vulnérabilités Ubuntu sous-jacentes pour résoudre les vulnérabilités de sécurité dans les environnements d'exécution de l'API Node. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx index 32a95692b08..5c9271f27d8 100644 --- a/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx +++ b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx @@ -1,10 +1,10 @@ --- subject: Node browser runtime -releaseDate: '2025-08-13' -version: 3.0.41 +releaseDate: '2025-07-29' +version: 3.0.39 translationType: machine --- ### Améliorations -* Correction des vulnérabilités tmp CVE-2025-54798 et des vulnérabilités Ubuntu sous-jacentes pour résoudre les vulnérabilités de sécurité dans les environnements d'exécution Node Browser. +* Correction des vulnérabilités des données de formulaire et des vulnérabilités Ubuntu sous-jacentes pour résoudre les vulnérabilités de sécurité dans les environnements d'exécution Browser Node. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx new file mode 100644 index 00000000000..40b68beae40 --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-07-29' +version: 1.53.0 +translationType: machine +--- + +### Améliorations + +* Vulnérabilités corrigées liées à `common-lang3` Java et Ubuntu pour résoudre les problèmes de sécurité dans l'environnement d'exécution Ping. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx new file mode 100644 index 00000000000..9cf6842663a --- /dev/null +++ b/src/i18n/content/fr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-08-13' +version: 1.54.0 +translationType: machine +--- + +### Améliorations + +* Correction de vulnérabilités liées à Ubuntu pour résoudre les problèmes de sécurité dans l'environnement d'exécution Ping. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/vulnerability-management/overview.mdx b/src/i18n/content/fr/docs/vulnerability-management/overview.mdx index fb05bb10db3..7f75cf5f033 100644 --- a/src/i18n/content/fr/docs/vulnerability-management/overview.mdx +++ b/src/i18n/content/fr/docs/vulnerability-management/overview.mdx @@ -17,7 +17,7 @@ Les logiciels modernes sont composés de milliers de composants et les offres de Avec Security RX, vous obtenez : -* Une vue d'ensemble de toutes les vulnérabilités, y compris celles détectées par la plateforme New Relic et nos partenaires d'intégration tels que [FOSSA](docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](docs/vulnerability-management/integrations/snyk/), [Dependabot](install/vm/), etc. +* Une vue d'ensemble de toutes les vulnérabilités, y compris celles détectées par la plateforme New Relic et nos partenaires d'intégration tels que [FOSSA](/docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](/docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](/docs/vulnerability-management/integrations/snyk/), [Dependabot](/install/vm/), et bien d'autres. * Visibilité continue en temps d'exécution des vulnérabilités de vos applications et infrastructure diff --git a/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx new file mode 100644 index 00000000000..eaa33dc3499 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx @@ -0,0 +1,707 @@ +--- +title: Créez votre propre workflow +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic +metaDescription: Build custom workflows from scratch using drag-and-drop actions. Learn by example with a real-world EC2 automation scenario. +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Lorsque les modèles ne correspondent pas à vos besoins, l'option [Create Your Own](https://onenr.io/0OQM47KgxjG) vous permet de concevoir un workflow personnalisé. Utilisez l'interface glisser-déposer pour enchaîner les actions du [catalogue d'actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) et créer une automatisation correspondant à votre processus. + +## Comment utiliser ce guide + +Ce guide vous montre comment construire un workflow à l'aide de concepts et d'un exemple complet. Choisissez votre parcours d'apprentissage : + +* **Apprenez d'abord les concepts fondamentaux** → Lisez [les concepts fondamentaux](#core-concepts) et [les modèles de workflow](#workflow-patterns) pour comprendre les bases, puis appliquez-les. + +* **Suivez l'exemple** → Accédez à [la procédure pas à pas](#example-walkthrough) pour créer un workflow de redimensionnement automatique EC2. + +* **Modèles de référence** → Utilisez la section [relative aux modèles de workflow](#workflow-patterns) comme référence rapide lors de la création de votre propre workflow. + + + **Vous débutez dans le monde du workflow ?** Commencez par les concepts de base, puis suivez l'exemple. Le workflow EC2 illustre tous les modèles clés dans un scénario réel. + + +## Pourquoi créer un workflow personnalisé ? + +Créez votre propre workflow pour : + +* **Implémenter une logique métier unique** que les modèles ne prennent pas en charge +* **Intégrez plusieurs systèmes** au-delà des modèles standards +* **Gérer les décisions complexes** grâce à la branchement conditionnel +* **Alignez vos processus d'approbation et de notification avec ceux de votre équipe**. + +## Concepts de base [#core-concepts] + +Comprenez ces principes fondamentaux avant de construire : + +
- **enregistreur** - - `logger` - - - - Prise en charge du transfert de logAPM à l'aide de la bibliothèque Logger de Ruby. -
- **Logstasher** - - `logstasher` - - 1.xx et supérieur - - Prise en charge du transfert de log APM. -
**Stripe** diff --git a/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx b/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx index 1b6ebb0274e..1cd62eacf8f 100644 --- a/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx +++ b/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx @@ -20,6 +20,8 @@ Les fonctionnalités clés de Transaction 360 incluent : * **Découverte automatique**: modélisation dynamique des relations de service et visualisation des flux de transactions en temps réel. * **Visibilité complète**: monitoring stack complète, suivi des transactions interservices et visibilité infrastructure jusqu'au navigateur. +* **Monitoring de bases de données**: informations approfondies détaillées sur les performances de la base de données, l'analyse des requêtes et l'état de la connexion sur l'ensemble de votre workload transaction. +* **Suivi des fonctions sans serveur**: visibilité complète sur les performances, les démarrages à froid et l’utilisation des ressources des fonctions sans serveur. * **Analyse historique**: Accès à des semaines de données historiques, permettant l'analyse des tendances et la reconnaissance de modèles. @@ -33,5 +35,7 @@ Pour démarrer avec Transaction 360, vous devez activer le tracing distribué da ## Et ensuite ? - Découvrez comment utiliser Transaction 360 pour résoudre les problèmes de performances des applications + + Découvrez comment utiliser Transaction 360 pour optimiser les performances de vos applications, notamment en matière de base de données et monitoring sans serveur. + \ No newline at end of file diff --git a/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx b/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx index 7da907edea8..cc09b68d9d9 100644 --- a/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx +++ b/src/i18n/content/fr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx @@ -3,88 +3,173 @@ title: Dépannage accéléré avec Transaction 360 tags: - transaction workloads - dynamic workload monitoring -metaDescription: Learn about the detailed page breakdown in New Relic's Transaction 360 feature. +metaDescription: Learn how Transaction 360 provides comprehensive workload visibility for faster troubleshooting and performance optimization. freshnessValidatedDate: never translationType: machine --- -Lorsque des problèmes de performances des applications surviennent, il est essentiel d'adopter une approche systématique pour identifier et résoudre la cause première. Ce guide vous aide à visualiser les problèmes de performances des applications à l'aide de Transaction 360. +Transaction 360 capture et met en corrélation automatiquement toutes les entités et données liées à une transaction spécifique, offrant une vue complète de votre workload distribuée. Cette approche holistique inclut les flux transaction, les relations de service et les indicateurs de performance de l'ensemble de votre stack, vous permettant d'identifier et de résoudre rapidement les problèmes. -Étant donné que Transaction 360 capture et met en corrélation automatiquement toutes les entités et données liées à un problème ou à une question spécifique, il fournit une vue complète de la workload. Cette vue inclut le flux de transaction, les relations de service et les mesures de performance, vous permettant d'identifier et de résoudre rapidement les problèmes. +## Ce que Transaction 360 vous montre -## Accéder à la vue Transaction 360 +Transaction 360 propose trois vues principales pour vous aider à comprendre votre workload: -Pour accéder à la vue Charge de travail des transactions, procédez comme suit : +* **Dashboard de présentation **: résumé de haut niveau avec le nombre d'entités, les problèmes et le suivi des changements +* **Cartographie dynamique des flux**: Représentation visuelle des chemins transaction et de la dépendance des services +* **Répartition des entités**: mesures de performance détaillées pour toutes les composantes participantes -1. Accédez à **[one.newrelic.com](https://one.newrelic.com)> APM and Services**. -2. Depuis la page de résumé APM, cliquez sur **Transactions > Transaction Details > View transaction 360 workload**. +## Accès à Transaction 360 -La vue Transaction 360 fournit une répartition détaillée de la workload des transactions, y compris les composants suivants : +1. Rendez-vous sur **[one.newrelic.com](https://one.newrelic.com) > APM and Services** +2. Sélectionnez votre service sur la page récapitulative APM +3. Accédez à **Transactions > Transaction Details > View transaction 360 workload** -* **PrésentationTransaction 360 **: affiche le résumé workload de la transaction, y compris le nombre d'entités impliquées, les alertes et le suivi des changements. + + Les sections de base de données et monitoring sans serveur sont actuellement disponibles dans les environnements de simulation. Assurez-vous de disposer des autorisations de compte appropriées et des outils adéquats pour accéder à ces fonctionnalités. + -* **Carte de flux dynamique**: visualise le flux de transaction, montrant les services impliqués et le temps pris par chaque service. +## Carte de flux dynamique -* **Entité participante**: répertorie les services impliqués dans la workload de la transaction, ainsi que leurs mesures de performance. + -## Présentation de Transaction 360 +Le diagramme de flux visualise le parcours de votre transaction à travers vos systèmes distribués : -transaction-360-overview.webp +* **Connexions de service**: Découvrez comment les services communiquent et interagissent entre eux. +* **Performance goulot d'étranglement**: Identifier les composants lents affectant transactionglobale +* **Suivi des relations**: Cliquez sur les paires de services pour afficher les indicateurs de suivi détaillés entre elles. -La section Présentation Transaction 360 fournit le résumé de haut niveau suivant de la workload de transaction associée : +### Fonctionnalité de collaboration -* **Entité dépendante :** Le nombre total d'entités impliquées dans la workload de la transaction fournissant des informations détaillées telles que le nombre d'entités instrumentées et non instrumentées, et le nombre d'entités avec des alertes. De plus, vous pouvez cliquer sur l’entité instrumentée pour afficher ses mesures de performance détaillées et les services associés. Vous pouvez également cliquer sur l'entité non instrumentée pour afficher la liste des entités qui ne sont pas instrumentées, vous permettant d'identifier l'entité qui nécessite instrumentation. De même, vous pouvez cliquer sur l’entité avec des alertes pour afficher la liste des entités avec des alertes, vous permettant de hiérarchiser votre enquête en fonction de la gravité des alertes. +* **Affectation des équipes**: Affecter des équipes à la charge de travail transaction pour une réponse plus rapide aux incidents. +* **Tagging**: Entité liée au groupe pour rationaliser l'enquête et l'organisation -* **Problèmes :** nombre de problèmes détectés dans la workload des transactions, y compris les alertes et les marqueurs de suivi des changements. Cliquez sur **View details** pour afficher la liste des problèmes et identifier l’entité directement impactée par les problèmes de performances. +## Analyse des performances de l'entité -* **suivi des changements :** Le nombre de marqueurs de suivi des changements détectés dans la workload de transaction, indiquant des changements dans les performances de la workload. Cliquez sur **View details** pour visualiser les marqueurs de suivi des changements et identifier les entités directement impactées par les changements de performances. +Cette section fournit des indicateurs détaillés pour chaque type de composant de votre workload transaction : -## Carte de flux dynamique +### Services APM -La carte de flux dynamique visualise le flux de transaction, montrant les services impliqués et le temps pris par chaque service. La carte fournit un aperçu de haut niveau de la workload des transactions, vous permettant d'identifier les goulots d'étranglement et les problèmes de performances. + -dynamic-map.webp +Monitorez les services de votre application avec : -Vous pouvez sélectionner des services associés pour afficher les métriques de tracing entre eux. De plus, vous pouvez également affecter une équipe à la workload de transaction pour faciliter la collaboration et la résolution des problèmes, ou regrouper des entités associées à l'aide d'une balise pour rationaliser le processus d'enquête. +**Tableau des métriques de service :** -La carte de flux dynamique vous aide à identifier les services directement impactés par les problèmes de performances, vous permettant ainsi de concentrer votre enquête sur la cause première. +* **Débit**: Requêtes par minute pour chaque service +* **Taux d'erreur**: Pourcentage de requestséchouées +* **Temps de réponse**: Latence moyenne par service +* **Gravité du problème**: alertes critiques, d’avertissement et d’information pour prioriser les correctifs -## Entité participante et soutenante +**analyse des transactions :** -### Entité APM +* **Évolution des performances**: Modifications des transactions présentant les temps de réponse les plus longs +* **Détails de la trace**: Cliquez sur une transaction pour afficher son flux trace complet. -La section Entité participante fournit une ventilation détaillée des services impliqués dans la workload de transaction, tels que les services APM, les applications de navigateur, les applications mobiles, les fonctions sans serveur ou l'entité infrastructure . +### entité d'infrastructure -partcipating-services.webp + -* **Mesures de performances :** le tableau des services APM affiche les mesures de performances de chaque service, notamment le débit, le taux d'erreur, la latence et les problèmes avec des niveaux de gravité, tels que critique, avertissement et info, pour hiérarchiser votre enquête. +Afficher les performances infrastructure pour les hôtes, le conteneur et le cluster Kubernetes: -* **Tableau des transactions :** vous pouvez également utiliser le tableau des transactions pour identifier les transactions présentant le pourcentage de changement de temps de réponse le plus élevé, ce qui vous permet de concentrer votre enquête sur les transactions les plus impactées. De plus, vous pouvez sélectionner une transaction spécifique pour afficher son flux trace et ses mesures de performance. +**Métriques de ressources :** -### entité d'infrastructure +* **Utilisation du CPU**: Utilisation des processeurs dans infrastructure +* **Consommation de mémoire**: utilisation de la RAM et contraintes potentielles +* **I/O disque**: performances de stockage et goulot d'étranglement +* **Activité du réseau**: Débits de transfert de données et problèmes de réseau + +**Analyse de l'hôtel :** + +* **Classement des ressources**: identifier les hôtes ayant la plus forte consommation de ressources +* **Services associés**: Consultez les applications exécutées sur chaque hôte + +### Applications Browser + + + +moniteur de performances frontend et expérience utilisateur : + +**Métriques de performance :** + +* **Temps de chargement de page**: Rendu frontend et performances de chargement +* **Erreurs JavaScript**: Erreurs côté client affectant l’expérience utilisateur +* **Pages vues**: modèles Traffic et engagement des utilisateurs + +**Outils d'expérience utilisateur :** + +* **Session Replay**: regardez les sessions utilisateur pour comprendre l'impact des performances sur l'utilisateur réel +* Cliquez sur sessions pour afficher les données interaction utilisateur détaillées +* Pour plus de détails, consultez [la documentationSession Replay](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/) + +### Monitoring de base de données + +Suivez les performances de la base de données avec des mesures complètes : + +**Visualisation des performances :** + +* **Graphique du débit**: Opérations de base de données par minute au fil du temps +* **Graphique des temps de requête**: tendances et modèles de performance des temps de réponse + +**Tableau d'analyse des requêtes :** + +* **Opérations de base de données**: nombre d’appels, durée et métriques de temps par requête +* **Classement des performances**: temps d'exécution maximum, moyen et total +* **Optimisation de requête**: identifier la requête la plus lente et la plus fréquente + +**Tableau d'impact des transactions :** + +* **Dépendance de base de données**: indique quelles transactions dépendent le plus des opérations de la base de données +* **Répartition du temps**: Pourcentage du temps de transaction consacré aux appels de base de données +* **Cible d'optimisation**: Transactions avec la charge de base de données la plus élevée + +**Exploration interactive :** + +* Cliquez sur « Nombre de requêtes » pour afficher toutes les requêtes utilisées par une transactionspécifique. +* Cliquez sur les noms transaction pour filtrer la requête par cette transaction +* Accéder à la trace d'appels via les détails d'une requête individuelle + +### fonction sans serveur + +Monitoring AWS Lambda et d'autres composants sans serveur : + +**Graphiques de performance personnalisables :** + +* **Modèles d'appel**: Fréquence d'exécution des fonctions au fil du temps +* **Métriques de Duration**: Délais d'exécution et évolution des performances +* **Utilisation de la mémoire**: Modèles de consommation des ressources +* **Suivi des coûts**: Dépenses associées aux appels de fonction -Si vous avez instrumenté votre entité infrastructure , vous pouvez visualiser les mesures de performance de votre entité infrastructure dans la vue Transaction 360 . La section Entité infrastructure fournit une ventilation détaillée de l'entité infrastructure impliquée dans la workload de transaction, comme les hôtes, le conteneur et le cluster Kubernetes. +**Analyse fonctionnelle :** -infrastructure-entities.webp +* **Relations entre transactions**: Voir quelles transactions déclenchent la fonction serverless +* **Impact sur les performances**: Comment les performances fonctionnelles affectent la vitesse globale transaction +* **Efficacité des ressources**: Allocation de mémoire par rapport à l'utilisation réelle -* **Métriques de performances :** le tableau des entités d'infrastructure affiche les métriques de performances pour chaque entité, y compris l'utilisation du processeur, l'utilisation de la mémoire, I/O disque et I/O réseau, afin d'identifier les problèmes d'étranglement de performances et les contraintes de ressources. +### Applications mobiles -* **Tableau des hôtes :** Vous pouvez également utiliser le tableau des hôtes pour trouver la liste des entités infrastructure et identifier les hôtes avec l'utilisation du processeur, de la mémoire, des I/O disque et I/O réseau les plus élevées, vous permettant ainsi de concentrer votre enquête sur les hôtes les plus impactés. De plus, vous pouvez sélectionner un hôte spécifique pour afficher ses mesures de performances et les services associés. +Suivez les performances de votre application mobile au sein de votre flux transaction : -### Entité Browser +* **Performance de l'application**: temps de réponse et expérience utilisateur métriques +* **Taux de plantage**: Suivi des erreurs spécifiques aux mobiles +* **Métriques des appareils**: performances sur différents appareils mobiles -Si vous avez instrumenté vos applications de navigateur, vous pouvez visualiser les mesures de performance de votre entité de navigateur dans la vue Transaction 360 . La section Entité du navigateur fournit une ventilation détaillée des applications de navigateur impliquées dans la workload de transaction. +### monitoringIA/LLM -browser-entities.webp +performances et coûts du moniteur grands modèles de langage (LLM) : -* **Métriques de performances :** le tableau des entités Browser affiche les mesures de performances pour chaque entité, y compris le temps de chargement de la page, les pages vues et les erreurs JavaScript, afin d'identifier les problèmes de performance et d'étranglement et d'expérience utilisateur. +* **Performance du modèle**: temps de réponse et métriques de précision pour les services d'IA +* **Suivi des coûts**: utilisation de Jeton et coûts associés +* **Taux d'erreur**: Échec requests IA et problèmes de délai d'attente -* **Relecture de session :** vous pouvez également utiliser la fonctionnalité Relecture de session pour rejouer les sessions utilisateur et identifier les interactions utilisateur qui entraînent des problèmes de performances. De plus, vous pouvez sélectionner une session spécifique pour afficher ses mesures de performance et les services associés. Pour plus d'informations, reportez-vous à [Session Replay](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/). +Pour une configuration détaillée de monitoring de l'IA, consultez [la documentationmonitoring de l'IA](/docs/ai-monitoring/intro-to-ai-monitoring/). -### Entité mobile +## Prochaines étapes -Si vous avez instrumenté vos applications mobiles, vous pouvez visualiser les métriques de performance de votre entité mobile dans la vue Transaction 360 . La section Entité mobile fournit une ventilation détaillée des applications mobiles impliquées dans la workload de transaction. +Après avoir identifié les problèmes dans Transaction 360 : -### Monitoring de l'IA +1. **Prioriser les correctifs**: Commencez par l'analyse des alertes et les problèmes de performance ayant le plus grand impact. +2. **Lacunes en matière d'instrumentation**: Ajouter monitoring à l'entité non instrumentée pour une visibilité complète +3. **Mettre en place du monitoring proactif**: créer des alertes pour les seuils de performance des clés transaction +4. **Collaborer**: Utilisez les affectations d'équipe et les étiquettes pour coordonner les efforts de résolution. -Si votre application effectue des appels à des grands modèles de langage (LLM) (LLM) et est instrumentée avec l'agent APM, vous pouvez afficher les mesures de performances de votre entité AI dans la vue Transaction 360 . La section Entité AI fournit une ventilation détaillée du modèle d'IA impliqué dans la workload de transaction. Pour plus d'informations, consultez [monitoring de l'IA](/docs/ai-monitoring/intro-to-ai-monitoring/). \ No newline at end of file +Transaction 360 vous offre la vue d'ensemble dont vous avez besoin pour comprendre, diagnostiquer et résoudre rapidement les problèmes sur l'ensemble de votre workload distribuée. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx b/src/i18n/content/fr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx new file mode 100644 index 00000000000..bd41dcc26ca --- /dev/null +++ b/src/i18n/content/fr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx @@ -0,0 +1,162 @@ +--- +title: Fonctionnalité avancée de relecture de session +metaDescription: Manage session replay & modify capabilities depending on the role +freshnessValidatedDate: '2024-12-19T00:00:00.000Z' +redirect: + - /docs/browser/browser-monitoring/browser-pro-features/session-replay/sequence-filtering +translationType: machine +--- + +Ce document fournit des informations sur la manière d'utiliser la relecture de session pour une analyse approfondie afin d'étudier et de comprendre efficacement le comportement des utilisateurs. Vous pouvez désormais tirer parti New Relic AI pour résumer automatiquement les événements de Session Replay suivi, utiliser le filtrage de séquence pour identifier les replays avec des modèles interaction utilisateur spécifiques et découper les enregistrements pour se concentrer sur la partie la plus pertinente d'une session et la partager avec l'équipe ou la personne responsable. + +## Résumé de New Relic AI [#new-relic-ai] + +Vous pouvez utiliser New Relic AI (NRAI) pour vous aider à résumer et à cartographier les données de suivi des événements de Session Replay afin de mieux comprendre les erreurs et les succès du parcours de navigation de votre utilisateur. + +Pour utiliser NRAI pour résumer vos données de suivi des événements Session Replay, vous devez avoir [NRAI activé](/docs/agentic-ai/new-relic-ai/#enable) pour votre compte. Une fois NRAI activé sur votre compte, procédez comme suit pour afficher votre résumé : + +1. Allez à **[one.newrelic.com > All Capabilities](https://one.newrelic.com/all-capabilities) > Browser**. + +2. Sélectionnez votre application de navigateur. + +3. Dans le menu de gauche, faites défiler vers le bas et cliquez sur **Session replay**. + +4. Cliquez sur le replay pour afficher les détails de la session que vous souhaitez résumer. + + screenshot of the session replay page in browser + +5. Cliquez sur **Summarize**. Un résumé de la session est généré sur le panneau de focus. + + screenshot of the session replay page in browser + +## Filtrage de séquence [#sequence-filtering] + +La fonctionnalité **de filtrage de séquence** vous aide à filtrer la relecture de session en fonction d'une séquence spécifique d'événements enregistrés lors de l'interaction de l'utilisateur. Cette fonctionnalité est conçue pour vous aider à naviguer efficacement parmi de nombreux enregistrements de session sur la page **de liste des sessions**, rendant la recherche de rediffusions pertinentes transparente. + +### Fonctionnalité clé + +* **Filtrage de séquence d'événements**: Vous pouvez filtrer les rediffusions en spécifiant une séquence d'événements dans un ordre particulier, comme un utilisateur effectuant une recherche suivie de l'ajout d'un article à son panier. +* **Filtres personnalisables**: vous pouvez sélectionner des attributs, des opérateurs et des valeurs pour définir leurs filtres de séquence. +* **Prise en charge de plusieurs actions**: vous pouvez spécifier jusqu'à cinq actions dans une séquence. +* **Filtrage flexible**: les filtres peuvent être appliqués dans n'importe quel ordre, vous permettant de combiner des filtres de séquence avec d'autres types de filtres tels que la durée. + +### Personnaliser la vue + +Par défaut, la **séquence** est définie sur **Tout**. Vous pouvez personnaliser la vue en sélectionnant le filtre **Séquence = Tout** et en cliquant sur la boîte de dialogue **Configurer une séquence de filtrage** pour définir leurs filtres de séquence. + +1. Allez à **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**. +2. Sélectionnez le filtre **Séquence = Tout**, l’option **Configurer une séquence de filtrage** apparaît. +3. L'option **Configurer une séquence de filtrage** vous permet de créer un filtre de séquence en spécifiant jusqu'à 5 actions dans un ordre particulier. Vous pouvez définir la séquence en sélectionnant l'attribut suivant : + + + Vous devez ajouter au moins deux étapes au formulaire de filtrage. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Action + + Description +
+ Attribut + + Sélectionnez un attribut : + + * **URL consultée**: Filtrez les données en fonction de l'URL de la page consultée par l'utilisateur. + + * **Action de la page**: filtrez les données en fonction de l'interaction de l'utilisateur avec la page. + + * **Saisie au clavier**: filtrez les données en fonction de la saisie au clavier de l'utilisateur. Vous pouvez élargir davantage la recherche en sélectionnant les options ci-dessous : + + * **cible**: Sélectionnez l'élément cible où la saisie au clavier a été effectuée. + * **cible ID**: Sélectionnez l'ID cible où la saisie au clavier a été effectuée. + * **Classe cible**: Sélectionnez la classe cible dans laquelle la saisie au clavier a été effectuée. + + * **clics du utilisateur**: Filtrez les données en fonction des clics du utilisateur. +
+ Opérateur + + Sélectionnez un opérateur parmi les options ci-dessous : + + * **=**: Où la valeur fournie est égale à la valeur de l'attribut d'incident. + * **Comme**: Lorsque la valeur fournie est similaire à la valeur de l'attribut de l'incident. +
+ Valeur + + Recherchez ou saisissez une valeur. +
+ +4. Cliquez sur **Appliquer**. + + Screenshot of session replay details + +## Replay de la session raccourcie [#trimmed-session-replay] + +La fonction de **Trimmed session replay** vous permet d'extraire et de partager des segments spécifiques des enregistrements de session, en vous concentrant sur les événements pertinents pour une analyse ciblée et une résolution plus rapide des problèmes. Au lieu de partager de longs enregistrements complets, vous pouvez créer des clips ciblés qui mettent en évidence les moments précis où les problèmes surviennent. + +### Créer un replay de session raccourci + +1. Allez à **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**. + +2. Sélectionnez la session de rediffusion que vous souhaitez découper. + +3. Cliquez sur **Share a clip** dans les commandes de relecture de session. + +4. Sélectionnez les limites de votre clip à l'aide des commandes de la timeline : + + * Faites glisser la flèche gauche pour définir l'heure de début de votre clip. + * Faites glisser la flèche vers la droite pour définir l'heure de fin de votre clip. + +5. Remplissez le formulaire de détails du clip : + + * Choisissez la durée pendant laquelle le lien du clip doit rester actif à l'aide de l'onglet Liste de **Availability**. + * Ajouter un message (facultatif) - fournir un contexte sur ce que montre le clip. + * Ajoutez les adresses e-mail pour partager directement le clip avec certains membres de l'équipe. + +6. Vérifiez votre sélection. La section en surbrillance indique ce qui sera inclus dans votre clip. + +7. Cliquez sur **Share this clip** pour générer votre segment découpé. + +### Accès aux clips partagés + +Lorsque vous recevez un enregistrement de session tronqué d'un membre de l'équipe : + +1. **Par notification par e-mail**: Si vous avez été ajouté comme destinataire, vous recevrez un e-mail contenant le lien du clip et tout message fourni par l’expéditeur. +2. **Via une URL partagée**: Cliquez sur le lien partagé dans le panneau de discussion pour ouvrir la rediffusion de la session (version abrégée) dans votre navigateur. + + + Dans Safari, l'URL partagée ne peut pas être copiée automatiquement. Vous devrez copier manuellement le lien généré et le partager avec les destinataires. + + +3. **Visionner l'extrait**: L'extrait est lu automatiquement et n'affiche que le segment sélectionné, ainsi que tout message contextuel de l'expéditeur. + +4. **Disponibilité des clips**: Les clips ont une date d'expiration définie par l'expéditeur. Consultez la fenêtre **Availability** si vous ne pouvez pas accéder à un clip partagé précédemment. + + screenshot of the session replay page in browser \ No newline at end of file diff --git a/src/i18n/content/fr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx b/src/i18n/content/fr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx index bdba6b4a883..e9b1ef05c79 100644 --- a/src/i18n/content/fr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx +++ b/src/i18n/content/fr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx @@ -60,7 +60,7 @@ Un utilisateur différent de `root` peut être utilisé dans la politique géré Statement: - Effect: Allow Principal: - AWS: !Sub 'arn:aws:iam::754728514883:root' + AWS: !Sub 'arn:aws:iam::253490767857:root' Action: 'sts:AssumeRole' Condition: StringEquals: diff --git a/src/i18n/content/fr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx b/src/i18n/content/fr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx index 825b932988c..c752aa5bf35 100644 --- a/src/i18n/content/fr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx +++ b/src/i18n/content/fr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx @@ -52,7 +52,7 @@ Si vous ne voyez pas de données après avoir attendu au moins 10 minutes, essay 		- `754728514883` + `253490767857`
- Comptes HITRUST + Comptes HIPAA - La fonctionnalité log patterns n'est pas conforme à FedRAMP. Les comptes FedRAMP ou autres comptes HITRUST ne sont pas éligibles à l'utilisation de modèles. + La fonctionnalité log patterns n'est pas conforme à FedRAMP. Les comptes FedRAMP ou autres comptes HIPAA ne sont pas éligibles à l'utilisation de modèles (patterns).
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Concept** + + **Ce que cela fait** + + **Exemple** +
+ Entrées et secrets + + Paramètres d'identification et de configuration + + `${{ :secrets:awsKeyId }}` pour les informations d'identification, `${{ .inputs.region }}` pour la configuration. +
+ Catalogue des actions + + Intégration pré-construite (AWS, Slack, base de données, API) + + Faites glisser `aws.ec2.stopInstances` dans le canevas workflow +
+ Flux de données + + Transmettez les sorties entre les étapes + + `${{ .steps.getAlert.outputs.entityGuid }}` +
+ Interrupteurs + + Créez différents chemins en fonction des conditions + + `Route by CPU > 90% vs. 70-90% vs. < 70%` +
+ Boucles + + Listes de processus ou sondage pour l'achèvement + + Utilisez `type: loop` avec `for` et `in` pour itérer sur les collections +
+ portes d'approbation + + Pause pour les décisions humaines + + Réactions de relâchement avant les opérations destructives +
+ Gestion des erreurs + + Détecter les erreurs et exécuter le nettoyage + + Modèles try-catch avec procédures de restauration +
+ + + **Apprenez en pratiquant :** chaque concept est illustré dans l’ [exemple](#example-walkthrough) ci-dessous. Vous verrez des entrées, des commutateurs, des boucles et des portes d'approbation fonctionner ensemble dans un workflow réel. + + +Pour des modèles détaillés de gestion des erreurs, voir [bonnes pratiques](/docs/workflow-automation/limitations-and-faq/workflow-best-practices#error-handling). + +## Démarrage rapide [#quick-start] + +Créez votre premier workflow en cinq étapes : + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** et sélectionnez **[Create Your Own](https://onenr.io/0OQM47KgxjG)** +2. Définir les paramètres pour les informations d'identification (à partir du gestionnaire de secrets : `${{ :secrets:keyName }}`), configuration (régions, type d'instance) et les données d'exécution (identifiants de compte, identifiants d'alerte). +3. Faites glisser les actions depuis le [catalogue](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) et reliez-les avec la syntaxe `${{ .steps.stepName.outputs.field }}` pour transmettre les données. +4. Intégrez des commutateurs pour les branchements conditionnels, des boucles pour le traitement de listes ou l'interrogation, et des portes d'approbation pour les décisions humaines. +5. Exécutez ce script après chaque section pour détecter les erreurs au plus tôt, puis [démarrez ou planifiez](/docs/workflow-automation/create-a-workflow-automation/start-schedule) votre workflow. + + + Commencez par 3 étapes, testez minutieusement, puis développez-les. Un workflow fonctionnel en 5 étapes vaut mieux qu'un workflow défaillant en 20 étapes. + + +## Modèles workflow clés [#workflow-patterns] + +Quatre modèles essentiels permettent de couvrir la plupart des scénarios d'automatisation. Chaque modèle est illustré dans l' [exemple](#example-walkthrough) ci-dessous. + +### Branchement conditionnel avec commutateurs + +**Utilisez des commutateurs lorsque :** les résultats varient en fonction des données (vérifications de seuil, réponses d’API, décisions de l’utilisateur). + +**Syntaxe clé :** + +```yaml +- name: hasCompleted + type: switch + switch: + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}" + next: displayError + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}" + next: displaySuccess + next: displayUnexpected # Default path when no condition matches +``` + +**Voyez-le en action :** les sections [de gestion des réponses de l’équipe](#handle-team-response), [de vérification et de nettoyage](#verify-and-clean-up) montrent le routage des commutateurs en fonction des réactions Slack et de l’état d’AWS SSM. + +### Boucles pour le traitement des listes + +**Utilisez les boucles lorsque** vous traitez plusieurs éléments ou répétez des actions. + +**Syntaxe clé :** + +```yaml +# Send progress updates using range loop +- name: progressLoop + type: loop + for: + in: "${{ [range(1; 5)] }}" # Loop 5 times + steps: + - name: wait + type: wait + seconds: 10 + - name: progressMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "${{ .workflowInputs.channel }}" + text: "Resizing in progress..." +``` + +**Voyez-le en action :** [la section d’exécution de redimensionnement](#execute-the-resize) utilise `progressLoop` pour les mises à jour d’état. + +### Portails d'approbation et attente + +**Utilisez des points de contrôle d'approbation lorsque :** un jugement humain est nécessaire avant des opérations destructives ou une validation de conformité est requise + +**Syntaxe clé :** + +```yaml +- name: requestApproval + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "#approvals" + text: "Approve? React with :thumbsup: or :thumbsdown:" + +- name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: "${{ .workflowInputs.slackToken }}" + channelID: "${{ .steps.requestApproval.outputs.channelID }}" + threadTs: "${{ .steps.requestApproval.outputs.threadTs }}" + timeout: 300 # Wait 5 minutes for reaction + +- name: checkApproval + type: switch + switch: + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}' + next: handleApproval + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}' + next: handleRejection +``` + +**Pour les retards simples :** + +```yaml +- name: waitBeforeRetry + type: wait + seconds: 60 # Wait 60 seconds before continuing +``` + +**Voyez-le en action :** la section [« Demander l’approbation de l’équipe »](#request-team-approval) implémente workflow d’approbation Slack complet. + +### Transmission de données entre les étapes + +**Utilisez le passage de données lorsque :** la sortie d'une étape devient l'entrée d'une autre (la base de tout workflow). + +**Syntaxe clé :** + +```yaml +# Reference previous step outputs +awsRegion: "${{ .inputs.region }}" +instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}" +``` + +**Voyez-le en action :** toutes les sections illustrent le transfert de données ; chaque étape s’appuie sur les résultats précédents. + + + **Vous souhaitez des exemples de motifs complets ?** Consultez [les exemples de workflow](/docs/workflow-automation/workflow-examples) pour découvrir d'autres modèles, notamment la gestion des erreurs, les nouvelles tentatives et l'intégration complexe. + + +## Exemple de procédure pas à pas : redimensionnement automatique des instances EC2 avec approbation [#example-walkthrough] + +Cet exemple complet montre comment créer un workflow qui redimensionne automatiquement les instances EC2 en cas de pics d'utilisation du processeur, après avoir obtenu l'approbation de l'équipe via Slack. Il illustre la collecte de données, la logique conditionnelle, l'intégration externe et la gestion des erreurs dans un scénario réel. + + + **Vous débutez dans le monde du workflow ?** Cet exemple utilise AWS, Slack et une logique d'approbation. Si vous débutez, essayez d'abord [d'envoyer le rapport sur Slack](/docs/workflow-automation/create-a-workflow-automation/use-a-template#send-report-to-slack). + + +### Prérequis [#prerequisites] + +Avant de mettre en place ce workflow, assurez-vous d'avoir : + +* **AWS**: Identifiants avec autorisations EC2 et système Manager +* **Slack**: Bot Jeton et canal de notification +* **New Relic**: état d'alerte monitoring du processeur EC2 +* **Gestionnaire de secrets**: configuré (voir [gestion des secrets](/docs/infrastructure/host-integrations/installation/secrets-management/)) + +### aperçu du flux de travail [#workflow-overview] + +**Flux de haut niveau :** + +1. **Collecte de données**: Récupérer les détails de l'alerte et de l'instance auprès de New Relic +2. **Demande d'approbation**: Envoyer un message Slack, attendre la réponse de l'équipe +3. **Exécuter le redimensionnement**: Utilisez AWS Systems Manager pour redimensionner instanceEC2. +4. **Vérification et nettoyage**: Vérifier les résultats, informer l'équipe, supprimer les ressources temporaires + +Cet exemple illustre les principaux modèles que vous utiliserez dans un workflow personnalisé : interrogation d’API, branchement conditionnel, intégration externe, boucles d’interrogation et gestion des erreurs. + +### Entrées du workflow [#workflow-inputs] + + + **Passez cette section si vous cherchez à comprendre les concepts.** Ce tableau détaille les 12 paramètres utilisés par ce workflow. Vous pouvez vous y référer lors de la construction, mais ce n'est pas indispensable pour comprendre le flux. + + +Ce workflow nécessite comme entrées des informations d'identification, configuration et un contexte d'exécution. Les valeurs sensibles proviennent du gestionnaire de secrets utilisant la syntaxe `${{ :secrets:keyName }}`. + +**Catégories d'entrée :** + +* **Authentification**: identifiants AWS et Slack provenant du gestionnaire de secrets +* **Contexte de l'alerte**: ID du compte et ID du problème provenant de New Relic +* **Configuration**: Région, type d'instance, fuseau horaire, canal Slack + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Nom du paramètre** + + **Type** + + **Valeur par défaut** + + **Description** +
+ `awsAccessKeyId` + + Chaîne + + `${{ :secrets:awsAccessKeyId }}` + + ID de clé d'accès AWS récupéré depuis le gestionnaire de secrets pour l'authentification auprès des services AWS. +
+ `awsSecretAccessKey` + + Chaîne + + `${{ :secrets:awsSecretAccessKey }}` + + Clé d'accès secrète AWS récupérée depuis le gestionnaire de secrets. Paires avec l'ID de clé d'accès. +
+ `awsSessionToken` + + Chaîne + + `${{ :secrets:awsSessionToken }}` + + Jeton de session pour les informations d'identification AWS temporaires (facultatif, utilisé avec les rôles IAM). +
+ `slackToken` + + Chaîne + + `${{ :secrets:slackToken }}` + + Bot Jeton permettant de publier des messages et de lire les réactions sur Slack. +
+ `accountId` + + Int + + Requis + + Votre identifiant de compte New Relic. Utilisé pour interroger les détails des alertes et les données des entités. +
+ `issueId` + + Chaîne + + Requis + + L'identifiant du problème de l'alerte New Relic qui a déclenché ce workflow. Fourni automatiquement lorsque le workflow s'exécute à partir d'une alerte. +
+ `awsRegion` + + Chaîne + + `us-east-2` + + région AWS dans laquelle votre instanceEC2 s'exécute (par exemple, `us-east-1`, `us-west-2`, `eu-west-1`). +
+ `InstanceType` + + Chaîne + + `t4g.nano` + + instance cible EC2 de type d'instance à redimensionner. Choisissez en fonction de vos besoins en matière de performance et de votre budget. +
+ `timestampUnit` + + Chaîne + + `MILLISECONDS` + + Unité de temps pour l'horodatage de l'alerte. Généralement `MILLISECONDS` ou `SECONDS`. +
+ `timezoneId` + + Chaîne + + `America/Los_Angeles` + + Fuseau horaire pour l'affichage de l'heure d'activation de l'alerte dans les messages Slack (par exemple, `America/New_York`, `Europe/London`, `Asia/Tokyo`). +
+ `pattern` + + Chaîne + + `MM-dd-yyyy HH:mm` + + Modèle de format de date/heure pour l'affichage de l'horodatage. Utilise les modèles SimpleDateFormat de Java. +
+ `channel` + + Chaîne + + Requis + + Identifiant (et non nom) du canal Slack où les notifications sont publiées. Vous trouverez cela dans les détails du canal Slack. +
+ + + +## Élaborez le workflow étape par étape [#step-by-step-workflow] + +Passons maintenant en revue chaque partie du workflow. Chaque étape comprend les actions spécifiques à ajouter et les modèles workflow qu'elles illustrent. + + + + ### Recueillir le contexte de l'alerte [#gather-alert-context] + + Requêtes API et base de données avant d'agir. Cela vous assure d'avoir un contexte complet. + + Le workflow collecte les informations relatives aux alertes et aux instanceEC2 à l'aide de trois actions : + + * **`getAlertDetails`**: appelle l'API NerdGraph (API GraphQL de New Relic) pour récupérer les métadonnées des alertes : heure d'activation, nom de la condition et entité affectée. + + * **`activatedDateTime`**: Convertit l'horodatage en un format lisible comme « 01-24-2025 14:30 » pour les messages Slack. + + * **`impactedEC2Instance`**: requête NRDB (New Relic base de données) pour trouver l'ID EC2 et le type actuel de instance. + + Workflow diagram showing three steps: getAlertDetails queries NerdGraph API, activatedDateTime converts timestamp, and impactedEC2Instance retrieves instance details from NRDB + + **Pourquoi c'est important :** sans ces détails, vous ne pouvez pas construire de messages Slack significatifs ni cibler la bonne instanceEC2. + + + + ### Demander l'approbation de l'équipe [#request-team-approval] + + Connectez-vous à des outils de collaboration comme Slack, PagerDuty ou ServiceNow pour les points de décision humains. + + Le workflow envoie les détails à Slack et attend une réponse : + + * **`IssueDetected`**: Publie les détails de l'alerte, le type actuel d'instance et le redimensionnement proposé vers Slack. Demande à l'équipe de réagir avec `:+1:` (approuver) ou `:-1:` (annuler). + + * **`GetUserReaction`**: Pause de 5 minutes (300 secondes) en attendant une réaction. + + * **`checkQuery` (Interrupteur)**: Routes basées sur la réaction : + + * **`:+1:`** → Commencer le redimensionnement + * **`:-1:`** → Arrêter workflow + * **Autre** → invite à une réaction valide, retour en arrière + + Workflow diagram showing user approval process: IssueDetected posts Slack message, GetUserReaction waits for response, checkQuery evaluates reactions with three conditions for approval, cancellation, or unexpected responses + + + **Problème courant :** utilisez **l’ID** du canal Slack (`C01234ABCD`), et non le nom du canal. Vous le trouverez dans les détails du canal Slack. Consultez [la section dépannage](#common-issues) pour plus d'informations. + + + + + ### Gérer la réponse de l'équipe [#handle-team-response] + + Utilisez des commutateurs pour créer différents chemins en fonction des valeurs des données ou des entrées de l'utilisateur. + + Le workflow se ramifie en fonction de la réaction : + + * **`unexpectedReaction`**: Explique les réactions valides et revient en arrière pour attendre à nouveau. + * **`gotCancelReaction`**: Confirme l'annulation, passe à la fin. Aucun changement d'infrastructure. + * **`gotYesReaction`**: Confirme l'approbation, procède au redimensionnement. + + + **Modèle de contrôle d'approbation :** Utilisez ce type de mécanisme lorsque vous avez besoin d'un jugement humain avant d'entreprendre des changements risqués. Ce modèle fonctionne avec les réactions Slack, les accusés de réception PagerDuty, les réponses par e-mail ou les webhooks personnalisés. + + + + + ### Exécutez le redimensionnement [#execute-the-resize] + + Utilisez un jeton unique pour éviter les opérations en double. Utilisez des boucles pour vérifier l'état des opérations de longue durée. + + Le workflow redimensionne l' instance via AWS Systems Manager (SSM) : + + * **`createSsmDocument`**: Crée un document d'automatisation SSM qui arrête l'instance, modifie le type et la redémarre. + * **`generateIdempotencyToken`**: Crée un UUID unique. Empêche les redimensionnements en double si le workflow s'exécute deux fois. + * **`startResizing`**: Exécute le document SSM avec l'ID d' instance et le nouveau type. + * **`progressLoop` (Boucle)**: Publie les mises à jour Slack toutes les 10 secondes (5 fois au total). + * **`waitForCompletion`**: Interroge l'état du SSM avec un délai d'expiration de 2 minutes. + + + **Pourquoi SSM ?** Système Manager assure la gestion des erreurs, la vérification de l’état et les logs d’audit CloudTrail. Mieux qu'un appel d'API EC2 direct. + + + + **Problème courant :** assurez-vous que les informations d’identification AWS disposent des autorisations `ec2:StopInstances`, `ec2:ModifyInstanceAttribute`, `ec2:StartInstances` et `ssm:*`. Les autorisations manquantes entraînent une erreur silencieuse. + + + + + ### Vérifier et nettoyer [#verify-and-clean-up] + + Prévoyez les échecs et nettoyez les ressources temporaires, quel que soit le résultat. + + Le workflow vérifie les résultats et supprime les ressources temporaires : + + * **`hasCompleted` (Switch)**: Branches sur l'état SSM (succès/échec/délai d'attente dépassé). + * **`displaySuccess`**: enregistrer le succès dans New Relic. + * **`sendSuccessMessage`**: Confirme la fin de la tâche dans Slack. + * **`displayError`**: enregiste les détails de l'erreur pour le dépannage. + * **`displayUnexpected`**: consigner les états inhabituels (annulation manuelle, etc.). + * **`cleanupSsmDocument`**: Supprime le document SSM temporaire. + * **`sendSSMCleanMessage`**: Confirme le nettoyage dans Slack. + * **`workflowCompleted`**: Message de fin de série (exécute pour réussir ou annuler). + + + * **Toujours nettoyer.** Structurez le workflow de manière à ce que le nettoyage s'exécute même si les étapes précédentes échouent. Cela permet d'éviter les fuites de ressources et les frais AWS inattendus. + * **Problème courant :** si le SSM expire, l’ instanceEC2 peut encore être en transition entre deux états. Consultez AWS Console pour vérifier l'état actuel instance avant de relancer l'opération. + + + + +## Prochaines étapes + +### Exécuter et gérer + +* **[Démarrer et planifier des workflows](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: Déclencher manuellement ou planifier automatiquement. +* **[Gestion des workflows](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: Modifier, versionner, cloner ou désactiver les workflows. + +### Améliorer + +* **[bonnes pratiques](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Gestion des erreurs, gestion des secrets, performances, tests. +* **[Catalogue des actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: AWS, Azure, GCP, HTTP, transformations de données. +* **[Exemples de workflow](/docs/workflow-automation/workflow-examples)**: Des scénarios d’automatisation plus concrets. + +### Échelle + +* **[API d'automatisation des workflows](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: déploiement via API pour infrastructureen tant que code. +* **[Limites du workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: délais d’expiration, limites d’actions, contraintes de charge utile. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx new file mode 100644 index 00000000000..51898e3c0d6 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx @@ -0,0 +1,164 @@ +--- +title: Gérer l'automatisation workflow +tags: + - Workflow Automation + - workflow + - build a workflow using New Relic +metaDescription: 'Navigate the workflow dashboard to view, edit, duplicate, delete, and monitor workflows in New Relic.' +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Le [dashboard d'automatisation des workflows](https://onenr.io/0gR7XE8LXjo) offre un emplacement centralisé pour visualiser, gérer et monitorer tous les workflows de votre compte. Utilisez le dashboard pour modifier la configuration, suivre l'historique des versions, gérer les calendriers d'exécution et résoudre les problèmes. + +## Tâches courantes + +Accès rapide aux opérations de gestion workflow : + +* **[Afficher le workflow](#view-workflows)** - Accéder dashboard et filtrer le workflow +* **[Modifier un workflow](#edit-a-workflow)** - Mettre à jour la configuration ou les paramètres +* **[Gérer les versions](#manage-versions)** - Comprendre le versionnage automatique et figer les versions pour la planification +* **[Dupliquer un workflow](#duplicate-a-workflow)** - Copier le workflow lors de l'adaptation des modèles +* **[Supprimer un workflow](#delete-a-workflow)** - Supprimer définitivement un workflow + +## Avant de commencer + +Avant de gérer le workflow, assurez-vous d'avoir : + +* Un compte New Relic actif avec accès à l'automatisation des workflows. +* Au moins un workflow dans votre compte (à partir d'un modèle ou personnalisé). +* Modifier et supprimer les autorisations du workflow. + +**Vous débutez dans le monde du workflow ?** Commencez par [utiliser un modèle](/docs/workflow-automation/create-a-workflow-automation/use-a-template) ou [créez votre propre workflow](/docs/workflow-automation/create-a-workflow-automation/create-your-own) pour construire votre premier workflow. + +## Afficher le workflow [#view-workflows] + +Le dashboard workflow affiche tous les workflows de votre compte, avec des informations clés pour vous aider à les gérer. + +### Accéder au dashboard + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + +2. Le dashboard affiche l'ensemble du workflow avec les informations suivantes : + + * **Nom**: identifiant du workflow que vous avez attribué lors de sa création + * **Description**: Objectif ou fonction du workflow + * **Statut**: État actuel (Actif, Inactif, Échec) + * **Version**: Numéro de version actuel pour le suivi des modifications + * **Dernière exécution**: horodatage de la dernière exécution + * **Créé par**: l'utilisateur qui a créé le workflow + +### Workflow de filtrage et de recherche + +Utilisez les options de recherche et de filtrage pour localiser un workflow spécifique : + +* **Barre de recherche**: Saisissez le nom ou les mots-clés de la description workflow +* **Filtre d'état**: Afficher uniquement les workflows actifs, inactifs ou ayant échoué +* **Options de tri**: Tri par nom, dernier temps d'exécution ou date de création + +## Modifier un workflow [#edit-a-workflow] + +Mettre à jour le nom, la description ou configuration workflow. Accédez aux options de gestion workflow via le menu « Plus d’options » (trois points verticaux) situé à côté de chaque nom workflow. + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + +2. Sélectionnez votre workflow dans la liste. + +3. Mettre à jour les détails workflow : + + * **Nom**: Identifiant de modification workflow + * **Description**: Modifier la description de l'objectif workflow + * **configuration**: Ajuster les paramètres d'entrée, les actions ou la logique + +4. Cliquez sur **Save** + +## Gérer les versions [#manage-versions] + +L'automatisation des workflows crée automatiquement une nouvelle version à chaque mise à jour d'une définition workflow. Toutes les versions précédentes restent disponibles à titre de référence. + +### Épinglage de version pour la planification + +Lorsque vous planifiez un workflow, vous devez l'associer à une version spécifique. Cette exigence garantit que les exécutions planifiées continuent d'utiliser la même version testée même lorsque vous mettez à jour la définition workflow. + +**Démarrez et planifiez l'épinglage de la version de prise en charge des workflows :** + +* Lors de la planification d'un workflow, spécifiez la version à exécuter. +* Lors du lancement manuel d'un workflow, sélectionnez la version à exécuter. +* Les calendriers existants continuent d'utiliser leur version épinglée jusqu'à ce que vous les mettiez à jour. + +Cela vous permet de : + +* Mise à jour du workflow sans incidence sur les calendriers en cours +* Tester manuellement les nouvelles versions avant de mettre à jour les calendriers +* Maintenir la stabilité du flux de production + +## Dupliquer un workflow [#duplicate-a-workflow] + +Dupliquez le workflow lorsque vous devez adapter un modèle ou workflow existant à un usage différent tout en conservant l'original intact. + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Localisez le workflow que vous souhaitez dupliquer. +3. Cliquez sur les points de suspension (trois points verticaux). +4. Sélectionner **Duplicate** +5. Le système crée une copie avec « (Copie) » ajouté au nom +6. Renommez et personnalisez le workflow dupliqué selon vos besoins. + +**Scénarios de duplication courants :** + +* Adapter un modèle workflow à votre cas d'utilisation spécifique +* Création d'un workflow pour une autre équipe ayant des exigences similaires +* Expérimenter des changements significatifs tout en préservant l'original + + + **Évitez les duplications inutiles :** ne dupliquez pas le workflow à des fins de contrôle de version ou de restauration ; le système crée automatiquement des versions lorsque vous mettez à jour le workflow. Une duplication excessive peut vous amener à atteindre les limites workflow. Consultez [la section Gérer les versions](#manage-versions) pour plus d'informations sur le versionnage automatique. + + +## Supprimer un workflow [#delete-a-workflow] + +Supprimez les workflows dont vous n'avez plus besoin. + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Localisez le workflow que vous souhaitez supprimer +3. Cliquez sur le menu « Plus d’options » (trois points verticaux). +4. Sélectionner **Delete** +5. Confirmez la suppression dans la boîte de dialogue. + + + La suppression d'un workflow efface toutes les versions et l'historique d'exécution. Cette action ne peut pas être annulée. Si vous pensez avoir besoin de ce workflow ultérieurement, envisagez de le désactiver plutôt que de le supprimer. + + +**Ce qui est supprimé :** + +* Toutes les versions du workflow +* Historique complet des exécutions et des logs +* Toutes les exécutions planifiées associées au workflow + +**Avant de supprimer, vérifiez :** + +* Aucune automatisation critique ne dépend de ce workflow +* Vous disposez d'une copie de sauvegarde au cas où vous en auriez besoin plus tard. +* Toutes les exécutions planifiées sont identifiées et comptabilisées. + +## Prochaines étapes + +Après vous être familiarisé avec le dashboard workflow, explorez ces ressources : + +**Exécuter et monitorer vos workflows :** + +* **[Démarrer et planifier des workflows](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: déclenchez-les manuellement ou configurez des planifications automatisées. + +**Améliorez votre workflow :** + +* **[Bonnes pratiques](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Patterns pour la gestion des erreurs, les performances et la fiabilité +* **[Limites du workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprendre les contraintes de délai d’expiration, d’action et de charge utile + +**Créer davantage de workflow :** + +* **[Utiliser un modèle](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: déployer un workflow préconfiguré pour les scénarios courants +* **[Créez votre propre workflow](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: élaborez des automatisations personnalisées à partir de zéro. \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx new file mode 100644 index 00000000000..4e3878a3096 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx @@ -0,0 +1,237 @@ +--- +title: Démarrer et planifier le workflow +tags: + - workflow automation + - workflow + - start a workflow automation + - start workflow automation on demand + - schedule workflows +metaDescription: Trigger workflows manually or schedule them to run automatically at specified times using NerdGraph APIs. +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Une fois votre workflow créé, vous pouvez l'exécuter manuellement à la demande ou le programmer pour qu'il s'exécute automatiquement à des heures précises. Les deux méthodes utilisent l' [API NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) pour déclencher l'exécution workflow. + +## Choisissez votre méthode de déclenchement + +Choisissez l'approche la plus adaptée à votre cas d'utilisation : + +| **Utilisation à la demande** | **Utiliser les horaires** | +| ------------------------------------ | ------------------------------------ | +| Test d'un nouveau workflow | bilans de santé réguliers | +| Workflow d'approbation manuelle | Traitement périodique des données | +| Réponses déclenchées par une alerte | Rapports quotidiens/hebdomadaires | +| Tâches de maintenance ponctuelles | Fenêtres de maintenance programmées | +| Opérations ponctuelles | Sauvegardes ou nettoyages récurrents | + +## Avant de commencer + +Avant de déclencher le workflow, assurez-vous d'avoir : + +* **Workflow créé**: Une définition workflow déjà déployée dans votre compte (à partir [d'un modèle](/docs/workflow-automation/create-a-workflow-automation/use-a-template) ou [personnalisée](/docs/workflow-automation/create-a-workflow-automation/create-your-own)). +* **ID du compte**: Votre ID de compte New Relic (disponible dans [les paramètres du compte](/docs/accounts/accounts-billing/account-structure/account-id)). +* **Nom du workflow**: Le nom exact figurant dans votre définition workflow. +* **Entrées requises**: Valeurs de tous les paramètres attendus par votre workflow. +* **Secrets configurés**: identifiants AWS, jeton Slack ou autres secrets stockés dans [le gestionnaire de secrets](/docs/infrastructure/host-integrations/installation/secrets-management/). + + + **Vous débutez dans le monde du workflow ?** Créez votre premier workflow avant de tenter de le déclencher. Commencez par [utiliser un modèle](/docs/workflow-automation/create-a-workflow-automation/use-a-template) pour les workflows prédéfinis. + + +## Exécuter le workflow à la demande [#on-demand] + +Déclenchez manuellement des workflows à l'aide de l' [API StartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run). Cela exécute immédiatement le workflow avec les données que vous fournissez. + +### Exemple : Appeler une fonction AWS Lambda + +La définition workflow suivante invoque une fonction AWS Lambda et enregistre la sortie. Remplacez `12345678` par votre identifiant de compte New Relic. + +```yaml + name: lambda1 + + workflowInputs: + username: + type: String + defaultValue: "User" + key: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_ACCESS_KEY_ID }}" + access: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SECRET_ACCESS_KEY }}" + token: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SESSION_TOKEN }}" + region: + type: String + defaultValue: us-east-1 + + steps: + - name: invoke1 + type: action + action: aws.lambda.invoke + version: 1 + inputs: + awsAccessKeyId: ${{ .workflowInputs.key }} + awsSecretAccessKey: ${{ .workflowInputs.access }} + awsSessionToken: ${{ .workflowInputs.token }} + region: ${{ .workflowInputs.region }} + functionName: hello-you + payload: + user: ${{ .workflowInputs.username }} + + - name: logOutput + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'The lambda function message output is:${{ .steps.invoke1.outputs.payload.body }}' +``` + +Pour démarrer ce workflow, utilisez la mutation NerdGraph suivante. Avant d'exécuter cette mutation, assurez-vous d'avoir enregistré vos informations d'identification AWS à l'aide de la mutation `secretsManagementCreateSecret`. Pour plus d'informations, consultez [l'Introduction à la gestion des secrets](/docs/apis/nerdgraph/examples/nerdgraph-secrets-management). + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "Julien"} + ] + ) { + runId + } +} +``` + +**Explication des paramètres :** + +* `scope`: L'identifiant du compte où est stockée votre définition workflow +* `definition`: Le nom du workflow à exécuter (doit correspondre au champ `name` dans votre définition workflow ) +* `workflowInputs`: paires clé-valeur qui remplacent les valeurs par défaut dans la section `workflowInputs` de votre définition workflow + +La mutation renvoie un `runId` (par exemple, `7bd25287-2af8-42e1-b783-80f4e760a40b`). Utilisez cet identifiant pour interroger les logs et afficher le résultat : + +Workflow automation logs showing the Lambda function output + +## Planifier le workflow [#scheduled] + +Planifiez l'exécution automatique des workflows à des heures spécifiques à l'aide de l' [API CreateSchedule](/docs/workflow-automation/workflow-automation-apis). Les workflows planifiés exécutent des tâches récurrentes sans intervention manuelle. + +**Quand planifier le workflow :** + +* bilans de santé réguliers +* Traitement périodique des données +* Rapports quotidiens/hebdomadaires +* Fenêtres de maintenance programmées +* Sauvegardes ou nettoyages récurrents + +### Référence d'expression Cron + +Les planifications utilisent des expressions cron pour définir le moment d'exécution des workflows. Format: `minute hour day month weekday` + +| **Modèle** | **Description** | **Exemple d'utilisation** | +| -------------- | ----------------------------------- | ---------------------------------------- | +| `0 9 * * *` | Tous les jours à 9h00 | bilans de santé quotidiens du matin | +| `0 9 * * 1-5` | Tous les jours de la semaine à 9h00 | opérations en journée | +| `0 */6 * * *` | Toutes les 6 heures | Opérations de synchronisation régulières | +| `0 0 1 * *` | Premier jour du mois à minuit | Rapports mensuels | +| `*/15 * * * *` | Toutes les 15 minutes | Sondages fréquents | +| `0 0 * * 0` | Tous les dimanches à minuit | Tâches de nettoyage hebdomadaires | + + + **Syntaxe de Cron :** `*` signifie « chaque », `/` signifie « tous les n », `-` signifie « intervalle ». Exemple : `0 9 * * 1-5` = À la minute 0, à l'heure 9, tous les jours, tous les mois, du lundi au vendredi. + + +### Exemple : Planifier un bilan de santé quotidien + +L'exemple suivant planifie l'exécution workflow `lambda1` tous les jours à 9 h, heure de l'Est : + +```graphql +mutation { + workflowAutomationCreateSchedule( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Configure the schedule + schedule: { + # Cron expression: minute hour day month weekday + # "0 9 * * *" = every day at 9:00 AM + cronExpression: "0 9 * * *" + + # Timezone for the schedule + timezone: "America/New_York" + + # Optional: Schedule name for identification + name: "daily-lambda-health-check" + + # Optional: Add a description + description: "Runs Lambda health check every morning at 9 AM" + } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "HealthCheckBot"} + ] + ) { + scheduleId + } +} +``` + +**Ce que vous obtenez en retour :** + +* `scheduleId`: Identifiant unique du planning (à utiliser pour mettre à jour ou supprimer le planning ultérieurement) + +### Gérer les horaires + +Après avoir créé un planning : + +* **Afficher les planifications actives**: Consultez toutes les exécutions planifiées dans le [dashboardworkflow.](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs) +* **Mise à jour du planning**: Utilisez l’API UpdateSchedule pour modifier la fréquence ou les entrées. +* **Supprimer une planification**: utilisez l’API DeleteSchedule pour arrêter les exécutions récurrentes. + +Pour obtenir la documentation complète de l'API, consultez [la section API d'automatisation des workflows](/docs/workflow-automation/workflow-automation-apis). + +## Prochaines étapes + +Votre workflow est en cours ! Voici la prochaine étape : + +**Monitorer et gérer :** + +* **[Gérer le workflow](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: consulter l’historique des exécutions, vérifier les logs et résoudre les problèmes. +* **[Dépannage des workflows](/docs/workflow-automation/troubleshooting)**: Résoudre les problèmes d'exécution courants + +**Optimiser pour la production :** + +* **[bonnes pratiques](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Modèles de gestion des erreurs, de performances et de fiabilité +* **[Limites du workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprendre les limites de délai d’expiration et de contrainte + +**Développez votre workflow :** + +* **[Catalogue d'actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: Explorez toutes les intégrations disponibles. +* **[API d'automatisation des workflows](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: Gestion programmatique workflow \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx new file mode 100644 index 00000000000..bffedbfd69c --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx @@ -0,0 +1,284 @@ +--- +title: Utilisez un modèle pour créer une automatisation de workflow +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic + - workflow template +metaDescription: 'Jump-start your automation with pre-built workflow templates. Deploy in minutes, customize to your needs, and automate common tasks.' +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Les modèles offrent un workflow préconfiguré pour les scénarios courants : envoi de rapports à Slack, restauration d’un déploiement, redimensionnement d’instances EC2, etc. Déployez-le en quelques minutes, puis personnalisez-le pour qu'il corresponde au processus de votre équipe. + +## Pourquoi utiliser des modèles ? + +* **Démarrez plus rapidement**: déployez des automatisations fonctionnelles en quelques minutes. +* **Adoptez les bonnes pratiques**: utilisez des modèles éprouvés et une gestion des erreurs efficace. +* **Apprenez par l'exemple**: découvrez comment les actions s'enchaînent et comment les données circulent. +* **Réduisez les erreurs**: Commencez par une configuration testée + +## Avant de commencer + +La plupart des modèles nécessitent des identifiants et une intégration : + +* **Modèles AWS**: [Identifiants AWS](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials) avec autorisations (EC2, API Gateway, système Manager ou SQS). +* **Notification Slack**: Application Slack avec bot jeton et accès au canal. +* **Tous les modèles**: compte New Relic et GUID de l'entité (identifiant unique pour les ressources du moniteur). + + + **Vous n'avez pas encore d'identifiants ?** Commencez par parcourir les modèles. Configurez les identifiants avant le déploiement. + + +## déployer un modèle + + + + ### Trouvez le bon modèle + + Parcourez la [bibliothèque de modèles](#workflow-automation-templates) ci-dessous. Chacune indique sa fonction, quand l'utiliser, les prérequis et son mode de fonctionnement. + + + + ### déployer et configurer + + 1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + 2. Sélectionnez **Use a Template** + 3. Choisissez votre modèle + 4. Remplissez les entrées (identifiants, GUID de l'entité, requête, canaux) + 5. Sélectionnez **Deploy** + + Votre workflow est maintenant actif. + + + + ### Tester et vérifier + + Tester avant la mise en production : + + 1. Déclencher manuellement (voir [Démarrer les workflows à la demande](/docs/workflow-automation/create-a-workflow-automation/start-schedule#on-demand)) + 2. Exécution du moniteur dans l'historique d'exécution + 3. Vérifier les résultats (messages Slack, modifications AWS, logs) + 4. Vérifier les erreurs, ajuster la configuration + + + **Effectuez d'abord les tests en environnement hors production.** Certains modèles modifient l'infrastructure. Valider avant utilisation en production. + + + + +## Personnalisez votre modèle + +Modifier le workflow après déploiement : + +* **Ajouter une logique conditionnelle**: ignorer les étapes en fonction des conditions +* **Modèles de chaînes**: Utiliser les sorties comme entrées pour d'autres workflows +* **Personnaliser les notifications**: modifier les formats, les destinataires et les canaux +* **Ajouter des actions personnalisées**: Inclure requests HTTP ou des transformations de données + +Consultez la section [« Créer votre propre workflow »](/docs/workflow-automation/create-a-workflow-automation/create-your-own) pour plus de détails. + +## Modèles de dépannage + +Si votre workflow échoue ou ne se comporte pas comme prévu : + +1. **Consultez l'historique d'exécution**: accédez à **Workflow Automation > \[Votre workflow] > Run History** pour afficher les logs d'exécution et le message d'erreur. + +2. **Consultez les problèmes courants**: voir [la section « Automatisation du workflow de dépannage »](/docs/workflow-automation/troubleshooting) pour trouver des solutions. + + * Erreurs d'identification et d'autorisation AWS + * Problèmes d'intégration Slack + * Problèmes liés aux GUID d'entité + * échecs des requêtes NRQL + * délai d'expiration du workflow + * dépannage spécifique au modèle + + + **Testez les modèles en toute sécurité**: testez toujours d'abord dans un environnement hors production. Les modèles modifiant l'infrastructure (EC2, API Gateway) peuvent avoir un impact sur la disponibilité s'ils sont mal configurés. + + +## modèles d'automatisation des workflows + + + + **Ce que cela fait :** + + interroge les données New Relic avec NRQL (langage de requête New Relic), formate les résultats en CSV et les publie sur Slack. + + **Quand l'utiliser :** + + Automatisez les rapports réguliers : résumés de performances quotidiens, taux d'erreur hebdomadaire, volumes transaction horaires ou mesures personnalisées. + + **Ce dont vous aurez besoin :** + + * **Slack**: Bot Jeton avec autorisations de publication sur le canal + * **New Relic**: Accès au compte et requête NRQL valide + + **Comment ça marche :** + + 1. Exécute votre requête NRQL + 2. Convertit les résultats au format CSV + 3. Publications sur Slack + 4. État des logs + + + + **Ce que cela fait :** + + Détecte les problèmes de déploiement et rétablit la configuration précédente d'AWS API Gateway, après approbation de l'équipe. + + **Quand l'utiliser :** + + Annulez les mauvaises déploiements qui génèrent des erreurs, interrompent l'intégration ou provoquent un incident. Filet de sécurité pour les changements à haut risque. + + **Ce dont vous aurez besoin :** + + * **AWS**: autorisations API Gateway et système Manager + * **Slack**: Application de notification et d'approbation + * **New Relic**: GUID de l'entité API Gateway + + **Comment ça marche :** + + 1. Récupère l'historique de déploiement + 2. En lien avec le problème actuel + 3. Demande d'approbation Slack + 4. Exécute la restauration si approuvée + 5. Avertit l'équipe et nettoie. + + + **Approbation manuelle requise.** Aucune annulation ne sera effectuée sans l'approbation de l'équipe via les réactions Slack. + + + + + **Ce que cela fait :** + + Redimensionne automatiquement les instances EC2 en cas de pic d'utilisation du processeur ou des ressources. + + **Quand l'utiliser :** + + Gérer les pics d'utilisation du processeur lors des pics de trafic, adapter la taille des instances atteignant leurs limites, gérer les modèles de charge imprévisibles. + + **Ce dont vous aurez besoin :** + + * **AWS**: autorisations EC2 et système Manager + * **Slack**: Application de notification et d'approbation + * **New Relic**:monitoring de[AWS CloudWatch Metric Streams](https://docs.newrelic.com/install/aws-cloudwatch/) EC2, [monitoring et des conditions d'alerte](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) + + + **Utilisez le flux de métriques CloudWatch.** Fournit une couverture complète des métriques AWS, y compris un espace de nommage personnalisé. + + + **Comment ça marche :** + + 1. Reçoit une alerte et identifie l'instance + 2. Demande d'approbation Slack + 3. Crée un document d'automatisation + 4. Arrête, modifie et démarre une instance + 5. Mise à jour des progrès et nettoyage + + + + **Ce que cela fait :** + + Récupère les données JSON des pages d'état externes, analyse l'état des composants et enregistre les informations dans New Relic. + + **Quand l'utiliser :** + + Monitorez les dépendances tierces (processeurs de paiement, fournisseurs d'authentification, services de données), corrélez les pannes avec vos problèmes, créez un dashboard unifié. + + **Ce dont vous aurez besoin :** + + * **Accès API**: point de terminaison d'état public renvoyant JSON + * **New Relic**: Compte pour la connexion + + **Comment ça marche :** + + 1. Récupère le JSON à partir du point de terminaison + 2. Analyse l'état des composants + 3. Catégorise l'état opérationnel + 4. Logs dans New Relic avec filtres + + + **Planifiez un enregistrement toutes les 5 à 15 minutes** pour constituer un historique de la fiabilité des tiers. + + + + + **Ce que cela fait :** + + Monitore l'état de l'application après son déploiement et envoie une notification en cas de problème. + + **Quand l'utiliser :** + + Surveillez les nouvelles sorties après déploiement, détectez les problèmes spécifiques à la production, déclenchez un processus de restauration en cas de dégradation de l'état de santé. + + **Ce dont vous aurez besoin :** + + * **New Relic**: GUID d'entité pour monitoring + * **notification** (choisissez-en une ou les deux) : autorisations AWS SQS ou point de terminaison du webhook HTTP + + **Comment ça marche :** + + 1. Monitorer l'état de santé toutes les 1 à 5 minutes + 2. Évalue la gravité de l'alerte + 3. Envoie une notification (SQS/webhook) en cas de dégradation + 4. Consignez tous les contrôles de santé + 5. Continue jusqu'à son arrêt ou sa récupération + + + **À utiliser avec [suivi des changements](/docs/change-tracking/change-tracking-introduction)** pour corréler les problèmes avec la déploiement. + + + + + **Ce que cela fait :** + + Exécute une requête SQL sur le catalogue de données de New Relic à l'aide de NRLens (outil de requête avancé). + + **Quand l'utiliser :** + + Analyse complexe au-delà de NRQL: jointures multi-tables, analyses statistiques, rapports personnalisés combinant métriques/événement/log. + + **Ce dont vous aurez besoin :** + + * **NRLens**: Identifiants pour le Gateway de requêtes SQL + * **New Relic**: Identifiants d'organisation et de compte + + **Comment ça marche :** + + 1. Se connecte à NRLens + 2. Exécute des requêtes SQL + 3. Récupère les résultats + 4. Se connecter à New Relic + 5. Prend en charge la planification + + + **NRLens étend NRQL.** Utilisez NRQL pour les requêtes temps réel, NRLens SQL pour les charges de travail analytiques complexes. + + + + +## Prochaines étapes + +### Exécuter et gérer + +* **[Démarrer et planifier des workflows](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: déclenchement manuel ou planification automatique +* **[Gestion des workflows](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: Modifier, dupliquer ou supprimer des workflows + +### Créez un modèle personnalisé + +* **[Créez votre propre workflow](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: construisez-le à partir de zéro avec une logique personnalisée +* **[bonnes pratiques](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Patterns pour des automatisations fiables et prêtes pour la production + +### Échelle + +* **[API d'automatisation des workflows](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: Intégration avec CI/CD (intégration et livraison continue) ou infrastructure-as-code +* **[Limites du workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: délais d’attente, limites de débit, contraintes \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/introduction-to-workflow.mdx b/src/i18n/content/fr/docs/workflow-automation/introduction-to-workflow.mdx new file mode 100644 index 00000000000..23e8a17b705 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/introduction-to-workflow.mdx @@ -0,0 +1,148 @@ +--- +title: Introduction à l'automatisation des workflows +tags: + - workflow automation + - workflow + - automation +metaDescription: Automate routine tasks and incident responses with Workflow Automation in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +L'automatisation des workflows connecte New Relic à vos outils existants pour automatiser la réponse aux incidents, la gestion infrastructure et les tâches opérationnelles, sans écrire de code. Créez des workflows qui répondent aux alertes, s'intègrent à AWS et Slack, gèrent les approbations et exécutent une logique d'automatisation complexe. + +Screenshot showing the workflow automation interface + +## Principaux avantages + +* **Réponse plus rapide aux incidents**: redimensionnement automatique des instances EC2, restauration du déploiement ou redémarrage des services en cas d’alerte – aucune intervention manuelle requise +* **Connectez vos outils**: intégrez New Relic à AWS, Slack, Jira, ServiceNow et à toute API HTTP pour envoyer des données d’alerte enrichies là où votre équipe travaille. +* **Ajoutez des mécanismes d'approbation**: Intégrez une supervision humaine dans les workflows critiques — demandez la confirmation de l'équipe avant de faire évoluer infrastructure de production ou d'effectuer des restaurations. +* **Gérez la complexité**: utilisez la logique conditionnelle, les boucles et les transformations de données pour automatiser vos processus opérationnels uniques. + +## Cas d'utilisation courants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Catégorie + + Exemples +
+ **Réponse aux incidents** + + Résolution automatique des problèmes, restauration des déploiements ayant échoué, redimensionnement de infrastructure en fonction des alertes. +
+ **gestion des infrastructures** + + Faites évoluer les services selon des calendriers, gérez les ressources AWS, exécutez automatiquement les manuels d'exploitation. +
+ **Notifications** + + Envoyez des alertes enrichies à Slack, générez des rapports programmés, formatez les données au format CSV. +
+ **intégration** + + Connectez-vous à n'importe quelle API, synchronisez les données sur tout le système, mettez à jour la plateforme de tickets. +
+ +Consultez la page [d'exemples de workflow](/docs/workflow-automation/workflow-examples) pour découvrir des scénarios détaillés et des modèles prêts à l'emploi. + +## Démarrer + +Choisissez votre voie en fonction de ce que vous souhaitez construire : + + + + Utiliser un modèle Créer workflowpersonnalisé Configurer l'intégration + + + + + Déployez un workflow préconfiguré pour les scénarios courants : envoi de rapports à Slack, restauration du déploiement, redimensionnement des instances EC2, etc. + + 1. Parcourez [les modèles disponibles](/docs/workflow-automation/create-a-workflow-automation/use-a-template) + 2. Sélectionnez un modèle qui correspond à votre cas d'utilisation + 3. Configurer les entrées (identifiants, GUID d'entité, requête) + 4. déployer et tester + + + + Créez un workflow à partir de zéro à l'aide de l'interface glisser-déposer. Enchaînez les actions, ajoutez une logique conditionnelle et intégrez-les à vos outils. + + 1. Consultez l' [exemple de redimensionnement automatique d'EC2](/docs/workflow-automation/create-a-workflow-automation/create-your-own) + 2. Comprendre les modèles workflow (commutateurs, boucles, approbations) + 3. Parcourir [les actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)disponibles + 4. Construisez par étapes et testez chaque étape. + + + + Configurez les identifiants et le canal de notification pour que le workflow puisse interagir avec les services externes. + + **Workflow AWS**: [Configurer les informations d’identification AWS](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials) (rôles IAM, utilisateur ou jeton de session) + + **Notifications**: [Créer des destinations](/docs/workflow-automation/setup-and-configuration/create-destinations) (Slack, email, webhooks) + + + + +## Prochaines étapes + +Après avoir créé votre premier workflow, apprenez à le gérer et à l'optimiser : + + + + * **[Démarrez et planifiez des workflows](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: déclenchez-les manuellement ou configurez des exécutions récurrentes avec des expressions cron. + * **[Gestion du workflow](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: modification de la configuration, duplication pour différents environnements, historique d’exécution du moniteur + + + + * **[dépannage](/docs/workflow-automation/troubleshooting)**: Correction des erreurs d'identification, des problèmes d'intégration et des échecs workflow + * **[Bonnes pratiques](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Gestion des erreurs, optimisation des performances, stratégies de tests + * **[Limites du workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprendre les délais d’expiration, les limites de débit et les contraintes + + + + * **[Catalogue des actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: Parcourez toutes les actions AWS, New Relic et HTTP disponibles + * **[Exemples de workflow](/docs/workflow-automation/workflow-examples)**: Apprenez de scénarios d’automatisation réels + * **[API de workflow](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: Gérer le workflow par programmation pour l'intégration CI/CD (intégration et livraison continue) + + \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx b/src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx new file mode 100644 index 00000000000..cbedccb82d5 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx @@ -0,0 +1,326 @@ +--- +title: Automatisation du workflow bonnes pratiques +tags: + - Workflow Automation + - workflow + - best practices + - workflow automation best practices +metaDescription: 'Build reliable, maintainable workflows that handle errors gracefully and scale with your operations.' +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Mettez en place un workflow fiable qui gère les erreurs avec élégance, protège les données sensibles et s'adapte à la croissance de vos opérations. Suivez ces modèles pour créer des automatisations faciles à maintenir. + +## Workflow axé sur la conception + +Veillez à ce que le workflow soit concentré sur une seule responsabilité. Regroupez les actions similaires, mais évitez de combiner des tâches sans rapport. + +### Un seul workflow, un seul objectif + +**À faire**: Créer un workflow distinct pour la réponse aux incidents et la maintenance planifiée. **À ne pas faire**: Combiner le redimensionnement EC2, les sauvegardes de données de base et les notifications Slack dans un seul workflow. + +### Réutiliser le workflow avec des paramètres + +Utilisez des paramètres d'entrée pour rendre le workflow réutilisable dans différents environnements au lieu de le dupliquer. + +**Exemple**: Un workflow de redimensionnement EC2 avec paramètres de région et de type d'instance : + +```yaml +inputs: + awsRegion: us-east-1 + instanceType: t3.medium + instanceId: i-1234567890abcdef0 +``` + +Cela remplace la création d'un workflow distinct pour chaque région ou instance de type d'. + +### Combiner les actions connexes + +Actions de groupe connexes qui doivent être exécutées ensemble : + +* **Effectuer**: demander les détails de l'alerte, formater le message, l'envoyer à Slack en une seule workflow +* **À éviter**: Créer un workflow distinct pour « demander une alerte », « formater le message », « envoyer sur Slack ». + +## Gérer les erreurs + +Incluez toujours la gestion des erreurs pour les appels d'API externes et les opérations critiques. + +### Ajouter des actions de repli + +Lorsque des étapes critiques peuvent échouer, prévoyez des actions de repli qui informent votre équipe. + +**Exemple**: Envoyer une notification Slack même si une étape échoue en utilisant `ignoreErrors`: + +```yaml +- name: sendNotification + type: action + action: aws.execute.api + version: 1 + ignoreErrors: true + inputs: + service: sqs + api: send_message + parameters: + MessageBody: "Rollback notification" + QueueUrl: "${{ .workflowInputs.queueUrl }}" + +- name: logResult + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Notification sent: ${{ .steps.sendNotification.outputs.success }}" +``` + +Utilisez `ignoreErrors: true` pour poursuivre l'exécution workflow même si une étape échoue. + +### Définissez des délais d'expiration appropriés + +Définissez des délais d'attente pour les appels d'API externes afin d'éviter le blocage du workflow : + +* Appel d'API AWS : 30 à 60 secondes +* requête de base de données : 10-30 secondes +* requests HTTP : 15 à 30 secondes +* Messages Slack : 10 secondes + +### Les logs des erreurs pour le dépannage + +Veuillez inclure ces détails dans les logs des erreurs : + +* Action qui a échoué +* Paramètres d'entrée +* message d'erreur du service +* horodatage + +## Identifiants sécurisés + +Stockez toutes les données sensibles dans le gestionnaire de secrets de New Relic. Ne jamais intégrer en dur les informations d'identification dans les définitions workflow. + +### Utiliser le gestionnaire de secrets + +Stockez les identifiants AWS, les jetons API et les mots de passe : + +```graphql +mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } +} +``` + +Secrets de référence : `${{ :secrets:awsAccessKeyId }}` + +### Renouvelez régulièrement vos identifiants. + +Si vous utilisez des clés d'accès utilisateur IAM : + +* Rotation tous les 90 jours minimum +* Configurer des rappels dans le calendrier +* Testez les nouveaux identifiants avant de supprimer les anciens. + +**Recommandation**: Utilisez plutôt les rôles IAM — ils sont automatiquement renouvelés. + +### Utiliser les permissions minimales + +N'accordez que les autorisations requises. Commencez par un accès en lecture seule, n'ajoutez les autorisations d'écriture qu'en cas de besoin. + +**Exemple de stratégie AWS IAM** pour SQS : + +```json +{ + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-queue" +} +``` + +Cela limite l'accès à une file d'attente spécifique. + +## Test avant production + +Tester le workflow en environnement hors production avant de le déployer en production. + +### Duplicata pour les tests + +Créer des versions de test du workflow de production : + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Trouvez le workflow et cliquez sur le menu « Plus d'options ». +3. Sélectionner **Duplicate** +4. Mettez à jour vos identifiants pour utiliser les comptes de test. +5. Test avec des ressources hors production + +### Scénarios d'échec des tests + +Vérifier les échecs de gestion du workflow : + +* Que se passe-t-il si l'API AWS est indisponible ? +* Que se passe-t-il si Slack est hors service ? +* Que se passe-t-il si les identifiants expirent ? +* Que se passe-t-il si une ressource requise n'existe pas ? + +### Vérifier l'intégration + +Avant de planifier, déclenchez manuellement le workflow et vérifiez : + +* Les actions AWS s'exécutent avec succès +* Les messages Slack apparaissent dans les canaux appropriés. +* Les barrières d'approbation attendent des réponses. +* La gestion des erreurs fonctionne comme prévu + +## Optimiser les performances + +Mettez en place un workflow efficace qui s'exécute rapidement. + +### Une seule requête, réutilisation des résultats + +Stockez les résultats de la requête et consultez-les à plusieurs reprises : + +```yaml +- name: getAlertDetails + action: newrelic.nerdgraph.execute + +- name: sendToSlack + inputs: + text: "${{ .steps.getAlertDetails.outputs.data }}" + +- name: updateJira + inputs: + body: "${{ .steps.getAlertDetails.outputs.data }}" +``` + +**À éviter**: demander les détails des alertes séparément pour Slack et Jira. + +## Monitorer et maintenir + +Monitorez régulièrement l'exécution workflow et maintenez-le à jour. + +### Vérifier l'historique d'exécution chaque semaine + +Exécution workflow de révision : + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Sélectionnez le workflow +3. Cliquez sur **Run history** +4. Recherchez les échecs d'exécution ou les temps d'exécution croissants. + +### Configurer les alertes de panne + +Configurer les alertes en cas d'échec workflow : + +1. Créer une condition d'alerte pour les échecs d'exécution workflow +2. Envoyer une notification au canal principal de l'équipe +3. Inclure le nom workflow et les détails de l'erreur + +### Examiner le workflow trimestriellement + +Configurez des rappels récurrents dans votre calendrier : + +* Supprimer le workflow inutilisé +* Mettre à jour les informations d'identification expirantes +* Vérifiez que les API des services intégrés n'ont pas été modifiées. +* Scénarios d'échec des tests +* Mise à jour de la documentation + +## Workflow documentaire + +Simplifiez le workflow. + +### Utilisez des noms descriptifs + +* **Faites**: « Redimensionnement automatique des instances EC2 en cas d'alertes de forte utilisation du processeur » +* **À éviter**: « workflow 1 » ou « EC2 Automation ». + +### Rédigez des descriptions claires + +Expliquez quoi, quand et qui : + +``` +Automatically resizes EC2 instances when CPU exceeds 90% for 10 minutes. +Requires approval via Slack before executing changes. +Owner: DevOps Team (devops@example.com) +Last updated: 2025-01-26 +``` + +### Ajoutez des commentaires pour les logiques complexes + +Lorsque vous utilisez une logique conditionnelle ou des boucles, expliquez la logique : + +```yaml +- name: checkCPU + # Query CPU for last 10 minutes to avoid false positives + type: action + action: newrelic.nerdgraph.execute + version: 1 + +- name: decideAction + # If CPU > 90%: resize, 70-90%: warn, < 70%: no action + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.result > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.result > 70 }}" + next: sendWarning + next: noAction +``` + +## Sécurité + +Protéger les workflows et les ressources auxquelles ils accèdent. + +### Utiliser des mécanismes d'approbation pour les opérations destructives + +Exiger une approbation humaine avant : + +* Suppression des ressources +* Réduction des services de production +* Retour à l'application +* Modification des autorisations IAM + +### modifications workflow d'audit + +Utilisez l'historique des versions pour suivre les modifications : + +1. Accéder aux détails workflow +2. Cliquez sur **Version history** +3. Examiner les modifications et leurs auteurs + +### Restreindre l'accès workflow + +Assurez-vous que seuls les membres autorisés de l'équipe puissent modifier le workflow : + +1. Vérifier le rôle d'utilisateur dans les paramètres du compte +2. Limiter les autorisations de modification à l'équipe DevOps +3. Utilisez des comptes distincts pour la production et les tests. + +## Prochaines étapes + +**Comprendre les limites :** + +* **[Limites du workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits)** - Contraintes de délai d'expiration, d'action et de charge utile + +**Résolution des problèmes :** + +* **[Dépannage](/docs/workflow-automation/troubleshooting)** - Solutions aux problèmes courants + +**Voir des exemples :** + +* **[Exemples de workflow](/docs/workflow-automation/workflow-examples)** - Scénarios d'automatisation concrets + +**Gérer le workflow :** + +* **[Gestion du workflow](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)** - Éditer, dupliquer et monitorer vos workflows d'édition \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx b/src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx new file mode 100644 index 00000000000..2f92c42e4d9 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx @@ -0,0 +1,201 @@ +--- +title: limites de l'automatisation des workflows +metaDescription: 'For New Relic Workflow automation, explanations of the Workflow automation limits.' +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Quoi + + Min + + Max +
+ taille de sortie de l'action + + + + 100 Ko +
+ tentatives de nouvelle action + + + + 3 +
+ Définition du workflow : nombre total d'étapes + + 1 + + 100 +
+ taille de définition du workflow + + + + 50 Ko +
+ Nombre de définitions de workflow + + + + 1000 +
+ durée du workflow + + + + 7 jours +
+ Exécution du workflow : nombre total d'étapes + + + + 5000 +
+ Nombre de programmes + + + + 10 +
+ Longueur d'une valeur d'entrée workflow + + + + 1000 caractères +
+ Exécutions simultanées du workflow (par compte) + + + + 30 +
+ taille du signal d'entrée + + + + 10 Ko +
+ Nombre de conditions dans l'étape de commutation + + + + 10 +
+ Nombre de signaux dans l'étape d'attente + + + + 10 +
+ +## Quelle est la prochaine étape ? + +Vous comprenez les limites techniques. Explorez maintenant des méthodes de programmation pour gérer votre workflow à grande échelle. + +**Prochaine étape de votre parcours**: [API d’automatisation des workflows](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api) – Apprenez à créer, gérer et exécuter des workflows par programmation. + +**Ressources supplémentaires**: + +* [Catalogue des actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) - Référence complète de toutes les actions +* [bonnes pratiques](/docs/workflow-automation/limitations-and-faq/workflow-best-practices) - Réviser les techniques d'optimisation \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx new file mode 100644 index 00000000000..c2c5d653315 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx @@ -0,0 +1,41 @@ +--- +title: Aperçu du catalogue Actions +tags: + - workflow automation + - workflow + - workflow automation actions + - actions catalog +metaDescription: List of available actions catalog for workflow definition +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Le catalogue d'actions New Relic propose des actions pouvant être effectuées sur votre infrastructure et votre intégration. Vous pouvez orchestrer et automatiser vos processus de bout en bout en reliant des actions qui effectuent des tâches chez vos fournisseurs de cloud et dans vos comptes New Relic. + +## Catalogues d'actions disponibles [#available-catalogs] + +Les catalogues d'actions suivants sont disponibles pour l'automatisation workflow : + +* [Actions AWS](/docs/workflow-automation/setup-and-configuration/actions-catalog/aws) - Intégration avec les services AWS, notamment Lambda, EC2 et SystemManager +* [Actions de communication](/docs/workflow-automation/setup-and-configuration/actions-catalog/communication) - Envoyer des notifications et des messages via différents canaux de communication +* [Actions HTTP](/docs/workflow-automation/setup-and-configuration/actions-catalog/http) - Effectuer requests HTTP vers des API et services externes +* [Actions New Relic](/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic) - Interagir avec les fonctionnalités et les données de la plateforme New Relic +* [ActionsPagerDuty ](/docs/workflow-automation/setup-and-configuration/actions-catalog/pagerduty)- Gérer l'incident et l'intégration PagerDuty +* [Actions utilitaires](/docs/workflow-automation/setup-and-configuration/actions-catalog/others) - Effectuer des opérations courantes de transformation et d'utilitaires de données + +## Quelle est la prochaine étape ? + +Vous avez vu toutes les actions disponibles. Il est maintenant temps de les assembler et de construire votre premier workflow. + +**Prochaine étape de votre parcours**: [Gestion des workflows](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) – Apprenez à créer, gérer et exécuter des workflows dans New Relic. + +**Commencez la construction**: + +* [Utilisez un modèle workflow ](/docs/workflow-automation/create-a-workflow-automation/use-a-template)- Démarrage rapide avec un workflow préconfiguré +* [Créez votre propre workflow](/docs/workflow-automation/create-a-workflow-automation/create-your-own) - Concevez un workflow personnalisé à partir de zéro \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx new file mode 100644 index 00000000000..f2e65e111fa --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx @@ -0,0 +1,704 @@ +--- +title: Actions de communication +tags: + - workflow automation + - workflow + - workflow automation actions + - communication actions + - slack actions + - ms teams actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Cette page fournit une référence complète des actions de communication disponibles dans le catalogue des actions d'automatisation workflow. Ces actions vous permettent d'intégrer une plateforme de communication à vos définitions workflow, notamment en envoyant des messages aux canaux Slack, en récupérant les réactions, et bien plus encore. + +## Prérequis + +Avant d'utiliser des actions de communication dans l'automatisation workflow, assurez-vous de disposer de : + +* Un espace de travail Slack avec les autorisations appropriées. +* Un bot Slack configuré comme secret dans l'automatisation workflow. +* Accès aux canaux Slack dans lesquels vous souhaitez envoyer des messages. + +Consultez la section [« Ajouter une configuration Slack »](/docs/autoflow/overview#add-the-slack-integration) pour plus d'informations sur la configuration de l'intégration Slack. + +## Actions de communication disponibles + +Référence rapide de toutes les actions de communication par plateforme : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ plateforme + + Action + + But +
+ **Mou** + + [Publier un message](#slackchatpostmessage) + + Envoyer des messages vers les canaux Slack avec pièces jointes facultatives. +
+ **Mou** + + [Obtenir des réactions](#slackchatgetreactions) + + Récupérer les réactions emoji des messages Slack. +
+ +## Actions Slack + + + + Envoie un message vers un canal Slack, avec une pièce jointe facultative. + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Exemple +
+ **jeton** + + Requis + + secrète + + `${{ :secrets:slackToken }}` +
+ **canal** + + Requis + + chaîne + + `my-slack-channel` +
+ **texte** + + Requis + + chaîne + + `Hello World!` +
+ **filTs** + + Facultatif + + chaîne + + `.` +
+ **pièce jointe** + + Facultatif + + carte + +
+ **pièce jointe.nom_de_fichier** + + Requis + + chaîne + + `file.txt` +
+ **pièce jointe.contenu** + + Requis + + chaîne + + `Hello\nWorld!` +
+ + + * **token**: Le bot Slack jeton à utiliser. Cela devrait être transmis comme une syntaxe secrète. Consultez la section [« Ajouter une configuration Slack »](/docs/autoflow/overview#add-the-slack-integration) pour obtenir des instructions sur la configuration d'un jeton. + * **channel**: Le nom du canal, ou un identifiant de canal, sur lequel envoyer le message. Consultez [l'API Slack](https://api.slack.com/methods/chat.postMessage#arg_channel/) pour plus d'informations. + * **text**: Le message à publier sur Slack dans le `channel` spécifié. + * **threadTs**: horodatage appartenant au message parent, utilisé pour créer une réponse à un message dans un fil de discussion. + * **attachment**: Autoriser la pièce jointe d'un fichier avec un message sur le `channel` spécifié. + * **attachment.filename**: Spécifiez le nom du fichier téléchargé dans Slack. + * **attachment.content**: Le contenu du fichier à télécharger au format UTF-8. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Exemple +
+ **filTs** + + chaîne + + `.` +
+ **ID du canal** + + chaîne + + `` +
+ + + * **threadTs**: horodatage du message. Peut être utilisé dans de futurs appels postMessage pour publier une réponse dans un fil de discussion. + * **channelID**: Identifiant du canal où le message est publié. + + + + + **Exemple 1 : Publier un message sur un canal Slack** + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: SendMessage + + steps: + - name: send_slack_message + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: ${{ .workflowInputs.channel }} + text: ${{ .workflowInputs.text }} + ``` + + **Entrées attendues :** + + ```json + { + "inputs": [ + { + "key" : "channel", + "value" : "my-channel" + }, + { + "key" : "text", + "value" : "This is my message *with bold text* and `code backticks`" + } + ] + } + ``` + + **Résultat attendu :** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + **Exemple 2 : Joindre un fichier** + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: SendFileMessage + + steps: + - name: postCsv + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: my-channel + text: "Please find the attached file:" + attachment: + filename: 'file.txt' + content: "Hello\nWorld!" + ``` + + **Résultat attendu :** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + + + + + + + + Obtenir une réaction à un message provenant d'un canal Slack. + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Exemple +
+ **jeton** + + Requis + + secrète + + `${{ :secrets:slackToken }}` +
+ **ID du canal** + + Requis + + chaîne + + `C063JK1RHN1` +
+ **temps mort** + + Facultatif + + int + + 60 +
+ **filTs** + + Requis + + chaîne + + `.` +
+ **sélecteurs** + + Facultatif + + liste + + `[{\"name\": \"reactions\", \"expression\": \".reactions \"}]` +
+ + + * **token**: Le bot Slack jeton à utiliser. Cela devrait être transmis comme une syntaxe secrète. Consultez la section [« Ajouter une configuration Slack »](/docs/autoflow/overview#add-the-slack-integration) pour obtenir des instructions sur la configuration d'un jeton. + * **channelID**: L'identifiant du canal permettant d'obtenir les réactions aux messages. + * **timeout**: Durée en secondes pendant laquelle il faut attendre une réaction. La valeur par défaut est de 60 secondes, la valeur maximale autorisée est de 600 secondes (10 minutes). + * **threadTs**: horodatage associé au message, utilisé pour obtenir la réaction à ce message. + * **selectors**: Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Exemple +
+ **réactions** + + liste + + `` +
+ + + * **reactions**: Liste des éléments contenant toutes les réactions capturées ou une liste vide en cas de dépassement de délai. + + + + + **Exemple 1 : Slack obtient des réactions** + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: GetReactions + + steps: + - name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channelID: ${{ .steps.promptUser.outputs.channelID }} + threadTs: ${{ .steps.promptUser.outputs.threadTs }} + timeout: ${{ .workflowInputs.timeout }} + selectors: ${{ .workflowInputs.selectors }} + ``` + + **Entrées attendues :** + + ```json + { + "inputs": [ + { + "key" : "channelID", + "value" : "C063JK1RHN1" + }, + { + "key" : "threadTs", + "value" : "1718897637.400609" + }, + { + "key" : "selectors", + "value" : "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" + } + ] + } + ``` + + **Résultat attendu :** + + ```json + [ + { + "name": "grinning", + "users": [ + "W222222" + ], + "count": 1 + }, + { + "name": "question", + "users": [ + "W333333" + ], + "count": 1 + } + ] + ``` + + Ou si le délai est dépassé : + + ```json + [] + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx new file mode 100644 index 00000000000..f14c7b293b6 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx @@ -0,0 +1,1103 @@ +--- +title: actions HTTP +tags: + - workflow automation + - workflow + - workflow automation actions + - HTTP actions +metaDescription: A list of available HTTP actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Cette page fournit une référence complète des actions HTTP disponibles dans le catalogue des actions d'automatisation workflow. Ces actions vous permettent d'effectuer requests HTTP (GET, POST, PUT, DELETE) vers des API et des services externes dans le cadre de vos définitions workflow. + +## Prérequis + +Avant d'utiliser les actions HTTP dans l'automatisation workflow, assurez-vous de disposer de : + +* cible points de terminaison d'API URLs. +* Toutes les informations d'identification d'authentification requises (clé API, jeton, etc.). +* Compréhension des formats de requête/réponse de l'API. + + + Les actions HTTP prennent en charge la syntaxe secrète pour toute valeur d'en-tête, vous permettant de transmettre en toute sécurité des données sensibles telles que l'API clé. Consultez [la section Gestion des secrets](/docs/infrastructure/host-integrations/installation/secrets-management/) pour plus d'informations. + + +## Actions HTTP disponibles + +Référence rapide de toutes les actions HTTP : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Action + + But +
+ [requête GET](#httpget) + + Récupérer des données à partir d'un point de terminaison d'API. +
+ [Requête POST](#httppost) + + Envoyer les données à un point de terminaison d'API. +
+ [Requête PUT](#httpput) + + Mettre à jour les données aux points de terminaison d'API. +
+ [Demande de suppression](#httpdelete) + + Supprimer les données aux points de terminaison d'API. +
+ +## actions HTTP + + + + Effectuez un appel HTTP GET pour récupérer des données à partir d'un point de terminaison d'API. + + + Cela prend en charge la syntaxe secrète pour toute valeur d'en-tête. + + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Description +
+ **url** + + Requis + + Chaîne + + L'URL cible de la requête. Le dispositif doit être inclus : + + `https://example.com` +
+ **urlParams** + + Facultatif + + Carte + + Les paramètres de requête à ajouter à l'URL. Prend un objet JSON converti en chaîne de caractères. +
+ **en-têtes** + + Facultatif + + Carte + + Les en-têtes à ajouter à la requête. Prend un objet JSON converti en chaîne de caractères. +
+ **sélecteurs** + + Facultatif + + List + + Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Description +
+ **corps de réponse** + + Chaîne + + Le corps de la réponse. +
+ **code d'état** + + Entier + + Le code d'état HTTP de la réponse. +
+ + + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: httpGetTest + description: 'Performs an HTTP GET request to retrieve data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + steps: + - name: query + type: action + action: http.get + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + next: end + ``` + + **Exemples d'entrées :** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}" + } + ``` + + **Exemples de résultats :** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + + + Effectue un appel HTTP POST pour envoyer des données à un point de terminaison d'API. + + + Cela prend en charge la syntaxe secrète pour toute valeur d'en-tête. + + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Description +
+ **url** + + Requis + + Chaîne + + L'URL cible de la requête. Le dispositif doit être inclus : + + `https://example.com` +
+ **urlParams** + + Facultatif + + Carte + + Les paramètres de requête à ajouter à l'URL. Prend un objet JSON converti en chaîne de caractères. +
+ **en-têtes** + + Facultatif + + Carte + + Les en-têtes à ajouter à la requête. Prend un objet JSON converti en chaîne de caractères. +
+ **corps** + + Facultatif + + Chaîne + + Le corps de la requête. +
+ **sélecteurs** + + Facultatif + + List + + Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Description +
+ **corps de réponse** + + Chaîne + + Le corps de la réponse. +
+ **code d'état** + + Entier + + Le code d'état HTTP de la réponse. +
+ + + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: httpPostTest + description: 'Performs an HTTP POST request to send data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + steps: + - name: query + type: action + action: http.post + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + next: end + ``` + + **Exemples d'entrées :** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}" + } + ``` + + **Exemples de résultats :** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + Effectue une requête HTTP PUT pour mettre à jour les données à un point de terminaison d'API. + + + Si vous devez transmettre des données sensibles à une entrée, par exemple un en-tête `Api-Key`, vous pouvez utiliser les valeurs stockées via la mutation NerdGraph [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql). + + Exemple: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Description +
+ **url** + + Requis + + Chaîne + + L'URL cible de la requête. L'URL doit inclure le schéma (par exemple, https:// ou http://). Exemple: + + `https://example.com` +
+ **urlParams** + + Facultatif + + Carte + + Les paramètres de requête à ajouter à l'URL. Prend un objet JSON converti en chaîne de caractères. +
+ **en-têtes** + + Facultatif + + Carte + + Les en-têtes à ajouter à la requête. Prend un objet JSON converti en chaîne de caractères. +
+ **corps** + + Facultatif + + Chaîne + + Le corps de la requête. +
+ **sélecteurs** + + Facultatif + + List + + Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Description +
+ **corps de réponse** + + Chaîne + + Le corps de la réponse. +
+ **code d'état** + + Entier + + Le code d'état HTTP de la réponse. +
+ + + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: httpPutTest + description: 'Performs an HTTP PUT request to update data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.put + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **Exemples d'entrées :** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **Exemples de résultats :** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + Effectue une requête HTTP DELETE pour supprimer des données à un point de terminaison d'API. + + + Si vous devez transmettre des données sensibles à une entrée, par exemple un en-tête `Api-Key`, vous pouvez utiliser les valeurs stockées via la mutation NerdGraph [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql). + + Exemple: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Description +
+ **url** + + Requis + + Chaîne + + L'URL cible de la requête. L'URL doit inclure le schéma (par exemple, https:// ou http://). Exemple: + + `https://example.com` +
+ **urlParams** + + Facultatif + + Carte + + Les paramètres de requête à ajouter à l'URL. Prend un objet JSON converti en chaîne de caractères. +
+ **en-têtes** + + Facultatif + + Carte + + Les en-têtes à ajouter à la requête. Prend un objet JSON converti en chaîne de caractères. +
+ **sélecteurs** + + Facultatif + + List + + Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Description +
+ **corps de réponse** + + Chaîne + + Le corps de la réponse. +
+ **code d'état** + + Entier + + Le code d'état HTTP de la réponse. +
+ + + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: httpDeleteTest + description: 'Performs an HTTP DELETE request to remove data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.delete + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **Exemples d'entrées :** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **Exemples de résultats :** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx new file mode 100644 index 00000000000..c1b772faf29 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx @@ -0,0 +1,1212 @@ +--- +title: Actions de New Relic +tags: + - workflow automation + - workflow + - workflow automation actions + - New relic actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Cette page fournit une référence complète des actions New Relic disponibles dans le catalogue des actions d'automatisation workflow. Ces actions vous permettent d'intégrer les fonctionnalités de la plateforme New Relic dans vos définitions workflow, notamment l'envoi d'événements personnalisés et de logs, l'exécution de requêtes NerdGraph, l'exécution de requêtes NRQL et l'envoi de notifications. + +## Prérequis + +Avant d'utiliser les actions New Relic dans l'automatisation workflow, assurez-vous de disposer de : + +* Un compte New Relic disposant des autorisations appropriées. +* Une clé de licence New Relic (si vous envoyez des données vers un compte différent). +* Les autorisations nécessaires pour les services New Relic spécifiques que vous prévoyez d'utiliser. + +Consultez [la clé de licence](/docs/apis/intro-apis/new-relic-api-keys/#license-key) pour obtenir des informations sur la façon de créer et de gérer votre compte New Relic. + +## Actions New Relic disponibles + +Guide rapide de toutes les actions de New Relic par catégorie : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Catégorie + + Action + + But +
+ **Ingestion de données** + + [Envoyer un événement personnalisé](#newrelicingestsendevents) + + Envoyer un événement personnalisé à New Relic. +
+ **Ingestion de données** + + [Envoyer les logs](#newrelicingestsendlogs) + + Envoyer les données log à New Relic. +
+ **NerdGraph** + + [Exécuter une requête ou une mutation GraphQL](#newrelicnerdgraphexecute) + + Exécuter des commandes GraphQL sur l'API NerdGraph. +
+ **Qequête** + + [Exécuter une requête NRDB](#newrelicnrdbquery) + + Exécuter la requête NRQL inter-comptes. +
+ **Notifications** + + [Envoyer une notification](#newrelicnotificationsend) + + Envoyer une notification aux destinations New Relic. +
+ +## actions d'ingestion de données + + + + Envoie un événement personnalisé à New Relic + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Exemple +
+ **attributes** + + Facultatif + + carte + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **événement** + + Requis + + liste + + `"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]` +
+ **clé de licence** + + Facultatif + + chaîne + + `"{{ .secrets.secretName }}"` +
+ **sélecteurs** + + Facultatif + + liste + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: Attribut commun qui fait partie de tous les événements lorsqu'il est fourni. Fusion pour chaque élément d'événement lorsque cela est nécessaire, l'élément d'événement remplace la définition commune. + * **events**: La liste des données d'événement. Notez que l'événement nécessite l'utilisation d'un champ `eventType` qui représente le type d'événement personnalisé et que le nombre maximal d'événements autorisés par requête est de 100. + * **licenseKey**: La clé de licence du compte New Relic qui spécifie le compte cible où les événements sont envoyés. Si cette valeur n’est pas fournie, une clé de licence par défaut est supposée en fonction du compte exécutant le workflow. + * **selectors**: Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Exemple +
+ **succès** + + Booléen + + `true` +
+ **message d'erreur** + + chaîne + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: heartbeat_newrelicIngestSendEvents + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendEvents + version: 1 + inputs: + attributes: + colour: red + id: 1234 + events: + - eventType: HeartBeat + test: "OK" + attributes: + foo: bar + - eventType: HeartBeat1234 + test: "OK1234" + attributes: + foo: bar + - eventType: HeartBeat12345 + test: "OK12345" + attributes: + foo: bar + colour: yellow + - eventType: HeartBeat12345678 + test: "OK12345678" + selectors: + - name: success + expression: ".success" + ``` + + **Résultat attendu :** + + ```yaml + { + "success": true + } + ``` + + **Récupérer l'événement :** + + Une fois un workflow exécuté avec succès, vous pouvez récupérer l'événement associé en exécutant une requête sous le compte qui a exécuté le workflow: + + ```sql + SELECT * FROM HeartBeat + ``` +
+ + + + + + + + + Envoyer les logs à New Relic + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de saisie + + optionnalité + + Type + + Exemple +
+ **attributes** + + Facultatif + + carte + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **logs** + + Requis + + liste + + `"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"` +
+ **clé de licence** + + Facultatif + + chaîne + + `"{{ .secrets.secretName }}"` +
+ **sélecteurs** + + Facultatif + + liste + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: Attribut commun inclus dans tous les logs lorsqu'il est fourni. Si un élément log spécifie le même attribut, il remplace la définition commune. + * **logs**: La liste des données log. Notez que le nombre maximal des logs d'entrées autorisé par requête est de 100. + * **licenseKey**: La clé de licence du compte New Relic qui spécifie le compte cible où les logs sont envoyés. Si aucune clé de licence n’est fournie, une clé de licence par défaut est supposée en fonction du compte exécutant le workflow. Consultez [la clé de licence](/docs/apis/intro-apis/new-relic-api-keys/#license-key) pour plus d'informations. + * **selectors**: Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ de sortie + + Type + + Exemple +
+ **succès** + + Booléen + + `true` +
+ **message d'erreur** + + chaîne + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ Exemple de workflow +
+ ```yaml + name: heartbeat_newrelicIngestSendLogs + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + attributes: + colour: red + id: 1234 + logs: + - message: 'Heartbeat sendLogs Action Test Message' + attributes: + foo: bar + - message: 'HeartBeat1234' + attributes: + foo: bar + - message: 'HeartBeat12345' + attributes: + foo: bar + colour: yellow + - message: 'HeartBeat12345678' + selectors: + - name: success + expression: ".success" + ``` + + **Résultat attendu :** + + ```yaml + { + "success": true + } + ``` + + **Récupérer les logs :** + + Une fois un workflow exécuté avec succès, vous pouvez récupérer le log associé en exécutant une requête sous le compte qui a exécuté le workflow: + + ```sql + SELECT * FROM Log + ``` +
+ + + + + + +## Actions NerdGraph + + + + Exécute une commande Graphql sur l'API New Relic NerdGraph. La commande peut être soit une requête, soit une mutation. + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Saisir + + optionnalité + + Type + + Description + + Exemple +
+ **graphql** + + Requis + + chaîne + + Une syntaxe GraphQL. Vous devriez utiliser GraphiQL pour construire et tester votre commande + +
+ **variables** + + Requis + + map[string]any + + Toutes les variables de type paire valeur-clé à utiliser avec l'instruction GraphQL. + +
+ **sélecteurs** + + Facultatif + + liste + + Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. + + ```yaml + { + "data": { + "actor": { + "user": { + "name": "" + } + } + } + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Sortir + + Type + + Exemple +
+ **données** + + map[string]any : Contenu de la propriété + + `data` + + d'une réponse NerdGraph. + + ```yaml + steps: + - name: currentUserId + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + graphql: | + query userId { + currentUser { + id + } + } + - name: sayHello + type: action + action: example.messaging.sayHello + version: 1 + inputs: + name: ${{ .steps.currentUserId.outputs.data.currentUser.id }} + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Exemple + + Sortir + + Récupérer l'événement +
+ ```json + name: testLog + + steps: + - name: logStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'Hello World' + ``` + + ```yaml + { + "success": true + } + ``` + + Vous pouvez récupérer l'événement associé en exécutant une requête sous le compte qui a exécuté le workflow. + + ```yaml + SELECT message FROM Log WHERE allColumnSearch('Hello World', insensitive: true) SINCE 30 minutes ago + ``` +
+ + + + + + +## Actions de requête + + + + Exécute une requête NRQL inter-comptes via l'API NerdGraph. + + + + + Entrées + + + + Sorties + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Saisir + + optionnalité + + Type + + Description + + Exemple +
+ **requête** + + Requis + + chaîne + + L'instruction de requête NRQL. + +
+ **identifiants de compte** + + Facultatif + + liste d'entiers + + Le champ + + **New Relic Account ID** + + est une liste d’identifiants cibles qui vous permet de spécifier les comptes cibles sur lesquels la requête est exécutée. Si cette valeur n'est pas fournie en entrée, la requête sera automatiquement exécutée sur le compte associé au compte d'exécution du workflow. + +
+ **sélecteurs** + + Facultatif + + liste + + Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. + + ```json + steps: + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + accountIds: [12345] + query: FROM Log SELECT * WHERE message LIKE 'DEMO%' + selectors: + - name: resultsAsString + expression: '.results | tostring' + ``` +
+ + + + + + + + + + + + + + + + + + + + + +
+ Sortir + + Type + + Exemple +
+ **results** + + : Un éventail d'objets contenant les résultats de la requête. + + + + ```yaml + { + results=[ + { message=[INFO] - Workflow: test has ended, messageId=39af98 }, + { message=[INFO] - Workflow: test - Step query has started, messageId=649c612 }, + ... + ] + } + ``` +
+ + + + + + +## Actions de notification + + + + Envoie un message à un canal, intégré à des destinations comme Slack par exemple. + + + + + Entrées + + + + Sorties + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Saisir + + optionnalité + + Type + + Description + + Exemple +
+ **type** + + Requis + + chaîne + + Type de destination New Relic + + `slack` +
+ **destinationId** + + Requis + + Chaîne + + DestinationId associé à la destination New Relic. + + `123e4567-e89b-12d3-a456-426614174000` +
+ **paramètres** + + Requis + + carte + + Champs requis pour envoyer une notification au type de destination choisi. + + `{\"channel\": \"${{ YOUR_CHANNEL }}\", \"text\": \"Enter your text here\"}` +
+ **sélecteurs** + + Facultatif + + liste + + Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie. + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Sortir + + Type + + Exemple +
+ succès + + booléen + + `true/false` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx new file mode 100644 index 00000000000..760ebfcc4a0 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx @@ -0,0 +1,684 @@ +--- +title: Actions utilitaires +tags: + - workflow automation + - workflow + - workflow automation actions + - utility actions +metaDescription: A list of available utility actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + +Cette page fournit une référence pour les actions utilitaires disponibles dans le catalogue des actions d'automatisation workflow. Ces actions vous permettent d'effectuer des opérations courantes de transformation et d'utilisation des données dans vos définitions workflow. + +## Actions utilitaires disponibles + +Référence rapide de toutes les actions utilitaires : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Action + + But +
+ [Mise à jour de la date et de l'heure à partir de l'époque](#utils.datetime.fromEpoch) + + Convertir l'horodatage Unix au format date/heure. +
+ [Convertir en CSV](#utils.transform.toCSV) + + Convertir les données au format CSV. +
+ [Générer un UUID](#utils.uuid.generate) + + Générer un UUID V4 conforme à la RFC. +
+ +## Actions utilitaires + + + + Cette action permet de convertir un horodatage Unix en date/heure. Références possibles : + + * [https://en.wikipedia.org/wiki/List\_of\_tz\_database\_time\_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) + * [https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT\_IDS](https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT_IDS) + + Consultez [fromEpoch](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html) pour plus d'informations. + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Saisir + + optionnalité + + Type + + Description +
+ **horodatage** + + Requis + + int + + Un entier représentant l'horodatage de l'époque. Notez que les époques UNIX correspondent au nombre de secondes écoulées depuis le 1er janvier 1970 à minuit UTC (00:00). +
+ **horodatageUnité** + + Facultatif + + chaîne + + Une chaîne de caractères représentant l'unité de l'horodatage fourni. Valeurs acceptables : SECONDES, MILLISECONDES (PAR DÉFAUT) +
+ **fuseau horaireId** + + Facultatif + + chaîne + + Chaîne de caractères représentant le fuseau horaire de la date et de l'heure souhaitées (par défaut : UTC). +
+ **modèle** + + Facultatif + + chaîne + + Chaîne de caractères représentant le format de date et d'heure souhaité, par défaut : ISO-8601 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ + + optionnalité + + Type de données + + Description +
+ **date** + + Requis + + chaîne + + Représentation sous forme de chaîne de caractères de la date. +
+ **temps** + + Requis + + chaîne + + Une représentation sous forme de chaîne de caractères du temps. +
+ **date et heure** + + Requis + + chaîne + + Représentation sous forme de chaîne de caractères d'une date et heure. +
+ **fuseau horaire** + + Requis + + carte + + Représentation cartographique de l'identifiant et de l'abréviation du fuseau horaire. +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Exemple + + Workflow Entrée + + Sorties +
+ ```yaml + name: from_epoch + + workflowInputs: + timestamp: + type: Int + timestampUnit: + type: String + timezoneId: + type: String + pattern: + type: String + + steps: + - name: epochTime + type: action + action: utils.datetime.fromEpoch + version: 1 + inputs: + timestamp: ${{ .workflowInputs.timestamp }} + timezoneId: ${{ .workflowInputs.timezoneId }} + pattern: ${{ .workflowInputs.pattern }} + timestampUnit: ${{ .workflowInputs.timestampUnit }} + ``` + + ```json + mutation { + workflowAutomationStartWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { name: "from_epoch" } + workflowInputs: [ + {key: "timestamp", value: "1738236424003"} + {key: "timestampUnit", value: "MILLISECONDS"} + {key: "pattern", value: "yyyy-mm-dd HH:SS"} + {key: "timezoneId", value: "Asia/Kolkata"} + ] + ) { + runId + } + } + ``` + + ```json + { + "date": "2025-01-30", + "time": "16:57:04.003" + "datetime": "2025-01-30 16:00", + "timezone": { + "abbreviation": "IST", + "id": "Asia/Kolkata" + } + } + ``` +
+ + + + + + + + + Cette action permet de transformer différents types d'entrées (JSON, map) au format CSV. + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Saisir + + optionnalité + + Type + + Description +
+ **données** + + Requis + + n'importe lequel + + Une chaîne de caractères représentant des données à transformer en CSV, généralement une chaîne JSON ou une carte. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Champ + + optionnalité + + Type de données + + Description +
+ **csv** + + Requis + + chaîne + + Une représentation CSV des données reçues. +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Exemple + + Workflow Entrée + + Sorties +
+ ```json + name: nrqltocsv + + steps: + - name: queryForLog + type: action + action: newrelic.nrql.query + version: 1 + inputs: + accountIds: ['${{ .workflowInputs.accountId }}'] + query: ${{ .workflowInputs.nrql }} + + - name: csv1 + type: action + action: utils.transform.toCSV + version: 1 + inputs: + data: ${{ .steps.queryForLog.outputs.results | tostring }} + ``` + + ```json + mutation { + startWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { + name: "nrqltocsv", + } + workflowInputs: [ + {key: "accountId" value: "12345678"} + {key: "nrql" value: "FROM TransactionError SELECT error.message, error.class, transactionName, request.uri, query WHERE appName like 'my-app-1%' AND error.expected IS FALSE SINCE 1 hour ago LIMIT 50"} + ] + ) + { runId } + } + ``` + +
+ + + + + + + + + Générer un UUID V4 conforme à la RFC. + + + + + Entrées + + + + Sorties + + + + Exemple + + + + + + + + + + + + + + + + + + + + + + +
+ Saisir + + optionnalité + + Type de données + + Description +
+ + + + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Champ + + Type de données + + Description +
+ **uuid** + + chaîne + +
+ + + + + + + + + + + + + + + + + + + + + +
+ Exemple + + Workflow Entrée + + Sorties +
+ + + nom : générerUUID
mesures: + + * nom : generateUUID type : action action : utils.uuid.generate version : 1 + 		+ ```json + { + "uuid": "c76bd606-5eaa-42bb-a847-4221fb49f83c", + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx new file mode 100644 index 00000000000..b7d140087b2 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx @@ -0,0 +1,91 @@ +--- +title: Envoyer une notification depuis le workflow +tags: + - workflow automation + - workflow + - notifications + - slack + - pagerduty +metaDescription: 'Configure workflows to send notifications via Slack, PagerDuty, email, or webhooks when automation tasks complete or fail.' +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Le workflow peut envoyer des notifications à votre équipe via Slack, PagerDuty, par e-mail ou via des webhooks personnalisés. Utilisez les notifications pour alerter les équipes lorsque le workflow est terminé, échoue ou nécessite une approbation. + +## Choisissez votre canal de notification + +Sélectionnez le canal adapté à votre cas d'utilisation : + +| **Canal** | **Idéal pour** | **Complexité de la configuration** | **Caractéristiques** | +| ------------- | ----------------------------------------- | ----------------------------------------- | ------------------------------------------------ | +| **Mou** | Collaboration d'équipe, approbations | Facile - nécessite un jeton de bot | Messages enrichis, réactions, fils de discussion | +| **PagerDuty** | Gestion des incidents, astreinte | Facile – nécessite une clé API | Politiques d'escalade, suivi incident | +| **E-mail** | Notification officielle, rapports | Facile - configurationSMTP | Pièces jointes, formatage HTML | +| **Webhooks** | intégration personnalisée | Moyen - nécessite un point de terminaison | Charge flexible, tout système | + +## Avant de commencer + +Avant de configurer les notifications, assurez-vous d'avoir : + +* Un workflow créé dans votre compte (à partir d' [un modèle](/docs/workflow-automation/create-a-workflow-automation/use-a-template) ou [personnalisé](/docs/workflow-automation/create-a-workflow-automation/create-your-own)). +* Identifiants pour votre canal de notification (jeton du bot Slack, clé API PagerDuty, etc.). +* Identifiants stockés dans [le gestionnaire de secrets](/docs/infrastructure/host-integrations/installation/secrets-management/). + +## Définir une destination [#set-the-destination] + +1. Accédez à **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Destinations** et sélectionnez **Workflow Automation**. + +2. Pour configurer l'automatisation du workflow, saisissez les informations requises, telles que le **nom de destination de l'automatisation du workflow** (un nom unique pour l'automatisation du workflow) et l' **API Key**. + +3. Cliquez sur **Save destination**. + + Image of the Workflow Automation destination page. + +## Créer un notification workflow [#create-the-notification-workflow] + +1. Rendez-vous sur **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Notification Workflows** et sélectionnez **+ Add a workflow**. + +2. Pour configurer votre workflow notification, sur la page Configurer votre workflow notification, fournissez les informations requises : + + * Saisissez un nom unique que vous reconnaîtrez. + * Sélectionnez l'attribut **Tag**, **Policy** et **Priority** dans leurs listes respectives dans l'option de filtre **Basic** pour recevoir une notification concernant un incident, ou optez pour l'option de filtre **Advanced** pour choisir **Attributes**, **Operators** et **Values** pour une notification incident plus détaillée. + * Cliquez sur **Additional settings** pour enrichir vos données en créant [une requêteNRQL ](/docs/alerts/get-notified/incident-workflows/#enrichments)afin de collecter des données connexes provenant de l’ensemble de votre plateforme New Relic. Pour des exemples d'enrichissement, voir [enrichissement des données de workflow](/docs/alerts/get-notified/custom-variables-incident-workflows/#enrichment-examples). + +3. Pour spécifier les destinations de notification, dans la section **Notify**, choisissez une ou plusieurs [**destinations**](/docs/alerts/get-notified/destinations). + +4. Voici un exemple : pour envoyer des notifications à un groupe [Slack](/docs/alerts/get-notified/notification-integrations/#slack), sélectionnez **Slack** comme type de destination. + + 1. Sélectionnez **Slack destination** dans la liste déroulante. + 2. Sélectionnez la **Channel** dans la liste déroulante et cochez la case **Receive notification updates on the channel**. + 3. Vous pouvez ajouter un message personnalisé dans la section **Custom Details**. + + + Nous vous recommandons d'envoyer une notification de test via **Send test notification**. + + + 4. Sélectionnez **Save message**. + +5. Pour tester l'automatisation workflow, sélectionnez **Test workflow**. Cette fonction utilise les données existantes de votre compte pour vérifier la configuration et envoie une notification d'exemple pour s'assurer qu'elle parvienne au groupe Slack. + +6. Sélectionnez **Activate workflow**. + + Image of how to configure a workflow + +## Quelle est la prochaine étape ? + +Vous avez configuré vos destinations de notification. Explorez maintenant toutes les actions disponibles pour créer un workflow performant. + +**Prochaine étape**: [Catalogue des actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) - Parcourez toutes les actions disponibles pour AWS, New Relic et l'intégration. + +**Prêt à construire ?** + +* [Utilisez un modèle workflow ](/docs/workflow-automation/create-a-workflow-automation/use-a-template)- Commencez par un workflow préconfiguré +* [Créez votre propre workflow](/docs/workflow-automation/create-a-workflow-automation/create-your-own) - Construisez-le à partir de zéro +* [Gestion des workflows](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) - Découvrez le dashboard workflow \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx new file mode 100644 index 00000000000..95e8e1aa489 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx @@ -0,0 +1,465 @@ +--- +title: Configurer les identifiants AWS +metaDescription: 'Configure AWS credentials for workflow automation using IAM roles, IAM users, or temporary session tokens.' +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Autorisez l'automatisation workflow New Relic à effectuer des actions dans votre compte AWS. Vous configurerez une méthode d'authentification permettant au workflow d'interagir en toute sécurité avec les services AWS tels que EC2, SQS, DynamoDB et bien plus encore, sans intégrer en dur les informations d'identification ni compromettre la sécurité. + +## Prérequis + +Avant de configurer vos identifiants AWS, assurez-vous d'avoir : + +* Un compte AWS disposant de l'autorisation de créer des rôles IAM ou des utilisateurs. +* Votre [identifiant de compte New Relic](/docs/accounts/accounts-billing/account-structure/account-id). +* Accès administrateur à la [console AWS IAM](https://console.aws.amazon.com/iam/). + +## Comprendre les autorisations requises [#required-permissions] + +Avant de créer des identifiants, assurez-vous de bien comprendre les autorisations nécessaires à votre workflow. N’accordez que les autorisations réellement utilisées par votre workflow – cela respecte le principe du moindre privilège et minimise les risques de sécurité. + +### Autorisations workflow communes + +| **Type de workflow** | **Autorisations AWS requises** | **Description** | +| ---------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | +| **Gestion EC2** | `ec2:DescribeInstances`
`ec2:StopInstances`
`ec2:StartInstances`
`ec2:ModifyInstanceAttribute` | Arrêter, démarrer ou modifier les instances EC2 en réponse aux alertes | +| **Messagerie SQS** | `sqs:SendMessage`
`sqs:GetQueueAttributes` | Envoyer des messages aux files d'attente SQS pour traitement en aval | +| **Passerelle API** | `apigateway:GET`
`apigateway:PUT` | Rétablir le déploiement ou la configuration du Gateway API | +| **Gestionnaire de systèmes** | `ssm:CreateDocument`
`ssm:DeleteDocument`
`ssm:StartAutomationExecution`
`ssm:GetAutomationExecution` | Exécuter les manuels d'exécution automatisés | +| **DynamoDB** | `dynamodb:Query`
`dynamodb:GetItem`
`dynamodb:PutItem` | Lire ou écrire dans des tables DynamoDB | + + + Commencez par des permissions de lecture seule (`Describe*`, `Get*`, `List*`), puis ajoutez des permissions d'écriture (`Put*`, `Create*`, `Delete*`) uniquement lorsque cela est nécessaire. Cela permet d'éviter les actions destructives accidentelles lors des tests. + + +Consultez [les exemples de politiques](#policy-examples) ci-dessous pour obtenir des modèles de politiques IAM complets. + +## Configurer l'authentification + +Choisissez la méthode qui correspond à votre cas d'utilisation dans le tableau ci-dessus : + + + + Rôle IAM (recommandé) Utilisateur IAM avec clés d'accès Session jeton + + + + + Un rôle IAM permet à New Relic d'utiliser des informations d'identification temporaires dans votre compte AWS sans nécessiter de clés d'accès permanentes. + + **Caractéristiques du rôle IAM :** + + * Les identifiants sont renouvelés automatiquement. + * L'accès est limité dans le temps par conception. + * Toutes les actions sont enregistrées dans AWS CloudTrail + * Conforme aux bonnes pratiques de sécurité AWS + + ### Créez le rôle dans AWS + + 1. Connectez-vous à la [console AWS IAM](https://console.aws.amazon.com/iam/) + 2. Accédez à **Roles > Create role > Trusted entity type** et sélectionnez **AWS account > another AWS account** + 3. Dans le champ **Account ID**, saisissez : `253490767857` + 4. Dans **Options**, cochez la case **Require external ID.** + 5. Dans le champ **External ID**, saisissez l'ID de votre compte New Relic et cliquez sur **Next**. + + * Vous ne l'avez pas ? [Trouvez votre identifiant de compte ici](/docs/accounts/accounts-billing/account-structure/account-id) + + 6. Sur la page **Add permissions**, associez des stratégies en fonction de votre workflow : + + * Pour le workflow EC2 : Attachez `AmazonEC2ReadOnlyAccess` ou créez une stratégie personnalisée + * Pour le workflow SQS : Attachez `AmazonSQSFullAccess` ou limitez-le à des files d’attente spécifiques. + * Pour les autres services : consultez [la section « Autorisations AWS requises »](#required-aws-permissions) ci-dessous. + + 7. Cliquez sur **Next**. + 8. Saisissez un nom de rôle : `NewRelicWorkflowAutomationRole` (ou le nom de votre choix) + 9. Ajoutez éventuellement une description : « Permet à l’automatisation de workflows de New Relic d’effectuer des actions dans AWS », puis cliquez sur **Create role**. + + ### Vérifiez la politique de fiducie + + Après avoir créé le rôle, vérifiez la relation de confiance : + + 1. Dans la console IAM, sélectionnez le rôle que vous venez de créer. + 2. Cliquez sur l'onglet **Trust relationships** + 3. Veuillez vérifier que la politique correspond à cette structure (remplacez `` par votre identifiant de compte réel) : + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sts:AssumeRole", + "Principal": { + "AWS": "arn:aws:iam::253490767857:root" + }, + "Condition": { + "StringEquals": { + "sts:ExternalId": "" + } + } + } + ] + } + ``` + + ### Copiez votre ARN de rôle + + Vous aurez besoin de l'ARN du rôle pour configurer le workflow : + + 1. Dans la console IAM, sélectionnez votre rôle + 2. Dans la section **Summary**, repérez le champ **ARN** + 3. Copiez l'ARN complet ; il ressemble à ceci : `arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole` + 4. Enregistrez cet ARN en lieu sûr ; vous le collerez directement dans la configuration workflow. + + + **Important :** Les ARN des rôles doivent être directement intégrés aux entrées workflow ; ne les stockez pas dans le gestionnaire de secrets. Ce ne sont pas des identifiants sensibles ; ce sont des identifiants de ressource. + + + Le rôle est maintenant configuré. Utilisez l'ARN dans la configuration workflow qui nécessite un accès AWS. + + + + Utilisez cette méthode pour les environnements de test ou lorsque les rôles IAM ne sont pas pris en charge. Les clés d'accès sont des identifiants à longue durée de vie qui nécessitent une rotation manuelle. + + **Cas d'utilisation :** + + * Environnements de test et de développement + * Configurations AWS ne prenant pas en charge l'attribution de rôles entre comptes + * Flux d'authentification simplifié + + + Les clés d'accès sont des identifiants à longue durée de vie. Faites-les tourner régulièrement (tous les 90 jours) et limitez les autorisations à ce dont votre workflow a besoin. + + + ### Créer l'utilisateur IAM + + 1. Connectez-vous à la [console AWS IAM](https://console.aws.amazon.com/iam/) + 2. Accédez à **Users > Create user** et saisissez un nom d'utilisateur : `workflow-automation-user` (ou le nom de votre choix) + 3. Cliquez sur **Next** + 4. Sur la page **Set permissions**, choisissez **Attach policies directly** + 5. Recherchez et sélectionnez les politiques en fonction de votre workflow : + + * Pour SQS : Sélectionnez `AmazonSQSFullAccess` + * Pour EC2 : sélectionnez `AmazonEC2ReadOnlyAccess` + * Ou créez une politique personnalisée avec des autorisations limitées (recommandé). + + 6. Cliquez sur **Next**, puis sur **Create user** + + ### Générer des clés d'accès + + 1. Dans la liste des utilisateurs, sélectionnez votre utilisateur nouvellement créé. + 2. Cliquez sur l'onglet **Security credentials** + 3. Dans la section **Access keys**, choisissez **Create access key** + 4. Sélectionnez **Application running outside AWS** et cliquez sur **Next**. + 5. (Facultatif) Ajouter une tag de description : « Automatisation workflow New Relic » + 6. Choisissez **Create access key** + 7. Copiez immédiatement les deux identifiants : + + * **Identifiant de la clé d'accès** (commence par `AKIA...`) + * **Clé d'accès secrète** (affichée une seule fois) + + + AWS n'affiche la clé d'accès secrète qu'une seule fois, lors de la création. Si vous ne l'enregistrez pas, vous devrez générer une nouvelle paire de clés. + + + ### Stockez vos identifiants en toute sécurité + + Ne jamais intégrer en dur les identifiants AWS dans un workflow. Stockez-les plutôt dans [le gestionnaire de secrets](/docs/infrastructure/host-integrations/installation/secrets-management/) de New Relic. + + 1. Ouvrez l' [explorateur GraphiQL de NerdGraph](https://one.newrelic.com/nerdgraph-graphiql) + 2. Exécutez cette mutation pour enregistrer votre ID de clé d'accès (remplacez les valeurs d'espace réservé) : + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } + } + ``` + + 3. Exécutez une autre mutation pour votre clé d'accès secrète : + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsSecretAccessKey" + description: "AWS Secret Access Key for workflow automation" + value: "YOUR_AWS_SECRET_ACCESS_KEY" + ) { + key + } + } + ``` + + **Référencez ces secrets dans votre workflow** en utilisant la syntaxe suivante : `${{ :secrets:awsAccessKeyId }}` + + + Utilisez le champ `namespace` pour organiser les secrets par environnement (`aws-prod`, `aws-staging`) ou par nom d'équipe. + + + + + Session Jeton fournit des identifiants temporaires avec expiration automatique. + + **Cas d'utilisation :** + + * Développement et tests locaux + * pipeline CI/CD nécessitant une rotation des identifiants + * Environnements soumis à des exigences de conformité en matière d'accès limité dans le temps (généralement de 1 à 12 heures) + + **Prérequis :** + + * [AWS CLI installé et configuré](https://aws.amazon.com/cli/) + * Un rôle IAM existant que vous pouvez assumer + + ### Générer des identifiants temporaires + + 1. Ouvrez votre terminal et exécutez cette commande (remplacez par l'ARN de votre rôle) : + + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` + + Si vous utilisez AWS CLI pour la première fois, vous devrez peut-être la configurer avec `aws configure` et saisir vos informations d'identification : + + Image of the Static Access credentials + + 2. AWS renvoie trois valeurs ; vous avez besoin des trois : + + ```json + { + "Credentials": { + "AccessKeyId": "ASIAIOSFODNN7EXAMPLE", + "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", + "SessionToken": "FQoGZXIvYXdzEBk...", + "Expiration": "2025-01-25T12:00:00Z" + } + } + ``` + + 3. Stockez les trois identifiants dans le gestionnaire de secrets : + + * `AccessKeyId` stocker comme `awsAccessKeyId` + * `SecretAccessKey` stocker comme `awsSecretAccessKey` + * `SessionToken` stocker comme `awsSessionToken` + + + La session expire (généralement après 1 heure). Programmez un rappel pour les actualiser avant l'horodatage `Expiration`, sinon votre workflow échouera avec des erreurs d'authentification. + + + + + +## Utiliser les informations d'identification dans le workflow [#use-credentials] + +Après avoir configuré l'authentification, indiquez vos informations d'identification dans la configuration workflow : + +### Rôle IAM (recommandé) + +Collez directement l'ARN du rôle dans les entrées workflow ; aucun gestionnaire de secrets n'est nécessaire : + +```yaml +awsRoleArn: arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole +``` + + + Les ARN de rôle sont des identifiants de ressource, et non des informations d'identification sensibles. Ne les stockez pas dans le gestionnaire de secrets ; collez-les directement dans la configuration workflow. + + +### IAM utilisateur ou session jeton + +Gestionnaire de secrets de référence pour les clés d'accès : + +```yaml +awsAccessKeyId: ${{ :secrets:awsAccessKeyId }} +awsSecretAccessKey: ${{ :secrets:awsSecretAccessKey }} +awsSessionToken: ${{ :secrets:awsSessionToken }} # Only for session tokens +``` + +New Relic récupère les secrets lors de l'exécution, s'authentifie auprès d'AWS, puis les supprime. Vos identifiants n'apparaissent jamais dans les logs ou l'historique workflow. + +## Exemples de politiques [#policy-examples] + +Utilisez ces modèles de stratégie IAM complets pour les types workflow courants. Chacune applique le principe du moindre privilège en limitant l'accès à des ressources spécifiques. + + + + Restreindre l'accès à une file d'attente spécifique : + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + }, + { + "Effect": "Allow", + "Action": "sqs:GetQueueAttributes", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + } + ] + } + ``` + + Remplacez `us-west-2` par votre région, `123456789012` par l'ID de votre compte AWS et `my-workflow-queue` par le nom de votre file d'attente. + + + + Restreindre l'accès à une instance spécifique par tag: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ec2:DescribeInstances", + "ec2:DescribeTags" + ], + "Resource": "*" + }, + { + "Effect": "Allow", + "Action": [ + "ec2:StopInstances", + "ec2:StartInstances", + "ec2:ModifyInstanceAttribute" + ], + "Resource": "arn:aws:ec2:us-east-1:123456789012:instance/*", + "Condition": { + "StringEquals": { + "aws:ResourceTag/Environment": "production" + } + } + } + ] + } + ``` + + Cette politique permet au workflow d'arrêter/démarrer/modifier uniquement les instances EC2 étiquetées avec `Environment=production`. + + + + Restreindre l'accès à une table spécifique : + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "dynamodb:Query", + "dynamodb:GetItem", + "dynamodb:PutItem" + ], + "Resource": "arn:aws:dynamodb:us-east-1:123456789012:table/WorkflowData" + } + ] + } + ``` + + Remplacez `WorkflowData` par le nom de votre table. + + + + Limiter l'accès à certains documents d'automatisation : + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument" + ], + "Resource": "arn:aws:ssm:us-east-1:123456789012:document/WorkflowAutomation-*" + }, + { + "Effect": "Allow", + "Action": [ + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": [ + "arn:aws:ssm:us-east-1:123456789012:automation-definition/WorkflowAutomation-*:*", + "arn:aws:ssm:us-east-1:123456789012:automation-execution/*" + ] + } + ] + } + ``` + + Cela limite les documents d'automatisation à ceux préfixés par `WorkflowAutomation-`. + + + + Restreindre l'accès à une API spécifique : + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "apigateway:GET", + "apigateway:PUT" + ], + "Resource": "arn:aws:apigateway:us-west-2::/restapis/abc123xyz/*" + } + ] + } + ``` + + Remplacez `abc123xyz` par votre ID de Gateway API. + + + +### Ressources supplémentaires + +Pour une documentation complète sur les autorisations AWS : + +* **[Politiques d'intégration AWS gérées](/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies/)**: liste complète des autorisations AWS par service, ainsi que des modèles CloudFormation adaptables. +* **[Configurer l'interrogation d'API AWS](/docs/infrastructure/amazon-integrations/connect/set-up-aws-api-polling/)**: Modèles de configuration supplémentaires + + + Ces ressources utilisent l'ID de compte `754728514883` pour l'intégration cloud (monitoring). Pour l'automatisation workflow, utilisez toujours `253490767857`. + + +## Prochaines étapes + +Après avoir configuré les informations d'identification AWS, vous pouvez créer un workflow : + +**Créer un workflow :** + +1. **[Parcourez les actions AWS](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: consultez les opérations AWS disponibles (EC2, SQS, DynamoDB, etc.). +2. **[Utilisez un modèle](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: déployez un workflow préconfiguré pour les tâches d'automatisation AWS courantes. +3. **[Créer un workflowpersonnalisé](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: Concevez un workflow adapté à vos besoins spécifiques. + +**Configurer la notification :** + +* **[Configurer les destinations](/docs/workflow-automation/setup-and-configuration/create-destinations)**: Configurer les notifications Slack, PagerDuty, par e-mail ou par webhook pour les événements workflow \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/troubleshooting.mdx b/src/i18n/content/fr/docs/workflow-automation/troubleshooting.mdx new file mode 100644 index 00000000000..c95306d0c6f --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/troubleshooting.mdx @@ -0,0 +1,386 @@ +--- +title: Dépannage de l'automatisation des workflows +tags: + - workflow automation + - troubleshooting + - workflow errors +metaDescription: 'Common issues and solutions for Workflow Automation including AWS credentials, workflow execution, and dashboard problems.' +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Cette page propose des solutions aux problèmes courants que vous pourriez rencontrer lors de l'utilisation de l'automatisation des workflows. Pour obtenir de l'aide supplémentaire, consultez le [forum d'assistance de New Relic](https://discuss.newrelic.com/) ou contactez [l'assistance de New Relic](https://support.newrelic.com/). + +## Identifiants et authentification AWS + + + + **Problème :** Votre workflow échoue en raison d’une erreur d’autorisation AWS. + + **Solutions :** + + 1. **Vérifiez l'identifiant de votre compte :** assurez-vous d'avoir utilisé `253490767857` (et non `754728514883`) dans la politique de confiance. L'ID du compte cloud d'intégration (`754728514883`) est différent de l'ID du compte d'automatisation workflow. + 2. **Vérifiez l'ID externe :** assurez-vous que l'ID externe de votre politique de confiance correspond exactement à l'ID de votre compte New Relic (disponible dans [les paramètres du compte](/docs/accounts/accounts-billing/account-structure/account-id)). + 3. **Vérifiez les autorisations :** assurez-vous que votre rôle IAM ou votre utilisateur dispose des autorisations AWS spécifiques requises par votre workflow. Consultez le tableau [des autorisations AWS requises](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials#required-aws-permissions). + 4. **Testez avec l'interface de ligne de commande AWS :** exécutez `aws sts assume-role` localement pour vérifier que le rôle peut être assumé : + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/NewRelicWorkflowAutomationRole" \ + --role-session-name "TestSession" \ + --external-id "YOUR_NR_ACCOUNT_ID" + ``` + + + +### « Jeton invalide » ou identifiants expirés + +**Problème :** le workflow a échoué en raison d’erreurs d’expiration Jeton. + +**Solutions :** + +1. **Pour les jetons de session :** vérifiez la durée d'expiration — les jetons de session durent généralement de 1 à 12 heures. Générez-en de nouveaux avant leur expiration en utilisant : + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` +2. **Pour les clés d'accès :** vérifiez que l'ID de clé d'accès et la clé d'accès secrète sont correctement enregistrés dans le gestionnaire de secrets. Revérifiez les valeurs dans [l'explorateur NerdGraph GraphiQL](https://one.newrelic.com/nerdgraph-graphiql). +3. **Vérifiez la syntaxe des secrets :** assurez-vous d’utiliser le format `${{ :secrets:keyName }}` et non `${{ secrets.keyName }}`. Le préfixe deux-points (`:secrets:`) est requis. + +### Impossible de trouver mon rôle ARN + +**Problème :** Vous avez besoin de l’ARN mais vous ne parvenez pas à le localiser dans AWS. + +**Solution:** + +1. Connectez-vous à la [console AWS IAM](https://console.aws.amazon.com/iam/) +2. Choisissez **Roles** dans le menu de navigation +3. Recherchez le nom de votre rôle (par exemple, `NewRelicWorkflowAutomationRole`) +4. Sélectionnez le rôle — l’ARN apparaît dans la section Résumé +5. Le format ARN est : `arn:aws:iam:::role/` + +### Le workflow ne peut pas accéder à certaines ressources AWS. + +**Problème :** Votre rôle dispose des autorisations nécessaires, mais le workflow ne peut toujours pas accéder à certaines ressources. + +**Solutions :** + +1. **Autorisations au niveau des ressources :** vérifiez si votre stratégie IAM restreint l’accès à des ARN de ressources spécifiques. Vous devrez peut-être ajouter un caractère générique (`*`) pour les tests, puis limiter l'accès à des ressources spécifiques. + ```json + { + "Effect": "Allow", + "Action": "ec2:DescribeInstances", + "Resource": "*" // Change from specific ARN to * for testing + } + ``` +2. **Politiques de contrôle des services (SCP) :** si vous êtes dans une organisation AWS, les SCP peuvent bloquer certaines actions. Contactez votre administrateur AWS pour consulter les politiques de votre organisation. +3. **Incompatibilité de région :** assurez-vous que vos autorisations IAM spécifient la région AWS correcte où se trouvent vos ressources. Mettez à jour le paramètre `awsRegion` du workflow pour qu'il corresponde à l'emplacement de votre ressource. + +## problèmes d'exécution du workflow + +### Guide de dépannage rapide + +Utilisez ce tableau pour un diagnostic rapide des problèmes courants workflow : + +| **Symptôme** | **Vérifier** | **Solution** | +| ---------------------------------------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | +| Le workflow échoue à une étape spécifique | Consultez les logs d'exécution pour obtenir le message d'erreur. | Corrigez la configuration, les identifiants ou les données d'entrée pour cette action. | +| Le workflow s'exécute mais produit des résultats incorrects | Vérifier le passage des données entre les étapes | Vérifier la syntaxe du modèle `${{ .steps.name.outputs.field }}` | +| workflow planifié ne s'exécute pas. | Consultez l'historique d'exécution pour les exécutions ignorées. | Vérifier configuration de la planification et l'état workflow (Actif) | +| Le workflow expire | Vérifier la durée d'exécution | Réduisez la fréquence d'interrogation ou divisez le workflow en plus petits | +| Les modifications ne sont pas prises en compte. | Consulter l'historique des versions | Mettez à jour les exécutions planifiées pour utiliser la nouvelle version. | + +Pour des instructions détaillées sur la consultation des logs et de l'historique d'exécution, voir [les exécutions workflow du moniteur](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs). + +### Le workflow affiche l'état « Échec ». + +**Problème :** Un workflow apparaît avec le statut « Échec » dans le dashboard. + +**Solutions :** + +1. **Consultez l'historique d'exécution**: + + * Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + * Cliquez sur le nom workflow + * Consultez **Run history** pour voir quelle exécution a échoué. + +2. **Revoir les logs d'exécution **: + + * Cliquez sur **View logs** de l’exécution ayant échoué pour identifier l’action spécifique qui a échoué. + * Recherchez les messages d'erreur indiquant la cause première + +3. **Causes fréquentes**: + + * **Identifiants invalides**: jeton expiré, syntaxe des secrets incorrecte ou clés secrètes erronées + * **Autorisations manquantes**: autorisations AWS IAM insuffisantes, étendues d’accès au bot Slack ou accès à l’API insuffisants + * **Modifications apportées aux ressources cibles**: instances EC2 supprimées, canaux Slack supprimés ou base de données renommée + * **Limites de débit de l'API dépassées**: Trop de requests vers des services externes (AWS, Slack, etc.). + * **Délais d'attente réseau**: les API externes mettent trop de temps à répondre. + +4. **Correction et nouvelle exécution**: Après avoir résolu le problème, déclenchez manuellement le workflow à l’aide de l’ [API StartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) pour vérifier son bon fonctionnement. + +### L'exécution du workflow prend trop de temps. + +**Problème :** les exécutions du workflow dépassent la durée prévue ou expirent. + +**Solutions :** + +1. **Analyse de la séquence d'actions**: Consultez les logs pour identifier les actions lentes. Recherchez les actions dont le temps d'exécution est supérieur à 30 secondes. + +2. **Optimisation des requêtes**: Si vous utilisez des requêtes NRQL, optimisez-les pour de meilleures performances : + + * Ajoutez des plages horaires spécifiques au lieu d'interroger toutes les données. + * Utilisez `LIMIT` pour réduire la taille de l'ensemble de résultats + * Filtrer tôt avec des clauses `WHERE` + +3. **Vérifiez les API externes**: des réponses lentes des services intégrés (AWS, Slack) peuvent retarder l’exécution. Tester séparément les temps de réponse de l'API. + +4. **Tenez compte des limites workflow **: examinez [les limitesworkflow ](/docs/workflow-automation/limitations-and-faq/workflow-limits)pour les contraintes de délai d'expiration (généralement 15 minutes par workflow). + +5. **Décomposez les workflows en processus plus courts**: Divisez les workflows complexes en automatisations plus petites et ciblées pouvant s’exécuter en parallèle. + +### Les modifications apportées au workflow ne sont pas prises en compte. + +**Problème :** Vous avez modifié un workflow, mais les modifications ne sont pas prises en compte lors de son exécution. + +**Solutions :** + +1. **Vérifiez que vous avez enregistré**: Assurez-vous d'avoir cliqué sur **Save** après avoir modifié la configuration workflow. + +2. **Vérifiez la version**: + + * Accéder aux détails workflow + * Cliquez sur l'onglet **Version history** + * Assurez-vous que vos dernières modifications apparaissent comme une nouvelle version + * Vérifiez que cette version est bien active. + +3. **Mise à jour des exécutions planifiées**: si le workflow s’exécute selon une planification, mettez à jour cette planification pour utiliser la nouvelle version : + + * Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + * Trouver les courses programmées + * Mettez à jour le planning pour qu'il prenne en compte la nouvelle version workflow + +4. **Vider le cache**: La mise en cache Browser peut afficher une ancienne configuration— actualisez la page (Ctrl+Maj+R ou Cmd+Maj+R). + +## Problèmes dashboard du workflow + +### Impossible de trouver un workflow dans le dashboard + +**Problème :** Le workflow que vous avez créé n’apparaît pas dans la liste dashboard. + +**Solutions :** + +1. **Vérifier les filtres**: + + * Cliquez sur la liste déroulante des filtres + * Sélectionnez « Tous » pour les filtres d'état + * Effacer la barre de recherche + +2. **Vérifier le compte**: Confirmez que vous êtes connecté au compte New Relic correct sur lequel le workflow a été créé. Consultez le sélecteur de compte en haut à droite. + +3. **Vérifiez les autorisations**: assurez-vous que votre rôle d'utilisateur a accès à la visualisation du workflow. Contactez votre administrateur New Relic si vous avez besoin d'autorisations d'accès workflow. + +4. **Actualisez la page**: la mise en cache Browser peut parfois masquer les modifications récentes. Essayez une actualisation forcée (Ctrl+Maj+R ou Cmd+Maj+R). + +### Impossible de supprimer un workflow + +**Problème :** L’option Supprimer est grisée ou la suppression échoue. + +**Solutions :** + +1. **Vérifier les autorisations**: Vérifiez que votre rôle d'utilisateur dispose des autorisations de suppression pour le workflow. Contactez l'administrateur de votre compte si nécessaire. + +2. **Arrêter les exécutions planifiées**: Annulez toutes les exécutions planifiées actives avant de les supprimer : + + * Accédez aux détails workflow + * Accédez à l'onglet **Scheduled runs** + * Annuler tous les horaires actifs + +3. **Vérification des dépendances**: certains workflows ne peuvent pas être supprimés si d’autres automatisations en dépendent. Vérifiez si le workflow est référencé par : + + * D'autres workflows l'appellent ainsi. + * règle d'alerte qui le déclenche + * Système externe qui le démarre via API + +4. **Contactez l'assistance**: Si le problème persiste après avoir essayé les solutions ci-dessus, contactez [l'assistance New Relic](https://support.newrelic.com/) pour obtenir de l'aide. + +## Problèmes spécifiques à l'intégration + +### La notification Slack ne s'affiche pas + +**Problème :** le workflow s'exécute correctement, mais les messages Slack n'apparaissent pas. + +**Solutions :** + +1. **Vérifiez l'ID du canal**: Assurez-vous d'utiliser l' **ID** du canal Slack (par exemple, `C01234ABCD`), et non le nom du canal. Trouvez l'identifiant dans Slack : + + * Faites un clic droit sur le nom de la chaîne + * Sélectionnez **View channel details**. + * Copiez l'identifiant de la chaîne en bas. + +2. **Vérifiez les autorisations du bot**: assurez-vous que votre bot Slack dispose des autorisations suivantes : + + * `chat:write` - Publier des messages + * `channels:read` - Consulter les chaînes publiques + * `groups:read` - Afficher les chaînes privées (le cas échéant) + +3. **Vérifier que le bot est dans le canal**: Ajouter le bot au canal cible : + + * Tapez `/invite @YourBotName` dans le canal + * Vérifiez que le bot figure bien dans la liste des membres. + +4. **Vérifier le jeton dans les secrets**: Vérifiez que le jeton Slack stocké dans le gestionnaire de secrets est correct et n’a pas expiré. + +### Les opérations AWS système Manager échouent + +**Problème :** Les documents ou commandes d’automatisation SSM ne s’exécutent pas. + +**Solutions :** + +1. **Vérifiez les autorisations SSM**: assurez-vous que le rôle IAM dispose des autorisations suivantes : + ```json + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument", + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": "*" + } + ``` +2. **Vérification de l'agent SSM**: assurez-vous que l'agent SSM est installé et en cours d'exécution sur les instances EC2 cibles : + ```bash + aws ssm describe-instance-information --region us-east-1 + ``` +3. **Vérifiez le profil de l'instance**: les instances EC2 nécessitent un profil d'instance IAM avec des autorisations SSM pour exécuter des commandes. +4. **Vérifier l'existence du document**: Si vous utilisez un document SSM existant, vérifiez qu'il existe dans votre compte AWS et votre région. + +## Problèmes spécifiques au modèle + +### GUID d'entité introuvable + +**Problème :** Les modèles échouent avec `Entity not found` erreurs. + +**Solutions :** + +1. **Trouver le GUID d'entité correct**: + + * Accédez à la page de ressources du moniteur dans New Relic + * Vérifiez l'URL ou les métadonnées de l'entité pour le GUID + * Utilisez [la recherche d'entité](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic#find) pour localiser l'entité + +2. **Vérifiez que l'entité existe dans le compte approprié**: assurez-vous d'utiliser l'entité du même compte que celui où le workflow est déployé. + +3. **Vérifiez les données de l'entité**: assurez-vous que l'entité affiche **Last seen** récente (une entité obsolète a peut-être été supprimée). + +4. **Pour l'entité AWS**: Assurez-vous que [les intégrations](/docs/infrastructure/amazon-integrations/get-started/introduction-aws-integrations) sont actives + + + **Les GUID d'entité sont spécifiques à chaque compte.** Le déplacement du workflow entre les comptes nécessite la mise à jour de tous les GUID d'entité. + + +### La requête NRQL ne renvoie aucun résultat + +**Problème :** Les modèles utilisant la requête NRQL s’exécutent correctement mais renvoient des ensembles de données vides. + +**Solutions :** + +1. **Testez d'abord la requête**: utilisez [le générateur de requêtes](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) pour valider la requête avant de l'ajouter aux modèles + +2. **Vérifiez le type de données et les noms des événements**: + + * Utilisez `FROM Transaction`, et non `FROM Transactions` + * Vérifier que les noms des attributs correspondent exactement (sensible à la casse). + +3. **Ajuster les plages horaires**: Pour les données éparses, élargir la fenêtre temporelle : + + * Ajoutez `SINCE 1 hour ago` pour les données récentes + * Utilisez `SINCE 1 day ago` pour les tendances + +4. **Simplifiez et testez progressivement**: commencez par une requête de base, puis ajoutez les filtres un par un. + +5. **Vérifier [la syntaxe NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language)**: s’assurer que la structure de la requête correspond aux exigences NRQL + +### Le déploiement du modèle échoue + +**Problème :** Le modèle ne se déploie pas ou affiche des erreurs lors du déploiement. + +**Solutions :** + +1. **Vérifiez toutes les informations requises**: assurez-vous d’avoir rempli tous les champs obligatoires (identifiants, GUID, requête). +2. **Vérifiez le format des informations d'identification**: les secrets doivent utiliser le format `${{ :secrets:keyName }}` avec le préfixe deux-points. +3. **Testez les identifiants indépendamment**: avant le déploiement, testez les identifiants AWS avec l’interface de ligne de commande AWS et l’API Slack. +4. **Exigences relatives aux modèles de vérification**: Chaque modèle énumère des prérequis spécifiques ; assurez-vous qu’ils sont tous respectés. +5. **Vérifiez la présence de caractères spéciaux**: certains champs (noms de canaux, requêtes) peuvent ne pas fonctionner correctement avec des caractères spéciaux ; utilisez des caractères alphanumériques lorsque cela est possible. + +### Le flux d'approbation ne répond pas. + +**Problème :** les modèles nécessitant une approbation Slack (restauration d’API Gateway, redimensionnement d’EC2) ne détectent pas les réactions. + +**Solutions :** + +1. **Vérifier les portées des jetons du bot**: + + * `reactions:read` - Nécessaire pour détecter les réactions aux émojis + * `chat:write` - Obligatoire pour publier les messages d'approbation + +2. **Vérifiez le format de réaction**: utilisez l’emoji exact spécifié dans le workflow (généralement 👍 pour approuver, 👎 pour refuser). + +3. **Vérifiez les paramètres de délai d'expiration**: requests d'approbation expirent après le délai configuré (généralement 5 à 10 minutes). + +4. **Assurez-vous que le bot puisse lire les messages**: le bot doit être présent dans le canal et avoir l’autorisation de consulter l’historique des messages. + +5. **Test avec une approbation simple**: Créez un workflow de test avec uniquement la logique d’approbation pour isoler le problème. + +### Problèmes de gestion des instances EC2 + +**Problème :** le modèle EC2 ne parvient pas à redimensionner ou à gérer l’instance. + +**Solutions :** + +1. **Vérifiez que [les flux de métriques CloudWatch](/install/aws-cloudwatch/) sont configurés**: requis pour les métriques EC2 en temps réel. +2. **Vérifier que [l'intégration du monitoring EC2](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) est active**: garantit que les données de l'instance sont transmises à New Relic. +3. **Vérifier l'état instance **: l'instance doit être à l'état `running` ou `stopped` ; les états transitoires (en attente, en cours d'arrêt) entraînent des échecs. +4. **Vérifiez la compatibilité instance de type d'**: toutes instance de type d' ne prennent pas en charge toutes les opérations de redimensionnement. Consultez [la documentation AWS relative aux instance de type d'](https://aws.amazon.com/ec2/instance-types/). +5. **Vérifiez les autorisations d'arrêt/démarrage**: le rôle IAM nécessite `ec2:StopInstances` et `ec2:StartInstances` en plus de `ec2:ModifyInstanceAttribute` + +### Le modèle d'analyse JSON ne consigne pas les données. + +**Problème :** le modèle d’analyse JSON s’exécute correctement, mais aucune donnée n’apparaît dans les logs New Relic. + +**Solutions :** + +1. **Vérifier les points de terminaison d'API**: Tester l'URL de la page d'état dans un navigateur – s'assurer qu'elle renvoie un JSON valide +2. **Vérifiez la structure JSON**: le modèle attend un format spécifique ; assurez-vous que les champs d’état des composants correspondent à la structure attendue. +3. **Vérifiez les filtres log **: assurez-vous que l’action de logging utilise le type d’événement et l’attribut corrects. +4. **Test avec un point de terminaison simple**: utilisez un point de terminaison JSON basique (comme `https://httpbin.org/json`) pour vérifier le bon fonctionnement du modèle. +5. **Vérifier les autorisations du compte**: s’assurer que workflow est autorisé à écrire les logs dans New Relic. + +### L'authentification de la requête SQL NRLens échoue + +**Problème :** le modèle NRLens échoue en raison d’erreurs d’authentification ou de connexion. + +**Solutions :** + +1. **Vérifiez les informations d'identification NRLens**: assurez-vous que les informations d'identification du Gateway de requête SQL sont à jour et correctement stockées dans les secrets. +2. **Vérifiez les identifiants de l'organisation et du compte**: assurez-vous que les deux identifiants correspondent exactement à ceux de votre organisation New Relic. +3. **Tester la requête SQL séparément**: utiliser l’interface NRLens pour tester la requête avant de l’ajouter au workflow +4. **Vérifiez la syntaxe SQL**: NRLens SQL diffère de NRQL ; consultez [la documentation NRLens](https://docs.newrelic.com/docs/nrlens-overview) pour connaître la syntaxe prise en charge. +5. **Vérifiez la complexité de la requête**: les jointures très complexes ou les grands ensembles de données peuvent expirer ; simplifiez la requête ou ajoutez des limites de temps. + +## Prochaines étapes + +Si vous rencontrez toujours des problèmes après avoir essayé ces solutions : + +* **[Forum de la communauté sur l'automatisation des workflows](https://discuss.newrelic.com/)**: Posez des questions et obtenez de l'aide d'autres utilisateurs +* **[Assistance New Relic](https://support.newrelic.com/)**: Contactez l’assistance pour les problèmes liés à votre compte. +* **[Bonnes pratiques de workflow](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Apprenez des modèles pour un workflow fiable +* **[Limites du workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Comprendre les contraintes et les quotas du système \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx new file mode 100644 index 00000000000..3ca311d858d --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx @@ -0,0 +1,33 @@ +--- +title: Créer un calendrier +tags: + - workflow automation + - workflow + - CreateSchedule + - workflow automation API +metaDescription: Create a schedule for a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Crée un planning pour une définition workflow. + +Le nombre de planifications et la durée minimale d'une planification donnée sont définis dans [les limites du système de workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits). + +## Exemple + +Utilisez le [générateur de requêtes](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) pour créer et éditer un workflow. Voir [l'explorateur d'API NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +mutation { + workflowAutomationCreateSchedule( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "healthyHeartbeat", version: 1} + cronExpression: "0 0 * * *" + timezone: "Asia/Kolkata" + options: {logLevel: DEBUG} + ) { + scheduleId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx new file mode 100644 index 00000000000..04f2227b8f5 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: Créer une définition de workflow +tags: + - workflow automation + - workflow + - CreateWorkflowDefinition + - workflow automation API +metaDescription: Create a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API est utilisée pour créer une définition workflow. Elle renvoie une erreur si la définition workflow existe déjà. + +## Exemple + +Utilisez le [générateur de requêtes](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) pour créer et éditer un workflow. Voir [l'explorateur d'API NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphiql + mutation { + workflowAutomationCreateWorkflowDefinition( + scope: { + id: "11933347" + } + definition: { + yaml: "bmFtZTogbXV0YXRpb25fZXhlY3V0ZQoKc3RlcHM6CiAgLSBuYW1lOiBleGVjMQogICAgdHlwZTogYWN0aW9uCiAgICBhY3Rpb246IG5ld3JlbGljLm5lcmRncmFwaC5leGVjdXRlCiAgICB2ZXJzaW9uOiAnMS4wLjAnCiAgICBpbnB1dHM6CiAgICAgIGdyYXBocWw6IHwKICAgICAgICBtdXRhdGlvbiBLZWVwQWxpdmUoJGd1aWQ6IEVudGl0eUd1aWQhKXsKICAgICAgICAgIGVudGl0eUtlZXBBbGl2ZShndWlkczogWyRndWlkXSkgewogICAgICAgICAgICByZWZyZXNoZWRFbnRpdGllcwogICAgICAgICAgfQogICAgICAgIH0KICAgICAgdmFyaWFibGVzOgogICAgICAgIGd1aWQ6ICJ7eyAud29ya2Zsb3dJbnB1dHMuZW50aXR5R3VpZCB9fSIKCiAgLSBuYW1lOiBsb2cxCiAgICB0eXBlOiBhY3Rpb24KICAgIGFjdGlvbjogbmV3cmVsaWMuaW5zdHJ1bWVudGF0aW9uLmxvZwogICAgdmVyc2lvbjogJzEuMC4wJwogICAgaW5wdXRzOgogICAgICBNZXNzYWdlOiAiZW50aXR5R3VpZCByZWZyZXNoZWQge3sgLnN0ZXBzLmV4ZWMxLm91dHB1dHMuZGF0YS5lbnRpdHlLZWVwQWxpdmUucmVmcmVzaGVkRW50aXRpZXMgfX0iCg==" + } + ) { + definition { + name + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx new file mode 100644 index 00000000000..7058fdf2d0f --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx @@ -0,0 +1,697 @@ +--- +title: schéma de définition du workflow +tags: + - workflow automation + - workflow schems + - workflow automation API +metaDescription: Workflow definitions are written in YAML. Keys use a camelCase naming convention. +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +## Schéma + +Les définitions de workflow sont écrites en YAML. Les clés utilisent une convention de nommage `camelCase`. + +### **nom** (obligatoire) + +* **Type**: Chaîne de caractères +* **Format**: Doit être conforme à l'expression régulière `^[A-Za-z_][A-Za-z0-9_-]*$`. +* **Longueur maximale**: 100 +* **Description**: Les valeurs `name` ne sont pas sensibles à la casse. Par exemple, `ExampleWorkflow`, `exampleworkflow`, et `EXAMPLEWORKFLOW` sont tous considérés comme représentant la même définition workflow. + +### **description** (facultatif) + +* **Type**: Chaîne de caractères +* **Format**: Doit être conforme à l'expression régulière `^[A-Za-z0-9 _-]*$`. +* **Longueur maximale**: 200 +* **Description**: Un `description` du workflow qui explique son objectif. + +### **workflowInputs** (facultatif) + +* **Type**: Carte des cartes +* **Taille maximale**: 100 +* **Description**: Une carte des entrées workflow acceptées par workflow. +* **Exemple**: + +```java + workflowInputs: + myInput1: + type: String + myInput2: + type: Number + defaultValue: 42 +``` + +* **`workflowInputs.`** (Obligatoire) + + * **Type**: Chaîne de caractères (conforme au [modèle d'expression sûre]()) + * **Longueur minimale**: 1 + * **Longueur maximale**: 50 + * **Description**: Nom de l'entrée workflow. + +* **`workflowInputs..type`** (Obligatoire) + + * **Type**: Enum (Boolean, List, Map, String, Int, Float) + * **Description**: Type de données de l'entrée workflow. + +* **`workflowInputs..defaultValue`** (Facultatif) + + * **Type**: Tout ; doit être conforme à `type`. + * **Description**: Valeur par défaut de l'entrée workflow. + +* **étapes** (obligatoires) + + * **Type**: éventail de cartes + * **Description**: Étapes à effectuer lors de l'exécution de la définition workflow. Il doit y avoir au moins une étape. + + + Les étapes s'exécuteront dans l'ordre où elles sont définies dans l'éventail `steps`. + + Si un ordre différent est souhaité, un « saut » peut être effectué en définissant la propriété `steps[*].next` sur le nom de l'étape souhaitée vers laquelle sauter. + + + * **`steps[*].name`** (Obligatoire) + + * **Type**: Chaîne (conforme au [modèle d'expression sûre](); ne peut pas être `end`) + * **Longueur maximale**: 100 + * **Description**: Le nom de l'étape à référencer par `steps[*].next`. Il ne peut pas s'agir des mots clés spéciaux `end`, `continue`, ou `break`, car ceux-ci sont utilisés pour indiquer une étape de terminaison, une continuation d'une boucle ou pour sortir d'une boucle. + + * **`steps[*].type`** (Obligatoire) + + * **Type**: Chaîne de caractères + * **Description**: Le type d'étape, indiquant ce que fait l'étape lorsqu'elle est exécutée. Consultez la [section « Types d'étapes »]() pour connaître les options disponibles. + + * [**`steps[*].next`**](#steps-next) (Facultatif) + + * **Type**: Chaîne de caractères (conforme au [modèle d'expression sûre]()) + + * **Description**: + + * Nom de l'étape suivante à exécuter une fois cette étape terminée avec succès. Le mot-clé spécial `end` peut être utilisé pour indiquer que cette étape doit être la dernière à être exécutée. + * Si `next` est omis, l'entrée suivante dans le éventail `steps` de la définition sera utilisée comme étape suivante implicite. S'il n'y a pas d'entrée suivante, le workflow sera terminé. + +## Types d'étapes + +### **action** + +Une étape qui exécute une action spécifique. Consultez [le catalogue des actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) pour connaître les options disponibles. + +* **`steps[*].action`** (Obligatoire) + + * **Type**: Chaîne de caractères + + * **Description**: Nom complet de la fonction d'action à exécuter. Elle devrait respecter la convention suivante : + + `..` + + * **Exemple**: + + * Action utilisant les services New Relic (par exemple via NerdGraph) : `newrelic.dashboards.getDashboard` + * Action via Slack : `slack.chat.postMessage` + +* **`steps[*].version`** (Obligatoire) + + * **Type**: Chaîne de caractères + * **Description**: Version de la fonction d'action à exécuter. + +* **`steps[*].inputs`** (Facultatif) + + * **Type**: Carte de valeurs (incluant [les expressions]()) + + * **Description**: + + * Les données d'entrée à transmettre à la fonction d'action. Les entrées spécifiques acceptées sont définies par chaque action. + * Les entrées peuvent utiliser des expressions. Consultez la section [« Chaînes d’expressions »]() pour plus de détails. + + + Aucune donnée sensible (ni clé API ni secret, ni PII, ni PHI, ni aucune donnée permettant d'identifier une personne) ne doit être transmise en tant qu'arguments. + + +* **`steps[*].inputs.selectors`** (Facultatif) + + * **Type**: liste de maps sous la forme `name` avec `expression`. + + * **Description**: + + * L'entrée `selectors` permet de redéfinir la sortie pour ne renvoyer que les éléments spécifiés. + * L'expression peut être utilisée. Consultez la section [« Chaînes d’expressions »]() pour plus de détails. + + * **Exemple** + + * Dans l'exemple donné, nous obtenons `pageUrl` et `statusDescription` comme réponse de l'action http.get. + + ```yaml + name: status + description: A workflow for checking the status of New Relic components + + steps: + - name: query1 + type: action + action: http.get + version: 1 + inputs: + url: "https://status.newrelic.com/api/v2/status.json" + selectors: + - name: statusCode + expression: '.statusCode' + - name: pageUrl + expression: '.responseBody | fromjson | .page.url' + - name: statusDescription + expression: '.responseBody | fromjson | .status.description' + + - name: logOutput1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "status is '${{ .steps.query1.outputs.statusDescription }}' details at ${{ .steps.query1.outputs.pageUrl }}" + ``` + +### **boucle** + +Une boucle parcourra une collection donnée définie par `in` et créera des variables de boucle `index` et `element` pour chacune de ses itérations. Ces variables de boucle ne sont accessibles à l'intérieur de la boucle qu'avec l'expression `${{ .steps..loop.element }}` ou `${{ .steps..loop.index }` + +Pour plus de détails, voir ci-dessous : + + + + Vous pouvez utiliser la boucle pour parcourir une liste, une carte ou une collection. + + * `for` (Requis) + + * **Type**: Constant + * **Description**: Signal de début de boucle. + + * `in` (Requis) + + * **Type**: chaîne (expression) + * **Description**: Une expression qui doit être évaluée en une collection d'éléments. + + * `steps` (Requis) + + * **Description**: Étapes à exécuter à chaque itération de la boucle. Une étape peut être de tout type, y compris une autre boucle. + + * **Exemples**: Ce qui suit montre comment exécuter la boucle workflowInputs. Notez que le résultat doit être un type de collection. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # not exist outside of this loop + index: '${{ .steps.loopStep.loop.index }}' # not exist outside of this loop + ``` + + + * `element` et `index` sont automatiquement attribués dans le cadre de la boucle. + * `Index` est une base zéro. + * Le `element` peut être un type complexe si vous avez une collection d'éléments complexes. + * Toutes les variables de boucle et les sorties des étapes à l'intérieur de la boucle ont une portée au niveau de la boucle. Ces variables sont effacées après la sortie de la boucle et y accéder en dehors de la boucle renverra une valeur nulle. La boucle peut accéder aux variables situées en dehors de la boucle si elles ont été préalablement définies. + + + **Boucle for simple sur les entiers** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: ${{ [range(1; 6)] }} + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [1, 2, 3, 4, 5] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1, 2, 3, 4] + ``` + + **Boucle simple pour la carte** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [ { "key1": "val1" }, { "key2": "val2"} ] }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [{ "key1": "val1" }, { "key2": "val2"}] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1] + ``` + + **Sauter à l'intérieur d'une boucle** + + Seuls les sauts entre étapes nommées appartenant à la même boucle for sont autorisés. Il est interdit d'entrer ou de sortir d'une boucle for, de passer à une boucle interne/externe ou de naviguer entre deux boucles for différentes. + + ```yaml + name: myWorkflow + steps: + - name: firstStep + type: action + action: example.messaging.sayHello + version: '1.0.0' + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: step3 # Okay within the loop + - name: step2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.step1.outputs.greeting }}' + - name: step3 + type: action + action: example.messaging.sayHello + version: '1.0.0' + next: firstStep # Not okay, first step is not in the loop context + ``` + + **Utilisez break/continue dans une boucle** + + Pour modifier le flux d'une boucle for, vous pouvez utiliser `next: break` ou `next: continue`. Notez que `break` et `continue` sont des cibles de saut réservées définies implicitement dans une boucle. L'utilisation de `next: break` ou `next: continue` en dehors d'une boucle permettra de passer à la fin des étapes du workflow. + + * Le `end` est équivalent à `break` s'il est utilisé à l'intérieur d'une boucle. + * L'étape suivante peut être utilisée aussi bien dans les phases de commutation que dans tout type d'étape. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [range(1; 6)] }}' + steps: + - name: insideLoopStep1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: continue + - name: insideLoopStep2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + - name: loopStepAgain + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: switchStep + type: switch + switch: + - condition: '${{ .steps.loopStepAgain.loop.index >= 0 }}' + next: break + - name: insideLoopStepAgain + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStepAgain.loop.element }}' + ``` + + + +* **`steps[*].for`** (Obligatoire) + + * **Type**: constante + * **Description**: Signal de démarrage d'une boucle + +* **`steps[*].in`** (Obligatoire) + + * **Type**: chaîne (expression) + + * **Description**: Une expression qui doit être évaluée en une collection d'éléments. + + * **`steps[*].steps`** (Facultatif) + + * **Description**: Étapes à exécuter à chaque itération de la boucle. Voir la définition des étapes ci-dessus. + + * **Exemple**: + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: "${{ [range(1; 5)] }}"" + steps: + - name: step1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Loop: ${{ .steps.loopStep.loop.element }}" + ``` + +### **changer** + +* Une étape qui vérifie diverses conditions et emprunte la première branche qui s'évalue à vrai. + +* Un commutateur peut contenir un nombre quelconque d'éléments de condition dans une liste. Il vérifiera les conditions dans l'ordre et traitera la première qui s'avère vraie. Si aucune condition n'est vraie, l'étape suivante sera exécutée conformément à la définition de steps\[\*].next. + +* **`steps[*].switch`** (Obligatoire) + + * **Type**: éventail + * **Description**: Un éventail de cas de commutation, spécifiant la liste ordonnée des conditions à évaluer. + +* **`steps[*].switch[*].condition`** (Obligatoire) + + * **Type**: chaîne (expression) + * **Description**: État du boîtier de l'interrupteur. Si la valeur est vraie, l'étape suivante du cas sera exécutée. + +* **`steps[*].switch[*].next`** (Obligatoire) + + * **Type**: chaîne de caractères (conforme au [modèle d'expression sûre]()) + * **Description**: Nom de l'étape à exécuter si la condition du cas est vraie. Le mot-clé spécial « end » peut être utilisé pour indiquer que cette étape doit être la dernière à être exécutée. + + ```yaml + - name: hasCompleted + type: switch + switch: + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Failed" }} + next: displayError + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Success" }} + next: displaySuccess + next: displayUnexpected + ``` + +### attendez + +Une étape qui suspend l'exécution workflow pendant un certain nombre de secondes avant de se poursuivre. Il peut également capter un ou plusieurs signaux. Si aucun signal n'est reçu pendant l'attente, la procédure se déroulera normalement. Les signaux sont définis dans une liste. Chaque signal doit avoir une étape suivante correspondante définie. Le premier signal reçu est celui qui sera traité. La valeur reçue pour le signal sera stockée dans la sortie de l'étape d'attente et pourra être utilisée pour le traitement logique lors des étapes ultérieures. + +* Exemple: + + ```yaml + name: waitSignalExample + workflowInputs: + steps: + - name: waitStep + type: wait + seconds: 300 + signals: [{name: 'mySignalName', next: 'firstStep'}] + - name: endStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "didn't get signal" + next: end + - name: firstStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.waitStep.outputs.signalInputs.myString }} + ``` + +* **`steps[*].seconds`** (Obligatoire) + + * **Type**: nombre + * **Description**: Nombre de secondes à attendre avant de poursuivre l'exécution workflow. + +* **`steps[*].signals`** + + * **Type**: éventail + * **Description**: Les signaux qui, lorsqu'ils sont reçus, modifient le flux du programme. + +* **`steps[*].signals[*].name`** + + * **Type**: chaîne de caractères + * **Description**: Le nom du signal à écouter. + +* **`steps[*].signals[*].next`** + + * **Type**: chaîne de caractères + * **Description**: Étape à exécuter si le signal spécifié est reçu. + +## Types partagés + +### chaînes d'expression + +Plusieurs propriétés acceptent des valeurs de type chaîne contenant des expressions intégrées qui sont évaluées lors de l'exécution workflow, ce qui permet d'utiliser des valeurs dynamiques dans les définitions workflow. Les chaînes d'expression peuvent contenir une ou plusieurs expressions, chacune étant encadrée par des doubles accolades. Le contenu entre accolades est évalué à l'aide de jq. + +jq offre la possibilité d'accéder aux valeurs et de les manipuler de multiples façons. Par exemple, la longueur d'une chaîne d'entrée workflow pourrait être obtenue comme suit : `${{ .workflowInputs.myString | length }}` + +Cet outil permet de créer et [de tester des expressions JQ](https://play.jqlang.org/). + +### propriétés d'expression + +Un certain nombre de propriétés sont accessibles via des expressions. Ces propriétés résident dans un objet « portée », les expressions doivent donc commencer par un point (.) pour accéder à ces propriétés de l'objet portée. + +Les propriétés disponibles sont : + +* `workflowInputs` - objet contenant les entrées transmises au workflow au démarrage. + * Exemple: `${{ .workflowInputs.myInput }}` +* `steps` - objet contenant une propriété pour chaque étape du workflow + * `steps.` - objet contenant les propriétés d'une étape spécifique + * `steps..outputs` - objet contenant les propriétés de résultat, spécifiques à l'étape/action. + * Exemple: `${{ .steps.myStep.outputs.myResult }}` + +### Résultats de l'évaluation de l'expression + +Une seule expression jq peut être évaluée à n'importe quel type JSON, mais il est important de noter que le résultat final d'une chaîne d'expression complète dépendra du contenu de la chaîne (le cas échéant) entourant la ou les expressions. + +Si l'intégralité d'une chaîne d'expression se compose d'une seule expression, celle-ci sera évaluée comme le résultat de l'expression jq, en conservant le type JSON du résultat. Par exemple, si un workflow reçoit un éventail en entrée, la chaîne `${{ .workflowInputs.myArray }}` sera évaluée comme un éventail. Cela peut s'avérer utile pour transmettre des données complexes au sein d'un workflow. + +Si la chaîne d'expression contient un contenu autre qu'une expression unique, elle sera évaluée comme un résultat de type chaîne de caractères. Par exemple, cela se produit lorsqu'une expression est précédée ou suivie d'un contenu, ou si la chaîne contient plusieurs expressions. Chaque expression contenue dans la chaîne est évaluée et convertie en une représentation sous forme de chaîne de caractères. + +Exemple: + +Pour les exemples suivants, supposons que myArray ait une valeur de \[1, 2, 3]. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ chaîne d'expression + + Données de résultats + + Type de résultat +
+ `${{ .workflowInputs.myArray }}` + + \[1, 2, 3] + + éventail de nombres +
+ `${{ .workflowInputs.myArray | length }}` + + 3 + + nombre +
+ `${{ .workflowInputs.myArray | length > 0 }}` + + vrai + + booléen +
+ `Input is not empty: ${{ .workflowInputs.myArray | length > 0 }}` + + "Le champ d'entrée n'est pas vide : vrai" + + chaîne +
+ `${{ .workflowInputs.myArray }} has length ${{ .workflowInputs.myArray | length }}` + + " a une longueur de 3" + + chaîne +
+ +### Modèle sans danger pour les expressions [#expression-safe-pattern] + +Les propriétés utilisables dans les expressions doivent respecter l'expression régulière suivante : `^[A-Za-z_][A-Za-z0-9_]*$` + +### Références secrètes + +Les valeurs secrètes peuvent être utilisées dans les actions via des chaînes de référence qui spécifient le nom d'un secret à rechercher dans le service de secrets. Pour faire référence à un secret dans une définition workflow, utilisez la syntaxe suivante : + +* `${{ :secrets: }}` pour un secret pas dans un `namespace` +* `${{ :secrets:: }}` pour un secret dans un `namespace` + +Une chaîne d'expression peut contenir un mélange de références secrètes et d'expressions JQ et/ou plusieurs références secrètes. + +Exemples : + +```yaml + steps: + - name: bearer_auth + type: action + action: http.post + inputs: + headers: + Authorization: Bearer ${{ :secrets: }} +``` + +## Exemples + +* Bonjour le monde + +```yaml +name: helloWorld +description: 'A hello world workflow' + +workflowInputs: + name: + type: String + defaultValue: World + required: false + validations: + - type: maxLength + errorMessage: "name must be at most 100 characters" + length: 100 + slackTokenSecret: + type: String + defaultValue: "${{ :secrets:SLACK_TOKEN }}" + slackChannel: + type: String + defaultValue: my-channel + validations: + - type: regex + errorMessage: "A slack channel name must be lowercase and can only contain letters, numbers, and hyphens" + pattern: "^[a-z0-9\\-]+$" + required: true + +steps: + - name: init1 + type: assign + inputs: + greeting: Hello ${{ .workflowInputs.name }} + + - name: logName + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.init1.outputs.greeting }} + + - name: waiting1 + type: wait + seconds: 1 + + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + query: >- + FROM Log SELECT * WHERE message LIKE '${{ .steps.init1.outputs.greeting + }}' + + - name: checkResult + type: switch + switch: + - condition: ${{ .steps.queryForLog.outputs.results | length > 0 }} + next: FoundMessage + + - name: waitingMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Waiting for log message... + token: ${{ .workflowInputs.slackTokenSecret }} + next: waiting1 + + - name: FoundMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Found message! ${{ .steps.queryForLog.outputs.results[0].message }} + token: ${{ .workflowInputs.slackTokenSecret }} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx new file mode 100644 index 00000000000..36c4494152b --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx @@ -0,0 +1,44 @@ +--- +title: Supprimer le planning +tags: + - workflow automation + - workflow + - Delete Schedule + - workflow automation API +metaDescription: 'Deletes the schedule of a workflow definition. Note, this doesn’t stop already running workflow instance.' +freshnessValidatedDate: never +translationType: machine +--- + +Supprime la planification d'une définition workflow. Notez que cela n'arrête pas l'exécution d'un workflow en cours (utilisez la mutation StopWorkflowRun). + +## Exemple [#example] + +Utilisez le [générateur de requêtes](https://one.newrelic.com/nerdgraph-graphiql?state=fc314f67-101e-a54a-169a-191d1fd41fd) pour créer et éditer un workflow. Voir [l'explorateur d'API NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql + mutation { + workflowAutomationDeleteSchedule( + accountId: 11933347 + schedule: {id: "1a71d299-82c2-4b4d-9803-b14523e3a9e7"} + ) { + scheduleId + } + } +``` + +### Exemple d'erreur + +Si `schedule.id` n'est pas trouvé, la structure suivante est renvoyée. + +```graphql +{ + "data": { + "workflowAutomationDeleteSchedule": null + }, + "errors": [{ + "message": "Could not find schedule with ID MTE2NDk5MDB8TkdFUHxXT1JLRkxPV19TQ0hFRFVMRXwwMTk5MGUzYi04NzAyLTc2M2QtOWUzMy01ZTU1ZThmZTYzYjkl", + "path": ["workflowAutomationDeleteSchedule"] + }] +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx new file mode 100644 index 00000000000..142886d770c --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx @@ -0,0 +1,32 @@ +--- +title: Supprimer la définition du workflow +tags: + - workflow automation + - workflow + - Delete Workflow Definition + - workflow automation API +metaDescription: Used to delete all the workflow definition versions with the specified name. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API supprime toutes les versions de définition workflow portant le nom spécifié. + +Pour supprimer une définition, il ne doit exister aucune planification utilisant cette définition. Si la définition est actuellement utilisée par une planification, sa suppression échouera et renverra une erreur en conséquence. + +Tous les flux workflow en cours s'exécuteront jusqu'à leur terme même si la définition est supprimée. + +## Exemple + +```graphql +mutation { + workflowAutomationDeleteWorkflowDefinition( + definition: {name: "my-workflow"} + scope: {id: "12345678", type: ACCOUNT} + ) { + definition { + name + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx new file mode 100644 index 00000000000..93688190a97 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx @@ -0,0 +1,158 @@ +--- +title: Obtenir les définitions d'action +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: 'Returns all action definitions stored. This operation is behind NerdGraph, under account stitch point.' +freshnessValidatedDate: never +translationType: machine +--- + +\#Renvoie toutes les définitions d'actions pouvant être utilisées pour composer une définition workflow. + +## Exemple + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + actionDefinitions { + results { + description + inputs { + name + required + secretAllowed + } + name + outputs { + name + } + timeout { + action + } + version + } + } + } + } + } +} +``` + +renvoie ce qui suit + +```graphql +{ + "data": { + "actor": { + "account": { + "workflowAutomation": { + "actionDefinitions": { + "results": [ + { + "description": "Reboot one or more EC2 instances in an AWS account.", + "inputs": [ + { + "name": "awsRoleArn", + "required": false, + "secretAllowed": false + }, + { + "name": "awsAccessKeyId", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSecretAccessKey", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSessionToken", + "required": false, + "secretAllowed": true + }, + { + "name": "region", + "required": true, + "secretAllowed": false + }, + { + "name": "instanceIds", + "required": true, + "secretAllowed": false + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "aws.ec2.rebootInstances", + "outputs": [ + { + "name": "success" + }, + { + "name": "response" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 25 + }, + "version": 1 + }, + { + "description": "Send logs to New Relic.", + "inputs": [ + { + "name": "attributes", + "required": false, + "secretAllowed": false + }, + { + "name": "logs", + "required": true, + "secretAllowed": false + }, + { + "name": "licenseKey", + "required": false, + "secretAllowed": true + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "newrelic.ingest.sendLogs", + "outputs": [ + { + "name": "success" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 20 + }, + "version": 1 + } + # more ... + ] + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx new file mode 100644 index 00000000000..3ccbff308c3 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx @@ -0,0 +1,29 @@ +--- +title: Obtenir le calendrier +tags: + - workflow automation + - workflow + - Get Schedule + - workflow automation API +metaDescription: API gets and returns a schedule. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API récupère et renvoie un planning. + +## Exemple [#example] + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedule(id: "schedule-id") { + id + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx new file mode 100644 index 00000000000..ab0ab23b3e4 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx @@ -0,0 +1,41 @@ +--- +title: Obtenir les horaires +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Returns information about schedules. +freshnessValidatedDate: never +translationType: machine +--- + +Retourne des informations sur les horaires. + +## Exemple + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedules { + results { + definition { + name + scope { + id + type + } + version + } + schedule { + id + } + } + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx new file mode 100644 index 00000000000..7c6455dfd2b --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx @@ -0,0 +1,35 @@ +--- +title: Obtenir la définition du workflow +tags: + - workflow automation + - workflow + - Get Workflow Definition + - workflow automation API +metaDescription: Used to get and return a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API permet de récupérer et de renvoyer une définition workflow. + +## Exemple + +Utilisez le [générateur de requêtes](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) pour créer et éditer un workflow. Voir [l'explorateur d'API NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflow(name: "my-workflow", version: 1) { + definition { + name + version + yaml + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx new file mode 100644 index 00000000000..159dbcd9326 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx @@ -0,0 +1,38 @@ +--- +title: Obtenir les définitions du workflow +tags: + - workflow automation + - workflow + - Get Workflow Definitions + - workflow automation API +metaDescription: Used to get and return a list of workflow definitions under the user account’s scope. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API récupère et renvoie une liste de tous les schémas de définition workflow relevant du périmètre spécifié. Notez que le fichier YAML de définition workflow interne n'est pas disponible avec cette requête. Un fichier YAML de définition de workflow n'est renvoyé que par une requête GetWorkflowDefinition. `/{actor/account(:id)/workflowAutomation/workflow(:name, :version)` + +## Exemple + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflows(cursor: "xyz123") { + results { + definition { + name + scope { + id + type + } + version + } + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx new file mode 100644 index 00000000000..f1f5d0e5f80 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx @@ -0,0 +1,75 @@ +--- +title: Exécution du workflow du signal +tags: + - workflow automation + - workflow + - Signal Workflow Run + - workflow automation API +metaDescription: Actions trigger a signal to an existing running workflow. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API déclenche un signal vers un workflow en cours d'exécution. Cela peut servir à envoyer un rappel et être évalué par le workflow pour passer à différentes étapes suivantes. + +Des paramètres peuvent lui être transmis avec le signal. + +## Exemple [#example] + + + + ```yaml + name: signalDemo + + steps: + - name: waitStep + type: wait + seconds: 300 + signals: + - name: approve + next: signalHandler + - name: cancel + next: signalHandler + + - name: NoSignalReceived + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "no signals received" + next: end + + - name: signalHandler + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "signal '${{ .steps.waitStep.outputs.signalName }}' was received with: '${{ .steps.waitStep.outputs.signalInputs | tostring }}'" + ``` + + + +Après le démarrage de ce workflow, cet identifiant d'exécution est renvoyé au démarrage. `107e6df2-aa17-41bc-8065-bfa46bde810b` + +Le workflow peut alors être signalé par cette mutation. + +```graphql +mutation { + workflowAutomationSignalWorkflowRun( + accountId: 11933347 + runId: "107e6df2-aa17-41bc-8065-bfa46bde810b" + signalName: "approve" + signalInputs: [ + {key: "foo", value: "bar"} + ] + ) { + runId + } +} +``` + +On peut observer ce qui suit dans les Logs si le workflow a été démarré avec le `options: {logLevel: DEBUG}` + +Screenshot displaying Logs if the workflow was started with the options: {logLevel: DEBUG} \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx new file mode 100644 index 00000000000..a8df27c072a --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx @@ -0,0 +1,35 @@ +--- +title: Démarrer le workflow +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Start a workflow run for a specified workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API lance l'exécution d'un workflow pour une définition workflow spécifiée. + +Le nombre d'exécutions workflow simultanées et le nombre d'étapes exécutées dans une exécution donnée sont définis dans les [limites du système de workflow](/docs/workflow-automation/limitations-and-faq/workflow-limits). + +## Exemple + +Utilisez le [générateur de requêtes](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) pour créer et éditer un workflow. Voir [l'explorateur d'API NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "my-workflow"} + workflowInputs: [ + {key: "foo", value: "bar"}, + {key: "fruit", value: "apple"} + ] + options: {logLevel: DEBUG} + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx new file mode 100644 index 00000000000..427efa72165 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx @@ -0,0 +1,26 @@ +--- +title: Arrêter l'exécution du workflow +tags: + - workflow automation + - workflow + - Stop Workflow Run + - workflow automation API +metaDescription: Stops a running workflow instance. +freshnessValidatedDate: never +translationType: machine +--- + +Cela interrompt un workflow en cours. Elle renvoie une valeur vide `runId` si le workflow est introuvable. + +## Exemple + +```graphql +mutation { + workflowAutomationStopWorkflowRun( + accountId: 11933347 + runId: "7ffbe082-8efa-4d3d-901a-a08bcf22bcd3" + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx new file mode 100644 index 00000000000..3daa10a6aa9 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx @@ -0,0 +1,30 @@ +--- +title: Mise à jour de la définition du workflow +tags: + - workflow automation + - workflow + - Update Workflow Definition + - workflow automation API +metaDescription: Used to update an existing workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Utilisé pour mettre à jour une définition workflow existante. Elle renvoie une erreur si la définition workflow n'existe pas déjà. + +## Exemple + +```graphql + mutation { + workflowAutomationUpdateWorkflowDefinition( + definition: {yaml: ""} + scope: {id: "11608789", type: ACCOUNT} + ) { + definition { + name + version + yaml + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx new file mode 100644 index 00000000000..776c5407fc8 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx @@ -0,0 +1,81 @@ +--- +title: Référence de l'API d'automatisation des workflows +tags: + - workflow automation + - workflow + - nerdgraph + - nerdgraph api + - workflow automation api +metaDescription: Complete reference guide for Workflow Automation APIs in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez ! + + Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos [politiques de pré-sortie](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +L'API d'automatisation des workflows vous permet de créer, gérer et exécuter par programmation des workflows dans New Relic. Utilisez ces API pour automatiser les tâches répétitives, orchestrer des opérations complexes et intégrer le workflow à vos processus de développement et d'exploitation. + +## Avant de commencer + +Pour utiliser les API d'automatisation des workflows, vous aurez besoin de : + +* Un compte New Relic disposant des autorisations appropriées +* Accès à l' [explorateur d'API NerdGraph](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) pour créer et tester votre appel d'API +* Compréhension de [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) (API GraphQL de New Relic) + +Pour obtenir de l'aide supplémentaire : + +* Apprenez à utiliser l'IDE GraphiQL grâce au [tutoriel de l'explorateur d'API NerdGraph.](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) +* Consultez [la section Introduction aux API](/docs/apis/intro-apis/introduction-new-relic-apis) pour obtenir un aperçu de toutes les API de New Relic. + +### Authentification et secrets + +L'automatisation des workflows utilise le stockage secret des clients pour gérer les informations sensibles telles que les clés API et les identifiants. Les secrets sont gérés via [notre API GraphQL](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph). Pour plus de détails sur l'authentification relative à la gestion des secrets, veuillez consulter la [documentation NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph). + +## Opérations API par catégorie + +### Créer et gérer un workflow + +Utilisez ces API pour créer, mettre à jour, valider et supprimer des définitions workflow : + +* Créer une définition [de workflow](/docs/workflow-automation/workflow-automation-apis/create-workflow-definition) - Créer une nouvelle définition de workflow +* Mettre à jour la définition [du workflow](/docs/workflow-automation/workflow-automation-apis/update-workflow-definition) - Mettre à jour une définition de workflow existante +* [ValidateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition) - Validez la définition du workflow YAML avant de créer ou de mettre à jour +* [SupprimerDéfinitionDeFluxDeTravail](/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition) - Supprime toutes les versions d'une définition de workflow portant le nom spécifié + +### Workflow et actions des requêtes + +Utilisez ces API pour récupérer des informations sur le workflow et les actions disponibles : + +* [GetWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/get-workflow-definition) - Obtenir et renvoyer une définition de workflow spécifique +* [GetWorkflowDefinitions](/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions) - Obtenir et renvoyer une liste de définitions de workflow sous votre périmètre de compte +* [GetActionDefinitions](/docs/workflow-automation/workflow-automation-apis/get-action-definitions) - Renvoie toutes les définitions d'actions disponibles + +### Exécuter le workflow + +Utilisez ces API pour contrôler l'exécution workflow : + +* [Démarrer l'exécution du workflow](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) - Lancer l'exécution d'un workflow pour une définition de workflow spécifiée +* [SignalWorkflowRun](/docs/workflow-automation/workflow-automation-apis/signal-workflow-run) - Déclenche un signal vers un workflow en cours d'exécution. +* [StopWorkflowRun](/docs/workflow-automation/workflow-automation-apis/stop-workflow-run) - Arrêter une instance de workflow en cours d'exécution + +### Planifier le workflow + +Utilisez ces API pour créer et gérer des planifications workflow : + +* [Créer un planning](/docs/workflow-automation/workflow-automation-apis/create-schedule) - Créer un planning pour une définition de workflow +* [GetSchedule](/docs/workflow-automation/workflow-automation-apis/get-schedule) - Obtenir et renvoyer les détails de l'horaire +* [GetSchedules](/docs/workflow-automation/workflow-automation-apis/get-schedules) - Renvoie les informations sur tous les horaires +* [SupprimerPlanification](/docs/workflow-automation/workflow-automation-apis/delete-schedule) - Supprimer la planification d'une définition de workflow + + + La suppression d'une planification n'arrête pas l'instance workflow déjà en cours d'exécution. + + +### Documentation de référence + +* [Schéma de définition](/docs/workflow-automation/workflow-automation-apis/definition-schema) - Référence de la structure et de la syntaxe de la définition du workflow \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx new file mode 100644 index 00000000000..56a5775d678 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: Valider la définition du workflow +tags: + - workflow automation + - workflow + - Validate Workflow Definition + - workflow automation API +metaDescription: Used to validate workflow definition YAML. +freshnessValidatedDate: never +translationType: machine +--- + +Valider la définition workflow YAML. + +## Exemple + +```graphql + query workflowDefinitionValidation { + actor { + account(id: 11933347) { + workflowAutomation { + workflowDefinitionValidation( + definition: {yaml: "ICAgICAgICAgICAgICAgIG5hbWU6IG15V29ya2Zsb3cKCiAgICAgICAgICAgICAgICBzdGVwczoKICAgICAgICAgICAgICAgICAgLSBuYW1lOiBvbmx5U3RlcAogICAgICAgICAgICAgICAgICAgIHR5cGU6IHdhaXQKICAgICAgICAgICAgICAgICAgICBzZWNvbmRzOiAtNDIKCiAgICAgICAgICAgICAgICAgIC0gbmFtZTogJycKICAgICAgICAgICAgICAgICAgICB0eXBlOiB3YWl0CiAgICAgICAgICAgICAgICAgICAgc2Vjb25kczogLTQyCgogICAgICAgICAgICAgICAgICAtIG5hbWU6IG9ubHlTdGVwCiAgICAgICAgICAgICAgICAgICAgdHlwZTogYWN0aW9uCiAgICAgICAgICAgICAgICAgICAgYWN0aW9uOiBDb25zb2xlTG9nCiAgICAgICAgICAgICAgICAgICAgdmVyc2lvbjogIiIKICAgICAgICAgICAgICAgICAgICBpbnB1dHM6CiAgICAgICAgICAgICAgICAgICAgICAgZm9vOiAiIg=="} + ) { + errors { + message + } + valid + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx new file mode 100644 index 00000000000..544f481dc84 --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx @@ -0,0 +1,32 @@ +--- +title: WorkflowRunInfo +tags: + - workflow automation + - workflow + - Workflow Run Info + - workflow automation API +metaDescription: Used to retrieve information about a specific workflow run. +freshnessValidatedDate: never +translationType: machine +--- + +Cette API permet de récupérer et de renvoyer l'état d'un workflow pour un identifiant d'exécution workflow spécifique. + +## Exemple + +Utilisez le [générateur de requêtes](https://one.newrelic.com/nerdgraph-graphiql?state=03119d23-7b51-7b7a-1c99-d2cd026300e5) pour créer et éditer un workflow. Voir [l'explorateur d'API NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflowRunInfo(runId: "8911c7e4-5a1f-4316-90c8-67adde72dd1c") { + logUrl + status + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/fr/docs/workflow-automation/workflow-examples.mdx b/src/i18n/content/fr/docs/workflow-automation/workflow-examples.mdx new file mode 100644 index 00000000000..69b54d10d8e --- /dev/null +++ b/src/i18n/content/fr/docs/workflow-automation/workflow-examples.mdx @@ -0,0 +1,244 @@ +--- +title: Exemples de workflow +tags: + - workflow automation + - workflow + - automation + - examples +metaDescription: 'Common workflow automation scenarios and examples for incident response, infrastructure management, and integrations.' +freshnessValidatedDate: never +translationType: machine +--- + +Cette page présente des scénarios d'automatisation courants que vous pouvez créer avec l'automatisation des workflows. Utilisez ces exemples comme points de départ pour votre propre workflow, ou explorez la [bibliothèque de modèles](/docs/workflow-automation/create-a-workflow-automation/use-a-template) pour trouver des solutions prêtes à être déployées. + +## Réponse aux incidents et remédiation + +### Restauration du gateway API + +Rétablissez la configuration du Gateway API à un état antérieur afin de pouvoir corriger les erreurs et les mauvaises configurations. + +**Ce que fait ce workflow :** + +* Détecte les déploiements récents liés à un problème en utilisant New Relic suivi des changements +* Envoie une notification Slack avec des boutons d'approbation (:+1: ou :-1:) +* Après approbation, un document AWS Systems Manager est créé pour automatiser la restauration. +* Rétablit la version précédente de l'intégration API Gateway avec Lambda. +* Crée un nouveau déploiement pour appliquer la restauration. +* Envoie une notification de succès ou d'échec à Slack +* Nettoie le document SSM après son achèvement + +**Exigences:** + +* Identifiants AWS avec autorisations pour API Gateway et système Manager +* Une application Slack configurée pour recevoir les notifications et les approbations +* monitoring de l'entité New Relic avec suivi des changements + +**Actions clés**: `newrelic.nerdgraph.execute`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument` + +### Gestion des instances EC2 + +Automatisez le provisionnement, la mise à l'échelle et la suppression des instances EC2 pour des performances et des coûts optimaux. + +**Ce que fait ce workflow :** + +* Reçoit des alertes de forte utilisation du processeur de la part de New Relic +* Récupère les détails de l'alerte et identifie l' instanceEC2 concernée. +* Envoie notification Slack contenant les détails instance et requests l'approbation pour le redimensionnement. +* Après approbation, un document SSM est créé pour automatiser le redimensionnement instance. +* Arrête l' instance, modifie le type d'instance et la redémarre. +* Envoie des mises à jour de progression à Slack pendant le processus de redimensionnement +* Attend la fin de l'opération et envoie un statut de succès ou d'échec +* Nettoie le document SSM et envoie la confirmation finale + +**Exigences:** + +* Identifiants AWS avec autorisations pour EC2 et système Manager +* Une condition d'alerte New Relic active pour les métriques EC2 +* Une application Slack configurée pour recevoir les notifications et les approbations + +**Actions clés**: `newrelic.nerdgraph.execute`, `newrelic.nrdb.query`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument`, `utils.datetime.fromEpoch`, `utils.uuid.generate` + +### Restauration du déploiement + +Annuler le déploiement si l'entité devient défaillante et notifier par AWS SQS ou HTTP. + +**Ce que fait ce workflow :** + +* Monitorer la gravité des alertes d'une entité pendant une durée spécifiée (30 minutes par défaut). +* Vérifie l'état de l'entité toutes les minutes +* Si l'entité passe à l'état CRITIQUE ou AVERTISSEMENT, consignez l'état d'anomalie. +* Envoie une notification de restauration via AWS SQS (si configuré) avec les détails de l'entité. +* Envoie une notification de restauration via webhook HTTP (si configuré). +* Si l'entité reste saine pendant toute la durée, consigner le succès +* monitoring s'interrompt si l'entité est introuvable. + +**Exigences:** + +* Entité New Relic avec monitoringde la gravité des alertes +* (Facultatif) File d'attente AWS SQS et rôle pour recevoir les notifications de restauration +* (Facultatif) Point de terminaison HTTP pour recevoir notificationde restauration + +**Actions clés**: `newrelic.nerdgraph.execute`, `newrelic.ingest.sendLogs`, `aws.execute.api` (sqs.send\_message), `http.post` + +## traitement des données et reporting + +### Envoyer un rapport à Slack + +Envoyer le résultat d'une requête NRQL sous forme de fichier CSV sur Slack. + +**Ce que fait ce workflow :** + +* Exécute une requête NRQL sur le(s) compte(s) New Relic spécifié(s). +* Génère un fichier CSV à partir des résultats de la requête +* Publie le fichier CSV sur un canal Slack spécifié avec un message + +**Exigences:** + +* Une authentification New Relic et une requête NRQL fonctionnelle +* Une application Slack configurée avec un jeton et un canal cible + +**Actions clés**: `newrelic.nrdb.query`, `utils.transform.toCSV`, `slack.chat.postMessage` + +### Analyse JSON + +Analyse l'API d'état public JSON (HTTP) de New Relic et enregistre éventuellement les composants opérationnels et non opérationnels. + +**Ce que fait ce workflow :** + +* Récupère des données JSON à partir de l'API d'état de New Relic +* Extrait et catégorise les composants selon leur état opérationnel +* Enregistrement conditionnel des composants opérationnels (si activée) +* Enregistrement conditionnel des composants non opérationnels (si activée) +* Gère les erreurs HTTP et consigne les messages d'erreur. + +**Exigences:** + +* Accès à l'API d'état de New Relic (summary.json) +* Autorisations pour envoyer des logs via newrelic.ingest.sendLogs + +**Actions clés**: `http.get`, `newrelic.ingest.sendLogs` + +## Modèle de workflow disponible + +Les modèles énumérés ci-dessus sont disponibles directement dans l'interface utilisateur d'automatisation des workflows de New Relic. Pour y accéder : + +1. Accédez à **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Cliquez sur **Create workflow** +3. Sélectionnez **Use a template** +4. Parcourez la bibliothèque de modèles et choisissez un workflow qui correspond à votre cas d'utilisation. + +Chaque modèle comprend : + +* Étapes et logique workflow préconfigurées +* Exemple de paramètres d'entrée +* Identifiants et intégration requis +* Documentation des résultats attendus + +Vous pouvez utiliser les modèles tels quels ou les personnaliser pour les adapter à vos besoins spécifiques. + +## Transmission de données entre les étapes + +Tous les workflows peuvent faire référence aux résultats des étapes précédentes en utilisant la syntaxe de modèle. Cela vous permet d'enchaîner des actions et de construire une logique d'automatisation complexe. + +### Transmission de données de base + +```yaml +steps: + - name: getAlert + action: newrelic.nerdgraph.execute + inputs: + query: | + { + actor { + account(id: 123456) { + alerts { + violation(id: 789) { + condition + entity { + name + guid + } + } + } + } + } + } + + - name: sendToSlack + action: slack.chat.postMessage + inputs: + channel: "#incidents" + text: "Alert: ${{ .steps.getAlert.outputs.data.actor.account.alerts.violation.condition }}" +``` + +### Utilisation des données dans les boucles + +```yaml +steps: + - name: listInstances + type: action + action: aws.ec2.describeInstances + version: 1 + inputs: + filters: + - name: "tag:Environment" + values: ["production"] + + - name: checkEachInstance + type: loop + for: + in: "${{ .steps.listInstances.outputs.reservations }}" + steps: + - name: getInstanceMetrics + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + query: "SELECT average(cpuPercent) FROM SystemSample WHERE instanceId = '${{ .steps.checkEachInstance.loop.element.instanceId }}'" +``` + +### Logique conditionnelle avec données + +```yaml +steps: + - name: checkCPU + type: action + action: newrelic.nerdgraph.execute + version: 1 + # ... query configuration + + - name: decideAction + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 70 }}" + next: sendWarning + next: normalOperation + + - name: resizeInstance + type: action + action: aws.ec2.modifyInstanceAttribute + version: 1 + # ... resize configuration + + - name: sendWarning + type: action + action: slack.chat.postMessage + version: 1 + # ... warning message + + - name: normalOperation + type: action + action: newrelic.ingest.sendLogs + version: 1 + # ... log normal status +``` + +## Prochaines étapes + +* **[Créez votre propre workflow](/docs/workflow-automation/create-a-workflow-automation/create-your-own)** - Guide étape par étape pour la création d'un workflow +* **[Catalogue des actions](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)** - Parcourir toutes les actions disponibles +* **[Utiliser un modèle](/docs/workflow-automation/create-a-workflow-automation/use-a-template)** - déployer un workflow préconfiguré +* **[Configurer les informations d'identification AWS](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)** - Configurer l'authentification AWS \ No newline at end of file diff --git a/src/i18n/content/jp/docs/alerts/get-notified/notification-integrations.mdx b/src/i18n/content/jp/docs/alerts/get-notified/notification-integrations.mdx index 0daf2eba72f..0a88f59775f 100644 --- a/src/i18n/content/jp/docs/alerts/get-notified/notification-integrations.mdx +++ b/src/i18n/content/jp/docs/alerts/get-notified/notification-integrations.mdx @@ -179,13 +179,13 @@ translationType: machine * 電子メール アドレスが既存の宛先にすでに関連付けられている場合は、それらを結合するように求められます。 宛先を結合するには、 **Merge**を選択します。 * 新しいメールアドレスを追加した場合、受信者は確認メールを受け取ります。通知の受信を開始するには、受信者は検証プロセスを完了する必要があります。 - - メール送信先の制限: + + メール送信先の制限: - * **無料アカウント**: 各送信先には最大 5 つの電子メール アドレスを設定できます。 - * **有料アカウント**: 各送信先には最大 150 個のメール アドレスを設定できます。 - * **組織の制限**: カスタマー組織ごとに 24 時間あたり 1000 件の固有の電子メール アドレスを追加できます (すべてのユーザーに適用されます)。 - + * **無料アカウント**: 各送信先には最大 5 つの電子メール アドレスを設定できます。 + * **有料アカウント**: 各送信先には最大 150 個のメール アドレスを設定できます。 + * **組織の制限**: カスタマー組織ごとに 24 時間あたり 1000 件の固有の電子メール アドレスを追加できます (すべてのユーザーに適用されます)。 + 10. 電子メール メッセージをカスタマイズします。 diff --git a/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx b/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx index 30bd7e4c7a4..46ea828c395 100644 --- a/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx +++ b/src/i18n/content/jp/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx @@ -998,6 +998,68 @@ New Relic は AI/ML ライブラリのサポートを拡張しています。 +## ロギングライブラリ + +エージェントは、[コンテキスト内の APM ログ](/docs/logs/logs-context/get-started-logs-context/)の次のライブラリからログを転送できます。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **ライブラリ** + + **宝石名** + + **サポート対象** + + **メモ** +
+ **ロガー** + + `logger` + + + + Rubyのロガー ライブラリと、ActiveSupport::BroadcastLogger などのRubyロガーから継承するログ ライブラリを使用したAPMログ転送のサポート。 +
+ **ログスタッシャー** + + `logstasher` + + 1.xx以上 + + APM ログ転送のサポート。 +
+ ## その他のライブラリとテクノロジー [#other\_libraries][#other_libraries] @@ -1134,40 +1196,6 @@ New Relic は AI/ML ライブラリのサポートを拡張しています。 - - - - - - - - - - - - - - - - - - @@ -82,4 +82,4 @@ translationType: machine
- **ロガー** - - `logger` - - - - のロガー ライブラリを使用した APMログ転送のサポート。Ruby -
- **ログスタッシャー** - - `logstasher` - - 1.xx以上 - - APM ログ転送のサポート。 -
**ストライプ** diff --git a/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/introdution.mdx b/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/introdution.mdx index 5f13e1c5cb7..ae4f39deb38 100644 --- a/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/introdution.mdx +++ b/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/introdution.mdx @@ -20,6 +20,8 @@ Transaction 360 の主な機能は次のとおりです。 * **自動検出**: 動的なサービス関係のマッピングとリアルタイムのトランザクション フローの視覚化。 * **包括的な可視性**: フルスタックモニタリング、クロスサービストランザクション追跡、およびブラウザ可視性へのインフラストラクチャ。 +* **データベース監視**: インサイトをデータベースのパフォーマンス、書き込み分析、および現場ワークロード全体にわたる接続の状態に深く掘り下げます。 +* **サーバーレス機能の追跡**: サーバーレス機能のパフォーマンス、コールド スタート、リソース使用率を完全に可視化します。 * **履歴分析**: 数週間分の履歴データにアクセスして、傾向分析とパターン認識を可能にします。 @@ -33,5 +35,7 @@ Transaction 360を開始するには、 New Relicアカウントでディスト ## 次のステップ - アプリケーションのパフォーマンスの問題に Transaction 360 を使用する方法を学ぶ + + データベースやサーバーレス監視など、アプリケーションのパフォーマンスの問題にTransaction 360使用する方法を学習します。 + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx b/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx index a1ec5bd7868..9a4371a7f8e 100644 --- a/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx +++ b/src/i18n/content/jp/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx @@ -3,88 +3,173 @@ title: Transaction 360 による迅速なトラブルシューティング tags: - transaction workloads - dynamic workload monitoring -metaDescription: Learn about the detailed page breakdown in New Relic's Transaction 360 feature. +metaDescription: Learn how Transaction 360 provides comprehensive workload visibility for faster troubleshooting and performance optimization. freshnessValidatedDate: never translationType: machine --- -アプリケーションのパフォーマンスの問題が発生した場合、根本原因を特定して解決するための体系的なアプローチを持つことが重要です。 このガイドでは、トランザクション 360 を使用してアプリケーションのパフォーマンスの問題を表示する方法を説明します。 +Transaction 360 は、特定のトランザクションに関連するすべてのエンティティとデータを自動的にキャプチャして相関させ、分散ワークロードの包括的なビューを提供します。この総合的なアプローチには、スタック全体にわたる現場フロー、サービス関係、パフォーマンス メトリクスが含まれており、問題を迅速に特定して解決できるようになります。 -Transaction 360 は、特定の問題や質問に関連するすべてのエンティティとデータを自動的に取得して相関させるため、ワークロードの包括的なビューを提供します。 このビューにはトランザクション フロー、サービス関係、パフォーマンス メトリクスが含まれており、問題を迅速に特定して解決できるようになります。 +## Transaction 360でわかること -## トランザクション360ビューに移動する +Transaction 360 には、ワークロードを理解するのに役立つ 3 つの主要なビューがあります。 -トランザクション ワークロード ビューにアクセスするには、次の手順に従います。 +* **概要ダッシュボード**: エンティティ数、問題、および変更追跡 (変更追跡機能) を含む高レベルの概要 +* **動的フローマップ**: トランザクションパスとサービスの依存関係を視覚的に表現 +* **エンティティの内訳**: 参加しているすべてのコンポーネントの詳細なパフォーマンス メトリクス -1. **[one.newrelic.com](https://one.newrelic.com) > APM and Services**に移動します。 -2. APM 概要ページで、 **Transactions > Transaction Details > View transaction 360 workload**をクリックします。 +## Transaction 360にアクセス -Transaction 360 ビューには、次のコンポーネントを含むトランザクション ワークロードの詳細な内訳が表示されます。 +1. **[one.newrelic.com](https://one.newrelic.com) > APM and Services**にアクセスしてください +2. APM概要ページからサービスを選択してください +3. **Transactions > Transaction Details > View transaction 360 workload**に移動します。 -* **トランザクション 360 の概要**: 関係するエンティティの数、アラート、および変更追跡 (変更追跡機能) を含む、トランザクションのワークロードの概要を表示します。 + + 現在、データベース セクションとサーバー レス監視セクションはステージング環境で利用できます。 これらの機能にアクセスするには、適切なアカウント権限と適切な計装があることを確認してください。 + -* **動的フロー マップ**: トランザクション フローを視覚化し、関連するサービスと各サービスにかかる時間を表示します。 +## ダイナミックフローマップ -* **参加エンティティ**: トランザクション ワークロードに関与するサービスとそのパフォーマンス メトリクスをリストします。 + -## トランザクション 360 の概要 +フロー マップは、分散システム内でのトランザクションの流れを視覚化します。 -transaction-360-overview.webp +* **サービス接続**: サービス間の通信方法と依存関係を確認します +* **パフォーマンスボトルネック**:全体的な瞬間タイムに影響を与える遅いコンポーネントを特定する +* **トレース関係**: サービスペアをクリックすると、それらの間の詳細なトレースメトリクスが表示されます。 -Transaction 360 の概要セクションでは、関連するトランザクション ワークロードの次のような概要が示されます。 +### コラボレーション機能 -* **依存エンティティ：インストルメントされた**エンティティ数、未インストルメントのエンティティ数、アラートのあるエンティティ数など、インサイトを提供するトランザクションワークロードに関わるエンティティの総数。 さらに、インストゥルメントされたエンティティをクリックすると、詳細なパフォーマンス メトリクスと関連サービスを表示できます。 また、インストゥルメントされていないエンティティをクリックすると、インストゥルメント化されていないエンティティのリストが表示され、インストゥルメントが必要なエンティティを特定することもできます。 同様に、アラートのあるエンティティをクリックすると、アラートのあるエンティティのリストが表示され、アラートの重大度に基づいて調査の優先順位を付けることができます。 +* **チームの割り当て**: トランザクションワークロードにチームを割り当てて、インシデント対応を迅速化します。 +* **タグ付け**：関連するエンティティをグループ化して調査と組織化を効率化します -* **問題:**トランザクション ワークロードで検出された問題の数 (アラートおよび変更追跡機能) マーカーを含みます。 **「詳細の表示」**をクリックして問題のリストを表示し、パフォーマンスの問題によって直接影響を受けるエンティティを特定します。 +## エンティティパフォーマンスの内訳 -* **Change Tracking**\[変更追跡機能]:トランザクション ワークロード内で検出された変更追跡 (変更追跡機能) マーカーの数。ワークロードのパフォーマンスの変化を示します。 **View details** \[詳細を表示]をクリックして変更追跡 (変更追跡機能) マーカーを表示し、パフォーマンスの変化によって直接影響を受けるエンティティを特定します。 +このセクションでは、ワークロードのコンポーネントの種類ごとに詳細なメトリクスを提供します。 -## ダイナミックフローマップ +### APMサービス -動的フロー マップはトランザクション フローを視覚化し、関連するサービスと各サービスにかかる時間を表示します。 マップはトランザクション ワークロードの概要を提供し、ボトルネックやパフォーマンスの問題を特定できるようにします。 + -dynamic-map.webp +以下を使用してアプリケーション サービスを監視します。 -関連サービスを選択して、それらの間のトレース メトリクスを表示できます。 さらに、トランザクション ワークロードにチームを割り当ててコラボレーションと問題解決を促進したり、タグを使用して関連エンティティをグループ化して調査プロセスを効率化したりすることもできます。 +**サービス メトリクス テーブル:** -動的フロー マップを使用すると、パフォーマンスの問題によって直接影響を受けるサービスを特定し、根本原因の調査に集中することができます。 +* **スループット**: 各サービスの1分あたりのリクエスト数 +* **エラー率**: 失敗したrequestsの割合 +* **応答時間**: サービスあたりの平均レイテンシ +* **問題の重大度**: 修正の優先順位を決定するための重大、警告、および情報アラート -## エンティティへの参加と支援 +**トランザクション分析:** -### APMタグ +* **パフォーマンスの変化**: 応答時間の変化が最も高いトランザクション +* **トレースの詳細**: 任意をクリックすると、完全なトレース フローが表示されます -参加エンティティ セクションでは、APM サービス、ブラウザー アプリケーション、モバイル アプリケーション、サーバーレス機能、インフラストラクチャ エンティティなど、トランザクション ワークロードに関係するサービスの詳細な内訳が示されます。 +### インフラストラクチャエンティティ -partcipating-services.webp + -* **パフォーマンス メトリクス:** APMサービス テーブルには、調査の優先順位を決定するために、スループット、エラー率、レイテンシ、重大度レベルの問題 (クリティカル、警告、情報など) を含む各サービスのパフォーマンス メトリクスが表示されます。 +ホスト、コンテナ、およびKubernetesクラスタのインフラストラクチャ パフォーマンスを表示します。 -* **トランザクション テーブル:**トランザクション テーブルを使用して、レスポンス時間の変化率が最も高いトランザクションを特定し、最も影響を受けたトランザクションに調査を集中させることもできます。 さらに、特定のトランザクションを選択して、そのトレース フローとパフォーマンス メトリクスを表示できます。 +**リソースメトリクス:** -### インフラストラクチャエンティティ +* **CPU使用率**: インフラストラクチャ全体のプロセッサ使用率 +* **メモリ消費**：RAM使用量と潜在的な制約 +* **ディスクI/O** : ストレージのパフォーマンスとボトルネック +* **ネットワークアクティビティ**: データ転送速度とネットワークの問題 + +**ホスト分析:** + +* **リソースランキング**: リソース消費量が最も高いホストを特定する +* **関連サービス**: 各ホストで実行されているアプリケーションを確認する + +### ブラウザ アプリケーション + + + +フロントエンドのパフォーマンスとユーザーエクスペリエンスを監視: + +**パフォーマンスメトリクス:** + +* **ページロードタイム**: フロントエンドのレンダリングと読み込みのパフォーマンス +* **JavaScript エラー**: ユーザー体験に影響を与えるクライアント側のエラー +* **ページビュー**: Trafficパターンとユーザー エンゲージメント + +**ユーザー体験ツール:** + +* セッション**リプレイ**: ユーザーのセッションを見て、実際のユーザーに対するパフォーマンスの影響を理解する +* セッションをクリックすると、詳細なユーザーインタラクションデータが表示されます。 +* 詳細については、[セッションリプレイのドキュメント](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/)を参照してください。 + +### データベース監視 + +包括的なメトリクスを使用してデータベースのパフォーマンスを追跡します。 + +**パフォーマンスの視覚化:** + +* **スループット チャート**: 時間の経過に伴う 1 分あたりのデータベース操作数 +* **タイムチャート**：レスポンスタイムの傾向とパフォーマンスパターン + +**クエリ分析テーブル:** + +* **データベース操作**: 呼び出し回数、期間、タイミング 書き込みごとのメトリクス +* **パフォーマンスランキング**: 最大、平均、合計実行時間 +* **書き込みの最適化**: 最も遅い書き込みと最も頻繁な書き込みを特定します + +**トランザクション影響表:** + +* **データベース依存関係**: どのトランザクションがデータベース操作に最も大きく依存しているかを示します。 +* **時間割り当て**: データベース呼び出しに費やされた時間の割合 +* **最適化の目標: データベースの**オーバーヘッドが最も高いトランザクション + +**インタラクティブなドリルダウン:** + +* 「書き込みカウント」をクリックすると、特定の席で使用されたすべての書き込みが表示されます +* トランザクション名をクリックすると、そのトランザクションでクエリをフィルタリングできます。 +* 個別の書き込み詳細からスタックトレースにアクセスする + +### サーバーレス機能 + +AWS Lambdaおよびその他のサーバーレス コンポーネントを監視します。 + +**カスタマイズ可能なパフォーマンス チャート:** + +* **呼び出しパターン**: 時間の経過に伴う関数の実行頻度 +* **期間メトリクス**: 実行時間とパフォーマンスの傾向 +* **メモリ使用率**: リソース消費パターン +* **コスト追跡**:関数呼び出しに関連する費用 -インフラストラクチャ エンティティをインストゥルメント化した場合は、トランザクション 360 ビューでインフラストラクチャ エンティティのパフォーマンス メトリクスを表示できます。 「インフラストラクチャ エンティティ」セクションでは、ホスト、コンテナ、 Kubernetesクラスタなど、トランザクション ワークロードに関係するインフラストラクチャ エンティティの詳細な内訳を提供します。 +**機能分析:** -infrastructure-entities.webp +* **関係性**: どのトランザクションがサーバー レス機能をトリガーするかを確認します +* **パフォーマンスの影響**: 関数のパフォーマンスが全体的な速度にどのように影響するか +* **リソース効率**: メモリ割り当てと実際の使用量 -* **パフォーマンス メトリクス:**インフラストラクチャ エンティティ テーブルには、CPU 使用率、メモリ使用率、ディスクI/O 、ネットワークI/Oなどの各エンティティのパフォーマンス メトリクスが表示され、パフォーマンス ボトルネックとリソースの制約が特定されます。 +### モバイルアプリケーション -* **ホスト テーブル:**ホスト テーブルを使用してインフラストラクチャ エンティティのリストを検索し、CPU 使用率、メモリ使用量、ディスク I/O、ネットワーク I/O が最も高いホストを特定して、最も影響を受けているホストに調査を集中させることもできます。 さらに、特定のホストを選択して、そのパフォーマンス メトリクスおよび関連サービスを表示することもできます。 +トランザクションフロー内でモバイル アプリのパフォーマンスを追跡します。 -### Browser +* **アプリのパフォーマンス**: 応答時間とユーザー体験メトリクス +* **クラッシュ率**: モバイル固有のエラー追跡 +* **デバイスメトリクス**: さまざまなモバイルデバイス間のパフォーマンス -ブラウザ アプリケーションをインストルメントした場合は、トランザクション 360 ビューでブラウザ エンティティのパフォーマンス メトリクスを表示できます。 ブラウザ エンティティ セクションでは、トランザクション ワークロードに関係するブラウザ アプリケーションの詳細な内訳が提供されます。 +### AI/LLM監視 -browser-entities.webp +大規模言語モデル(LLM)のパフォーマンスとコストをモニターします: -* **パフォーマンス メトリクス:** Browserエンティティ テーブルには、ページロードタイム、ページ ビュー、JavaScript エラーなどの各エンティティのパフォーマンス メトリクスが表示され、パフォーマンス ボトルネックとユーザー エクスペリエンスの問題を特定します。 +* **モデルのパフォーマンス**: 応答時間と精度 AI サービスのメトリクス +* **コスト追跡**: トークンの使用と関連コスト +* **エラー率**: AI requestsの失敗とタイムアウトの問題 -* **セッションリプレイ:**セッションリプレイ機能を使用して、ユーザーセッションを再生し、パフォーマンスの問題につながるユーザーインタラクションを特定することもできます。 さらに、特定のセッションを選択して、そのパフォーマンス メトリクスおよび関連サービスを表示することができます。 詳細については、[セッションリプレイ](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/)を参照してください。 +AI モニタリングのセットアップの詳細については、 [AI モニタリングのドキュメントを](/docs/ai-monitoring/intro-to-ai-monitoring/)参照してください。 -### モバイルエンティティ +## 次のステップ -モバイル アプリケーションをインストゥルメント化した場合は、トランザクション 360 ビューでモバイル エンティティのパフォーマンス メトリクスを表示できます。 モバイル エンティティ セクションでは、トランザクション ワークロードに関係するモバイル アプリケーションの詳細な内訳が提供されます。 +Transaction 360 で問題を特定した後: -### AIモニタリング +1. **修正の優先順位付け**: 重大なアラートと最も影響の大きいパフォーマンスの問題から開始します +2. **計装ギャップ**: 完全な可視性を実現するために、計測されていないエンティティに監視を追加します +3. **プロアクティブな監視を設定する**: キーを実行するパフォーマンス閾値のアラートを作成する +4. **コラボレーション**: チームの割り当てとタグを使用して、解決の取り組みを調整します -アプリケーションが大規模言語モデル (LLM) (LLM) を呼び出しており、 APMエージェントを使用してインストゥルメントが行われている場合、トランザクション 360 ビューで AI エンティティのパフォーマンス メトリクスを表示できます。 AI エンティティ セクションでは、トランザクション ワークロードに関与する AI モデルの詳細な内訳が提供されます。 詳細については、 [AIモニタリング](/docs/ai-monitoring/intro-to-ai-monitoring/)を参照してください。 \ No newline at end of file +Transaction 360 は、分散ワークロード全体の問題を迅速に理解、診断、解決するために必要な包括的なビューを提供します。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx b/src/i18n/content/jp/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx new file mode 100644 index 00000000000..0bcc2bc92ba --- /dev/null +++ b/src/i18n/content/jp/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx @@ -0,0 +1,162 @@ +--- +title: 高度なセッションリプレイ機能 +metaDescription: Manage session replay & modify capabilities depending on the role +freshnessValidatedDate: '2024-12-19T00:00:00.000Z' +redirect: + - /docs/browser/browser-monitoring/browser-pro-features/session-replay/sequence-filtering +translationType: machine +--- + +このドキュメントでは、セッションリプレイを使用して詳細な分析を行い、ユーザーの行動を効率的に調査して理解する方法について説明します。 New Relic AI活用して、セッションリプレイ イベント トレイルを自動的に要約したり、シーケンス フィルターを使用して特定のユーザー インタラクション パターンでリプレイを特定したり、録画をトリミングしてセッションの最も関連性の高い部分に焦点を当て、責任のあるチームや担当者と共有したりできるようになりました。 + +## New Relic AIの概要 [#new-relic-ai] + +New Relic AI (NRAI) を使用すると、セッションリプレイ イベント トレイル データの要約とマッピングに役立ち、ユーザーのbrowserジャーニーのエラーと成功をより深く理解できるようになります。 + +NRAI を使用してセッションリプレイ イベント トレイル データを要約するには、アカウントで[NRAI を有効に](/docs/agentic-ai/new-relic-ai/#enable)する必要があります。 アカウントで NRAI が有効になったら、次の操作を実行して概要を表示します。 + +1. **[one.newrelic.com > All Capabilities](https://one.newrelic.com/all-capabilities) > Browser**に移動します。 + +2. ブラウザ アプリを選択します。 + +3. 左側のメニューで下にスクロールし、 **Session replay**をクリックします。 + +4. リプレイをクリックすると、要約したいセッションの詳細が表示されます。 + + screenshot of the session replay page in browser + +5. **Summarize**をクリックします。 セッションの概要がフォーカス パネルに生成されます。 + + screenshot of the session replay page in browser + +## シーケンスフィルタリング [#sequence-filtering] + +**Sequence Filtering** \[シーケンスフィルタリング]機能は、ユーザーインタラクション中に記録されたイベントの特定のシーケンスに基づいてセッションリプレイをフィルタリングするのに役立ちます。 この機能は、**Session Listing** \[セッション一覧]ページで多数のセッション録画を効率的にナビゲートし、関連するリプレイをシームレスに検索できるように設計されています。 + +### キー機能 + +* **イベント シーケンス フィルタリング**: ユーザーが検索を実行してからカートに商品を追加するなど、イベントのシーケンスを特定の順序で指定することによって、リプレイをフィルタリングできます。 +* **カスタマイズ可能なフィルター**: 属性、演算子、値を選択して、シーケンス フィルターを定義できます。 +* **複数のアクションのサポート**: シーケンスで最大 5 つのアクションを指定できます。 +* **柔軟なフィルタリング**: フィルタは任意の順序で適用できるため、シーケンス フィルタを期間などの他のフィルタ タイプと組み合わせることができます。 + +### ビューをカスタマイズする + +デフォルトでは、**Sequence**\[シーケンス]は**All** \[すべて]に設定されています。 **Sequence = All** \[シーケンス = すべて]フィルターを選択し、**Set up a filtering sequence** \[フィルタリング シーケンスの設定]ダイアログをクリックしてシーケンス フィルターを定義することで、ビューをカスタマイズできます。 + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**に移動します。 +2. **Sequence = All** \[シーケンス = すべて]フィルターを選択すると、**Set up a filtering sequence** \[フィルタリング シーケンスの設定]オプションが表示されます。 +3. **Set up a filtering sequence** \[フィルタリング シーケンスの設定]オプションを使用すると、特定の順序で最大 5 つのアクションを指定してシーケンス フィルターを作成できます。 次の属性を選択してシーケンスを定義できます。 + + + フィルター フォームに少なくとも 2 つのステップを追加する必要があります。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ アクション + + 説明 +
+ 属性 + + 属性を選択してください: + + * **閲覧した URL** : ユーザーが閲覧したページの URL に応じてデータをフィルタリングします。 + + * **ページアクション**: ユーザーのページとのインタラクションに基づいてデータをフィルタリングします。 + + * **キーボード入力**: ユーザーのキーボード入力に基づいてデータをフィルタリングします。 以下のオプションを選択すると、検索範囲をさらに広げることができます。 + + * **ターゲット**: キーボード入力が行われたターゲット要素を選択します。 + * **目標 ID** : キーボード入力が行われた目標 ID を選択します。 + * **目標クラス**: キーボード入力が行われた目標クラスを選択します。 + + * **ユーザーのクリック数**: ユーザーのクリック数に基づいてデータをフィルターします。 +
+ オペレーター + + 以下のオプションから演算子を選択します。 + + * **=** : 指定された値はインシデント属性値と等しくなります。 + * **類似**: 指定された値がインシデント属性値に類似している場合。 +
+ 価値 + + 検索するか値を入力します。 +
+ +4. **Apply** \[適用]をクリックします。 + + Screenshot of session replay details + +## トリミングされたセッションリプレイ [#trimmed-session-replay] + +**Trimmed session replay** \[Trimmed セッションリプレイ]機能を使用すると、セッション録画の特定のセグメントを抽出して共有し、関連するイベントに焦点を当てて目的の分析と迅速な問題解決を行うことができます。 長い録画全体を共有する代わりに、問題が発生した瞬間を正確に強調する焦点を絞ったクリップを作成できます。 + +### トリミングされたセッションリプレイを作成する + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**に移動します。 + +2. トリムしたいセッションリプレイを選択します。 + +3. セッションリプレイコントロールで**Share a clip** \[クリップを共有]をクリックします。 + +4. タイムライン コントロールを使用してクリップの境界を選択します。 + + * 左矢印をドラッグして、クリップの開始時間を設定します。 + * 右矢印をドラッグして、クリップの終了時間を設定します。 + +5. クリップの詳細フォームに記入してください: + + * **Availability** \[可用性]ドロップダウンを使用して、クリップ リンクをアクティブにしておく期間を選択します。 + * メッセージを追加します (オプション) - クリップの内容に関するコンテキストを提供します。 + * 特定のチーム メンバーとクリップを直接共有するには、メール アドレスを追加します。 + +6. 選択内容を確認します。ハイライト表示されたセクションには、クリップに含まれる内容が表示されます。 + +7. トリミングされたセグメントを生成するには、 **Share this clip** \[このクリップを共有]をクリックします。 + +### 共有クリップにアクセスする + +チームメンバーからトリミングされたセッションリプレイを受け取った場合: + +1. **電子メール通知経由**: 受信者として追加された場合は、クリップ リンクと送信者から提供されたメッセージが記載された電子メールが届きます。 +2. **共有 URL 経由**: ディスカッション パネルから共有リンクをクリックして、トリミングされたセッションリプレイをブラウザーで開きます。 + + + Safari では共有された URL を自動的にコピーすることはできません。生成されたリンクを手動でコピーし、受信者と共有する必要があります。 + + +3. **クリップを表示する**: クリップは自動的に再生され、選択したセグメントと送信者からのコンテキスト メッセージのみが表示されます。 + +4. **クリップの可用性**: クリップには送信者によって設定された有効期限があります。以前共有したクリップにアクセスできない場合は、 **Availability** \[可用性]ウィンドウを確認してください。 + + screenshot of the session replay page in browser \ No newline at end of file diff --git a/src/i18n/content/jp/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx b/src/i18n/content/jp/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx index 755d97a01c9..336e551a210 100644 --- a/src/i18n/content/jp/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx +++ b/src/i18n/content/jp/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx @@ -60,7 +60,7 @@ AWSから`ReadOnlyAccess` [マネージドポリシー](http://docs.aws.amazon.c Statement: - Effect: Allow Principal: - AWS: !Sub 'arn:aws:iam::754728514883:root' + AWS: !Sub 'arn:aws:iam::253490767857:root' Action: 'sts:AssumeRole' Condition: StringEquals: diff --git a/src/i18n/content/jp/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx b/src/i18n/content/jp/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx index 7a5fa329a8b..9b9aa754e67 100644 --- a/src/i18n/content/jp/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx +++ b/src/i18n/content/jp/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx @@ -21,10 +21,10 @@ translationType: machine 1. インフラストラクチャエージェントが[正しくインストールされ、実行されている](/docs/infrastructure/new-relic-infrastructure/troubleshooting/no-data-appears-infrastructure)ことを確認してください。 インフラストラクチャエージェント **first** をインストールし、 AWSアカウントに接続する必要があります。 - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events**または**Infrastructure > Settings > Agents**に属性名が表示され、データが表示されない場合は、インフラストラクチャエージェントがインストールされていない可能性があります。 + **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events**または**Infrastructure > Settings > Agents**に属性名が表示され、データが表示されない場合は、インフラストラクチャエージェントがインストールされていない可能性があります。 -2. アカウント ステータス ダッシュボードに表示されるエラーを修正します。 **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS**に移動し、各アカウントの**Account status dashboard**を選択します。 +2. アカウント ステータス ダッシュボードに表示されるエラーを修正します。 **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS**に移動し、各アカウントの**Account status dashboard**を選択します。 **Role errors** または **Permission errors** のレポートが表示される場合は、[インテグレーションと管理ポリシー](/docs/integrations/amazon-integrations/getting-started/integrations-managed-policies)を参照し、アカウントから関連データを読み取るために必要な権限をNew Relicに付与していることを確認してください。 @@ -52,7 +52,7 @@ translationType: machine 		- `754728514883` + `253490767857`
-3. データの[正しい場所を探している](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric)ことを確認してください。すべての統合データは、[指標とイベント](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer)で見つけることができます。 +3. データの[正しい場所を探している](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric)ことを確認してください。すべての統合データは、[指標とイベント](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer)で見つけることができます。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx b/src/i18n/content/jp/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx index 38c52877e23..2bf5f4ab0c9 100644 --- a/src/i18n/content/jp/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx +++ b/src/i18n/content/jp/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx @@ -13,14 +13,10 @@ translationType: machine ログデータは大量のテレメトリであり、個々のレコードあたりの価値は低い。検索すれば、根本的な原因を説明するログをすぐに見つけることができますが、ほとんどのデータは反復的で、閲覧時に文脈を理解するのは困難です。パターンは、価値の低いデータを読むのに多くの時間を費やすことなく、ログデータを発見できるようにします。 -Screenshot of Log patterns UI +Screenshot of Log patterns UI
- **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: ログパターン を使用すると、余分な時間をかけて検索することなく、ログメッセージの不審な急増や急減を見つけることができます。 + **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: ログパターン を使用すると、余分な時間をかけて検索することなく、ログメッセージの不審な急増や急減を見つけることができます。
## 技術概要 [#overview] @@ -67,11 +63,11 @@ translationType: machine - ヒットラスト・アカウント + HIPAAアカウント - ログパターン機能はFedRAMPに準拠していません。FedRAMPまたは他のHITRUSTアカウントはパターンを使用することができません。 + ログパターン機能は FedRAMP に準拠していません。 FedRAMP またはその他の HIPAA アカウントではパターンを使用することはできません。 @@ -81,7 +77,7 @@ translationType: machine - ログをパターンに照合する際に、メモリやCPUのリソースに安全制限を設ける仕組みがあります。これらのマッチング制限は、ログパターンにグループ化できるログの割合に影響を与えます。しかし、ログ パターン マッチングは"ベストエフォート" プロセスです。すべてのログがパターンによってグループ化される機会がなくてもエラーではありません。リソースの制限内で行うことができるグループ化からも価値を得ることができます。 + ログをパターンに照合する際に、メモリやCPUのリソースに安全制限を設ける仕組みがあります。これらのマッチング制限は、ログパターンにグループ化できるログの割合に影響を与えます。しかし、ログ パターン マッチングは"ベストエフォート" プロセスです。すべてのログがパターンによってグループ化される機会がなくてもエラーではありません。リソースの制限内で行うことができるグループ化からも価値を得ることができます。 @@ -91,19 +87,8 @@ translationType: machine パターンの検討を始めるために -1. - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs** - - - に移動し、アカウント ピッカーのドロップダウンを使用して、パターンを調査するターゲット アカウントを選択します。 - -2. ログ UI の左側のナビゲーションで、 - - - **Patterns** - - - をクリックします。 +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs**に移動し、アカウント ピッカーのドロップダウンを使用して、パターンを調査するターゲット アカウントを選択します。 +2. ログ UI の左側のナビゲーションで、 **Patterns**をクリックします。 メインログUIが変更され、クエリバーのクエリに一致するパターンが表示されます。特定の期間のログを表示するには、チャート上のそのポイントをクリックする（または領域をクリックしてドラッグする）か、タイムピッカーを使用します。 @@ -221,11 +206,5 @@ translationType: machine パターンは、 `newrelic.logPattern`という名前の新しい属性として既存のログメッセージに追加される値です。ログを使用して実行できることはすべて、通常、次のようなログパターンを使用して実行できます。 * パターンを使用して独自の[ダッシュボード](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards)を作成し、関心のある特定のパターンまたはパターンのグループを監視します。 - -* [NRQL アラート](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions)を追加してパターンの - - - - を作成します。 - -* [異常アラート条件](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions)を使用して、既知のログ パターンの異常を検出します。 +* [NRQL アラート](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions)を追加してパターンのを作成します。 +* [異常アラート条件](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions)を使用して、既知のログ パターンの異常を検出します。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx b/src/i18n/content/jp/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx index 5c9c0c89288..4502cd4d4f2 100644 --- a/src/i18n/content/jp/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx +++ b/src/i18n/content/jp/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx @@ -204,7 +204,13 @@ Go ランタイム ページには、Go サービスのランタイムの問題 Go ランタイムのゴールデン ページには、ランタイムの問題とサービスの使用状況を関連付けるために、Go ランタイム メトリクスの横に「マイナス」が表示されます。 -この記事では、データが[OpenTelemetry Go ランタイム計装ライブラリ](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/)によって生成されることを前提としています。 現在、Go ランタイム メトリクスにはセマンティック規則が存在しないことに注意してください。 +この記事では、データが[OpenTelemetry Go ランタイム計装ライブラリ](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/)によって生成されることを前提としています。 + + + Go ランタイム Metrix の[セマンティック規則は](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/runtime/go-metrics.md)まだ開発中です。 Go ランタイム ページは、古いバージョンの規則を対象としています。 `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS`環境変数を有効にして、古い規則を有効にする必要があります。詳細については、計装の[ドキュメント](https://github.com/open-telemetry/opentelemetry-go-contrib/blob/9a6e0bf68e1da495be52faf152b5b4e6fb09d475/instrumentation/runtime/internal/x/README.md)を参照してください。 + + New Relic は、新しい規則が安定次第、最終的にそれをサポートする予定です。 + ### ログ [#logs-page] diff --git a/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx new file mode 100644 index 00000000000..9836f09e0ee --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx @@ -0,0 +1,71 @@ +--- +subject: Docs +releaseDate: '2025-10-25' +version: 'October 19 - October 24, 2025' +translationType: machine +--- + +### 新しいドキュメント + +* Cloud Cost Intelligence [Azure](/docs/cci/azure-cci)と[Google Cloud Platform (GCP)](/docs/cci/gcp-cci)を追加し、 Azureと GCP の請求統合New Relicと接続してコストの監視と最適化を行うための包括的なガイダンスを提供します。 + +### 主な変更点 + +* [Node.js エージェントの互換性レポート](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent)を更新しました。 +* ユーザーエクスペリエンスを向上させるために、合理化されたコンテンツで[NRQLの概要を](/docs/nrql/get-started/introduction-nrql-new-relics-query-language)更新しました。 +* JavaエージェントのConfigMapサポートを[Kubernetesエージェント演算](/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator)子に追加しました。 + +### マイナーチェンジ + +* [Set 閾値アラート条件](/docs/alerts/create-alert/set-thresholds/set-thresholds-alert-condition)の壊れたリンクを修正しました。 +* [ビジュアルビルダーの導入](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder)ドキュメントが強化され、ビジュアルが改善されました。 +* ドキュメント全体での数式のレンダリングのサポートが追加されました。 +* セッションリプレイ[一時停止機能](/docs/browser/new-relic-browser/browser-apis/pauseReplay)と[レコード機能の](/docs/browser/new-relic-browser/browser-apis/recordReplay)ドキュメントが強化され、ガイダンスが改善されました。 +* わかりやすくするために、複数のドキュメント ページにわたるブラウザエージェントのディストリビューティッド（分散）トレーシング要件を更新しました。 +* [外形監視ジョブ マネージャーの設定](/docs/synthetics/synthetic-monitoring/private-locations/job-manager-configuration/#kubernetes-sizing)が更新され、 Docker 、Podman、 Kubernetes 、および OpenShift のサイジングを考慮するための数式が改善されました。 +* ドキュメントのレンダリングに影響する MDX の問題を修正しました。 + +### リリースノート + +* 弊社の最新リリース情報を常に把握してください: + + * [Browser v1.300.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.300.0) : + + * すべてのユーザーに対してマークとメジャーの機能フラグの使用を削除しました。 + * hasReplay 属性の誤認率が減少しました。 + * waitForEnd を反映するためにインターラクションAPI型付けを更新しました。 + * ロールアップ.js の動的な require の問題を修正しました。 + + * [Browser v1.301.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.301.0) : + + * セッションリプレイにNew Relicのフォークされたバージョンの rrweb の使用に切り替えました。 + * 適切な優先順位処理を使用して、ログ ペイロードのエージェント属性が保持されます。 + + * [Kubernetesインテグレーション v3.47.0](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-47-0) : + + * Kubernetes 環境の監視機能が強化されました。 + * リソース収集とパフォーマンスの最適化が改善されました。 + + * [Node.jsエージェント v13.5.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-5-0) : + + * 発行されたイベントをサブスクライブするために fastify 計装を更新しました。 + * データベース監視を改善するために、pg および pg-native 計装を更新しました。 + * パフォーマンス向上のため、timers.setTimeout と timers.setInterval をデフォルトで無効にしました。 + * トラブルシューティングを強化するために、新しい診断基本クラスを追加しました。 + + * [iOS エージェント v7.5.11](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-7511) : + + * インタラクション トレースのパフォーマンスの問題を修正しました。 + * 誤ったディストリビューティッド（分散）トレーシングログメッセージを修正しました。 + + * [Android エージェント v7.6.10](/docs/release-notes/mobile-release-notes/android-release-notes/android-7610) : + + * ビルドの互換性を向上させるために Gradle 9 のサポートを追加しました。 + + * [インフラストラクチャエージェント v1.69.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1690) : + + * 強化されたシステム監視機能とバグ修正。 + + * [インフラストラクチャエージェント v1.70.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1700) : + + * 追加のパフォーマンスの改善と監視の強化。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx new file mode 100644 index 00000000000..9e024f7adf7 --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx @@ -0,0 +1,60 @@ +--- +subject: Docs +releaseDate: '2025-08-08' +version: 'August 01 - August 07, 2025' +translationType: machine +--- + +### 新しいドキュメント + +* [NerdGraph チュートリアル「チームのカスタム ロールの作成」が追加され、](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) New Relic NerdGraph API を使用してチームのカスタム ロールを作成および管理する方法が説明されました。 + +### マイナーチェンジ + +* [条件ごとの集中イベントの値を](/docs/alerts/admin/rules-limits-alerts)1 分あたり 1,000 に変更しました。 +* 最新の検証済み[.Net エージェント互換バージョンと要件](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements)を更新しました。 +* [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-service-broker-integration)のサービス ブローカーのバージョンおよびバージョン サポート情報を更新しました。 +* [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-nginx-buildpack-integration)用のNew Relic NGINX 統合ビルドパックに関するバージョン サポート情報を更新しました。 +* New Relic Nozzle for [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-firehose-nozzle-integration/#product-snapshot)のバージョンおよびバージョン サポート情報を更新しました。 + +### リリースノート + +* 新着情報投稿をご覧ください: + + * [Errors Inboxはワークロード内に統合されました](/whats-new/2025/08/whats-new-08-06-workloads-errors-inbox)。 + +* 弊社の最新リリース情報を常に把握してください: + + * [ジョブマネージャー v452](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-452) : + * キュー メッセージの処理における例外処理の内部的な改善を追加しました。 + + * [Kubernetesインテグレーション v3.43.3](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-43-3) : + * New Relic Kubernetes 監視ソリューションをデプロイするための Helm チャートを追加しました。 + + * [Pipeline Controlゲートウェイ v1.1.0](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-08-05) : + + * ドロップ ルールを使用して`SqlTrace`および`TransactionTrace`イベントからデータと属性を選択的にドロップする新しい機能を実装しました。 + + * クロスサイト スクリプトの問題や、IPv6 ゾーン ID に関連する HTTP プロキシ バイパスなど、 `golang.org/x/net`パッケージの脆弱性に対処しました。 + + * Go `1.24`にアップグレードされ、セキュリティを強化し、最近の修正を組み込むために次の依存関係が更新されました。 + + * `golang.org/x/net to v0.38.0` + * `golang.org/x/sys to v0.31.0` + * `golang.org/x/text to v0.23.0` + + * [iOS向けモバイルアプリv6.9.11](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6101) : + * ユーザーの認証ドメインを保存し、ユーザーをサインイン ページに直接リダイレクトすることで、ログイン フローを 2 ステップ削減しました。 + + * [Flutterエージェント v1.1.13](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1113) : + + * ネイティブ Android エージェントがバージョン 7.6.8 にアップデートされました + * ネイティブ iOS エージェントがバージョン 7.5.8 にアップデートされました + + * [.NET MAUI エージェント v1.1.11](/docs/release-notes/mobile-release-notes/net-maui-release-notes/net-maui-agent-1111) + + * ネイティブ Android エージェントがバージョン 7.6.8 にアップデートされました + * ネイティブ iOS エージェントがバージョン 7.5.8 にアップデートされました + + * [インフラストラクチャエージェント v1.65.5](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1655) : + * ストレージサンプルのAWS efsマウントのサポートを変更しました \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx new file mode 100644 index 00000000000..a7591ff8b81 --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx @@ -0,0 +1,112 @@ +--- +subject: Docs +releaseDate: '2025-08-15' +version: 'August 08 - August 14, 2025' +translationType: machine +--- + +### 新しいドキュメント + +* [ゲートウェイ ルールでのNRQL関数のサポート](/docs/new-relic-control/pipeline-control/nrql-functions)を追加しPipeline Controlゲートウェイ ルールでサポートされるNRQL関数の概要を示しました。 +* New Relic Infrastructure エージェント設定でホスト名の解決設定を調整することで[、頻繁なFluent Bit Restart イベント](/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/frequent-fluent-bit-restart-events)を解決するためのトラブルシューティング手順を追加しました。 + +### 主な変更点 + +* 最新の価格情報に合わせて[使用プラン](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/#list-price)を更新しました。 +* [ワークロード UI](/docs/new-relic-solutions/new-relic-one/workloads/use-workloads/#errors) に **Error inbox** \[エラー受信トレイ] を追加しました。 +* [Javaエージェント設定](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file/#skip-applications)のセキュリティ設定を強化するとともに、環境変数を介して起動メイン クラスまたは実行可能 jar に基づいて選択的エージェントを無効にする機能を追加しました。 +* Agent Controlに[プライベート リポジトリ設定](/docs/new-relic-control/agent-control/configuration/#private-repository-configuration)のサポートが追加され、基本または TLS 証明書方式による認証による管理対象エージェントのプロイメントが可能になります。 +* Agent Controlに[Secret Management](/docs/new-relic-control/agent-control/configuration/#secrets-management)のサポートが追加されました。これにより、専用のシークレット プロバイダーからパスワードやAPIキーなどの機密データを取得して管理できるようになります。 + +### マイナーチェンジ + +* [Pipeline Control クラウド ルールを使用して、Drop data](/docs/new-relic-control/pipeline-control/cloud-rules-api/#restrictions)の`WHERE`句にエンティティ タグ制限を追加しました。 +* New Relic AI Knowledge コネクタの[ナレッジ ソース コンテンツを最適化するためのベストプラクティス](/docs/agentic-ai/knowledge-integration/overview/#configure)を追加しました。 + +### リリースノート + +* 新着情報投稿をご覧ください: + + * [UniqueCount 高精度モードと引数サポートの増加が一般提供されました](/whats-new/2025/08/whats-new-8-13-high-precision-uniquecount)。 + +* 弊社の最新リリース情報を常に把握してください: + + * [Cordovaエージェント v7.0.8](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-708/) : + + * ネイティブ Android エージェントをバージョン 7.6.8 に更新します + * ネイティブ iOS エージェントをバージョン 7.5.8 に更新します + + * [Cordovaエージェント v7.0.9](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-709/) : + + * ネイティブ Android エージェントをバージョン 7.6.6 に更新します + * ネイティブ iOS エージェントをバージョン 7.5.5 に更新します + + * [Capacitor v1.5.8](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-158/) : + + * ネイティブ Android エージェントをバージョン 7.6.6 に更新します + * ネイティブ iOS エージェントをバージョン 7.5.5 に更新します + + * [Capacitor v1.5.9](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-159/) : + * 中止信号のクラッシュを修正 + + * [Capacitor v1.5.10](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-1510/) : + + * ネイティブ Android エージェントをバージョン 7.6.8 に更新します + * ネイティブ iOS エージェントをバージョン 7.5.8 に更新します + + * [診断 CLI (nrdiag) v3.5.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-350/) : + * `Java/Appserver/JbossEapCheck`バージョンの互換性チェックを更新しました + + * [.NET エージェント v10.44.0](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-0/) : + + * Serverlessモードでパフォーマンス メトリクス サンプラーを有効にしました + * Azure Function webhost (Linux) プロセスを計装から除外しました。 + + * [NRDOT v1.3.0](/docs/release-notes/nrdot-release-notes/nrdot-2025-08-13/) : + + * オテルコンポーネントのバージョンを v0.128.0 から v0.131.0 に上げました + * nrdotコアディストリビューションを導入 + + * [Node.jsエージェント v13.1.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-1-0/) : + + * OTEL ログAPIのサポートを追加しました + * パッケージで計装が無効になっている場合のメトリクスのサポートを追加しました + * サンプル設定ではデフォルトで無効になっているタイマーを計装しています + * `transaction.url`難読化を修正しました + + * [ジョブマネージャーv454](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-454/) : + * SJM のセキュリティ脆弱性に対処するために、Ubuntu の根本的な脆弱性を修正しました。 + + * [Node API ランタイム v1.2.124](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.124/) : + * Node API ランタイムのセキュリティ脆弱性に対処するために、根本的な Ubuntu の脆弱性を修正しました。 + + * [Node ブラウザ ランタイム v3.0.41](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.41/) : + * ノードBrowserランタイムのセキュリティ脆弱性に対処するために、tmp `CVE-2025-54798`脆弱性と基礎となる Ubuntu 脆弱性を修正しました。 + + * [Pingランタイムv1.54.0](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.0/) : + * Ping ランタイムのセキュリティ問題に対処するために、Ubuntu に関連する脆弱性を修正しました。 + + * [Javaエージェント v8.23.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8230/) : + + * graphql の v24 をサポートするように更新されました。 + * レタス6.5計装を追加しました。 + * commons-lang バージョンを 3.18.0 にアップグレードしました + + * [AWS Lambda ログフォワーダー v1.1.1](/docs/release-notes/aws-lambda-log-forwarder-release-notes/lambda-25-07-25/) : + * システムの Go バージョンを 1.24.4 にアップグレードすることで、セキュリティ体制を強化しました。 + + * [PHPエージェント v12.0.0.25](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-0-0-25/) : + + * Drupal フック マップのエラー ログが改善されました。 + * Security RX のレガシー パッケージ検出の問題を修正しました。 + + * [インフラストラクチャエージェント v1.66.1](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1661/) : + * ストレージ サンプルの AWS EFS マウントのサポートを元に戻しました。 + + * [Android用モバイルアプリv5.30.6](docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5306/) : + * SAML およびソーシャル ログインのパスキー サポートが強化されました。 + + * [Browser v1.295.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.0/) : + + * エラー原因の検出を追加しました。 + * モンキーパッチの警告を追加しました。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx new file mode 100644 index 00000000000..5e0abc2d13d --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx @@ -0,0 +1,94 @@ +--- +subject: Docs +releaseDate: '2025-09-14' +version: 'September 08 - September 12, 2025' +translationType: machine +--- + +### 新しいドキュメント + +* ビジネス実行時間、デジタル エクスペリエンス、エンジニアリング エクセレンス、インテリジェント オブザーバビリティの 4 つの主要領域にわたるオブザーバビリティの実践を測定および改善するためのガイダンスを提供する、包括的な[オブザーバビリティ成熟度モデルの](/docs/new-relic-solutions/observability-maturity/)ドキュメントを追加しました。 + +### 主な変更点 + +* サンプリング コントロールとフレームワーク例外ハンドラー計装のための広範な新しい設定オプションを備えた[PHP エージェント設定](/docs/apm/agents/php-agent/configuration/php-agent-configuration/)を更新しました。 + +### マイナーチェンジ + +* ダッシュボードの使用に関するガイダンスを強化して[ダッシュボードの紹介](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/)を更新しました。 +* JSON 管理のコンテンツが簡素化された、[ダッシュボード管理](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/)ドキュメントが強化されました。 +* [New Relic 使用プランの](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/)ドキュメント内の壊れたリンクを修正しました。 +* [.NET エージェント トラブルシューティング](/docs/apm/agents/net-agent/troubleshooting/debugging-net-windows/)ドキュメントのデバッグ設定を修正しました。 + +### リリースノート + +* 弊社の最新リリース情報を常に把握してください: + + * [Browser v1.297.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.0/) : + + * レート制限処理を改善するために、再試行期間中の早期収穫を防止しました。 + * 課金対象バイトを削減するために、送信されるリプレイ ペイロードから NewRelic メタ属性を削除しました。 + * 空の収穫から発生するヌル ボディの例外を修正しました。 + + * [PHPエージェント v12.1.0.26](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-1-0-26/) : + + * アップストリームの w3c トレースサンプリングの決定に基づいたサンプリング制御を追加しました。 + * フレームワーク例外ハンドラーの計装をスキップする設定オプションを追加しました。 + * `newrelic_end_transaction(true)`呼び出すときに発生する可能性のあるメモリ リークを修正しました。 + * セキュリティ強化のため、golang バージョンを 1.25.1 にアップグレードしました。 + + * [Pythonエージェント v10.17.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101700/) : + + * Celery のカスタム タスクのサポートが追加されました。 + * Graphene-Django 監視のサポートが追加されました。 + * Django でのミドルウェア フィルタリングのサポートが追加されました。 + * AWS Bedrock Converse API のサポートが追加されました。 + * W3CTraceParent ヘッダー サンプリング フラグのサポートが追加されました。 + + * [Javaエージェント v8.24.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8240/) : + + * MongoDB Reactive Streams 5.2.0 以降のサポートが追加されました。 + * Jedis 6のサポートを追加しました。 + * CouchBaseの二重計装の問題を修正しました。 + * Spring WebClient 5.x のヘッダー ラッピングの問題を修正しました。 + + * [Node.jsエージェント v13.3.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-0/) : + + * MCP `StreamableHTTPClientTransport`サポートが追加されました。 + + * [Node.jsエージェント v13.3.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-1/) : + + * `requestParameters` `transaction.addRequestParameters`内のオブジェクトにデフォルト設定することでクラッシュする問題を修正しました。 + + * [Node.jsエージェント v13.3.2](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-2/) : + + * アウトバウンド HTTP 呼び出しで`protocol`取得するための防御コードを追加しました。 + + * [Kubernetesインテグレーション v3.45.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-45-1/) : + + * 最新の改善とバグ修正を加えて更新されました。 + + * [ジョブマネージャーv464](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-464/) : + + * 顧客が podman を使用してカスタム レジストリからイメージをプルできない問題を修正しました。 + + * [Node ブラウザ ランタイム v3.0.43](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.43/) : + + * セキュリティの脆弱性に対処するために、Ubuntu の根本的な脆弱性を修正しました。 + + * [iOS向けモバイルアプリv6.9.12](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6102/) : + + * ダッシュボードとアラートのディープリンクの問題を修正しました。 + * CCU ダッシュボード ID の問題を修正しました。 + + * [Android用モバイルアプリv5.30.7](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5307/) : + + * バグ修正と改善を追加しました。 + + * [Flutterエージェント v1.1.14](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1114/) : + + * 追加の安定性の改善とバグ修正を追加しました。 + + * [Pipeline Controlゲートウェイ v25.09.01](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-09-01/) : + + * パイプライン制御機能が強化された新しいリリースが追加されました。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx b/src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx new file mode 100644 index 00000000000..7a3f6592ca4 --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx @@ -0,0 +1,15 @@ +--- +subject: Infrastructure agent +releaseDate: '2025-10-27' +version: 1.71.0 +translationType: machine +--- + +エージェントの新しいバージョンがリリースされました。標準手順に従って[インフラストラクチャエージェントを更新します](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent)。 New Relic では、エージェントを定期的に、少なくとも 3 か月ごとにアップグレードすることを推奨しています。このリリースの時点で、サポートされている最も古いバージョンは[インフラストラクチャエージェント 1.55.2](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1552/)です。 + +## かわった + +* Suse 15.7 のサポートを追加[#2139](https://github.com/newrelic/infrastructure-agent/pull/2139) +* Debian 13 (Trixie) のサポートを追加[#2140](https://github.com/newrelic/infrastructure-agent/pull/2140) +* 依存関係 newrelic/nri-winservices を v1.4.0 に更新しました[#2143](https://github.com/newrelic/infrastructure-agent/pull/2143) +* 依存関係 newrelic/nri-prometheus を v2.27.2 に更新しました[#2130](https://github.com/newrelic/infrastructure-agent/pull/2130) \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx b/src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx new file mode 100644 index 00000000000..13524f8b850 --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx @@ -0,0 +1,13 @@ +--- +subject: Kubernetes integration +releaseDate: '2025-10-28' +version: 3.48.0 +translationType: machine +--- + +変更の詳細な説明については、[リリース ノートを](https://github.com/newrelic/nri-kubernetes/releases/tag/v3.48.0)参照してください。 + +この統合は、次のチャート バージョンに含まれています。 + +* [ニューレリック・インフラストラクチャー 3.53.0](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.53.0) +* [nri-バンドル-6.0.19](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.19) \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx b/src/i18n/content/jp/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx new file mode 100644 index 00000000000..cc22569c014 --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx @@ -0,0 +1,18 @@ +--- +subject: Flutter agent +releaseDate: '2025-10-24' +version: 1.1.16 +downloadLink: 'https://pub.dev/packages/newrelic_mobile/versions/1.1.16' +translationType: machine +--- + +## バグ修正 + +* ボトムシートやモーダルダイアログなど、キー のないルートを処理するときに`NewRelicNavigationObserver`がクラッシュする問題を修正しました。 +* `PageRoute`を拡張しないルートのナビゲーション トラッキングの失敗を解決しました。 + +## 機能強化 + +* すべての動的型を削除することにより、 `NewRelicNavigationObserver`の型の安全性が向上しました。 +* `go_router`からの`CupertinoPage`および`NoTransitionPage`を含む追加のルート タイプのサポートが追加されました。 +* 保守性と可読性を向上させるために、ナビゲーション オブザーバー コードをリファクタリングしました。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx b/src/i18n/content/jp/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx new file mode 100644 index 00000000000..6e5b982a15b --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx @@ -0,0 +1,39 @@ +--- +subject: Browser agent +releaseDate: '2025-08-04' +version: 1.295.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Add error cause detection +bugs: + - Add monkey-patching warnings + - Calculate first and last timestamps from raw data +security: [] +translationType: machine +--- + +## v1.295.0 + +### 特徴 + +#### エラー原因検出を追加 + +キャプチャされた JavaScriptError イベントの原因属性を検出して報告します。原因がエラーのインスタンスである場合はスタックトレースがキャプチャされ、それ以外の場合は原因の文字列化された内容が報告されます。 これは、属性`cause`の下の JavaScriptError イベントでクエリ可能になります。 + +### バグ修正 + +#### モンキーパッチの警告を追加する + +エージェントがページで実行される前に、予期されるグローバルにモンキーパッチが適用された場合の検出と警告を追加しました。これにより予期しない動作が発生する可能性があり、この動作について顧客に通知することが目的です。 + +#### 生データから最初と最後のタイムスタンプを計算する + +UI リプレーヤーの一貫性を向上させるために、収集前にエージェントが SessionReplay ペイロードの最初と最後のタイムスタンプを手動で計算することを確認します。 + +## サポートステートメント + +New Relic では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。古いリリースは[サポート終了](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/)になるとサポートされなくなります。リリース日は、エージェント バージョンの元の公開日を反映します。 + +新しいブラウザエージェントのリリースは、一定期間にわたって小さな段階で顧客に展開されます。 このため、リリースがアカウントでアクセス可能になる日付は、元の公開日と一致しない可能性があります。詳細については、この[ステータス ダッシュボード](https://newrelic.github.io/newrelic-browser-agent-release/)をご覧ください。 + +弊社の[ブラウザ サポート ポリシー](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types)に従い、 Browserの v1.295.0 は、 Chrome 128 ～ 138、Edge 128 ～ 138、Safari 17 ～ 19、Firefox 130 ～ 140 のブラウザとバージョン範囲向けに構築され、テストされました。 モバイル デバイスの場合、v1.295.0 は Android OS 16 および iOS Safari 17-26 用に構築およびテストされました。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx b/src/i18n/content/jp/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx new file mode 100644 index 00000000000..d3726ad0d76 --- /dev/null +++ b/src/i18n/content/jp/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-08-13' +version: 1.54.0 +translationType: machine +--- + +### 改良点 + +* Ping ランタイムのセキュリティ問題に対処するために、Ubuntu に関連する脆弱性を修正しました。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/vulnerability-management/overview.mdx b/src/i18n/content/jp/docs/vulnerability-management/overview.mdx index ebec63bdc1f..6904167d18f 100644 --- a/src/i18n/content/jp/docs/vulnerability-management/overview.mdx +++ b/src/i18n/content/jp/docs/vulnerability-management/overview.mdx @@ -17,7 +17,7 @@ translationType: machine Security RX を使用すると、次のメリットが得られます。 -* プラットフォームと、[ FOSSA](docs/vulnerability-management/integrations/fossa/) 、[AWS Security Hub](docs/vulnerability-management/integrations/aws/)[ 、Trivy](/docs/vulnerability-management/integrations/trivy) 、Snyk 、 Dependabot[Snyk](docs/vulnerability-management/integrations/snyk/) などの統合パートナーによって検出される脆弱性を含む、すべてのNew Relic [Dependabot](install/vm/)性の 。 +* New Relicプラットフォームと、 [FOSSA](/docs/vulnerability-management/integrations/fossa/) 、 [AWS Security Hub](/docs/vulnerability-management/integrations/aws/) 、 [Trivy](/docs/vulnerability-management/integrations/trivy) 、[Snyk](/docs/vulnerability-management/integrations/snyk/) 、 [Dependabot](/install/vm/)などの統合パートナーによって検出される脆弱性を含む、すべての脆弱性の鳥瞰図。 * アプリケーションやインフラストラクチャの脆弱性を継続的にランタイムで可視化 diff --git a/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx new file mode 100644 index 00000000000..d2e297454b8 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx @@ -0,0 +1,707 @@ +--- +title: 独自のワークフローを作成する +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic +metaDescription: Build custom workflows from scratch using drag-and-drop actions. Learn by example with a real-world EC2 automation scenario. +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +テンプレートがニーズに合わない場合は、 [「Create Your Own」を](https://onenr.io/0OQM47KgxjG)使用してカスタムワークフローを構築できます。ドラッグ アンド ドロップ インターフェイスを使用して[、アクション カタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)のアクションをプロセスに一致する自動化に連結します。 + +## このガイドの使い方 + +このガイドでは、概念と完全な例を使用してワークフローを構築する方法を説明します。学習パスを選択してください: + +* **まずコアコンセプトを学ぶ**→[コアコンセプト](#core-concepts)と[ワークフローパターン](#workflow-patterns)を読んで基礎を理解し、それを応用する + +* **例に従ってください**→[例のウォークスルー](#example-walkthrough)にジャンプして、EC2 自動サイズ変更ワークフローを段階的に構築します + +* **参考パターン**→ 独自のワークフローを構築する際のクイックリファレンスとして[ワークフローパターン](#workflow-patterns)セクションを使用してください + + + **ワークフローは初めてですか?**コアコンセプトから始めて、例に従ってください。EC2 ワークフローは、実際のシナリオにおけるすべての主要パターンを示します。 + + +## カスタムワークフローを構築する理由は何ですか? + +独自のワークフローを構築して、次のことを実現します。 + +* テンプレートがサポートしていない**独自のビジネスロジックを実装する** +* 標準テンプレートを超えて**複数のシステムを統合** +* 条件分岐で**複雑な決定を処理する** +* **チームの承認と通知のプロセスに合わせる** + +## コアコンセプト [#core-concepts] + +構築する前に、次の基本事項を理解してください。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **コンセプト** + + **何をするのか** + + **例** +
+ 入力と秘密 + + 認証情報と設定に関する問題 + + `${{ :secrets:awsKeyId }}` 資格情報の場合は`${{ .inputs.region }}`、構成の場合は 。 +
+ アクションカタログ + + 事前構築された統合 ( AWS 、Slack、データベース、API) + + `aws.ec2.stopInstances`ワークフローキャンバスにドラッグします +
+ データフロー + + ステップ間で出力を渡す + + `${{ .steps.getAlert.outputs.entityGuid }}` +
+ スイッチ + + 条件に応じて異なるパスを作成する + + `Route by CPU > 90% vs. 70-90% vs. < 70%` +
+ ループ + + リストを処理するか完了をポーリングする + + コレクションを反復処理するには、 `type: loop` `for`および`in`と一緒に使用します。 +
+ 承認ゲート + + 人間の決断を待つ + + 破壊的な行動の前に緩い反応 +
+ エラー処理 + + 失敗をキャッチしてクリーンアップを実行する + + ロールバック手順を含むtry-catchパターン +
+ + + **実践で学ぶ:**それぞれの概念は、以下の[例のウォークスルー](#example-walkthrough)で説明されています。実際のワークフローで、入力、スイッチ、ループ、承認ゲートが連携して動作する様子を確認できます。 + + +エラー処理パターンの詳細については、 [「ベストプラクティス」](/docs/workflow-automation/limitations-and-faq/workflow-best-practices#error-handling)を参照してください。 + +## クイックスタート [#quick-start] + +最初のワークフローを 5 つのステップで構築します。 + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**に移動し、**[Create Your Own](https://onenr.io/0OQM47KgxjG) \[独自の作成を]**選択します +2. 認証情報 (シークレット マネージャーから: `${{ :secrets:keyName }}` )、設定 (リージョン、インスタンスタイプ)、およびランタイム データ (アカウント ID、集計 ID) の定義 +3. [カタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)からアクションをドラッグし、 `${{ .steps.stepName.outputs.field }}`構文で接続してデータを渡します +4. 条件分岐用のスイッチ、リストやポーリングの処理用のループ、人間の決定のための承認ゲートを挿入します。 +5. 各セクションの後に実行してエラーを早期に発見し、ワークフローを[開始またはスケジュールします。](/docs/workflow-automation/create-a-workflow-automation/start-schedule) + + + 3 つのステップから始めて、徹底的にテストしてから拡張します。機能する 5 ステップのワークフローは、機能しない 20 ステップのワークフローよりも優れています。 + + +## 主要なワークフローパターン [#workflow-patterns] + +4 つの基本パターンで、ほとんどの自動化シナリオに対応します。各パターンについては、以下の[例のチュートリアル](#example-walkthrough)で説明します。 + +### スイッチを使った条件分岐 + +**次の場合にスイッチを使用します:**結果はデータに基づいて変化します (閾値チェック、 API応答、ユーザーの決定) + +**キー構文:** + +```yaml +- name: hasCompleted + type: switch + switch: + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}" + next: displayError + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}" + next: displaySuccess + next: displayUnexpected # Default path when no condition matches +``` + +**実際のアクションをご覧ください:**[チームの対応の処理](#handle-team-response)と[検証およびクリーンアップの](#verify-and-clean-up)セクションでは、Slack の反応と AWS SSM のステータスに基づいてスイッチのルーティングが表示されます。 + +### リストを処理するためのループ + +**ループを使用するのは、複数のアイテムを処理する場合やアクションを繰り返す場合です。** + +**キー構文:** + +```yaml +# Send progress updates using range loop +- name: progressLoop + type: loop + for: + in: "${{ [range(1; 5)] }}" # Loop 5 times + steps: + - name: wait + type: wait + seconds: 10 + - name: progressMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "${{ .workflowInputs.channel }}" + text: "Resizing in progress..." +``` + +**実際に動作しているところをご覧ください:**[サイズ変更セクションを実行すると、](#execute-the-resize)ステータスの更新に`progressLoop`が使用されます。 + +### 承認ゲートと待機 + +**承認ゲートを使用するのは、破壊的な操作やコンプライアンスの承認の前に人間の判断が必要な場合です**。 + +**キー構文:** + +```yaml +- name: requestApproval + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "#approvals" + text: "Approve? React with :thumbsup: or :thumbsdown:" + +- name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: "${{ .workflowInputs.slackToken }}" + channelID: "${{ .steps.requestApproval.outputs.channelID }}" + threadTs: "${{ .steps.requestApproval.outputs.threadTs }}" + timeout: 300 # Wait 5 minutes for reaction + +- name: checkApproval + type: switch + switch: + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}' + next: handleApproval + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}' + next: handleRejection +``` + +**単純な遅延の場合:** + +```yaml +- name: waitBeforeRetry + type: wait + seconds: 60 # Wait 60 seconds before continuing +``` + +**実際の手順をご覧ください:**[リクエスト チーム承認](#request-team-approval)セクションでは、完全な Slack 承認ワークフローが実装されます。 + +### ステップ間でのデータの受け渡し + +**データ受け渡しは次の場合に使用します:** 1 つのステップの出力が別のステップの入力になる場合 (すべてのワークフローの基礎) + +**キー構文:** + +```yaml +# Reference previous step outputs +awsRegion: "${{ .inputs.region }}" +instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}" +``` + +**実際に動作を確認してください。**すべてのセクションでデータの受け渡しが示され、各ステップは前の結果に基づいて構築されます。 + + + **完全なパターン例が必要ですか?**エラー処理、再試行、複雑な統合などの追加のパターンについては[、ワークフローの例を](/docs/workflow-automation/workflow-examples)参照してください。 + + +## ウォークスルーの例: 承認による EC2 の自動サイズ変更 [#example-walkthrough] + +この完全な例では、Slack 経由でチームの承認を得た後、CPU が急増したときに EC2 インスタンスのサイズを自動的に変更するワークフローを構築する方法を示します。 実際のシナリオでのデータ収集、条件付きロジック、外部統合、およびエラー処理を示します。 + + + **ワークフローは初めてですか?**この例では、AWS、Slack、承認ロジックを使用します。始めたばかりの場合は、まず[Slack にレポートを送信して](/docs/workflow-automation/create-a-workflow-automation/use-a-template#send-report-to-slack)みてください。 + + +### 前提条件 [#prerequisites] + +このワークフローを構築する前に、次のものを用意してください。 + +* **AWS** : EC2 および Systems Manager の権限を持つ認証情報 +* **Slack** : 通知用のボットトークンとチャンネル +* **New Relic** : アラート条件監視 EC2 CPU +* **シークレット マネージャー**: 構成済み ([シークレット管理を](/docs/infrastructure/host-integrations/installation/secrets-management/)参照) + +### ワークフローの概要 [#workflow-overview] + +**大まかなフロー:** + +1. **データを収集する**: New Relicから集計とインスタンスの詳細を取得します +2. **承認リクエスト**: Slack メッセージを送信し、チームの応答を待ちます +3. **サイズ変更の実行**: AWS Systems Manager を使用して EC2 インスタンスのサイズを変更します +4. **検証とクリーンアップ**: 結果を確認し、チームに通知し、一時的なリソースを削除します + +この例では、カスタム ワークフローで使用する主要なパターン (API のクエリ、条件分岐、外部統合、ポーリング ループ、エラー処理) を示します。 + +### ワークフロー入力 [#workflow-inputs] + + + **概念を理解するために読んでいる場合は飛ばしてください。**この表は、このワークフローで使用される 12 の問題の詳細を示しています。 ビルド時に参照することはできますが、フローを理解するために必須ではありません。 + + +このワークフローには、入力として資格情報、設定、およびランタイム コンテキストが必要です。 機密値は、 `${{ :secrets:keyName }}`構文を使用してシークレット マネージャーから取得されます。 + +**入力カテゴリ:** + +* **認証**: シークレットマネージャーからの AWS および Slack の認証情報 +* **まとめコンテキスト**: New Relicからのアカウント ID と問題 ID +* **設定**: リージョン、インスタンスタイプ、タイムゾーン、Slackチャンネル + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **問題の名前** + + **タイプ** + + **デフォルト値** + + **説明** +
+ `awsAccessKeyId` + + 弦 + + `${{ :secrets:awsAccessKeyId }}` + + AWSサービスで認証するためにシークレット マネージャーから取得したAWSアクセス キー ID。 +
+ `awsSecretAccessKey` + + 弦 + + `${{ :secrets:awsSecretAccessKey }}` + + シークレット マネージャーから取得した AWS シークレット アクセス キー。アクセスキーIDとペアになります。 +
+ `awsSessionToken` + + 弦 + + `${{ :secrets:awsSessionToken }}` + + 一時的な AWS 認証情報のセッショントークン (オプション、IAM ロールで使用)。 +
+ `slackToken` + + 弦 + + `${{ :secrets:slackToken }}` + + Slack でメッセージを投稿したり反応を読んだりするためのボット トークン。 +
+ `accountId` + + Int + + 必須 + + New Relic アカウント ID。集計詳細およびエンティティ データのクエリに使用されます。 +
+ `issueId` + + 弦 + + 必須 + + このワークフローをトリガーしたNew Relic集計の課題 ID。 ワークフローが累計から実行されるときに自動的に提供されます。 +
+ `awsRegion` + + 弦 + + `us-east-2` + + EC2 インスタンスが実行されるAWSリージョン (例: `us-east-1` 、 `us-west-2` 、 `eu-west-1` )。 +
+ `InstanceType` + + 弦 + + `t4g.nano` + + 目標 EC2 サイズ変更用インスタンスタイプ。 パフォーマンスのニーズと予算に基づいて選択してください。 +
+ `timestampUnit` + + 弦 + + `MILLISECONDS` + + 積算タイムスタンプの時間単位。 通常は`MILLISECONDS`または`SECONDS`です。 +
+ `timezoneId` + + 弦 + + `America/Los_Angeles` + + Slack メッセージで一括アクティベーション時間を表示するためのタイムゾーン (例: `America/New_York` 、 `Europe/London` 、 `Asia/Tokyo` )。 +
+ `pattern` + + 弦 + + `MM-dd-yyyy HH:mm` + + タイムスタンプを表示するための日付/時刻形式パターン。Java SimpleDateFormat パターンを使用します。 +
+ `channel` + + 弦 + + 必須 + + 通知が投稿される Slack チャンネル ID (名前ではありません)。Slack のチャンネル詳細でこれを見つけてください。 +
+ + + +## ワークフローを段階的に構築する [#step-by-step-workflow] + +それでは、ワークフローの各部分を構築してみましょう。各ステップには、追加する特定のアクションと、それらが示すワークフロー パターンが含まれます。 + + + + ### まとまったコンテキストを収集する [#gather-alert-context] + + アクションを実行する前に、API とデータベースをクエリします。これにより、完全なコンテキストが確保されます。 + + ワークフローは、次の 3 つのアクションを使用して、集計および EC2 インスタンス情報を収集します。 + + * **`getAlertDetails`** : NerdGraph API ( New RelicのGraphQL API ) を呼び出して、アクティブ化時刻、条件名、影響を受けるエンティティなどの細分メタデータを取得します。 + + * **`activatedDateTime`** : Slack メッセージのタイムスタンプを「01-24-2025 14:30」のような読み取り可能な形式に変換します。 + + * **`impactedEC2Instance`** : NRDB ( New Relicデータベース) を使用して EC2 インスタンス ID と現在のタイプを見つけます。 + + Workflow diagram showing three steps: getAlertDetails queries NerdGraph API, activatedDateTime converts timestamp, and impactedEC2Instance retrieves instance details from NRDB + + **これが重要な理由:**これらの詳細がなければ、意味のある Slack メッセージを作成したり、適切な EC2 インスタンスをターゲットにしたりすることはできません。 + + + + ### チームの承認をリクエスト [#request-team-approval] + + 人間の意思決定ポイントのために、Slack、PagerDuty、ServiceNow などのコラボレーション ツールに接続します。 + + ワークフローは詳細を Slack に送信し、応答を待ちます。 + + * **`IssueDetected`** : 集計の詳細、現在のインスタンスタイプ、および提案されたサイズ変更を Slack に投稿します。 チームに`:+1:` (承認) または`:-1:` (キャンセル) で反応するよう求めます。 + + * **`GetUserReaction`** : 反応を待つために 5 分 (300 秒) 間一時停止します。 + + * **`checkQuery` (スイッチ)** : 反応に基づいたルート: + + * **`:+1:`** → サイズ変更を開始 + * **`:-1:`** → ワークフローを停止 + * **その他**→ 有効な反応のプロンプト、ループバック + + Workflow diagram showing user approval process: IssueDetected posts Slack message, GetUserReaction waits for response, checkQuery evaluates reactions with three conditions for approval, cancellation, or unexpected responses + + + **よくある問題:**チャンネル名ではなく、Slack チャンネル**ID** ( `C01234ABCD` ) を使用してください。Slack のチャンネル詳細で見つけてください。詳細については[トラブルシューティング](#common-issues)を参照してください。 + + + + + ### チームの対応を処理する [#handle-team-response] + + スイッチを使用して、データ値またはユーザー入力に基づいて異なるパスを作成します。 + + ワークフローは反応に基づいて分岐します。 + + * **`unexpectedReaction`** : 有効な反応を説明し、再度待機するためにループします。 + * **`gotCancelReaction`** : キャンセルを確認し、完了までスキップします。インフラストラクチャの変更はありません。 + * **`gotYesReaction`** : 承認を確認し、サイズ変更に進みます。 + + + **承認ゲート パターン:**リスクのある変更の前に人間の判断が必要な場合は、このようなスイッチを使用します。このパターンは、Slack の反応、PagerDuty の確認、電子メールの応答、またはカスタム Webhook で機能します。 + + + + + ### サイズ変更を実行する [#execute-the-resize] + + 重複した操作を防ぐために、一意のトークンを使用します。ループを使用して、長時間実行される操作のステータスを確認します。 + + ワークフローは、AWS Systems Manager (SSM) を通じてインスタンスのサイズを変更します。 + + * **`createSsmDocument`** : インスタンスを停止し、タイプを変更して再起動する SSM 自動化ドキュメントを作成します。 + * **`generateIdempotencyToken`** : 一意の UUID を作成します。ワークフローが 2 回実行された場合に、重複したサイズ変更を防止します。 + * **`startResizing`** : インスタンス ID と新しいタイプを使用して SSM ドキュメントを実行します。 + * **`progressLoop` (ループ)** : Slack の更新を 10 秒ごとに投稿します (合計 5 回)。 + * **`waitForCompletion`** : 2 分間のタイムアウトで SSM ステータスをポーリングします。 + + + **SSM を使用する理由**Systems Manager は、エラー処理、状態検証、CloudTrail 監査ログを提供します。直接 EC2 APIコールよりも優れています。 + + + + **一般的な問題:** AWS 認証情報に`ec2:StopInstances` 、 `ec2:ModifyInstanceAttribute` 、 `ec2:StartInstances` 、および`ssm:*`権限があることを確認します。権限が不足している場合は、何も表示されずに失敗します。 + + + + + ### 検証とクリーンアップ [#verify-and-clean-up] + + 失敗を計画し、結果に関係なく一時的なリソースをクリーンアップします。 + + ワークフローは結果をチェックし、一時リソースを削除します。 + + * **`hasCompleted` (スイッチ)** : SSM ステータス (成功/失敗/タイムアウト) に応じて分岐します。 + * **`displaySuccess`** : New Relicに成功をログします。 + * **`sendSuccessMessage`** : Slack で完了を確認します。 + * **`displayError`** : トラブルシューティングのエラー詳細をログに記録します。 + * **`displayUnexpected`** : 異常な状態 (手動キャンセルなど) をログに記録します。 + * **`cleanupSsmDocument`** : 一時 SSM ドキュメントを削除します。 + * **`sendSSMCleanMessage`** : Slack でクリーンアップを確認します。 + * **`workflowCompleted`** : 最終完了メッセージ (成功またはキャンセルの場合に実行されます)。 + + + * **常に掃除をしてください。**前のステップが失敗した場合でもクリーンアップが実行されるようにワークフローを構成します。これにより、リソースの漏洩や予期しない AWS 料金の発生を防ぐことができます。 + * **一般的な問題:** SSM がタイムアウトしても、EC2 インスタンスは依然として状態間で遷移している可能性があります。 再実行する前に、 AWS Console実際のインスタンスのステータスを確認してください。 + + + + +## 次のステップ + +### 実行と管理 + +* **[ワークフローの開始とスケジュール](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: 手動でトリガーするか、自動的にスケジュールします。 +* **[ワークフローの管理](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: ワークフローを編集、バージョン管理、複製、または非アクティブ化します。 + +### 改善する + +* **[ベストプラクティス](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: エラー処理、シークレット管理、パフォーマンス、テスト。 +* **[アクション カタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: AWS、Azure、GCP、HTTP、データ変換。 +* **[ワークフローの例](/docs/workflow-automation/workflow-examples)**: より現実的な自動化シナリオ。 + +### 規模 + +* **[ワークフロー自動化 API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)** : インフラストラクチャをコードとして API 経由でデプロイします。 +* **[ワークフローの制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: タイムアウト、アクションの制限、ペイロードの制約。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx new file mode 100644 index 00000000000..2d692d80c82 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx @@ -0,0 +1,164 @@ +--- +title: ワークフロー自動化を管理する +tags: + - Workflow Automation + - workflow + - build a workflow using New Relic +metaDescription: 'Navigate the workflow dashboard to view, edit, duplicate, delete, and monitor workflows in New Relic.' +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +[ワークフロー オートメーション ダッシュボードは、](https://onenr.io/0gR7XE8LXjo)アカウント内のすべてのワークフローを表示、管理、監視するための中心的な場所を提供します。 ダッシュボードを使用して、設定の編集、バージョン履歴の追跡、実行スケジュールの管理、障害のトラブルシューティングを行います。 + +## 一般的なタスク + +ワークフロー管理操作へのクイックアクセス: + +* **[ワークフローの表示](#view-workflows)**- ダッシュボードにアクセスしてワークフローをフィルタリングする +* **[ワークフローを編集する](#edit-a-workflow)**- 構成または設定を更新する +* **[バージョンの管理](#manage-versions)**- 自動バージョン管理とスケジュール用のバージョンのピン留めについて理解する +* **[ワークフローを複製する](#duplicate-a-workflow)**- テンプレートを適用するときにワークフローをコピーします +* **[ワークフローを削除する](#delete-a-workflow)**- ワークフローを完全に削除します + +## あなたが始める前に + +ワークフローを管理する前に、次の点を確認してください。 + +* ワークフロー自動化アクセス権を持つアクティブな New Relic アカウント。 +* アカウント内に少なくとも 1 つのワークフロー (テンプレートまたはカスタム構築から)。 +* ワークフローの権限を編集および削除します。 + +**ワークフローは初めてですか?**最初のワークフローを構築するには、 [「テンプレートの使用」](/docs/workflow-automation/create-a-workflow-automation/use-a-template)または[「独自のワークフローの作成」](/docs/workflow-automation/create-a-workflow-automation/create-your-own)から始めます。 + +## ワークフローを表示 [#view-workflows] + +ワークフロー ダッシュボードには、アカウント内のすべてのワークフローが、管理に役立つ重要な情報とともに表示されます。 + +### ダッシュボードにアクセスする + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 + +2. ダッシュボードには、すべてのワークフローと次の情報が表示されます。 + + * **名前**: 作成時に割り当てたワークフロー識別子 + * **説明**: ワークフローの目的または機能 + * **ステータス**: 現在の状態 (アクティブ、非アクティブ、失敗) + * **バージョン**: 変更を追跡するための現在のバージョン番号 + * **最終実行**: 最新の実行のタイムスタンプ + * **作成者**: ワークフローを作成したユーザー + +### フィルタリングと検索のワークフロー + +特定のワークフローを見つけるには、検索およびフィルター オプションを使用します。 + +* **検索バー**: ワークフロー名または説明のキーワードを入力 +* **ステータスフィルター**: アクティブ、非アクティブ、または失敗したワークフローのみを表示します +* **並べ替えオプション**: 名前、最終ランタイム、または作成日で並べ替えます。 + +## ワークフローを編集する [#edit-a-workflow] + +ワークフローの名前、説明、または設定を更新します。 各ワークフロー名の横にあるその他のオプション メニュー (縦に並んだ 3 つのドット) からワークフロー管理オプションにアクセスします。 + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 + +2. リストからワークフローを選択します。 + +3. ワークフローの詳細を更新します。 + + * **名前**: ワークフロー識別子を変更する + * **説明**: ワークフローの目的の説明を変更します + * **設定**: 入力、アクション、またはロジックを調整する + +4. **\[保存]**をクリックします + +## バージョンを管理する [#manage-versions] + +ワークフロー オートメーションは、ワークフロー定義を更新するたびに新しいバージョンを自動的に作成します。 以前のバージョンはすべて参照用に引き続きご利用いただけます。 + +### スケジュール用のバージョン固定 + +ワークフローをスケジュールするときは、それを特定のバージョンに固定する必要があります。この要件により、ワークフロー定義を更新した場合でも、スケジュールされた実行で同じテスト済みバージョンが引き続き実行されることが保証されます。 + +**開始およびスケジュールワークフローはバージョン固定をサポートします。** + +* ワークフローをスケジュールするときに、実行するバージョンを指定します +* ワークフロー実行を手動で開始する場合は、実行するバージョンを選択します +* 既存のスケジュールは、更新するまで固定されたバージョンを使用し続けます。 + +これにより、次のことが可能になります。 + +* 実行スケジュールに影響を与えずにワークフローを更新する +* スケジュールを更新する前に新しいバージョンを手動でテストする +* 生産ワークフローの安定性を維持する + +## ワークフローを複製する [#duplicate-a-workflow] + +元のワークフローをそのまま保持しながら、テンプレートまたは既存のワークフローを別の目的に適応させる必要がある場合は、ワークフローを複製します。 + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 +2. 複製したいワークフローを見つけます +3. 省略記号（縦に3つの点）をクリックします +4. **Duplicate** \[複製を]選択 +5. システムは名前に「(コピー)」を追加したコピーを作成します +6. 複製したワークフローの名前を変更し、ニーズに合わせてカスタマイズします + +**一般的な重複シナリオ:** + +* 特定のユースケースに合わせてワークフローテンプレートを調整する +* 同様の要件を持つ別のチーム用のワークフローを作成する +* オリジナルを維持しながら大幅な変更を試みる + + + **不要な重複を避ける:**バージョン管理やロールバックの目的でワークフローを重複させないでください。ワークフローを更新すると、システムによって自動的にバージョンが作成されます。重複が多すぎると、ワークフローの制限に達する可能性があります。自動バージョン管理の詳細については、 [「バージョンの管理」](#manage-versions)を参照してください。 + + +## ワークフローを削除する [#delete-a-workflow] + +不要になったワークフローを削除します。 + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 +2. 削除したいワークフローを見つけます +3. その他のオプションメニュー（縦に3つの点）をクリックします +4. **Delete** \[削除を]選択 +5. ダイアログボックスで削除を確認します + + + ワークフローを削除すると、すべてのバージョンと実行履歴が削除されます。この操作は元に戻せません。後でワークフローが必要になる可能性がある場合は、削除するのではなく非アクティブ化することを検討してください。 + + +**削除されるもの:** + +* ワークフローのすべてのバージョン +* すべての実行履歴とログ +* ワークフローに関連付けられたすべてのスケジュール実行 + +**削除する前に、次の点を確認してください。** + +* このワークフローに依存する重要な自動化はありません +* 後で必要になるかもしれないので、バックアップコピーを用意しておく +* すべてのスケジュールされた実行が識別され、記録されます + +## 次のステップ + +ワークフロー ダッシュボードに慣れたら、次のリソースを調べてください。 + +**ワークフローの実行と監視:** + +* **[ワークフローの開始とスケジュール](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: ワークフローを手動でトリガーするか、自動スケジュールを設定します + +**ワークフローを改善します。** + +* **[ベストプラクティス](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: エラー処理、パフォーマンス、信頼性のパターン +* **[ワークフローの制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: タイムアウト、アクション、ペイロードの制約を理解する + +**さらに多くのワークフローを作成します。** + +* **[テンプレートを使用する](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: 一般的なシナリオ用のデプロイ事前構築ワークフロー +* **[独自のワークフローを作成する](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**:カスタム自動化をゼロから構築する \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx new file mode 100644 index 00000000000..63aaf336698 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx @@ -0,0 +1,237 @@ +--- +title: ワークフローを開始してスケジュールする +tags: + - workflow automation + - workflow + - start a workflow automation + - start workflow automation on demand + - schedule workflows +metaDescription: Trigger workflows manually or schedule them to run automatically at specified times using NerdGraph APIs. +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +ワークフローを作成したら、オンデマンドで手動で実行したり、特定の時間に自動的に実行するようにスケジュールしたりできます。どちらの方法でも、 [NerdGraph API を](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)使用してワークフローの実行をトリガーします。 + +## トリガー方法を選択してください + +ユースケースに適したアプローチを選択してください。 + +| **オンデマンドで使用** | **スケジュール使用** | +| -------------- | -------------------- | +| 新しいワークフローのテスト | 定期的な健康診断 | +| 手動承認ワークフロー | 定期的なデータ処理 | +| 集中トリガーの応答 | 日次/週次レポート | +| アドホックメンテナンスタスク | スケジュールされたメンテナンスウィンドウ | +| 1回限りの操作 | 定期的なバックアップまたはクリーンアップ | + +## あなたが始める前に + +ワークフローをトリガーする前に、次のことを確認してください。 + +* **ワークフローが作成されました**: ワークフロー定義はすでにアカウントにデプロイされています ([テンプレート](/docs/workflow-automation/create-a-workflow-automation/use-a-template)または[カスタム構築](/docs/workflow-automation/create-a-workflow-automation/create-your-own)から)。 +* **アカウント ID** : New Relic アカウント ID ([アカウント設定](/docs/accounts/accounts-billing/account-structure/account-id)で確認できます)。 +* **ワークフロー名**: ワークフロー定義の正確な名前。 +* **必須入力**: ワークフローが期待するすべての値。 +* **構成されたシークレット**: AWS 認証情報、Slack トークン、または[シークレット マネージャー](/docs/infrastructure/host-integrations/installation/secrets-management/)に保存されているその他のシークレット。 + + + **ワークフローは初めてですか?**ワークフローをトリガーする前に、最初のワークフローを作成します。事前に構築されたワークフローの[テンプレートの使用](/docs/workflow-automation/create-a-workflow-automation/use-a-template)から始めます。 + + +## オンデマンドでワークフローを実行する [#on-demand] + +[StartWorkflowRun API を](/docs/workflow-automation/workflow-automation-apis/start-workflow-run)使用してワークフローを手動でトリガーします。これにより、指定した入力に基づいてワークフローが直ちに実行されます。 + +### 例: AWS Lambda関数を呼び出す + +次のワークフロー定義は、 AWS Lambda関数を呼び出し、出力をログに記録します。 `12345678` New Relic アカウント ID に置き換えます。 + +```yaml + name: lambda1 + + workflowInputs: + username: + type: String + defaultValue: "User" + key: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_ACCESS_KEY_ID }}" + access: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SECRET_ACCESS_KEY }}" + token: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SESSION_TOKEN }}" + region: + type: String + defaultValue: us-east-1 + + steps: + - name: invoke1 + type: action + action: aws.lambda.invoke + version: 1 + inputs: + awsAccessKeyId: ${{ .workflowInputs.key }} + awsSecretAccessKey: ${{ .workflowInputs.access }} + awsSessionToken: ${{ .workflowInputs.token }} + region: ${{ .workflowInputs.region }} + functionName: hello-you + payload: + user: ${{ .workflowInputs.username }} + + - name: logOutput + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'The lambda function message output is:${{ .steps.invoke1.outputs.payload.body }}' +``` + +このワークフローを開始するには、次の NerdGraph ミューテーションを使用します。このミューテーションを実行する前に、 `secretsManagementCreateSecret`ミューテーションを使用して AWS 認証情報を保存していることを確認してください。詳細については、 [「シークレット管理の概要」](/docs/apis/nerdgraph/examples/nerdgraph-secrets-management)を参照してください。 + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "Julien"} + ] + ) { + runId + } +} +``` + +**問題は次のように説明しました。** + +* `scope`: ワークフロー定義が保存されているアカウントID +* `definition`: 実行するワークフローの名前（ワークフロー定義の`name`フィールドと一致する必要があります） +* `workflowInputs`: ワークフロー定義の`workflowInputs`セクションのデフォルト値をオーバーライドするキーの値のペア + +ミューテーションは`runId` (たとえば、 `7bd25287-2af8-42e1-b783-80f4e760a40b` ) を返します。この ID を使用してログをクエリし、出力を表示します。 + +Workflow automation logs showing the Lambda function output + +## ワークフローのスケジュール [#scheduled] + +[CreateSchedule API を](/docs/workflow-automation/workflow-automation-apis)使用して、ワークフローが特定の時間に自動的に実行されるようにスケジュールします。スケジュールされたワークフローは、手動による介入なしに定期的なタスクを実行します。 + +**ワークフローをスケジュールするタイミング:** + +* 定期的な健康診断 +* 定期的なデータ処理 +* 日次/週次レポート +* スケジュールされたメンテナンスウィンドウ +* 定期的なバックアップまたはクリーンアップ + +### Cron式リファレンス + +スケジュールでは、cron 式を使用してワークフローの実行タイミングを定義します。形式： `minute hour day month weekday` + +| **パターン** | **説明** | **使用例** | +| -------------- | ---------- | ------------- | +| `0 9 * * *` | 毎日午前9時 | 毎朝の健康チェック | +| `0 9 * * 1-5` | 平日午前9時 | 営業日の運営 | +| `0 */6 * * *` | 6時間ごと | 定期的な同期操作 | +| `0 0 1 * *` | 月初めの日の深夜0時 | 月次レポート | +| `*/15 * * * *` | 15分ごと | 頻繁な投票 | +| `0 0 * * 0` | 毎週日曜日の深夜 | 毎週のクリーンアップタスク | + + + **Cron 構文:** `*`は「すべて」、 `/`は「n 番目ごと」、 `-` 「範囲」を意味します。例: `0 9 * * 1-5` = 毎月、毎日、月曜日から金曜日の 0 分、9 時。 + + +### 例: 毎日の健康診断をスケジュールする + +次の例では、 `lambda1`ワークフローを毎日東部標準時の午前 9 時に実行するようにスケジュールします。 + +```graphql +mutation { + workflowAutomationCreateSchedule( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Configure the schedule + schedule: { + # Cron expression: minute hour day month weekday + # "0 9 * * *" = every day at 9:00 AM + cronExpression: "0 9 * * *" + + # Timezone for the schedule + timezone: "America/New_York" + + # Optional: Schedule name for identification + name: "daily-lambda-health-check" + + # Optional: Add a description + description: "Runs Lambda health check every morning at 9 AM" + } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "HealthCheckBot"} + ] + ) { + scheduleId + } +} +``` + +**返されるもの:** + +* `scheduleId`: スケジュールの一意の識別子（後でスケジュールを更新または削除するために使用します） + +### スケジュールを管理する + +スケジュールを作成した後: + +* **アクティブなスケジュールの表示**:[ワークフロー ダッシュボード](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs)でスケジュールされたすべての実行を表示します。 +* **更新スケジュール**: UpdateSchedule APIを使用して頻度または入力を変更します +* **スケジュールの削除**: 定期的な実行を停止するには、DeleteSchedule API を使用します。 + +完全な API ドキュメントについては、 [「ワークフロー自動化 API」](/docs/workflow-automation/workflow-automation-apis)を参照してください。 + +## 次のステップ + +ワークフローが実行中です。次に行うべきことは次のとおりです。 + +**以下を監視および管理します。** + +* **[ワークフローの管理](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: 実行履歴の表示、ログの確認、問題のトラブルシューティング +* **[ワークフローのトラブルシューティング](/docs/workflow-automation/troubleshooting)**: 一般的な実行問題を解決する + +**生産向けに最適化:** + +* **[ベストプラクティス](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: エラー処理、パフォーマンス、信頼性のパターン +* **[ワークフローの制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: タイムアウトと制約の制限を理解する + +**ワークフローを拡張します。** + +* **[アクション カタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: 利用可能なすべての統合を探索します。 +* **[ワークフロー オートメーション API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)** : プログラムによるワークフロー管理 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx new file mode 100644 index 00000000000..1c931f8a947 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx @@ -0,0 +1,284 @@ +--- +title: テンプレートを使用してワークフロー自動化を作成する +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic + - workflow template +metaDescription: 'Jump-start your automation with pre-built workflow templates. Deploy in minutes, customize to your needs, and automate common tasks.' +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +テンプレートは、Slack へのレポートの送信、デプロイメントのロールバック、EC2 インスタンスのサイズ変更など、一般的なシナリオ向けに事前構成されたワークフローを提供します。 数分でデプロイし、チームのプロセスに合わせてカスタマイズします。 + +## テンプレートを使用する理由は何ですか? + +* **より迅速に開始**: 作業自動化を数分でデプロイ +* **ベストプラクティスに従う**: 実証済みのパターンとエラー処理を使用する +* **例で学ぶ**: アクションがどのように接続され、データがどのように流れるかを確認します +* **エラーを減らす**: テスト済みの設定から始める + +## あなたが始める前に + +ほとんどのテンプレートには認証情報と統合が必要です。 + +* **AWS テンプレート**: 権限のある[AWS 認証情報](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)(EC2、API Gateway、Systems Manager、または SQS)。 +* **Slack 通知**: ボット トークンとチャンネル アクセスを備えた Slack アプリ。 +* **すべてのテンプレート**: New Relicアカウントおよびエンティティ GUID (監視リソースの一意の識別子)。 + + + **まだ資格情報をお持ちではありませんか?**まずテンプレートを参照してください。デプロイする前に資格情報を設定します。 + + +## テンプレートをデプロイする + + + + ### 適切なテンプレートを見つける + + 以下の[テンプレート ライブラリ](#workflow-automation-templates)を参照してください。それぞれ、機能、使用時期、要件、および動作方法を示します。 + + + + ### デプロイして構成する + + 1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 + 2. **Use a Template** \[テンプレートの使用を]選択 + 3. テンプレートを選択してください + 4. 入力内容を入力します（資格情報、エンティティ GUID、クエリ、チャネル） + 5. セレクト**Deploy** \[デプロイ] + + ワークフローがアクティブになりました。 + + + + ### テストと検証 + + 実稼働前にテストする: + + 1. 手動でトリガーする（[オンデマンドでワークフローを開始するを](/docs/workflow-automation/create-a-workflow-automation/start-schedule#on-demand)参照） + 2. 実行履歴での実行の監視 + 3. 出力を確認する（Slack メッセージ、AWS の変更、ログ） + 4. エラーを確認し、設定を調整する + + + **まず非本番環境でテストします。**一部のテンプレートではインフラストラクチャが変更されます。実稼働で使用する前に検証します。 + + + + +## テンプレートをカスタマイズする + +デプロイメント後にワークフローを変更する: + +* **条件付きロジックを追加**: 条件に基づいてステップをスキップする +* **チェーンテンプレート**: 出力を他のワークフローの入力として使用する +* **通知の調整**：形式、受信者、チャネルを変更する +* **カスタムアクションの追加**: HTTP requestsまたはデータ変換を含める + +詳細については、 [「独自のワークフローを作成する」](/docs/workflow-automation/create-a-workflow-automation/create-your-own)を参照してください。 + +## トラブルシューティングテンプレート + +ワークフローが失敗したり、期待どおりに動作しない場合は、次の手順に従ってください。 + +1. **実行履歴を確認します**。**Workflow Automation > \[あなたのワークフロー] > Run History**、実行ログとエラーメッセージを確認します。 + +2. **一般的な問題を確認する**: 次の問題の解決策については、 [「ワークフロー自動化のトラブルシューティング」](/docs/workflow-automation/troubleshooting)を参照してください。 + + * AWS 認証情報と権限のエラー + * Slack 統合の問題 + * エンティティ GUID の問題 + * NRQL失敗 + * ワークフローのタイムアウト + * テンプレート固有のトラブルシューティング + + + **テンプレートを安全にテストする**: 必ず最初に本番環境以外の環境でテストしてください。 インフラストラクチャを変更するテンプレート (EC2、API ゲートウェイ) は、誤って構成された場合、可用性に影響を与える可能性があります。 + + +## ワークフロー自動化テンプレート + + + + **機能:** + + New RelicデータをNRQL （ New Relic書き込み言語）で作成し、結果を CSV としてフォーマットし、Slack に投稿します。 + + **いつ使うのか:** + + 定期レポートを自動化します: 日次パフォーマンス概要、週次エラー率、時間別の実行量、またはカスタムメトリック。 + + **必要なもの:** + + * **Slack** : チャンネル投稿権限を持つボットトークン + * **New Relic** : アカウントアクセスと有効なNRQL書き込み + + **使い方：** + + 1. NRQL実行します + 2. 結果をCSVに変換します + 3. Slackへの投稿 + 4. ログのステータス + + + + **機能:** + + デプロイメントの問題を検出し、チームの承認を得た後、 AWS API Gateway を以前の設定にロールバックします。 + + **いつ使うのか:** + + スパイクエラー、インテグレーションの中断、またはインシデントの原因となる悪いデプロイメントを元に戻します。 高リスクの変更に対するセーフティネット。 + + **必要なもの:** + + * **AWS** : API Gateway と Systems Manager の権限 + * **Slack** : 通知と承認のためのアプリ + * **New Relic** : API ゲートウェイ エンティティ GUID + + **使い方：** + + 1. デプロイメント履歴を取得します + 2. 現在の問題と相関関係がある + 3. Slackの承認をリクエスト + 4. 承認された場合はロールバックを実行します + 5. チームに通知してクリーンアップする + + + **手動承認が必要です。**Slack の反応によるチームの承認がなければロールバックされません。 + + + + + **機能:** + + CPU またはリソースが急増したときに EC2 インスタンスのサイズを自動的に変更します。 + + **いつ使うのか:** + + トラフィックの急増時の CPU スパイクを処理し、制限に達したインスタンスをスケーリングし、予測できない負荷パターンを管理します。 + + **必要なもの:** + + * **AWS** : EC2 および Systems Manager の権限 + * **Slack** : 通知と承認のためのアプリ + * **New Relic** : アラート条件監視 EC2、 [AWS CloudWatch Metric Streams](https://docs.newrelic.com/install/aws-cloudwatch/) 、 [EC2 監視統合](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) + + + **CloudWatch Metric Streamsを使用します。** カスタムネームスペースを含む、 AWSメトリクスの完全なカバレッジを提供します。 + + + **使い方：** + + 1. 集計を取得してインスタンスを特定 + 2. Slackの承認をリクエスト + 3. 自動化ドキュメントを作成する + 4. インスタンスを停止、変更、起動する + 5. 進捗状況を更新してクリーンアップします + + + + **機能:** + + 外部ステータス ページから JSON を取得し、コンポーネントのヘルスを解析し、New Relic にログを記録します。 + + **いつ使うのか:** + + サードパーティの依存関係 (決済処理業者、認証プロバイダー、データ サービス) を監視し、障害と問題を関連付け、統合ダッシュボードを作成します。 + + **必要なもの:** + + * **API アクセス**: JSON を返すパブリック ステータス エンドポイント + * **New Relic** : ログ記録用のアカウント + + **使い方：** + + 1. エンドポイントからJSONを取得します + 2. コンポーネントの健全性を解析する + 3. 運用状況を分類する + 4. フィルターを使用してNew Relicにログを記録する + + + **5 ～ 15 分ごとにスケジュールを設定して、**サードパーティの信頼性の履歴ビューを構築します。 + + + + + **機能:** + + デプロイメント後のアプリケーションの健全性を監視し、問題が発生した場合に通知を送信します。 + + **いつ使うのか:** + + デプロイメント後の新しいリリースを監視し、運用環境のみの問題を検出し、健全性の低下に対してワークフローのロールバックをトリガーします。 + + **必要なもの:** + + * **New Relic** : 監視用のエンティティ GUID + * **通知**（いずれかまたは両方を選択）：AWS SQS 権限または HTTP Webhook エンドポイント + + **使い方：** + + 1. 1～5分ごとに健康状態を監視 + 2. まとめ重大度を評価します + 3. 劣化時に通知（SQS/Webhook）を送信します + 4. すべてのヘルスチェックをログに記録します + 5. 停止または回復するまで継続します + + + **[変更追跡 (変更追跡機能)](/docs/change-tracking/change-tracking-introduction)と併用して、**問題をデプロイメントと関連付けます。 + + + + + **機能:** + + NRLens (高度な書き込みツール) を使用して、 New Relicのデータカタログに対して SQL 書き込みを実行します。 + + **いつ使うのか:** + + NRQLを超えた複雑な分析：複数テーブル結合、統計分析、メトリクス/イベント/ログを組み合わせたカスタムレポート。 + + **必要なもの:** + + * **NRLens** : SQL クエリ ゲートウェイの資格情報 + * **New Relic** : 組織とアカウントID + + **使い方：** + + 1. NRLensに接続 + 2. SQLを実行する + 3. 結果を取得します + 4. New Relicへのログ + 5. スケジュールをサポート + + + **NRLens は NRQL を拡張します。**リアルタイム クエリには NRQL を使用し、複雑な分析ワークロードには NRLens SQL を使用します。 + + + + +## 次のステップ + +### 実行と管理 + +* **[ワークフローの開始とスケジュール](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: 手動でトリガーするか、自動的にスケジュールする +* **[ワークフローの管理](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: ワークフローの編集、複製、削除 + +### カスタムビルド + +* **[独自のワークフローを作成する](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**:カスタムロジックでゼロから構築 +* **[ベストプラクティス](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 信頼性が高く、本番環境に対応した自動化のパターン + +### 規模 + +* **[ワークフロー オートメーション API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)** : CI/CDまたはインフラストラクチャ-as-code と統合 +* **[ワークフローの制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: タイムアウト、レート制限、制約 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/introduction-to-workflow.mdx b/src/i18n/content/jp/docs/workflow-automation/introduction-to-workflow.mdx new file mode 100644 index 00000000000..887cfc7c534 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/introduction-to-workflow.mdx @@ -0,0 +1,148 @@ +--- +title: ワークフロー自動化入門 +tags: + - workflow automation + - workflow + - automation +metaDescription: Automate routine tasks and incident responses with Workflow Automation in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +ワークフロー自動化は、New Relic を既存のツールに接続し、コードを記述することなく、インシデント対応、インフラストラクチャ管理、運用タスクを自動化します。アラートに応答し、AWS および Slack と統合し、承認を管理し、複雑な自動化ロジックを実行するワークフローを構築します。 + +Screenshot showing the workflow automation interface + +## 主なメリット + +* **より高速なインシデント対応**: アラートの起動時に EC2 インスタンスのサイズ変更、デプロイメントのロールバック、またはサービスの再起動が自動的に行われます。手動介入は必要ありません。 +* **ツールを接続**: New Relic AWS 、Slack、Jira、ServiceNow、その他の HTTP APIと統合して、チームが作業している場所に強化された集計データを送信します。 +* **承認ゲートの追加**: 重要なワークフローに人間による監視を組み込み、本番環境のインフラストラクチャを拡張したりロールバックを実行したりする前に、チームの確認を要求します。 +* **複雑さへの対応**: 条件付きロジック、ループ、データ変換を使用して、独自の運用プロセスを自動化します。 + +## 一般的な使用例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ カテゴリー + + 例 +
+ **インシデント対応** + + アラートに基づいて、問題を自動的に修復し、失敗したデプロイメントをロールバックし、インフラストラクチャのサイズを変更します。 +
+ **インフラストラクチャ管理** + + スケジュールに従ってサービスを拡張し、AWS リソースを管理し、ランブックを自動的に実行します。 +
+ **通知** + + 充実したアラートを Slack に送信し、スケジュールされたレポートを生成し、データを CSV としてフォーマットします。 +
+ **インテグレーション** + + 任意の API に接続し、システム間でデータを同期し、チケットプラットフォームを更新します。 +
+ +詳細なシナリオとすぐに使用できるテンプレートについては、[ワークフロー例の](/docs/workflow-automation/workflow-examples)ページを参照してください。 + +## 始めましょう + +構築したいものに応じてパスを選択します。 + + + + テンプレートを使用するカスタムワークフローを構築する インテグレーションをセットアップする + + + + + デプロイは、Slack へのレポートの送信、デプロイメントのロールバック、EC2 インスタンスのサイズ変更など、一般的なシナリオ向けにワークフローを事前構成しました。 + + 1. [利用可能なテンプレート](/docs/workflow-automation/create-a-workflow-automation/use-a-template)を参照する + 2. ユースケースに合ったテンプレートを選択してください + 3. 入力を構成する（資格情報、エンティティ GUID、クエリ） + 4. デプロイとテスト + + + + ドラッグ アンド ドロップ インターフェースを使用して、ワークフローを最初から構築します。アクションをチェーンし、条件付きロジックを追加し、ツールと統合します。 + + 1. [EC2の自動サイズ変更の例](/docs/workflow-automation/create-a-workflow-automation/create-your-own)を確認する + 2. ワークフローパターン（スイッチ、ループ、承認）を理解する + 3. 利用可能な[アクション](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)を参照 + 4. 段階的に構築し、各ステップをテストする + + + + ワークフローが外部サービスと対話できるように、資格情報と通知チャネルを構成します。 + + **AWS ワークフロー**: [AWS 認証情報 (IAM ロール、ユーザー、またはセッション トークン) を設定する](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials) + + **通知**:[送信先の作成](/docs/workflow-automation/setup-and-configuration/create-destinations)(Slack、メール、Webhook) + + + + +## 次のステップ + +最初のワークフローを作成したら、次の管理と最適化の方法を学びます。 + + + + * **[ワークフローの開始とスケジュール](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: 手動でトリガーするか、cron 式を使用して定期的な実行を設定します。 + * **[ワークフローの管理](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**：設定の編集、異なる環境への複製、実行履歴の監視 + + + + * **[トラブルシューティング](/docs/workflow-automation/troubleshooting)**: 資格情報エラー、統合の問題、ワークフローの失敗を修正します。 + * **[ベストプラクティス](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: エラー処理、パフォーマンスの最適化、テスト戦略 + * **[ワークフローの制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: タイムアウト、レート制限、制約を理解する + + + + * **[アクションカタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: 利用可能なすべての AWS、New Relic、HTTP アクションを参照します + * **[ワークフローの例](/docs/workflow-automation/workflow-examples)**: 実際の自動化シナリオから学ぶ + * **[ワークフロー API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)** : CI/CDインテグレーションのためにプログラムでワークフローを管理 + + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx b/src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx new file mode 100644 index 00000000000..f3a268708c2 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx @@ -0,0 +1,326 @@ +--- +title: ワークフロー自動化のベストプラクティス +tags: + - Workflow Automation + - workflow + - best practices + - workflow automation best practices +metaDescription: 'Build reliable, maintainable workflows that handle errors gracefully and scale with your operations.' +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +エラーを適切に処理し、機密データを保護し、運用に合わせて拡張できる信頼性の高いワークフローを構築します。保守可能な自動化を作成するには、これらのパターンに従ってください。 + +## デザイン重視のワークフロー + +ワークフローを単一の責任に集中させます。関連するアクションをグループ化しますが、無関係なタスクを組み合わせることは避けます。 + +### 1つのワークフロー、1つの目的 + +**実行**: インシデント対応と定期メンテナンス用に別々のワークフローを作成します。**しないでください**: EC2 のサイズ変更、データベースのバックアップ、Slack 通知を 1 つのワークフローに組み合わせます。 + +### 問題のあるワークフローを再利用する + +input を使用して、ワークフローを複製するのではなく、環境間でワークフローを再利用できるようにします。 + +**例**: リージョンとインスタンスタイプを使用した 1 つの EC2 サイズ変更ワークフロー: + +```yaml +inputs: + awsRegion: us-east-1 + instanceType: t3.medium + instanceId: i-1234567890abcdef0 +``` + +これは、リージョンまたはインスタンスタイプごとに個別のワークフローを作成することに代わるものです。 + +### 関連するアクションを組み合わせる + +一緒に実行する必要がある関連アクションをグループ化します。 + +* **Do** : まとめ詳細、メッセージのフォーマット、1 つのワークフローで Slack に送信 +* **してはいけないこと**: 「金額集計」、「メッセージのフォーマット」、「Slack への送信」のワークフローを別に作成する + +## エラーを処理する + +外部API呼び出しと重要な操作に対するエラー処理を常に含めます。 + +### フォールバックアクションを追加する + +重要なステップが失敗する可能性がある場合は、チームに通知するフォールバック アクションを追加します。 + +**例**: `ignoreErrors`を使用してステップが失敗した場合でも Slack 通知を送信します。 + +```yaml +- name: sendNotification + type: action + action: aws.execute.api + version: 1 + ignoreErrors: true + inputs: + service: sqs + api: send_message + parameters: + MessageBody: "Rollback notification" + QueueUrl: "${{ .workflowInputs.queueUrl }}" + +- name: logResult + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Notification sent: ${{ .steps.sendNotification.outputs.success }}" +``` + +ステップが失敗した場合でもワークフローの実行を続行するには、 `ignoreErrors: true`を使用します。 + +### 適切なタイムアウトを設定する + +ワークフローがハングしないように、外部APIコールのタイムアウトを設定します。 + +* AWS APIコール: 30～60秒 +* データベースクエリ: 10～30秒 +* HTTP requests : 15～30秒 +* Slackメッセージ: 10秒 + +### トラブルシューティングのためにエラーをログに記録する + +エラー ログに次の詳細を含めます。 + +* 失敗したアクション +* 入力 +* サービスからのエラーメッセージ +* タイムスタンプ + +## 認証情報の保護 + +すべての機密値を New Relic のシークレット マネージャーに保存します。ワークフロー定義に資格情報をハードコードしないでください。 + +### シークレットマネージャーを使用する + +AWS 認証情報、API トークン、パスワードを保存します。 + +```graphql +mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } +} +``` + +参照秘密: `${{ :secrets:awsAccessKeyId }}` + +### 資格情報を定期的にローテーションする + +IAM ユーザー アクセス キーを使用する場合: + +* 最低90日ごとにローテーションする +* カレンダーのリマインダーを設定する +* 古い資格情報を削除する前に新しい資格情報をテストしてください + +**推奨**: 代わりに IAM ロールを使用します。ロールは自動的にローテーションされます。 + +### 最小限の権限を使用する + +必要な権限のみを付与します。最初は読み取り専用で、必要な場合にのみ書き込み権限を追加します。 + +SQS の**AWS IAM ポリシーの例**: + +```json +{ + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-queue" +} +``` + +これにより、特定の 1 つのキューへのアクセスが制限されます。 + +## 生産前にテストする + +本番環境にデプロイする前に、本番環境以外の環境でワークフローをテストします。 + +### テスト用に複製 + +本番ワークフローのテスト バージョンを作成します。 + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**に移動します +2. ワークフローを見つけて、その他のオプションメニューをクリックします +3. **Duplicate** \[複製を]選択 +4. テストアカウントを使用するには資格情報を更新してください +5. 非本番環境のリソースでテストする + +### テスト失敗シナリオ + +ワークフローが失敗を処理することを確認します。 + +* AWS API が利用できない場合はどうなりますか? +* Slack がダウンしたらどうなりますか? +* 資格情報の有効期限が切れた場合はどうなりますか? +* 必要なリソースが存在しない場合はどうなりますか? + +### 統合の検証 + +スケジュールを設定する前に、ワークフローを手動でトリガーして次の点を確認します。 + +* AWSアクションが正常に実行されました +* Slackのメッセージは正しいチャンネルに表示されます +* 承認ゲートは応答を待つ +* エラー処理は期待通りに動作します + +## パフォーマンスを最適化する + +迅速に実行される効率的なワークフローを構築します。 + +### 一度クエリを実行して結果を再利用する + +クエリ結果を保存し、複数回参照します。 + +```yaml +- name: getAlertDetails + action: newrelic.nerdgraph.execute + +- name: sendToSlack + inputs: + text: "${{ .steps.getAlertDetails.outputs.data }}" + +- name: updateJira + inputs: + body: "${{ .steps.getAlertDetails.outputs.data }}" +``` + +**禁止事項**: Slack と Jira について個別に詳細をまとめます。 + +## 監視し、維持する + +ワークフローの実行を定期的に監視し、ワークフローを最新の状態に保ちます。 + +### 実行履歴を毎週チェックする + +ワークフロー実行の確認: + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**に移動します +2. ワークフローを選択 +3. **Run history** \[実行履歴を]クリック +4. 失敗した実行や実行時間の増加を探す + +### 障害アラートを設定する + +ワークフローの失敗に関するアラートを構成します。 + +1. ワークフロー実行失敗のアラート条件を作成する +2. チームのメインチャンネルに通知を送信する +3. ワークフロー名とエラーの詳細を含める + +### 四半期ごとにワークフローを確認する + +定期的なカレンダーリマインダーを次のように設定します: + +* 未使用のワークフローを削除する +* 期限切れの資格情報を更新する +* 統合されたサービスがAPIを変更していないことを確認する +* テスト失敗シナリオ +* ドキュメントの更新 + +## ドキュメントワークフロー + +ワークフローをわかりやすくします。 + +### 分かりやすい名前を使用する + +* **実行**: 「高 CPU アラートに対する EC2 の自動サイズ変更」 +* **しないでください**:「ワークフロー 1」または「EC2 オートメーション」 + +### 明確な説明を書く + +何を、いつ、誰が行ったかを説明します。 + +``` +Automatically resizes EC2 instances when CPU exceeds 90% for 10 minutes. +Requires approval via Slack before executing changes. +Owner: DevOps Team (devops@example.com) +Last updated: 2025-01-26 +``` + +### 複雑なロジックにコメントを追加する + +条件付きロジックまたはループを使用する場合は、ロジックを説明します。 + +```yaml +- name: checkCPU + # Query CPU for last 10 minutes to avoid false positives + type: action + action: newrelic.nerdgraph.execute + version: 1 + +- name: decideAction + # If CPU > 90%: resize, 70-90%: warn, < 70%: no action + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.result > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.result > 70 }}" + next: sendWarning + next: noAction +``` + +## セキュリティ + +ワークフローとそれがアクセスするリソースを保護します。 + +### 破壊的な操作には承認ゲートを使用する + +次の場合は事前に人間の承認が必要です: + +* リソースの削除 +* 生産サービスの縮小 +* デプロイメントのロールバック +* IAM権限の変更 + +### 監査ワークフローの変更 + +変更を追跡するにはバージョン履歴を使用します。 + +1. ワークフローの詳細へ +2. **Version history** \[バージョン履歴]をクリック +3. 変更内容と変更者を確認する + +### ワークフローアクセスを制限する + +承認されたチーム メンバーのみがワークフローを編集できるようにします。 + +1. アカウント設定でユーザーロールを確認する +2. 編集権限をDevOpsチームに制限する +3. 本番環境とテスト環境で別々のアカウントを使用する + +## 次のステップ + +**限界を理解する:** + +* **[ワークフローの制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)**- タイムアウト、アクション、ペイロードの制約 + +**問題のトラブルシューティング:** + +* **[トラブルシューティング](/docs/workflow-automation/troubleshooting)**- よくある問題の解決策 + +**例を参照してください:** + +* **[ワークフローの例](/docs/workflow-automation/workflow-examples)**- 実際の自動化シナリオ + +**ワークフローを管理する:** + +* **[ワークフローの管理](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**- ワークフローの編集、複製、監視 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx b/src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx new file mode 100644 index 00000000000..fe4dd29ff32 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx @@ -0,0 +1,201 @@ +--- +title: ワークフロー自動化の限界 +metaDescription: 'For New Relic Workflow automation, explanations of the Workflow automation limits.' +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 何 + + 分 + + Max +
+ アクション出力サイズ + + + + 100KB +
+ アクションの再試行回数 + + + + 3 +
+ ワークフロー定義の合計ステップ + + 1 + + 100 +
+ ワークフロー定義のサイズ + + + + 50KB +
+ ワークフロー定義の数 + + + + 1000 +
+ ワークフローの所要時間 + + + + 7日 +
+ ワークフロー実行合計ステップ + + + + 5000 +
+ スケジュール数 + + + + 10 +
+ ワークフロー入力値の長さ + + + + 1000文字 +
+ ワークフローの同時実行数（アカウントあたり） + + + + 30 +
+ 信号入力サイズ + + + + 10KB +
+ スイッチステップの条件の数 + + + + 10 +
+ 待機ステップ内の信号の数 + + + + 10 +
+ +## 次は何ですか？ + +技術的な限界を理解しています。大規模なワークフローを管理するプログラム的な方法を検討してみましょう。 + +**次は**[ワークフロー オートメーション API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api) - ワークフローをプログラムで作成、管理、実行する方法を学びます。 + +**追加リソース**: + +* [アクションカタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)- すべてのアクションの完全なリファレンス +* [ベストプラクティス](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)- レビューの最適化手法 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx new file mode 100644 index 00000000000..cfc66284949 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx @@ -0,0 +1,41 @@ +--- +title: アクションカタログの概要 +tags: + - workflow automation + - workflow + - workflow automation actions + - actions catalog +metaDescription: List of available actions catalog for workflow definition +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +New Relicアクション カタログは、インフラストラクチャとインテグレーションに対して実行できるアクションを提供します。 cloudプロバイダーとNew Relicアカウントでタスクを実行するアクションをリンクすることで、エンドツーエンドのプロセスを調整および自動化できます。 + +## 利用可能なアクションカタログ [#available-catalogs] + +ワークフロー自動化には次のアクション カタログを使用できます。 + +* [AWSアクション](/docs/workflow-automation/setup-and-configuration/actions-catalog/aws)- Lambda 、EC2、Systems Manager などのAWSサービスとの統合 +* [コミュニケーションアクション](/docs/workflow-automation/setup-and-configuration/actions-catalog/communication)- さまざまなコミュニケーションチャネルを通じて通知やメッセージを送信します +* [HTTPアクション](/docs/workflow-automation/setup-and-configuration/actions-catalog/http)- 外部APIおよびサービスにHTTP requests送信します +* [New Relic アクション](/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic)- New Relic プラットフォームの機能とデータと対話する +* [PagerDutyアクション](/docs/workflow-automation/setup-and-configuration/actions-catalog/pagerduty)- PagerDutyインシデントと統合の管理 +* [ユーティリティアクション](/docs/workflow-automation/setup-and-configuration/actions-catalog/others)- 一般的なデータ変換とユーティリティ操作を実行します + +## 次は何ですか？ + +利用可能なすべてのアクションを確認しました。次は、それらを組み合わせて最初のワークフローを構築します。 + +**次のステップ**:[ワークフローの管理](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)- New Relic でワークフローを作成、管理、実行する方法を学びます。 + +**構築を開始します**: + +* [ワークフロー テンプレートを使用する](/docs/workflow-automation/create-a-workflow-automation/use-a-template)- 構築済みのワークフローでクイック スタート +* [独自のワークフローを作成](/docs/workflow-automation/create-a-workflow-automation/create-your-own)- カスタム ワークフローを最初から構築します \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx new file mode 100644 index 00000000000..65e0c91e962 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx @@ -0,0 +1,704 @@ +--- +title: コミュニケーションアクション +tags: + - workflow automation + - workflow + - workflow automation actions + - communication actions + - slack actions + - ms teams actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +このページでは、ワークフロー自動化アクション カタログで使用できる通信アクションの包括的なリファレンスを提供します。これらのアクションを使用すると、Slack チャネルへのメッセージの送信、反応の取得など、コミュニケーション プラットフォームをワークフロー定義に統合できます。 + +## 前提条件 + +ワークフロー自動化でコミュニケーションアクションを使用する前に、次の点を確認してください。 + +* 適切な権限を持つ Slack ワークスペース。 +* ワークフロー自動化でシークレットとして設定された Slack ボット トークン。 +* メッセージを送信する Slack チャネルへのアクセス。 + +Slack 統合の設定方法については、 [「Slack 設定の追加」を](/docs/autoflow/overview#add-the-slack-integration)参照してください。 + +## 利用可能なコミュニケーションアクション + +プラットフォーム別のすべての通信アクションのクイックリファレンス: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ プラットフォーム + + アクション + + 目的 +
+ **スラック** + + [メッセージを投稿](#slackchatpostmessage) + + オプションのファイル添付を使用して、Slack チャネルにメッセージを送信します。 +
+ **スラック** + + [反応を得る](#slackchatgetreactions) + + Slack メッセージから絵文字反応を取得します。 +
+ +## Slackアクション + + + + オプションのファイル添付を使用して、メッセージを Slack チャネルに送信します。 + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 例 +
+ **トークン** + + 必須 + + シークレット + + `${{ :secrets:slackToken }}` +
+ **チャネル** + + 必須 + + ストリング + + `my-slack-channel` +
+ **テキスト** + + 必須 + + ストリング + + `Hello World!` +
+ **スレッドT** + + オプション + + ストリング + + `.` +
+ **添付ファイル** + + オプション + + マップ + +
+ **添付ファイル.ファイル名** + + 必須 + + ストリング + + `file.txt` +
+ **添付ファイルの内容** + + 必須 + + ストリング + + `Hello\nWorld!` +
+ + + * **token**: Slack ボットを使用します。 これは秘密の構文として渡す必要があります。トークンの設定手順については、 [「Slack 構成の追加」](/docs/autoflow/overview#add-the-slack-integration)を参照してください。 + * **channel** : メッセージを送信するチャネルの名前、またはチャネル ID。詳細については、 [Slack API を](https://api.slack.com/methods/chat.postMessage#arg_channel/)参照してください。 + * **text** : 指定された`channel`で Slack に投稿されるメッセージ。 + * **threadTs** : 親メッセージに属するタイムスタンプ。スレッド内でメッセージの返信を作成するために使用されます。 + * **attachment** : 指定された`channel`にメッセージ付きのファイルを添付できるようにします。 + * **attachment.filename** : Slack にアップロードするファイルのファイル名を指定します。 + * **attachment.content**:UTF8 としてアップロードするファイルの内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 例 +
+ **スレッドT** + + ストリング + + `.` +
+ **チャンネルID** + + ストリング + + `` +
+ + + * **threadTs** : メッセージのタイムスタンプ。今後の postMessage 呼び出しでスレッドに返信を投稿するために使用される場合があります。 + * **channelID** : メッセージが投稿されるチャネルの ID。 + + + + + **例1: Slackチャンネルにメッセージを投稿する** + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: SendMessage + + steps: + - name: send_slack_message + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: ${{ .workflowInputs.channel }} + text: ${{ .workflowInputs.text }} + ``` + + **予想される入力:** + + ```json + { + "inputs": [ + { + "key" : "channel", + "value" : "my-channel" + }, + { + "key" : "text", + "value" : "This is my message *with bold text* and `code backticks`" + } + ] + } + ``` + + **期待される出力:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + **例2: ファイルを添付する** + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: SendFileMessage + + steps: + - name: postCsv + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: my-channel + text: "Please find the attached file:" + attachment: + filename: 'file.txt' + content: "Hello\nWorld!" + ``` + + **期待される出力:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + + + + + + + + Slack チャネルからメッセージに対する反応を取得します。 + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 例 +
+ **トークン** + + 必須 + + シークレット + + `${{ :secrets:slackToken }}` +
+ **チャンネルID** + + 必須 + + ストリング + + `C063JK1RHN1` +
+ **タイムアウト** + + オプション + + int + + 60 +
+ **スレッドT** + + 必須 + + ストリング + + `.` +
+ **セレクター** + + オプション + + リスト + + `[{\"name\": \"reactions\", \"expression\": \".reactions \"}]` +
+ + + * **token**: Slack ボットを使用します。 これは秘密の構文として渡す必要があります。トークンの設定手順については、 [「Slack 構成の追加」](/docs/autoflow/overview#add-the-slack-integration)を参照してください。 + * **channelID** : メッセージの反応を取得するためのチャネルID。 + * **timeout** : 反応を待つ時間（秒数）。デフォルトは 60 秒、最大許容時間は 600 秒 (10 分) です。 + * **threadTs** : メッセージに属するタイムスタンプ。そのメッセージの反応を取得するために使用されます。 + * **selectors** : 指定された唯一のものを出力として取得するセレクター。 + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 例 +
+ **反応** + + リスト + + `` +
+ + + * **reactions**: キャプチャされたすべての反応を含む要素のリスト、またはタイムアウトが発生した場合は空のリスト。 + + + + + **例1: Slackで反応を得る** + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: GetReactions + + steps: + - name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channelID: ${{ .steps.promptUser.outputs.channelID }} + threadTs: ${{ .steps.promptUser.outputs.threadTs }} + timeout: ${{ .workflowInputs.timeout }} + selectors: ${{ .workflowInputs.selectors }} + ``` + + **予想される入力:** + + ```json + { + "inputs": [ + { + "key" : "channelID", + "value" : "C063JK1RHN1" + }, + { + "key" : "threadTs", + "value" : "1718897637.400609" + }, + { + "key" : "selectors", + "value" : "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" + } + ] + } + ``` + + **期待される出力:** + + ```json + [ + { + "name": "grinning", + "users": [ + "W222222" + ], + "count": 1 + }, + { + "name": "question", + "users": [ + "W333333" + ], + "count": 1 + } + ] + ``` + + またはタイムアウトになった場合: + + ```json + [] + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx new file mode 100644 index 00000000000..a96c0968742 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx @@ -0,0 +1,1103 @@ +--- +title: HTTPアクション +tags: + - workflow automation + - workflow + - workflow automation actions + - HTTP actions +metaDescription: A list of available HTTP actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +このページでは、ワークフロー自動化アクション カタログで使用できる HTTP アクションの包括的なリファレンスを提供します。これらのアクションを使用すると、ワークフロー定義の一部として外部 API およびサービスに HTTP requests ( GET 、POST、PUT、DELETE) を送信できるようになります。 + +## 前提条件 + +ワークフロー自動化で HTTP アクションを使用する前に、次の点を確認してください。 + +* 目標APIエンドポイントのURL。 +* 必要な認証資格情報 ( APIキー、VPN など)。 +* API リクエスト/レスポンス形式の理解。 + + + HTTP アクションは、任意のヘッダー値の秘密の構文をサポートしているため、 APIキーなどの機密データを安全に渡すことができます。 詳細については、[シークレット管理を](/docs/infrastructure/host-integrations/installation/secrets-management/)参照してください。 + + +## 利用可能なHTTPアクション + +すべての HTTP アクションのクイック リファレンス: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ アクション + + 目的 +
+ [GETリクエスト](#httpget) + + APIエンドポイントからデータを取得します。 +
+ [POSTリクエスト](#httppost) + + APIエンドポイントにデータを送信します。 +
+ [PUTリクエスト](#httpput) + + APIエンドポイントでデータを更新します。 +
+ [削除リクエスト](#httpdelete) + + APIエンドポイントでデータを削除します。 +
+ +## HTTPアクション + + + + HTTP GET呼び出しを実行して、 APIエンドポイントからデータを取得します。 + + + これは、任意のヘッダー値の秘密の構文をサポートします。 + + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 説明 +
+ **url** + + 必須 + + 弦 + + リクエストのターゲット URL。スキームには次の内容が含まれている必要があります。 + + `https://example.com` +
+ **urlパラメータ** + + オプション + + 地図 + + URL に追加するのは間違いありません。 文字列化された JSON オブジェクトを受け取ります。 +
+ **ヘッダ** + + オプション + + 地図 + + リクエストに追加するヘッダー。文字列化された JSON オブジェクトを受け取ります。 +
+ **セレクター** + + オプション + + リスト + + 指定されたもののみを出力として取得するセレクター。 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 説明 +
+ **レスポンスボディ** + + 弦 + + 応答の本文。 +
+ **ステータスコード** + + 整数 + + 応答の HTTP ステータス コード。 +
+ + + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: httpGetTest + description: 'Performs an HTTP GET request to retrieve data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + steps: + - name: query + type: action + action: http.get + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + next: end + ``` + + **入力例:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}" + } + ``` + + **出力例:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + + + HTTP POST 呼び出しを実行して、 APIエンドポイントにデータを送信します。 + + + これは、任意のヘッダー値の秘密の構文をサポートします。 + + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 説明 +
+ **url** + + 必須 + + 弦 + + リクエストのターゲット URL。スキームには次の内容が含まれている必要があります。 + + `https://example.com` +
+ **urlパラメータ** + + オプション + + 地図 + + URL に追加するのは間違いありません。 文字列化された JSON オブジェクトを受け取ります。 +
+ **ヘッダ** + + オプション + + 地図 + + リクエストに追加するヘッダー。文字列化された JSON オブジェクトを受け取ります。 +
+ **体** + + オプション + + 弦 + + リクエスト本体。 +
+ **セレクター** + + オプション + + リスト + + 指定されたもののみを出力として取得するセレクター。 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 説明 +
+ **レスポンスボディ** + + 弦 + + 応答の本文。 +
+ **ステータスコード** + + 整数 + + 応答の HTTP ステータス コード。 +
+ + + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: httpPostTest + description: 'Performs an HTTP POST request to send data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + steps: + - name: query + type: action + action: http.post + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + next: end + ``` + + **入力例:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}" + } + ``` + + **出力例:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + HTTP PUT リクエストを実行して、 APIエンドポイントのデータを更新します。 + + + 入力に機密データ（ `Api-Key`ヘッダーなど）を渡す必要がある場合は、 [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) NerdGraph ミューテーションを介して保存された値を使用できます。 + + 例： + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 説明 +
+ **url** + + 必須 + + 弦 + + リクエストのターゲット URL。URL にはスキーム (例: https:// または http://) を含める必要があります。例： + + `https://example.com` +
+ **urlパラメータ** + + オプション + + 地図 + + URL に追加するのは間違いありません。 文字列化された JSON オブジェクトを受け取ります。 +
+ **ヘッダ** + + オプション + + 地図 + + リクエストに追加するヘッダー。文字列化された JSON オブジェクトを受け取ります。 +
+ **体** + + オプション + + 弦 + + リクエスト本体。 +
+ **セレクター** + + オプション + + リスト + + 指定されたもののみを出力として取得するセレクター。 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 説明 +
+ **レスポンスボディ** + + 弦 + + 応答の本文。 +
+ **ステータスコード** + + 整数 + + 応答の HTTP ステータス コード。 +
+ + + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: httpPutTest + description: 'Performs an HTTP PUT request to update data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.put + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **入力例:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **出力例:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + HTTP DELETE リクエストを実行して、 APIエンドポイントのデータを削除します。 + + + 入力に機密データ（ `Api-Key`ヘッダーなど）を渡す必要がある場合は、 [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) NerdGraph ミューテーションを介して保存された値を使用できます。 + + 例： + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 説明 +
+ **url** + + 必須 + + 弦 + + リクエストのターゲット URL。URL にはスキーム (例: https:// または http://) を含める必要があります。例： + + `https://example.com` +
+ **urlパラメータ** + + オプション + + 地図 + + URL に追加するのは間違いありません。 文字列化された JSON オブジェクトを受け取ります。 +
+ **ヘッダ** + + オプション + + 地図 + + リクエストに追加するヘッダー。文字列化された JSON オブジェクトを受け取ります。 +
+ **セレクター** + + オプション + + リスト + + 指定されたもののみを出力として取得するセレクター。 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 説明 +
+ **レスポンスボディ** + + 弦 + + 応答の本文。 +
+ **ステータスコード** + + 整数 + + 応答の HTTP ステータス コード。 +
+ + + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: httpDeleteTest + description: 'Performs an HTTP DELETE request to remove data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.delete + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **入力例:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **出力例:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx new file mode 100644 index 00000000000..006177259f6 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx @@ -0,0 +1,1210 @@ +--- +title: New Relicアクション +tags: + - workflow automation + - workflow + - workflow automation actions + - New relic actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +このページでは、ワークフロー自動化アクション カタログで使用できる New Relic アクションの包括的なリファレンスを提供します。これらのアクションにより、カスタムイベントやログの送信、NerdGraph 書き込みの実行、 NRQL書き込みの実行、通知の送信など、 New Relicプラットフォームの機能をワークフロー定義に統合できます。 + +## 前提条件 + +ワークフロー自動化で New Relic アクションを使用する前に、次の点を確認してください。 + +* 適切な権限を持つ New Relic アカウント。 +* New Relicライセンスキー (データを別のアカウントに送信する場合)。 +* 使用を計画している特定の New Relic サービスに必要な権限。 + +New Relicアカウントのライセンスキーの作成および管理方法については、「[ライセンスキー」](/docs/apis/intro-apis/new-relic-api-keys/#license-key)を参照してください。 + +## 利用可能なNew Relicアクション + +カテゴリ別のすべての New Relic アクションのクイックリファレンス: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ カテゴリー + + アクション + + 目的 +
+ **データの取り込み** + + [カスタムイベントを送信する](#newrelicingestsendevents) + + カスタムイベントをNew Relicに送信します。 +
+ **データの取り込み** + + [ログを送信](#newrelicingestsendlogs) + + ログデータを New Relic に送信します。 +
+ **NerdGraph** + + [GraphQL書き込みまたはミューテーションを実行する](#newrelicnerdgraphexecute) + + NerdGraph API に対して GraphQL コマンドを実行します。 +
+ **クエリ** + + [NRDB書き込みを実行する](#newrelicnrdbquery) + + クロスアカウント NRQL クエリを実行します。 +
+ **通知** + + [通知を送信](#newrelicnotificationsend) + + New Relic の宛先に通知を送信します。 +
+ +## データ取り込みアクション + + + + New Relicにカスタムイベントを送信します + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 例 +
+ **属性** + + オプション + + マップ + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **イベント** + + 必須 + + リスト + + `"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]` +
+ **ライセンスキー** + + オプション + + ストリング + + `"{{ .secrets.secretName }}"` +
+ **セレクター** + + オプション + + リスト + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: 提供される場合にすべてのイベントの一部となる共通属性。必要なイベント項目が共通定義をオーバーライドする場合、各イベント項目をマージします。 + * **events**: イベントデータのリスト。 イベントではカスタムイベント タイプを表す`eventType`フィールドを使用する必要があり、リクエストごとに許可されるイベントの最大数は 100 であることに注意してください。 + * **LicenseKey** : イベントが送信されるターゲット アカウントを指定するNew Relicアカウント ライセンスキー。 この値が指定されていない場合、ワークフローを実行しているアカウントに基づいてデフォルトのライセンスキーが想定されます。 + * **selectors** : 指定されたもののみを出力として取得するセレクター。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 例 +
+ **成功** + + ブール値 + + `true` +
+ **エラーメッセージ** + + ストリング + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: heartbeat_newrelicIngestSendEvents + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendEvents + version: 1 + inputs: + attributes: + colour: red + id: 1234 + events: + - eventType: HeartBeat + test: "OK" + attributes: + foo: bar + - eventType: HeartBeat1234 + test: "OK1234" + attributes: + foo: bar + - eventType: HeartBeat12345 + test: "OK12345" + attributes: + foo: bar + colour: yellow + - eventType: HeartBeat12345678 + test: "OK12345678" + selectors: + - name: success + expression: ".success" + ``` + + **期待される出力:** + + ```yaml + { + "success": true + } + ``` + + **イベントを取得:** + + ワークフローを正常に実行した後、ワークフローを実行したアカウントでクエリを実行して、関連付けられたイベントを取得できます。 + + ```sql + SELECT * FROM HeartBeat + ``` +
+ + + + + + + + + New Relicへのログ送信 + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力フィールド + + オプション性 + + タイプ + + 例 +
+ **属性** + + オプション + + マップ + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **ログ** + + 必須 + + リスト + + `"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"` +
+ **ライセンスキー** + + オプション + + ストリング + + `"{{ .secrets.secretName }}"` +
+ **セレクター** + + オプション + + リスト + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: 提供された場合、すべてのログに含まれる共通属性。ログ項目で同じ属性が指定されている場合は、共通の定義が上書きされます。 + * **logs**: ログデータのリスト。 リクエストごとに許可されるログの最大数は 100 であることに注意してください。 + * **LicenseKey** : ログが送信される対象アカウントを指定するNew Relicアカウント ライセンスキー。 指定しない場合、ワークフローを実行するアカウントに基づいてデフォルトのライセンスキーが想定されます。 詳細については、 [「ライセンスキー」を](/docs/apis/intro-apis/new-relic-api-keys/#license-key)参照してください。 + * **selectors** : 指定されたもののみを出力として取得するセレクター。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 出力フィールド + + タイプ + + 例 +
+ **成功** + + ブール値 + + `true` +
+ **エラーメッセージ** + + ストリング + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ ワークフローの例 +
+ ```yaml + name: heartbeat_newrelicIngestSendLogs + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + attributes: + colour: red + id: 1234 + logs: + - message: 'Heartbeat sendLogs Action Test Message' + attributes: + foo: bar + - message: 'HeartBeat1234' + attributes: + foo: bar + - message: 'HeartBeat12345' + attributes: + foo: bar + colour: yellow + - message: 'HeartBeat12345678' + selectors: + - name: success + expression: ".success" + ``` + + **期待される出力:** + + ```yaml + { + "success": true + } + ``` + + **ログを取得:** + + ワークフローを正常に実行した後、ワークフローを実行したアカウントでクエリを実行して、関連するログを取得できます。 + + ```sql + SELECT * FROM Log + ``` +
+ + + + + + +## NerdGraphアクション + + + + newrelic NerdGraph API に対して Graphql コマンドを実行します。コマンドはクエリまたはミューテーションのいずれかになります。 + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力 + + オプション性 + + タイプ + + 説明 + + 例 +
+ **グラフQL** + + 必須 + + ストリング + + GraphQL 構文。コマンドの構築とテストにはGraphiQLを使用する必要があります + +
+ **変数** + + 必須 + + map[string]any + + GraphQLステートメントで使用する任意のキーの値ペア変数。 + +
+ **セレクター** + + オプション + + リスト + + 指定された唯一のものを出力として取得するセレクター。 + + ```yaml + { + "data": { + "actor": { + "user": { + "name": "" + } + } + } + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 出力 + + タイプ + + 例 +
+ **データ** + + map[string]any: NerdGraphレスポンスの + + `data` + + プロパティの内容。 + + ```yaml + steps: + - name: currentUserId + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + graphql: | + query userId { + currentUser { + id + } + } + - name: sayHello + type: action + action: example.messaging.sayHello + version: 1 + inputs: + name: ${{ .steps.currentUserId.outputs.data.currentUser.id }} + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 例 + + 出力 + + イベントを取得する +
+ ```json + name: testLog + + steps: + - name: logStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'Hello World' + ``` + + ```yaml + { + "success": true + } + ``` + + ワークフローを実行したアカウントでクエリを実行すると、関連付けられたイベントを取得できます。 + + ```yaml + SELECT message FROM Log WHERE allColumnSearch('Hello World', insensitive: true) SINCE 30 minutes ago + ``` +
+ + + + + + +## クエリアクション + + + + NerdGraph API を介してクロスアカウント NRQL クエリを実行します。 + + + + + 入力 + + + + 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力 + + オプション性 + + タイプ + + 説明 + + 例 +
+ **クエリ** + + 必須 + + ストリング + + NRQL クエリ ステートメント。 + +
+ **アカウント ID** + + オプション + + intのリスト + + **New Relic Account ID** + + \[New Relic アカウント ID]入力は、クエリが実行されるターゲット アカウントを指定できるターゲット ID のリストです。この値が入力として提供されない場合、クエリはワークフローの実行アカウントに関連付けられたアカウントに対して自動的に実行されます。 + +
+ **セレクター** + + オプション + + リスト + + 指定された唯一のものを出力として取得するセレクター。 + + ```json + steps: + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + accountIds: [12345] + query: FROM Log SELECT * WHERE message LIKE 'DEMO%' + selectors: + - name: resultsAsString + expression: '.results | tostring' + ``` +
+ + + + + + + + + + + + + + + + + + + + + +
+ 出力 + + タイプ + + 例 +
+ **results** + + : クエリの結果を含むオブジェクトの配列。 + + + + ```yaml + { + results=[ + { message=[INFO] - Workflow: test has ended, messageId=39af98 }, + { message=[INFO] - Workflow: test - Step query has started, messageId=649c612 }, + ... + ] + } + ``` +
+ + + + + + +## 通知アクション + + + + Slackなどの宛先と統合されたチャネルにメッセージを送信します + + + + + 入力 + + + + 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力 + + オプション性 + + タイプ + + 説明 + + 例 +
+ **タイプ** + + 必須 + + ストリング + + NewRelicの宛先の種類 + + `slack` +
+ **宛先ID** + + 必須 + + 弦 + + NewRelic の宛先に関連付けられた DestinationId。 + + `123e4567-e89b-12d3-a456-426614174000` +
+ **パラメーター** + + 必須 + + マップ + + 選択した宛先タイプに通知を送信するために必要なフィールド。 + + `{\"channel\": \"${{ YOUR_CHANNEL }}\", \"text\": \"Enter your text here\"}` +
+ **セレクター** + + オプション + + リスト + + 指定された唯一のものを出力として取得するセレクター。 + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 出力 + + タイプ + + 例 +
+ 成功 + + ブール値 + + `true/false` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx new file mode 100644 index 00000000000..a9567ce1bc3 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx @@ -0,0 +1,684 @@ +--- +title: ユーティリティアクション +tags: + - workflow automation + - workflow + - workflow automation actions + - utility actions +metaDescription: A list of available utility actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + +このページでは、ワークフロー自動化アクション カタログで使用できるユーティリティ アクションのリファレンスを提供します。これらのアクションを使用すると、ワークフロー定義で一般的なデータ変換およびユーティリティ操作を実行できます。 + +## 利用可能なユーティリティアクション + +すべてのユーティリティアクションのクイックリファレンス: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ アクション + + 目的 +
+ [エポックから日時を更新します](#utils.datetime.fromEpoch) + + エポックタイムスタンプを日付/時刻形式に変換します。 +
+ [CSVに変換](#utils.transform.toCSV) + + データをCSV形式に変換します。 +
+ [UUIDを生成する](#utils.uuid.generate) + + RFC 準拠の V4 UUID を生成します。 +
+ +## ユーティリティアクション + + + + このアクションは、エポックタイムスタンプを日付/時刻に変換するために使用されます。参照可能なもの: + + * [https://en.wikipedia.org/wiki/List\_of\_tz\_database\_time\_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) + * [https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT\_IDS](https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT_IDS) + + 詳細については[fromEpochを](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html)参照してください。 + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力 + + オプション性 + + タイプ + + 説明 +
+ **タイムスタンプ** + + 必須 + + int + + エポックタイムスタンプを表す整数。UNIXエポックは1970年1月1日午前0時（UTC）からの秒数であることに注意してください。 +
+ **タイムスタンプ単位** + + オプション + + ストリング + + 提供されたタイムスタンプの単位を表す文字列。許容値: SECONDS、MILLISECONDS(デフォルト) +
+ **タイムゾーンID** + + オプション + + ストリング + + 希望する日付/時刻のタイムゾーンを表す文字列。デフォルト: UTC +
+ **パターン** + + オプション + + ストリング + + 希望する日時のパターンを表す文字列。デフォルト: ISO-8601 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ フィールド + + オプション性 + + データ型 + + 説明 +
+ **日付** + + 必須 + + ストリング + + 日付の文字列表現。 +
+ **時間** + + 必須 + + ストリング + + 時間の文字列表現。 +
+ **データタイム** + + 必須 + + ストリング + + 日時を文字列で表現します。 +
+ **タイムゾーン** + + 必須 + + マップ + + timezoneId と略語のマップ表現。 +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 例 + + ワークフロー入力 + + 出力 +
+ ```yaml + name: from_epoch + + workflowInputs: + timestamp: + type: Int + timestampUnit: + type: String + timezoneId: + type: String + pattern: + type: String + + steps: + - name: epochTime + type: action + action: utils.datetime.fromEpoch + version: 1 + inputs: + timestamp: ${{ .workflowInputs.timestamp }} + timezoneId: ${{ .workflowInputs.timezoneId }} + pattern: ${{ .workflowInputs.pattern }} + timestampUnit: ${{ .workflowInputs.timestampUnit }} + ``` + + ```json + mutation { + workflowAutomationStartWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { name: "from_epoch" } + workflowInputs: [ + {key: "timestamp", value: "1738236424003"} + {key: "timestampUnit", value: "MILLISECONDS"} + {key: "pattern", value: "yyyy-mm-dd HH:SS"} + {key: "timezoneId", value: "Asia/Kolkata"} + ] + ) { + runId + } + } + ``` + + ```json + { + "date": "2025-01-30", + "time": "16:57:04.003" + "datetime": "2025-01-30 16:00", + "timezone": { + "abbreviation": "IST", + "id": "Asia/Kolkata" + } + } + ``` +
+ + + + + + + + + このアクションは、さまざまなタイプの入力 (JSON、マップ) を CSV 形式に変換するために使用されます。 + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 入力 + + オプション性 + + タイプ + + 説明 +
+ **データ** + + 必須 + + どんな + + CSV に変換するデータを表す文字列。通常は JSON 文字列またはマップです。 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ フィールド + + オプション性 + + データ型 + + 説明 +
+ **csv** + + 必須 + + ストリング + + 受信したデータの CSV 表現。 +
+ + + + + + + + + + + + + + + + + + + + + + +
+ 例 + + ワークフロー入力 + + 出力 +
+ ```json + name: nrqltocsv + + steps: + - name: queryForLog + type: action + action: newrelic.nrql.query + version: 1 + inputs: + accountIds: ['${{ .workflowInputs.accountId }}'] + query: ${{ .workflowInputs.nrql }} + + - name: csv1 + type: action + action: utils.transform.toCSV + version: 1 + inputs: + data: ${{ .steps.queryForLog.outputs.results | tostring }} + ``` + + ```json + mutation { + startWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { + name: "nrqltocsv", + } + workflowInputs: [ + {key: "accountId" value: "12345678"} + {key: "nrql" value: "FROM TransactionError SELECT error.message, error.class, transactionName, request.uri, query WHERE appName like 'my-app-1%' AND error.expected IS FALSE SINCE 1 hour ago LIMIT 50"} + ] + ) + { runId } + } + ``` + +
+ + + + + + + + + RFC 準拠の V4 uuid を生成します。 + + + + + 入力 + + + + 出力 + + + + 例 + + + + + + + + + + + + + + + + + + + + + + +
+ 入力 + + オプション性 + + データ型 + + 説明 +
+ + + + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ フィールド + + データ型 + + 説明 +
+ **uuid** + + ストリング + +
+ + + + + + + + + + + + + + + + + + + + + +
+ 例 + + ワークフロー入力 + + 出力 +
+ + + 名前: generateUUID
手順: + + * 名前: generateUUID タイプ: アクション アクション: utils.uuid.generate バージョン: 1 + 		+ ```json + { + "uuid": "c76bd606-5eaa-42bb-a847-4221fb49f83c", + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/create-destinations.mdx b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/create-destinations.mdx new file mode 100644 index 00000000000..a3ac401ec99 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/create-destinations.mdx @@ -0,0 +1,91 @@ +--- +title: ワークフローから通知を送信する +tags: + - workflow automation + - workflow + - notifications + - slack + - pagerduty +metaDescription: 'Configure workflows to send notifications via Slack, PagerDuty, email, or webhooks when automation tasks complete or fail.' +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +ワークフローは、Slack、PagerDuty、電子メール、またはカスタム Webhook を介してチームに通知を送信できます。ワークフローが完了したとき、失敗したとき、または承認が必要なときに、集計チームに通知を使用します。 + +## 通知チャネルを選択してください + +ユースケースに適したチャネルを選択してください。 + +| **チャネル** | **最適な用途** | **セットアップの複雑さ** | **特徴** | +| ------------- | -------------- | --------------- | --------------------- | +| **スラック** | チームコラボレーション、承認 | 簡単 - ボットトークンが必要 | 豊富なメッセージ、反応、スレッド | +| **PagerDuty** | インシデント管理、オンコール | 簡単 - APIキーが必要です | エスカレーションポリシー、インシデント追跡 | +| **メール** | 正式な通知、報告 | 簡単 - SMTP設定 | 添付ファイル、HTMLフォーマット | +| **Webhook** | カスタムインテグレーション | 中 - エンドポイントが必要 | 柔軟なペイロード、あらゆるシステム | + +## あなたが始める前に + +通知を構成する前に、次の点を確認してください。 + +* アカウントで作成されたワークフロー ([テンプレート](/docs/workflow-automation/create-a-workflow-automation/use-a-template)または[カスタムビルド](/docs/workflow-automation/create-a-workflow-automation/create-your-own)から)。 +* 通知チャネルの認証情報 (Slack ボット、 PagerDuty APIキーなど)。 +* 資格情報は[シークレット マネージャー](/docs/infrastructure/host-integrations/installation/secrets-management/)に保存されます。 + +## 目的地を設定する [#set-the-destination] + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities)> Alerts > Destinations**に移動し、**Workflow Automation** \[ワークフロー オートメーションを]選択します。 + +2. ワークフロー オートメーションを設定するには、**ワークフロー オートメーションの宛先名**(ワークフロー オートメーションの一意の名前) や**API Key** \[APIキー]などの必要な情報を入力します。 + +3. **Save destination** \[保存先]をクリックします。 + + Image of the Workflow Automation destination page. + +## 通知ワークフローを作成する [#create-the-notification-workflow] + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities)> Alerts > Notification Workflows**に移動し、 **+ Add a workflow** \[+ ワークフローの追加を]選択します。 + +2. 通知ワークフローを構成するには、「通知ワークフローの構成」ページで必要な情報を入力します。 + + * 認識できる一意の名前を入力します。 + * **Basic** \[基本]フィルター オプションのそれぞれのドロップダウンから**Tag** \[タグ]、**Policy** \[ポリシー]、**Priority** \[優先度の]プロパティを選択してインシデントに関する通知を受け取るか、**Advanced** \[詳細]フィルター オプションを選択して**Attributes** \[プロパティ]、**Operators** \[演算子]、**Values** \[値を]選択してより詳細なインシデント通知を取得します。 + * **Additional settings** \[追加設定]をクリックすると、 [NRQL クエリを](/docs/alerts/get-notified/incident-workflows/#enrichments)構築してデータを拡充し、New Relic プラットフォーム全体から関連データを収集できます。エンリッチメントの例については、 [「ワークフロー データ エンリッチメント」](/docs/alerts/get-notified/custom-variables-incident-workflows/#enrichment-examples)を参照してください。 + +3. 通知先を指定するには、 **Notify** \[通知]セクションで 1 つ以上の[**Destination** \[宛先\]](/docs/alerts/get-notified/destinations)を選択します。 + +4. たとえば、 [Slack](/docs/alerts/get-notified/notification-integrations/#slack)グループに通知を送信するには、送信先の種類として**Slack を**選択します。 + + 1. ドロップダウンリストから**Slack destination** \[Slack の送信先]を選択します。 + 2. ドロップダウン リストから**Channel** \[チャネルを]選択し、**Receive notification updates on the channel \[チャネルの通知更新を受信する]**チェックボックスをオンにします。 + 3. 必要に応じて、 **Custom Details** \[カスタム詳細]セクションにカスタム メッセージを追加します。 + + + **Send test notification** \[テスト通知の送信]を使用してテスト通知を送信することをお勧めします。 + + + 4. **Save message** \[メッセージを保存]を選択します。 + +5. ワークフロー自動化をテストするには、 **Test workflow** \[ワークフローのテスト]を選択します。これは、アカウントの既存のデータを使用して設定を検証し、サンプルの通知を送信して Slack グループに確実に届くようにします。 + +6. **Activate workflow** \[ワークフローのアクティブ化]を選択します。 + + Image of how to configure a workflow + +## 次は何ですか？ + +通知先を設定しました。強力なワークフローを構築するために利用できるすべてのアクションを調べてみましょう。 + +**旅の次は**:[アクション カタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)- AWS 、 New Relic 、および統合で利用可能なすべてのアクションを参照します。 + +**構築する準備はできましたか?** + +* [ワークフロー テンプレートを使用する](/docs/workflow-automation/create-a-workflow-automation/use-a-template)- 事前に構築されたワークフローから始めます +* [独自のワークフローを作成する](/docs/workflow-automation/create-a-workflow-automation/create-your-own)- ゼロから構築 +* [ワークフローの管理](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)- ワークフローダッシュボードを学ぶ \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx new file mode 100644 index 00000000000..d32d4269499 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx @@ -0,0 +1,465 @@ +--- +title: AWS認証情報を設定する +metaDescription: 'Configure AWS credentials for workflow automation using IAM roles, IAM users, or temporary session tokens.' +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +New Relic ワークフロー自動化が AWS アカウントでアクションを実行することを承認します。認証情報をハードコーディングしたり、セキュリティを侵害したりすることなく、ワークフローが EC2、SQS、DynamoDB などのAWSサービスと安全にやり取りできるようにする認証方法を設定します。 + +## 前提条件 + +AWS 認証情報を設定する前に、次のものを用意してください。 + +* IAM ロールまたはユーザーを作成する権限を持つ AWS アカウント。 +* [New Relic アカウント ID](/docs/accounts/accounts-billing/account-structure/account-id) 。 +* [AWS IAM コンソール](https://console.aws.amazon.com/iam/)への管理者アクセス。 + +## 必要な権限を理解する [#required-permissions] + +資格情報を作成する前に、ワークフローに必要な権限を理解してください。ワークフローが実際に使用する権限のみを付与します。これにより、最小権限の原則が遵守され、セキュリティ リスクが最小限に抑えられます。 + +### 一般的なワークフロー権限 + +| **ワークフロータイプ** | **必要なAWS権限** | **説明** | +| -------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | +| **EC2管理** | `ec2:DescribeInstances`
`ec2:StopInstances`
`ec2:StartInstances`
`ec2:ModifyInstanceAttribute` | アラートに応じて EC2 インスタンスを停止、開始、または変更する | +| **SQSメッセージング** | `sqs:SendMessage`
`sqs:GetQueueAttributes` | 下流処理のために SQS キューにメッセージを送信する | +| **APIゲートウェイ** | `apigateway:GET`
`apigateway:PUT` | API Gateway のデプロイメントまたは設定をロールバックする | +| **システムマネージャー** | `ssm:CreateDocument`
`ssm:DeleteDocument`
`ssm:StartAutomationExecution`
`ssm:GetAutomationExecution` | 自動化ランブックを実行する | +| **DynamoDB** | `dynamodb:Query`
`dynamodb:GetItem`
`dynamodb:PutItem` | DynamoDB テーブルからの読み取りまたは書き込み | + + + 読み取り専用権限 ( `Describe*` 、 `Get*` 、 `List*` ) から開始し、必要に応じて書き込み権限 ( `Put*` 、 `Create*` 、 `Delete*` ) を追加します。これにより、テスト中の偶発的な破壊的な操作を防止できます。 + + +完全な IAM ポリシー テンプレートについては、以下の[ポリシー例を](#policy-examples)参照してください。 + +## 認証を設定する + +上の表から、ユースケースに合った方法を選択してください。 + + + + IAM ロール（推奨） アクセスキーを持つ IAM ユーザーセッショントークン + + + + + IAM ロールを使用すると、New Relic は永続的なアクセスキーを必要とせずに AWS アカウントの一時的な認証情報を引き受けることができます。 + + **IAM ロールの特性:** + + * 資格情報は自動的に更新されます + * アクセスは設計上、時間制限があります + * すべてのアクションはAWS CloudTrailにログとして記録されます + * AWS セキュリティのベストプラクティスに準拠 + + ### AWSでロールを作成する + + 1. [AWS IAMコンソール](https://console.aws.amazon.com/iam/)にサインインする + 2. **Roles > Create role > Trusted entity type**に移動し、 **AWS account > another AWS account**を選択します。 + 3. **Account ID** \[アカウント ID]フィールドに次のように入力します。 `253490767857` + 4. **Options** \[オプション]で**Require external ID** \[外部IDを要求するに]チェックを入れます + 5. **External ID** \[外部 ID]フィールドに New Relic アカウント ID を入力し、 **Next** \[次へ]をクリックします。 + + * 持っていないですか？[アカウントIDはこちら](/docs/accounts/accounts-billing/account-structure/account-id) + + 6. **Add permissions** \[権限の追加]ページで、ワークフローに基づいてポリシーを添付します。 + + * EC2 ワークフローの場合: `AmazonEC2ReadOnlyAccess`をアタッチするか、カスタムポリシーを作成します + * SQS ワークフローの場合: `AmazonSQSFullAccess`を添付するか、特定のキューに制限します + * その他のサービスについては、以下の[必要なAWS権限](#required-aws-permissions)を参照してください。 + + 7. **Next**\[次へ]をクリックします。 + 8. ロール名を入力してください: `NewRelicWorkflowAutomationRole` (または希望する名前) + 9. オプションで説明「New Relic ワークフロー自動化が AWS でアクションを実行できるようにする」を追加し、 **Create role** \[ロールの作成]をクリックします。 + + ### 信頼ポリシーを確認する + + ロールを作成したら、信頼関係を確認します。 + + 1. IAMコンソールで、新しく作成したロールを選択します。 + 2. **Trust relationships** \[信頼関係]タブをクリックします + 3. ポリシーがこの構造と一致していることを確認します ( ``実際のアカウント ID に置き換えます)。 + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sts:AssumeRole", + "Principal": { + "AWS": "arn:aws:iam::253490767857:root" + }, + "Condition": { + "StringEquals": { + "sts:ExternalId": "" + } + } + } + ] + } + ``` + + ### ロールARNをコピーする + + ワークフローを構成するには、ロール ARN が必要です。 + + 1. IAMコンソールでロールを選択します + 2. **Summary** \[概要]セクションで、 **ARN**フィールドを見つけます。 + 3. 完全な ARN をコピーします。次のようになります。 `arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole` + 4. このARNを安全に保存します。ワークフロー設定に直接貼り付けます。 + + + **重要:**ロール ARN はワークフロー入力に直接渡されます。シークレット マネージャーには保存しないでください。これらは機密性の高い資格情報ではなく、リソース識別子です。 + + + ロールが設定されました。AWSアクセスが必要なワークフロー設定で ARN を使用します。 + + + + この方法は、テスト環境の場合や IAM ロールがサポートされていない場合に使用します。アクセス キーは手動でのローテーションを必要とする長期にわたる資格情報です。 + + **使用例:** + + * テストおよび開発環境 + * クロスアカウントロールの引き継ぎをサポートしないAWS設定 + * 簡素化された認証ワークフロー + + + アクセス キーは長期間有効な資格情報です。定期的に（90 日ごとに）ローテーションし、ワークフローに必要なものだけにアクセスを制限します。 + + + ### IAM ユーザーを作成する + + 1. [AWS IAMコンソール](https://console.aws.amazon.com/iam/)にサインインする + 2. **Users > Create user**に移動し、ユーザー名: `workflow-automation-user` (または任意の名前) を入力します。 + 3. **Next**をクリックします + 4. **Set permissions** \[権限の設定]ページで、**Attach policies directly** \[ポリシーを直接アタッチするを]選択します。 + 5. ワークフローに基づいてポリシーを検索して選択します。 + + * SQSの場合: 選択 `AmazonSQSFullAccess` + * EC2の場合: 選択 `AmazonEC2ReadOnlyAccess` + * または、権限を制限したカスタムポリシーを作成します（推奨） + + 6. **Next** \[次へ]をクリックし、 **Create user** \[ユーザーを作成]をクリックします。 + + ### アクセスキーを生成する + + 1. ユーザーリストで、新しく作成したユーザーを選択します + 2. **Security credentials** \[セキュリティ資格情報]タブをクリックします + 3. **Access keys** \[アクセスキー]セクションで、**Create access key** \[アクセスキーの作成を]選択します。 + 4. **Application running outside AWS** \[AWS外で実行されているアプリケーション]を選択し、 **Next** \[次へ]をクリックします。 + 5. (オプション) 説明タグを追加します:「New Relic ワークフロー自動化」 + 6. **Create access key** \[アクセスキーの作成を]選択 + 7. 両方の資格情報をすぐにコピーします。 + + * **アクセスキーID** （ `AKIA...`で始まる） + * **秘密アクセスキー**（一度だけ表示） + + + AWS は、作成時にシークレットアクセスキーを 1 回だけ表示します。保存しない場合は、新しいキー ペアを生成する必要があります。 + + + ### 資格情報を安全に保存する + + ワークフローに AWS 認証情報をハードコードしないでください。代わりに、New Relic の[シークレット マネージャー](/docs/infrastructure/host-integrations/installation/secrets-management/)に保存します。 + + 1. [NerdGraph GraphiQLエクスプローラー](https://one.newrelic.com/nerdgraph-graphiql)を開く + 2. このミューテーションを実行してアクセス キー ID を保存します (プレースホルダーの値を置き換えます)。 + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } + } + ``` + + 3. シークレット アクセス キーに対して別のミューテーションを実行します。 + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsSecretAccessKey" + description: "AWS Secret Access Key for workflow automation" + value: "YOUR_AWS_SECRET_ACCESS_KEY" + ) { + key + } + } + ``` + + 次の構文を使用して**、ワークフローでこれらのシークレットを参照します**。 `${{ :secrets:awsAccessKeyId }}` + + + `namespace`フィールドを使用して、環境 ( `aws-prod` 、 `aws-staging` ) またはチーム名別にシークレットを整理します。 + + + + + セッション トークンは、自動的に期限が切れる一時的な資格情報を提供します。 + + **使用例:** + + * ローカル開発とテスト + * 資格情報のローテーションが必要なCI/CDパイプライン + * 時間制限付きアクセス（通常 1 ～ 12 時間）のコンプライアンス要件がある環境 + + **前提条件:** + + * [AWS CLI がインストールおよび設定されている](https://aws.amazon.com/cli/) + * 引き受けることができる既存のIAMロール + + ### 一時的な認証情報を生成する + + 1. ターミナルを開き、次のコマンドを実行します (ロール ARN に置き換えます)。 + + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` + + AWS CLI を初めて使用する場合は、 `aws configure`を使用して設定し、アクセス認証情報を入力する必要がある場合があります。 + + Image of the Static Access credentials + + 2. AWS は 3 つの値を返します。3 つすべてが必要です。 + + ```json + { + "Credentials": { + "AccessKeyId": "ASIAIOSFODNN7EXAMPLE", + "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", + "SessionToken": "FQoGZXIvYXdzEBk...", + "Expiration": "2025-01-25T12:00:00Z" + } + } + ``` + + 3. 3 つの資格情報すべてをシークレット マネージャーに保存します。 + + * `AccessKeyId` 保存先 `awsAccessKeyId` + * `SecretAccessKey` 保存先 `awsSecretAccessKey` + * `SessionToken` 保存先 `awsSessionToken` + + + セッション トークンは期限切れになります (通常 1 時間後)。`Expiration`タイムスタンプの前に更新するようにリマインダーを設定してください。そうしないと、認証エラーが発生してワークフローが失敗します。 + + + + + +## ワークフローで資格情報を使用する [#use-credentials] + +認証を設定したら、ワークフロー構成で資格情報を参照します。 + +### IAM ロール（推奨） + +ロール ARN をワークフロー入力に直接貼り付けます。シークレット マネージャーは必要ありません。 + +```yaml +awsRoleArn: arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole +``` + + + ロール ARN はリソース識別子であり、機密性の高い認証情報ではありません。これらを Secrets Manager に保存せず、ワークフロー設定に直接貼り付けてください。 + + +### IAM ユーザーまたはセッショントークン + +アクセス キーの参照シークレット マネージャー: + +```yaml +awsAccessKeyId: ${{ :secrets:awsAccessKeyId }} +awsSecretAccessKey: ${{ :secrets:awsSecretAccessKey }} +awsSessionToken: ${{ :secrets:awsSessionToken }} # Only for session tokens +``` + +New Relic は実行時にシークレットを取得し、AWS で認証してから、シークレットを破棄します。資格情報はログやワークフロー履歴に表示されることはありません。 + +## ポリシーの例 [#policy-examples] + +一般的なワークフロー タイプには、これらの完全な IAM ポリシー テンプレートを使用します。それぞれは、特定のリソースへのアクセスを制限することで、最小権限の原則に従います。 + + + + 特定のキューへのアクセスを制限します。 + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + }, + { + "Effect": "Allow", + "Action": "sqs:GetQueueAttributes", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + } + ] + } + ``` + + `us-west-2`リージョンに、 `123456789012` AWS アカウント ID に、 `my-workflow-queue`キュー名に置き換えます。 + + + + タグによって特定のインスタンスへのアクセスを制限します。 + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ec2:DescribeInstances", + "ec2:DescribeTags" + ], + "Resource": "*" + }, + { + "Effect": "Allow", + "Action": [ + "ec2:StopInstances", + "ec2:StartInstances", + "ec2:ModifyInstanceAttribute" + ], + "Resource": "arn:aws:ec2:us-east-1:123456789012:instance/*", + "Condition": { + "StringEquals": { + "aws:ResourceTag/Environment": "production" + } + } + } + ] + } + ``` + + このポリシーでは、ワークフローが`Environment=production`を持つ EC2 インスタンス タグのみを停止/開始/変更できるようにします。 + + + + 特定のテーブルへのアクセスを制限します。 + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "dynamodb:Query", + "dynamodb:GetItem", + "dynamodb:PutItem" + ], + "Resource": "arn:aws:dynamodb:us-east-1:123456789012:table/WorkflowData" + } + ] + } + ``` + + `WorkflowData`テーブル名に置き換えます。 + + + + 特定の自動化ドキュメントへのアクセスを制限します。 + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument" + ], + "Resource": "arn:aws:ssm:us-east-1:123456789012:document/WorkflowAutomation-*" + }, + { + "Effect": "Allow", + "Action": [ + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": [ + "arn:aws:ssm:us-east-1:123456789012:automation-definition/WorkflowAutomation-*:*", + "arn:aws:ssm:us-east-1:123456789012:automation-execution/*" + ] + } + ] + } + ``` + + これにより、自動化ドキュメントは、プレフィックスが`WorkflowAutomation-`の付いたものに制限されます。 + + + + 特定の API へのアクセスを制限します。 + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "apigateway:GET", + "apigateway:PUT" + ], + "Resource": "arn:aws:apigateway:us-west-2::/restapis/abc123xyz/*" + } + ] + } + ``` + + `abc123xyz` API Gateway ID に置き換えます。 + + + +### 追加リソース + +包括的な AWS 権限リファレンス: + +* **[AWSインテグレーション管理ポリシー](/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies/)**: サービス別のAWS権限の完全なリストと、適応できる CloudFormation テンプレート +* **[AWS APIポーリングの設定](/docs/infrastructure/amazon-integrations/connect/set-up-aws-api-polling/)**：追加の設定パターン + + + これらのリソースは、クラウド統合 (監視) にアカウント ID `754728514883`を使用します。 ワークフローの自動化には、常に`253490767857`を使用します。 + + +## 次のステップ + +AWS 認証情報を設定したら、ワークフローを作成できます。 + +**ワークフローを作成します。** + +1. **[AWS アクションの参照](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: 利用可能な AWS 操作 (EC2、SQS、DynamoDB など) を表示します。 +2. **[テンプレートを使用する](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: 一般的な AWS 自動化タスク用に事前設定されたワークフローをデプロイする +3. **[カスタム ワークフローの作成](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: 特定の要件に合わせてワークフローを構築します + +**通知を設定します。** + +* **[送信先の設定](/docs/workflow-automation/setup-and-configuration/create-destinations)**: ワークフロー イベントの Slack、PagerDuty、メール、または Webhook 通知を構成する \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/troubleshooting.mdx b/src/i18n/content/jp/docs/workflow-automation/troubleshooting.mdx new file mode 100644 index 00000000000..2981e0d08f6 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/troubleshooting.mdx @@ -0,0 +1,386 @@ +--- +title: ワークフロー自動化のトラブルシューティング +tags: + - workflow automation + - troubleshooting + - workflow errors +metaDescription: 'Common issues and solutions for Workflow Automation including AWS credentials, workflow execution, and dashboard problems.' +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +このページでは、ワークフロー自動化の使用時に発生する可能性のある一般的な問題の解決策を示します。追加のサポートについては、 [New Relic サポート フォーラム](https://discuss.newrelic.com/)を参照するか、 [New Relic サポート](https://support.newrelic.com/)にお問い合わせください。 + +## AWS の認証情報と認証 + + + + **問題:**ワークフローが AWS 認証エラーで失敗します。 + + **解決策:** + + 1. **アカウント ID を確認してください:**信頼ポリシーで`253490767857` ( `754728514883`ではない) を使用していることを確認してください。クラウドインテグレーションのアカウント ID ( `754728514883` ) は、ワークフロー オートメーションのアカウント ID とは異なります。 + 2. **外部 ID の確認:**信頼ポリシー内の外部 ID が New Relic アカウント ID ([アカウント設定](/docs/accounts/accounts-billing/account-structure/account-id)で確認可能) と完全に一致していることを確認します。 + 3. **権限を確認する:** IAM ロールまたはユーザーに、ワークフローに必要な特定の AWS 権限があることを確認します。[必要な AWS 権限の](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials#required-aws-permissions)表を確認してください。 + 4. **AWS CLI でテスト:**ロールが引き受け可能であることを確認するには、 `aws sts assume-role`をローカルで実行します。 + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/NewRelicWorkflowAutomationRole" \ + --role-session-name "TestSession" \ + --external-id "YOUR_NR_ACCOUNT_ID" + ``` + + + +### 「無効なトークン」または期限切れの資格情報 + +**問題:**トークンの有効期限エラーによりワークフローが失敗します。 + +**解決策:** + +1. **セッション トークンの場合:**有効期限のタイムスタンプを確認します。セッション トークンの有効期間は通常 1 ～ 12 時間です。有効期限が切れる前に、次の方法で新しいものを生成します。 + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` +2. **アクセス キーの場合:**アクセス キー ID とシークレット アクセス キーの両方がシークレット マネージャーに正しく保存されていることを確認します。[NerdGraph GraphiQL エクスプローラー](https://one.newrelic.com/nerdgraph-graphiql)で値を再確認します。 +3. **シークレットの構文を確認してください:** `${{ secrets.keyName }}`ではなく`${{ :secrets:keyName }}`形式を使用していることを確認してください。コロンプレフィックス（ `:secrets:` ）が必要です。 + +### 自分の役割のARNが見つかりません + +**問題:** ARN が必要なのに、AWS で見つけることができません。 + +**解決：** + +1. [AWS IAMコンソール](https://console.aws.amazon.com/iam/)にサインインする +2. ナビゲーションから**Roles** \[役割]を選択します +3. ロール名を検索します（例： `NewRelicWorkflowAutomationRole` ） +4. ロールを選択すると、ARNが概要セクションに表示されます。 +5. ARN の形式は次のとおりです。 `arn:aws:iam:::role/` + +### ワークフローは特定のAWSリソースにアクセスできません + +**問題:**ロールには権限がありますが、ワークフローが特定のリソースにアクセスできません。 + +**解決策:** + +1. **リソースレベルのアクセス許可:** IAM ポリシーによって特定のリソース ARN へのアクセスが制限されているかどうかを確認します。テストのためにワイルドカード ( `*` ) を追加し、特定のリソースにロックダウンする必要がある場合があります。 + ```json + { + "Effect": "Allow", + "Action": "ec2:DescribeInstances", + "Resource": "*" // Change from specific ARN to * for testing + } + ``` +2. **サービス制御ポリシー (SCP):** AWS 組織内にいる場合、SCP によって特定のアクションがブロックされる可能性があります。組織ポリシーを確認するには、 AWSアドミニストレーターに問い合わせてください。 +3. **リージョンの不一致:** IAM 権限で、リソースが存在する正しい AWS リージョンが指定されていることを確認します。リソースの場所に一致するようにワークフローの`awsRegion`問題を更新します。 + +## ワークフロー実行の問題 + +### クイックトラブルシューティングリファレンス + +一般的なワークフローの問題を迅速に診断するには、次の表を使用します。 + +| **症状** | **チェック** | **解決** | +| -------------------------- | -------------------- | ------------------------------------------------- | +| ワークフローが特定のステップで失敗する | エラーメッセージの実行ログを表示する | そのアクションの設定、資格情報、または入力データを修正します | +| ワークフローは実行されるが、間違った結果が生成される | ステップ間のデータ受け渡しをチェックする | テンプレートの構文を確認する `${{ .steps.name.outputs.field }}` | +| スケジュールされたワークフローが実行されない | スキップされた実行の実行履歴を確認する | スケジュール設定とワークフローの状態（アクティブ）を確認する | +| ワークフローがタイムアウトする | 実行時間を確認する | ポーリング頻度を減らすか、ワークフローを小さく分割する | +| 変更は有効になりません | バージョン履歴を確認する | 新しいバージョンを使用するようにスケジュールされた実行を更新する | + +ログと実行履歴の表示に関する詳細な手順については、 [「ワークフロー実行の監視」](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs)を参照してください。 + +### ワークフローが「失敗」ステータスとして表示される + +**問題:**ダッシュボードにワークフローのステータスが「失敗」と表示されます。 + +**解決策:** + +1. **実行履歴を確認します**: + + * **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 + * ワークフロー名をクリック + * **Run history** \[実行履歴を]表示して、どの実行が失敗したかを確認します + +2. **実行ログを確認します**: + + * 失敗した実行の**View logs** \[ログを表示]をクリックして、失敗した特定のアクションを特定します。 + * 根本原因を示すエラーメッセージを探す + +3. **一般的な原因**: + + * **無効な資格情報**: 期限切れのトークン、不正なシークレット構文、または間違ったシークレットキー + * **不足している権限**: AWS IAM 権限、Slack ボットトークンのスコープ、または API アクセスが不十分です + * **目標リソースの変更**: EC2 インスタンスの削除、Slack チャネルの削除、またはデータベースの名前変更 + * **APIレート制限を超えました**: 外部サービス ( AWS 、Slack など) へのrequestsが多すぎます + * **ネットワークタイムアウト**: 外部APIの応答に時間がかかりすぎます + +4. **修正して再実行**: 問題を解決した後、 [StartWorkflowRun API を](/docs/workflow-automation/workflow-automation-apis/start-workflow-run)使用してワークフローを手動でトリガーし、動作することを確認します。 + +### ワークフローの実行に時間がかかりすぎる + +**問題:**ワークフローの実行が予想される期間またはタイムアウトを超えます。 + +**解決策:** + +1. **アクション シーケンスを確認する**: ログをチェックして、遅いアクションを特定します。実行時間が 30 秒を超えるアクションを探します。 + +2. **クエリの最適化**: NRQL クエリを使用する場合は、パフォーマンスを向上させるためにクエリを最適化します。 + + * すべてのデータをクエリするのではなく、特定の時間範囲を追加します + * 結果セットのサイズを縮小するには、 `LIMIT`を使用します。 + * `WHERE`句で早期にフィルタリング + +3. **外部 API を確認する**: 統合サービス (AWS、Slack) からの応答が遅いと、実行が遅れる可能性があります。API応答時間を個別にテストします。 + +4. **ワークフローの制限を考慮する**: タイムアウト制約の[ワークフロー制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)を確認します (通常、ワークフローごとに 15 分)。 + +5. **より小さなワークフローに分割する**: 複雑なワークフローを、並行して実行できる、より小さく、集中した自動化に分割します。 + +### ワークフローの変更が有効にならない + +**問題:**ワークフローを編集しましたが、実行時に変更が適用されません。 + +**解決策:** + +1. **保存したことを確認する**：ワークフロー設定を編集した後、 **Save** \[保存]をクリックしたことを確認します。 + +2. **バージョンを確認してください**: + + * ワークフローの詳細へ + * **Version history** \[バージョン履歴]タブをクリック + * 最新の変更が新しいバージョンとして表示されることを確認します + * このバージョンがアクティブとしてマークされていることを確認してください + +3. **スケジュールされた実行の更新**: ワークフローがスケジュールに従って実行される場合は、新しいバージョンを使用するようにスケジュールを更新します。 + + * **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 + * スケジュールされた実行を見つける + * 新しいワークフロー バージョンを参照するようにスケジュールを更新します + +4. **キャッシュをクリア**: Browserキャッシュに古い設定が表示される場合があります - ページをハードリフレッシュします (Ctrl+Shift+R または Cmd+Shift+R)。 + +## ワークフローダッシュボードの問題 + +### ダッシュボードでワークフローが見つからない + +**問題:**作成したワークフローがダッシュボード リストに表示されません。 + +**解決策:** + +1. **フィルターを確認してください**: + + * フィルタードロップダウンをクリック + * ステータスフィルターに「すべて」を選択します + * 検索バーをクリアする + +2. **アカウントの確認**: ワークフローが作成された正しい New Relic アカウントにログインしていることを確認します。右上隅のアカウントセレクターを確認してください。 + +3. **権限を確認する**: ユーザーロールにワークフローを表示するためのアクセス権があることを確認してください。 ワークフロー アクセス権限が必要な場合は、New Relic 管理者に問い合わせてください。 + +4. **ページを更新します**。 Browserキャッシュにより、最近の変更が隠れてしまう場合があります。 ハードリフレッシュ (Ctrl+Shift+R または Cmd+Shift+R) を試してください。 + +### ワークフローを削除できません + +**問題:**削除オプションがグレー表示されているか、削除に失敗します。 + +**解決策:** + +1. **権限を確認する**: ユーザーロールにワークフローの削除権限があることを確認します。 必要に応じてアカウント管理者に問い合わせてください。 + +2. **スケジュールされた実行を停止**: 削除する前に、アクティブなスケジュールされた実行をキャンセルします。 + + * ワークフローの詳細に移動する + * **Scheduled runs** \[スケジュール実行]タブに移動 + * すべてのアクティブなスケジュールをキャンセルする + +3. **依存関係を確認する**: 他の自動化が依存しているワークフローは削除できません。ワークフローが以下によって参照されているかどうかを確認します。 + + * これを呼び出す他のワークフロー + * それをトリガーするアラートポリシー + * API経由で起動する外部システム + +4. **サポートにお問い合わせください**: 上記の手順を試しても問題が解決しない場合は、 [New Relic サポート](https://support.newrelic.com/)にお問い合わせください。 + +## 統合特有の問題 + +### Slackの通知が表示されない + +**問題:**ワークフローは正常に完了しますが、Slack メッセージが表示されません。 + +**解決策:** + +1. **チャネル ID を確認する**: チャネル名ではなく、Slack チャネル**ID** (例: `C01234ABCD` ) を使用していることを確認します。Slack で ID を見つける: + + * チャンネル名を右クリック + * **View channel details** \[チャンネルの詳細を表示]を選択 + * 下部のチャンネルIDをコピーします + +2. **ボットの権限を確認する**: Slack ボットに次のスコープがあることを確認します。 + + * `chat:write` - メッセージを投稿する + * `channels:read` - パブリックチャンネルを表示する + * `groups:read` - プライベートチャンネルを表示する（該当する場合） + +3. **ボットがチャネル内にあることを確認する**: ボットをターゲット チャネルに追加します。 + + * チャンネルに`/invite @YourBotName`と入力してください + * ボットがメンバーリストに表示されていることを確認する + +4. **シークレット内のトークンを確認する**: シークレット マネージャーに保存されている Slack トークンが正しく、期限切れになっていないことを確認します。 + +### AWS Systems Manager の操作が失敗する + +**問題:** SSM 自動化ドキュメントまたはコマンドの実行に失敗します。 + +**解決策:** + +1. **SSM 権限を確認する**: IAM ロールに次の権限があることを確認します。 + ```json + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument", + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": "*" + } + ``` +2. **SSM エージェントを確認します**: 目的の EC2 インスタンスに SSM エージェントがインストールされ、実行されていることを確認します。 + ```bash + aws ssm describe-instance-information --region us-east-1 + ``` +3. **インスタンス プロファイルの確認**: EC2 インスタンスには、コマンドを実行するための SSM 権限を持つ IAM インスタンス プロファイルが必要です。 +4. **ドキュメントの存在を確認する**: 既存の SSM ドキュメントを使用する場合は、それが AWS アカウントとリージョンに存在することを確認します。 + +## テンプレート固有の問題 + +### エンティティ GUID が見つかりません + +**問題:**テンプレートが`Entity not found`エラーで失敗します。 + +**解決策:** + +1. **正しいエンティティ GUID を見つけます**: + + * New Relicのモニター リソース ページに移動します + * GUIDのURLまたはエンティティメタデータを確認します + * [エンティティ検索を](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic#find)使用してエンティティを見つけます + +2. **エンティティが正しいアカウントに存在することを確認する**: ワークフローがデプロイされているのと同じアカウントのエンティティを使用していることを確認します + +3. **エンティティ レポート データを確認する**: エンティティに**Last seen** \[最後に表示されたのは]最近 — 古いエンティティは削除された可能性があります」と表示されていることを確認します。 + +4. **AWSの場合**:[インテグレーション](/docs/infrastructure/amazon-integrations/get-started/introduction-aws-integrations)がアクティブであることを確認してください + + + **エンティティ GUID はアカウント固有です。**アカウント間でワークフローを移動するには、すべてのエンティティ GUID を更新する必要があります。 + + +### NRQL結果を返しません + +**問題:** NRQL クエリを使用するテンプレートは完了しますが、空のデータセットを返します。 + +**解決策:** + +1. **最初にクエリをテストする**: テンプレートに追加する前に[クエリビルダー](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder)を使用してクエリを検証します + +2. **データ型とイベント名を確認します**: + + * `FROM Transaction`を使用してください。 `FROM Transactions` + * 属性名が完全に一致していることを確認します（大文字と小文字を区別します） + +3. **時間範囲を調整する**: まばらなデータの場合は、時間ウィンドウを拡張します。 + + * 最近のデータに`SINCE 1 hour ago`を追加 + * トレンドには`SINCE 1 day ago`を使用する + +4. **段階的に簡素化してテストする**: 基本的なクエリから始めて、フィルターを 1 つずつ追加します。 + +5. **[NRQL構文](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language)のチェック**: クエリ構造がNRQL要件と一致していることを確認します + +### テンプレートのデプロイメントが失敗する + +**問題:**テンプレートがデプロイされないか、デプロイメント中にエラーが表示されます。 + +**解決策:** + +1. **必須入力をすべて確認**: 必須フィールド (資格情報、GUID、クエリ) がすべて入力されていることを確認します。 +2. **認証情報の形式を確認してください**: シークレットはコロンのプレフィックスが付いた`${{ :secrets:keyName }}`形式を使用する必要があります +3. **認証情報を個別にテストする**: デプロイする前に、AWS CLI と Slack API の Slack トークンを使用して AWS 認証情報をテストします。 +4. **テンプレートの要件を確認する**: 各テンプレートには特定の前提条件が記載されているので、すべてが満たされていることを確認します。 +5. **特殊文字のチェック**: 一部のフィールド（チャンネル名、クエリ）は特殊文字で失敗する可能性があります。可能な場合は英数字を使用してください。 + +### 承認ワークフローが応答しない + +**問題:** Slack 承認を必要とするテンプレート (API Gateway ロールバック、EC2 サイズ変更) が反応を検出しません。 + +**解決策:** + +1. **ボットトークンスコープを確認します**: + + * `reactions:read` - 絵文字反応を検出するために必要 + * `chat:write` - 承認メッセージを投稿する必要があります + +2. **反応形式を確認する**: ワークフローで指定された絵文字を正確に使用します (通常、承認の場合は👍、拒否の場合は👎) + +3. **タイムアウト設定を確認する**: 承認requests設定されたタイムアウト（通常 5 ～ 10 分）後に期限切れになります。 + +4. **ボットがメッセージを読み取ることができることを確認する**: ボットはチャネルに参加し、メッセージ履歴を読み取る権限を持っている必要があります + +5. **シンプルな承認でテストする**: 問題を切り分けるために、承認ロジックのみでテストワークフローを作成します。 + +### EC2インスタンス管理の問題 + +**問題:** EC2 テンプレートがインスタンスのサイズ変更や管理に失敗します。 + +**解決策:** + +1. **[CloudWatch Metric Streams](/install/aws-cloudwatch/)が設定されていることを確認します**: 収益 EC2 メトリクスに必要です +2. **[EC2 監視統合](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate)active を確認する**: インスタンス データがNew Relicに流れることを確認します +3. **インスタンスの状態を確認します**。インスタンスは`running`または`stopped`状態である必要があります。遷移状態 (保留中、停止中) は失敗の原因になります。 +4. **インスタンスタイプの互換性を確認する**: すべてのインスタンスタイプがすべてのサイズ変更操作をサポートしているわけではありません。AWS[インスタンスタイプのドキュメントAWS](https://aws.amazon.com/ec2/instance-types/)確認してください。 +5. **停止/開始権限を確認してください**: IAMロールには`ec2:StopInstances`と`ec2:StartInstances`に加えて `ec2:ModifyInstanceAttribute` + +### JSON解析テンプレートがデータをログに記録しない + +**問題:** JSON 解析テンプレートは正常に実行されますが、 New Relicログにデータが表示されません。 + +**解決策:** + +1. **APIエンドポイントの検証**: ブラウザでステータスページのURLをテストし、有効なJSONが返されることを確認します。 +2. **JSON構造をチェック**: テンプレートは特定の形式を想定しています - コンポーネントのヘルスフィールドが期待される構造と一致していることを確認します +3. **ログフィルタを確認する**: ログアクションで正しいイベントタイプと属性が使用されていることを確認する +4. **シンプルなエンドポイントでテスト**: 基本的な JSON エンドポイント ( `https://httpbin.org/json`など) を使用して、テンプレートの仕組みが機能することを確認します。 +5. **アカウント権限の確認**: ワークフローに New Relic にログを書き込む権限があることを確認します + +### NRLens SQL 完了認証が失敗する + +**問題:** NRLens テンプレートが認証または接続エラーで失敗します。 + +**解決策:** + +1. **NRLens 資格情報の確認**: SQL クエリ ゲートウェイの資格情報が最新であり、シークレットに正しく保存されていることを確認します。 +2. **組織 ID とアカウント ID を確認する**: 両方の ID がNew Relic組織と正確に一致していることを確認してください +3. **SQL クエリを個別にテストする**: ワークフローに追加する前に NRLens インターフェースを使用してクエリをテストします。 +4. **SQL 構文の確認**: NRLens SQL は NRQL と異なります。サポートされている構文については、 [NRLens のドキュメント](https://docs.newrelic.com/docs/nrlens-overview)を確認してください。 +5. **クエリの複雑さをチェックする**: 非常に複雑な結合や大規模なデータセットはタイムアウトする可能性があります。クエリを簡素化するか、時間制限を追加します。 + +## 次のステップ + +これらの解決策を試しても問題が解決しない場合は、次の手順に従ってください。 + +* **[ワークフロー自動化コミュニティフォーラム](https://discuss.newrelic.com/)**: 質問をしたり、他のユーザーからサポートを受けたりできます +* **[New Relic サポート](https://support.newrelic.com/)**: アカウント固有の問題についてはサポートにお問い合わせください +* **[ワークフローベストプラクティス](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 信頼できるワークフローのためのパターンを学ぶ +* **[ワークフローの制限](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: システムの制約とクォータを理解する \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx new file mode 100644 index 00000000000..aa60e09b334 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx @@ -0,0 +1,33 @@ +--- +title: スケジュールの作成 +tags: + - workflow automation + - workflow + - CreateSchedule + - workflow automation API +metaDescription: Create a schedule for a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +ワークフロー定義のスケジュールを作成します。 + +スケジュールの数と、特定のスケジュールの最小期間は[、「ワークフロー システムの制限」](/docs/workflow-automation/limitations-and-faq/workflow-limits)で定義されます。 + +## 例 + +ワークフローの作成・編集には、書き込み[ビルダー](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f)を使用します。 [NerdGraph API エクスプローラー](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)を参照してください。 + +```graphql +mutation { + workflowAutomationCreateSchedule( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "healthyHeartbeat", version: 1} + cronExpression: "0 0 * * *" + timezone: "Asia/Kolkata" + options: {logLevel: DEBUG} + ) { + scheduleId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx new file mode 100644 index 00000000000..721f41d159c --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: ワークフロー定義の作成 +tags: + - workflow automation + - workflow + - CreateWorkflowDefinition + - workflow automation API +metaDescription: Create a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +この API はワークフロー定義を作成するために使用されます。ワークフロー定義がすでに存在する場合はエラーを返します。 + +## 例 + +ワークフローの作成・編集には、書き込み[ビルダー](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a)を使用します。 [NerdGraph API エクスプローラー](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)を参照してください。 + +```graphiql + mutation { + workflowAutomationCreateWorkflowDefinition( + scope: { + id: "11933347" + } + definition: { + yaml: "bmFtZTogbXV0YXRpb25fZXhlY3V0ZQoKc3RlcHM6CiAgLSBuYW1lOiBleGVjMQogICAgdHlwZTogYWN0aW9uCiAgICBhY3Rpb246IG5ld3JlbGljLm5lcmRncmFwaC5leGVjdXRlCiAgICB2ZXJzaW9uOiAnMS4wLjAnCiAgICBpbnB1dHM6CiAgICAgIGdyYXBocWw6IHwKICAgICAgICBtdXRhdGlvbiBLZWVwQWxpdmUoJGd1aWQ6IEVudGl0eUd1aWQhKXsKICAgICAgICAgIGVudGl0eUtlZXBBbGl2ZShndWlkczogWyRndWlkXSkgewogICAgICAgICAgICByZWZyZXNoZWRFbnRpdGllcwogICAgICAgICAgfQogICAgICAgIH0KICAgICAgdmFyaWFibGVzOgogICAgICAgIGd1aWQ6ICJ7eyAud29ya2Zsb3dJbnB1dHMuZW50aXR5R3VpZCB9fSIKCiAgLSBuYW1lOiBsb2cxCiAgICB0eXBlOiBhY3Rpb24KICAgIGFjdGlvbjogbmV3cmVsaWMuaW5zdHJ1bWVudGF0aW9uLmxvZwogICAgdmVyc2lvbjogJzEuMC4wJwogICAgaW5wdXRzOgogICAgICBNZXNzYWdlOiAiZW50aXR5R3VpZCByZWZyZXNoZWQge3sgLnN0ZXBzLmV4ZWMxLm91dHB1dHMuZGF0YS5lbnRpdHlLZWVwQWxpdmUucmVmcmVzaGVkRW50aXRpZXMgfX0iCg==" + } + ) { + definition { + name + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx new file mode 100644 index 00000000000..cc38fbf1b9c --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx @@ -0,0 +1,697 @@ +--- +title: ワークフロー定義スキーマ +tags: + - workflow automation + - workflow schems + - workflow automation API +metaDescription: Workflow definitions are written in YAML. Keys use a camelCase naming convention. +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +## スキーマ + +ワークフロー定義は YAML で記述されます。キーは`camelCase`命名規則を使用します。 + +### **名前**（必須） + +* **タイプ**: 文字列 +* **フォーマット**: 正規表現`^[A-Za-z_][A-Za-z0-9_-]*$`に準拠する必要があります。 +* **最大長**: 100 +* **説明**: `name`値は大文字と小文字を区別しません。たとえば、 `ExampleWorkflow` 、 `exampleworkflow` 、 `EXAMPLEWORKFLOW`はすべて同じワークフロー定義を表すものと見なされます。 + +### **説明**（オプション） + +* **タイプ**: 文字列 +* **フォーマット**: 正規表現`^[A-Za-z0-9 _-]*$`に準拠する必要があります。 +* **最大長**: 200 +* **説明**: ワークフローの目的を説明する`description` 。 + +### **workflowInputs**（オプション） + +* **タイプ**: 地図の地図 +* **最大サイズ**: 100 +* **説明**: ワークフローが受け入れるワークフロー入力のマップ。 +* **例**: + +```java + workflowInputs: + myInput1: + type: String + myInput2: + type: Number + defaultValue: 42 +``` + +* **`workflowInputs.`** (必須) + + * **タイプ**: 文字列 ([式安全なパターン]()に準拠) + * **最小の長さ**: 1 + * **最大長**: 50 + * **説明**: ワークフロー入力の名前。 + +* **`workflowInputs..type`** (必須) + + * **タイプ**: 列挙型 (ブール、リスト、マップ、文字列、整数、フロート) + * **説明**: ワークフロー入力のデータ型。 + +* **`workflowInputs..defaultValue`** (オプション) + + * **タイプ**: 任意; `type`に準拠する必要があります。 + * **説明**: ワークフロー入力のデフォルト値。 + +* **手順**（必須） + + * **タイプ**: マップの配列 + * **説明**: ワークフロー定義の実行時に実行される手順。少なくとも 1 つのステップが必要です。 + + + ステップは、 `steps`配列で定義された順序で実行されます。 + + 異なる順序が必要な場合は、 `steps[*].next`プロパティをジャンプ先のステップの名前に設定することで「ジャンプ」を実行できます。 + + + * **`steps[*].name`** (必須) + + * **タイプ**: 文字列 ([式セーフパターン]()に準拠; `end`は不可) + * **最大長**: 100 + * **説明**: `steps[*].next`によって参照されるステップの名前。終了ステップ、ループの継続、またはループからの脱出を示すために使用される特殊キーワード`end` 、 `continue` 、または`break`は使用できません。 + + * **`steps[*].type`** (必須) + + * **タイプ**: 文字列 + * **説明**: ステップのタイプ。実行時にステップが何を行うかを示します。利用可能なオプションについては、[ステップ タイプ]()を参照してください。 + + * [**`steps[*].next`**](#steps-next) (オプション) + + * **タイプ**: 文字列 ([式安全なパターン]()に準拠) + + * **説明**： + + * このステップが正常に完了したときに実行される次のステップの名前。特別なキーワード`end`を使用すると、このステップが最後に実行されることを示すことができます。 + * `next`が省略されている場合、定義の`steps`配列内の次のエントリが暗黙的な次のステップとして使用されます。次のエントリがない場合、ワークフローは完了します。 + +## ステップの種類 + +### **アクション** + +特定のアクションを実行するステップ。利用可能なオプションについては、[アクション カタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)を参照してください。 + +* **`steps[*].action`** (必須) + + * **タイプ**: 文字列 + + * **説明**: 実行するアクション関数の完全修飾名。次の規則に従う必要があります。 + + `..` + + * **例**: + + * New Relic サービスを使用したアクション (例: NerdGraph 経由): `newrelic.dashboards.getDashboard` + * Slackを使ったアクション: `slack.chat.postMessage` + +* **`steps[*].version`** (必須) + + * **タイプ**: 文字列 + * **説明**: 実行するアクション関数のバージョン。 + +* **`steps[*].inputs`** (オプション) + + * **タイプ**: 値のマップ（[式]()を含む） + + * **説明**： + + * アクション関数に渡す入力。受け入れられる特定の入力は、各アクションによって定義されます。 + * 入力には式を使用できます。詳細については、[式文字列の]()セクションを参照してください。 + + + 機密データ ( APIキーやシークレット、PII、PHI、または個人を特定できるデータ) を引数として渡さないでください。 + + +* **`steps[*].inputs.selectors`** (オプション) + + * **タイプ**: `name`と`expression`の形式のマップのリスト。 + + * **説明**： + + * `selectors`入力を使用すると、指定された要素のみを返すように出力を再定義できます。 + * 表現が使えます。詳細については、[式文字列の]()セクションを参照してください。 + + * **例** + + * この例では、http.get アクションの応答として`pageUrl`と`statusDescription`を取得しています。 + + ```yaml + name: status + description: A workflow for checking the status of New Relic components + + steps: + - name: query1 + type: action + action: http.get + version: 1 + inputs: + url: "https://status.newrelic.com/api/v2/status.json" + selectors: + - name: statusCode + expression: '.statusCode' + - name: pageUrl + expression: '.responseBody | fromjson | .page.url' + - name: statusDescription + expression: '.responseBody | fromjson | .status.description' + + - name: logOutput1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "status is '${{ .steps.query1.outputs.statusDescription }}' details at ${{ .steps.query1.outputs.pageUrl }}" + ``` + +### **ループ** + +ループは、 `in`で定義された特定のコレクションを反復処理し、反復ごとにループ変数`index`と`element`を作成します。これらのループ変数は、式`${{ .steps..loop.element }}`または `${{ .steps..loop.index }` + +詳細については以下を参照してください。 + + + + ループを使用して、リスト、マップ、またはコレクションを反復処理できます。 + + * `for` （必須） + + * **タイプ**: 定数 + * **説明**: ループの開始を知らせます。 + + * `in` （必須） + + * **タイプ**: 文字列 (式) + * **説明**: 要素のコレクションに評価する必要がある式。 + + * `steps` （必須） + + * **説明**: ループの各反復で実行される手順。ステップは、別のループを含む任意のタイプのステップにすることができます。 + + * **例**: 以下は、ループ workflowInputs を実行する方法を示しています。結果はコレクションの型である必要があることに注意してください。 + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # not exist outside of this loop + index: '${{ .steps.loopStep.loop.index }}' # not exist outside of this loop + ``` + + + * `element` `index`はループの一部として自動的に割り当てられます。 + * `Index` ゼロベースです。 + * 複合要素のコレクションがある場合、 `element`複合型になることがあります。 + * ループ内のすべてのループ変数とループ内のステップからの出力には、ループ レベルのスコープがあります。これらの変数はループを終了した後にクリアされ、ループの外部からアクセスすると null 値になります。ループは、以前に定義されている場合、ループ外の変数にアクセスできます。 + + + **整数に対する単純な for ループ** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: ${{ [range(1; 6)] }} + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [1, 2, 3, 4, 5] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1, 2, 3, 4] + ``` + + **マップのシンプルなループ** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [ { "key1": "val1" }, { "key2": "val2"} ] }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [{ "key1": "val1" }, { "key2": "val2"}] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1] + ``` + + **ループ内でジャンプする** + + 同じ for ループに属する名前付きステップ間のジャンプのみが許可されます。for ループ内またはループ外、内部/外部ループ、または 2 つの異なる for ループ間でのジャンプは許可されません。 + + ```yaml + name: myWorkflow + steps: + - name: firstStep + type: action + action: example.messaging.sayHello + version: '1.0.0' + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: step3 # Okay within the loop + - name: step2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.step1.outputs.greeting }}' + - name: step3 + type: action + action: example.messaging.sayHello + version: '1.0.0' + next: firstStep # Not okay, first step is not in the loop context + ``` + + **ループ内でbreak/continueを使用する** + + for ループのフローを変更するには、 `next: break`または`next: continue`を使用できます。`break`と`continue`ループ内で暗黙的に定義された予約済みのジャンプ ターゲットであることに注意してください。ループの外で`next: break`または`next: continue`を使用すると、ワークフロー ステップの最後にジャンプします。 + + * `end`はループ内で使用される場合、 `break`と同じように機能します。 + * Next は、スイッチ ステップまたは任意のタイプのステップの両方で使用できます。 + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [range(1; 6)] }}' + steps: + - name: insideLoopStep1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: continue + - name: insideLoopStep2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + - name: loopStepAgain + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: switchStep + type: switch + switch: + - condition: '${{ .steps.loopStepAgain.loop.index >= 0 }}' + next: break + - name: insideLoopStepAgain + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStepAgain.loop.element }}' + ``` + + + +* **`steps[*].for`** (必須) + + * **タイプ**: 定数 + * **説明**: ループの開始を知らせる信号 + +* **`steps[*].in`** (必須) + + * **タイプ**: 文字列 (式) + + * **説明**: 要素のコレクションとして評価する必要がある式。 + + * **`steps[*].steps`** (オプション) + + * **説明**: ループの各反復で実行される手順。上記の手順については定義を参照してください。 + + * **例**: + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: "${{ [range(1; 5)] }}"" + steps: + - name: step1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Loop: ${{ .steps.loopStep.loop.element }}" + ``` + +### **スイッチ** + +* さまざまな条件をチェックし、true と評価される最初の分岐を実行するステップ。 + +* スイッチには、リスト内に任意の数の条件要素を含めることができます。条件を順番にチェックし、最初に true と評価される条件を処理します。どれもtrueと評価されない場合は、steps\[\*].nextで定義されている次のステップを実行します。 + +* **`steps[*].switch`** (必須) + + * **タイプ**: 配列 + * **説明**: 評価する条件の順序付きリストを指定する、スイッチ ケースの配列。 + +* **`steps[*].switch[*].condition`** (必須) + + * **タイプ**: 文字列 (式) + * **説明**: スイッチケースの状態。true と評価された場合、ケースの次のステップが実行されます。 + +* **`steps[*].switch[*].next`** (必須) + + * **タイプ**: 文字列 ([式安全なパターン]()に準拠) + * **説明**: ケースの条件が true と評価された場合に実行するステップの名前。特別なキーワード end を使用すると、このステップが最後に実行されることを示すことができます。 + + ```yaml + - name: hasCompleted + type: switch + switch: + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Failed" }} + next: displayError + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Success" }} + next: displaySuccess + next: displayUnexpected + ``` + +### 待つ + +ワークフローの実行を続行する前に一定の秒数待機させるステップ。1 つ以上の信号をリッスンすることもできます。待機中に信号が受信されない場合は、通常どおり続行されます。信号はリストで定義されます。各信号には対応する次のステップを定義する必要があります。最初に受信された信号が処理されます。信号として受信された値は、待機ステップのステップ出力に保存され、後のステップでのロジック処理に使用できます。 + +* 例： + + ```yaml + name: waitSignalExample + workflowInputs: + steps: + - name: waitStep + type: wait + seconds: 300 + signals: [{name: 'mySignalName', next: 'firstStep'}] + - name: endStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "didn't get signal" + next: end + - name: firstStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.waitStep.outputs.signalInputs.myString }} + ``` + +* **`steps[*].seconds`** (必須) + + * **タイプ**: 数値 + * **説明**: ワークフローの実行を続行する前に待機する秒数。 + +* **`steps[*].signals`** + + * **タイプ**: 配列 + * **説明**: 受信されるとプログラムフローを転換する信号。 + +* **`steps[*].signals[*].name`** + + * **タイプ**: 文字列 + * **説明**: リッスンする信号の名前。 + +* **`steps[*].signals[*].next`** + + * **タイプ**: 文字列 + * **説明**: 指定されたシグナルを受信した場合に実行するステップ。 + +## 共有型 + +### 式文字列 + +いくつかのプロパティは、ワークフロー実行中に評価される埋め込み式を含む文字列値を受け入れ、ワークフロー定義内で動的な値を使用できるようにします。式文字列には 1 つまたは複数の式を含めることができ、各式は二重中括弧で囲まれます。中括弧内の内容は jq を使用して評価されます。 + +jq は、さまざまな方法で値にアクセスし、値を操作する機能を提供します。たとえば、ワークフロー入力文字列の長さは次のようにして実現できます。 `${{ .workflowInputs.myString | length }}` + +[JQ 式を構築およびテストする](https://play.jqlang.org/)には、このツールを使用できます。 + +### 式のプロパティ + +式を使用して、多数のプロパティにアクセスできます。これらのプロパティは「scope」オブジェクト内に存在するため、scope オブジェクトのこれらのプロパティにアクセスするには、式をピリオド (.) で始める必要があります。 + +利用可能なプロパティは次のとおりです。 + +* `workflowInputs` - 開始時にワークフローに渡される入力を含むオブジェクト。 + * 例： `${{ .workflowInputs.myInput }}` +* `steps` - ワークフローの各ステップのプロパティを含むオブジェクト + * `steps.` - 特定のステップのプロパティを含むオブジェクト + * `steps..outputs` - ステップ/アクションに固有の結果プロパティを含むオブジェクト。 + * 例： `${{ .steps.myStep.outputs.myResult }}` + +### 表現評価結果 + +単一の jq 式は任意の JSON 型に評価できますが、式文字列全体の最終結果は式を囲む文字列の内容 (存在する場合) に依存することに注意することが重要です。 + +式文字列全体が単一の式で構成されている場合は、結果の JSON 型を維持しながら、jq 式の結果に評価されます。たとえば、ワークフローに入力として配列が渡された場合、文字列`${{ .workflowInputs.myArray }}`は配列として評価されます。これは、ワークフロー内で複雑なデータを渡す場合に役立ちます。 + +式文字列に単一の式以外のコンテンツが含まれている場合は、文字列の結果に評価されます。たとえば、式の前後にコンテンツがある場合や、文字列内に複数の式がある場合に、この現象が発生します。文字列内の各式は評価され、文字列表現に変換されます。 + +例： + +次の例では、myArray の値が \[1, 2, 3] であると仮定します。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 式文字列 + + 結果データ + + 結果タイプ +
+ `${{ .workflowInputs.myArray }}` + + \[1, 2, 3] + + 数字の配列 +
+ `${{ .workflowInputs.myArray | length }}` + + 3 + + ナンバー +
+ `${{ .workflowInputs.myArray | length > 0 }}` + + true + + ブール値 +
+ `Input is not empty: ${{ .workflowInputs.myArray | length > 0 }}` + + 「入力が空ではありません: true」 + + ストリング +
+ `${{ .workflowInputs.myArray }} has length ${{ .workflowInputs.myArray | length }}` + + 「長さは3です」 + + ストリング +
+ +### 式セーフパターン [#expression-safe-pattern] + +式で使用できるプロパティは、次の正規表現に準拠する必要があります。 `^[A-Za-z_][A-Za-z0-9_]*$` + +### 秘密の参照 + +シークレット値は、シークレット サービスで検索するシークレットの名前を指定する参照文字列を介してアクションで使用できます。ワークフロー定義でシークレットを参照するには、次の構文を使用します。 + +* `${{ :secrets: }}` 秘密は `namespace` +* `${{ :secrets:: }}` 秘密のために `namespace` + +式文字列には、シークレット参照と JQ 式の組み合わせ、または複数のシークレット参照を含めることができます。 + +例： + +```yaml + steps: + - name: bearer_auth + type: action + action: http.post + inputs: + headers: + Authorization: Bearer ${{ :secrets: }} +``` + +## 例 + +* こんにちは世界 + +```yaml +name: helloWorld +description: 'A hello world workflow' + +workflowInputs: + name: + type: String + defaultValue: World + required: false + validations: + - type: maxLength + errorMessage: "name must be at most 100 characters" + length: 100 + slackTokenSecret: + type: String + defaultValue: "${{ :secrets:SLACK_TOKEN }}" + slackChannel: + type: String + defaultValue: my-channel + validations: + - type: regex + errorMessage: "A slack channel name must be lowercase and can only contain letters, numbers, and hyphens" + pattern: "^[a-z0-9\\-]+$" + required: true + +steps: + - name: init1 + type: assign + inputs: + greeting: Hello ${{ .workflowInputs.name }} + + - name: logName + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.init1.outputs.greeting }} + + - name: waiting1 + type: wait + seconds: 1 + + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + query: >- + FROM Log SELECT * WHERE message LIKE '${{ .steps.init1.outputs.greeting + }}' + + - name: checkResult + type: switch + switch: + - condition: ${{ .steps.queryForLog.outputs.results | length > 0 }} + next: FoundMessage + + - name: waitingMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Waiting for log message... + token: ${{ .workflowInputs.slackTokenSecret }} + next: waiting1 + + - name: FoundMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Found message! ${{ .steps.queryForLog.outputs.results[0].message }} + token: ${{ .workflowInputs.slackTokenSecret }} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx new file mode 100644 index 00000000000..8e3cc9b9d93 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx @@ -0,0 +1,44 @@ +--- +title: スケジュールの削除 +tags: + - workflow automation + - workflow + - Delete Schedule + - workflow automation API +metaDescription: 'Deletes the schedule of a workflow definition. Note, this doesn’t stop already running workflow instance.' +freshnessValidatedDate: never +translationType: machine +--- + +ワークフロー定義のスケジュールを削除します。ただし、これによって現在実行中のワークフロー実行が停止されるわけではありません (StopWorkflowRun ミューテーションを使用します)。 + +## 例 [#example] + +ワークフローの作成・編集には、書き込み[ビルダー](https://one.newrelic.com/nerdgraph-graphiql?state=fc314f67-101e-a54a-169a-191d1fd41fd)を使用します。 [NerdGraph API エクスプローラー](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)を参照してください。 + +```graphql + mutation { + workflowAutomationDeleteSchedule( + accountId: 11933347 + schedule: {id: "1a71d299-82c2-4b4d-9803-b14523e3a9e7"} + ) { + scheduleId + } + } +``` + +### エラー例 + +`schedule.id`が見つからない場合は、次の構造が返されます。 + +```graphql +{ + "data": { + "workflowAutomationDeleteSchedule": null + }, + "errors": [{ + "message": "Could not find schedule with ID MTE2NDk5MDB8TkdFUHxXT1JLRkxPV19TQ0hFRFVMRXwwMTk5MGUzYi04NzAyLTc2M2QtOWUzMy01ZTU1ZThmZTYzYjkl", + "path": ["workflowAutomationDeleteSchedule"] + }] +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx new file mode 100644 index 00000000000..8fd2c533990 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx @@ -0,0 +1,32 @@ +--- +title: ワークフロー定義の削除 +tags: + - workflow automation + - workflow + - Delete Workflow Definition + - workflow automation API +metaDescription: Used to delete all the workflow definition versions with the specified name. +freshnessValidatedDate: never +translationType: machine +--- + +この API は、指定された名前を持つすべてのワークフロー定義バージョンを削除します。 + +定義を削除するには、その定義を使用しているスケジュールが存在していない必要があります。定義が現在スケジュールによって使用されている場合、定義の削除は失敗し、それに応じてエラーが返されます。 + +定義が削除された場合でも、実行中のワークフロー実行はすべて完了まで続行されます。 + +## 例 + +```graphql +mutation { + workflowAutomationDeleteWorkflowDefinition( + definition: {name: "my-workflow"} + scope: {id: "12345678", type: ACCOUNT} + ) { + definition { + name + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx new file mode 100644 index 00000000000..414518f41f2 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx @@ -0,0 +1,158 @@ +--- +title: アクション定義の取得 +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: 'Returns all action definitions stored. This operation is behind NerdGraph, under account stitch point.' +freshnessValidatedDate: never +translationType: machine +--- + +\#ワークフロー定義の作成に使用できるすべてのアクション定義を返します。 + +## 例 + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + actionDefinitions { + results { + description + inputs { + name + required + secretAllowed + } + name + outputs { + name + } + timeout { + action + } + version + } + } + } + } + } +} +``` + +次のような結果を返します + +```graphql +{ + "data": { + "actor": { + "account": { + "workflowAutomation": { + "actionDefinitions": { + "results": [ + { + "description": "Reboot one or more EC2 instances in an AWS account.", + "inputs": [ + { + "name": "awsRoleArn", + "required": false, + "secretAllowed": false + }, + { + "name": "awsAccessKeyId", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSecretAccessKey", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSessionToken", + "required": false, + "secretAllowed": true + }, + { + "name": "region", + "required": true, + "secretAllowed": false + }, + { + "name": "instanceIds", + "required": true, + "secretAllowed": false + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "aws.ec2.rebootInstances", + "outputs": [ + { + "name": "success" + }, + { + "name": "response" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 25 + }, + "version": 1 + }, + { + "description": "Send logs to New Relic.", + "inputs": [ + { + "name": "attributes", + "required": false, + "secretAllowed": false + }, + { + "name": "logs", + "required": true, + "secretAllowed": false + }, + { + "name": "licenseKey", + "required": false, + "secretAllowed": true + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "newrelic.ingest.sendLogs", + "outputs": [ + { + "name": "success" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 20 + }, + "version": 1 + } + # more ... + ] + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx new file mode 100644 index 00000000000..92a8e3c0a43 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx @@ -0,0 +1,29 @@ +--- +title: スケジュールを取得 +tags: + - workflow automation + - workflow + - Get Schedule + - workflow automation API +metaDescription: API gets and returns a schedule. +freshnessValidatedDate: never +translationType: machine +--- + +この API はスケジュールを取得して返します。 + +## 例 [#example] + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedule(id: "schedule-id") { + id + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx new file mode 100644 index 00000000000..33b1aaeb937 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx @@ -0,0 +1,41 @@ +--- +title: スケジュールを取得 +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Returns information about schedules. +freshnessValidatedDate: never +translationType: machine +--- + +スケジュールに関する情報を返します。 + +## 例 + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedules { + results { + definition { + name + scope { + id + type + } + version + } + schedule { + id + } + } + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx new file mode 100644 index 00000000000..79567f2c466 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx @@ -0,0 +1,35 @@ +--- +title: ワークフロー定義の取得 +tags: + - workflow automation + - workflow + - Get Workflow Definition + - workflow automation API +metaDescription: Used to get and return a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +この API はワークフロー定義を取得して返します。 + +## 例 + +ワークフローの作成・編集には、書き込み[ビルダー](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a)を使用します。 [NerdGraph API エクスプローラー](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)を参照してください。 + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflow(name: "my-workflow", version: 1) { + definition { + name + version + yaml + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx new file mode 100644 index 00000000000..f0e0c3054fb --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx @@ -0,0 +1,38 @@ +--- +title: ワークフロー定義の取得 +tags: + - workflow automation + - workflow + - Get Workflow Definitions + - workflow automation API +metaDescription: Used to get and return a list of workflow definitions under the user account’s scope. +freshnessValidatedDate: never +translationType: machine +--- + +この API は、指定されたスコープ内のすべてのワークフロー定義アウトラインのリストを取得して返します。注意: このクエリでは、内部ワークフロー定義 yaml は使用できません。ワークフロー定義 yaml は GetWorkflowDefinition クエリを使用してのみ返されます `/{actor/account(:id)/workflowAutomation/workflow(:name, :version)` + +## 例 + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflows(cursor: "xyz123") { + results { + definition { + name + scope { + id + type + } + version + } + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx new file mode 100644 index 00000000000..c9fdeb25ac9 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx @@ -0,0 +1,75 @@ +--- +title: シグナルワークフロー実行 +tags: + - workflow automation + - workflow + - Signal Workflow Run + - workflow automation API +metaDescription: Actions trigger a signal to an existing running workflow. +freshnessValidatedDate: never +translationType: machine +--- + +この API は、実行中の既存のワークフローへのシグナルをトリガーします。これを使用してコールバックを送信し、ワークフローによって評価されて次のステップに進むことができます。 + +問題は信号と一緒に渡すことができます。 + +## 例 [#example] + + + + ```yaml + name: signalDemo + + steps: + - name: waitStep + type: wait + seconds: 300 + signals: + - name: approve + next: signalHandler + - name: cancel + next: signalHandler + + - name: NoSignalReceived + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "no signals received" + next: end + + - name: signalHandler + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "signal '${{ .steps.waitStep.outputs.signalName }}' was received with: '${{ .steps.waitStep.outputs.signalInputs | tostring }}'" + ``` + + + +このワークフローを開始すると、開始時にこのrunIdが返されます `107e6df2-aa17-41bc-8065-bfa46bde810b` + +ワークフローはこの変異によって通知される。 + +```graphql +mutation { + workflowAutomationSignalWorkflowRun( + accountId: 11933347 + runId: "107e6df2-aa17-41bc-8065-bfa46bde810b" + signalName: "approve" + signalInputs: [ + {key: "foo", value: "bar"} + ] + ) { + runId + } +} +``` + +ワークフローが以下のコマンドで開始された場合、ログには次のような内容が記録されます。 `options: {logLevel: DEBUG}` + +Screenshot displaying Logs if the workflow was started with the options: {logLevel: DEBUG} \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx new file mode 100644 index 00000000000..7001373ca82 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx @@ -0,0 +1,35 @@ +--- +title: ワークフロー実行の開始 +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Start a workflow run for a specified workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +この API は、指定されたワークフロー定義のワークフロー実行を開始します。 + +ワークフローの同時実行の数と、特定の実行で実行されるステップの数は[、「ワークフローのシステム制限」](/docs/workflow-automation/limitations-and-faq/workflow-limits)で定義されます。 + +## 例 + +ワークフローの作成・編集には、書き込み[ビルダー](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f)を使用します。 [NerdGraph API エクスプローラー](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)を参照してください。 + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "my-workflow"} + workflowInputs: [ + {key: "foo", value: "bar"}, + {key: "fruit", value: "apple"} + ] + options: {logLevel: DEBUG} + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx new file mode 100644 index 00000000000..f3903b74842 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx @@ -0,0 +1,26 @@ +--- +title: ワークフロー実行を停止 +tags: + - workflow automation + - workflow + - Stop Workflow Run + - workflow automation API +metaDescription: Stops a running workflow instance. +freshnessValidatedDate: never +translationType: machine +--- + +これにより、実行中のワークフローが停止します。ワークフローが見つからない場合は、空の`runId`を返します。 + +## 例 + +```graphql +mutation { + workflowAutomationStopWorkflowRun( + accountId: 11933347 + runId: "7ffbe082-8efa-4d3d-901a-a08bcf22bcd3" + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx new file mode 100644 index 00000000000..50e6c12e1c0 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx @@ -0,0 +1,30 @@ +--- +title: ワークフロー定義の更新 +tags: + - workflow automation + - workflow + - Update Workflow Definition + - workflow automation API +metaDescription: Used to update an existing workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +既存のワークフロー定義を更新するために使用されます。ワークフロー定義がまだ存在しない場合はエラーを返します。 + +## 例 + +```graphql + mutation { + workflowAutomationUpdateWorkflowDefinition( + definition: {yaml: ""} + scope: {id: "11608789", type: ACCOUNT} + ) { + definition { + name + version + yaml + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx new file mode 100644 index 00000000000..86d5528b1d1 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx @@ -0,0 +1,81 @@ +--- +title: ワークフロー自動化 API リファレンス +tags: + - workflow automation + - workflow + - nerdgraph + - nerdgraph api + - workflow automation api +metaDescription: Complete reference guide for Workflow Automation APIs in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +ワークフロー オートメーションAPI使用すると、 New Relicでワークフローをプログラムで作成、管理、実行できます。 これらの API を使用して、反復的なタスクを自動化し、複雑な操作を調整し、ワークフローを開発プロセスと運用プロセスに統合します。 + +## あなたが始める前に + +ワークフロー自動化 API を使用するには、次のものが必要です。 + +* 適切な権限を持つNew Relicアカウント +* [NerdGraph APIエクスプローラー](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a)にアクセスしてAPIコールを作成し、テストします +* [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) （New RelicのGraphQL API）の理解 + +さらにヘルプが必要な場合は、以下を参照してください。 + +* [NerdGraph APIエクスプローラーチュートリアル](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)でGraphiQL IDEの使い方を学びましょう +* New Relic APIの概要については、 [APIの概要](/docs/apis/intro-apis/introduction-new-relic-apis)を参照してください。 + +### 認証と秘密 + +ワークフロー オートメーションは、 APIキーや資格情報などの機密情報を管理するために顧客秘密ストレージを使用します。 シークレットは[GraphQL API](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph)を通じて管理されます。秘密管理に関連する認証の詳細については、 [NerdGraph のドキュメント](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph)を参照してください。 + +## カテゴリ別API操作 + +### ワークフローの作成と管理 + +ワークフロー定義を作成、更新、検証、および削除するには、次の API を使用します。 + +* [CreateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/create-workflow-definition) - 新しいワークフロー定義を作成する +* [UpdateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/update-workflow-definition) - 既存のワークフロー定義を更新する +* [ValidateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition) - 作成または更新する前にワークフロー定義 YAML を検証します +* [DeleteWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition) - 指定された名前のワークフロー定義のすべてのバージョンを削除します + +### クエリのワークフローとアクション + +ワークフローと利用可能なアクションに関する情報を取得するには、次の API を使用します。 + +* [GetWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/get-workflow-definition) - 特定のワークフロー定義を取得して返す +* [GetWorkflowDefinitions](/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions) - アカウントスコープ内のワークフロー定義のリストを取得して返します +* [GetActionDefinitions](/docs/workflow-automation/workflow-automation-apis/get-action-definitions) - 利用可能なすべてのアクション定義を返します + +### ワークフローを実行する + +ワークフローの実行を制御するには、次の API を使用します。 + +* [StartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) - 指定されたワークフロー定義のワークフロー実行を開始します +* [SignalWorkflowRun](/docs/workflow-automation/workflow-automation-apis/signal-workflow-run) - 実行中の既存のワークフローにシグナルをトリガーする +* [StopWorkflowRun](/docs/workflow-automation/workflow-automation-apis/stop-workflow-run) - 実行中のワークフローインスタンスを停止する + +### ワークフローのスケジュール + +ワークフロー スケジュールを作成および管理するには、次の API を使用します。 + +* [CreateSchedule](/docs/workflow-automation/workflow-automation-apis/create-schedule) - ワークフロー定義のスケジュールを作成する +* [GetSchedule](/docs/workflow-automation/workflow-automation-apis/get-schedule) - スケジュールの詳細を取得して返す +* [GetSchedules](/docs/workflow-automation/workflow-automation-apis/get-schedules) - すべてのスケジュールに関する情報を返します +* [DeleteSchedule](/docs/workflow-automation/workflow-automation-apis/delete-schedule) - ワークフロー定義のスケジュールを削除します + + + スケジュールを削除しても、すでに実行中のワークフロー インスタンスは停止されません。 + + +### 参照ドキュメント + +* [定義スキーマ](/docs/workflow-automation/workflow-automation-apis/definition-schema)- ワークフロー定義の構造と構文リファレンス \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx new file mode 100644 index 00000000000..129bfdb72f4 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: ワークフロー定義の検証 +tags: + - workflow automation + - workflow + - Validate Workflow Definition + - workflow automation API +metaDescription: Used to validate workflow definition YAML. +freshnessValidatedDate: never +translationType: machine +--- + +ワークフロー定義 yaml を検証します。 + +## 例 + +```graphql + query workflowDefinitionValidation { + actor { + account(id: 11933347) { + workflowAutomation { + workflowDefinitionValidation( + definition: {yaml: "ICAgICAgICAgICAgICAgIG5hbWU6IG15V29ya2Zsb3cKCiAgICAgICAgICAgICAgICBzdGVwczoKICAgICAgICAgICAgICAgICAgLSBuYW1lOiBvbmx5U3RlcAogICAgICAgICAgICAgICAgICAgIHR5cGU6IHdhaXQKICAgICAgICAgICAgICAgICAgICBzZWNvbmRzOiAtNDIKCiAgICAgICAgICAgICAgICAgIC0gbmFtZTogJycKICAgICAgICAgICAgICAgICAgICB0eXBlOiB3YWl0CiAgICAgICAgICAgICAgICAgICAgc2Vjb25kczogLTQyCgogICAgICAgICAgICAgICAgICAtIG5hbWU6IG9ubHlTdGVwCiAgICAgICAgICAgICAgICAgICAgdHlwZTogYWN0aW9uCiAgICAgICAgICAgICAgICAgICAgYWN0aW9uOiBDb25zb2xlTG9nCiAgICAgICAgICAgICAgICAgICAgdmVyc2lvbjogIiIKICAgICAgICAgICAgICAgICAgICBpbnB1dHM6CiAgICAgICAgICAgICAgICAgICAgICAgZm9vOiAiIg=="} + ) { + errors { + message + } + valid + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx new file mode 100644 index 00000000000..6a1d2a07ed7 --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx @@ -0,0 +1,32 @@ +--- +title: ワークフロー実行情報 +tags: + - workflow automation + - workflow + - Workflow Run Info + - workflow automation API +metaDescription: Used to retrieve information about a specific workflow run. +freshnessValidatedDate: never +translationType: machine +--- + +この API は、特定のワークフロー runId のワークフローのステータスを取得して返します。 + +## 例 + +ワークフローの作成・編集には、書き込み[ビルダー](https://one.newrelic.com/nerdgraph-graphiql?state=03119d23-7b51-7b7a-1c99-d2cd026300e5)を使用します。 [NerdGraph API エクスプローラー](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)を参照してください。 + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflowRunInfo(runId: "8911c7e4-5a1f-4316-90c8-67adde72dd1c") { + logUrl + status + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/workflow-automation/workflow-examples.mdx b/src/i18n/content/jp/docs/workflow-automation/workflow-examples.mdx new file mode 100644 index 00000000000..d9d8752cf5b --- /dev/null +++ b/src/i18n/content/jp/docs/workflow-automation/workflow-examples.mdx @@ -0,0 +1,244 @@ +--- +title: ワークフローの例 +tags: + - workflow automation + - workflow + - automation + - examples +metaDescription: 'Common workflow automation scenarios and examples for incident response, infrastructure management, and integrations.' +freshnessValidatedDate: never +translationType: machine +--- + +このページでは、ワークフロー自動化を使用して構築できる一般的な自動化シナリオを示します。これらの例を独自のワークフローの開始点として使用するか、すぐにデプロイできるソリューションの[テンプレート ライブラリ](/docs/workflow-automation/create-a-workflow-automation/use-a-template)を探索してください。 + +## インシデント対応と修復 + +### APIゲートウェイのロールバック + +API ゲートウェイの構成を以前の状態に戻して、エラーや誤った構成を修正できるようにします。 + +**このワークフローの機能:** + +* New Relic Change Tracking (変更追跡機能) を使用して、問題に関連する最近のデプロイメントを検出します +* 承認ボタン（:+1: または :-1:）付きの Slack 通知を送信します +* 承認後、ロールバックを自動化するための AWS Systems Manager ドキュメントを作成します。 +* API Gateway 統合を以前のLambdaバージョンにロールバックします +* ロールバックを適用するための新しいデプロイメントを作成します +* Slackに成功または失敗の通知を送信します +* 完了後にSSMドキュメントをクリーンアップします + +**要件：** + +* API Gateway および Systems Manager の権限を持つ AWS 認証情報 +* 通知と承認を受け取るための設定済みSlackアプリ +* 変更追跡によるNew Relicエンティティ監視 (変更追跡機能) + +**キーアクション**: `newrelic.nerdgraph.execute` 、 `slack.chat.postMessage` 、 `slack.chat.getReactions` 、 `aws.systemsManager.writeDocument` 、 `aws.systemsManager.startAutomation` 、 `aws.systemsManager.waitForAutomationStatus` 、 `aws.systemsManager.deleteDocument` + +### EC2インスタンス管理 + +EC2 インスタンスのプロビジョニング、スケーリング、終了を自動化して、最適なパフォーマンスとコストを実現します。 + +**このワークフローの機能:** + +* New RelicからCPU使用率が高いというアラートを受信する +* 大量の詳細を取得し、影響を受ける EC2 インスタンスを特定します +* インスタンスの詳細を含む Slack 通知を送信し、サイズ変更の承認requests +* 承認後、インスタンスのサイズ変更を自動化するための SSM ドキュメントを作成します。 +* インスタンスを停止し、インスタンスタイプを変更して再起動します +* サイズ変更プロセス中に進捗状況を Slack に送信します +* 完了を待ち、成功または失敗のステータスを送信します +* SSM文書をクリーンアップし、最終確認を送信します + +**要件：** + +* EC2 および Systems Manager の権限を持つ AWS 認証情報 +* EC2 メトリクスのアクティブな New Relic アラート条件 +* 通知と承認を受け取るための設定済みSlackアプリ + +**キーアクション**: `newrelic.nerdgraph.execute` 、 `newrelic.nrdb.query` 、 `slack.chat.postMessage` 、 `slack.chat.getReactions` 、 `aws.systemsManager.writeDocument` 、 `aws.systemsManager.startAutomation` 、 `aws.systemsManager.waitForAutomationStatus` 、 `aws.systemsManager.deleteDocument` 、 `utils.datetime.fromEpoch` 、 `utils.uuid.generate` + +### デプロイメントのロールバック + +エンティティが異常になった場合はデプロイメントをロールバックし、AWS SQS または HTTP のいずれかで通知します。 + +**このワークフローの機能:** + +* エンティティの重大度を指定された期間 (デフォルトは 30 分) 監視します。 +* エンティティの健全性を1分ごとにチェックします +* エンティティがCRITICALまたはWARNINGになった場合、不健全な状態をログに記録します。 +* エンティティの詳細を含むロールバック通知を AWS SQS (設定されている場合) 経由で送信します。 +* HTTP Webhook 経由でロールバック通知を送信します (設定されている場合) +* エンティティが全期間健全なままであれば、成功をログに記録します +* エンティティが見つからない場合は監視を停止します + +**要件：** + +* New Relicエンティティの重大度監視 +* (オプション) ロールバック通知を受信するための AWS SQS キューとロール +* (オプション) ロールバック通知を受信する HTTP エンドポイント + +**キーアクション**: `newrelic.nerdgraph.execute` 、 `newrelic.ingest.sendLogs` 、 `aws.execute.api` (sqs.send\_message)、 `http.post` + +## データ処理とレポート + +### Slackにレポートを送信する + +NRQL クエリ出力を CSV ファイルとして Slack に送信します。 + +**このワークフローの機能:** + +* 指定された New Relic アカウントに対して NRQL クエリを実行します。 +* クエリ結果からCSVファイルを生成します +* CSVファイルを指定されたSlackチャンネルにメッセージとともに投稿する + +**要件：** + +* New Relic 認証情報と機能的な NRQL クエリ +* トークンとターゲットチャンネルが設定されたSlackアプリ + +**キーアクション**: `newrelic.nrdb.query` 、 `utils.transform.toCSV` 、 `slack.chat.postMessage` + +### JSON解析 + +New Relic パブリック ステータス API JSON (HTTP) を解析し、オプションで運用コンポーネントと非運用コンポーネントをログに記録します。 + +**このワークフローの機能:** + +* New RelicステータスAPIからJSONデータを取得します +* コンポーネントを動作状態別に抽出し分類します +* 条件付きで運用コンポーネントをログに記録する（有効な場合） +* 条件付きで非動作コンポーネントをログに記録する（有効な場合） +* HTTPエラーを処理し、エラーメッセージをログに記録します + +**要件：** + +* New Relic ステータス API (summary.json) へのアクセス +* newrelic.ingest.sendLogs 経由でログを送信する権限 + +**キーアクション**: `http.get` 、 `newrelic.ingest.sendLogs` + +## 利用可能なテンプレートワークフロー + +上記のテンプレートはNew Relicワークフロー Automation UIで直接利用できます。 アクセスするには: + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**にアクセスしてください。 +2. **Create workflow** \[ワークフローの作成を]クリック +3. **Use a template** \[テンプレートを使用するを]選択 +4. テンプレートライブラリを参照して、ユースケースに合ったワークフローを選択します + +各テンプレートには以下が含まれます。 + +* 事前設定されたワークフローステップとロジック +* 入力例 +* 必要な認証情報と統合 +* 期待される成果の文書化 + +テンプレートをそのまま使用することも、特定の要件に合わせてカスタマイズすることもできます。 + +## ステップ間でのデータの受け渡し + +すべてのワークフローは、テンプレート構文を使用して前のステップからの出力を参照できます。これにより、アクションを連結し、複雑な自動化ロジックを構築できます。 + +### 基本的なデータの受け渡し + +```yaml +steps: + - name: getAlert + action: newrelic.nerdgraph.execute + inputs: + query: | + { + actor { + account(id: 123456) { + alerts { + violation(id: 789) { + condition + entity { + name + guid + } + } + } + } + } + } + + - name: sendToSlack + action: slack.chat.postMessage + inputs: + channel: "#incidents" + text: "Alert: ${{ .steps.getAlert.outputs.data.actor.account.alerts.violation.condition }}" +``` + +### ループ内でのデータの使用 + +```yaml +steps: + - name: listInstances + type: action + action: aws.ec2.describeInstances + version: 1 + inputs: + filters: + - name: "tag:Environment" + values: ["production"] + + - name: checkEachInstance + type: loop + for: + in: "${{ .steps.listInstances.outputs.reservations }}" + steps: + - name: getInstanceMetrics + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + query: "SELECT average(cpuPercent) FROM SystemSample WHERE instanceId = '${{ .steps.checkEachInstance.loop.element.instanceId }}'" +``` + +### データを使った条件付きロジック + +```yaml +steps: + - name: checkCPU + type: action + action: newrelic.nerdgraph.execute + version: 1 + # ... query configuration + + - name: decideAction + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 70 }}" + next: sendWarning + next: normalOperation + + - name: resizeInstance + type: action + action: aws.ec2.modifyInstanceAttribute + version: 1 + # ... resize configuration + + - name: sendWarning + type: action + action: slack.chat.postMessage + version: 1 + # ... warning message + + - name: normalOperation + type: action + action: newrelic.ingest.sendLogs + version: 1 + # ... log normal status +``` + +## 次のステップ + +* **[独自のワークフローを作成する](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**- ワークフローを構築するためのステップバイステップ ガイド +* **[アクションカタログ](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**- 利用可能なすべてのアクションを参照します +* **[テンプレートを使用する](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**- デプロイの構築済みワークフロー +* **[AWS 認証情報の設定](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)**- AWS 認証を構成する \ No newline at end of file diff --git a/src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx b/src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx new file mode 100644 index 00000000000..65be8f0b577 --- /dev/null +++ b/src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx @@ -0,0 +1,28 @@ +--- +title: 추가 결제(선택사항) +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: Add-ons are an optional billing factor +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +GB Ingested 및 청구 가능 사용자의 기본 청구 요소 외에도 선택적 청구 가능 추가 기능을 사용하여 뉴렐릭의 경험을 확장할 수 있습니다. + +* **Advanced Compute \[高度なコンピューティング] (旧称 Add-on Compute \[アドオン コンピューティング])**: 이 애드온은 CodeStream, Live Archives 및 기타 사용 가능한 기능과 관련하여 실행하는 작업에 대한 사용량 기반 청구에 적용됩니다. [고급 CCU](/docs/licenses/license-information/product-definitions/new-relic-one-pricing-definitions/#compute-capacity-unit) 사용량에 따라 측정 및 요금이 청구됩니다. + + + 고급 컴퓨팅 모드에서 CodeStream 사용하면 사용자 유형에 관계없이 CCU 요금이 부과됩니다. 즉, 무료 기본 사용자는 고급 컴퓨팅 기능에 액세스할 수 있지만 고급 CCU에 대해서는 요금이 부과됩니다. + + +* **Original Data 또는 Data Plus용 EU 데이터센터**: 이 추가 기능은 사용 가능한 경우 데이터 지역으로 유럽 연합을 선택하면 데이터 옵션(Original Data 또는 Data Plus)에 적용됩니다. + +* **Extended Retention for Original Data or Data Plus \[원본 데이터 또는 데이터 플러스의 연장 보존]**: 이 추가 기능은 데이터가 보존되는 기본 기간을 초과한 경우 적용됩니다. 이는 로그뿐만 아니라 모든 데이터에 적용되며, 많은 양의 작은 쿼리를 실행해야 하거나 대량의 데이터에 대한 쿼리를 실행해야 하는 경우 좋은 옵션입니다. + +* **Live Archives \[라이브 아카이브]**: 로그 보관 기간을 최대 7년까지 연장합니다. 라이브 아카이브에는 고급 컴퓨팅도 필요합니다. + +* **New Relic Synthetics Checks**: 이 추가 기능은 귀하의 수표가 신세틱 모니터링 검사의 기본 수를 초과하는 경우 적용됩니다. + +* **Security RX**: 이 기능은 데이터 플러스에 포함되어 있지만, 데이터 플러스 없이 시큐리티 RX 기능을 사용하는 경우 추가 기능이 적용됩니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx b/src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx new file mode 100644 index 00000000000..4e466ace0f4 --- /dev/null +++ b/src/i18n/content/kr/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx @@ -0,0 +1,354 @@ +--- +title: '데이터: 청구 및 규칙' +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: 'For New Relic pricing, an explanation of how data ingest is calculated for billing purposes.' +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +New Relic 가격 책정의 경우 New Relic 조직에서 수집한 데이터가 청구 요소 중 하나입니다. + +## 비용에 대해 알아보기 [#costs] + +아직 New Relic 고객이 아니고 비용에 대해 궁금한 경우 먼저 [기본 가격 페이지를](https://newrelic.com/pricing)참조하십시오. 기존 고객인 경우 데이터 수집 청구에 대한 세부 정보를 계속 읽으십시오. + +## UI에서 데이터 수집 보기 [#ui] + +UI에서 사용량 및 청구 정보를 찾는 방법은 [청구 UI를](/docs/accounts/accounts-billing/general-account-settings/introduction-account-settings)참조하십시오. + +데이터 수집을 보고 관리하는 방법은 [수집 관리를](/docs/data-apis/manage-data/manage-data-coming-new-relic)참조하십시오. + +## 데이터 옵션: 데이터 플러스 및 원본 [#data-prices] + +조직의 수집된 데이터 GB당 가격은 조직의 데이터 옵션( **Data Plus** 또는 **Original Data** 옵션)에 따라 다릅니다. Data Plus 옵션은 최적화된 성능, 규모, 보안 및 거버넌스를 위한 고급 데이터 기능을 제공합니다. 뉴렐릭 조직은 한 번에 하나의 옵션만 가질 수 있습니다. + +다음은 두 옵션을 비교한 표입니다. 가격 및 한도는 월 단위이며 가격은 USD로 표시됩니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 특징/능력 + + **Original Data** 옵션 + + **Data Plus** 옵션 + + 더 많은 기능 세부 정보 +
+ [에디션](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#editions) + + 모든 에디션 + + 스탠다드(Standard), 프로(Pro) 또는 엔터프라이즈(Enterprise) 필요 + + (기능이 에디션에만 해당되는 경우 아래에 설명되어 있습니다.) + +
+ 데이터 무료 한도 + + 100GB 수집됨 + + 100GB 수집됨 + +
+ 데이터 가격
(무료 한도를 초과) + 		+ $0.40/GB 수집됨 + + $0.60/GB 수집됨 + +
+ 데이터 보존 무료 한도
([데이터 유형에 따라 다름](/docs/data-apis/manage-data/manage-data-retention)) + 		+ 최소 8일의 기본값 + + 기본 기간보다 90일 추가 + +
+ 추가 30일 보존 기간당 가격
(무료 한도 초과) + 		+ +$0.05/GB + + +$0.05/GB + +
+ [EU 데이터 센터](/docs/accounts/accounts-billing/account-setup/choose-your-data-center)에 데이터를 저장하기 위한 추가 가격
+ 		+ +$0.05/GB + + +$0.05/GB + + 데이터는 기본적으로 미국 데이터 센터에 저장됩니다. +
+ 최대 [쿼리 한도](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-limits) + + 분당 최대 200억 개의 데이터 포인트 + + 분당 최대 60B 데이터 포인트 + +
+ 최대 [쿼리 기간](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-duration) + + 1 분 + + 최대 10분 + +
+ 클라우드 공급자 선택 + + 단일 클라우드 공급자 + + Azure 또는 여러 클라우드 공급자 + + 원격 측정 스토리지를 엔지니어링 배포 모델 및 클라우드 기본 설정에 맞추려면 관측 가능성 워크로드에 대해 선호하는 클라우드 공급자를 선택하세요. +
+ [로그 난독화](/docs/logs/ui-data/obfuscation-ui/) + + 로그에서 알려진 신용 카드 및 주민등록번호 패턴을[자동으로](/docs/logs/get-started/new-relics-log-management-security-privacy/#log-obfuscation) 마스킹합니다. + + UI에서 직접 규칙을 만들고 추적하며 [마스크 또는 민감한 로그 데이터를 해시](/docs/logs/ui-data/obfuscation-ui/) 합니다. + +
+ [New Relic 취약점 관리](/docs/vulnerability-management/overview)
(전체 플랫폼 사용자만 해당) + 		+ +$0.10/GB
(무료 한도 초과) + 		+ 스탠다드(Standard), 프로(Pro), 엔터프라이즈(Enterprise) + + 소프트웨어 수명 주기의 모든 단계에서 취약점을 식별하고 위험을 해결합니다. +
+ [FedRAMP 보통](/docs/security/security-privacy/compliance/fedramp-compliant-endpoints) 및 [HIPAA](/docs/security/security-privacy/compliance/hipaa-readiness-new-relic) 자격 + + + + 기업 + + FedRAMP 및 HIPAA 요구 사항을 충족하는 데 도움이 되는 구성을 통해 보안 규정 준수를 달성하십시오. +
+ [스트리밍 데이터 내보내기](/docs/apis/nerdgraph/examples/nerdgraph-streaming-export) + + + + 스탠다드(Standard), 프로(Pro), 엔터프라이즈(Enterprise) + + 원격 분석 데이터를 선택한 AWS 또는 Azure 스토리지로 동시에 내보내는 규칙을 구성합니다. 클라우드 공급자에 대한 추가 수출 수수료가 적용됩니다. +
+ [과거 데이터 내보내기](/docs/apis/nerdgraph/examples/nerdgraph-historical-data-export) + + + + 스탠다드(Standard), 프로(Pro), 엔터프라이즈(Enterprise) + + 기록 분석 및 모델링, 장기 저장 및 다른 데이터 분석 플랫폼과의 통합을 위한 제한 시간 없이 더 큰 쿼리를 실행합니다. +
+ Azure Native New Relic Service + + + + 스탠다드, 프로, 엔터프라이즈
([몇 가지 제한 사항이 있음](#azure-native-data-plus)) + 		+
+ +Data Plus와 기존 데이터 옵션을 나란히 비교하려면 [Data Plus 데이터 시트를](https://newrelic.com/resources/datasheets/data-plus) 확인하세요. + +데이터 플러스에 관심이 있으십니까? [데이터 플러스로 업그레이드를](#upgrade-data-plus)참조하십시오. + +### Azure Native New Relic Service 세부 정보 [#azure-native-data-plus] + +[Azure Native New Relic Service를](/docs/infrastructure/microsoft-azure-integrations/get-started/azure-native) 사용하면 Azure에서 직접 앱 및 인프라에 대한 원격 분석 데이터를 수집하고 저장할 수 있습니다. 이 기능은 Data Plus에 포함되어 있지만 다음과 같은 제한 사항이 있습니다. + +* 미국 데이터 센터 지역에서만 사용 가능 +* FedRAMP 보통/HIPAA 자격 없음 +* 이전 데이터 내보내기를 사용할 수 없음 + +## 데이터 플러스로 업그레이드 [#upgrade-data-plus] + +데이터 플러스(Data Plus)로 업그레이드하려면 데이터 관리 허브의 [**Data retention** UI](/docs/data-apis/manage-data/manage-data-retention/#adjust-retention) 로 이동하여 **Upgrade retention** 클릭하세요. + +* 참고: **Edit data retention** 버튼이 보일 수 있지만 이것은 **Upgrade retention** 버튼과 다릅니다. +* **Upgrade retention** 버튼을 보려면 [결제 권한이](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts/#admin-settings) 있어야 합니다. 요구 사항을 충족했지만 여전히 **Upgrade retention** 옵션이 표시되지 않으면 뉴렐릭 계정 담당자에게 문의하세요. + +## 청구 가능한 GB 수집량으로 간주되는 것은 무엇입니까? [#usage-calculation] + +[New Relic 요금제](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing)의 맥락에서 "수집된 데이터"는 다양한 데이터 트리밍 및 데이터 변환 규칙을 적용한 후 조직에서 New Relic에 저장한 데이터를 의미합니다. 즉, New Relic으로 보내는 raw data의 양이 아니라 실제로 저장되는 데이터의 크기입니다. + +일반적으로, 당사의 기능을 제공하기 위해 생성되는 데이터는 수집된 GB에 포함되지 않습니다. GB Ingested에 포함되지 않는 기능 및 기능 관련 데이터의 예는 다음과 같습니다. + +* [기본 알림 기능](/docs/alerts-applied-intelligence/new-relic-alerts/learn-alerts/alerts-concepts-workflow). 예를 들어, 이러한 기능을 생성하는 데 사용되는 이벤트인 `NrAiIncident` 은 수집된 GB에 포함되지 않습니다. +* 집계된 원시 데이터(예: [집계된 인프라 데이터](/docs/data-apis/manage-data/manage-data-retention/#infrastructure-data) 또는 [차원 메트릭 데이터](/data-apis/manage-data/manage-data-retention/#dimensional-metrics))로 생성된 데이터입니다. +* [골든 메트릭](/docs/apis/nerdgraph/examples/golden-metrics-entities-nerdgraph-api-tutorial) (골든 메트릭에 대한 자세한 내용은 [엔터티 정의](https://github.com/newrelic/entity-definitions)참조). +* 합성 모니터 확인. 합성 청구에 대한 자세한 내용은 [합성 한도 및 가격 책정을](/docs/synthetics/synthetic-monitoring/using-monitors/monitor-limits)참조하십시오. +* 사용량 및 청구 추적 데이터(예: `NrConsumption`). +* 계정 관리와 관련된 데이터(예: `NrIntegrationError`, `NrAuditEvent`). + +사용량을 이해하려면 [사용량 UI를](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing#usage-ui)참조하세요. + +## 기타 계산 세부 정보 [#calculation-details] + +* 가격 책정 모델의 맥락에서 GB는 10억 바이트로 정의됩니다. +* 월별 수집된 GB 수는 가장 가까운 정수로 반올림됩니다. 예를 들어, 조직에서 한 달에 100.9GB를 사용했다면 100GB로 계산됩니다. + +## 무료 버전 [#free-tier-limits] + +무료 버전의 GB Ingested에 대한 자세한 내용은 [무료 버전을](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#free) 참조하세요. + +## 더 알아보기 [#related-docs] + +* 수집된 GB를 관리하는 방법에 대한 자세한 내용은 [데이터 수집 관리를](/docs/data-apis/manage-data/manage-data-coming-new-relic) 참조하세요. +* 사용량을 쿼리하는 방법은 [쿼리 및 사용량 알림을](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/usage-queries-alerts) 참조하세요. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/alerts/get-notified/notification-integrations.mdx b/src/i18n/content/kr/docs/alerts/get-notified/notification-integrations.mdx index 32fe6daa455..ea8106446c1 100644 --- a/src/i18n/content/kr/docs/alerts/get-notified/notification-integrations.mdx +++ b/src/i18n/content/kr/docs/alerts/get-notified/notification-integrations.mdx @@ -179,13 +179,13 @@ translationType: machine * 이메일 주소가 이미 기존 목적지와 연결되어 있는 경우 병합할 수 있습니다. 목적지를 결합하려면 **Merge** 선택하세요. * 새로운 이메일 주소를 추가한 경우 수신자는 확인 이메일을 받게 됩니다. 수신자는 공지 수신을 시작하기 위해 확인 절차를 완료해야 합니다. - - 이메일 수신지 제한: + + 이메일 수신지 제한: - * **무료 계정**: 각 목적지에는 최대 5개의 이메일 주소를 가질 수 있습니다. - * **유료 계정**: 각 목적지에는 최대 150개의 이메일 주소를 가질 수 있습니다. - * **조직 제한**: 24시간마다 조직당 1000개의 고유 이메일 주소를 추가할 수 있습니다(모든 사용자에게 적용). - + * **무료 계정**: 각 목적지에는 최대 5개의 이메일 주소를 가질 수 있습니다. + * **유료 계정**: 각 목적지에는 최대 150개의 이메일 주소를 가질 수 있습니다. + * **조직 제한**: 24시간마다 조직당 1000개의 고유 이메일 주소를 추가할 수 있습니다(모든 사용자에게 적용). + 10. 전자 메일 메시지를 사용자 지정합니다. diff --git a/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx b/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx index 8ddcce1082f..57426d2bdc8 100644 --- a/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx +++ b/src/i18n/content/kr/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx @@ -268,21 +268,21 @@ Node.js 에이전트는 [npm(Node Package Manager) 저장소](https://npmjs.org/ | 패키지 이름 | 지원되는 최소 버전 | 최신 게시 버전 | \*에서 소개됨 | | --------------------------------- | ---------- | -------- | -------------------------------------- | | `@apollo/gateway` | 2.3.0 | 2.11.3 | `@newrelic/apollo-server-plugin@1.0.0` | -| `@apollo/server` | 4.0.0 | 5.0.0 | `@newrelic/apollo-server-plugin@2.1.0` | -| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.914.0 | 11.13.0 | -| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/client-sns` | 3.0.0 | 3.915.0 | 8.7.1 | -| `@aws-sdk/client-sqs` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.914.0 | 8.7.1 | +| `@apollo/server` | 4.0.0 | 5.1.0 | `@newrelic/apollo-server-plugin@2.1.0` | +| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.918.0 | 11.13.0 | +| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sns` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sqs` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.918.0 | 8.7.1 | | `@aws-sdk/smithy-client` | 3.47.0 | 3.374.0 | 8.7.1 | | `@azure/functions` | 4.7.0 | 4.8.0 | 12.18.0 | | `@elastic/elasticsearch` | 7.16.0 | 9.2.0 | 11.9.0 | -| `@google/genai` | 1.1.0 | 1.26.0 | 12.21.0 | +| `@google/genai` | 1.1.0 | 1.27.0 | 12.21.0 | | `@grpc/grpc-js` | 1.4.0 | 1.14.0 | 8.17.0 | | `@hapi/hapi` | 20.1.2 | 21.4.3 | 9.0.0 | | `@koa/router` | 12.0.1 | 14.0.0 | 3.2.0 | -| `@langchain/core` | 0.1.17 | 1.0.1 | 11.13.0 | -| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.1 | 13.2.0 | +| `@langchain/core` | 0.1.17 | 1.0.2 | 11.13.0 | +| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.2 | 13.2.0 | | `@nestjs/cli` | 9.0.0 | 11.0.10 | 10.1.0 | | `@opensearch-project/opensearch` | 2.1.0 | 3.5.1 | 12.10.0 | | `@prisma/client` | 5.0.0 | 6.18.0 | 11.0.0 | @@ -298,7 +298,7 @@ Node.js 에이전트는 [npm(Node Package Manager) 저장소](https://npmjs.org/ | `generic-pool` | 3.0.0 | 3.9.0 | 0.9.0 | | `ioredis` | 4.0.0 | 5.8.2 | 1.26.2 | | `kafkajs` | 2.0.0 | 2.2.4 | 11.19.0 | -| `koa` | 2.0.0 | 3.0.3 | 3.2.0 | +| `koa` | 2.0.0 | 3.1.1 | 3.2.0 | | `koa-route` | 3.0.0 | 4.0.1 | 3.2.0 | | `koa-router` | 12.0.1 | 14.0.0 | 3.2.0 | | `memcached` | 2.2.0 | 2.2.2 | 1.26.2 | @@ -306,7 +306,7 @@ Node.js 에이전트는 [npm(Node Package Manager) 저장소](https://npmjs.org/ | `mysql` | 2.16.0 | 2.18.1 | 1.32.0 | | `mysql2` | 2.0.0 | 3.15.3 | 1.32.0 | | `next` | 13.4.19 | 16.0.0 | 12.0.0 | -| `openai` | 4.0.0 | 6.6.0 | 11.13.0 | +| `openai` | 4.0.0 | 6.7.0 | 11.13.0 | | `pg` | 8.2.0 | 8.16.3 | 9.0.0 | | `pg-native` | 3.0.0 | 3.5.2 | 9.0.0 | | `pino` | 8.0.0 | 10.1.0 | 8.11.0 | diff --git a/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx b/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx index de04b22d9fa..3deaa08f2cb 100644 --- a/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx +++ b/src/i18n/content/kr/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx @@ -998,6 +998,68 @@ New Relic은 [다양한 데이터베이스 및 데이터베이스 드라이버 +## 로깅 라이브러리 + +에이전트는 [컨텍스트에서 APM 로그에](/docs/logs/logs-context/get-started-logs-context/) 대한 다음 라이브러리의 로그를 전달할 수 있습니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **도서관** + + **보석 이름** + + **지원** + + **Notes** +
+ **나무꾼** + + `logger` + + + + 루비의 로거 라이브러리와 ActiveSupport::BroadcastLogger와 같은 루비 로거에서 상속된 모든 로깅 라이브러리를 사용하는 APM 로그 포워딩을 지원합니다. +
+ **로그스태셔** + + `logstasher` + + 1.xx 이상 + + APM 로그 포워딩을 지원합니다. +
+ ## 기타 라이브러리 및 기술 [#other\_libraries][#other_libraries] @@ -1134,40 +1196,6 @@ New Relic은 [다양한 데이터베이스 및 데이터베이스 드라이버 - - - - - - - - - - - - - - - - - - @@ -82,4 +82,4 @@ translationType: machine
- **나무꾼** - - `logger` - - - - 루비의 로거 라이브러리를 사용하여 APM 로그 포워딩을 지원합니다. -
- **로그스태셔** - - `logstasher` - - 1.xx 이상 - - APM 로그 포워딩을 지원합니다. -
**줄무늬** diff --git a/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx b/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx index 8496ee6b4b8..0b98d1e1a98 100644 --- a/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx +++ b/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/introdution.mdx @@ -20,6 +20,8 @@ Transaction 360의 주요 기능은 다음과 같습니다. * **자동 검색**: 동적 서비스 관계 매핑 및 실시간 거래 흐름 시각화. * **종합적인 가시성**: 풀스택 모니터링, 서비스 간 거래 추적, 인프라부터 브라우저까지 가시성을 제공합니다. +* **데이터베이스 모니터링**: 프로세서 전반에 걸쳐 데이터베이스 성능, 쿼리 분석 및 연결 상태에 대한 심층적인 인사이트입니다. +* **서버리스 기능 추적**: 서버리스 기능, 콜드 스타트 및 리소스 활용도에 대한 완전한 가시성을 제공합니다. * **과거 분석**: 몇 주 분량의 이력 데이터에 접근하여 추세 분석 및 패턴 인식을 지원합니다. @@ -33,5 +35,7 @@ Transaction 360의 주요 기능은 다음과 같습니다. ## 무엇 향후 계획 - 애플리케이션 성능 문제에 Transaction 360을 사용하는 방법을 알아보세요 + + 데이터베이스 및 서버리스 모델링을 포함하여 견고한 성능 문제에 대해 프로세서 360을 사용하는 방법을 알아봅니다. + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx b/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx index 023b6fc3207..e325cf511c2 100644 --- a/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx +++ b/src/i18n/content/kr/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx @@ -3,88 +3,173 @@ title: 'Fast-track 문제 해결, Transaction 360을 통한 해결' tags: - transaction workloads - dynamic workload monitoring -metaDescription: Learn about the detailed page breakdown in New Relic's Transaction 360 feature. +metaDescription: Learn how Transaction 360 provides comprehensive workload visibility for faster troubleshooting and performance optimization. freshnessValidatedDate: never translationType: machine --- -애플리케이션 성능 문제가 발생하면 근본 원인을 식별하고 해결하기 위한 체계적인 접근 방식을 갖는 것이 중요합니다. 이 가이드에서는 Transaction 360을 사용하여 애플리케이션 성능 문제를 확인하는 방법을 안내합니다. +프로세서 360은 특정 프로세서와 관련된 모든 미팅 및 데이터를 자동으로 캡처하고 연관시켜 분산된 워크로드에 대한 포괄적인 보기를 제공합니다. 이러한 전체적인 접근 방식에는 전체 트레일러의 작업 흐름, 서비스 관계, 성과 지표가 포함되어 있어 문제를 신속하게 식별하고 해결할 수 있습니다. -Transaction 360은 특정 문제나 질문에 관련된 모든 정보와 데이터를 자동으로 수집하고 상관관계를 분석하므로 정보에 대한 포괄적인 관점을 제공합니다. 이 보기에는 거래 흐름, 서비스 관계, 성과 지표가 포함되어 있어 문제를 빠르게 식별하고 해결할 수 있습니다. +## 프로세서 360이 보여주는 것 -## Transaction 360 보기로 이동 +프로세서 360은 워크로드를 이해하는 데 도움이 되는 세 가지 주요 보기를 제공합니다. -트랜잭션 워크로드 보기에 액세스하려면 다음 단계를 따르세요. +* **개요 대시보드**: 분리 개수, 문제 및 변경 추적이 포함된 상위 수준 요약 +* **동적 흐름 맵**: 소니 경로 및 서비스 의존성/종속성을 시각적으로 표현 +* **부분 분석**: 참여하는 모든 구성 요소에 대한 자세한 성능 지표 -1. **[one.newrelic.com](https://one.newrelic.com)> APM and Services** 로 이동하세요. -2. APM 요약 페이지에서 **Transactions > Transaction Details > View transaction 360 workload**를 클릭합니다. +## 트랜잭션 360에 액세스하세요 -Transaction 360 보기는 다음 구성 요소를 포함하여 거래에 대한 자세한 분석을 제공합니다. +1. **[one.newrelic.com](https://one.newrelic.com) > APM and Services**로 이동 +2. APM 요약 페이지에서 서비스를 선택하세요 +3. **Transactions > Transaction Details > View transaction 360 workload**로 이동하세요. -* **Transaction 360 개요**: 관련 건수, 알림, 변경 추적 등 트랜잭션 워크로드 요약을 표시합니다. + + 데이터베이스 및 서버리스 모니터링 섹션은 현재 스테이징 환경에서 사용할 수 있습니다. 이러한 기능에 액세스하려면 적절한 계정 권한과 적절한 측정 및 과학적 지식이 있는지 확인하세요. + -* **동적 흐름 맵**: 거래 흐름을 시각화하여 관련 서비스와 각 서비스에 소요된 시간을 보여줍니다. +## 동적 흐름 맵 -* **참여 부분**: 트랜잭션 워크로드에 관련된 서비스를 해당 기능 지표와 함께 나열합니다. + -## 트랜잭션 360 개요 +흐름도는 귀하의 프로세서 시스템을 통한 귀하의 여정을 시각화합니다. -transaction-360-overview.webp +* **서비스 연결**: 서비스 간의 통신 및 의존성/종속성을 확인하세요. +* **성능 병목 현상, 병목지점**: 프로세서 시간 전체에 영향을 미치는 느린 구성 요소 식별 +* **트레이스 관계**: 서비스 쌍을 클릭하여 자세한 추적 지표를 확인하세요. -Transaction 360 개요 섹션에서는 연관된 거래에 대한 다음과 같은 간략한 요약을 제공합니다. +### 협업 기능 -* **종속 부분:** 로그된 부분과 계측되지 않은 부분의 수 등 인사이트를 제공하는 트랜잭션에 관련된 부분의 총 수, 알림이 있는 부분의 수입니다. 또한, 포함된 부분을 클릭하여 자세한 성능 지표 및 관련 서비스를 볼 수 있습니다. 또한 계측되지 않은 부분을 클릭하여 분량이 아닌 부분 목록을 보고 측정이 필요한 부분, 로그를 식별할 수 있습니다. 마찬가지로, 알림이 있는 기사를 클릭하면 알림이 있는 기사 목록을 볼 수 있으며, 이를 통해 알림의 심각도에 따라 조사의 우선순위를 정할 수 있습니다. +* **팀 할당**: 더 빠른 인시던트 대응을 위해 팀을 프로세서로드에 할당합니다. +* **태그**: 조사 및 조직의 효율화를 위한 그룹 관련 부문 -* **문제:** 알림 및 변경 추적 마커를 포함하여 트랜잭션 워크로드에서 감지된 문제 수입니다. **세부 정보 보기를** 클릭하면 문제 목록을 보고 해당 문제의 직접적인 영향을 받는 기관을 파악할 수 있습니다. +## 부품별 성능 -* **변경 추적:** 워크로드의 성능 변화를 나타내는 트랜잭션 워크로드에서 감지된 변경 추적 마커의 수입니다. **세부 정보 보기를** 클릭하면 변경 추적 마커를 보고 성능 변화로 직접 영향을 받는 주제를 식별할 수 있습니다. +이 섹션에서는 귀하의 프로세서플레이로드에 있는 각 구성 요소 유형에 대한 자세한 지표를 제공합니다. -## 동적 흐름 맵 +### APM 서비스 -동적 흐름 맵은 거래 흐름을 시각화하여 관련 서비스와 각 서비스에 걸리는 시간을 보여줍니다. 지도는 트랜잭션 워크로드에 대한 높은 수준의 개요를 제공하여 병목현상, 병목지점 및 성능 문제를 식별할 수 있게 해줍니다. + -dynamic-map.webp +다음을 사용하여 애플리케이션 서비스를 모니터링하세요. -관련 서비스를 선택하면 해당 서비스 간의 추적 지표를 볼 수 있습니다. 또한, 협업과 문제 해결을 용이하게 하기 위해 거래 정보에 팀을 할당하거나, 태그를 사용하여 관련 정보를 그룹화하여 조사 프로세스를 간소화할 수도 있습니다. +**서비스 지표 테이블:** -동적 흐름 맵은 성능 문제로 직접 영향을 받는 서비스를 식별하는 데 도움이 되므로 근본 원인에 대한 조사를 집중할 수 있습니다. +* **처리량**: 각 서비스에 대한 분당 요청 수 +* **오류율**: 실패한 requests의 백분율 +* **응답시간**: 서비스당 평균 지연시간 +* **문제 심각도**: 중요, 경고 및 정보 알림을 통해 수정 사항의 우선순위를 지정합니다. -## 참여 및 지원 +**프로세서 분석:** -### APM 시스템 +* **성능 변화**: 응답 시간이 가장 긴 트랜잭션 변경 +* **트레이스 세부 정보**: 전체 트레이스 흐름을 보려면 프로세서를 클릭하세요. -참여 부분 섹션에서는 APM 서비스, 브라우저 응용 프로그램, 모바일 구성 서버리스 기능 또는 데스크톱과 같이 트랜잭션 워크로드와 관련된 서비스에 대한 자세한 분석을 제공합니다. +### 인프라 엔터티 -partcipating-services.webp + -* **성능 지표:** APM 서비스 테이블에는 처리량, 오류율, 지연 시간, 위험, 경고, 정보 등 심각도 수준의 문제를 포함하여 각 서비스에 대한 성능 지표가 표시되어 조사 우선순위를 정할 수 있습니다. +호스트, 컨테이너 및 쿠버네티스 클러스터에 대한 성능 성능 보기: -* **거래 표:** 거래 표를 사용하여 응답 시간에서 가장 큰 비율로 변화가 발생한 거래를 식별하고, 이를 통해 가장 큰 영향을 받은 거래에 집중하여 조사를 수행할 수 있습니다. 또한 특정 트랜잭션을 선택하여 트레이스 흐름 및 성능 지표를 볼 수 있습니다. +**자원 지표:** -### 인프라 엔터티 +* **CPU 사용량**: 인프라 전반의 프로세서 활용도 +* **메모리 소비**: RAM 사용량 및 잠재적 제약 +* **Disk I/O**: Storage 성능과 병목현상, 병목지점 +* **네트워크 활동**: 데이터 전송 속도 및 네트워크 문제 + +**호스트 분석:** + +* **리소스 순위**: 리소스 소모가 가장 높은 호스트 식별 +* **관련 서비스**: 각 호스트에서 실행되는 애플리케이션 확인 + +### 브라우저 애플리케이션 + + + +프런트엔드 성능과 사용자 경험을 모니터링합니다. + +**성능 지표:** + +* **페이지 로드 시간**: 프런트엔드 렌더링 및 로딩 성능 +* **JavaScript 오류**: 사용자 경험에 영향을 미치는 클라이언트 측 오류 +* **페이지 뷰**: Traffic 패턴 및 사용자 참여 + +**사용자 경험 도구:** + +* **세션 리플레이**: 사용자 세션을 시청하여 성능이 실제 사용자에게 미치는 영향을 이해하세요. +* 자세한 사용자 상호작용 데이터를 보려면 세션을 클릭하세요. +* 자세한 내용은 [세션 리플레이 문서를](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/)참조하세요. + +### 데이터베이스 모니터링 + +포괄적인 지표로 데이터베이스 성능 추적: + +**성능 시각화:** + +* **처리량 차트**: 시간 경과에 따른 분당 데이터베이스 작업 +* **쿼리 시간 차트**: 응답 시간 추세 및 성능 패턴 + +**쿼리 분석 테이블:** + +* **데이터베이스 작업**: 쿼리당 호출 횟수, 지속 시간 및 타이밍 메트릭 +* **성능 순위**: 최대, 평균 및 총 실행 시간 +* **쿼리 최적화**: 가장 느리고 가장 빈번한 쿼리 식별 + +**프로세서 충격표:** + +* **데이터베이스 의존성/종속성**: 데이터베이스 작업에 가장 많이 의존하는 트랜잭션을 표시합니다. +* **시간 할당**: 데이터베이스 호출에 소요된 트랜잭션 시간의 백분율 +* **Optimization 묶어, 목표**: 데이터베이스 오버헤드가 가장 높은 트랜잭션 + +**대화형 드릴다운:** + +* 특정 프로세서에서 사용하는 모든 쿼리를 보려면 쿼리 개수를 클릭하세요. +* 프로세서 이름을 클릭하면 해당 프로세서를 기준으로 쿼리를 필터링할 수 있습니다. +* 개별 쿼리 세부 정보를 통해 스택 추적에 액세스합니다. + +### 서버리스 기능이 있습니다 + +AWS Lambda 및 기타 서버리스 구성 요소를 모니터링합니다. + +**사용자 정의 가능한 성능 차트:** + +* **호출 패턴**: 시간 경과에 따른 함수 실행 빈도 +* **Duration 지표**: 실행 시간 및 성능 추세 +* **메모리 활용도**: 리소스 소비 패턴 +* **비용 추적**: 함수 호출에 대한 관련 비용 -통합된 부품 구성요소가 있는 경우 Transaction 360 보기에서 통합 구성 요소를 볼 수 있습니다. 부품 부품 섹션에서는 호스트, 컨테이너, 쿠버네티스 클러스터 등 트랜잭션 워크로드와 관련된 부품에 대한 자세한 분석을 제공합니다. +**함수 분석:** -infrastructure-entities.webp +* **프로세서 관계**: 서버리스 기능을 트리거하는 트랜잭션을 확인합니다. +* **성능 영향**: 기능 성능이 전반적인 프로세서 속도에 미치는 영향 +* **리소스 효율성**: 메모리 할당 대비 실제 사용량 -* **성능 지표: 성능** 지표: CPU 사용량, 메모리 사용량, 디스크 I/O, 네트워크 I/O 등 각 성능 요소에 대한 성능 지표를 표시하여 성능 병목 현상, 병목지점 및 리소스 제약 조건을 식별합니다. +### 모바일 애플리케이션 -* **호스트 테이블:** 호스트 테이블을 사용하여 사회과학 목록을 찾고 CPU 사용률, 메모리 사용률, 디스크 I/O, 네트워크 I/O 가 가장 높은 호스트를 식별하여 영향을 가장 많이 받는 호스트에 조사를 집중할 수 있습니다. 또한, 특정 호스트를 선택하여 해당 성능 지표와 관련 서비스를 볼 수 있습니다. +프로세서 흐름 내에서 모바일 앱 성능을 추적하세요. -### 브라우저 +* **앱 성능**: 응답 시간 및 사용자 경험 지표 +* **충돌률**: 모바일 전용 오류 추적 +* **장치 지표**: 다양한 모바일 장치에 걸친 성능 -브라우저에 기능을 추가한 경우 Transaction 360 보기에서 브라우저에 대한 성능 요소를 볼 수 있습니다. 브라우저 부분 섹션에서는 거래 워크로드와 관련된 브라우저 부분에 대한 자세한 분석을 제공합니다. +### AI/LLM 모니터링 -browser-entities.webp +모니터 언어 모델(LLM) 성능 및 비용: -* **변형 지표:** 브라우저 부분 테이블은 성능 병목 현상, 병목지점 및 사용자 경험 문제를 식별하기 위해, 페이지 보기, JavaScript 오류 등 각 부분에 대한 성능 지표를 표시합니다. +* **모델 성능**: AI 서비스의 응답 시간 및 정확도 지표 +* **비용 추적**: 토큰 사용 및 관련 비용 +* **오류율**: 실패한 AI requests 및 시간 초과 문제 -* **세션 리플레이:** 세션 리플레이 기능을 사용하여 사용자 세션을 재생하고 성능 문제를 유발하는 사용자 인스턴스 복사를 식별할 수도 있습니다. 또한, 특정 세션을 선택하여 해당 세션의 성능 지표와 관련 서비스를 볼 수 있습니다. 자세한 내용은 [세션 리플레이를](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/) 참조하세요. +자세한 AI 모니터링 설정은 [AI 모니터링 설명서를](/docs/ai-monitoring/intro-to-ai-monitoring/) 참조하세요. -### 모바일 엔티티 +## 다음 단계 -모바일 기능이 포함된 경우 Transaction 360 보기에서 모바일에 대한 성능 요소를 볼 수 있습니다. 모바일 부문 섹션에서는 거래 워크로드와 관련된 모바일 업무에 대한 자세한 분석을 제공합니다. +프로세서 360에서 문제를 확인한 후: -### AI 모니터링 +1. **수정 우선순위 지정**: 중요한 알림 및 가장 큰 영향을 미치는 성능 문제부터 시작 +2. **편집하다 gaps**: 완전한 가시성을 위해 계측되지 않은 부분에 모니터링 추가 +3. **사전 예방적 모니터링 설정**: 주요 프로세서 성능 저하에 대한 알림 생성 +4. **협업**: 팀 할당 및 태그를 사용하여 해결 노력을 조정합니다. -귀하의 기능이 LLM(기능 언어 모델)(LLM)을 호출하고 APM 에이전트를 사용하여 축소된 경우 Transaction 360 보기에서 AI에 대한 성능 지표를 볼 수 있습니다. AI 분리 섹션에서는 트랜잭션 워크로드에 관련된 AI 모델에 대한 자세한 분석을 제공합니다. 자세한 내용은 [AI 모니터링을](/docs/ai-monitoring/intro-to-ai-monitoring/) 참조하세요. \ No newline at end of file +Lync 360은 분산된 시스템 전체에서 문제를 신속하게 이해하고 진단하고 해결하는 데 필요한 포괄적인 뷰를 제공합니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx b/src/i18n/content/kr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx new file mode 100644 index 00000000000..15670e1b1e8 --- /dev/null +++ b/src/i18n/content/kr/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx @@ -0,0 +1,162 @@ +--- +title: 고급 세션 리플레이 기능 +metaDescription: Manage session replay & modify capabilities depending on the role +freshnessValidatedDate: '2024-12-19T00:00:00.000Z' +redirect: + - /docs/browser/browser-monitoring/browser-pro-features/session-replay/sequence-filtering +translationType: machine +--- + +이 문서에서는 세션 리플레이를 사용하여 심층 분석을 수행하고 사용자 행동을 효율적으로 조사하고 이해하는 방법에 대한 정보를 제공합니다. 이제 뉴렐릭 AI를 활용하여 세션 리플레이 이벤트 추적을 자동으로 요약하고, 시퀀스 필터링을 사용하여 특정 사용자 캡슐화 패턴으로 재생을 찾아내고, 녹음 내용을 다듬어 세션의 가장 관련성이 높은 부분에 집중하고 담당 팀이나 담당자와 공유할 수 있습니다. + +## 뉴렐릭 AI 요약 [#new-relic-ai] + +뉴렐릭 AI(NRAI)를 사용하면 세션 리플레이 이벤트 추적 데이터를 요약하고 매핑하여 사용자의 브라우저 여정의 오류와 성공을 더 잘 이해할 수 있습니다. + +NRAI를 사용하여 세션 리플레이 이벤트 추적 데이터를 요약하려면 계정에 [NRAI가 활성화되어](/docs/agentic-ai/new-relic-ai/#enable) 있어야 합니다. 계정에서 NRAI가 활성화되면 다음을 수행하여 요약을 표시합니다. + +1. **[one.newrelic.com > All Capabilities](https://one.newrelic.com/all-capabilities) > Browser** 으)로 이동합니다. + +2. 브라우저 앱을 선택하세요. + +3. 왼쪽 메뉴에서 아래로 스크롤하여 **Session replay** 클릭합니다. + +4. 요약하고 싶은 세션의 세부 정보를 보려면 리플레이를 클릭하세요. + + screenshot of the session replay page in browser + +5. **Summarize** 클릭하세요. 세션 요약은 포커스 패널에 생성됩니다. + + screenshot of the session replay page in browser + +## 시퀀스 필터링 [#sequence-filtering] + +**Sequence Filtering** 기능을 사용하면 사용자 블록결합 중에 기록된 특정 이벤트 시퀀스를 기반으로 세션 리플레이를 필터링할 수 있습니다. 이 기능은 **Session Listing** \[세션 목록] 페이지에서 수많은 세션 녹화본을 효율적으로 탐색하고 관련 리플레이를 원활하게 검색할 수 있도록 설계되었습니다. + +### 주요 기능 + +* **이벤트 시퀀스 필터링**: 특정 순서로 이벤트 시퀀스를 지정하여 리플레이를 필터링할 수 있습니다. 예를 들어, 사용자가 검색을 수행한 다음 장바구니에 항목을 추가하는 경우가 있습니다. +* **사용자 정의 필터**: 속성, 연산자 및 값을 선택하여 시퀀스 필터를 정의할 수 있습니다. +* **다중 작업 지원**: 최대 5개의 작업을 순서대로 지정할 수 있습니다. +* **유연한 필터링**: 필터는 어떤 순서로든 적용할 수 있으므로 시퀀스 필터를 기간 등의 다른 필터 유형과 결합할 수 있습니다. + +### 보기를 개인화하세요 + +기본적으로 **Sequence** \[시퀀스는] **All** \[모두] 로 설정됩니다. **Sequence = All** \[시퀀스 = 전체] 필터를 선택하고 **Set up a filtering sequence** \[필터링 시퀀스 설정] 대화 상자를 클릭하여 시퀀스 필터를 정의하여 보기를 개인화할 수 있습니다. + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay** 으)로 이동합니다. +2. **Sequence = All** \[시퀀스 = 모든] 필터를 선택하면 **Set up a filtering sequence** \[필터링 시퀀스 설정] 옵션이 나타납니다. +3. **Set up a filtering sequence** \[필터링 시퀀스 설정] 옵션을 사용하면 특정 순서로 최대 5개의 작업을 지정하여 시퀀스 필터를 만들 수 있습니다. 다음 속성을 선택하여 시퀀스를 정의할 수 있습니다. + + + 필터 양식에 최소 2단계를 추가해야 합니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 동작 + + 설명 +
+ 기인하다 + + 속성을 선택하세요: + + * **조회된 URL**: 사용자가 조회한 페이지의 URL에 따라 데이터를 필터링합니다. + + * **페이지 작업**: 페이지와 사용자의 상호작용을 기반으로 데이터를 필터링합니다. + + * **키보드 입력**: 사용자의 키보드 입력을 기준으로 데이터를 필터링합니다. 아래 옵션을 선택하여 검색 범위를 더욱 넓힐 수 있습니다. + + * **개구리, 목표**: 키보드 입력이 이루어진 터키요소를 선택합니다. + * **타겟 ID**: 키보드 입력이 이루어진 타겟 ID를 선택합니다. + * **타겟 클래스**: 키보드 입력이 이루어진 타겟 클래스를 선택합니다. + + * **사용자 클릭수**: 사용자의 클릭수를 기준으로 데이터를 필터링합니다. +
+ 연산자 + + 아래 옵션에서 운영자를 선택하세요: + + * **=**: 제공된 값이 인시던트 속성 값과 동일한 경우. + * **Like**: 제공된 값이 인시던트 속성 값과 유사한 경우입니다. +
+ 값 + + 검색하거나 값을 입력하세요. +
+ +4. **Apply** \[적용을] 클릭하세요. + + Screenshot of session replay details + +## Trimmed 세션 리플레이 [#trimmed-session-replay] + +**Trimmed session replay** \[Trimmed 세션 리플레이] 기능을 사용하면 관련 이벤트 기록, 목표 분석 및 빠른 문제 해결에 중점을 두고 세션 기록의 특정 세그먼트를 추출하고 공유할 수 있습니다. 긴 녹화본 전체를 공유하는 대신, 문제가 발생한 정확한 순간을 강조하는 집중적인 클립을 만들 수 있습니다. + +### 트리밍된 세션 리플레이 만들기 + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay** 으)로 이동합니다. + +2. 다듬고 싶은 세션 리플레이를 선택하세요. + +3. 세션 리플레이 컨트롤에서 **Share a clip** \[클립 공유를] 클릭하세요. + +4. 타임라인 컨트롤을 사용하여 클립 경계를 선택하세요. + + * 왼쪽 화살표를 끌어 클립의 시작 시간을 설정하세요. + * 오른쪽 화살표를 끌어 클립의 종료 시간을 설정하세요. + +5. 클립 세부 정보 양식을 작성하세요. + + * **Availability** \[사용 가능 여부] 드롭다운 메뉴를 사용하여 클립 링크가 활성 상태로 유지되는 기간을 선택하세요. + * 메시지 추가(선택 사항) - 클립이 보여주는 내용에 대한 맥락을 제공합니다. + * 이메일 주소를 추가하면 클립을 특정 팀원과 직접 공유할 수 있습니다. + +6. 선택 사항을 검토하세요. 강조된 섹션은 클립에 포함될 내용을 보여줍니다. + +7. **Share this clip** \[이 클립 공유]를 클릭하면 잘린 세그먼트가 생성됩니다. + +### 공유 클립에 액세스하기 + +팀원으로부터 잘린 세션 리플레이를 받으면: + +1. **이메일을 통해 알림**: 수신자로 추가된 경우 클립 링크와 발신자가 제공한 메시지가 포함된 이메일을 받게 됩니다. +2. **공유 URL을 통해**: 토론 패널에서 공유된 링크를 클릭하여 브라우저에서 잘린 세션 리플레이를 엽니다. + + + Safari에서는 공유 URL을 자동으로 복사할 수 없습니다. 생성된 링크를 수동으로 복사하여 수신자와 공유해야 합니다. + + +3. **클립 보기**: 클립이 자동으로 재생되고, 보낸 사람의 컨텍스트 메시지와 함께 선택한 부분만 표시됩니다. + +4. **클립의 사용 가능 여부**: 클립의 만료일은 보낸 사람이 설정합니다. 이전에 공유한 클립에 액세스할 수 없는 경우 **Availability** \[가용성] 창을 확인하세요. + + screenshot of the session replay page in browser \ No newline at end of file diff --git a/src/i18n/content/kr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx b/src/i18n/content/kr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx index 761154692a6..e51ee10b337 100644 --- a/src/i18n/content/kr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx +++ b/src/i18n/content/kr/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx @@ -60,7 +60,7 @@ CloudFormation 템플릿에는 모든 AWS 통합에 대한 모든 권한이 포 Statement: - Effect: Allow Principal: - AWS: !Sub 'arn:aws:iam::754728514883:root' + AWS: !Sub 'arn:aws:iam::253490767857:root' Action: 'sts:AssumeRole' Condition: StringEquals: diff --git a/src/i18n/content/kr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx b/src/i18n/content/kr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx index 03cfe691327..63e3306278d 100644 --- a/src/i18n/content/kr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx +++ b/src/i18n/content/kr/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx @@ -21,10 +21,10 @@ translationType: machine 1. 인프라 에이전트가 [설치되어 제대로 실행되고 있는지](/docs/infrastructure/new-relic-infrastructure/troubleshooting/no-data-appears-infrastructure) 확인하십시오. 인프라 에이전트 **first** 설치한 다음 AWS 계정에 연결해야 합니다. - 속성 이름은 표시되지만 **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events** 또는 **Infrastructure > Settings > Agents** 에 데이터가 없으면 인프라 에이전트를 설치하지 않았을 수 있습니다. + 속성 이름은 표시되지만 **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events** 또는 **Infrastructure > Settings > Agents** 에 데이터가 없으면 인프라 에이전트를 설치하지 않았을 수 있습니다. -2. 계정 상태 대시보드에 표시되는 오류를 수정하세요. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS** 으로 이동하여 각 계정에 대해 **Account status dashboard** 을 선택하세요. +2. 계정 상태 대시보드에 표시되는 오류를 수정하세요. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS** 으로 이동하여 각 계정에 대해 **Account status dashboard** 을 선택하세요. **Role errors** 또는 **Permission errors** 보고가 표시되면 [통합 및 관리형 정책을](/docs/integrations/amazon-integrations/getting-started/integrations-managed-policies) 참조하고 뉴렐릭에게 계정에서 관련 데이터를 읽는 데 필요한 권한을 부여했는지 확인하세요. @@ -52,7 +52,7 @@ translationType: machine 		- `754728514883` + `253490767857`
-3. 데이터의 [올바른 위치를 찾고](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric) 있는지 확인하십시오. [메트릭 및 이벤트](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer) 에서 모든 통합 데이터를 찾을 수 있습니다. +3. 데이터의 [올바른 위치를 찾고](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric) 있는지 확인하십시오. [메트릭 및 이벤트](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer) 에서 모든 통합 데이터를 찾을 수 있습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx b/src/i18n/content/kr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx index 48e0e9bb34c..9fb071dfd76 100644 --- a/src/i18n/content/kr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx +++ b/src/i18n/content/kr/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx @@ -13,14 +13,10 @@ translationType: machine 로그 데이터는 개별 레코드당 값이 낮은 대용량 원격 분석입니다. 검색하면 근본 원인 설명을 제공하는 로그가 빠르게 생성될 수 있지만 대부분의 데이터는 반복적이고 검색할 때 상황을 파악하기 어렵습니다. 패턴을 사용하면 값이 낮은 데이터를 읽는 데 많은 시간을 소비하지 않고도 로그 데이터를 검색할 수 있습니다. -Screenshot of Log patterns UI +Screenshot of Log patterns UI
- **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: 로그 패턴을 사용하면 검색에 추가 시간을 소비하지 않고도 로그 메시지에서 의심스러운 급증 또는 감소를 발견할 수 있습니다. + **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: 로그 패턴을 사용하면 검색에 추가 시간을 소비하지 않고도 로그 메시지에서 의심스러운 급증 또는 감소를 발견할 수 있습니다.
## 기술 개요 [#overview] @@ -67,11 +63,11 @@ translationType: machine - HITRUST 계정 + HIPAA 계정 - 로그 패턴 기능은 FedRAMP와 호환되지 않습니다. FedRAMP 또는 기타 HITRUST 계정은 패턴을 사용할 수 없습니다. + 로그 패턴 기능은 FedRAMP와 호환되지 않습니다. FedRAMP 또는 기타 HIPAA 계정은 패턴을 사용할 수 없습니다. @@ -81,7 +77,7 @@ translationType: machine - 로그를 패턴에 일치시킬 때 메모리 및 CPU 리소스에 대한 안전 제한 시스템이 있습니다. 이러한 일치 제한은 로그 패턴으로 그룹화할 수 있는 로그의 백분율에 영향을 줄 수 있습니다. 그러나 로그 패턴 일치는 "최선의 노력" 프로세스입니다. 모든 로그에 패턴별로 그룹화할 기회가 없는 경우 오류가 아닙니다. 리소스 제한 내에서 수행할 수 있는 그룹화에서 여전히 가치를 얻을 수 있습니다. + 로그를 패턴에 일치시킬 때 메모리 및 CPU 리소스에 대한 안전 제한 시스템이 있습니다. 이러한 일치 제한은 로그 패턴으로 그룹화할 수 있는 로그의 백분율에 영향을 줄 수 있습니다. 그러나 로그 패턴 일치는 "최선의 노력" 프로세스입니다. 모든 로그에 패턴별로 그룹화할 기회가 없는 경우 오류가 아닙니다. 리소스 제한 내에서 수행할 수 있는 그룹화에서 여전히 가치를 얻을 수 있습니다. @@ -91,19 +87,8 @@ translationType: machine 패턴 검사를 시작하려면: -1. - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs** - - - 으로 이동하여 계정 선택기 드롭다운 메뉴를 사용하여 패턴을 탐색하려는 목표 계정을 선택하세요. - -2. 로그 UI의 왼쪽 탐색에서 - - - **Patterns** - - - 클릭합니다. +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs** 으로 이동하여 계정 선택기 드롭다운 메뉴를 사용하여 패턴을 탐색하려는 목표 계정을 선택하세요. +2. 로그 UI의 왼쪽 탐색에서 **Patterns** 클릭합니다. 기본 로그 UI가 쿼리 표시줄에 쿼리와 일치하는 패턴을 표시하도록 변경됩니다. 특정 기간의 로그를 보려면 차트에서 해당 지점을 클릭(또는 영역을 클릭하고 드래그)하거나 시간 선택기를 사용하세요. @@ -221,11 +206,5 @@ translationType: machine 패턴은 기존 로그 메시지에 `newrelic.logPattern` 이라는 새 속성으로 보강되는 값입니다. 로그로 할 수 있는 모든 작업은 일반적으로 다음과 같은 로그 패턴으로 수행할 수 있습니다. * 특정 패턴 또는 관심 있는 패턴 그룹을 모니터링하기 위해 패턴을 사용하여 고유한 [대시보드](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards) 를 구축합니다. - -* [NRQL 알림을](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions) 추가하여 패턴에 대한 - - - - 을 생성합니다. - -* [이상 알림 조건](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions) 을 사용하여 알려진 로그 패턴의 이상을 감지합니다. +* [NRQL 알림을](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions) 추가하여 패턴에 대한 을 생성합니다. +* [이상 알림 조건](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions) 을 사용하여 알려진 로그 패턴의 이상을 감지합니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx b/src/i18n/content/kr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx index 5fff0ee0da6..359bc1c03dc 100644 --- a/src/i18n/content/kr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx +++ b/src/i18n/content/kr/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx @@ -204,7 +204,13 @@ Go 런타임 페이지는 Go 서비스 런타임과 관련된 문제를 식별 Go 런타임 페이지에는 Go 런타임 지표와 함께 황금 아이콘이 표시되어 런타임 문제와 서비스 사용량의 상관관계를 보여줍니다. -쿼리는 데이터가 [OpenTelemetry Go 런타임 측정, 리소스 저장소](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/) 에 의해 생성된다고 가정합니다. 참고로, 현재 Go 런타임 메트릭에 대한 의미 규칙은 없습니다. +쿼리는 데이터가 [OpenTelemetry Go 런타임 측정, 리소스 저장소](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/) 에 의해 생성된다고 가정합니다. + + + Go 런타임 메트릭에 대한 [의미 규칙은](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/runtime/go-metrics.md) 아직 개발 중입니다. Go 런타임 페이지는 이전 버전의 규칙을 목표로 합니다. `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS` 환경 변수를 활성화하여 이전 규칙을 활성화해야 합니다. 자세한 내용은 측정 및 계측에 대한 [설명서를](https://github.com/open-telemetry/opentelemetry-go-contrib/blob/9a6e0bf68e1da495be52faf152b5b4e6fb09d475/instrumentation/runtime/internal/x/README.md) 참조하세요. + + 뉴렐릭은 새로운 규칙이 안정되면 결국 이를 지지할 것입니다. + ### 로그 [#logs-page] diff --git a/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx new file mode 100644 index 00000000000..8b88406b1d0 --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx @@ -0,0 +1,71 @@ +--- +subject: Docs +releaseDate: '2025-10-25' +version: 'October 19 - October 24, 2025' +translationType: machine +--- + +### 새로운 문서 + +* 클라우드 비용 인텔리전스 [Azure](/docs/cci/azure-cci) 및 [Google Cloud Platform (GCP)을](/docs/cci/gcp-cci) 추가하여 비용 계획 및 최적화를 위해 뉴렐릭과 Azure 및 GCP 청구 통합을 연결하기 위한 포괄적인 지침을 제공합니다. + +### 주요 변경 사항 + +* [Node.js 에이전트 호환성 보고서가](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent) 업데이트되었습니다. +* 더 나은 사용자 경험을 위해 간소화된 콘텐츠로 업데이트된 [NRQL 소개](/docs/nrql/get-started/introduction-nrql-new-relics-query-language). +* [Kubernetes 에이전트 연산자](/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator) 에 저항 에이전트에 대한 ConfigMap 지원이 추가되었습니다. + +### 사소한 변경 사항 + +* [Set 청년값, 곧 공지 조건](/docs/alerts/create-alert/set-thresholds/set-thresholds-alert-condition) 에 대한 끊어진 링크가 수정되었습니다. +* 개선된 시각적 요소를 갖춘 향상된 [쿼리 빌더 소개](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) 문서입니다. +* 문서 전반에 걸쳐 수학 방정식 렌더링에 대한 지원이 추가되었습니다. +* 향상된 세션 재생 [일시 정지 기능](/docs/browser/new-relic-browser/browser-apis/pauseReplay) 과 향상된 안내를 통해 [기능 설명서를 녹화합니다](/docs/browser/new-relic-browser/browser-apis/recordReplay). +* 명확성을 위해 여러 문서 페이지에 걸쳐 브라우저 에이전트 분산 추적 요구 사항을 업데이트했습니다. +* 도커, Podman, Kubernetes 및 OpenShift의 크기 조정 고려 사항에 대한 향상된 수학 방정식을 통해 [신세틱스 작업 관리자 설정이](/docs/synthetics/synthetic-monitoring/private-locations/job-manager-configuration/#kubernetes-sizing) 업데이트되었습니다. +* 문서 렌더링에 영향을 미치는 MDX 문제가 해결되었습니다. + +### 릴리즈 정보 + +* 최신 릴리스에 대한 최신 정보를 받아보세요. + + * [브라우저 에이전트 v1.300.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.300.0): + + * 모든 사용자에 대해 표시 및 측정 기능 플래그 사용이 제거되었습니다. + * hasReplay 속성 오탐 비율이 감소했습니다. + * waitForEnd 모범 사례를 반영하기 위해 푸시형 결합 API 입력을 업데이트했습니다. + * 롤업.js의 동적 요구 문제를 해결했습니다. + + * [브라우저 에이전트 v1.301.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.301.0): + + * 세션 리플레이에 뉴렐릭의 rrweb 분기 버전을 사용하도록 전환했습니다. + * 적절한 우선순위 처리를 통해 로그 페이로드에 대한 에이전트 속성을 보존합니다. + + * [Kubernetes 통합 v3.47.0](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-47-0): + + * Kubernetes 환경을 위한 향상된 모니터링 기능. + * 리소스 수집 및 성능 최적화가 개선되었습니다. + + * [Node.js 에이전트 v13.5.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-5-0): + + * 방출된 이벤트를 구독하기 위해 fastify 측정, 로그를 업데이트했습니다. + * 향상된 데이터베이스 모니터링을 위해 pg 및 pg-native 측정, 로그를 업데이트했습니다. + * 더 나은 성능을 위해 기본적으로 timers.setTimeout 및 timers.setInterval을 비활성화했습니다. + * 향상된 문제 해결, 해결을 위한 새로운 진단 기본 클래스가 추가되었습니다. + + * [iOS 에이전트 v7.5.11](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-7511): + + * 상호작용 추적과 관련된 성능 문제가 해결되었습니다. + * 잘못된 분산 추적 로그 메시지를 수정했습니다. + + * [안드로이드 에이전트 v7.6.10](/docs/release-notes/mobile-release-notes/android-release-notes/android-7610): + + * 빌드 호환성을 개선하기 위해 Gradle 9 지원을 추가했습니다. + + * [인프라 에이전트 v1.69.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1690): + + * 향상된 시스템 모니터링 기능과 버그 수정. + + * [인프라 에이전트 v1.70.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1700): + + * 추가적인 성능 개선 및 모니터링 향상. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx new file mode 100644 index 00000000000..e6aff2f120f --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx @@ -0,0 +1,99 @@ +--- +subject: Docs +releaseDate: '2025-08-01' +version: 'July 25 - August 01, 2025' +translationType: machine +--- + +### 새로운 문서 + +* 컴퓨트 소비 단위(CCU) 사용량에 대한 모니터링 및 공지 메커니즘을 제공하기 위해 [컴퓨트 예산 문서를](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) 추가했습니다. + +### 주요 변경 사항 + +* Node.js 에이전트에 대한 [호환성 및 요구 사항이](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent) 업데이트되었습니다. + +* PHP 에이전트용 [Arcin Linux의 호환성 및 요구 사항이](/docs/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements) 업데이트되었습니다. + +* [파이프라인](/docs/new-relic-control/pipeline-control/modify-agent-configuration) 위험에 대한 에이전트별 요구 사항을 업데이트했습니다. + +* [지속 저항](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file#jfr-harvest-interval) 에 대한 설정 요구 사항과 관련된 JFR을 업데이트했습니다. + +* 뉴렐릭 가격 및 청구에 대한 가격 및 청구 정보가 업데이트되었습니다. + + * [데이터: 청구 및 규칙](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing) + * [사용량 관련 쿼리 및 알림](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/usage-queries-alerts) + * [뉴렐릭 이용 계획](/docs/licenses/license-information/usage-plans/new-relic-usage-plan) + +### 사소한 변경 사항 + +* .NET 에이전트 [호환성 및 요구 사항 문서에서 SQL 에이전트를 캡처하기 위해 .NET 에이전트](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements) 의 언어를 명확하게 했습니다. +* [작업 데이터베이스 모니터링 통합](/docs/infrastructure/host-integrations/host-integrations-list/oracle-database-monitoring-integration) 의 언어가 개선되었습니다. + +### 릴리즈 정보 + +* 새로운 소식 게시물을 확인하세요. + + * [컴퓨터 예산이 이제 일반적으로 이용 가능합니다](/whats-new/2025/07/whats-new-7-30-compute-budgets). + * [사용자 경험 강화: 핵심 웹 바이탈 최적화를 위해 세션 리플레이 활용](/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser). + +* 최신 릴리스에 대한 최신 정보를 받아보세요. + + * [안드로이드 에이전트 v7.6.8](/docs/release-notes/mobile-release-notes/android-release-notes/android-768): + + * Unity 오류에 대한 스택 추적이 올바르게 표시되지 않는 문제를 해결했습니다. + * 앱이 처음 실행된 후 포그라운드로 돌아왔을 때 요약 지표가 기록되지 않는 문제를 해결했습니다. + * 로그 항목에 잘못된 JSON이 포함되어 오류가 발생할 수 있는 문제를 해결했습니다. + + * [진단 CLI(nrdiag) v3.4.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-341): + * 에이전트 제어 설치에서 생성된 로그를 수집하기 위해 `K8s/AgentControl/agent-control-install-job-logs` 을 추가했습니다. + + * [작업 관리자 v451](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-451): + + * SJM의 보안 문제를 해결하기 위해 `common-lang3` ยู่ 및 Ubuntu와 관련된 버그를 수정했습니다. + * 내부 서비스 아키텍처의 마이그레이션과 관련된 프로세서 대기열 마이그레이션 변경 사항을 구현했습니다. + * SJM 로그에서 문제 해결, 해결에 대한 더 나은 컨텍스트를 제공하기 위해 전체 예외 세부 정보를 포함하도록 문제를 수정했습니다. + + * [Android v5.30.1용 모바일 앱](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5301): + * 로그인 경험이 향상되었습니다. + + * [iOS v7.5.8용 모바일 앱](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-758): + + * Xcode 16.4를 사용하여 에이전트를 빌드했습니다. + * 세션 시작 시 분산 추적에 필요한 모든 계정 정보가 포함되지 않는 문제를 해결했습니다. + * 에이전트 시작 시 충돌이 발생할 수 있는 문제를 해결했습니다. + + * [노드 API 런타임](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.122): + * Node API 런타임에서 보안 교육을 처리하기 위해 양식 데이터 잘라내 및 기본 Ubuntu 잘라내를 수정했습니다. + + * [노드 브라우저 런타임](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.39): + * Node 브라우저 런타임의 보안 쿠키를 해결하기 위해 form-data 쿠키 및 기본 Ubuntu 괄호를 수정했습니다. + + * [Ping 런타임](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.0): + * Ping 런타임의 보안 문제를 해결하기 위해 `common-lang3` ย 및 Ubuntu와 관련된 고정된 버그를 수정했습니다. + + * [접착제 에이전트 v10.15.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101500): + + * [`oracledb`](https://pypi.org/project/oracledb/)에 대한 지원이 추가되었습니다. + * `MessageBroker` 측정, 과학적에서 serialize 메서드가 `MessageTransaction` 에서 `destination_name` 속성을 찾고 있었지만 해당 속성이 존재하지 않았던 버그를 수정했습니다. + * AWS와 K8s를 함께 실행할 때 발생하는 AWS 활용 메타데이터 문제를 해결했습니다. + + * [루비 에이전트 v9.20.0](/docs/release-notes/agent-release-notes/ruby-release-notes/ruby-agent-9-20-0): + + * AWS ECS Fargate 환경에서 실행할 때 도커 ID를 기록하는 지원이 추가되었습니다. + * 버전 비교를 단순화하기 위해 새로운 도우미 메서드를 추가했습니다. + * 기간이 구성된 청년 값을 초과하는 경우 데이터 스토어 범위에 `code.stacktrace` 속성을 추가했습니다. + * `Brewfile` 소스 링크가 수정되었습니다. + * `HTTPX 1.5.0` 사용하여 응답을 저장할 때 발생하는 오류를 수정했습니다. + * 에이전트가 설정 소스를 읽을 때 디버그 수준에서 에이전트에 의한 정보 로그를 개선했습니다. + + * [유니티 에이전트 v1.4.8](/docs/release-notes/mobile-release-notes/unity-release-notes/unity-agent-148): + + * 네이티브 안드로이드 에이전트를 v7.6.7로 업데이트했습니다. + * 네이티브 iOS 에이전트를 v7.5.6으로 업데이트했습니다. + + * [유니티 에이전트 v1.4.9](/docs/release-notes/mobile-release-notes/unity-release-notes/unity-agent-149): + + * 네이티브 안드로이드 에이전트를 v7.6.8로 업데이트했습니다. + * 네이티브 iOS 에이전트를 v7.5.8로 업데이트했습니다. + * 네임스페이스가 사용될 때 발생하는 Unity 예외 스택 추적 문제가 해결되었습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx new file mode 100644 index 00000000000..8223f140d0d --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx @@ -0,0 +1,60 @@ +--- +subject: Docs +releaseDate: '2025-08-08' +version: 'August 01 - August 07, 2025' +translationType: machine +--- + +### 새로운 문서 + +* [NerdGraph 튜토리얼을 추가했습니다: Teams에 대한 사용자 지정 역할 만들기는](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) NerdGraph API 사용하여 Teams에 대한 사용자 지정 역할을 만들고 관리하는 방법을 안내합니다. + +### 사소한 변경 사항 + +* [조건별 알림 이벤트를 분당 1,000개로](/docs/alerts/admin/rules-limits-alerts) 변경했습니다. +* 최신 검증된 [.Net 에이전트 호환 버전과 요구 사항을](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements) 업데이트했습니다. +* [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-service-broker-integration) 의 서비스 브로커에 대한 버전 및 버전 지원 정보가 업데이트되었습니다. +* [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-nginx-buildpack-integration) 용 뉴렐릭 NGINX 통합 빌드팩에 대한 버전 지원 정보를 업데이트했습니다. +* [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-firehose-nozzle-integration/#product-snapshot) 용 뉴렐릭 Nozzle에 대한 버전 및 버전 지원 정보를 업데이트했습니다. + +### 릴리즈 정보 + +* 새로운 소식 게시물을 확인하세요. + + * [의 인박스(errors inbox)가 이제 워크로드 내에 통합되었습니다](/whats-new/2025/08/whats-new-08-06-workloads-errors-inbox). + +* 최신 릴리스에 대한 최신 정보를 받아보세요. + + * [작업 관리자 v452](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-452): + * 대기열 메시지 처리 시 예외 처리를 위한 내부 개선 사항이 추가되었습니다. + + * [Kubernetes 통합 v3.43.3](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-43-3): + * 뉴렐릭 Kubernetes 모니터링 솔루션을 구현하고 배포하기 위해 Helm 차트를 추가했습니다. + + * [파이프라인 컨트롤 게이트웨이 v1.1.0](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-08-05): + + * 삭제 규칙을 사용하여 `SqlTrace` 및 `TransactionTrace` 이벤트에서 데이터와 속성을 선택적으로 삭제하는 새로운 기능을 구현했습니다. + + * IPv6 영역 ID와 관련된 HTTP 프록시 우회 및 사이트 간 스프레드시트 문제를 포함하여 `golang.org/x/net` 패키지의 취약점을 해결했습니다. + + * Go `1.24` 로 업그레이드되었으며 다음 의존성/종속성이 보안을 강화하고 최근 수정 사항을 통합하도록 업데이트되었습니다. + + * `golang.org/x/net to v0.38.0` + * `golang.org/x/sys to v0.31.0` + * `golang.org/x/text to v0.23.0` + + * [iOS v6.9.11용 모바일 앱](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6101): + * 사용자의 인증 도메인을 저장하고 사용자를 로그인 페이지로 직접 리디렉션하여 로그인 흐름을 두 단계로 줄였습니다. + + * [플러터 에이전트 v1.1.13](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1113): + + * 개선된 네이티브 Android 에이전트가 버전 7.6.8로 업데이트되었습니다. + * 향상된 네이티브 iOS 에이전트가 버전 7.5.8로 업데이트되었습니다. + + * [.NET MAUI 에이전트 v1.1.11](/docs/release-notes/mobile-release-notes/net-maui-release-notes/net-maui-agent-1111) + + * 개선된 네이티브 Android 에이전트가 버전 7.6.8로 업데이트되었습니다. + * 향상된 네이티브 iOS 에이전트가 버전 7.5.8로 업데이트되었습니다. + + * [인프라 에이전트 v1.65.5](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1655): + * 저장소 샘플에서 지원 AWS EFS 마운트를 변경했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx new file mode 100644 index 00000000000..aa88f66f598 --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx @@ -0,0 +1,112 @@ +--- +subject: Docs +releaseDate: '2025-08-15' +version: 'August 08 - August 14, 2025' +translationType: machine +--- + +### 새로운 문서 + +* [NRQL 함수에 대한 지원을 게이트웨이 규칙에](/docs/new-relic-control/pipeline-control/nrql-functions) 추가하여 NRQL 게이트웨이 규칙에서 지원되는 NRQL 함수를 간략하게 설명했습니다. +* 뉴렐릭 인프라 에이전트 설정에서 호스트명 해상도 설정을 조정하여 [빈번한 Fluent Bit Restart 이벤트를](/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/frequent-fluent-bit-restart-events) 해결하기 위한 문제 해결, 해결 단계를 추가했습니다. + +### 주요 변경 사항 + +* 최신 가격 정보가 포함된 업데이트된 [사용 계획](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/#list-price) 입니다. +* [워크로드 UI](/docs/new-relic-solutions/new-relic-one/workloads/use-workloads/#errors)에 **Error inbox** \[오류 받은 편지함]을 추가했습니다. +* [저항](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file/#skip-applications) 세력 설정에 대한 강화된 보안 설정과 함께 환경 변수를 통해 시작 메인 클래스 또는 실행 가능한 jar를 기반으로 선택적 에이전트 비활성화를 추가했습니다. +* 에이전트 제어에 [개인용 스테이션 설정](/docs/new-relic-control/agent-control/configuration/#private-repository-configuration) 에 대한 지원이 추가되어 기본 또는 TLS 인증서 방법을 통한 인증으로 관리형 에이전트의 구현, 배포가 가능해졌습니다. +* 에이전트 제어에서 [비밀 관리](/docs/new-relic-control/agent-control/configuration/#secrets-management) 에 대한 지원이 추가되어 전용 비밀 공급자로부터 비밀번호 및 API 키와 같은 민감한 데이터를 검색하여 관리할 수 있습니다. + +### 사소한 변경 사항 + +* [파이프라인 제어 cloud 규칙을 사용하여 데이터 삭제](/docs/new-relic-control/pipeline-control/cloud-rules-api/#restrictions) 에 `WHERE` 절에 대한 카테고리 태그 제한을 추가했습니다. +* 뉴렐릭 AI 지식 커넥터에 대한 [지식 소스 콘텐츠를 최적화하기 위한 모범 사례를](/docs/agentic-ai/knowledge-integration/overview/#configure) 추가했습니다. + +### 릴리즈 정보 + +* 새로운 소식 게시물을 확인하세요. + + * [UniqueCount 고정밀 모드와 향상된 인수 지원이 이제 일반적으로 사용 가능합니다](/whats-new/2025/08/whats-new-8-13-high-precision-uniquecount). + +* 최신 릴리스에 대한 최신 정보를 받아보세요. + + * [코도바 에이전트 v7.0.8](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-708/): + + * 네이티브 안드로이드 에이전트를 7.6.8 버전으로 업데이트하세요 + * 네이티브 iOS 에이전트를 7.5.8 버전으로 업데이트하세요. + + * [코도바 에이전트 v7.0.9](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-709/): + + * 네이티브 안드로이드 에이전트를 7.6.6 버전으로 업데이트하세요 + * 네이티브 iOS 에이전트를 7.5.5 버전으로 업데이트하세요. + + * [Capacitor 에이전트 v1.5.8](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-158/): + + * 네이티브 안드로이드 에이전트를 7.6.6 버전으로 업데이트하세요 + * 네이티브 iOS 에이전트를 7.5.5 버전으로 업데이트하세요. + + * [Capacitor 에이전트 v1.5.9](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-159/): + * 고정된 중단 신호 충돌 + + * [Capacitor 에이전트 v1.5.10](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-1510/): + + * 네이티브 안드로이드 에이전트를 7.6.8 버전으로 업데이트하세요 + * 네이티브 iOS 에이전트를 7.5.8 버전으로 업데이트하세요. + + * [진단 CLI(nrdiag) v3.5.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-350/): + * `Java/Appserver/JbossEapCheck` 버전 호환성 검사를 업데이트했습니다. + + * [.NET 에이전트 v10.44.0](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-0/): + + * Serverless 모드에서 성능 메트릭 샘플러 활성화 + * 측정, 리소스에서 Azure Function 웹호스트(Linux) 프로세스를 제외했습니다. + + * [NRDOT v1.3.0](/docs/release-notes/nrdot-release-notes/nrdot-2025-08-13/): + + * 호텔 구성 요소 버전이 v0.128.0에서 v0.131.0으로 상향 조정되었습니다. + * nrdot 코어 배포판 출시 + + * [Node.js 에이전트 v13.1.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-1-0/): + + * OTEL 로그 API에 대한 지원이 추가되었습니다. + * 패키지에 대해 측정, 로그가 비활성화된 경우 지원 가능성 지표를 추가했습니다. + * 비활성화된 타이머 측정, 기본적으로 샘플 설정의 로그 + * `transaction.url` 난독화 수정 + + * [작업 관리자 v454](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-454/): + * SJM의 보안 취약점을 해결하기 위해 Ubuntu의 기본 취약점을 수정했습니다. + + * [노드 API 런타임 v1.2.124](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.124/): + * Node API 런타임의 보안 취약점을 해결하기 위해 기본 Ubuntu 취약점을 수정했습니다. + + * [노드 브라우저 런타임 v3.0.41](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.41/): + * 노드 브라우저 런타임의 보안 쿠키를 해결하기 위해 tmp `CVE-2025-54798` 붂개 및 기본 Ubuntu 접속을 수정했습니다. + + * [Ping 런타임 v1.54.0](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.0/): + * Ping 런타임의 보안 문제를 해결하기 위해 Ubuntu와 관련된 취약점을 수정했습니다. + + * [대응 에이전트 v8.23.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8230/): + + * graphql v24를 지원하도록 업데이트되었습니다. + * 양상추 6.5 측정, 로그가 추가되었습니다. + * commons-lang 버전을 3.18.0으로 올렸습니다. + + * [AWS Lambda 로그인 전달자 v1.1.1](/docs/release-notes/aws-lambda-log-forwarder-release-notes/lambda-25-07-25/): + * 시스템의 Go 버전을 1.24.4로 업그레이드하여 보안 태세를 강화했습니다. + + * [PHP 에이전트 v12.0.0.25](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-0-0-25/): + + * Drupal Hook Map 오류 로깅이 개선되었습니다. + * 시큐리티 RX의 구형 패키지 감지 문제를 수정했습니다. + + * [인프라 에이전트 v1.66.1](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1661/): + * 스토리지 샘플에서 AWS EFS 마운트에 대한 지원을 되돌렸습니다. + + * [Android v5.30.6용 모바일 앱](docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5306/): + * SAML 및 소셜 로그인에 대한 향상된 Passkey 지원. + + * [브라우저 에이전트 v1.295.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.0/): + + * 오류 원인 감지 기능이 추가되었습니다. + * 몽키 패칭 경고를 추가했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx new file mode 100644 index 00000000000..690e192131c --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx @@ -0,0 +1,56 @@ +--- +subject: Docs +releaseDate: '2025-08-22' +version: 'August 15 - August 21, 2025' +translationType: machine +--- + +### 주요 변경 사항 + +* [Node.js 에이전트](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent/) 호환성 보고서가 업데이트되었습니다. +* 최신 검증된 호환 라이브러리 버전으로 [.NET 에이전트를](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements/) 업데이트했습니다. + +### 사소한 변경 사항 + +* Linux용 [에이전트](/docs/infrastructure/infrastructure-agent/requirements-infrastructure-agent/#os) 에이전트를 지원하도록 [Debian 운영 시스템을 버전 12("bookworm")로 업데이트했습니다.](/docs/infrastructure/infrastructure-agent/linux-installation/package-manager-install/) +* 데이터 제한을 쿼리하기 위한 [`accountId()`](/docs/data-apis/manage-data/query-limits/) 함수가 업데이트되었습니다. +* 64비트Windows (Intel/AMD)를 지원하도록 [Windows MSI 설치기를](/docs/infrastructure/infrastructure-agent/windows-installation/windows-msi-installer/#install-windows) 업데이트했습니다. + +### 릴리즈 정보 + +* [AI 모니터링 UI](/docs/ai-monitoring/drop-sensitive-data/) 를 통해 2026년 1월 7일이 폐기 규칙의 수명 종료일로 발표되었습니다. + +* [iOS 에이전트 v7.5.9](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-759/) + + * 세션 시작 시 분산 추적에 필요한 모든 계정 정보가 포함되지 않는 문제를 해결했습니다. + * 에이전트 시작 시 충돌이 발생할 수 있는 문제를 해결했습니다. + +* [파이썬 에이전트 v10.16.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101600/) + + * 새로운 [REDIS](https://pypi.org/project/redis/) 기능에 대한 지원이 추가되었습니다. + * 모든 내부 경로를 `os.path` 에서 `pathlib.Path` 로 변환했습니다. + * PosixPath의 JSON 인코딩 문제가 해결되었습니다. + +* [Kubernetes 통합 v3.44.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-44-1/) + + * 이 통합은 다음 차트 버전에 포함되어 있습니다. + + * [뉴렐릭-인프라-3.49.1](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.49.1) + * [nri-bundle-6.0.10](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.10) + +* [.NET 에이전트 v10.44.1](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-1/) + + * Service Bus 측정, 로그 래퍼에서 예외 처리가 수정되었습니다. + * 측정, 리소스에서 Azure Function 웹호스트(Linux) 프로세스를 제외했습니다. + +* [Node.js 에이전트 v13.2.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-2-0/) + + * 구독자 기반 측정, 리소스에 대한 `Supportability/Features/Instrumentation/OnRequire/` 지표를 등록하는 기능이 추가되었습니다. + * orchestrion-js와 함께 작동하도록 esm 로더 후크와 commonjs 패치를 추가했습니다. + * `@modelcontextprotocol/sdk` 클라이언트 호출 `client.callTool`, `client.readResource` 및 `client.getPrompt` 에 대한 측정, 로그가 추가되었습니다. + * OTEL 패키지 감지에 대한 고정 논리가 적용되었습니다. + * 비활성화된 구독자를 올바르게 설정하고 건너뛸 수 있도록 `shimmer.setupSubscribers` 업데이트했습니다. + +* [Node.js 에이전트 v13.2.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-2-1/) + + * 추적 채널 기반 측정을 위한 CJS/ESM 등록에 `@apm-js-collab/tracing-hooks` 사용하도록 에이전트가 업데이트되었습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx new file mode 100644 index 00000000000..b882f2ec86d --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx @@ -0,0 +1,94 @@ +--- +subject: Docs +releaseDate: '2025-09-14' +version: 'September 08 - September 12, 2025' +translationType: machine +--- + +### 새로운 문서 + +* 4가지 핵심 영역(비즈니스 업타임, 디지털 경험, 엔지니어링 우수성, 인텔리전스)에 걸쳐 옵저버빌리티 관행을 측정하고 개선하기 위한 지침을 제공하기 위해 포괄적인 [옵저버빌리티 성숙도 모델](/docs/new-relic-solutions/observability-maturity/) 문서를 추가했습니다. + +### 주요 변경 사항 + +* 샘플링 컨트롤 및 프레임워크 예외 처리기 측정을 위한 광범위한 새 설정 옵션으로 [PHP 에이전트 설정이](/docs/apm/agents/php-agent/configuration/php-agent-configuration/) 업데이트되었습니다. + +### 사소한 변경 사항 + +* 대시보드 사용에 대한 향상된 가이드를 포함하여 [대시보드 소개가](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) 업데이트되었습니다. +* JSON 관리를 위한 간소화된 콘텐츠로 [대시보드 관리](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/) 문서가 개선되었습니다. +* [뉴렐릭 사용 계획](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/) 문서의 깨진 링크를 수정했습니다. +* [.NET 에이전트 문제 해결, 해결](/docs/apm/agents/net-agent/troubleshooting/debugging-net-windows/) 문서의 디버깅 설정이 수정되었습니다. + +### 릴리즈 정보 + +* 최신 릴리스에 대한 최신 정보를 받아보세요. + + * [브라우저 에이전트 v1.297.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.0/): + + * 재시도 기간 동안 조기 수확을 방지하여 더 나은 속도 제한 처리를 제공합니다. + * 청구 가능한 바이트를 줄이기 위해 나가는 리플레이 페이로드에서 Newrelic 메타 속성을 제거했습니다. + * 빈 수확으로 인해 발생하는 null 본문에 대한 고정 예외가 수정되었습니다. + + * [PHP 에이전트 v12.1.0.26](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-1-0-26/): + + * 업스트림 w3c 트레이스 바로 결정을 기반으로 샘플링 제어가 추가되었습니다. + * 프레임워크 예외 처리기의 측정, 서명을 건너뛰는 설정 옵션이 추가되었습니다. + * `newrelic_end_transaction(true)` 호출할 때 잠재적인 메모리 누수가 해결되었습니다. + * 보안 개선을 위해 Golang 버전을 1.25.1로 올렸습니다. + + * [접착제 에이전트 v10.17.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101700/): + + * Celery에서 사용자 정의 작업에 대한 지원이 추가되었습니다. + * Graphene-Django 모니터링에 대한 지원이 추가되었습니다. + * Django에서 미들웨어 필터링에 대한 지원이 추가되었습니다. + * AWS Bedrock Converse API에 대한 지원이 추가되었습니다. + * W3CTraceParent 헤더 샘플링 플래그에 대한 지원이 추가되었습니다. + + * [대응 에이전트 v8.24.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8240/): + + * MongoDB Reactive Streams 5.2.0 이상에 대한 지원이 추가되었습니다. + * Jedis 6 지원이 추가되었습니다. + * CouchBase 이중 측정, 로그 문제가 해결되었습니다. + * Spring WebClient 5.x 헤더 래핑 문제가 해결되었습니다. + + * [Node.js 에이전트 v13.3.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-0/): + + * MCP `StreamableHTTPClientTransport` 지원이 추가되었습니다. + + * [Node.js 에이전트 v13.3.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-1/): + + * `transaction.addRequestParameters` 의 객체에 `requestParameters` 기본값으로 지정하여 충돌을 해결했습니다. + + * [Node.js 에이전트 v13.3.2](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-2/): + + * 아웃바운드 http 호출에서 `protocol` 얻기 위한 방어 코드가 추가되었습니다. + + * [Kubernetes 통합 v3.45.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-45-1/): + + * 최신 개선 사항과 버그 수정이 적용되었습니다. + + * [작업 관리자 v464](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-464/): + + * 고객이 podman을 사용하여 사용자 지정 레지스트리에서 이미지를 가져올 수 없는 문제가 해결되었습니다. + + * [노드 브라우저 런타임 v3.0.43](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.43/): + + * 보안 취약점을 해결하기 위해 Ubuntu의 기본 취약점을 수정했습니다. + + * [iOS v6.9.12용 모바일 앱](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6102/): + + * 대시보드 및 알림에 대한 딥 링크 문제가 해결되었습니다. + * CCU 대시보드 ID 문제가 해결되었습니다. + + * [Android v5.30.7용 모바일 앱](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5307/): + + * 버그 수정 및 개선 사항이 추가되었습니다. + + * [플러터 에이전트 v1.1.14](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1114/): + + * 추가적인 안정성 개선 및 버그 수정이 이루어졌습니다. + + * [파이프라인 컨트롤 게이트웨이 v25.09.01](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-09-01/): + + * 파이프라인 제어 기능이 향상된 새로운 릴리스가 추가되었습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx b/src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx new file mode 100644 index 00000000000..6d826a7aac5 --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx @@ -0,0 +1,15 @@ +--- +subject: Infrastructure agent +releaseDate: '2025-10-27' +version: 1.71.0 +translationType: machine +--- + +에이전트의 새로운 버전이 출시되었습니다. [인프라 에이전트를 업데이트](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent) 하려면 표준 절차를 따르세요. 뉴렐릭은 에이전트를 정기적으로, 그리고 최소 3개월마다 업그레이드할 것을 권장합니다. 이번 릴리스부터 지원되는 가장 오래된 버전은 [안드로이드 에이전트 1.55.2](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1552/) 입니다. + +## 변경됨 + +* Suse 15.7 [#2139](https://github.com/newrelic/infrastructure-agent/pull/2139)에 대한 지원 추가 +* Debian 13(Trixie) [#2140](https://github.com/newrelic/infrastructure-agent/pull/2140)에 대한 지원 추가 +* 의존성/종속성 newrelic/nri-winservices를 v1.4.0 [#2143](https://github.com/newrelic/infrastructure-agent/pull/2143)으로 업데이트했습니다. +* 의존성/종속성 newrelic/nri-prometheus를 v2.27.2 [#2130](https://github.com/newrelic/infrastructure-agent/pull/2130)으로 업데이트했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx b/src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx new file mode 100644 index 00000000000..87d1e04f6f6 --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx @@ -0,0 +1,13 @@ +--- +subject: Kubernetes integration +releaseDate: '2025-10-28' +version: 3.48.0 +translationType: machine +--- + +변경 사항에 대한 자세한 설명은 [릴리스 노트를](https://github.com/newrelic/nri-kubernetes/releases/tag/v3.48.0) 참조하세요. + +이 통합은 다음 차트 버전에 포함되어 있습니다. + +* [뉴렐릭-인프라-3.53.0](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.53.0) +* [nri-번들-6.0.19](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.19) \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx b/src/i18n/content/kr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx new file mode 100644 index 00000000000..8d531a00fbf --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx @@ -0,0 +1,18 @@ +--- +subject: Flutter agent +releaseDate: '2025-10-24' +version: 1.1.16 +downloadLink: 'https://pub.dev/packages/newrelic_mobile/versions/1.1.16' +translationType: machine +--- + +## 버그 수정 + +* 키가 없는 경로(예: 바텀 시트 및 모달 대화 상자)를 처리할 때 `NewRelicNavigationObserver` 이 충돌하는 문제를 해결했습니다. +* `PageRoute` 확장하지 않는 경로에 대한 탐색 추적 오류가 해결되었습니다. + +## 개선 사항 + +* `NewRelicNavigationObserver` 에서 모든 동적 유형을 제거하여 유형 안전성을 개선했습니다. +* `go_router` 에서 `CupertinoPage` 및 `NoTransitionPage` 을 포함한 추가 경로 유형에 대한 지원이 추가되었습니다. +* 더 나은 유지 관리성과 가독성을 위해 탐색 관찰자 코드를 리팩토링했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx b/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx new file mode 100644 index 00000000000..d2e754e3a25 --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx @@ -0,0 +1,39 @@ +--- +subject: Browser agent +releaseDate: '2025-08-04' +version: 1.295.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Add error cause detection +bugs: + - Add monkey-patching warnings + - Calculate first and last timestamps from raw data +security: [] +translationType: machine +--- + +## v1.295.0 + +### 특징 + +#### 오류 원인 감지 추가 + +캡처된 JavaScriptError 이벤트에서 원인 속성을 감지하고 보고합니다. 원인이 오류의 인스턴스인 경우 스택 추적이 캡처되고, 그렇지 않은 경우 원인의 문자열화된 내용이 보고됩니다. 이는 `cause` 속성 아래의 JavaScriptError 이벤트에서 쿼리될 수 있습니다. + +### 버그 수정 + +#### 몽키 패칭 경고 추가 + +에이전트가 페이지에서 실행되기 전에 예상되는 글로벌 변수에 몽키 패치가 적용된 경우 감지 및 경고가 추가되었습니다. 이로 인해 예상치 못한 동작이 발생할 수 있으며, 고객에게 이러한 동작에 대해 알리는 것이 목적입니다. + +#### 원시 데이터에서 첫 번째 및 마지막 타임스탬프 계산 + +UI 리플레이어의 일관성을 개선하기 위해 수집하기 전에 에이전트가 SessionReplay 페이로드의 첫 번째 및 마지막 타임스탬프를 수동으로 계산하도록 합니다. + +## 지지 성명 + +뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 이전 릴리스는 지원 [종료](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/) 시점부터 더 이상 지원되지 않습니다. 출시일은 에이전트 버전의 원래 출판일을 반영합니다. + +새로운 브라우저 에이전트 릴리스는 일정 기간 동안 작은 단계로 고객에게 출시됩니다. 이로 인해, 귀하의 계정에서 해당 릴리스에 접근할 수 있는 날짜가 원래 게시 날짜와 일치하지 않을 수 있습니다. 자세한 내용은 이 [상태 대시보드를](https://newrelic.github.io/newrelic-browser-agent-release/) 참조하세요. + +[브라우저 지원 정책](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types) 에 따라, 브라우저 에이전트 v1.295.0은 다음 브라우저 및 버전 범위에 맞춰 빌드되고 테스트되었습니다: Chrome 128-138, Edge 128-138, Safari 17-19, Firefox 130-140. 모바일 장치의 경우 v1.295.0은 Android OS 16 및 iOS Safari 17-26용으로 구축 및 테스트되었습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx b/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx new file mode 100644 index 00000000000..6325fc4941e --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx @@ -0,0 +1,34 @@ +--- +subject: Browser agent +releaseDate: '2025-08-19' +version: 1.296.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Harvest traces early +bugs: + - Remove event buffer inspection event +security: [] +translationType: machine +--- + +## v1.296.0 + +### 특징 + +#### 수확 트레이스 조기 + +에이전트가 [1.294.0](https://docs.newrelic.com/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.294.0/) 부터 다른 기능이 데이터를 처리하는 것과 동일한 방식으로 세션 트레이스를 처리하도록 업데이트합니다. 16kb 크기에서 수확을 허용함으로써. + +### 버그 수정 + +#### 이벤트 버퍼 검사 이벤트 제거 + +`newrelic` 창 이벤트 리스너와 함께 console.log를 사용할 때 메모리 누수를 방지하기 위해 이벤트 버퍼 검사 이벤트를 제거합니다. + +## 지지 성명 + +뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 이전 릴리스는 지원 [종료](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/) 시점부터 더 이상 지원되지 않습니다. 출시일은 에이전트 버전의 원래 출판일을 반영합니다. + +새로운 브라우저 에이전트 릴리스는 일정 기간 동안 작은 단계로 고객에게 출시됩니다. 이로 인해, 귀하의 계정에서 해당 릴리스에 접근할 수 있는 날짜가 원래 게시 날짜와 일치하지 않을 수 있습니다. 자세한 내용은 이 [상태 대시보드를](https://newrelic.github.io/newrelic-browser-agent-release/) 참조하세요. + +[브라우저 지원 정책](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types) 에 따라, 브라우저 에이전트 v1.296.0은 다음 브라우저 및 버전 범위에 맞춰 빌드되고 테스트되었습니다: Chrome 129-139, Edge 129-139, Safari 17-19, Firefox 131-141. 모바일 장치의 경우 v1.296.0은 Android OS 16 및 iOS Safari 17-18.1에 대해 구축 및 테스트되었습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx b/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx index b1b2ac06c65..67041e6d551 100644 --- a/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx +++ b/src/i18n/content/kr/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx @@ -1,34 +1,22 @@ --- subject: Browser agent -releaseDate: '2025-09-10' -version: 1.297.0 +releaseDate: '2025-09-17' +version: 1.297.1 downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' -features: - - Prevent early harvests when in retry period - - remove newrelic meta attribute +features: [] bugs: - - Fix exceptions for null bodies arising from empty harvests + - Prevent double import of Session Replay aggregate class security: [] translationType: machine --- -## v1.297.0 - -### 특징 - -#### 재시도 기간 동안 조기 수확을 방지하세요 - -속도 제한이 있을 경우 에이전트가 조기에 수확하지 못하도록 합니다. 수집 서비스가 429를 반환하면 에이전트는 데이터를 교체하고 나중에 다시 수집을 시도합니다. 이러한 일이 진행되는 동안에는 새로운 데이터가 들어오더라도 조기에 수확할 수 없으며, 성공적으로 수확될 때까지는 수확이 불가능합니다. - -#### Newrelic 메타 속성 제거 - -나가는 리플레이 페이로드에서 \_\_newrelic 메타 속성 보고를 제거합니다. 이는 고객의 청구 대상 바이트를 절약하고 세션 리플레이 기능 사용 비용을 절감하기 위한 조치로 수행됩니다. +## v1.297.1 ### 버그 수정 -#### 빈 수확으로 인해 발생하는 null 본문에 대한 예외를 수정합니다. +#### 세션 리플레이 집계 클래스 이중 가져오기 방지 -정리된 모든 페이로드가 유효한 출력을 보장하도록 변경되었습니다. 이전에는 본문 정리 프로세스를 통과하는 빈 문자열이 본문을 null로 반환하기 때문에 오류가 발생할 수 있었습니다. 이제 빈 문자열은 손상되지 않고 통과되므로 추가 처리가 성공적으로 적용됩니다. +newrelic.recordReplay를 사용할 때 세션 재생 집계 클래스를 두 번 가져올 수 있는 문제가 발견되었습니다. 사전 로딩이 활성화된 동안 API 메서드가 활성화되었습니다. ## 지지 성명 @@ -36,4 +24,4 @@ translationType: machine 새로운 브라우저 에이전트 릴리스는 일정 기간 동안 작은 단계로 고객에게 출시됩니다. 이로 인해, 귀하의 계정에서 해당 릴리스에 접근할 수 있는 날짜가 원래 게시 날짜와 일치하지 않을 수 있습니다. 자세한 내용은 이 [상태 대시보드를](https://newrelic.github.io/newrelic-browser-agent-release/) 참조하세요. -[브라우저 지원 정책](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types) 에 따라, 브라우저 에이전트 v1.297.0은 다음 브라우저 및 버전 범위에 맞춰 빌드되고 테스트되었습니다: Chrome 129-139, Edge 129-139, Safari 17-19, Firefox 131-141. 모바일 장치의 경우 v1.297.0은 Android OS 16 및 iOS Safari 17-18.1에 대해 구축 및 테스트되었습니다. \ No newline at end of file +[브라우저 지원 정책](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types) 에 따라, 브라우저 에이전트 v1.297.1은 다음 브라우저 및 버전 범위에 맞춰 빌드되고 테스트되었습니다: Chrome 130-140, Edge 130-140, Safari 17-19, Firefox 132-142. 모바일 장치의 경우 v1.297.1은 Android OS 16 및 iOS Safari 17-18.5에 대해 구축 및 테스트되었습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx index b25ccda7180..3406c1d2490 100644 --- a/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx +++ b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx @@ -1,11 +1,10 @@ --- subject: Node API runtime -releaseDate: '2025-09-22' -version: 1.2.134 +releaseDate: '2025-07-29' +version: 1.2.122 translationType: machine --- ### 수정 사항 -* Node API 런타임의 보안 취약점을 해결하기 위해 기본 Ubuntu 취약점을 수정했습니다. -* SSL 검사기 조건이 며칠 남았습니다. 버그 수정. \ No newline at end of file +* Node API 런타임에서 보안 교육을 처리하기 위해 양식 데이터 잘라내 및 기본 Ubuntu 잘라내를 수정했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx index bab07a289b5..063ff1fe630 100644 --- a/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx +++ b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx @@ -1,14 +1,10 @@ --- subject: Node browser runtime -releaseDate: '2025-09-22' -version: 3.0.50 +releaseDate: '2025-07-29' +version: 3.0.39 translationType: machine --- ### 개량 -* Chrome 브라우저 버전을 131에서 134로 업그레이드하세요 - -### 수정 사항 - -* Node.js 브라우저 런타임의 보안 취약점을 해결하기 위해 CVE-2025-58754와 기본 Ubuntu 취약점을 수정했습니다. \ No newline at end of file +* Node 브라우저 런타임의 보안 쿠키를 해결하기 위해 form-data 쿠키 및 기본 Ubuntu 괄호를 수정했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx new file mode 100644 index 00000000000..d0c4af0c3c3 --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-07-29' +version: 1.53.0 +translationType: machine +--- + +### 개량 + +* Ping 런타임의 보안 문제를 해결하기 위해 `common-lang3` ย 및 Ubuntu와 관련된 고정된 버그를 수정했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx new file mode 100644 index 00000000000..1e9b8e6103d --- /dev/null +++ b/src/i18n/content/kr/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-08-13' +version: 1.54.0 +translationType: machine +--- + +### 개량 + +* Ping 런타임의 보안 문제를 해결하기 위해 Ubuntu와 관련된 취약점을 수정했습니다. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/vulnerability-management/overview.mdx b/src/i18n/content/kr/docs/vulnerability-management/overview.mdx index ca55942d573..a4b2e8c34ad 100644 --- a/src/i18n/content/kr/docs/vulnerability-management/overview.mdx +++ b/src/i18n/content/kr/docs/vulnerability-management/overview.mdx @@ -17,7 +17,7 @@ translationType: machine Security RX를 사용하면 다음과 같은 혜택을 누릴 수 있습니다. -* [FOSSA](docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](docs/vulnerability-management/integrations/snyk/), [Dependabot](install/vm/) 등과 같은 뉴렐릭 플랫폼과 통합 파트너가 감지한 취약점을 포함한 모든 취약점을 한눈에 볼 수 있습니다. +* 뉴렐릭 플랫폼과 [FOSSA](/docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](/docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](/docs/vulnerability-management/integrations/snyk/), [Dependabot](/install/vm/) 등과 같은 통합 파트너가 감지한 취약점을 포함한 모든 취약점을 한눈에 볼 수 있습니다. * 귀하의 전투 및 전투에서 지속적인 기지국 가시성을 확보하세요. diff --git a/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx new file mode 100644 index 00000000000..2b7ee90bda8 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx @@ -0,0 +1,707 @@ +--- +title: 나만의 흐름 만들기 +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic +metaDescription: Build custom workflows from scratch using drag-and-drop actions. Learn by example with a real-world EC2 automation scenario. +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +템플릿이 필요에 맞지 않을 경우 [Create Your Own을 사용](https://onenr.io/0OQM47KgxjG) 하여 사용자 정의 폴리스우를 만들 수 있습니다. 드래그 앤 드롭 인터페이스를 사용하여 [작업 카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) 에서 작업을 체인으로 연결하여 프로세스에 맞는 자동화를 구현하세요. + +## 이 가이드를 사용하는 방법 + +이 가이드에서는 개념과 완전한 예를 사용하여 플레우스를 만드는 방법을 보여줍니다. 학습 경로를 선택하세요: + +* **핵심 개념을 먼저 배우세요** → [핵심 개념](#core-concepts) 과 [에볼루션 패턴을](#workflow-patterns) 읽어 기본을 이해한 다음 적용하세요 + +* **예시를 따르세요** → EC2 자동 크기 조정 스텔라우를 단계별로 빌드하는 [예제 연습](#example-walkthrough) 으로 이동하세요 + +* **참고 패턴** → [에라스우 패턴](#workflow-patterns) 섹션을 에라스우를 직접 만들 때 빠른 참조로 활용하세요. + + + **워크플로우를 처음 사용하시나요?** 핵심 개념부터 시작한 다음, 예를 따르세요. EC2 스카이레이크는 실제 시나리오의 모든 주요 패턴을 보여줍니다. + + +## 왜 커스텀 플로우를 구축하나요? + +자신만의 워크플로우를 구축해 보세요: + +* 템플릿이 지원하지 않는 **고유한 비즈니스 로직을 구현합니다.** +* 표준 템플릿을 넘어 **여러 시스템을 통합합니다** . +* 조건 분기를 사용하여 **복잡한 결정을 처리하세요** +* 승인 및 공지를 위한 **팀의 프로세스를 일치시키세요.** + +## 핵심 개념 [#core-concepts] + +빌드하기 전에 다음 기본 사항을 이해하세요. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **개념** + + **그것이 하는 일** + + **예시** +
+ 입력 및 비밀 + + 사용자 인증 정보 및 설정에 대한 반응 + + `${{ :secrets:awsKeyId }}` 자격 증명의 경우 `${{ .inputs.region }}` , 구성의 경우 +
+ 작업 카탈로그 + + 사전 구축된 통합(AWS, Slack, 데이터베이스, API) + + `aws.ec2.stopInstances` (를) 워크플로우 캔버스로 드래그하세요. +
+ 데이터 흐름 + + 단계 간 출력 전달 + + `${{ .steps.getAlert.outputs.entityGuid }}` +
+ 스위치 + + 조건에 따라 다른 경로를 생성합니다. + + `Route by CPU > 90% vs. 70-90% vs. < 70%` +
+ 루프 + + 완료를 위한 프로세스 목록 또는 투표 + + `for` 및 `in` 와 함께 `type: loop` 사용하여 컬렉션을 반복합니다. +
+ 승인 게이트 + + 인간의 결정을 위한 일시 정지 + + 파괴적인 작업 전의 느슨한 반응 +
+ 오류 처리 + + 실패를 포착하고 정리를 실행합니다. + + 롤백 프로시저를 사용한 Try-catch 패턴 +
+ + + **실천을 통해 배우기:** 각 개념은 아래의 [예제 연습](#example-walkthrough) 에서 설명됩니다. 실제 스텔라우에서 입력, 스위치, 루프 및 승인 게이트가 함께 작동하는 것을 볼 수 있습니다. + + +자세한 오류 처리 패턴은 [모범 사례를](/docs/workflow-automation/limitations-and-faq/workflow-best-practices#error-handling) 참조하세요. + +## 빠른 시작 [#quick-start] + +5단계로 첫 번째 폴리스우를 만들어 보세요. + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** 로 이동하여 **[Create Your Own](https://onenr.io/0OQM47KgxjG) \[나만의 자동화 만들기를]**선택하세요. +2. 매개변수, 자격 증명(비밀 관리자에서: `${{ :secrets:keyName }}`), 설정(지역, 제외) 및 런타임 데이터(계정 ID, 공지 ID)에 대해 정의합니다. +3. [카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) 에서 작업을 끌어서 `${{ .steps.stepName.outputs.field }}` 구문으로 연결하여 데이터를 전달합니다. +4. 조건 분기를 위한 스위치, 목록 또는 폴링을 처리하기 위한 루프, 인간의 결정을 위한 승인 게이트를 삽입합니다. +5. 각 섹션을 실행한 후 오류를 일찍 포착한 다음 폴리스우를 [시작하거나 예약하세요.](/docs/workflow-automation/create-a-workflow-automation/start-schedule) + + + 3단계로 시작하여 철저히 테스트한 다음 확장하세요. 제대로 작동하는 5단계 워크플로우가 깨진 20단계 워크플로우를 이깁니다. + + +## 주요 흐름 패턴 [#workflow-patterns] + +네 가지 필수 패턴으로 대부분의 자동화 시나리오를 처리할 수 있습니다. 각 패턴은 아래의 [예제 연습](#example-walkthrough) 에서 설명됩니다. + +### 스위치를 사용한 조건 분기 + +**다음과 같은 경우에 스위치를 사용하십시오:** 데이터에 따라 결과가 다양함(임계값, 릴레이 확인, API 응답, 사용자 결정) + +**주요 구문:** + +```yaml +- name: hasCompleted + type: switch + switch: + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}" + next: displayError + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}" + next: displaySuccess + next: displayUnexpected # Default path when no condition matches +``` + +**실제로 확인해 보세요.** [팀 응답 처리](#handle-team-response) 및 [검증 및 정리](#verify-and-clean-up) 섹션에서는 Slack 반응과 AWS SSM 상태를 기반으로 스위치 라우팅을 보여줍니다. + +### 목록 처리를 위한 루프 + +여러 항목을 처리하거나 작업을 반복할 **때 루프를 사용합니다.** + +**주요 구문:** + +```yaml +# Send progress updates using range loop +- name: progressLoop + type: loop + for: + in: "${{ [range(1; 5)] }}" # Loop 5 times + steps: + - name: wait + type: wait + seconds: 10 + - name: progressMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "${{ .workflowInputs.channel }}" + text: "Resizing in progress..." +``` + +**실제로 확인해 보세요.** [크기 조정 섹션을 실행하면](#execute-the-resize) 상태 업데이트에 `progressLoop` 사용됩니다. + +### 승인 게이트 및 대기 + +파괴적인 작업이나 규정 준수 승인이 필요하기 전에 인간의 판단이 필요한 **경우 승인 게이트를 사용하세요.** + +**주요 구문:** + +```yaml +- name: requestApproval + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "#approvals" + text: "Approve? React with :thumbsup: or :thumbsdown:" + +- name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: "${{ .workflowInputs.slackToken }}" + channelID: "${{ .steps.requestApproval.outputs.channelID }}" + threadTs: "${{ .steps.requestApproval.outputs.threadTs }}" + timeout: 300 # Wait 5 minutes for reaction + +- name: checkApproval + type: switch + switch: + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}' + next: handleApproval + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}' + next: handleRejection +``` + +**간단한 지연의 경우:** + +```yaml +- name: waitBeforeRetry + type: wait + seconds: 60 # Wait 60 seconds before continuing +``` + +**실제로 확인해 보세요:** [요청 팀 승인](#request-team-approval) 섹션은 Slack 승인을 전체적으로 구현합니다. + +### 단계 간 데이터 전달 + +**데이터 전달을 사용하는 경우:** 한 단계의 출력이 다른 단계의 입력이 되는 경우(모든 스텔라우의 기초) + +**주요 구문:** + +```yaml +# Reference previous step outputs +awsRegion: "${{ .inputs.region }}" +instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}" +``` + +**실제 작동 모습을 확인하세요.** 모든 섹션에서 데이터 전달을 보여줍니다. 각 단계는 이전 결과를 기반으로 구성됩니다. + + + **완전한 패턴 예를 원하시나요?** 오류 처리, 재시도, 복잡한 통합을 포함한 추가 패턴에 대한 [워크플로우 예를](/docs/workflow-automation/workflow-examples) 참조하세요. + + +## 예제 연습: 승인을 통해 EC2 크기 자동 조정 [#example-walkthrough] + +이 완전한 예제는 Slack을 통해 팀 승인을 받은 후 CPU가 급증할 때 EC2 인스턴스의 크기를 자동으로 조정하는 스텔라우를 빌드하는 방법을 보여줍니다. 실제 시나리오에서 데이터 수집, 조건 논리, 외부 통합 및 오류 처리를 보여줍니다. + + + **워크플로우를 처음 사용하시나요?** 이 예제에서는 AWS, Slack 및 승인 논리를 사용합니다. 이제 막 시작했다면 먼저 [Slack에 보고서 보내기](/docs/workflow-automation/create-a-workflow-automation/use-a-template#send-report-to-slack) 를 시도해 보세요. + + +### 전제 조건 [#prerequisites] + +이 폴리스우를 구축하기 전에 다음 사항이 있는지 확인하세요. + +* **AWS**: EC2 및 Systems Manager 권한이 있는 자격 증명 +* **Slack**: 공지를 위한 봇 및 채널 +* **뉴렐릭**: 공지사항 검토 EC2 CPU +* **비밀 관리자**: 구성됨( [비밀 관리](/docs/infrastructure/host-integrations/installation/secrets-management/) 참조) + +### 흐름 흐름 개요 [#workflow-overview] + +**상위 수준 흐름:** + +1. **데이터 수집**: 뉴렐릭으로부터 공지 및 세부정보 가져오기 +2. **승인 요청**: Slack 메시지 보내기, 팀 응답 대기 +3. **크기 조정 실행**: AWS Systems Manager를 사용하여 EC2 인스턴스 크기 조정 +4. **확인 및 정리**: 결과 확인, 팀에 알림, 임시 리소스 제거 + +이 예제에서는 사용자 지정 폴리스우에서 사용할 주요 패턴, 즉 API 쿼리, 조건 분기, 외부 통합, 폴링 루프 및 오류 처리를 보여줍니다. + +### 흐름 흐름 입력 [#workflow-inputs] + + + **개념에 대해 읽고 있다면 건너뛰세요.** 이 표에서는 이 활동이 사용하는 12가지 활동에 대해 자세히 설명합니다. 빌드할 때 참조할 수는 있지만, 흐름을 이해하는 데 필수적인 것은 아닙니다. + + +이 워크플로우에는 자격 증명, 설정 및 런타임 컨텍스트가 입력으로 필요합니다. 민감한 값은 `${{ :secrets:keyName }}` 구문을 사용하여 비밀 관리자에서 제공됩니다. + +**입력 카테고리:** + +* **인증**: Secrets Manager의 AWS 및 Slack 자격 증명 +* **공지 내용**: 뉴렐릭의 계정 ID 및 문제 ID +* **설정**: 지역,상태, 시간대, Slack 채널 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **반응, 이름** + + **유형** + + **기본값** + + **설명** +
+ `awsAccessKeyId` + + 문자열 + + `${{ :secrets:awsAccessKeyId }}` + + AWS 서비스 인증을 위해 Secrets Manager에서 AWS 액세스 키 ID를 검색했습니다. +
+ `awsSecretAccessKey` + + 문자열 + + `${{ :secrets:awsSecretAccessKey }}` + + AWS Secret Access Key가 Secrets Manager에서 검색되었습니다. 액세스 키 ID와 쌍을 이룹니다. +
+ `awsSessionToken` + + 문자열 + + `${{ :secrets:awsSessionToken }}` + + 임시 AWS 자격 증명에 대한 세션 토큰(선택 사항, IAM 역할과 함께 사용). +
+ `slackToken` + + 문자열 + + `${{ :secrets:slackToken }}` + + Slack에서 메시지를 게시하고 반응을 읽는 데 사용되는 봇 토큰입니다. +
+ `accountId` + + Int + + 필수의 + + 귀하의 뉴렐릭 계정 ID입니다. 공지 내용 및 부품 데이터를 조회하는데 사용됩니다. +
+ `issueId` + + 문자열 + + 필수의 + + 이 룩플로우를 촉발시킨 뉴렐릭 공지의 이슈 ID입니다. 공지에서 워크플로우 실행 시 자동으로 제공됩니다. +
+ `awsRegion` + + 문자열 + + `us-east-2` + + EC2 인스턴스가 실행되는 AWS 지역(예: `us-east-1`, `us-west-2`, `eu-west-1`). +
+ `InstanceType` + + 문자열 + + `t4g.nano` + + 크기 조정을 위한 목표 EC2 형태. 귀하의 성능 요구 사항과 예산에 따라 선택하세요. +
+ `timestampUnit` + + 문자열 + + `MILLISECONDS` + + 공지 타임스탬프의 시간 단위입니다. 일반적으로 `MILLISECONDS` 또는 `SECONDS` 입니다. +
+ `timezoneId` + + 문자열 + + `America/Los_Angeles` + + Slack 메시지에서 공지 활성화 시간을 표시하는 시간대(예: `America/New_York`, `Europe/London`, `Asia/Tokyo`). +
+ `pattern` + + 문자열 + + `MM-dd-yyyy HH:mm` + + 타임스탬프를 표시하기 위한 날짜/시간 형식 패턴입니다. 다음 SimpleDateFormat 패턴을 사용합니다. +
+ `channel` + + 문자열 + + 필수의 + + 공지가 게시된 Slack 채널 ID(이름 아님)입니다. 자세한 내용은 Slack 채널 세부정보에서 확인하세요. +
+ + + +## 단계별 워크플로우 구축 [#step-by-step-workflow] + +이제 스텔라우의 각 부분을 만들어 보겠습니다. 각 단계에는 추가할 구체적인 작업과 해당 작업이 보여주는 파라메트릭 패턴이 포함되어 있습니다. + + + + ### 공지 컨텍스트 수집 [#gather-alert-context] + + 조치를 취하기 전에 API와 데이터베이스를 쿼리하세요. 이렇게 하면 완전한 맥락을 파악할 수 있습니다. + + 워크플로우는 세 가지 작업을 통해 공지 및 EC2 관련 정보를 수집합니다. + + * **`getAlertDetails`**: NerdGraph API (뉴렐릭의 GraphQL API)를 호출하여 공지사항 데이터(활성화 시간, 조건 이름, 영향을 받는 부분)를 가져옵니다. + + * **`activatedDateTime`**: Slack 메시지의 타임스탬프를 "01-24-2025 14:30"과 같은 읽을 수 있는 형식으로 변환합니다. + + * **`impactedEC2Instance`**: EC2연결 ID와 현재 유형을 찾기 위한 쿼리 NRDB(뉴렐릭 데이터베이스)입니다. + + Workflow diagram showing three steps: getAlertDetails queries NerdGraph API, activatedDateTime converts timestamp, and impactedEC2Instance retrieves instance details from NRDB + + **이것이 중요한 이유:** 이러한 세부 정보가 없으면 의미 있는 Slack 메시지를 구성하거나 올바른 EC2 서버를 타겟팅할 수 없습니다. + + + + ### 팀 승인 요청 [#request-team-approval] + + Slack, PagerDuty 또는 ServiceNow와 같은 협업 도구에 연결하여 인간의 의사결정 지점을 파악합니다. + + 팰리스우는 Slack에 세부 정보를 보내고 응답을 기다립니다. + + * **`IssueDetected`**: 공지 세부정보, 현재 변경사항 및 제안된 크기 조정을 Slack에 게시합니다. 팀에 `:+1:` (승인) 또는 `:-1:` (취소)로 반응하도록 요청합니다. + + * **`GetUserReaction`**: 반응을 기다리며 5분(300초) 동안 멈춥니다. + + * **`checkQuery` (스위치)**: 반응 기반 경로: + + * **`:+1:`** → 크기 조정 시작 + * **`:-1:`** → 흐름 중지 + * **기타** → 유효한 반응을 위한 루프백 + + Workflow diagram showing user approval process: IssueDetected posts Slack message, GetUserReaction waits for response, checkQuery evaluates reactions with three conditions for approval, cancellation, or unexpected responses + + + **일반적인 문제:** 채널 이름이 아닌 Slack 채널 **ID** (`C01234ABCD`)를 사용하세요. Slack 채널 세부정보에서 찾아보세요. 자세한 내용 [은 문제 해결을](#common-issues) 참조하세요. + + + + + ### 팀 대응 처리 [#handle-team-response] + + 스위치를 사용하여 데이터 값이나 사용자 입력에 따라 다양한 경로를 만듭니다. + + 플루톤우 분기는 다음 반응에 따라 결정됩니다. + + * **`unexpectedReaction`**: 유효한 반응을 설명하고 다시 기다리기 위해 루프백합니다. + * **`gotCancelReaction`**: 취소를 확인하고 완료로 건너뜁니다. 인프라 변경 없음. + * **`gotYesReaction`**: 승인을 확인하고 크기 조정을 진행합니다. + + + **승인 게이트 패턴:** 위험한 변경 사항을 적용하기 전에 인간의 판단이 필요할 때 이와 같은 스위치를 사용하세요. 이 패턴은 Slack 반응, PagerDuty 확인, 이메일 응답 또는 사용자 정의 웹후크와 함께 작동합니다. + + + + + ### 크기 조정을 실행하세요 [#execute-the-resize] + + 중복 작업을 방지하려면 고유한 토큰을 사용하세요. 루프를 사용하여 장기 실행 작업의 상태를 확인합니다. + + 워크플로우는 AWS Systems Manager(SSM)를 통해 크기를 조정합니다. + + * **`createSsmDocument`**: 인스턴스를 중지하고, 유형을 수정하고, 다시 시작하는 SSM 자동화 문서를 만듭니다. + * **`generateIdempotencyToken`**: 고유한 UUID를 생성합니다. 스텔라우가 두 번 실행되는 경우 중복된 크기 조정을 방지합니다. + * **`startResizing`**: 인스턴스 ID와 새 유형으로 SSM 문서를 실행합니다. + * **`progressLoop` (루프)**: 10초마다 Slack 업데이트를 게시합니다(총 5회). + * **`waitForCompletion`**: 2분 제한 시간으로 SSM 상태를 폴링합니다. + + + **SSM을 선택해야 하는 이유는 무엇일까요?** Systems Manager는 오류 처리, 상태 검증, CloudTrail 감사 로그를 제공합니다. 직접 EC2 API 호출보다 낫습니다. + + + + **일반적인 문제:** AWS 자격 증명에 `ec2:StopInstances`, `ec2:ModifyInstanceAttribute`, `ec2:StartInstances` 및 `ssm:*` 권한이 있는지 확인하세요. 권한이 없으면 아무런 경고 없이 실패합니다. + + + + + ### 확인 및 정리 [#verify-and-clean-up] + + 결과에 관계없이 실패에 대비하고 임시 리소스를 정리하세요. + + 스텔라우에서는 결과를 확인하고 임시 리소스를 제거합니다. + + * **`hasCompleted` (스위치)**: SSM 상태(성공/실패/시간 초과)의 분기. + * **`displaySuccess`**: 뉴렐릭에 대한 로그인 성공입니다. + * **`sendSuccessMessage`**: Slack에서 완료를 확인합니다. + * **`displayError`**: 문제 해결, 해결을 위한 오류 세부정보를 기록합니다. + * **`displayUnexpected`**: 비정상적인 상태(수동 취소 등)를 기록합니다. + * **`cleanupSsmDocument`**: 임시 SSM 문서를 삭제합니다. + * **`sendSSMCleanMessage`**: Slack에서 정리를 확인합니다. + * **`workflowCompleted`**: 최종 완료 메시지(성공 또는 취소 시 실행). + + + * **항상 청소하세요.** 구조 에라스우 따라서 이전 단계가 실패하더라도 정리가 실행됩니다. 이를 통해 리소스 누출과 예상치 못한 AWS 요금을 방지할 수 있습니다. + * **일반적인 문제:** SSM이 시간 초과되면 EC2 인스턴스가 여전히 상태 간에 전환 중일 수 있습니다. 다시 실행하기 전에 AWS Console 확인하여 실제 인스턴스 상태를 확인하세요. + + + + +## 다음 단계 + +### 실행하고 관리하세요 + +* **[시작 및 일정 스텔라우](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: 수동으로 트리거하거나 자동으로 일정을 예약합니다. +* **[워크플로우 관리](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: 워크플로우를 편집, 버전화, 복제, 비활성화합니다. + +### 개선하다 + +* **[모범 사례](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 오류 처리, 비밀 관리, 성능, 테스트. +* **[작업 카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: AWS, Azure, GCP, HTTP, 데이터 변환. +* **[워크플로우 예시](/docs/workflow-automation/workflow-examples)**: 더욱 현실적인 자동화 시나리오. + +### 규모 + +* **[워크플로우 자동화 API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: 구현하다, 코드형 API 용 배포를 통해 구현됩니다. +* **[워크플로우 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: 타임아웃, 액션 제한, 페이로드 제약. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx new file mode 100644 index 00000000000..925935f0227 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx @@ -0,0 +1,164 @@ +--- +title: 흐름 흐름 자동화 관리 +tags: + - Workflow Automation + - workflow + - build a workflow using New Relic +metaDescription: 'Navigate the workflow dashboard to view, edit, duplicate, delete, and monitor workflows in New Relic.' +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +[워크플로우 자동화 대시보드는](https://onenr.io/0gR7XE8LXjo) 계정 내 모든 워크플로우를 보고, 관리하고, 모니터링할 수 있는 중앙 위치를 제공합니다. 대시보드를 사용하여 설정 편집, 버전 기록 추적, 실행 일정 관리, 오류 문제 해결 등을 수행할 수 있습니다. + +## 일반적인 작업 + +에로스우 관리 운영에 대한 빠른 접근: + +* **[View 워크플로우](#view-workflows)** - 대시보드 및 필터 흐름에 액세스합니다. +* **[편집 a 워크플로우](#edit-a-workflow)** - 설정 또는 설정 업데이트 +* **[버전 관리](#manage-versions)** - 자동 버전 관리 및 일정을 위한 고정 버전을 이해합니다. +* **[a 워크플로우 복제](#duplicate-a-workflow)** - 템플릿 수정 시 복사플로우 +* **[삭제 a 워크플로우](#delete-a-workflow)** - 워크플로우를 영구적으로 제거합니다. + +## 시작하기 전에 + +에리스우를 관리하기 전에 다음 사항을 확인하세요. + +* 자동화 액세스 권한이 있는 활동적인 뉴렐릭 계정입니다. +* 계정에 최소 하나의 파라쿠가 있어야 합니다(템플릿 또는 맞춤형). +* 워크플로우에 대한 권한 수정 및 삭제입니다. + +**워크플로우를 처음 사용하시나요?** [템플릿을 사용](/docs/workflow-automation/create-a-workflow-automation/use-a-template) 하거나 [직접 ◈◈◈를 만들어](/docs/workflow-automation/create-a-workflow-automation/create-your-own) 첫 번째 ◈◈◈를 만들어 보세요. + +## 흐름 보기 [#view-workflows] + +워크플로우 대시보드는 계정 내 모든 워크플로우를 주요 정보와 함께 표시하여 관리에 도움을 줍니다. + +### 대시보드에 접속하세요 + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 + +2. 대시보드는 다음 정보와 함께 모든 흐름을 표시합니다. + + * **이름**: 생성 시 지정한 워크플로우 블록 + * **설명**: 스텔라우의 목적 또는 기능 + * **상태**: 현재 상태(활성, 비활성, 실패) + * **버전**: 변경 사항 추적을 위한 현재 버전 번호 + * **마지막 실행**: 가장 최근 실행의 타임스탬프 + * **작성자**: 워크플로우를 만든 사용자 + +### 필터 및 검색 흐름 + +검색 및 필터 옵션을 사용하여 특정 에리스우를 찾으세요. + +* **검색창**: 에리스우 이름 또는 설명 키워드를 입력하세요 +* **상태 필터**: 활성, 비활성 또는 실패만 표시 +* **정렬 옵션**: 이름, 마지막 인물 또는 생성 날짜순으로 정렬 + +## 흐름 편집 [#edit-a-workflow] + +워크플로우 이름, 설명, 설정을 업데이트합니다. 각 스텔라우 이름 옆에 있는 추가 옵션 메뉴(세 개의 수직 점)를 통해 스텔라우 관리 옵션에 액세스하세요. + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 + +2. 목록에서 귀하의 워크플로우를 선택하세요. + +3. 흐름 흐름 세부정보를 업데이트합니다. + + * **이름**: 플로우 흐름 변경 + * **설명**: 스텔라우 목적 설명 수정 + * **설정**: 입력 볼륨, 조치, 작업 또는 논리를 조정합니다. + +4. **Save**클릭합니다. + +## 버전 관리 [#manage-versions] + +플레우스 자동화는 플레우스 정의를 업데이트할 때마다 자동으로 새 버전을 생성합니다. 이전 버전은 모두 참조용으로 제공됩니다. + +### 스케줄링을 위한 버전 고정 + +폴리스우를 예약할 때는 특정 버전에 고정해야 합니다. 이 요구 사항은 펠릭스우 정의를 업데이트하더라도 예약된 실행이 테스트된 동일한 버전을 계속 실행하도록 보장합니다. + +**시작 및 일정 에스텔라우 지원 버전 고정:** + +* 플레소우를 예약할 때 실행할 버전을 지정하세요. +* 에펠로우 실행을 수동으로 시작할 때 실행할 버전을 선택하세요. +* 기존 일정은 업데이트할 때까지 고정된 버전을 계속 사용합니다. + +이를 통해 다음을 수행할 수 있습니다. + +* 실행 일정에 영향을 주지 않고 플레소우 업데이트 +* 일정을 업데이트하기 전에 수동으로 새 버전을 테스트하세요. +* 생산 안정성 유지 + +## 흐름 흐름을 복제합니다. [#duplicate-a-workflow] + +원본을 그대로 유지하면서 템플릿이나 기존 에펠탑을 다른 용도로 조정해야 할 때 에펠탑을 복제합니다. + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 +2. 복제하려는 플레소우를 찾으세요 +3. 줄임표(세 개의 수직 점)를 클릭하세요. +4. **Duplicate** \[중복]선택 +5. 시스템은 이름에 "(복사본)"이 추가된 복사본을 생성합니다. +6. 복제된 폴리스우의 이름을 바꾸고 필요에 맞게 사용자 정의하세요. + +**일반적인 중복 시나리오:** + +* 특정 사용 사례에 맞게 엘리스우 템플릿 조정 +* 유사한 요구 사항을 가진 다른 팀을 위한 에스텔라우 만들기 +* 원본을 보존하면서 중요한 변화를 실험합니다. + + + **불필요한 중복을 피하세요.** 버전 제어나 롤백 목적으로 미스릴을 복제하지 마세요. 미스릴을 업데이트하면 시스템이 자동으로 버전을 생성합니다. 과도한 중복으로 인해 펠릭스우 한도에 도달할 수 있습니다. 자동 버전 관리에 대한 자세한 내용은 [버전 관리를](#manage-versions) 참조하세요. + + +## 워크플로 삭제 [#delete-a-workflow] + +더 이상 필요하지 않은 워크플로우를 제거하세요. + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 +2. 삭제하고 싶은 흐름을 찾으세요 +3. 더 많은 옵션 메뉴(세 개의 수직 점)를 클릭하세요. +4. **Delete** \[삭제]선택 +5. 대화 상자에서 삭제를 확인하세요 + + + 스카이우를 삭제하면 모든 버전과 실행 기록이 제거됩니다. 이 작업은 실행 취소할 수 없습니다. 나중에 에스텔라우가 필요할 경우 삭제하는 대신 비활성화하는 것을 고려하세요. + + +**삭제되는 내용:** + +* 모든 버전의 워크플로우 +* 모든 실행 기록 및 로그 +* 에펠탑과 관련된 모든 예정된 실행 + +**삭제하기 전에 다음 사항을 확인하세요.** + +* 이것에 의존하는 중요한 자동화는 없습니다. +* 나중에 필요할 경우를 대비해 백업 사본을 만들어 두십시오. +* 모든 예정된 실행이 식별되고 설명됩니다. + +## 다음 단계 + +워크플로우 대시보드에 익숙해진 후 다음 리소스를 살펴보세요. + +**실행 및 모니터링 흐름:** + +* **[시작 및 일정 흐름](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: 흐름 흐름을 수동으로 트리거하거나 자동화된 일정을 설정합니다. + +**당신의 흐름을 개선하세요:** + +* **[모범 사례](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 오류 처리, 성능 및 안정성을 위한 패턴 +* **[워크플로우 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: 시간 초과, 작업 및 페이로드 제약 조건 이해 + +**더 많은 흐름 만들기:** + +* 일반적인 시나리오를 위해 **[템플릿을 사용합니다](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: 구현하다, 배포하다 사전 구축된 흐름 +* **[나만의 블리자드 만들기](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: 처음부터 사용자 정의 자동화 구축 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx new file mode 100644 index 00000000000..c4efc17cd29 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx @@ -0,0 +1,237 @@ +--- +title: 시작 및 일정 흐름 +tags: + - workflow automation + - workflow + - start a workflow automation + - start workflow automation on demand + - schedule workflows +metaDescription: Trigger workflows manually or schedule them to run automatically at specified times using NerdGraph APIs. +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +일단 에어소프트를 생성하면 필요에 따라 수동으로 실행하거나 특정 시간에 자동으로 실행되도록 예약할 수 있습니다. 두 방법 모두 [NerdGraph API](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) 사용하여 에펠우 실행을 트리거합니다. + +## 트리거 방법을 선택하세요 + +귀하의 사용 사례에 맞는 올바른 접근 방식을 선택하세요. + +| **주문형 사용** | **예약된 사용** | +| ------------ | ------------- | +| 새로운 흐름 테스트하기 | 정기 건강 검진 | +| 수동 승인 흐름 | 주기적 데이터 처리 | +| 공지로 인한 응답 | 일일/주간 보고서 | +| 임시 유지 관리 작업 | 예정된 유지 관리 기간 | +| 일회성 작업 | 반복되는 백업 또는 정리 | + +## 시작하기 전에 + +에펠탑우를 작동시키기 전에 다음 사항을 확인하세요. + +* **생성된 워크플로우** 정의 : 이미 존재하다, 배포하다( [템플릿](/docs/workflow-automation/create-a-workflow-automation/use-a-template) 또는 [맞춤 제작](/docs/workflow-automation/create-a-workflow-automation/create-your-own) 에서). +* **계정 ID**: 귀하의 뉴렐릭 계정 ID( [계정 설정](/docs/accounts/accounts-billing/account-structure/account-id) 에서 확인 가능). +* **워크플로우 이름**: 여러분이 정의한 워크플로우의 정확한 이름입니다. +* **필수 입력 사항**: 귀하의 활동이 기대하는 모든 이벤트에 대한 값입니다. +* **구성된 비밀**: AWS 자격 증명, Slack 토큰 또는 [Secrets Manager](/docs/infrastructure/host-integrations/installation/secrets-management/) 에 저장된 기타 비밀. + + + **워크플로우를 처음 사용하시나요?** 플레소우를 발동하기 전에 먼저 플레소우를 생성하세요. 미리 만들어진 에스텔라우용 [템플릿을 사용하여](/docs/workflow-automation/create-a-workflow-automation/use-a-template) 시작하세요. + + +## 요청 시 워크플로우 실행 [#on-demand] + +[StartWorkflowRun API](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) 사용하여 수동으로 에픽스를 트리거합니다. 이렇게 하면 귀하가 제공한 입력을 통해 fl.f.u가 즉시 실행됩니다. + +### 예: AWS Lambda 함수 호출 + +다음 워크플로우 정의는 AWS Lambda 함수를 호출하고 출력을 기록합니다. `12345678` 을 뉴렐릭 계정 ID로 바꾸세요. + +```yaml + name: lambda1 + + workflowInputs: + username: + type: String + defaultValue: "User" + key: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_ACCESS_KEY_ID }}" + access: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SECRET_ACCESS_KEY }}" + token: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SESSION_TOKEN }}" + region: + type: String + defaultValue: us-east-1 + + steps: + - name: invoke1 + type: action + action: aws.lambda.invoke + version: 1 + inputs: + awsAccessKeyId: ${{ .workflowInputs.key }} + awsSecretAccessKey: ${{ .workflowInputs.access }} + awsSessionToken: ${{ .workflowInputs.token }} + region: ${{ .workflowInputs.region }} + functionName: hello-you + payload: + user: ${{ .workflowInputs.username }} + + - name: logOutput + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'The lambda function message output is:${{ .steps.invoke1.outputs.payload.body }}' +``` + +이 에펠탑우를 시작하려면 다음 NerdGraph 뮤테이션을 사용하세요. 이 변형을 실행하기 전에 `secretsManagementCreateSecret` 변형을 사용하여 AWS 자격 증명을 저장했는지 확인하세요. 자세한 내용은 [비밀 관리 소개를](/docs/apis/nerdgraph/examples/nerdgraph-secrets-management) 참조하세요. + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "Julien"} + ] + ) { + runId + } +} +``` + +**반응, 설명:** + +* `scope`: 폴리스우 정의가 저장된 계정 ID +* `definition`: 실행할 플레스코우의 이름(플레스코우 정의의 `name` 필드와 일치해야 함) +* `workflowInputs`: 플로우플로우 정의의 `workflowInputs` 섹션에 있는 기본값을 재정의하는 핵심 가치 쌍입니다. + +돌연변이는 `runId` 을 반환합니다(예: `7bd25287-2af8-42e1-b783-80f4e760a40b`). 이 ID를 사용하여 로그를 쿼리하고 출력을 확인하세요. + +Workflow automation logs showing the Lambda function output + +## 일정 흐름 [#scheduled] + +[CreateSchedule API](/docs/workflow-automation/workflow-automation-apis) 사용하여 특정 시간에 에펠탑이 자동으로 실행되도록 예약합니다. 예약된 에펠탑은 수동 개입 없이 반복 작업을 실행합니다. + +**일정을 계획하는 시기:** + +* 정기 건강 검진 +* 주기적 데이터 처리 +* 일일/주간 보고서 +* 예정된 유지 관리 기간 +* 반복되는 백업 또는 정리 + +### Cron 표현식 참조 + +일정은 피스우가 언제 실행되는지 정의하기 위해 cron 표현식을 사용합니다. 체재: `minute hour day month weekday` + +| **무늬** | **설명** | **예시 사용 사례** | +| -------------- | ----------- | ------------ | +| `0 9 * * *` | 매일 오전 9시에 | 매일 아침 건강 검진 | +| `0 9 * * 1-5` | 매주 평일 오전 9시 | 영업일 운영 | +| `0 */6 * * *` | 6시간마다 | 정기적인 동기화 작업 | +| `0 0 1 * *` | 매월 1일 자정 | 월별 보고서 | +| `*/15 * * * *` | 15분마다 | 잦은 여론조사 | +| `0 0 * * 0` | 매주 일요일 자정 | 주간 정리 작업 | + + + **Cron 구문:** `*` 은 "매"를 의미하고, `/` "n번째마다"를 의미하고, `-` "범위"를 의미합니다. 예: `0 9 * * 1-5` = 매일, 매월, 월요일부터 금요일까지, 0분, 9시. + + +### 예: 일일 건강 검진 일정을 예약하세요 + +다음 예제에서는 `lambda1` 폴리스우가 매일 오전 9시(동부 표준시)에 실행되도록 예약합니다. + +```graphql +mutation { + workflowAutomationCreateSchedule( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Configure the schedule + schedule: { + # Cron expression: minute hour day month weekday + # "0 9 * * *" = every day at 9:00 AM + cronExpression: "0 9 * * *" + + # Timezone for the schedule + timezone: "America/New_York" + + # Optional: Schedule name for identification + name: "daily-lambda-health-check" + + # Optional: Add a description + description: "Runs Lambda health check every morning at 9 AM" + } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "HealthCheckBot"} + ] + ) { + scheduleId + } +} +``` + +**당신이 얻는 것:** + +* `scheduleId`: 일정에 대한 고유 식별자(나중에 일정을 업데이트하거나 삭제하는 데 사용) + +### 일정 관리 + +일정을 만든 후: + +* **활성 일정 보기**: [워크플로우 대시보드](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs)에서 모든 예정된 실행을 확인하세요. +* **업데이트 일정**: UpdateSchedule API를 사용하여 빈도 또는 입력을 변경합니다. +* **일정 삭제**: DeleteSchedule API를 사용하여 반복 실행을 중지합니다. + +전체 API 설명서는 [에펠탑 자동화 API를](/docs/workflow-automation/workflow-automation-apis) 참조하세요. + +## 다음 단계 + +당신의 워크플로우가 달리고 있어요! 다음에 할 일은 다음과 같습니다. + +**모니터링 및 관리:** + +* **[워크플로우 관리](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: 실행 기록 보기, 로그인 확인, 문제 해결 +* **[문제 해결 에펠탑우](/docs/workflow-automation/troubleshooting)**: 일반적인 실행 문제 해결 + +**생산을 위해 최적화:** + +* **[모범 사례](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 오류 처리, 성능 및 안정성 패턴 +* **[팰리스우 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: 시간 초과 및 제약 조건 제한 이해 + +**당신의 흐름을 확장하세요:** + +* **[작업 카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: 사용 가능한 모든 통합을 살펴보세요. +* **[워크플로우 자동화 APIs](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: 프로그래밍 방식의 워크플로우 관리 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx new file mode 100644 index 00000000000..cc3d575ef6c --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx @@ -0,0 +1,284 @@ +--- +title: 템플릿을 사용하여 에스텔로우 자동화를 만듭니다. +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic + - workflow template +metaDescription: 'Jump-start your automation with pre-built workflow templates. Deploy in minutes, customize to your needs, and automate common tasks.' +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +템플릿은 Slack으로 보고서 보내기, 형태 롤백, 배포, EC2 구성 크기 조정 등 일반적인 시나리오에 대해 사전 구성된 워크플로우를 제공합니다. 몇 분 안에 구현하고 배포한 다음 팀의 프로세스에 맞게 사용자 정의하세요. + +## 왜 템플릿을 사용해야 하나요? + +* **더 빠르게 시작하기**: 구현하다, 배포하다 몇 분 만에 자동화 작업 +* **모범 사례를 따르세요**: 검증된 패턴과 오류 처리를 사용하세요 +* **예제를 통해 배우기**: 작업이 어떻게 연결되고 데이터가 어떻게 흐르는지 살펴보세요 +* **오류 감소**: 테스트된 설정으로 시작 + +## 시작하기 전에 + +대부분의 템플릿에는 자격 증명과 통합이 필요합니다. + +* **AWS 템플릿**: 권한이 있는 [AWS 자격 증명](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials) (EC2, API Gateway, Systems Manager 또는 SQS). +* **Slack 공지**: 봇과 채널 액세스가 포함된 Slack 앱입니다. +* **모든 템플릿**: 뉴베리 계정 및 부분 GUID( 모니터 리소스에 대해 고유한 섹션). + + + **아직 자격증이 없나요?** 먼저 템플릿을 탐색해 보세요. 구현하다, 배포하기 전에 자격 증명을 설정합니다. + + +## 템플릿을 구현하다, 배포하다 + + + + ### 적합한 템플릿을 찾으세요 + + 아래의 [템플릿 라이브러리를](#workflow-automation-templates) 탐색해 보세요. 각 기능은 무엇을 하는지, 언제 사용해야 하는지, 요구 사항은 무엇인지, 어떻게 작동하는지 보여줍니다. + + + + ### 구현하다, 배포하다 및 구성하다 + + 1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 + 2. **Use a Template** \[템플릿 사용을]선택하세요 + 3. 템플릿을 선택하세요 + 4. 입력 채우기(자격 증명, 분리 GUID, 쿼리, 채널) + 5. **Deploy** \[배포]를 선택하세요 + + 귀하의 워크플로우가 활성화되었습니다. + + + + ### 테스트하고 검증하세요 + + 생산에 사용하기 전에 테스트하세요: + + 1. 수동으로 트리거( [요청 시 시작플로우](/docs/workflow-automation/create-a-workflow-automation/start-schedule#on-demand) 참조) + 2. 실행 기록에서 실행 모니터링 + 3. 출력 확인(Slack 메시지, AWS 변경 사항, 로그) + 4. 오류 검토, 설정 조정 + + + **먼저 비생산 환경에서 테스트하세요.** 일부 템플릿은 인프라를 변경합니다. 실제 사용 전에 검증하세요. + + + + +## 템플릿을 사용자 정의하세요 + +형태, 배치 후 수정: + +* **조건 논리 추가**: 조건에 따라 단계 건너뛰기 +* **체인 템플릿**: 출력을 다른 플로우의 입력으로 사용합니다. +* **조정 공지**: 형식, 수신자, 채널 변경 +* **사용자 지정 작업 추가**: HTTP requests 또는 데이터 변환 포함 + +자세한 내용은 [나만의 스텔라우 만들기를](/docs/workflow-automation/create-a-workflow-automation/create-your-own) 참조하세요. + +## 문제 해결, 해결 템플릿 + +폴리스우가 실패하거나 예상대로 작동하지 않는 경우: + +1. **실행 기록 확인**: **Workflow Automation > \[귀하의 워크플로] > Run History** 으로 이동하여 실행 기록 및 오류 메시지를 확인하세요. + +2. **일반적인 문제 검토**: 다음 문제에 대한 해결 방법 [은 문제 해결, 문제 해결 흐름 자동화를](/docs/workflow-automation/troubleshooting) 참조하세요. + + * AWS 자격 증명 및 권한 오류 + * Slack 통합 문제 + * 일부 GUID 문제 + * NRQL 쿼리 실패 + * 흐름흐름 시간 초과 + * 템플릿별 문제 해결, 해결 + + + **테스트 템플릿을 안전하게 사용하세요**. 항상 먼저 비운영 환경에서 테스트하세요. 인프라를 변경하는 템플릿(EC2, API Gateway)을 잘못 구성하면 가용성에 영향을 미칠 수 있습니다. + + +## 흐름흐름 자동화 템플릿 + + + + **기능:** + + NRQL(뉴렐릭 쿼리 언어))을 사용하여 쿼리 뉴렐릭 데이터를 만들고, 결과 형식을 CSV로 지정하고 Slack에 게시합니다. + + **언제 사용해야 하나요?** + + 정기적인 보고서 자동화: 일일 성능 요약, 주간 오류율, 시간별 카트리지 볼륨 또는 관습 지표. + + **필요한 것:** + + * **Slack**: 채널 게시 권한이 있는 봇 토큰 + * **뉴렐릭**: 계정 액세스 및 유효한 NRQL 쿼리 + + **작동 방식:** + + 1. NRQL 쿼리를 실행합니다 + 2. 결과를 CSV로 변환합니다 + 3. Slack에 게시 + 4. 로그 상태 + + + + **기능:** + + 팀 승인을 받은 후 구현 및 배포 문제를 감지하고 AWS API Gateway를 이전 설정으로 롤백합니다. + + **언제 사용해야 하나요?** + + 오류가 급증하거나 통합이 중단되거나 인시던트를 유발하는 잘못된 구현을 되돌립니다. 위험성이 높은 변화에 대한 안전망. + + **필요한 것:** + + * **AWS**: API Gateway 및 Systems Manager 권한 + * **Slack**: 공지 및 승인용 앱 + * **뉴렐릭**: API Gateway 부분 GUID + + **작동 방식:** + + 1. 가져오기 구현, 배포 기록 + 2. 현재 문제와 관련이 있습니다 + 3. Slack 승인을 요청합니다 + 4. 승인되면 롤백을 실행합니다. + 5. 팀에 알리고 정리합니다. + + + **수동 승인이 필요합니다.** Slack 반응을 통한 팀 승인 없이는 롤백할 수 없습니다. + + + + + **기능:** + + CPU 또는 리소스가 급증하면 EC2 인스턴스의 크기를 자동으로 조정합니다. + + **언제 사용해야 하나요?** + + 트래픽 급증 시 CPU 스파이크를 처리하고, 한도에 도달한 인스턴스를 확장하고, 예측할 수 없는 부하 패턴을 관리합니다. + + **필요한 것:** + + * **AWS**: EC2 및 Systems Manager 권한 + * **Slack**: 공지 및 승인용 앱 + * **뉴렐릭**: 공지사항 검토 EC2, [AWS CloudWatch Metric Streams](https://docs.newrelic.com/install/aws-cloudwatch/), [EC2 모니터링 통합](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) + + + **CloudWatch Metric Streams 사용하세요.** 맞춤형 삭제스페이스를 포함하여 완전한 AWS 지표 적용 범위를 제공합니다. + + + **작동 방식:** + + 1. 공지를 가져오고 제외를 식별합니다. + 2. Slack 승인을 요청합니다 + 3. 자동화 문서를 생성합니다 + 4. 인스턴스를 중지, 수정 및 시작합니다. + 5. 진행 상황을 업데이트하고 정리합니다. + + + + **기능:** + + 외부 상태 페이지에서 JSON을 가져오고, 구성요소 상태를 구문 분석하고, 뉴렐릭에 로그인합니다. + + **언제 사용해야 하나요?** + + 제3자 의존성/종속성(결제 처리자, 인증 제공자, 데이터 서비스)을 모니터링하고 중단과 문제를 연관시키고 통합 대시보드를 생성하세요. + + **필요한 것:** + + * **API 접근**: JSON을 반환하는 공개 상태 엔드포인트 + * **뉴렐릭**: 로깅 계정 + + **작동 방식:** + + 1. 엔드포인트에서 JSON을 가져옵니다. + 2. 구성 요소 상태를 구문 분석합니다. + 3. 운영 상태를 분류합니다 + 4. 필터를 사용하여 뉴렐릭에 로그인하세요. + + + **5\~15분마다 일정을 잡아** 타사 신뢰도에 대한 과거 관점을 구축하세요. + + + + + **기능:** + + 모니터의 형상 상태 후 구현, 배포, 문제 발생 시 공지를 보냅니다. + + **언제 사용해야 하나요?** + + 구현 이후의 새 릴리스를 시청하고, 배포하고, 프로덕션 전용 문제를 감지하고, 상태 저하에 대한 롤백 현상을 유발합니다. + + **필요한 것:** + + * **뉴렐릭**: 모니터링을 위한 GUID + * **공지** (하나 또는 둘 다 선택): AWS SQS 권한 또는 HTTP webhook 포인트포인트 + + **작동 방식:** + + 1. 1\~5분마다 건강 상태를 모니터링합니다. + 2. 공지 심각도 평가 + 3. 저하 시 공지(SQS/웹훅)를 전송합니다. + 4. 모든 상태 확인 로그인 + 5. 중단 또는 복구될 때까지 계속됩니다. + + + **[변경 추적](/docs/change-tracking/change-tracking-introduction)과 함께 사용하여** 구현, 배포와 문제를 연관시킵니다. + + + + + **기능:** + + NRLens(고급 쿼리 도구)를 사용하여 뉴렐릭의 데이터 카탈로그에 대해 SQL 쿼리를 실행합니다. + + **언제 사용해야 하나요?** + + NRQL을 넘어서는 복잡한 분석: 다중 테이블 조인, 통계 분석, 메트릭/이벤트/로그를 결합한 사용자 정의 보고서. + + **필요한 것:** + + * **NRLens**: SQL 쿼리 게이트웨이 자격 증명 + * **뉴렐릭**: 조직 및 계정 ID + + **작동 방식:** + + 1. NRLens에 연결 + 2. SQL을 실행합니다 + 3. 결과를 검색합니다 + 4. 뉴렐릭으로 로그인하세요 + 5. 스케줄링 지원 + + + **NRLens는 NRQL을 확장합니다.** 쿼리 쿼리에는 NRQL 사용하고, 복잡한 분석 워크로드에는 NRLens SQL을 사용하세요. + + + + +## 다음 단계 + +### 실행하고 관리하세요 + +* **[시작 및 일정 스텔라우](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: 수동으로 트리거하거나 자동으로 일정을 예약합니다. +* **[워크플로우 관리](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: 워크플로우 편집, 복제, 제거 + +### 맞춤형 빌드 + +* **[나만의 스카이우 만들기](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: 사용자 정의 로직으로 처음부터 구축 +* **[모범 사례](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 안정적이고 생산에 바로 적용 가능한 자동화를 위한 패턴 + +### 규모 + +* **[워크플로우 자동화 API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: 연속 통합/연속 배포(CI/CD) 또는 코드형 통합과 통합 +* **[팰런티우 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: 시간 초과, 속도 제한, 제약 조건 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/introduction-to-workflow.mdx b/src/i18n/content/kr/docs/workflow-automation/introduction-to-workflow.mdx new file mode 100644 index 00000000000..b154276d7e0 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/introduction-to-workflow.mdx @@ -0,0 +1,148 @@ +--- +title: 흐름흐름 자동화 소개 +tags: + - workflow automation + - workflow + - automation +metaDescription: Automate routine tasks and incident responses with Workflow Automation in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +워크플로우 자동화는 뉴럴릭을 기존 도구와 연결하여 코드를 작성하지 않고도 인시던트 대응, 집계 관리 및 운영 작업을 자동화합니다. 알림에 응답하고, AWS 및 Slack과 통합하고, 승인을 관리하고, 복잡한 자동화 로직을 실행하는 에라스우를 구축합니다. + +Screenshot showing the workflow automation interface + +## 주요 이점 + +* **더 빠른 인시던트 대응**: 알림 실행 시 자동으로 EC2 크기 조정, 구현 롤백, 배포 또는 서비스 재시작 - 수동 개입이 필요하지 않습니다. +* **도구 연결**: AWS, Slack, Jira, ServiceNow 및 모든 HTTP API 와 통합하여 팀이 작업하는 곳으로 풍부한 공지 데이터를 전송하세요. +* **승인 게이트 추가**: 중요한 에펠로우에 인적 감독 포함 - 프로덕션 확장 또는 롤백 실행 전에 팀 확인 요청 +* **복잡성 처리**: 조건 논리, 루프 및 데이터 변환을 사용하여 고유한 운영 프로세스를 자동화합니다. + +## 일반적인 사용 사례 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 범주 + + 예 +
+ **인시던트 대응** + + 문제 자동 해결, 실패한 구현 롤백, 배포, 알림을 기반으로 크기 조정. +
+ **인프라 관리** + + 일정에 따라 서비스를 확장하고, AWS 리소스를 관리하고, 런북을 자동으로 실행합니다. +
+ **알림** + + Slack에 풍부한 알림을 보내고, 예약된 보고서를 생성하고, 데이터를 CSV 형식으로 지정합니다. +
+ **통합** + + 모든 API 에 연결하고, 시스템 간에 데이터를 동기화하고, 지원포켓 플랫폼을 업데이트하세요. +
+ +자세한 시나리오와 바로 사용 가능한 템플릿을 보려면 [워크플로우 예제](/docs/workflow-automation/workflow-examples) 페이지를 탐색하세요. + +## 시작하다 + +무엇을 만들고 싶은지에 따라 경로를 선택하세요: + + + + 템플릿 사용 커스텀 워크플로우 구축 통합 설정 + + + + + 구현하다, 배포하다 일반적인 시나리오에 대해 사전 구성된 레이아웃 흐름—Slack에 보고서 보내기, 구현 롤백, 배포, EC2 참여 크기 조정 등. + + 1. [사용 가능한 템플릿](/docs/workflow-automation/create-a-workflow-automation/use-a-template)찾아보기 + 2. 사용 사례에 맞는 템플릿을 선택하세요 + 3. 입력 구성(자격 증명, 분리 GUID, 쿼리) + 4. 구현하다, 배포하다 및 테스트 + + + + 드래그 앤 드롭 인터페이스를 사용하여 처음부터 파라다이스우를 만들어 보세요. 작업을 체인화하고, 조건 논리를 추가하고, 도구와 통합하세요. + + 1. [EC2 자동 크기 조정 예제를](/docs/workflow-automation/create-a-workflow-automation/create-your-own)검토하세요 + 2. 아리스토우 패턴(스위치, 루프, 승인)을 이해하세요 + 3. 사용 가능한 [작업](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)찾아보기 + 4. 점진적으로 구축하고 각 단계를 테스트하세요 + + + + 자격 증명 및 공지 채널을 구성하여 외부 서비스와 상호 작용할 수 있습니다. + + **AWS 흐름 흐름**: [AWS 자격 증명(IAM 역할, 사용자 또는 세션)을 설정합니다](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials) . + + **공지**: [목적지 생성](/docs/workflow-automation/setup-and-configuration/create-destinations) (Slack, 이메일, 웹훅) + + + + +## 다음 단계 + +첫 번째 폴리스우를 만든 후 관리 및 최적화 방법을 알아보세요. + + + + * **[시작 및 일정 에펠탑우](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: 수동으로 트리거하거나 Cron 표현식을 사용하여 반복 실행을 설정합니다. + * **[워크플로우 관리](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: 설정 편집, 환경별 복제, 실행 이력 조회 + + + + * **[문제 해결, 해결](/docs/workflow-automation/troubleshooting)**: 자격증명 오류, 통합 문제, 워크플로우 실패 수정 + * **[모범 사례](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 오류 처리, 성능 최적화, 테스트 전략 + * **[팰리스우 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: 시간 초과, 속도 제한 및 제약 조건 이해 + + + + * **[작업 카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: 사용 가능한 모든 AWS, 뉴렐릭 및 HTTP 작업 찾아보기 + * **[워크플로우 예시](/docs/workflow-automation/workflow-examples)**: 실제 자동화 시나리오에서 배우기 + * **[워크플로우 APIs](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: 연속 통합/연속 배포(CI/CD) 통합을 위해 프로그래밍 방식으로 워크플로우 관리 + + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx b/src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx new file mode 100644 index 00000000000..a8e4706ec52 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx @@ -0,0 +1,326 @@ +--- +title: 워크플로우 자동화 특징 +tags: + - Workflow Automation + - workflow + - best practices + - workflow automation best practices +metaDescription: 'Build reliable, maintainable workflows that handle errors gracefully and scale with your operations.' +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +오류를 원활하게 처리하고, 중요한 데이터를 보호하고, 운영에 맞춰 확장 가능한 안정적인 디즈니우를 구축하세요. 유지 관리 가능한 자동화를 만들려면 다음 패턴을 따르세요. + +## 디자인 중심의 흐름 + +폴리스우 하나의 책임에 집중하세요. 관련된 작업은 함께 그룹화하지만, 관련 없는 작업은 결합하지 마십시오. + +### 하나의 흐름, 하나의 목적 + +**해야 할 일**: 인시던트 대응과 예정된 점검을 위해 별도의 워크플로우를 생성합니다. **하지 말아야 할 것**: EC2 크기 조정, 데이터베이스 백업, Slack 공지를 하나의 꽃흐름으로 결합하세요. + +### 활동을 통해 활동을 재사용하세요. + +활동 커뮤니티를 복제하는 대신 여러 환경에서 재사용이 가능하도록 하려면 입력 규칙을 사용하세요. + +**예**: 지역 및 참여 유형이 포함된 EC2 크기 조정 활동, 실행: + +```yaml +inputs: + awsRegion: us-east-1 + instanceType: t3.medium + instanceId: i-1234567890abcdef0 +``` + +이는 지역별로 별도의 플로우를 생성하는 것을 대체합니다. + +### 관련 작업 결합 + +함께 실행해야 하는 그룹 관련 작업: + +* **Do**: 공지 쿼리 내용, 메시지 포맷, Slack으로 한 번에 보내기 +* **하지 말아야 할 것**: "쿼리 공지", "메시지 형식 지정", "Slack으로 보내기"에 대해 별도의 워크플로우를 생성하세요. + +## 오류 처리 + +외부 API 호출과 중요한 작업에 대한 오류 처리를 항상 포함하세요. + +### 대체 작업 추가 + +중요한 단계가 실패할 가능성이 있는 경우 팀에 알리는 대체 작업을 추가하세요. + +**예**: `ignoreErrors` 사용하여 단계가 실패하더라도 Slack 공지를 보냅니다. + +```yaml +- name: sendNotification + type: action + action: aws.execute.api + version: 1 + ignoreErrors: true + inputs: + service: sqs + api: send_message + parameters: + MessageBody: "Rollback notification" + QueueUrl: "${{ .workflowInputs.queueUrl }}" + +- name: logResult + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Notification sent: ${{ .steps.sendNotification.outputs.success }}" +``` + +단계가 실패하더라도 플레우스 실행을 계속하려면 `ignoreErrors: true` 사용하세요. + +### 적절한 시간 초과를 설정하세요 + +외부 API 호출에 대한 시간 제한을 설정하여 플로우가 중단되는 것을 방지합니다. + +* AWS API 호출: 30-60초 +* 데이터베이스 쿼리: 10\~30초 +* HTTP requests: 15-30초 +* Slack 메시지: 10초 + +### 문제 해결, 해결에 대한 로그 오류 + +오류 로그에 다음 세부 정보를 포함합니다. + +* 실패한 작업 +* 입력스피커, 변수 +* 서비스에서 발생한 오류 메시지 +* 시간소인 + +## 보안 자격 증명 + +모든 민감한 정보는 뉴렐릭의 비밀 관리자에 저장하세요. 폴리스우 정의에 자격 증명을 하드코딩하지 마세요. + +### 비밀 관리자 사용 + +AWS 자격 증명, API 토큰 및 비밀번호를 저장합니다. + +```graphql +mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } +} +``` + +참고 비밀: `${{ :secrets:awsAccessKeyId }}` + +### 자격 증명을 정기적으로 교체하세요 + +IAM 사용자 액세스 키를 사용하는 경우: + +* 최소 90일마다 회전 +* 캘린더 알림 설정 +* 이전 자격 증명을 삭제하기 전에 새 자격 증명을 테스트하세요. + +**권장 사항**: 대신 IAM 역할을 사용하세요. 역할은 자동으로 순환됩니다. + +### 최소 권한 사용 + +필요한 권한만 부여하세요. 읽기 전용으로 시작해서 필요할 때만 쓰기 권한을 추가하세요. + +SQS에 대한 **AWS IAM 정책 예** : + +```json +{ + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-queue" +} +``` + +이렇게 하면 특정 대기열에만 액세스할 수 있습니다. + +## 생산 전 테스트 + +구현하기 전에 비운영 환경에서 테스트 흐름을, 프로덕션으로 배포합니다. + +### 테스트를 위해 복제 + +프로덕션의 테스트 버전을 생성합니다. + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동하세요. +2. 스텔라우를 찾아 더 많은 옵션 메뉴를 클릭하세요 +3. **Duplicate** \[중복]선택 +4. 테스트 계정을 사용하려면 자격 증명을 업데이트하세요. +5. 비생산 리소스로 테스트 + +### 테스트 실패 시나리오 + +워크플로우 핸들 실패 확인: + +* AWS API를 사용할 수 없는 경우는 어떻게 되나요? +* Slack이 다운되면 어떻게 되나요? +* 자격 증명이 만료되면 어떻게 되나요? +* 필요한 리소스가 존재하지 않으면 어떻게 되나요? + +### 통합 확인 + +일정을 예약하기 전에 스텔라우를 수동으로 트리거하고 다음을 확인하세요. + +* AWS 작업이 성공적으로 실행되었습니다. +* Slack 메시지가 올바른 채널에 표시됩니다. +* 승인 게이트는 응답을 기다립니다. +* 오류 처리가 예상대로 작동합니다. + +## 성능 최적화 + +빠르게 실행되는 효율적인 에펠탑을 구축하세요. + +### 한 번 쿼리하고 결과 재사용 + +쿼리 결과를 저장하고 여러 번 참조합니다. + +```yaml +- name: getAlertDetails + action: newrelic.nerdgraph.execute + +- name: sendToSlack + inputs: + text: "${{ .steps.getAlertDetails.outputs.data }}" + +- name: updateJira + inputs: + body: "${{ .steps.getAlertDetails.outputs.data }}" +``` + +**하지 말아야 할 것**: Slack과 Jira에 대한 세부 정보를 별도로 쿼리하는 것입니다. + +## 모니터링 및 유지 관리 + +정기적으로 워크플로우 실행을 모니터링하고 업데이트를 유지합니다. + +### 매주 실행 내역 확인 + +검토 흐름이 실행됩니다: + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동하세요. +2. 흐름을 선택하세요 +3. **Run history** \[실행 기록을]클릭하세요 +4. 실패한 실행이나 증가하는 실행 시간을 찾으세요. + +### 실패 알림 설정 + +흐름 흐름 실패에 대한 알림 구성: + +1. 워크플로우 실행 실패에 대한 공지사항 생성 +2. 팀의 기본 채널로 공지 보내기 +3. 에리스우 이름 및 오류 세부 정보 포함 + +### 분기별 흐름 검토 + +반복되는 일정 알림을 다음으로 설정하세요. + +* 사용하지 않는 흐름 제거 +* 만료되는 자격 증명 업데이트 +* 통합 서비스가 API를 변경하지 않았는지 확인하세요. +* 테스트 실패 시나리오 +* 문서 업데이트 + +## 문서 흐름 + +워크플로우를 이해하기 쉽게 만드세요. + +### 기술 이름 사용 + +* **수행**: "높은 CPU 알림에 대한 EC2 자동 크기 조정" +* **하지 마세요**: "워크플로우 1" 또는 "EC2 Automation" + +### 명확한 설명을 작성하세요 + +무엇, 언제, 누구에 대해 설명하세요: + +``` +Automatically resizes EC2 instances when CPU exceeds 90% for 10 minutes. +Requires approval via Slack before executing changes. +Owner: DevOps Team (devops@example.com) +Last updated: 2025-01-26 +``` + +### 복잡한 논리에 대한 주석을 추가합니다. + +조건 논리나 루프를 사용할 때 논리를 설명하세요. + +```yaml +- name: checkCPU + # Query CPU for last 10 minutes to avoid false positives + type: action + action: newrelic.nerdgraph.execute + version: 1 + +- name: decideAction + # If CPU > 90%: resize, 70-90%: warn, < 70%: no action + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.result > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.result > 70 }}" + next: sendWarning + next: noAction +``` + +## 보안 + +에펠우와 그들이 접근하는 자원을 보호하세요. + +### 파괴적인 작업에 승인 게이트를 사용하세요 + +다음 사항에 대해 인간의 승인이 필요합니다. + +* 리소스 삭제 +* 생산 서비스 축소 +* 롤백 구현, 배포 +* IAM 권한 수정 + +### 감사 흐름 변화 + +버전 기록을 사용하여 변경 사항을 추적하세요. + +1. 흐름흐름 자세히 보러가기 +2. **Version history** \[버전 기록을]클릭하세요 +3. 변경 사항과 변경 사항을 만든 사람을 검토하세요 + +### 흐름 흐름 액세스 제한 + +권한이 있는 팀원만 스텔라우를 편집할 수 있도록 하세요. + +1. 계정 설정에서 사용자 역할 검토 +2. DevOps 팀에 대한 편집 권한 제한 +3. 프로덕션과 테스트에 별도의 계정을 사용하세요 + +## 다음 단계 + +**한계를 이해하세요:** + +* **[워크플로우 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits)** - 타임아웃, 액션, 페이로드 제약 + +**문제 해결:** + +* **[문제 해결, 해결](/docs/workflow-automation/troubleshooting)** - 일반적인 문제에 대한 해결 방법 + +**예를 참조하세요:** + +* **[워크플로우 예제](/docs/workflow-automation/workflow-examples)** - 실제 자동화 시나리오 + +**흐름 관리:** + +* **[워크플로우 관리](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)** - 편집, 복제, 모니터 흐름 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx b/src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx new file mode 100644 index 00000000000..7e7f398ae5b --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx @@ -0,0 +1,201 @@ +--- +title: 흐름 흐름 자동화 한계 +metaDescription: 'For New Relic Workflow automation, explanations of the Workflow automation limits.' +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 뭐 + + 민 + + 최대 +
+ 작업 출력 크기 + + + + 100KB +
+ 작업 재시도 시도 + + + + 삼 +
+ 흐름흐름 정의 전체 단계 + + 1 + + 도면 1 +
+ 흐름흐름 정의 크기 + + + + 50KB +
+ 워크플로우 정의 수 + + + + 1000 +
+ 흐름흐름 지속시간 + + + + 7 일 +
+ 흐름흐름 총 실행 단계 + + + + 5000 +
+ 일정 수 + + + + 10 +
+ 워크플로우 입력값의 길이 + + + + 1000자 +
+ 흐름흐름 동시 실행(계정당) + + + + 30 +
+ 신호 입력 크기 + + + + 10KB +
+ 스위치 단계의 조건 수 + + + + 10 +
+ 대기 단계의 신호 수 + + + + 10 +
+ +## 다음은 뭐지? + +당신은 기술적 경계를 이해합니다. 이제 규모에 맞게 폴리스우를 관리하는 프로그래밍 방식을 살펴보세요. + +**여정의 다음 단계**: [폴리스우 자동화 API](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api) - 폴리스우를 프로그래밍 방식으로 생성, 관리 및 실행하는 방법을 알아보세요. + +**추가 자료**: + +* [작업 카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) - 모든 작업에 대한 완전한 참조 +* [모범 사례](/docs/workflow-automation/limitations-and-faq/workflow-best-practices) - 리뷰 최적화 기술 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx new file mode 100644 index 00000000000..8d67401abd8 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx @@ -0,0 +1,41 @@ +--- +title: 작업 카탈로그 개요 +tags: + - workflow automation + - workflow + - workflow automation actions + - actions catalog +metaDescription: List of available actions catalog for workflow definition +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +뉴렐릭 작업 카탈로그는 통합 및 통합에 대해 수행할 수 있는 작업을 제공합니다. cloud 공급자와 뉴스 계정에서 작업을 수행하는 작업을 연결하여 종단 간 프로세스를 조율하고 자동화할 수 있습니다. + +## 사용 가능한 작업 카탈로그 [#available-catalogs] + +다음 작업 카탈로그는 폴리스우 자동화에 사용할 수 있습니다. + +* [AWS 작업](/docs/workflow-automation/setup-and-configuration/actions-catalog/aws) - Lambda, EC2 및 Systems Manager를 포함한 AWS 서비스와 통합 +* [커뮤니케이션 활동](/docs/workflow-automation/setup-and-configuration/actions-catalog/communication) - 다양한 커뮤니케이션 채널을 통해 공지 및 메시지 전송 +* [HTTP 작업](/docs/workflow-automation/setup-and-configuration/actions-catalog/http) - 외부 API 및 서비스에 HTTP requests 하기 +* [뉴렐릭 작업](/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic) - 뉴렐릭 플랫폼 기능 및 데이터와 상호작용합니다. +* [PagerDuty 작업](/docs/workflow-automation/setup-and-configuration/actions-catalog/pagerduty) - PagerDuty 인시던트 및 통합 관리 +* [유틸리티 작업](/docs/workflow-automation/setup-and-configuration/actions-catalog/others) - 공통 데이터 변환 및 유틸리티 작업 수행 + +## 다음은 뭐지? + +사용 가능한 모든 작업을 살펴보았습니다. 이제 이것들을 모아서 첫 번째 폴리스우를 만들 차례입니다. + +**다음 여정**: [클리플로우 관리](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) - 뉴렐릭에서 플로우플로우를 만들고, 관리하고, 실행하는 방법을 알아보세요. + +**빌드 시작**: + +* [워크플로우 템플릿 사용](/docs/workflow-automation/create-a-workflow-automation/use-a-template) - 사전 구축된 워크플로우로 빠른 시작 +* [나만의 워크플로우 만들기](/docs/workflow-automation/create-a-workflow-automation/create-your-own) - 처음부터 커스텀 플로우를 만들어 보세요. \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx new file mode 100644 index 00000000000..2887c2986a6 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx @@ -0,0 +1,704 @@ +--- +title: 커뮤니케이션 작업 +tags: + - workflow automation + - workflow + - workflow automation actions + - communication actions + - slack actions + - ms teams actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +이 페이지에서는 fl.flo 자동화 작업 카탈로그에서 사용 가능한 통신 작업에 대한 포괄적인 참조를 제공합니다. 이러한 작업을 통해 Slack 채널에 메시지를 보내고, 반응을 검색하는 등 커뮤니케이션 플랫폼을 팰팍우 정의에 통합할 수 있습니다. + +## 전제 조건 + +블리자드 자동화에서 통신 작업을 사용하기 전에 다음 사항이 있는지 확인하세요. + +* 적절한 권한이 있는 Slack 작업 공간. +* 흐름 자동화에서 비밀로 구성된 Slack 봇의 의미입니다. +* 메시지를 보내고 싶은 Slack 채널에 접속합니다. + +Slack 통합을 설정하는 방법에 대한 자세한 내용은 [Slack 구성 추가를](/docs/autoflow/overview#add-the-slack-integration) 참조하세요. + +## 사용 가능한 커뮤니케이션 작업 + +플랫폼별 모든 커뮤니케이션 작업에 대한 빠른 참조: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 플랫폼 + + 동작 + + 목적 +
+ **느슨하게** + + [메시지 게시](#slackchatpostmessage) + + 선택적으로 파일을 첨부하여 Slack 채널에 메시지를 보냅니다. +
+ **느슨하게** + + [반응을 얻으세요](#slackchatgetreactions) + + Slack 메시지에서 이모티콘 반응을 검색합니다. +
+ +## 슬랙 동작 + + + + 선택적으로 파일을 첨부하여 Slack 채널로 메시지를 보냅니다. + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 예시 +
+ **토큰** + + 필수의 + + 비밀 + + `${{ :secrets:slackToken }}` +
+ **채널** + + 필수의 + + 끈 + + `my-slack-channel` +
+ **텍스트** + + 필수의 + + 끈 + + `Hello World!` +
+ **스레드** + + 선택 과목 + + 끈 + + `.` +
+ **부착** + + 선택 과목 + + 지도 + +
+ **첨부 파일 이름** + + 필수의 + + 끈 + + `file.txt` +
+ **첨부 파일.내용** + + 필수의 + + 끈 + + `Hello\nWorld!` +
+ + + * **token**: 사용할 Slack 봇 토큰입니다. 이것은 비밀 구문으로 전달되어야 합니다. 토큰을 설정하는 방법에 대한 지침은 [Slack 구성 추가](/docs/autoflow/overview#add-the-slack-integration) 를 참조하세요. + * **channel**: 메시지를 보낼 채널의 이름 또는 채널ID입니다. 자세한 내용은 [Slack API를](https://api.slack.com/methods/chat.postMessage#arg_channel/) 참조하세요. + * **text**: 지정된 `channel` 에 Slack에 게시할 메시지입니다. + * **threadTs**: 부모 메시지에 속하는 타임스탬프로, 스레드에서 메시지 회신을 생성하는 데 사용됩니다. + * **attachment**: 지정된 `channel` 에 메시지가 포함된 파일을 첨부할 수 있습니다. + * **attachment.filename**: Slack에 업로드된 파일의 파일 이름을 지정합니다. + * **attachment.content**: 업로드할 파일의 내용은 UTF8입니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 예시 +
+ **스레드** + + 끈 + + `.` +
+ **채널ID** + + 끈 + + `` +
+ + + * **threadTs**: 메시지의 타임스탬프. 스레드에 답변을 게시하기 위해 향후 postMessage 호출에 사용될 수 있습니다. + * **channelID**: 메시지가 게시된 채널의 ID입니다. + + + + + **예 1: Slack 채널에 메시지 게시** + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: SendMessage + + steps: + - name: send_slack_message + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: ${{ .workflowInputs.channel }} + text: ${{ .workflowInputs.text }} + ``` + + **예상 입력:** + + ```json + { + "inputs": [ + { + "key" : "channel", + "value" : "my-channel" + }, + { + "key" : "text", + "value" : "This is my message *with bold text* and `code backticks`" + } + ] + } + ``` + + **예상 출력:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + **예 2: 파일 첨부** + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: SendFileMessage + + steps: + - name: postCsv + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: my-channel + text: "Please find the attached file:" + attachment: + filename: 'file.txt' + content: "Hello\nWorld!" + ``` + + **예상 출력:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + + + + + + + + Slack 채널에서 메시지에 대한 반응을 받아보세요. + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 예시 +
+ **토큰** + + 필수의 + + 비밀 + + `${{ :secrets:slackToken }}` +
+ **채널ID** + + 필수의 + + 끈 + + `C063JK1RHN1` +
+ **시간 초과** + + 선택 과목 + + 정수 + + 60 +
+ **스레드** + + 필수의 + + 끈 + + `.` +
+ **선택기** + + 선택 과목 + + 목록 + + `[{\"name\": \"reactions\", \"expression\": \".reactions \"}]` +
+ + + * **token**: 사용할 Slack 봇 토큰입니다. 이것은 비밀 구문으로 전달되어야 합니다. 토큰을 설정하는 방법에 대한 지침은 [Slack 구성 추가](/docs/autoflow/overview#add-the-slack-integration) 를 참조하세요. + * **channelID**: 메시지 반응을 얻기 위한 channelID입니다. + * **timeout**: 반응을 기다리는 시간(초)입니다. 기본값은 60초이고, 최대 허용 시간은 600초(10분)입니다. + * **threadTs**: 메시지에 속한 타임스탬프로, 해당 메시지에 대한 반응을 얻는 데 사용됩니다. + * **selectors**: 지정된 유일한 델파이를 출력으로 가져오는 선택기입니다. + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 예시 +
+ **반응** + + 목록 + + `` +
+ + + * **reactions**: 캡처된 모든 반응이 포함된 요소 목록이거나 시간 초과가 발생한 경우 비어 있는 목록입니다. + + + + + **예 1: Slack에서 반응 얻기** + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: GetReactions + + steps: + - name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channelID: ${{ .steps.promptUser.outputs.channelID }} + threadTs: ${{ .steps.promptUser.outputs.threadTs }} + timeout: ${{ .workflowInputs.timeout }} + selectors: ${{ .workflowInputs.selectors }} + ``` + + **예상 입력:** + + ```json + { + "inputs": [ + { + "key" : "channelID", + "value" : "C063JK1RHN1" + }, + { + "key" : "threadTs", + "value" : "1718897637.400609" + }, + { + "key" : "selectors", + "value" : "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" + } + ] + } + ``` + + **예상 출력:** + + ```json + [ + { + "name": "grinning", + "users": [ + "W222222" + ], + "count": 1 + }, + { + "name": "question", + "users": [ + "W333333" + ], + "count": 1 + } + ] + ``` + + 또는 시간이 초과된 경우: + + ```json + [] + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx new file mode 100644 index 00000000000..274e1db0cb1 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx @@ -0,0 +1,1103 @@ +--- +title: HTTP 동작 +tags: + - workflow automation + - workflow + - workflow automation actions + - HTTP actions +metaDescription: A list of available HTTP actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +이 페이지에서는 fl.flo 자동화 작업 카탈로그에서 사용할 수 있는 HTTP 작업에 대한 포괄적인 참조를 제공합니다. 이러한 작업을 통해 폴리스우 정의의 일부로 외부 API 및 서비스에 대한 HTTP requests (GET, POST, PUT, DELETE)을 수행할 수 있습니다. + +## 전제 조건 + +블리자드 자동화에서 HTTP 작업을 사용하기 전에 다음 사항이 있는지 확인하세요. + +* 부채, 목표 API 포인트 포인트 URL. +* 필요한 인증 자격 증명(API 키, 토큰 등) +* API 요청/응답 형식에 대한 이해. + + + HTTP 액션은 모든 헤더 값에 대해 비밀 구문을 지원하므로 API 키와 같은 민감한 데이터를 안전하게 전달할 수 있습니다. 자세한 내용은 [비밀 관리를](/docs/infrastructure/host-integrations/installation/secrets-management/) 참조하세요. + + +## 사용 가능한 HTTP 작업 + +모든 HTTP 동작에 대한 빠른 참조: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 동작 + + 목적 +
+ [GET 요청](#httpget) + + API 엔드포인트에서 데이터를 검색합니다. +
+ [POST 요청](#httppost) + + API 엔드포인트로 데이터를 보냅니다. +
+ [PUT 요청](#httpput) + + API 엔드포인트에서 데이터를 업데이트합니다. +
+ [삭제 요청](#httpdelete) + + API 엔드포인트에서 데이터를 삭제합니다. +
+ +## HTTP 동작 + + + + API 엔드포인트에서 데이터를 검색하려면 HTTP GET 호출을 수행합니다. + + + 이는 모든 헤더 값에 대한 비밀 구문을 지원합니다. + + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 설명 +
+ **URL** + + 필수의 + + 문자열 + + 요청에 대한 타겟 URL입니다. 계획에는 다음이 포함되어야 합니다. + + `https://example.com` +
+ **url 매개변수** + + 선택 과목 + + 지도 + + URL에 추가하려면 쿼리를 수행해야 합니다. 문자열화된 JSON 객체를 사용합니다. +
+ **헤더** + + 선택 과목 + + 지도 + + 요청에 추가할 헤더입니다. 문자열화된 JSON 객체를 사용합니다. +
+ **선택기** + + 선택 과목 + + 목록 + + 지정된 음색만 출력으로 가져오는 선택기입니다. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 설명 +
+ **응답 본문** + + 문자열 + + 응답의 본문. +
+ **상태 코드** + + 정수 + + 응답의 HTTP 상태 코드입니다. +
+ + + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: httpGetTest + description: 'Performs an HTTP GET request to retrieve data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + steps: + - name: query + type: action + action: http.get + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + next: end + ``` + + **입력 예시:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}" + } + ``` + + **출력 예시:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + + + API 엔드포인트에 데이터를 전송하기 위해 HTTP POST 호출을 수행합니다. + + + 이는 모든 헤더 값에 대한 비밀 구문을 지원합니다. + + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 설명 +
+ **URL** + + 필수의 + + 문자열 + + 요청에 대한 타겟 URL입니다. 계획에는 다음이 포함되어야 합니다. + + `https://example.com` +
+ **url 매개변수** + + 선택 과목 + + 지도 + + URL에 추가하려면 쿼리를 수행해야 합니다. 문자열화된 JSON 객체를 사용합니다. +
+ **헤더** + + 선택 과목 + + 지도 + + 요청에 추가할 헤더입니다. 문자열화된 JSON 객체를 사용합니다. +
+ **몸** + + 선택 과목 + + 문자열 + + 요청 본문. +
+ **선택기** + + 선택 과목 + + 목록 + + 지정된 음색만 출력으로 가져오는 선택기입니다. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 설명 +
+ **응답 본문** + + 문자열 + + 응답의 본문. +
+ **상태 코드** + + 정수 + + 응답의 HTTP 상태 코드입니다. +
+ + + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: httpPostTest + description: 'Performs an HTTP POST request to send data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + steps: + - name: query + type: action + action: http.post + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + next: end + ``` + + **입력 예시:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}" + } + ``` + + **출력 예시:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + API 엔드포인트에서 데이터를 업데이트하기 위해 HTTP PUT 요청을 수행합니다. + + + 예를 들어 `Api-Key` 헤더와 같이 민감한 데이터를 입력에 전달해야 하는 경우 [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) NerdGraph 뮤테이션을 통해 저장된 값을 사용할 수 있습니다. + + 예시: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 설명 +
+ **URL** + + 필수의 + + 문자열 + + 요청에 대한 타겟 URL입니다. URL에는 스키마(예: https:// 또는 http://)가 포함되어야 합니다. 예: + + `https://example.com` +
+ **url 매개변수** + + 선택 과목 + + 지도 + + URL에 추가하려면 쿼리를 수행해야 합니다. 문자열화된 JSON 객체를 사용합니다. +
+ **헤더** + + 선택 과목 + + 지도 + + 요청에 추가할 헤더입니다. 문자열화된 JSON 객체를 사용합니다. +
+ **몸** + + 선택 과목 + + 문자열 + + 요청 본문. +
+ **선택기** + + 선택 과목 + + 목록 + + 지정된 음색만 출력으로 가져오는 선택기입니다. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 설명 +
+ **응답 본문** + + 문자열 + + 응답의 본문. +
+ **상태 코드** + + 정수 + + 응답의 HTTP 상태 코드입니다. +
+ + + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: httpPutTest + description: 'Performs an HTTP PUT request to update data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.put + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **입력 예시:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **출력 예시:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + API 엔드포인트에서 데이터를 제거하기 위해 HTTP DELETE 요청을 수행합니다. + + + 예를 들어 `Api-Key` 헤더와 같이 민감한 데이터를 입력에 전달해야 하는 경우 [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) NerdGraph 뮤테이션을 통해 저장된 값을 사용할 수 있습니다. + + 예시: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 설명 +
+ **URL** + + 필수의 + + 문자열 + + 요청에 대한 타겟 URL입니다. URL에는 스키마(예: https:// 또는 http://)가 포함되어야 합니다. 예: + + `https://example.com` +
+ **url 매개변수** + + 선택 과목 + + 지도 + + URL에 추가하려면 쿼리를 수행해야 합니다. 문자열화된 JSON 객체를 사용합니다. +
+ **헤더** + + 선택 과목 + + 지도 + + 요청에 추가할 헤더입니다. 문자열화된 JSON 객체를 사용합니다. +
+ **선택기** + + 선택 과목 + + 목록 + + 지정된 음색만 출력으로 가져오는 선택기입니다. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 설명 +
+ **응답 본문** + + 문자열 + + 응답의 본문. +
+ **상태 코드** + + 정수 + + 응답의 HTTP 상태 코드입니다. +
+ + + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: httpDeleteTest + description: 'Performs an HTTP DELETE request to remove data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.delete + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **입력 예시:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **출력 예시:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx new file mode 100644 index 00000000000..ecfd8e7fba4 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx @@ -0,0 +1,1210 @@ +--- +title: 뉴렐릭 액션 +tags: + - workflow automation + - workflow + - workflow automation actions + - New relic actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +이 페이지는 폴리스우 자동화 작업 카탈로그에서 사용할 수 있는 뉴렐릭 작업에 대한 포괄적인 참조를 제공합니다. 이러한 작업을 사용하면 커스텀 대시보드 및 로그 보내기, NerdGraph 쿼리 실행, NRQL 쿼리 실행, 공지 보내기 등의 워크플로우 정의에 워크플로우 정의에 통합할 수 있습니다. + +## 전제 조건 + +블로우 자동화에서 뉴렐릭 작업을 사용하기 전에 다음 사항이 있는지 확인하세요. + +* 적절한 권한이 있는 뉴렐릭 계정. +* 뉴렐릭 클러스터 키(데이터를 다른 계정으로 보내는 경우). +* 사용하려는 특정 뉴렐릭 서비스에 필요한 권한입니다. + +블루렐릭 계정 키를 생성하고 관리하는 방법에 대한 자세한 내용은 [볼륨 키를](/docs/apis/intro-apis/new-relic-api-keys/#license-key) 참조하세요. + +## 사용 가능한 뉴렐릭 작업 + +카테고리별 모든 뉴렐릭 작업에 대한 빠른 참조: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 범주 + + 동작 + + 목적 +
+ **데이터 수집** + + [맞춤형 대시보드 보내기](#newrelicingestsendevents) + + 커스텀 대시보드를 뉴렐릭에게 보내세요. +
+ **데이터 수집** + + [로그 보내기](#newrelicingestsendlogs) + + 뉴렐릭에게 로그인 데이터를 보냅니다. +
+ **너드그래프** + + [GraphQL 쿼리 또는 뮤테이션 실행](#newrelicnerdgraphexecute) + + NerdGraph API에 대해 GraphQL 명령을 실행합니다. +
+ **질문** + + [NRDB 쿼리 실행](#newrelicnrdbquery) + + 여러 계정의 NRQL 쿼리를 실행합니다. +
+ **알림** + + [공지 보내기](#newrelicnotificationsend) + + 공지를 뉴렐릭 목적지로 보냅니다. +
+ +## 데이터 수집 작업 + + + + 사용자 정의 대시보드를 뉴렐릭에게 보냅니다. + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 예시 +
+ **속성** + + 선택 과목 + + 지도 + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **이벤트** + + 필수의 + + 목록 + + `"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]` +
+ **라이센스 키** + + 선택 과목 + + 끈 + + `"{{ .secrets.secretName }}"` +
+ **선택기** + + 선택 과목 + + 목록 + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: 제공되는 경우 모든 이벤트에 포함되는 공통 속성입니다. 필요한 경우 각 이벤트 항목을 병합하면 이벤트 항목이 일반적인 정의를 재정의합니다. + * **events**: 이벤트 데이터 목록입니다. 이벤트에는 사용자 정의 대시보드 유형을 나타내는 `eventType` 필드를 사용해야 하며 요청당 허용되는 최대 이벤트는 100개입니다. + * **LicenseKey**: 이벤트가 전송되는 구간, 목표 계정을 지정하는 뉴렐릭 계정 볼륨 키입니다. 이 값을 제공하지 않을 경우, 해당 워크플로우를 실행하는 계정을 기준으로 기본 볼륨 키를 가정합니다. + * **selectors**: 지정된 소스만 출력으로 가져오는 선택기입니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 예시 +
+ **성공** + + 부울 + + `true` +
+ **오류 메시지** + + 끈 + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: heartbeat_newrelicIngestSendEvents + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendEvents + version: 1 + inputs: + attributes: + colour: red + id: 1234 + events: + - eventType: HeartBeat + test: "OK" + attributes: + foo: bar + - eventType: HeartBeat1234 + test: "OK1234" + attributes: + foo: bar + - eventType: HeartBeat12345 + test: "OK12345" + attributes: + foo: bar + colour: yellow + - eventType: HeartBeat12345678 + test: "OK12345678" + selectors: + - name: success + expression: ".success" + ``` + + **예상 출력:** + + ```yaml + { + "success": true + } + ``` + + **이벤트 검색:** + + 워크플로우를 성공적으로 실행한 후 해당 이벤트를 실행한 계정에서 쿼리를 실행하면 관련 이벤트를 검색할 수 있습니다. + + ```sql + SELECT * FROM HeartBeat + ``` +
+ + + + + + + + + New Relic에 로그 보내기 + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 필드 + + 선택성 + + 유형 + + 예시 +
+ **속성** + + 선택 과목 + + 지도 + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **로그** + + 필수의 + + 목록 + + `"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"` +
+ **라이센스 키** + + 선택 과목 + + 끈 + + `"{{ .secrets.secretName }}"` +
+ **선택기** + + 선택 과목 + + 목록 + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: 제공되는 경우 모든 로그에 포함되는 공통 속성입니다. 로그 항목이 동일한 속성을 지정하는 경우 일반적인 정의가 재정의됩니다. + * **logs**: 로그인 데이터 목록입니다. 요청당 허용되는 최대 로그 수는 100개입니다. + * **LicenseKey**: 로그가 전송되는 구간, 주요 계정을 지정하는 뉴렐릭 계정 볼륨 키입니다. 제공하지 않을 경우, 해당 워크플로우를 실행하는 계정을 기준으로 기본 볼륨 키를 가정합니다. 자세한 내용은 [라이선스 키를](/docs/apis/intro-apis/new-relic-api-keys/#license-key) 참조하세요. + * **selectors**: 지정된 소스만 출력으로 가져오는 선택기입니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 출력 필드 + + 유형 + + 예시 +
+ **성공** + + 부울 + + `true` +
+ **오류 메시지** + + 끈 + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ 워크플로 예 +
+ ```yaml + name: heartbeat_newrelicIngestSendLogs + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + attributes: + colour: red + id: 1234 + logs: + - message: 'Heartbeat sendLogs Action Test Message' + attributes: + foo: bar + - message: 'HeartBeat1234' + attributes: + foo: bar + - message: 'HeartBeat12345' + attributes: + foo: bar + colour: yellow + - message: 'HeartBeat12345678' + selectors: + - name: success + expression: ".success" + ``` + + **예상 출력:** + + ```yaml + { + "success": true + } + ``` + + **로그 검색:** + + 워크플로우를 성공적으로 실행한 후 해당 로그플로우를 실행한 계정에서 쿼리를 실행하여 관련 로그플로우를 검색할 수 있습니다. + + ```sql + SELECT * FROM Log + ``` +
+ + + + + + +## NerdGraph 작업 + + + + newrelic NerdGraph API에 대해 Graphql 명령을 실행합니다. 명령은 쿼리이거나 뮤테이션일 수 있습니다. + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 + + 선택성 + + 유형 + + 설명 + + 예시 +
+ **그래프QL** + + 필수의 + + 끈 + + GraphQL 구문. 명령을 빌드하고 테스트하려면 GraphiQL을 사용해야 합니다. + +
+ **변수** + + 필수의 + + map[string]any + + GraphQL 명령문과 함께 사용할 핵심 가치 쌍 변수입니다. + +
+ **선택기** + + 선택 과목 + + 목록 + + 지정된 유일한 델파이를 출력으로 가져오는 선택기입니다. + + ```yaml + { + "data": { + "actor": { + "user": { + "name": "" + } + } + } + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 산출 + + 유형 + + 예시 +
+ **data** + + map[string]any: NerdGraph 응답의 + + `data` + + 속성 내용입니다. + + ```yaml + steps: + - name: currentUserId + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + graphql: | + query userId { + currentUser { + id + } + } + - name: sayHello + type: action + action: example.messaging.sayHello + version: 1 + inputs: + name: ${{ .steps.currentUserId.outputs.data.currentUser.id }} + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 예시 + + 산출 + + 이벤트 검색 +
+ ```json + name: testLog + + steps: + - name: logStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'Hello World' + ``` + + ```yaml + { + "success": true + } + ``` + + 해당 이벤트를 실행한 계정으로 쿼리를 실행하면 해당 이벤트를 조회할 수 있습니다. + + ```yaml + SELECT message FROM Log WHERE allColumnSearch('Hello World', insensitive: true) SINCE 30 minutes ago + ``` +
+ + + + + + +## 쿼리 작업 + + + + NerdGraph API를 통해 교차 계정 NRQL 쿼리를 실행합니다. + + + + + 입력 + + + + 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 + + 선택성 + + 유형 + + 설명 + + 예시 +
+ **질문** + + 필수의 + + 끈 + + NRQL 쿼리 문. + +
+ **계정 ID** + + 선택 과목 + + int 목록 + + **New Relic Account ID** + + \[뉴렐릭 계정 ID] 입력은 쿼리가 실행되는 퀴, 목표 계정을 지정할 수 있는 롤리, 목표 ID 목록입니다. 이 값을 입력으로 제공하지 않으면 쿼리는 자동으로 RPG우의 실행 계정과 연결된 계정에 대해 실행됩니다. + +
+ **선택기** + + 선택 과목 + + 목록 + + 지정된 유일한 델파이를 출력으로 가져오는 선택기입니다. + + ```json + steps: + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + accountIds: [12345] + query: FROM Log SELECT * WHERE message LIKE 'DEMO%' + selectors: + - name: resultsAsString + expression: '.results | tostring' + ``` +
+ + + + + + + + + + + + + + + + + + + + + +
+ 산출 + + 유형 + + 예시 +
+ **results** + + : 쿼리 결과를 포함하는 객체의 목록입니다. + + + + ```yaml + { + results=[ + { message=[INFO] - Workflow: test has ended, messageId=39af98 }, + { message=[INFO] - Workflow: test - Step query has started, messageId=649c612 }, + ... + ] + } + ``` +
+ + + + + + +## 공지사항 + + + + 예를 들어 Slack과 같은 대상과 통합된 채널로 메시지를 보냅니다. + + + + + 입력 + + + + 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 + + 선택성 + + 유형 + + 설명 + + 예시 +
+ **유형** + + 필수의 + + 끈 + + Newrelic 목적지 유형 + + `slack` +
+ **목적지 ID** + + 필수의 + + 문자열 + + Newrelic 대상과 연관된 DestinationId입니다. + + `123e4567-e89b-12d3-a456-426614174000` +
+ **매개변수** + + 필수의 + + 지도 + + 선택한 대상 유형으로 공지를 보내는 데 필요한 필드입니다. + + `{\"channel\": \"${{ YOUR_CHANNEL }}\", \"text\": \"Enter your text here\"}` +
+ **선택기** + + 선택 과목 + + 목록 + + 지정된 유일한 델파이를 출력으로 가져오는 선택기입니다. + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 산출 + + 유형 + + 예시 +
+ 성공 + + 부울 + + `true/false` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx new file mode 100644 index 00000000000..b103bf5723c --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx @@ -0,0 +1,684 @@ +--- +title: 유틸리티 작업 +tags: + - workflow automation + - workflow + - workflow automation actions + - utility actions +metaDescription: A list of available utility actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + +이 페이지에서는 fl.flo 자동화 작업 카탈로그에서 사용 가능한 유틸리티 작업에 대한 참조를 제공합니다. 이러한 작업을 통해 폴리스우 정의에서 일반적인 데이터 변환 및 유틸리티 작업을 수행할 수 있습니다. + +## 사용 가능한 유틸리티 작업 + +모든 유틸리티 작업에 대한 빠른 참조: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 동작 + + 목적 +
+ [에포크로부터 날짜/시간을 업데이트합니다.](#utils.datetime.fromEpoch) + + 에포크 타임스탬프를 날짜/시간 형식으로 변환합니다. +
+ [CSV로 변환](#utils.transform.toCSV) + + 데이터를 CSV 형식으로 변환합니다. +
+ [UUID 생성](#utils.uuid.generate) + + RFC 규격에 맞는 V4 UUID를 생성합니다. +
+ +## 유틸리티 작업 + + + + 이 작업은 에포크 타임스탬프를 날짜/시간으로 변환하는 데 사용됩니다. 가능한 참조: + + * [https://en.wikipedia.org/wiki/List\_of\_tz\_database\_time\_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) + * [https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT\_IDS](https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT_IDS) + + 자세한 내용은 [Epoch를](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html) 참조하세요. + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 + + 선택성 + + 유형 + + 설명 +
+ **타임스탬프** + + 필수의 + + 정수 + + 에포크 타임스탬프를 나타내는 정수입니다. 참고로, UNIX 에포크는 1970년 1월 1일 자정 UTC(00:00) 이후의 초 수입니다. +
+ **타임스탬프 단위** + + 선택 과목 + + 끈 + + 제공된 타임스탬프의 단위를 나타내는 문자열입니다. 허용 가능한 값: SECONDS, MILLISECONDS(기본값) +
+ **시간대 ID** + + 선택 과목 + + 끈 + + 원하는 날짜/시간의 시간대를 나타내는 문자열, 기본값: UTC +
+ **pattern** + + 선택 과목 + + 끈 + + 원하는 날짜/시간 패턴을 나타내는 문자열, 기본값: ISO-8601 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 들 + + 선택성 + + 데이터 유형 + + 설명 +
+ **날짜** + + 필수의 + + 끈 + + 날짜의 문자열 표현입니다. +
+ **시간** + + 필수의 + + 끈 + + 시간을 나타내는 문자열입니다. +
+ **날짜 시간** + + 필수의 + + 끈 + + datetime의 문자열 표현입니다. +
+ **시간대** + + 필수의 + + 지도 + + 시간대 ID와 약어를 지도로 표현한 것입니다. +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ 예시 + + 흐름흐름 입력 + + 출력 +
+ ```yaml + name: from_epoch + + workflowInputs: + timestamp: + type: Int + timestampUnit: + type: String + timezoneId: + type: String + pattern: + type: String + + steps: + - name: epochTime + type: action + action: utils.datetime.fromEpoch + version: 1 + inputs: + timestamp: ${{ .workflowInputs.timestamp }} + timezoneId: ${{ .workflowInputs.timezoneId }} + pattern: ${{ .workflowInputs.pattern }} + timestampUnit: ${{ .workflowInputs.timestampUnit }} + ``` + + ```json + mutation { + workflowAutomationStartWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { name: "from_epoch" } + workflowInputs: [ + {key: "timestamp", value: "1738236424003"} + {key: "timestampUnit", value: "MILLISECONDS"} + {key: "pattern", value: "yyyy-mm-dd HH:SS"} + {key: "timezoneId", value: "Asia/Kolkata"} + ] + ) { + runId + } + } + ``` + + ```json + { + "date": "2025-01-30", + "time": "16:57:04.003" + "datetime": "2025-01-30 16:00", + "timezone": { + "abbreviation": "IST", + "id": "Asia/Kolkata" + } + } + ``` +
+ + + + + + + + + 이 작업은 다양한 유형의 입력(JSON, 맵)을 CSV 형식으로 변환하는 데 사용됩니다. + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 + + 선택성 + + 유형 + + 설명 +
+ **data** + + 필수의 + + 어느 + + CSV로 변환할 데이터를 나타내는 문자열로, 일반적으로 JSON 문자열이나 맵입니다. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 들 + + 선택성 + + 데이터 유형 + + 설명 +
+ **CSV** + + 필수의 + + 끈 + + 수신된 데이터의 CSV 표현입니다. +
+ + + + + + + + + + + + + + + + + + + + + + +
+ 예시 + + 흐름흐름 입력 + + 출력 +
+ ```json + name: nrqltocsv + + steps: + - name: queryForLog + type: action + action: newrelic.nrql.query + version: 1 + inputs: + accountIds: ['${{ .workflowInputs.accountId }}'] + query: ${{ .workflowInputs.nrql }} + + - name: csv1 + type: action + action: utils.transform.toCSV + version: 1 + inputs: + data: ${{ .steps.queryForLog.outputs.results | tostring }} + ``` + + ```json + mutation { + startWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { + name: "nrqltocsv", + } + workflowInputs: [ + {key: "accountId" value: "12345678"} + {key: "nrql" value: "FROM TransactionError SELECT error.message, error.class, transactionName, request.uri, query WHERE appName like 'my-app-1%' AND error.expected IS FALSE SINCE 1 hour ago LIMIT 50"} + ] + ) + { runId } + } + ``` + +
+ + + + + + + + + RFC 규격에 맞는 V4 UUID를 생성합니다. + + + + + 입력 + + + + 출력 + + + + 예시 + + + + + + + + + + + + + + + + + + + + + + +
+ 입력 + + 선택성 + + 데이터 유형 + + 설명 +
+ + + + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ 들 + + 데이터 유형 + + 설명 +
+ **uuid** + + 끈 + +
+ + + + + + + + + + + + + + + + + + + + + +
+ 예시 + + 흐름흐름 입력 + + 출력 +
+ + + 이름: generateUUID
단계: + + * 이름: generateUUID 유형: 작업 작업: utils.uuid.generate 버전: 1 + 		+ ```json + { + "uuid": "c76bd606-5eaa-42bb-a847-4221fb49f83c", + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx new file mode 100644 index 00000000000..c15f60bbb1b --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/create-destinations.mdx @@ -0,0 +1,91 @@ +--- +title: 플로우에서 공지 보내기 +tags: + - workflow automation + - workflow + - notifications + - slack + - pagerduty +metaDescription: 'Configure workflows to send notifications via Slack, PagerDuty, email, or webhooks when automation tasks complete or fail.' +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +워크플로우는 Slack, PagerDuty, 이메일 또는 맞춤형 웹훅을 통해 팀에 공지를 보낼 수 있습니다. 워크플로우가 완료되거나, 실패하거나, 승인이 필요한 경우 공지 팀에 공지를 사용하세요. + +## 공지 채널을 선택하세요 + +사용 사례에 맞는 올바른 채널을 선택하세요. + +| **채널** | **가장 좋은** | **설정 복잡성** | **특징** | +| ---------- | ------------- | ----------------- | ------------------ | +| **느슨하게** | 팀 협업, 승인 | 쉬움 - 봇 토큰이 필요합니다 | 풍부한 메시지, 반응, 스레드 | +| **호출기 의무** | 인시던트 관리, 대기 중 | 쉬움 - API 키 필요 | 에스컬레이션 정책, 인시던트 추적 | +| **이메일** | 공식 공지, 보도 | 간편 - SMTP 설정 | 첨부 파일, HTML 서식 | +| **웹훅** | 맞춤형 통합 | 중간 - 엔드포인트가 필요합니다 | 유연한 페이로드, 모든 시스템 | + +## 시작하기 전에 + +공지를 구성하기 전에 다음 사항을 확인하세요. + +* 귀하의 계정에 생성된 A 플로리다우( [템플릿](/docs/workflow-automation/create-a-workflow-automation/use-a-template) 또는 [사용자 정의](/docs/workflow-automation/create-a-workflow-automation/create-your-own)) +* 공지 채널에 대한 자격 증명(Slack 봇 의미, PagerDuty API 키 등). +* 자격 증명은 [비밀 관리자](/docs/infrastructure/host-integrations/installation/secrets-management/) 에 저장됩니다. + +## 목적지 설정 [#set-the-destination] + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Destinations** 으로 이동한 후 **Workflow Automation** \[워크플로우 자동화를] 선택하세요. + +2. 워크플로우 자동화를 구성하려면 **워크플로우 자동화 대상 이름** (워크플로우 자동화의 고유 이름), **API Key** \[API 키] 등 필수 정보를 입력하세요. + +3. **Save destination** \[목적지 저장 을] 클릭합니다. + + Image of the Workflow Automation destination page. + +## 공지플로우 만들기 [#create-the-notification-workflow] + +1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) >Alerts > Notification Workflows** 에 접속한 후 **+ Add a workflow** \[+ 추가 a 워크플로우를] 선택하세요. + +2. 공지플로우를 구성하려면 공지플로우 구성 페이지에서 필수 정보를 제공하세요. + + * 알아볼 수 있는 고유한 이름을 입력하세요. + * **Basic** \[기본] 필터 옵션의 각 드롭다운 메뉴에서 **Tag** \[태그], **Policy** \[정책] , **Priority** \[우선순위] 속성을 선택하여 인시던트에 대한 공지를 받거나 **Advanced** \[고급] 필터 옵션을 선택하여 **Attributes** \[속성], **Operators** \[연산자], **Values** \[값을] 선택하여 더 자세한 인시던트 공지를 확인하세요. + * **Additional setting**s \[추가 설정을] 클릭하면 [NRQL 쿼리를](/docs/alerts/get-notified/incident-workflows/#enrichments) 구축하여 새로운 플랫폼 전반에서 관련 데이터를 수집하여 데이터를 풍부하게 만들 수 있습니다. 강화 예시는 [폴리스우 데이터 강화를](/docs/alerts/get-notified/custom-variables-incident-workflows/#enrichment-examples) 참조하세요. + +3. 알림 대상을 지정하려면 **Notify** \[알림] 섹션에서 하나 이상의 [**대상을**](/docs/alerts/get-notified/destinations) 선택합니다. + +4. 예를 들어, [Slack](/docs/alerts/get-notified/notification-integrations/#slack) 그룹에 공지를 보내려면 대상 유형으로 **Slack을** 선택합니다. + + 1. 드롭다운 목록에서 **Slack destination** \[Slack 대상을] 선택하세요. + 2. 드롭다운 목록에서 **Channel** \[채널을] 선택하고 **Receive notification updates on the channel** \[채널에서 공지 업데이트 수신] 확인란을 선택하세요. + 3. 선택적으로 **Custom Details** \[사용자 정의 세부 정보] 섹션에 사용자 정의 메시지를 추가합니다. + + + **Send test notification** \[테스트 공지 보내기를] 사용하여 테스트 공지를 보내는 것이 좋습니다. + + + 4. **Save message** \[메시지 저장을] 선택하세요. + +5. 워크플로우 자동화를 테스트하려면 **Test workflow** \[테스트플로우를] 선택하세요. 이는 계정의 기존 데이터를 사용하여 설정을 검증하고 샘플 공지를 전송하여 Slack 그룹에 도달하는지 확인합니다. + +6. **Activate workflow** \[활성화를] 선택하세요. + + Image of how to configure a workflow + +## 다음은 뭐지? + +공지 대상지를 구성했습니다. 이제 강력한 에라스우를 구축하는 데 사용할 수 있는 모든 액션을 살펴보세요. + +**여정의 다음 단계**: [작업 카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) - AWS, 뉴렐릭 및 통합에 사용 가능한 모든 작업을 찾아보세요. + +**건설할 준비가 되셨나요?** + +* [워크플로우 템플릿을 사용하세요](/docs/workflow-automation/create-a-workflow-automation/use-a-template) - 미리 구축된 워크플로우로 시작하세요 +* [나만의 워크플로우 만들기](/docs/workflow-automation/create-a-workflow-automation/create-your-own) - 처음부터 구축 +* [워크플로우 관리](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) - 워크플로우 대시보드 알아보기 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx new file mode 100644 index 00000000000..6d76bfcecf9 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx @@ -0,0 +1,465 @@ +--- +title: AWS 자격 증명 설정 +metaDescription: 'Configure AWS credentials for workflow automation using IAM roles, IAM users, or temporary session tokens.' +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +AWS 계정에서 작업을 수행하도록 자동화를 승인합니다. 자격 증명을 하드코딩하거나 보안을 손상시키지 않고도 EC2, SQS, DynamoDB 등의 AWS 서비스와 안전하게 상호 작용할 수 있는 인증 방법을 구성합니다. + +## 전제 조건 + +AWS 자격 증명을 설정하기 전에 다음 사항이 있는지 확인하세요. + +* IAM 역할이나 사용자를 생성할 수 있는 권한이 있는 AWS 계정. +* 귀하의 [뉴렐릭 계정 ID](/docs/accounts/accounts-billing/account-structure/account-id). +* [AWS IAM 콘솔](https://console.aws.amazon.com/iam/) 에 대한 관리자 액세스. + +## 필요한 권한 이해하기 [#required-permissions] + +자격 증명을 만들기 전에 플렉스우에 필요한 권한을 파악하세요. 실제로 사용하는 권한만 부여하세요. 이렇게 하면 최소 권한의 원칙을 따르고 보안 위험을 최소화할 수 있습니다. + +### 공통 흐름 권한 + +| **흐름흐름 종류** | **필수 AWS 권한** | **설명** | +| ------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------ | +| **EC2 관리** | `ec2:DescribeInstances`
`ec2:StopInstances`
`ec2:StartInstances`
`ec2:ModifyInstanceAttribute` | 알림에 응답하여 EC2를 중지, 시작 또는 수정합니다. | +| **SQS 메시징** | `sqs:SendMessage`
`sqs:GetQueueAttributes` | 다운스트림 처리를 위해 SQS 대기열에 메시지 보내기 | +| **API 게이트웨이** | `apigateway:GET`
`apigateway:PUT` | API Gateway 구현, 배포 또는 설정 롤백 | +| **시스템 관리자** | `ssm:CreateDocument`
`ssm:DeleteDocument`
`ssm:StartAutomationExecution`
`ssm:GetAutomationExecution` | 자동화 런북 실행 | +| **다이나모DB** | `dynamodb:Query`
`dynamodb:GetItem`
`dynamodb:PutItem` | DynamoDB 테이블에서 읽기 또는 쓰기 | + + + 읽기 전용 권한(`Describe*`, `Get*`, `List*`)으로 시작한 다음 필요에 따라서만 쓰기 권한(`Put*`, `Create*`, `Delete*`)을 추가합니다. 이를 통해 테스트 중에 실수로 파괴적인 행동을 하는 것을 방지할 수 있습니다. + + +전체 IAM 정책 템플릿은 아래의 [정책 예를](#policy-examples) 참조하세요. + +## 인증 설정 + +위 표에서 귀하의 사용 사례에 맞는 방법을 선택하세요. + + + + IAM 역할(권장) 액세스 키가 있는 IAM 사용자 세션 토큰 + + + + + IAM 역할을 사용하면 뉴렐릭이 영구 액세스 키를 요구하지 않고도 AWS 계정에서 임시 자격 증명을 가정할 수 있습니다. + + **IAM 역할 특성:** + + * 자격 증명은 자동으로 회전합니다. + * 설계상 접근은 시간적으로 제한됩니다. + * 모든 작업은 AWS CloudTrail에 기록됩니다. + * AWS 보안 모범 사례에 맞춰 조정 + + ### AWS에서 역할 생성 + + 1. [AWS IAM 콘솔](https://console.aws.amazon.com/iam/)에 로그인하세요 + 2. **Roles > Create role > Trusted entity type** 으로 이동하여 **AWS account > another AWS account**선택합니다. + 3. **Account ID** \[계정 ID] 필드에 다음을 입력합니다. `253490767857` + 4. **Options** \[옵션] 에서 **Require external ID** \[외부 ID 필요를]체크하세요. + 5. **External ID** \[외부 ID] 필드에 뉴렐릭 계정 ID를 입력하고 **Next** \[다음을] 클릭합니다. + + * 없으신가요? [여기에서 계정 ID를 찾으세요](/docs/accounts/accounts-billing/account-structure/account-id) + + 6. **Add permissions** \[권한 추가] 페이지에서 펠로스우에 따라 정책을 첨부합니다. + + * EC2 스텔라우의 경우: `AmazonEC2ReadOnlyAccess` 첨부하거나 사용자 지정 정책을 만듭니다. + * SQS의 경우: `AmazonSQSFullAccess` 첨부하거나 특정 대기열로 제한합니다. + * 다른 서비스의 경우: 아래의 [필수 AWS 권한을](#required-aws-permissions) 참조하세요. + + 7. **Next**클릭합니다. + 8. 역할 이름을 입력하세요: `NewRelicWorkflowAutomationRole` (또는 원하는 이름) + 9. 선택적으로 " AWS에서 자동화를 통해 작업을 수행할 수 있도록 허용"이라는 설명을 추가하고 **Create role** \[역할 만들기를] 클릭합니다. + + ### 신뢰 정책을 확인하세요 + + 역할을 만든 후 신뢰 관계를 확인하세요. + + 1. IAM 콘솔에서 새로 만든 역할을 선택하세요. + 2. **Trust relationships** \[신뢰 관계] 탭을 클릭하세요 + 3. 정책이 이 구조와 일치하는지 확인하세요( `` 실제 계정 ID로 바꾸세요). + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sts:AssumeRole", + "Principal": { + "AWS": "arn:aws:iam::253490767857:root" + }, + "Condition": { + "StringEquals": { + "sts:ExternalId": "" + } + } + } + ] + } + ``` + + ### 역할 ARN을 복사하세요 + + 폴리스우를 구성하려면 ARN 역할이 필요합니다. + + 1. IAM 콘솔에서 역할을 선택하세요 + 2. **Summary** \[요약] 섹션에서 **ARN** 필드를 찾으세요. + 3. 전체 ARN을 복사하세요. 다음과 같습니다. `arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole` + 4. 이 ARN을 안전하게 저장하세요. 워크플로우 설정에 직접 붙여넣으세요. + + + **중요:** 역할 ARN은 폴리스우 입력에 직접 입력됩니다. 비밀 관리자에 저장하지 마세요. 이는 민감한 자격 증명이 아니라 리소스 식별자입니다. + + + 이제 역할이 구성되었습니다. AWS 액세스가 필요한 ARN inactionflow 설정을 사용하세요. + + + + 이 방법은 테스트 환경이나 IAM 역할이 지원되지 않는 경우에 사용합니다. 액세스 키는 수동으로 교체해야 하는 장기 자격 증명입니다. + + **사용 사례:** + + * 테스트 및 개발 환경 + * 교차 계정 역할 가정을 지원하지 않는 AWS 설정 + * 단순화된 인증 흐름 + + + 액세스 키는 장기적으로 유효한 자격 증명입니다. 정기적으로(90일마다) 순환하고 필요한 것만으로 권한을 제한하세요. + + + ### IAM 사용자 생성 + + 1. [AWS IAM 콘솔](https://console.aws.amazon.com/iam/)에 로그인하세요 + 2. **Users > Create user** 로 이동하여 사용자 이름 `workflow-automation-user` (또는 원하는 이름)을 입력합니다. + 3. **다음을** 클릭하십시오 + 4. **Set permissions** \[권한 설정] 페이지에서 **Attach policies directly** \[정책 직접 첨부를]선택하세요. + 5. 폴리스우에 따라 정책을 검색하고 선택하세요: + + * SQS의 경우: 선택 `AmazonSQSFullAccess` + * EC2의 경우: 선택 `AmazonEC2ReadOnlyAccess` + * 또는 제한된 권한으로 사용자 지정 정책을 만듭니다(권장) + + 6. **Next** \[다음을] 클릭한 다음 **Create user** \[사용자 만들기를]클릭합니다. + + ### 액세스 키 생성 + + 1. 사용자 목록에서 새로 생성된 사용자를 선택하세요. + 2. **Security credentials** \[보안 자격 증명] 탭을 클릭하세요 + 3. **Access keys** \[액세스 키] 섹션에서 **Create access key** \[액세스 키 만들기를]선택하세요. + 4. **Application running outside AWS** \[AWS 외부에서 실행되는 애플리케이션을] 선택하고 **Next** \[다음을]클릭합니다. + 5. (선택) 설명 추가 태그: "뉴렐릭 흐름 자동화" + 6. **Create access key** \[액세스 키 만들기를]선택하세요 + 7. 두 자격 증명을 즉시 복사하세요. + + * **액세스 키 ID** ( `AKIA...` 으로 시작) + * **비밀 액세스 키** (한 번만 표시됨) + + + AWS는 생성 중에 비밀 액세스 키를 한 번만 표시합니다. 저장하지 않으면 새로운 키 쌍을 생성해야 합니다. + + + ### 자격 증명을 안전하게 저장하세요 + + 흐름 흐름에 AWS 자격 증명을 하드코딩하지 마세요. 대신 뉴렐릭의 [비밀 관리자](/docs/infrastructure/host-integrations/installation/secrets-management/) 에 저장하세요. + + 1. [NerdGraph GraphiQL 탐색기를](https://one.newrelic.com/nerdgraph-graphiql)엽니다. + 2. 액세스 키 ID를 저장하려면 이 뮤테이션을 실행하세요(플레이스홀더 값을 바꾸세요). + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } + } + ``` + + 3. 비밀 액세스 키에 대한 다른 뮤테이션을 실행합니다. + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsSecretAccessKey" + description: "AWS Secret Access Key for workflow automation" + value: "YOUR_AWS_SECRET_ACCESS_KEY" + ) { + key + } + } + ``` + + 다음 구문을 사용하여 **블리자드에서 이러한 비밀을 참조하세요** . `${{ :secrets:awsAccessKeyId }}` + + + `namespace` 필드를 사용하여 환경(`aws-prod`, `aws-staging`) 또는 팀 이름별로 비밀을 구성합니다. + + + + + 세션 토큰은 자동 만료되는 임시 자격 증명을 제공합니다. + + **사용 사례:** + + * 로컬 개발 및 테스트 + * 자격 증명 회전이 필요한 CI/CD 파이프라인 + * 시간 제한 액세스(일반적으로 1\~12시간)에 대한 규정 준수 요구 사항이 있는 환경 + + **필수 조건:** + + * [AWS CLI 설치 및 구성](https://aws.amazon.com/cli/) + * 가정할 수 있는 기존 IAM 역할 + + ### 임시 자격 증명 생성 + + 1. 터미널을 열고 다음 명령을 실행하세요(역할 ARN으로 바꾸세요). + + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` + + AWS CLI를 처음 사용하는 경우 `aws configure` 로 구성하고 액세스 자격 증명을 입력해야 할 수 있습니다. + + Image of the Static Access credentials + + 2. AWS는 세 가지 값을 반환합니다. 세 가지 모두 필요합니다. + + ```json + { + "Credentials": { + "AccessKeyId": "ASIAIOSFODNN7EXAMPLE", + "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", + "SessionToken": "FQoGZXIvYXdzEBk...", + "Expiration": "2025-01-25T12:00:00Z" + } + } + ``` + + 3. 세 가지 자격 증명을 모두 Secrets Manager에 저장합니다. + + * `AccessKeyId` 다른 이름으로 저장 `awsAccessKeyId` + * `SecretAccessKey` 다른 이름으로 저장 `awsSecretAccessKey` + * `SessionToken` 다른 이름으로 저장 `awsSessionToken` + + + 세션 토큰은 만료됩니다(일반적으로 1시간 후). `Expiration` 타임스탬프 전에 새로 고침 알림을 설정하세요. 그렇지 않으면 폴리스우가 인증 오류로 실패합니다. + + + + + +## 흐름에서 자격 증명 사용 [#use-credentials] + +인증을 설정한 후, 워크플로우 설정에서 자격 증명을 참조하세요: + +### IAM 역할(권장) + +역할 ARN을 폴리스우 입력에 직접 붙여넣습니다. 비밀 관리자가 필요하지 않습니다. + +```yaml +awsRoleArn: arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole +``` + + + 역할 ARN은 중요한 자격 증명이 아닌 리소스 식별자입니다. Secrets Manager에 저장하지 말고, 워크플로우 설정에 직접 붙여넣으세요. + + +### IAM 사용자 또는 세션 토큰 + +액세스 키에 대한 참조 비밀 관리자: + +```yaml +awsAccessKeyId: ${{ :secrets:awsAccessKeyId }} +awsSecretAccessKey: ${{ :secrets:awsSecretAccessKey }} +awsSessionToken: ${{ :secrets:awsSessionToken }} # Only for session tokens +``` + +뉴렐릭은 런타임에 비밀을 검색하고 AWS 에 인증한 다음 삭제합니다. 귀하의 자격 증명은 로그플로우 기록에 절대 나타나지 않습니다. + +## 정책 사례 [#policy-examples] + +일반적인 앨리스우 유형에 대해 이러한 완전한 IAM 정책 템플릿을 사용하세요. 각각은 특정 리소스에 대한 액세스를 제한함으로써 최소 권한의 원칙을 따릅니다. + + + + 특정 대기열에 대한 액세스 제한: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + }, + { + "Effect": "Allow", + "Action": "sqs:GetQueueAttributes", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + } + ] + } + ``` + + `us-west-2` 지역으로, `123456789012` 을 AWS 계정 ID로, `my-workflow-queue` 대기열 이름으로 바꾸세요. + + + + 태그를 사용하여 특정 인스턴스에 대한 액세스 제한: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ec2:DescribeInstances", + "ec2:DescribeTags" + ], + "Resource": "*" + }, + { + "Effect": "Allow", + "Action": [ + "ec2:StopInstances", + "ec2:StartInstances", + "ec2:ModifyInstanceAttribute" + ], + "Resource": "arn:aws:ec2:us-east-1:123456789012:instance/*", + "Condition": { + "StringEquals": { + "aws:ResourceTag/Environment": "production" + } + } + } + ] + } + ``` + + 이 정책은 `Environment=production` 있는 EC2 연결 태그만 중지/시작/수정하도록 허용합니다. + + + + 특정 테이블에 대한 액세스 제한: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "dynamodb:Query", + "dynamodb:GetItem", + "dynamodb:PutItem" + ], + "Resource": "arn:aws:dynamodb:us-east-1:123456789012:table/WorkflowData" + } + ] + } + ``` + + `WorkflowData` 테이블 이름으로 바꾸세요. + + + + 특정 자동화 문서에 대한 액세스 제한: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument" + ], + "Resource": "arn:aws:ssm:us-east-1:123456789012:document/WorkflowAutomation-*" + }, + { + "Effect": "Allow", + "Action": [ + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": [ + "arn:aws:ssm:us-east-1:123456789012:automation-definition/WorkflowAutomation-*:*", + "arn:aws:ssm:us-east-1:123456789012:automation-execution/*" + ] + } + ] + } + ``` + + 이는 자동화 문서를 `WorkflowAutomation-` 으로 접두사가 붙은 문서로 제한합니다. + + + + 특정 API에 대한 액세스 제한: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "apigateway:GET", + "apigateway:PUT" + ], + "Resource": "arn:aws:apigateway:us-west-2::/restapis/abc123xyz/*" + } + ] + } + ``` + + `abc123xyz` API Gateway ID로 바꾸세요. + + + +### 추가 리소스 + +포괄적인 AWS 권한 참조: + +* **[AWS 통합 관리 정책](/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies/)**: 서비스별 AWS 권한의 전체 목록과 조정할 수 있는 CloudFormation 템플릿 +* **[AWS API 폴링 설정](/docs/infrastructure/amazon-integrations/connect/set-up-aws-api-polling/)**: 추가 설정 패턴 + + + 해당 리소스는 클라우드 통합(모니터링)을 위해 계정 ID `754728514883` 을 사용합니다. 워크플로우 자동화의 경우 항상 `253490767857` 사용하세요. + + +## 다음 단계 + +AWS 자격 증명을 구성한 후 다음을 생성할 수 있습니다. + +**생성 흐름:** + +1. **[AWS 작업 찾아보기](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: 사용 가능한 AWS 작업(EC2, SQS, DynamoDB 등)을 확인합니다. +2. 일반적인 AWS 자동화 작업을 위해 사전 구성된 **[템플릿 사용](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: 구현하다, 배포하다 +3. **[맞춤형 워크플로우 만들기](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: 특정 요구 사항에 맞는 워크플로우 빌드 + +**공지 구성:** + +* **[대상 설정](/docs/workflow-automation/setup-and-configuration/create-destinations)**: Slack, PagerDuty, 이메일, webhook 구성 커뮤니티 커뮤니티 이벤트 공지 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/troubleshooting.mdx b/src/i18n/content/kr/docs/workflow-automation/troubleshooting.mdx new file mode 100644 index 00000000000..fce976b7a1f --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/troubleshooting.mdx @@ -0,0 +1,386 @@ +--- +title: 흐름 흐름 자동화 문제 해결 +tags: + - workflow automation + - troubleshooting + - workflow errors +metaDescription: 'Common issues and solutions for Workflow Automation including AWS credentials, workflow execution, and dashboard problems.' +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +이 페이지에서는 폴리스우 Automation을 사용할 때 발생할 수 있는 일반적인 문제에 대한 솔루션을 제공합니다. 추가 지원이 필요하면 [뉴렐릭 지원 포럼을](https://discuss.newrelic.com/) 참조하거나 [뉴렐릭 지원팀](https://support.newrelic.com/) 에 문의하세요. + +## AWS 자격 증명 및 인증 + + + + **문제:** 펠로우스가 AWS 인증 오류로 인해 실패합니다. + + **해결책:** + + 1. **계정 ID를 확인하세요.** 신뢰 정책에서 `253490767857` ( `754728514883` 아님)을 사용했는지 확인하세요. 클라우드 통합 계정 ID(`754728514883`)가 워크플로우 자동화 계정 ID와 다릅니다. + 2. **외부 ID 확인:** 신뢰 정책의 외부 ID가 뉴렐릭 계정 ID( [계정 설정](/docs/accounts/accounts-billing/account-structure/account-id) 에서 확인 가능)와 정확히 일치하는지 확인하세요. + 3. **권한 검토:** IAM 역할 또는 사용자에게 필요한 특정 AWS 권한이 있는지 확인하세요. [필수 AWS 권한](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials#required-aws-permissions) 표를 확인하세요. + 4. **AWS CLI로 테스트:** 로컬에서 `aws sts assume-role` 실행하여 역할이 가정 가능한지 확인합니다. + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/NewRelicWorkflowAutomationRole" \ + --role-session-name "TestSession" \ + --external-id "YOUR_NR_ACCOUNT_ID" + ``` + + + +### "잘못된 토큰" 또는 만료된 자격 증명 + +**문제:** 만료 오류로 인해 워크플로우가 실패합니다. + +**해결책:** + +1. **세션 토큰의 경우:** 만료 타임스탬프를 확인하세요. 세션 토큰은 일반적으로 1\~12시간 동안 지속됩니다. 만료되기 전에 새 항목을 생성하려면 다음을 사용하세요. + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` +2. **액세스 키의 경우:** 액세스 키 ID와 비밀 액세스 키가 모두 Secrets Manager에 올바르게 저장되어 있는지 확인하세요. [NerdGraph GraphiQL 탐색기](https://one.newrelic.com/nerdgraph-graphiql) 에서 값을 다시 확인하세요. +3. **비밀 구문을 확인하세요:** `${{ secrets.keyName }}` 아닌 `${{ :secrets:keyName }}` 형식을 사용하고 있는지 확인하세요. 콜론 접두사(`:secrets:`)가 필요합니다. + +### 내 역할 ARN을 찾을 수 없습니다 + +**문제:** ARN이 필요하지만 AWS에서 찾을 수 없습니다. + +**해결책:** + +1. [AWS IAM 콘솔](https://console.aws.amazon.com/iam/)에 로그인하세요 +2. 탐색에서 **Roles** \[역할을] 선택하세요 +3. 역할 이름을 검색하세요(예: `NewRelicWorkflowAutomationRole`) +4. 역할을 선택하세요. ARN이 요약 섹션에 나타납니다. +5. ARN 형식은 다음과 같습니다. `arn:aws:iam:::role/` + +### 에플로우가 특정 AWS 리소스에 액세스할 수 없습니다. + +**문제:** 역할에 권한이 있지만 폴리스우가 여전히 특정 리소스에 액세스할 수 없습니다. + +**해결책:** + +1. **리소스 수준 권한:** IAM 정책이 특정 리소스 ARN에 대한 액세스를 제한하는지 확인하세요. 테스트를 위해 와일드카드(`*`)를 추가한 다음 특정 리소스에 잠가야 할 수도 있습니다. + ```json + { + "Effect": "Allow", + "Action": "ec2:DescribeInstances", + "Resource": "*" // Change from specific ARN to * for testing + } + ``` +2. **서비스 제어 정책(SCP):** AWS 조직에 속한 경우 SCP가 특정 작업을 차단할 수 있습니다. AWS 관리자에게 문의하여 조직 정책을 검토하세요. +3. **지역 불일치:** IAM 권한이 리소스가 있는 올바른 AWS 지역을 지정하는지 확인하세요. 리소스 위치와 일치하도록 워크플로우의 `awsRegion` 보고서를 업데이트하세요. + +## 워크플로우 실행 문제 + +### 빠른 문제 해결, 해결 참고자료 + +일반적인 에펠로스우 문제를 빠르게 진단하려면 이 표를 사용하세요. + +| **징후** | **확인하다** | **해결책** | +| --------------------- | ------------------------ | -------------------------------------------- | +| 특정 단계에서 흐름이 실패함 | 오류 메시지에 대한 실행 로그 보기 | 해당 작업에 대한 설정, 자격 증명 또는 입력 데이터를 수정합니다. | +| 흐름이 실행되지만 잘못된 결과가 발생함 | 단계 간 데이터 전달 확인 | 템플릿 구문 확인 `${{ .steps.name.outputs.field }}` | +| 예정된 워크플로우가 실행되지 않습니다 | 건너뛴 실행에 대한 실행 기록을 확인하세요. | 일정 설정 및 워크플로우 상태 확인(Active) | +| 워크플로우 시간 초과 | 실행 기간 확인 | 폴링 빈도를 줄이거나 더 작은 SF로 분할 | +| 변경 사항이 적용되지 않습니다 | 버전 기록 확인 | 새 버전을 사용하려면 예약된 실행을 업데이트하세요. | + +로그 조회 및 실행 내역에 대한 자세한 내용은 [모니터 플로우 실행을](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs) 참조하세요. + +### 흐름흐름이 "Failed" 상태로 표시됩니다. + +**문제:** 대시보드에 A플로우가 Failed 상태로 나타납니다. + +**해결책:** + +1. **실행 기록을 확인하세요**: + + * **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 + * 워크플로우 이름을 클릭하세요 + * 어떤 실행이 실패했는지 확인하려면 **Run history** \[실행 기록을] 확인하세요. + +2. **실행 로그 검토**: + + * 실패한 실행에서 **View logs** \[로그 보기를] 클릭하여 실패한 특정 작업을 식별합니다. + * 근본 원인을 나타내는 오류 메시지를 찾으세요. + +3. **일반적인 원인**: + + * **잘못된 자격 증명**: 만료된 토큰, 잘못된 비밀 구문 또는 잘못된 비밀 키 + * **권한 없음**: AWS IAM 권한, Slack 봇 토큰 범위 또는 API 액세스가 부족합니다. + * **부채, 목표 리소스 변경**: EC2 제외 삭제, Slack 채널 제거 또는 데이터베이스 이름 변경 + * **API 속도 제한 초과**: 외부 서비스(AWS, Slack 등)에 대한 requests 너무 많습니다. + * **네트워크 시간 초과**: 외부 API가 응답하는 데 너무 오래 걸림 + +4. **수정 및 재실행**: 문제를 해결한 후 [StartWorkflowRun API](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) 사용하여 수동으로 팰리세우스를 트리거하여 작동하는지 확인합니다. + +### 플로우플로우 실행이 너무 오래 걸림 + +**문제:** 플레우스 실행이 예상 지속 시간 또는 시간 초과를 초과합니다. + +**해결책:** + +1. **동작 순서 검토**: 로그를 확인하여 느린 동작을 파악합니다. 실행 시간이 30초 이상인 작업을 찾으세요. + +2. **쿼리 최적화**: NRQL 쿼리를 사용하는 경우 더 나은 성능을 위해 쿼리를 최적화하세요. + + * 모든 데이터를 쿼리하는 대신 특정 시간 범위를 추가합니다. + * `LIMIT` 사용하여 결과 집합 크기를 줄이세요. + * `WHERE` 절을 사용하여 조기에 필터링 + +3. **외부 API 확인**: 통합 서비스(AWS, Slack)의 응답이 느리면 실행이 지연될 수 있습니다. API 응답 시간을 별도로 테스트합니다. + +4. **워크플로우 제한 고려**: [워크플로우 제한에 대한 시간 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits) 을 검토합니다(일반적으로 워크플로우당 15분). + +5. **더 작은 에펠탑우로 분할**: 복잡한 에펠탑우를 병렬로 실행할 수 있는 더 작고 집중적인 자동화로 분할합니다. + +### 워크플로우 변경사항이 적용되지 않습니다. + +**문제:** 플레시아우를 편집했지만 실행 시 변경 사항이 적용되지 않습니다. + +**해결책:** + +1. **저장했는지 확인하세요**. : 워크플로우 설정을 편집한 후 **Save** \[저장을] 눌렀는지 확인하세요. + +2. **버전을 확인하세요**: + + * 흐름흐름 자세히 보러가기 + * **Version history** \[버전 기록] 탭을 클릭하세요 + * 최신 변경 사항이 새 버전으로 표시되는지 확인하세요. + * 이 버전이 활성으로 표시되어 있는지 확인하세요. + +3. **예약된 실행 업데이트**: 에펠우가 일정에 따라 실행되는 경우 새 버전을 사용하도록 일정을 업데이트합니다. + + * **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 + * 예정된 실행 찾기 + * 새로운 플루토스우 버전을 참조하도록 일정을 업데이트하세요 + +4. **캐시 지우기**: 브라우저 캐싱에 이전 설정이 표시될 수 있습니다. 페이지를 새로 고치세요(Ctrl+Shift+R 또는 Cmd+Shift+R). + +## 워크플로우 대시보드 문제 + +### 대시보드에서 플로우플로우를 찾을 수 없습니다 + +**문제:** 생성한 A플로우가 대시보드 목록에 나타나지 않습니다. + +**해결책:** + +1. **필터 확인**: + + * 필터 드롭다운 메뉴를 클릭하세요 + * 상태 필터에 대해 "모두"를 선택하세요 + * 검색창을 비우세요 + +2. **계정 확인**: 뉴크리플로우가 생성된 올바른 계정에 로그인했는지 확인하세요. 오른쪽 상단 모서리에 있는 계정 선택기를 확인하세요. + +3. **권한 확인**: 사용자 역할이 조회수를 볼 수 있는 권한이 있는지 확인하세요. 켈로그 접속 권한이 필요하시면 관리자에게 문의하세요. + +4. **페이지 새로 고침**: 브라우저 캐싱으로 인해 최근 변경 사항이 숨겨질 수 있습니다. 강제 새로 고침(Ctrl+Shift+R 또는 Cmd+Shift+R)을 시도해 보세요. + +### 흐름을 삭제할 수 없습니다. + +**문제:** 삭제 옵션이 회색으로 표시되거나 삭제가 실패합니다. + +**해결책:** + +1. **권한 확인**: 사용자 역할에 추적플로우 삭제 권한이 있는지 확인하세요. 필요한 경우 계정 관리자에게 문의하세요. + +2. **예약된 실행 중지**: 삭제하기 전에 활성 예약된 실행을 취소합니다. + + * 워크플로우 세부정보로 이동 + * **Scheduled runs** \[예약된 실행] 탭으로 이동 + * 모든 활성 일정 취소 + +3. **Check 의존성/종속성**: 다른 자동화가 의존하고 있는 경우 일부 워크플로우를 삭제할 수 없습니다. 플루토스우가 다음에 의해 참조되는지 확인하세요. + + * 그것을 부르는 다른 흐름 + * 그것을 촉발시키는 공지사항 + * API를 통해 시작하는 외부 시스템 + +4. **지원팀에 문의하세요**: 위의 방법을 시도한 후에도 문제가 지속되면 [뉴렐릭 지원팀](https://support.newrelic.com/) 에 문의하여 도움을 받으세요. + +## 통합 관련 문제 + +### Slack 공지가 나오지 않아요 + +**문제:** 스텔라우가 성공적으로 완료되었지만 Slack 메시지가 나타나지 않습니다. + +**해결책:** + +1. **채널 ID 확인**: 채널 이름이 아닌 Slack 채널 **ID** (예: `C01234ABCD`)를 사용하고 있는지 확인하세요. Slack에서 ID 찾기: + + * 채널 이름을 마우스 오른쪽 버튼으로 클릭하세요 + * **View channel details** \[채널 세부정보 보기를]선택하세요 + * 하단의 채널 ID를 복사하세요 + +2. **봇 권한 확인**: Slack 봇의 범위가 다음과 같은지 확인하세요. + + * `chat:write` - 메시지 게시 + * `channels:read` - 공개 채널 보기 + * `groups:read` - 개인 채널 보기(해당되는 경우) + +3. **봇이 채널에 있는지 확인**: 봇을 목표 채널에 추가합니다: + + * 채널에 `/invite @YourBotName` 입력하세요 + * 봇이 멤버 목록에 나타나는지 확인하세요 + +4. **비밀의 토큰 확인**: 비밀 관리자에 저장된 Slack 토큰이 정확하고 만료되지 않았는지 확인하세요. + +### AWS Systems Manager 작업이 실패했습니다. + +**문제:** SSM 자동화 문서 또는 명령이 실행되지 않습니다. + +**해결책:** + +1. **SSM 권한 확인**: IAM 역할에 다음 권한이 있는지 확인하세요. + ```json + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument", + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": "*" + } + ``` +2. **SSM 에이전트 확인**: 타겟 EC2에 SSM 에이전트가 설치되어 실행 중인지 확인합니다. + ```bash + aws ssm describe-instance-information --region us-east-1 + ``` +3. **인스턴스 프로필 확인**: EC2 인스턴스에는 명령을 실행하기 위한 SSM 권한이 있는 IAM 인스턴스 프로필이 필요합니다. +4. **문서가 있는지 확인**: 기존 SSM 문서를 사용하는 경우 AWS 계정 및 지역에 문서가 있는지 확인합니다. + +## 템플릿 관련 문제 + +### 본문 GUID를 찾을 수 없습니다. + +**문제:** 템플릿이 `Entity not found` 오류로 인해 실패합니다. + +**해결책:** + +1. **올바른 부분 GUID 찾기**: + + * 뉴렐릭의 모니터 리소스 페이지로 이동하세요. + * GUID에 대한 URL 또는 세션데이터를 확인하세요 + * [분리 검색을](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic#find) 사용하여 분리 찾기 + +2. **올바른 계정에 부분이 존재하는지 확인**: 해당 활동이 특정하다, 배포하다와 동일한 계정에서 부분을 사용하고 있는지 확인하세요. + +3. **보고 데이터 확인**:가 최근에 **Last seen** \[마지막으로 본] 항목(오래됨)을 표시하는지 확인하세요.가 제거되었을 수 있습니다. + +4. **AWS 부분**: [통합이](/docs/infrastructure/amazon-integrations/get-started/introduction-aws-integrations) 활성화되어 있는지 확인하세요. + + + **GUID는 계정별로 다릅니다.** 계정 간에 블리자드를 이동하려면 모든 GUID를 업데이트해야 합니다. + + +### NRQL 쿼리가 결과를 반환하지 않습니다. + +**문제:** NRQL 쿼리를 사용하는 템플릿은 완료되지만 빈 데이터 세트를 반환합니다. + +**해결책:** + +1. **먼저 쿼리 테스트**: 템플릿에 추가하기 전에 [쿼리 빌더를](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) 사용하여 쿼리를 검증합니다. + +2. **데이터 유형 및 이벤트 이름 확인**: + + * `FROM Transaction` 사용하세요. `FROM Transactions` + * 속성 이름이 정확히 일치하는지 확인합니다(대소문자 구분). + +3. **시간 범위 조정**: 희소 데이터의 경우 시간 창을 확장합니다. + + * 최근 데이터에 `SINCE 1 hour ago` 추가합니다. + * 추세를 보려면 `SINCE 1 day ago` 사용하세요. + +4. **단순화하고 점진적으로 테스트**: 기본 쿼리로 시작하여 한 번에 하나씩 필터를 추가합니다. + +5. **[NRQL 구문](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language)확인**: 쿼리 구조가 NRQL 요구 사항과 일치하는지 확인 + +### 템플릿 구현, 배포 실패 + +**문제:** 템플릿이 구현, 배포되지 않거나 구현, 배포 중에 오류가 표시됩니다. + +**해결책:** + +1. **모든 필수 입력 사항 확인**: 모든 필수 필드(자격 증명, GUID, 쿼리)를 채웠는지 확인하세요. +2. **자격 증명 형식 확인**: 비밀은 콜론 접두사가 있는 `${{ :secrets:keyName }}` 형식을 사용해야 합니다. +3. **자격 증명을 독립적으로 테스트**: 구현하기 전에, Slack API에서 AWS CLI 및 Slack 의미를 사용하여 AWS 자격 증명을 테스트합니다. +4. **템플릿 요구 사항 검토**: 각 템플릿에는 특정 전제 조건이 나열되어 있습니다. 모든 요구 사항이 충족되는지 확인하세요. +5. **특수 문자 확인**: 일부 필드(채널 이름, 쿼리)는 특수 문자로 인해 실패할 수 있습니다. 가능한 경우 영숫자를 사용하세요. + +### 승인흐름플로우가 응답하지 않습니다. + +**문제:** Slack 승인(API Gateway 롤백, EC2 크기 조정)이 필요한 템플릿이 반응을 감지하지 못합니다. + +**해결책:** + +1. **봇 토큰 범위 확인**: + + * `reactions:read` - 이모티콘 반응을 감지하는 데 필요합니다. + * `chat:write` - 승인 메시지 게시가 필요합니다. + +2. **반응 형식 확인**: 에 지정된 정확한 이모지를 사용하세요. (일반적으로 승인은 👍, 거부는 👎) + +3. **시간 초과 설정 확인**: 승인 requests 구성된 시간 초과(일반적으로 5\~10분) 후에 만료됩니다. + +4. **봇이 메시지를 읽을 수 있는지 확인**: 봇은 채널에 있어야 하며 메시지 기록을 읽을 수 있는 권한이 있어야 합니다. + +5. **간단한 승인으로 테스트**: 승인 논리만으로 문제를 분리하여 테스트 에피스우를 만듭니다. + +### EC2 인스턴스 관리 문제 + +**문제:** EC2 템플릿이 인스턴스의 크기를 조정하거나 관리하지 못합니다. + +**해결책:** + +1. **[CloudWatch Metric Streams](/install/aws-cloudwatch/) 구성되어 있는지 확인**: 고대 EC2 지표에 필수 +2. **[EC2 모니터링 통합](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) 활성 확인**: 뉴렐릭으로의 데이터 흐름을 보장합니다. +3. **상태를 확인하십시오**: `running` 또는 `stopped` 상태여야 합니다. 전환 상태(보류 중, 중지)로 인해 오류가 발생합니다. +4. **호환 여부 확인**: 모든 크기 조정 작업을 지원하는 것은 아닙니다. [AWS 연결 설명서를](https://aws.amazon.com/ec2/instance-types/)확인하세요. +5. **중지/시작 권한 확인**: IAM 역할에는 `ec2:StopInstances` 및 `ec2:StartInstances` 추가로 필요합니다. `ec2:ModifyInstanceAttribute` + +### JSON 구문 분석 템플릿이 데이터를 기록하지 않음 + +**문제:** JSON 구문 분석 템플릿은 성공적으로 실행되지만 뉴렐릭 로그에 데이터가 나타나지 않습니다. + +**해결책:** + +1. **API 엔드포인트 확인**: 브라우저에서 상태 페이지 URL을 테스트하여 유효한 JSON을 반환하는지 확인합니다. +2. **JSON 구조 확인**: 템플릿은 특정 형식을 예상합니다. 구성 요소 상태 필드가 예상 구조와 일치하는지 확인하세요. +3. **로그 필터 검토**: 로깅 작업이 올바른 이벤트 유형 및 속성을 사용하는지 확인합니다. +4. **간단한 엔드포인트로 테스트**: 기본 JSON 엔드포인트(예: `https://httpbin.org/json`)를 사용하여 템플릿 메커니즘이 작동하는지 확인합니다. +5. **계정 권한 확인**: 크리플로우에 로그를 쓸 수 있는 권한이 있는지 확인하세요. + +### NRLens SQL 쿼리 인증이 실패했습니다. + +**문제:** NRLens 템플릿이 인증 또는 연결 오류로 인해 실패합니다. + +**해결책:** + +1. **NRLens 자격 증명 확인**: SQL 쿼리 Gateway 자격 증명이 최신이고 비밀에 올바르게 저장되었는지 확인하세요. +2. **조직 및 계정 ID 확인**: 두 ID가 모두 뉴렐릭 조직과 정확히 일치하는지 확인하세요. +3. **SQL 쿼리를 별도로 테스트**: 워크플로우에 추가하기 전에 NRLens 인터페이스를 사용하여 쿼리를 테스트합니다. +4. **SQL 구문 확인**: NRLens SQL은 NRQL과 다릅니다. 지원되는 구문은 [NRLens 설명서를](https://docs.newrelic.com/docs/nrlens-overview) 참조하세요. +5. **쿼리 복잡성 확인**: 매우 복잡한 조인이나 대규모 데이터 세트는 시간 초과될 수 있습니다. 쿼리를 단순화하거나 시간 제한을 추가하세요. + +## 다음 단계 + +이러한 해결 방법을 시도한 후에도 여전히 문제가 발생하는 경우: + +* **[사용자 흐름 자동화 커뮤니티 포럼](https://discuss.newrelic.com/)**: 질문하고 다른 사람에게 도움 받기 +* **[뉴렐릭 지원](https://support.newrelic.com/)**: 계정 관련 문제에 대해 지원팀에 문의하세요 +* **[플로우플로우 계수](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: 신뢰할 수 있는 플로우플로우를 위한 패턴을 학습합니다. +* **[플레시아우 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: 시스템 제약 조건 및 할당량 이해 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx new file mode 100644 index 00000000000..16bc5904de3 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx @@ -0,0 +1,33 @@ +--- +title: 일정 만들기 +tags: + - workflow automation + - workflow + - CreateSchedule + - workflow automation API +metaDescription: Create a schedule for a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +렉스우 정의에 대한 일정을 만듭니다. + +일정의 수와 일정에 대한 최소 기간은 [폴리스우 시스템 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits) 에서 정의됩니다. + +## 예시 + +쿼리플로우를 생성하고 편집하려면 [쿼리빌더를](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) 사용하세요. [NerdGraph API 탐색기를](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) 참조하세요. + +```graphql +mutation { + workflowAutomationCreateSchedule( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "healthyHeartbeat", version: 1} + cronExpression: "0 0 * * *" + timezone: "Asia/Kolkata" + options: {logLevel: DEBUG} + ) { + scheduleId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx new file mode 100644 index 00000000000..b7930674739 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: 워크플로 정의 만들기 +tags: + - workflow automation + - workflow + - CreateWorkflowDefinition + - workflow automation API +metaDescription: Create a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +이 API 폴리스우 정의를 생성하는 데 사용됩니다. 이미 스텔라우 정의가 존재하면 오류가 반환됩니다. + +## 예시 + +쿼리플로우를 생성하고 편집하려면 [쿼리빌더를](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) 사용하세요. [NerdGraph API 탐색기를](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) 참조하세요. + +```graphiql + mutation { + workflowAutomationCreateWorkflowDefinition( + scope: { + id: "11933347" + } + definition: { + yaml: "bmFtZTogbXV0YXRpb25fZXhlY3V0ZQoKc3RlcHM6CiAgLSBuYW1lOiBleGVjMQogICAgdHlwZTogYWN0aW9uCiAgICBhY3Rpb246IG5ld3JlbGljLm5lcmRncmFwaC5leGVjdXRlCiAgICB2ZXJzaW9uOiAnMS4wLjAnCiAgICBpbnB1dHM6CiAgICAgIGdyYXBocWw6IHwKICAgICAgICBtdXRhdGlvbiBLZWVwQWxpdmUoJGd1aWQ6IEVudGl0eUd1aWQhKXsKICAgICAgICAgIGVudGl0eUtlZXBBbGl2ZShndWlkczogWyRndWlkXSkgewogICAgICAgICAgICByZWZyZXNoZWRFbnRpdGllcwogICAgICAgICAgfQogICAgICAgIH0KICAgICAgdmFyaWFibGVzOgogICAgICAgIGd1aWQ6ICJ7eyAud29ya2Zsb3dJbnB1dHMuZW50aXR5R3VpZCB9fSIKCiAgLSBuYW1lOiBsb2cxCiAgICB0eXBlOiBhY3Rpb24KICAgIGFjdGlvbjogbmV3cmVsaWMuaW5zdHJ1bWVudGF0aW9uLmxvZwogICAgdmVyc2lvbjogJzEuMC4wJwogICAgaW5wdXRzOgogICAgICBNZXNzYWdlOiAiZW50aXR5R3VpZCByZWZyZXNoZWQge3sgLnN0ZXBzLmV4ZWMxLm91dHB1dHMuZGF0YS5lbnRpdHlLZWVwQWxpdmUucmVmcmVzaGVkRW50aXRpZXMgfX0iCg==" + } + ) { + definition { + name + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx new file mode 100644 index 00000000000..1deb3309c24 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx @@ -0,0 +1,697 @@ +--- +title: 흐름흐름 정의 스키마 +tags: + - workflow automation + - workflow schems + - workflow automation API +metaDescription: Workflow definitions are written in YAML. Keys use a camelCase naming convention. +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +## 개요 + +워크플로우 정의는 YAML로 작성됩니다. 키는 `camelCase` 명명 규칙을 사용합니다. + +### **이름** (필수) + +* **유형**: 문자열 +* **형식**: 정규식 `^[A-Za-z_][A-Za-z0-9_-]*$` 을 준수해야 합니다. +* **최대 길이**: 100 +* **설명**: `name` 값은 대소문자를 구분하지 않습니다. 예를 들어, `ExampleWorkflow`, `exampleworkflow`, `EXAMPLEWORKFLOW` 은 모두 동일한 파라다이스우 정의를 나타내는 것으로 간주됩니다. + +### **설명** (선택 사항) + +* **유형**: 문자열 +* **형식**: 정규식 `^[A-Za-z0-9 _-]*$` 을 준수해야 합니다. +* **최대 길이**: 200 +* **설명**: 팰리세이드우의 목적을 설명하는 `description` 입니다. + +### **workflowInputs** (선택 사항) + +* **유형**: 지도의 지도 +* **최대 크기**: 100 +* **설명**: 워크플로우가 수용하는 입력의 맵입니다. +* **예** : + +```java + workflowInputs: + myInput1: + type: String + myInput2: + type: Number + defaultValue: 42 +``` + +* **`workflowInputs.`** (필수) + + * **유형**: 문자열( [표현식 안전 패턴]() 에 따름) + * **최소 길이**: 1 + * **최대 길이**: 50 + * **설명**: 폴리스우 입력의 이름입니다. + +* **`workflowInputs..type`** (필수) + + * **Type**: Enum (Boolean, List, Map, String, Int, 날짜) + * **설명**: 폴리스우 입력의 데이터 유형입니다. + +* **`workflowInputs..defaultValue`** (선택 사항) + + * **유형**: 모든 유형; `type` 준수해야 합니다. + * **설명**: 플레시아우 입력의 기본값입니다. + +* **단계** (필수) + + * **유형**: 지도의 없음 + * **설명**: 플레우스 정의가 실행될 때 수행되는 단계입니다. 최소한 한 단계가 있어야 합니다. + + + 단계는 `steps` 에 정의된 순서대로 실행됩니다. + + 다른 순서가 필요한 경우, `steps[*].next` 속성을 점프할 단계의 이름으로 설정하여 "점프"를 수행할 수 있습니다. + + + * **`steps[*].name`** (필수) + + * **유형**: 문자열( [표현식 안전 패턴]() 에 따름; `end` 일 수 없음) + * **최대 길이**: 100 + * **설명**: `steps[*].next` 에서 참조할 단계의 이름입니다. `end`, `continue` 또는 `break` 과 같은 특수 키워드는 종료 단계, 루프의 계속 또는 루프의 중단을 나타내는 데 사용되므로 사용할 수 없습니다. + + * **`steps[*].type`** (필수) + + * **유형**: 문자열 + * **설명**: 단계의 유형으로, 단계가 실행될 때 수행되는 작업을 나타냅니다. 사용 가능한 옵션은 [단계 유형]() 을 참조하세요. + + * [**`steps[*].next`**](#steps-next) (선택 사항) + + * **유형**: 문자열( [표현식 안전 패턴]() 에 따름) + + * **설명**: + + * 이 단계가 성공적으로 완료되면 실행할 다음 단계의 이름입니다. 특수 키워드 `end` 을 사용하면 이 단계가 마지막에 실행되어야 함을 나타낼 수 있습니다. + * `next` 이 생략되면 정의의 `steps` 에 있는 다음 항목이 암시적 다음 단계로 사용됩니다. 다음 항목이 없으면 플로우가 완료됩니다. + +## 단계 유형 + +### **행동** + +특정 작업을 실행하는 단계입니다. 사용 가능한 옵션은 [Action Catalog](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) 를 참조하세요. + +* **`steps[*].action`** (필수) + + * **유형**: 문자열 + + * **설명**: 실행할 작업 함수의 정규화된 이름입니다. 다음 규칙을 따라야 합니다. + + `..` + + * **예** : + + * 뉴렐릭 서비스를 사용한 작업(예: NerdGraph를 통해): `newrelic.dashboards.getDashboard` + * Slack을 사용한 작업: `slack.chat.postMessage` + +* **`steps[*].version`** (필수) + + * **유형**: 문자열 + * **설명**: 실행할 작업 함수의 버전입니다. + +* **`steps[*].inputs`** (선택 사항) + + * **유형**: 값 맵( [표현식]() 포함) + + * **설명**: + + * 액션 함수에 전달할 입력입니다. 허용되는 구체적인 입력은 각 작업에 의해 정의됩니다. + * 입력에는 표현식을 사용할 수 있습니다. 자세한 내용은 [표현식 문자열]() 섹션을 참조하세요. + + + 민감한 데이터(API 키나 비밀, PII, PHI 또는 개인 식별 데이터)는 인수로 전달되어서는 안 됩니다. + + +* **`steps[*].inputs.selectors`** (선택 사항) + + * **유형**: `name` 과 `expression` 의 형태로 된 지도 목록입니다. + + * **설명**: + + * `selectors` 입력을 사용하면 지정된 요소만 반환하도록 출력을 다시 정의할 수 있습니다. + * 표현을 사용할 수 있습니다. 자세한 내용은 [표현식 문자열]() 섹션을 참조하세요. + + * **예시** + + * 제시된 예에서 우리는 http.get 작업의 응답으로 `pageUrl` 및 `statusDescription` 얻습니다. + + ```yaml + name: status + description: A workflow for checking the status of New Relic components + + steps: + - name: query1 + type: action + action: http.get + version: 1 + inputs: + url: "https://status.newrelic.com/api/v2/status.json" + selectors: + - name: statusCode + expression: '.statusCode' + - name: pageUrl + expression: '.responseBody | fromjson | .page.url' + - name: statusDescription + expression: '.responseBody | fromjson | .status.description' + + - name: logOutput1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "status is '${{ .steps.query1.outputs.statusDescription }}' details at ${{ .steps.query1.outputs.pageUrl }}" + ``` + +### **고리** + +루프는 `in` 으로 정의된 주어진 컬렉션을 반복하고 각 반복에 대해 루프 변수 `index` 과 `element` 를 생성합니다. 이러한 루프 변수는 표현식 `${{ .steps..loop.element }}` 또는 루프 내에서만 액세스할 수 있습니다. `${{ .steps..loop.index }` + +자세한 내용은 아래를 참조하세요. + + + + 루프를 사용하면 목록, 맵 또는 컬렉션을 반복할 수 있습니다. + + * `for` (필수의) + + * **유형**: 상수 + * **설명**: 루프의 시작 신호입니다. + + * `in` (필수의) + + * **유형**: 문자열(표현식) + * **설명**: 요소 컬렉션으로 평가되어야 하는 표현식입니다. + + * `steps` (필수의) + + * **설명**: 루프의 각 반복에서 실행되는 단계입니다. 단계는 다른 루프를 포함한 모든 유형의 단계가 될 수 있습니다. + + * **예**: 다음은 루프 workflowInputs를 실행하는 방법을 보여줍니다. 결과는 컬렉션 유형이어야 합니다. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # not exist outside of this loop + index: '${{ .steps.loopStep.loop.index }}' # not exist outside of this loop + ``` + + + * `element` `index` 은 루프의 일부로 자동으로 할당됩니다. + * `Index` 0부터 시작합니다. + * 복잡한 요소 컬렉션이 있는 경우 `element` 은 복잡한 유형이 될 수 있습니다. + * 루프 내 단계의 모든 루프 변수와 출력은 루프 수준 범위를 갖습니다. 이러한 변수는 루프를 종료한 후 지워지고 루프 외부에서 이 변수에 접근하면 null 값이 반환됩니다. 루프는 이전에 정의된 경우 루프 외부에 있는 변수에 액세스할 수 있습니다. + + + **정수에 대한 간단한 for 루프** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: ${{ [range(1; 6)] }} + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [1, 2, 3, 4, 5] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1, 2, 3, 4] + ``` + + **지도를 위한 간단한 루프** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [ { "key1": "val1" }, { "key2": "val2"} ] }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [{ "key1": "val1" }, { "key2": "val2"}] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1] + ``` + + **루프 내에서 점프** + + 동일한 for 루프에 속하는 명명된 단계 사이만 점프할 수 있습니다. for 루프 안팎으로 점프하거나, 내부/외부 루프로 점프하거나, 두 개의 서로 다른 for 루프 사이로 점프하는 것은 허용되지 않습니다. + + ```yaml + name: myWorkflow + steps: + - name: firstStep + type: action + action: example.messaging.sayHello + version: '1.0.0' + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: step3 # Okay within the loop + - name: step2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.step1.outputs.greeting }}' + - name: step3 + type: action + action: example.messaging.sayHello + version: '1.0.0' + next: firstStep # Not okay, first step is not in the loop context + ``` + + **루프에서 break/continue를 사용하세요** + + for 루프의 흐름을 변경하려면 `next: break` 또는 `next: continue` 사용할 수 있습니다. `break` 와 `continue` 은 루프 내에서 암시적으로 정의된 예약된 점프 목표입니다. 루프 외부에서 `next: break` 또는 `next: continue` 를 사용하면 렐름우 단계의 끝으로 이동합니다. + + * `end` 은 루프 내부에서 사용되는 경우 `break` 과 동일한 역할을 합니다. + * Next는 두 스위치 단계나 모든 유형의 단계에서 사용될 수 있습니다. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [range(1; 6)] }}' + steps: + - name: insideLoopStep1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: continue + - name: insideLoopStep2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + - name: loopStepAgain + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: switchStep + type: switch + switch: + - condition: '${{ .steps.loopStepAgain.loop.index >= 0 }}' + next: break + - name: insideLoopStepAgain + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStepAgain.loop.element }}' + ``` + + + +* **`steps[*].for`** (필수) + + * **유형**: 상수 + * **설명**: 루프 시작 신호 + +* **`steps[*].in`** (필수) + + * **유형**: 문자열(표현식) + + * **설명**: 요소 컬렉션으로 평가해야 하는 표현식입니다. + + * **`steps[*].steps`** (선택 사항) + + * **설명**: 루프의 각 반복에서 실행되는 단계입니다. 위의 단계에 대한 정의를 참조하세요. + + * **예** : + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: "${{ [range(1; 5)] }}"" + steps: + - name: step1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Loop: ${{ .steps.loopStep.loop.element }}" + ``` + +### **스위치** + +* 다양한 조건을 검사하고 참으로 평가되는 첫 번째 분기를 취하는 단계입니다. + +* 스위치는 목록에 아무리 많은 조건 요소라도 포함할 수 있습니다. 조건을 순서대로 검사하여 참으로 평가되는 첫 번째 조건을 처리합니다. 아무것도 참으로 평가되지 않으면 steps\[\*].next에 정의된 대로 다음 단계를 실행합니다. + +* **`steps[*].switch`** (필수) + + * **유형**: 기타 + * **설명**: 평가할 조건의 정렬된 목록을 지정하는 switch case의 배열입니다. + +* **`steps[*].switch[*].condition`** (필수) + + * **유형**: 문자열(표현식) + * **설명**: 스위치 케이스의 상태입니다. true로 평가되면 해당 사례의 다음 단계가 실행됩니다. + +* **`steps[*].switch[*].next`** (필수) + + * **유형**: 문자열( [표현식 안전 패턴]() 에 따름) + * **설명**: 케이스의 조건이 참으로 평가될 경우 실행할 단계의 이름입니다. 특수 키워드 end는 이 단계가 마지막에 실행되어야 함을 나타내는 데 사용할 수 있습니다. + + ```yaml + - name: hasCompleted + type: switch + switch: + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Failed" }} + next: displayError + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Success" }} + next: displaySuccess + next: displayUnexpected + ``` + +### 기다리다 + +팰리세이드우 실행을 계속하기 전에 특정 시간(초) 동안 기다리게 하는 단계입니다. 또한 하나 이상의 신호를 수신할 수도 있습니다. 대기하는 동안 신호가 수신되지 않으면 정상적으로 진행됩니다. 신호는 목록으로 정의됩니다. 각 신호에는 해당 다음 단계가 정의되어 있어야 합니다. 수신된 첫 번째 신호가 처리됩니다. 신호에 대해 수신된 값은 대기 단계의 단계 출력에 저장되며 이후 단계의 논리 처리에 사용될 수 있습니다. + +* 예시: + + ```yaml + name: waitSignalExample + workflowInputs: + steps: + - name: waitStep + type: wait + seconds: 300 + signals: [{name: 'mySignalName', next: 'firstStep'}] + - name: endStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "didn't get signal" + next: end + - name: firstStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.waitStep.outputs.signalInputs.myString }} + ``` + +* **`steps[*].seconds`** (필수) + + * **유형**: 숫자 + * **설명**: 폴리스우 실행을 계속하기 전에 기다리는 시간(초)입니다. + +* **`steps[*].signals`** + + * **유형**: 기타 + * **설명**: 수신 시 프로그램 흐름을 전환하는 신호입니다. + +* **`steps[*].signals[*].name`** + + * **유형**: 문자열 + * **설명**: 수신할 신호의 이름입니다. + +* **`steps[*].signals[*].next`** + + * **유형**: 문자열 + * **설명**: 지정된 신호를 수신하면 실행할 단계입니다. + +## 공유 유형 + +### 표현식 문자열 + +여러 속성은 플레임웨어 실행 중에 평가되는 내장 표현식이 있는 문자열 값을 허용하므로 플레임웨어 정의 내에서 동적 값을 사용할 수 있습니다. 표현식 문자열에는 하나 이상의 표현식이 포함될 수 있으며, 각 표현식은 이중 중괄호로 묶입니다. 중괄호 안의 내용은 jq를 사용하여 평가됩니다. + +jq는 다양한 방법으로 값에 접근하고 이를 조작할 수 있는 기능을 제공합니다. 예를 들어, 펠로스우 입력 문자열의 길이는 다음을 통해 얻을 수 있습니다. `${{ .workflowInputs.myString | length }}` + +[JQ 표현식을 빌드하고 테스트](https://play.jqlang.org/) 하려면 이 도구를 사용할 수 있습니다. + +### 발현 특성 + +표현식을 사용하여 여러 속성에 접근할 수 있습니다. 이러한 속성은 "범위" 객체에 있으므로 표현식은 마침표(.)로 시작해야 범위 객체의 해당 속성에 액세스할 수 있습니다. + +이용 가능한 속성은 다음과 같습니다. + +* `workflowInputs` - 시작 시 에펠우에 전달되는 입력을 포함하는 객체입니다. + * 예시: `${{ .workflowInputs.myInput }}` +* `steps` - 에리스우의 각 단계에 대한 속성을 포함하는 객체 + * `steps.` - 특정 단계에 대한 속성을 포함하는 객체 + * `steps..outputs` - 단계/작업에 특정한 결과 속성을 포함하는 객체입니다. + * 예시: `${{ .steps.myStep.outputs.myResult }}` + +### 발현 평가 결과 + +단일 jq 표현식은 모든 JSON 유형으로 평가될 수 있지만, 전체 표현식 문자열의 최종 결과는 표현식을 둘러싼 문자열 내용(있는 경우)에 따라 달라진다는 점에 유의하는 것이 중요합니다. + +표현식 문자열 전체가 단일 표현식으로 구성된 경우 jq 표현식의 결과로 평가되며 결과의 JSON 유형이 유지됩니다. 예를 들어, 로그플로우가 입력으로 포함되는 경우 문자열 `${{ .workflowInputs.myArray }}` 은 포함으로 평가됩니다. 이는 스텔라우 내에서 복잡한 데이터를 전달하는 데 유용할 수 있습니다. + +표현식 문자열에 단일 표현식이 아닌 다른 내용이 포함되어 있는 경우 문자열 결과로 평가됩니다. 예를 들어, 표현식 앞/뒤에 내용이 있거나 문자열 내에 여러 표현식이 있는 경우 이런 일이 발생합니다. 문자열 내의 각 표현식은 평가되어 문자열 표현으로 변환됩니다. + +예시: + +다음 예제에서는 myArray의 값이 \[1, 2, 3]이라고 가정합니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ 표현식 문자열 + + 결과 데이터 + + 결과 유형 +
+ `${{ .workflowInputs.myArray }}` + + \[1, 2, 3] + + 숫자의 비교 +
+ `${{ .workflowInputs.myArray | length }}` + + 삼 + + 숫자 +
+ `${{ .workflowInputs.myArray | length > 0 }}` + + 진정한 + + 부울 +
+ `Input is not empty: ${{ .workflowInputs.myArray | length > 0 }}` + + "입력이 비어 있지 않습니다: true" + + 끈 +
+ `${{ .workflowInputs.myArray }} has length ${{ .workflowInputs.myArray | length }}` + + "길이는 3입니다" + + 끈 +
+ +### 표현 안전 패턴 [#expression-safe-pattern] + +표현식에서 사용할 수 있는 속성은 다음 정규식을 따라야 합니다. `^[A-Za-z_][A-Za-z0-9_]*$` + +### 비밀 참조 + +비밀 값은 Secret Service에서 검색할 비밀의 이름을 지정하는 참조 문자열을 통해 작업에서 사용될 수 있습니다. 스텔라우 정의에서 비밀을 참조하려면 다음 구문을 사용하세요. + +* `${{ :secrets: }}` 비밀이 아닌 것에 대해 `namespace` +* `${{ :secrets:: }}` 비밀을 위해 `namespace` + +표현식 문자열에는 비밀 참조와 JQ 표현식이 혼합되어 있거나 여러 개의 비밀 참조가 포함될 수 있습니다. + +예: + +```yaml + steps: + - name: bearer_auth + type: action + action: http.post + inputs: + headers: + Authorization: Bearer ${{ :secrets: }} +``` + +## 예 + +* 안녕하세요 세상 + +```yaml +name: helloWorld +description: 'A hello world workflow' + +workflowInputs: + name: + type: String + defaultValue: World + required: false + validations: + - type: maxLength + errorMessage: "name must be at most 100 characters" + length: 100 + slackTokenSecret: + type: String + defaultValue: "${{ :secrets:SLACK_TOKEN }}" + slackChannel: + type: String + defaultValue: my-channel + validations: + - type: regex + errorMessage: "A slack channel name must be lowercase and can only contain letters, numbers, and hyphens" + pattern: "^[a-z0-9\\-]+$" + required: true + +steps: + - name: init1 + type: assign + inputs: + greeting: Hello ${{ .workflowInputs.name }} + + - name: logName + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.init1.outputs.greeting }} + + - name: waiting1 + type: wait + seconds: 1 + + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + query: >- + FROM Log SELECT * WHERE message LIKE '${{ .steps.init1.outputs.greeting + }}' + + - name: checkResult + type: switch + switch: + - condition: ${{ .steps.queryForLog.outputs.results | length > 0 }} + next: FoundMessage + + - name: waitingMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Waiting for log message... + token: ${{ .workflowInputs.slackTokenSecret }} + next: waiting1 + + - name: FoundMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Found message! ${{ .steps.queryForLog.outputs.results[0].message }} + token: ${{ .workflowInputs.slackTokenSecret }} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx new file mode 100644 index 00000000000..b72d716a8eb --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx @@ -0,0 +1,44 @@ +--- +title: 일정 삭제 +tags: + - workflow automation + - workflow + - Delete Schedule + - workflow automation API +metaDescription: 'Deletes the schedule of a workflow definition. Note, this doesn’t stop already running workflow instance.' +freshnessValidatedDate: never +translationType: machine +--- + +활동흐름 정의의 일정을 삭제합니다. 주의하세요, 이것은 현재 실행 중인 에라스우 실행을 중지하지 않습니다(StopWorkflowRun 변형을 사용하세요). + +## 예시 [#example] + +쿼리플로우를 생성하고 편집하려면 [쿼리빌더를](https://one.newrelic.com/nerdgraph-graphiql?state=fc314f67-101e-a54a-169a-191d1fd41fd) 사용하세요. [NerdGraph API 탐색기를](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) 참조하세요. + +```graphql + mutation { + workflowAutomationDeleteSchedule( + accountId: 11933347 + schedule: {id: "1a71d299-82c2-4b4d-9803-b14523e3a9e7"} + ) { + scheduleId + } + } +``` + +### 오류 예 + +`schedule.id` 을 찾을 수 없는 경우 다음 구조가 반환됩니다. + +```graphql +{ + "data": { + "workflowAutomationDeleteSchedule": null + }, + "errors": [{ + "message": "Could not find schedule with ID MTE2NDk5MDB8TkdFUHxXT1JLRkxPV19TQ0hFRFVMRXwwMTk5MGUzYi04NzAyLTc2M2QtOWUzMy01ZTU1ZThmZTYzYjkl", + "path": ["workflowAutomationDeleteSchedule"] + }] +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx new file mode 100644 index 00000000000..ef59bd9c3e3 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx @@ -0,0 +1,32 @@ +--- +title: 워크플로 정의 삭제 +tags: + - workflow automation + - workflow + - Delete Workflow Definition + - workflow automation API +metaDescription: Used to delete all the workflow definition versions with the specified name. +freshnessValidatedDate: never +translationType: machine +--- + +이 API 지정된 이름을 가진 모든 펠릭스우 정의 버전을 삭제합니다. + +정의를 삭제하려면 해당 정의를 사용하는 일정이 없어야 합니다. 정의가 현재 일정에 의해 사용 중인 경우 정의를 삭제하면 실패하고 그에 따라 오류가 반환됩니다. + +정의가 삭제되더라도 실행 중인 모든 펠로스우 실행은 완료될 때까지 계속됩니다. + +## 예시 + +```graphql +mutation { + workflowAutomationDeleteWorkflowDefinition( + definition: {name: "my-workflow"} + scope: {id: "12345678", type: ACCOUNT} + ) { + definition { + name + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx new file mode 100644 index 00000000000..cc904141479 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx @@ -0,0 +1,158 @@ +--- +title: GetActionDefinitions +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: 'Returns all action definitions stored. This operation is behind NerdGraph, under account stitch point.' +freshnessValidatedDate: never +translationType: machine +--- + +\# 파라우 정의를 구성하는 데 사용할 수 있는 모든 작업 정의를 반환합니다. + +## 예시 + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + actionDefinitions { + results { + description + inputs { + name + required + secretAllowed + } + name + outputs { + name + } + timeout { + action + } + version + } + } + } + } + } +} +``` + +다음을 반환합니다 + +```graphql +{ + "data": { + "actor": { + "account": { + "workflowAutomation": { + "actionDefinitions": { + "results": [ + { + "description": "Reboot one or more EC2 instances in an AWS account.", + "inputs": [ + { + "name": "awsRoleArn", + "required": false, + "secretAllowed": false + }, + { + "name": "awsAccessKeyId", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSecretAccessKey", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSessionToken", + "required": false, + "secretAllowed": true + }, + { + "name": "region", + "required": true, + "secretAllowed": false + }, + { + "name": "instanceIds", + "required": true, + "secretAllowed": false + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "aws.ec2.rebootInstances", + "outputs": [ + { + "name": "success" + }, + { + "name": "response" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 25 + }, + "version": 1 + }, + { + "description": "Send logs to New Relic.", + "inputs": [ + { + "name": "attributes", + "required": false, + "secretAllowed": false + }, + { + "name": "logs", + "required": true, + "secretAllowed": false + }, + { + "name": "licenseKey", + "required": false, + "secretAllowed": true + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "newrelic.ingest.sendLogs", + "outputs": [ + { + "name": "success" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 20 + }, + "version": 1 + } + # more ... + ] + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx new file mode 100644 index 00000000000..7849281e8a3 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx @@ -0,0 +1,29 @@ +--- +title: 일정을 얻으세요 +tags: + - workflow automation + - workflow + - Get Schedule + - workflow automation API +metaDescription: API gets and returns a schedule. +freshnessValidatedDate: never +translationType: machine +--- + +이 API는 일정을 가져와서 반환합니다. + +## 예시 [#example] + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedule(id: "schedule-id") { + id + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx new file mode 100644 index 00000000000..d284929e7f0 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx @@ -0,0 +1,41 @@ +--- +title: GetSchedules +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Returns information about schedules. +freshnessValidatedDate: never +translationType: machine +--- + +일정에 대한 정보를 반환합니다. + +## 예시 + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedules { + results { + definition { + name + scope { + id + type + } + version + } + schedule { + id + } + } + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx new file mode 100644 index 00000000000..8f68f16324f --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx @@ -0,0 +1,35 @@ +--- +title: GetWorkflowDefinition +tags: + - workflow automation + - workflow + - Get Workflow Definition + - workflow automation API +metaDescription: Used to get and return a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +이 API 폴리스우 정의를 가져와 반환합니다. + +## 예시 + +쿼리플로우를 생성하고 편집하려면 [쿼리빌더를](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) 사용하세요. [NerdGraph API 탐색기를](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) 참조하세요. + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflow(name: "my-workflow", version: 1) { + definition { + name + version + yaml + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx new file mode 100644 index 00000000000..ab5291df443 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx @@ -0,0 +1,38 @@ +--- +title: GetWorkflowDefinitions +tags: + - workflow automation + - workflow + - Get Workflow Definitions + - workflow automation API +metaDescription: Used to get and return a list of workflow definitions under the user account’s scope. +freshnessValidatedDate: never +translationType: machine +--- + +이 API 지정된 범위 내의 모든 펠로스우 정의 개요 목록을 가져와 반환합니다. 참고로, 내부 플로우 흐름 정의 yaml은 이 쿼리에서 사용할 수 없습니다. A 워크플로우 정의 yaml은 GetWorkflowDefinition 쿼리를 통해서만 반환됩니다. `/{actor/account(:id)/workflowAutomation/workflow(:name, :version)` + +## 예시 + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflows(cursor: "xyz123") { + results { + definition { + name + scope { + id + type + } + version + } + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx new file mode 100644 index 00000000000..5604b4230f0 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx @@ -0,0 +1,75 @@ +--- +title: SignalWorkflowRun +tags: + - workflow automation + - workflow + - Signal Workflow Run + - workflow automation API +metaDescription: Actions trigger a signal to an existing running workflow. +freshnessValidatedDate: never +translationType: machine +--- + +이 API 실행 중인 기존 FX우에 신호를 보냅니다. 이를 사용하여 콜백을 보내고 플레우스에서 평가하여 다음 단계로 넘어갈 수 있습니다. + +다양한 방법으로 신호와 함께 전달할 수 있습니다. + +## 예시 [#example] + + + + ```yaml + name: signalDemo + + steps: + - name: waitStep + type: wait + seconds: 300 + signals: + - name: approve + next: signalHandler + - name: cancel + next: signalHandler + + - name: NoSignalReceived + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "no signals received" + next: end + + - name: signalHandler + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "signal '${{ .steps.waitStep.outputs.signalName }}' was received with: '${{ .steps.waitStep.outputs.signalInputs | tostring }}'" + ``` + + + +이 스텔라우를 시작한 후 시작 시 이 runId가 반환됩니다. `107e6df2-aa17-41bc-8065-bfa46bde810b` + +그러면 에볼루션우가 이 돌연변이로 신호를 받을 수 있습니다. + +```graphql +mutation { + workflowAutomationSignalWorkflowRun( + accountId: 11933347 + runId: "107e6df2-aa17-41bc-8065-bfa46bde810b" + signalName: "approve" + signalInputs: [ + {key: "foo", value: "bar"} + ] + ) { + runId + } +} +``` + +플루스톤우가 시작된 경우 로그에서 다음을 관찰할 수 있습니다. `options: {logLevel: DEBUG}` + +Screenshot displaying Logs if the workflow was started with the options: {logLevel: DEBUG} \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx new file mode 100644 index 00000000000..862c2058efb --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx @@ -0,0 +1,35 @@ +--- +title: 시작워크플로 실행 +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Start a workflow run for a specified workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +지정된 워크플로우 정의에 대해 워크플로우 실행을 시작하는 API 입니다. + +동시 실행 수, 주어진 실행에서 실행되는 단계 수는 [플레로스우 시스템 제한](/docs/workflow-automation/limitations-and-faq/workflow-limits) 에서 정의됩니다. + +## 예시 + +쿼리플로우를 생성하고 편집하려면 [쿼리빌더를](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) 사용하세요. [NerdGraph API 탐색기를](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) 참조하세요. + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "my-workflow"} + workflowInputs: [ + {key: "foo", value: "bar"}, + {key: "fruit", value: "apple"} + ] + options: {logLevel: DEBUG} + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx new file mode 100644 index 00000000000..d3902ef56d3 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx @@ -0,0 +1,26 @@ +--- +title: StopWorkflowRun +tags: + - workflow automation + - workflow + - Stop Workflow Run + - workflow automation API +metaDescription: Stops a running workflow instance. +freshnessValidatedDate: never +translationType: machine +--- + +실행 중인 흐름을 중지합니다. 폴리스우를 찾을 수 없으면 빈 `runId` 을 반환합니다. + +## 예시 + +```graphql +mutation { + workflowAutomationStopWorkflowRun( + accountId: 11933347 + runId: "7ffbe082-8efa-4d3d-901a-a08bcf22bcd3" + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx new file mode 100644 index 00000000000..c930d8b27da --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx @@ -0,0 +1,30 @@ +--- +title: 업데이트워크플로 정의 +tags: + - workflow automation + - workflow + - Update Workflow Definition + - workflow automation API +metaDescription: Used to update an existing workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +기존 스텔라우 정의를 업데이트하는 데 사용됩니다. 스텔라우 정의가 아직 존재하지 않으면 오류가 반환됩니다. + +## 예시 + +```graphql + mutation { + workflowAutomationUpdateWorkflowDefinition( + definition: {yaml: ""} + scope: {id: "11608789", type: ACCOUNT} + ) { + definition { + name + version + yaml + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx new file mode 100644 index 00000000000..b4deb46da11 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx @@ -0,0 +1,81 @@ +--- +title: 흐름흐름 자동화 API 참조 +tags: + - workflow automation + - workflow + - nerdgraph + - nerdgraph api + - workflow automation api +metaDescription: Complete reference guide for Workflow Automation APIs in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + 이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다! + + 이 기능은 현재 [출시 전 정책](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy) 에 따라 미리보기 프로그램의 일부로 제공됩니다. + + +워크플로우 자동화 API 사용하면 뉴렐릭에서 프로그래밍 방식으로 워크플로우를 생성, 관리, 실행할 수 있습니다. 이러한 API를 사용하여 반복적인 작업을 자동화하고, 복잡한 운영을 조율하고, 스텔라우를 개발 및 운영 프로세스에 통합하세요. + +## 시작하기 전에 + +에볼루션우 자동화 API를 사용하려면 다음이 필요합니다. + +* 적절한 권한이 있는 뉴렐릭 계정 +* API 호출을 생성하고 테스트하기 위해 [NerdGraph API 탐색기](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) 에 액세스하세요. +* [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) (뉴렐릭의 GraphQL API)에 대한 이해 + +추가 도움이 필요하면: + +* [NerdGraph API 탐색기 튜토리얼](/docs/apis/nerdgraph/get-started/nerdgraph-explorer)에서 GraphiQL IDE를 사용하는 방법을 알아보세요. +* 모든 뉴렐릭 API에 대한 개요는 [API 소개를](/docs/apis/intro-apis/introduction-new-relic-apis) 참조하세요. + +### 인증 및 비밀 + +흐름 흐름 자동화는 API 키 및 자격 증명과 같은 민감한 정보를 관리하기 위해 고객 비밀 저장소를 사용합니다. 비밀은 [GraphQL API를](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) 통해 관리됩니다. 비밀 관리와 관련된 인증 세부 정보는 [NerdGraph 문서](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) 를 참조하세요. + +## 카테고리별 API 작업 + +### 흐름 생성 및 관리 + +다음 API를 사용하여 펠릭스우 정의를 생성, 업데이트, 검증 및 삭제합니다. + +* [CreateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/create-workflow-definition) - 새로운 워크플로우 정의 만들기 +* [UpdateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/update-workflow-definition) - 기존 아크로폴리스우 정의 업데이트 +* [ValidateWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition) - 에리스우 정의 YAML을 생성하거나 업데이트하기 전에 유효성을 검사합니다. +* [DeleteWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition) - 지정된 이름을 가진 모든 버전의 펠로스우 정의를 삭제합니다. + +### 쿼리플로우 및 액션 + +다음 API를 사용하여 에펠탑 및 사용 가능한 작업에 대한 정보를 검색합니다. + +* [GetWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/get-workflow-definition) - 특정 아크로폴리스 정의를 가져와 반환합니다. +* [GetWorkflowDefinitions](/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions) - 계정 범위에 있는 에리스우 정의 목록을 가져와 반환합니다. +* [GetActionDefinitions](/docs/workflow-automation/workflow-automation-apis/get-action-definitions) - 사용 가능한 모든 작업 정의를 반환합니다. + +### 런 흐름 + +다음 API를 사용하여 에펠로우 실행을 제어합니다. + +* [StartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) - 특정 플로우 정의에 대한 플로우 플로우 실행을 시작합니다. +* [SignalWorkflowRun](/docs/workflow-automation/workflow-automation-apis/signal-workflow-run) - 기존 실행 중인 에리스우에 신호 트리거 +* [StopWorkflowRun](/docs/workflow-automation/workflow-automation-apis/stop-workflow-run) - 실행 중인 활동을 중지합니다. + +### 일정 흐름 + +다음 API를 사용하여 팰팍스우 일정을 만들고 관리하세요. + +* [CreateSchedule](/docs/workflow-automation/workflow-automation-apis/create-schedule) - 엘피스우 정의에 대한 일정을 만듭니다. +* [GetSchedule](/docs/workflow-automation/workflow-automation-apis/get-schedule) - 일정 세부 정보를 가져오고 반환합니다. +* [GetSchedules](/docs/workflow-automation/workflow-automation-apis/get-schedules) - 모든 일정에 대한 정보 반환 +* [DeleteSchedule](/docs/workflow-automation/workflow-automation-apis/delete-schedule) - 에펠우 정의의 일정을 삭제합니다. + + + 일정을 삭제해도 이미 실행 중인 일정은 중단되지 않습니다. + + +### 참조 문서 + +* [정의 스키마](/docs/workflow-automation/workflow-automation-apis/definition-schema) - 폴리스우 정의 구조 및 구문 참조 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx new file mode 100644 index 00000000000..250bca6bc04 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: ValidateWorkflowDefinition +tags: + - workflow automation + - workflow + - Validate Workflow Definition + - workflow automation API +metaDescription: Used to validate workflow definition YAML. +freshnessValidatedDate: never +translationType: machine +--- + +워크플로우 정의 yaml을 검증합니다. + +## 예시 + +```graphql + query workflowDefinitionValidation { + actor { + account(id: 11933347) { + workflowAutomation { + workflowDefinitionValidation( + definition: {yaml: "ICAgICAgICAgICAgICAgIG5hbWU6IG15V29ya2Zsb3cKCiAgICAgICAgICAgICAgICBzdGVwczoKICAgICAgICAgICAgICAgICAgLSBuYW1lOiBvbmx5U3RlcAogICAgICAgICAgICAgICAgICAgIHR5cGU6IHdhaXQKICAgICAgICAgICAgICAgICAgICBzZWNvbmRzOiAtNDIKCiAgICAgICAgICAgICAgICAgIC0gbmFtZTogJycKICAgICAgICAgICAgICAgICAgICB0eXBlOiB3YWl0CiAgICAgICAgICAgICAgICAgICAgc2Vjb25kczogLTQyCgogICAgICAgICAgICAgICAgICAtIG5hbWU6IG9ubHlTdGVwCiAgICAgICAgICAgICAgICAgICAgdHlwZTogYWN0aW9uCiAgICAgICAgICAgICAgICAgICAgYWN0aW9uOiBDb25zb2xlTG9nCiAgICAgICAgICAgICAgICAgICAgdmVyc2lvbjogIiIKICAgICAgICAgICAgICAgICAgICBpbnB1dHM6CiAgICAgICAgICAgICAgICAgICAgICAgZm9vOiAiIg=="} + ) { + errors { + message + } + valid + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx new file mode 100644 index 00000000000..a1e6532793d --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx @@ -0,0 +1,32 @@ +--- +title: 워크플로 실행 정보 +tags: + - workflow automation + - workflow + - Workflow Run Info + - workflow automation API +metaDescription: Used to retrieve information about a specific workflow run. +freshnessValidatedDate: never +translationType: machine +--- + +이 API 특정 폴리스우 runId에 대한 폴리스우의 상태를 가져와 반환합니다. + +## 예시 + +쿼리플로우를 생성하고 편집하려면 [쿼리빌더를](https://one.newrelic.com/nerdgraph-graphiql?state=03119d23-7b51-7b7a-1c99-d2cd026300e5) 사용하세요. [NerdGraph API 탐색기를](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) 참조하세요. + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflowRunInfo(runId: "8911c7e4-5a1f-4316-90c8-67adde72dd1c") { + logUrl + status + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/kr/docs/workflow-automation/workflow-examples.mdx b/src/i18n/content/kr/docs/workflow-automation/workflow-examples.mdx new file mode 100644 index 00000000000..93a5f5eb3f4 --- /dev/null +++ b/src/i18n/content/kr/docs/workflow-automation/workflow-examples.mdx @@ -0,0 +1,244 @@ +--- +title: 워크플로우 예제 +tags: + - workflow automation + - workflow + - automation + - examples +metaDescription: 'Common workflow automation scenarios and examples for incident response, infrastructure management, and integrations.' +freshnessValidatedDate: never +translationType: machine +--- + +이 페이지에서는 펠릭스우 Automation을 사용하여 구축할 수 있는 일반적인 자동화 시나리오를 보여줍니다. 이러한 예를 자신만의 워크플로우의 시작점으로 사용하거나 준비된 구현하다, 배포하다 솔루션에 대한 [템플릿을](/docs/workflow-automation/create-a-workflow-automation/use-a-template) 탐색하세요. + +## 인시던트 대응 및 교정 + +### API 게이트웨이 롤백 + +API 게이트웨이 구성을 이전 상태로 되돌려 오류와 잘못된 구성을 수정할 수 있습니다. + +**이 흐름이 하는 일은:** + +* 뉴렐릭 변경 추적을 이용하여 이슈와 관련된 최근 형태, 배포를 탐지합니다. +* 승인 버튼(:+1: 또는 :-1:)을 사용하여 Slack에 공지를 보냅니다. +* 승인 후 롤백을 자동화하기 위해 AWS Systems Manager 문서를 생성합니다. +* API Gateway 통합을 이전 Lambda 버전으로 롤백합니다. +* 롤백을 적용하기 위한 새로운 구현, 배포를 생성합니다. +* Slack에 성공 또는 실패 알림을 보냅니다. +* 완료 후 SSM 문서를 정리합니다. + +**요구 사항:** + +* API Gateway 및 Systems Manager에 대한 권한이 있는 AWS 자격 증명 +* 공지 및 승인을 받기 위한 구성된 Slack 앱 +* 변경 추적을 통한 뉴렐릭 모니터링 + +**주요 작업**: `newrelic.nerdgraph.execute`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument` + +### EC2 인스턴스 관리 + +최적의 성능과 비용을 위해 EC2 인스턴스의 프로비저닝, 확장 및 종료를 자동화합니다. + +**이 흐름이 하는 일은:** + +* 뉴렐릭으로부터 높은 CPU 사용률 알림을 받았습니다. +* 알려진 세부 정보를 검색하고 영향을 받은 EC2 제외를 식별합니다. +* 인스턴스 세부 정보와 함께 Slack 공지를 보내고 크기 조정에 대한 승인을 requests . +* 승인 후 인스턴스 크기 조정을 자동화하기 위한 SSM 문서를 생성합니다. +* 인스턴스를 중지하고 인스턴스 유형을 수정한 후 다시 시작합니다. +* 크기 조정 프로세스 중에 Slack으로 진행 상황 업데이트를 보냅니다. +* 완료를 기다리고 성공 또는 실패 상태를 보냅니다. +* SSM 문서를 정리하고 최종 확인을 보냅니다. + +**요구 사항:** + +* EC2 및 Systems Manager에 대한 권한이 있는 AWS 자격 증명 +* EC2 지표에 대한 활성 뉴클릭 공지 용어 +* 공지 및 승인을 받기 위한 구성된 Slack 앱 + +**주요 작업**: `newrelic.nerdgraph.execute`, `newrelic.nrdb.query`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument`, `utils.datetime.fromEpoch`, `utils.uuid.generate` + +### 구현, 배포 롤백 + +롤백 구현, 부분이 비정상이 되는 경우 배포하고 AWS SQS 또는 HTTP로 알립니다. + +**이 흐름이 하는 일은:** + +* 지정된 기간 동안 패널의 공지 심각도를 모니터링합니다(기본값 30분). +* 매분 엔티티 상태를 확인합니다. +* 조각이 CRITICAL 또는 WARNING이 되면 비정상 상태를 기록합니다. +* AWS SQS를 통해 롤백 알림을 보냅니다(구성된 경우). 자세한 내용 포함 +* HTTP 웹후크를 통해 롤백 공지를 보냅니다(구성된 경우) +* 전체 기간 동안 정상 상태를 유지하면 로그인 성공 +* 엔티티가 발견되지 않으면 모니터링을 중지합니다. + +**요구 사항:** + +* 공지 심각도 검토를 통한 뉴렐릭 +* (선택사항) 롤백을 수신할 AWS SQS 대기열 및 역할 공지 +* (선택) 롤백을 받기 위한 HTTP 엔드포인트 공지 + +**주요 작업**: `newrelic.nerdgraph.execute`, `newrelic.ingest.sendLogs`, `aws.execute.api` (sqs.send\_message), `http.post` + +## 데이터 처리 및 보고 + +### Slack에 보고서 보내기 + +NRQL 쿼리 출력을 CSV 파일로 Slack에 보냅니다. + +**이 흐름이 하는 일은:** + +* 지정된 뉴렐릭 계정에 대해 NRQL 쿼리를 실행합니다. +* 쿼리 결과에서 CSV 파일을 생성합니다. +* 메시지와 함께 지정된 Slack 채널에 CSV 파일을 게시합니다. + +**요구 사항:** + +* 뉴렐릭 자격 증명 및 기능적인 NRQL 쿼리 +* 의의와 댓, 목표 채널로 구성된 Slack 앱 + +**주요 작업**: `newrelic.nrdb.query`, `utils.transform.toCSV`, `slack.chat.postMessage` + +### JSON 파싱 + +뉴렐릭 공개 상태 API JSON(HTTP)을 구문 분석하고 선택적으로 운영 및 비운영 구성 요소를 차단합니다. + +**이 흐름이 하는 일은:** + +* 뉴렐릭 상태 API에서 JSON 데이터를 가져옵니다. +* 구성 요소를 작동 상태에 따라 추출하고 분류합니다. +* 조건부로 운영 구성 요소를 테스트합니다(활성화된 경우) +* 비작동 구성 요소를 조건부로 로그합니다(활성화된 경우) +* HTTP 오류를 처리하고 로그인을 했습니다. + +**요구 사항:** + +* 뉴렐릭 상태 API (summary.json)에 대한 액세스 +* newrelic.ingest.sendLogs를 통해 로그를 보낼 수 있는 권한 + +**주요 작업**: `http.get`, `newrelic.ingest.sendLogs` + +## 사용 가능한 템플릿 흐름 + +위에 나열된 템플릿은 뉴렐릭 파라다이스 자동화 UI 에서 직접 사용할 수 있습니다. 접근 방법: + +1. **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation**로 이동 +2. **Create workflow** \[워크플로 만들기]를 클릭하세요. +3. **Use a template** \[템플릿 사용을]선택하세요 +4. 템플릿을 찾아보고 사용 사례에 맞는 활동 흐름을 선택하세요. + +각 템플릿에는 다음이 포함됩니다. + +* 사전 구성된 워크플로우 단계 및 로직 +* 예제 입력 매개변수, +* 필수 자격 증명 및 통합 +* 예상 결과 문서화 + +템플릿을 그대로 사용하거나 특정 요구 사항에 맞게 사용자 정의할 수 있습니다. + +## 단계 간 데이터 전달 + +모든 에라스우는 템플릿 구문을 사용하여 이전 단계의 출력을 참조할 수 있습니다. 이를 통해 여러 작업을 연결하고 복잡한 자동화 논리를 구축할 수 있습니다. + +### 기본 데이터 전달 + +```yaml +steps: + - name: getAlert + action: newrelic.nerdgraph.execute + inputs: + query: | + { + actor { + account(id: 123456) { + alerts { + violation(id: 789) { + condition + entity { + name + guid + } + } + } + } + } + } + + - name: sendToSlack + action: slack.chat.postMessage + inputs: + channel: "#incidents" + text: "Alert: ${{ .steps.getAlert.outputs.data.actor.account.alerts.violation.condition }}" +``` + +### 루프에서 데이터 사용 + +```yaml +steps: + - name: listInstances + type: action + action: aws.ec2.describeInstances + version: 1 + inputs: + filters: + - name: "tag:Environment" + values: ["production"] + + - name: checkEachInstance + type: loop + for: + in: "${{ .steps.listInstances.outputs.reservations }}" + steps: + - name: getInstanceMetrics + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + query: "SELECT average(cpuPercent) FROM SystemSample WHERE instanceId = '${{ .steps.checkEachInstance.loop.element.instanceId }}'" +``` + +### 데이터를 사용한 조건 논리 + +```yaml +steps: + - name: checkCPU + type: action + action: newrelic.nerdgraph.execute + version: 1 + # ... query configuration + + - name: decideAction + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 70 }}" + next: sendWarning + next: normalOperation + + - name: resizeInstance + type: action + action: aws.ec2.modifyInstanceAttribute + version: 1 + # ... resize configuration + + - name: sendWarning + type: action + action: slack.chat.postMessage + version: 1 + # ... warning message + + - name: normalOperation + type: action + action: newrelic.ingest.sendLogs + version: 1 + # ... log normal status +``` + +## 다음 단계 + +* **[나만의 워크플로우 만들기](/docs/workflow-automation/create-a-workflow-automation/create-your-own)** - 빌드 워크플로우 단계별 안내 +* **[작업 카탈로그](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)** - 사용 가능한 모든 작업 찾아보기 +* **[템플릿 사용](/docs/workflow-automation/create-a-workflow-automation/use-a-template)** - 구현하다, 배포하다 사전 구축된 흐름 +* **[AWS 자격 증명 설정](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)** - AWS 인증 구성 \ No newline at end of file diff --git a/src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx b/src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx new file mode 100644 index 00000000000..518f9563586 --- /dev/null +++ b/src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing.mdx @@ -0,0 +1,28 @@ +--- +title: Faturamento adicional (opcional) +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: Add-ons are an optional billing factor +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +Além dos fatores de cobrança principais do GB Ingested e do usuário faturável, você também pode usar complementos faturáveis opcionais para estender sua experiência com New Relic. + +* **Advanced Compute (anteriormente Add-on Compute)**: este complemento se aplica à cobrança baseada no uso para ações que você executa relacionadas ao CodeStream, Live Archives e outros recursos disponibilizados. Você é medido e cobrado com base no uso de [CCUs avançadas](/docs/licenses/license-information/product-definitions/new-relic-one-pricing-definitions/#compute-capacity-unit). + + + O uso do CodeStream no Advanced Computer incorrerá em cobranças de CCU, independentemente do tipo de usuário. Isso significa que o usuário básico gratuito pode acessar recursos de computador avançados e incorrer em cobranças por CCUs avançados. + + +* **EU Data Center for Original Data or Data Plus**: Este complemento se aplica à sua opção de dados (Dados Originais ou Dados Plus) quando você seleciona a União Europeia como sua região de dados, conforme disponível. + +* **Extended Retention for Original Data or Data Plus**: este complemento será aplicado se você exceder o período padrão de retenção dos seus dados. Isso se aplica a todos os seus dados — não apenas aos logs — e é uma boa opção se você precisar fazer muitas consultas pequenas ou consultar grandes volumes de dados. + +* **Live Archives**: estenda a duração do armazenamento de logs em até sete anos. Live Archives também requer um computador avançado. + +* **New Relic Synthetic Checks**: este complemento é aplicado caso suas verificações excedam o número padrão de verificações do monitoramento sintético. + +* **Security RX**: Este recurso está incluído no Data Plus, mas o complemento se aplica se você usar o recurso Security RX sem o Data Plus. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx b/src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx new file mode 100644 index 00000000000..6d724b3c3f9 --- /dev/null +++ b/src/i18n/content/pt/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing.mdx @@ -0,0 +1,354 @@ +--- +title: 'Dados: Faturamento e regras' +tags: + - Accounts + - Accounts and billing + - New Relic pricing and billing +metaDescription: 'For New Relic pricing, an explanation of how data ingest is calculated for billing purposes.' +freshnessValidatedDate: '2024-10-23T00:00:00.000Z' +translationType: machine +--- + +Para os preços da New Relic, os dados ingeridos pela sua organização New Relic são um fator de cobrança. + +## Saiba mais sobre custos [#costs] + +Se você ainda não é cliente New Relic e está curioso sobre custos, consulte primeiro [nossa página principal de preços](https://newrelic.com/pricing). Se você já é cliente, continue lendo para saber detalhes sobre o faturamento de ingestão de dados. + +## Ver a ingestão de dados na interface [#ui] + +Para saber como encontrar informações de uso e cobrança na interface, consulte [Interface de cobrança](/docs/accounts/accounts-billing/general-account-settings/introduction-account-settings). + +Para saber como visualizar e gerenciar a ingestão de dados, consulte [Gerenciar ingestão](/docs/data-apis/manage-data/manage-data-coming-new-relic). + +## Opções de dados: Data Plus e original [#data-prices] + +O preço da sua organização por GB de dados ingeridos varia dependendo da opção de dados que sua organização tem: **Data Plus** ou nossa opção **Original Data** . A opção Data Plus oferece recursos avançados de dados para desempenho, escala, segurança e governança otimizados. Uma organização New Relic pode ter apenas uma opção por vez. + +Aqui está uma tabela com comparações das duas opções. Os preços e limites são mensais e os preços estão em dólares americanos. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Recurso/habilidade + + **Original Data** opção + + **Data Plus** opção + + Mais detalhes do recurso +
+ [Edições](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#editions) + + Todas as edições + + Requer Standard, Pro ou Enterprise + + (Observamos abaixo se um recurso é específico de uma edição) + +
+ Limite de dados grátis + + 100 GB ingeridos + + 100 GB ingeridos + +
+ Preço dos dados
(além do limite livre) + 		+ US$ 0,40/GB ingerido + + US$ 0,60/GB ingerido + +
+ Limite livre de retenção de dados
([varia de acordo com o tipo de dados](/docs/data-apis/manage-data/manage-data-retention)) + 		+ Padrão de pelo menos 8 dias + + 90 dias extras por inadimplência + +
+ Preço para cada 30 dias adicionais de retenção
(além do limite gratuito) + 		+ +US$ 0,05/GB + + +US$ 0,05/GB + +
+ Preço adicional para armazenar dados no [data center da UE](/docs/accounts/accounts-billing/account-setup/choose-your-data-center)
+ 		+ +US$ 0,05/GB + + +US$ 0,05/GB + + Os dados são armazenados no data center dos EUA por padrão. +
+ [Limite máximo de consulta](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-limits) + + Até 20 bilhões de pontos de dados por minuto + + Até 60 bilhões de pontos de dados por minuto + +
+ [Duração máxima da consulta](/docs/query-your-data/nrql-new-relic-query-language/get-started/rate-limits-nrql-queries/#query-duration) + + 1 minuto + + Até 10 minutos + +
+ Escolha do provedor de nuvem + + Provedor de nuvem único + + Azure ou vários provedores de nuvem + + Escolha seu provedor de nuvem preferido para sua carga de trabalho de observabilidade para alinhar seu armazenamento de telemetria com seu modelo de implantação de engenharia e preferência de nuvem. +
+ [Ofuscação de logs](/docs/logs/ui-data/obfuscation-ui/) + + Mascarar [automaticamente](/docs/logs/get-started/new-relics-log-management-security-privacy/#log-obfuscation) padrões conhecidos de cartões de crédito e números de previdência social nos registros. + + Crie e rastreie regras diretamente na interface e [mascarar ou aplicar](/docs/logs/ui-data/obfuscation-ui/) dados log sensíveis a hash. + +
+ [Gerenciamento de vulnerabilidades New Relic ](/docs/vulnerability-management/overview)
(apenas usuário da plataforma completa) + 		+ +US$ 0,10/GB
(além do limite gratuito) + 		+ Standard, Pro e Enterprise + + Identifique vulnerabilidades e resolva riscos em todas as fases do ciclo de vida do software. +
+ Elegibilidade [FedRAMP Moderate](/docs/security/security-privacy/compliance/fedramp-compliant-endpoints) e [HIPAA](/docs/security/security-privacy/compliance/hipaa-readiness-new-relic) + + + + Empreendimento + + Obtenha conformidade de segurança por meio de configurações que ajudam você a atender aos requisitos FedRAMP e HIPAA. +
+ [Exportação de dados de streaming](/docs/apis/nerdgraph/examples/nerdgraph-streaming-export) + + + + Standard, Pro e Enterprise + + Configure regras para exportar simultaneamente dados de telemetria para o armazenamento AWS ou Azure de sua preferência. Serão aplicadas taxas de exportação adicionais para o provedor de nuvem. +
+ [Exportação de dados históricos](/docs/apis/nerdgraph/examples/nerdgraph-historical-data-export) + + + + Standard, Pro e Enterprise + + Execute consultas maiores sem tempo limite para análise e modelagem histórica, armazenamento de longo prazo e integração com outras plataformas de análise de dados. +
+ Serviço New Relic Nativo do Azure + + + + Standard, Pro e Enterprise
([com algumas limitações](#azure-native-data-plus)) + 		+
+ +Para ver uma comparação lado a lado do Data Plus e nossa opção de dados original, consulte [nossa planilha de dados do Data Plus](https://newrelic.com/resources/datasheets/data-plus). + +Interessado no Data Plus? Consulte [Atualizar para Data Plus](#upgrade-data-plus). + +### Detalhes do serviço New Relic nativo do Azure [#azure-native-data-plus] + +Com o [Azure Native New Relic Service](/docs/infrastructure/microsoft-azure-integrations/get-started/azure-native), você pode coletar e armazenar dados de telemetria para aplicativos e infraestrutura diretamente no Azure. Este recurso está incluído no Data Plus, mas com estas limitações: + +* Disponível apenas na região do data center dos EUA +* Elegibilidade FedRAMP moderada/HIPAA não disponível +* Exportação de dados históricos não disponível + +## Atualize para o Data Plus [#upgrade-data-plus] + +Para atualizar para o Data Plus, acesse a [interface do usuário**Data retention** ](/docs/data-apis/manage-data/manage-data-retention/#adjust-retention)no hub de gerenciamento de dados e clique em **Upgrade retention**. + +* Observação: você pode ver um botão **Edit data retention** , mas ele é diferente do botão **Upgrade retention** . +* Para ver o botão **Upgrade retention** , você precisa ter [permissões de faturamento](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts/#admin-settings). Se você atende aos requisitos e ainda não vê a opção **Upgrade retention**, fale com seu representante de conta New Relic . + +## O que conta como GB ingeridos faturáveis? [#usage-calculation] + +No contexto do [plano de preços da New Relic](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing), "dados ingeridos" referem-se aos dados salvos na New Relic pela sua organização depois de aplicarmos várias regras de corte e transformação de dados. Em outras palavras, não é a quantidade de dados brutos enviados para a New Relic, mas o tamanho dos dados que realmente acabam sendo armazenados. + +Em geral, os dados que geramos para fornecer nosso recurso não contam para seus GB ingeridos. Exemplos de recursos e dados relacionados a recursos que não contam para o GB Ingerido incluem: + +* [Funcionalidade básica de alerta](/docs/alerts-applied-intelligence/new-relic-alerts/learn-alerts/alerts-concepts-workflow). Por exemplo, `NrAiIncident`, um evento usado para gerar esses recursos, não conta para GB ingeridos. +* Dados criados por dados brutos agregados (por exemplo, [dados agregados de infraestrutura](/docs/data-apis/manage-data/manage-data-retention/#infrastructure-data) ou [dados métricos dimensionais](/data-apis/manage-data/manage-data-retention/#dimensional-metrics)). +* [métricas clássicas](/docs/apis/nerdgraph/examples/golden-metrics-entities-nerdgraph-api-tutorial) (para mais informações clássicas, consulte nossas [definições de entidade](https://github.com/newrelic/entity-definitions)). +* Verificação do monitoramento sintético. Para obter detalhes sobre o faturamento do Sintético, consulte [Limites e preços do Sintético](/docs/synthetics/synthetic-monitoring/using-monitors/monitor-limits). +* Dados de rastreamento de uso e faturamento (por exemplo, `NrConsumption`). +* Dados relacionados à administração da conta (por exemplo, `NrIntegrationError`, `NrAuditEvent`). + +Para entender seu uso, consulte a [interface de uso](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing#usage-ui). + +## Outros detalhes de cálculo [#calculation-details] + +* No contexto do nosso modelo de preços, um GB é definido como 1 bilhão de bytes. +* O GB ingerido mensalmente é arredondado para o número inteiro mais próximo. Por exemplo, se sua organização usa 100,9 GB durante um mês, isso é contado como 100 GB. + +## Edição grátis [#free-tier-limits] + +Para obter detalhes sobre o GB Ingested para nossa edição gratuita, consulte [Edição gratuita](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#free). + +## Saber mais [#related-docs] + +* Para obter mais informações sobre como gerenciar GB ingeridos, consulte [Gerenciar ingestão de dados](/docs/data-apis/manage-data/manage-data-coming-new-relic). +* Para saber como consultar o uso, veja [consulta e alerta de uso](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/usage-queries-alerts). \ No newline at end of file diff --git a/src/i18n/content/pt/docs/alerts/get-notified/notification-integrations.mdx b/src/i18n/content/pt/docs/alerts/get-notified/notification-integrations.mdx index cd12547169b..5b9c4017523 100644 --- a/src/i18n/content/pt/docs/alerts/get-notified/notification-integrations.mdx +++ b/src/i18n/content/pt/docs/alerts/get-notified/notification-integrations.mdx @@ -179,13 +179,13 @@ Leia mais sobre cada uma de nossas integração de notificação específica. * Se um endereço de e-mail já estiver associado a um destino existente, você será solicitado a mesclá-los. Selecione **Merge** para combinar destinos. * Se você adicionou um novo endereço de e-mail, o destinatário receberá um e-mail de verificação. O destinatário deve concluir o processo de verificação para começar a receber notificações. - - Limites de destino de e-mail: + + Limites de destino de e-mail: - * **Contas gratuitas**: Cada destino pode ter no máximo 5 endereços de e-mail. - * **Contas pagas**: cada destino pode ter no máximo 150 endereços de e-mail. - * **Limite de organização**: 1.000 endereços de e-mail exclusivos podem ser adicionados por clientes de organização por 24 horas (aplica-se a todos os usuários). - + * **Contas gratuitas**: Cada destino pode ter no máximo 5 endereços de e-mail. + * **Contas pagas**: cada destino pode ter no máximo 150 endereços de e-mail. + * **Limite de organização**: 1.000 endereços de e-mail exclusivos podem ser adicionados por clientes de organização por 24 horas (aplica-se a todos os usuários). + 10. Personalize a mensagem de e-mail. diff --git a/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx b/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx index 9c2ae7573af..7487d1c73a6 100644 --- a/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx +++ b/src/i18n/content/pt/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx @@ -268,21 +268,21 @@ Após a instalação, o agente automaticamente instrumento com nosso catálogo d | Nome do pacote | Versão mínima suportada | Última versão publicada | Introduzido em\* | | --------------------------------- | ----------------------- | ----------------------- | -------------------------------------- | | `@apollo/gateway` | 2.3.0 | 2.11.3 | `@newrelic/apollo-server-plugin@1.0.0` | -| `@apollo/server` | 4.0.0 | 5.0.0 | `@newrelic/apollo-server-plugin@2.1.0` | -| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.914.0 | 11.13.0 | -| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/client-sns` | 3.0.0 | 3.915.0 | 8.7.1 | -| `@aws-sdk/client-sqs` | 3.0.0 | 3.914.0 | 8.7.1 | -| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.914.0 | 8.7.1 | +| `@apollo/server` | 4.0.0 | 5.1.0 | `@newrelic/apollo-server-plugin@2.1.0` | +| `@aws-sdk/client-bedrock-runtime` | 3.474.0 | 3.918.0 | 11.13.0 | +| `@aws-sdk/client-dynamodb` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sns` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/client-sqs` | 3.0.0 | 3.918.0 | 8.7.1 | +| `@aws-sdk/lib-dynamodb` | 3.377.0 | 3.918.0 | 8.7.1 | | `@aws-sdk/smithy-client` | 3.47.0 | 3.374.0 | 8.7.1 | | `@azure/functions` | 4.7.0 | 4.8.0 | 12.18.0 | | `@elastic/elasticsearch` | 7.16.0 | 9.2.0 | 11.9.0 | -| `@google/genai` | 1.1.0 | 1.26.0 | 12.21.0 | +| `@google/genai` | 1.1.0 | 1.27.0 | 12.21.0 | | `@grpc/grpc-js` | 1.4.0 | 1.14.0 | 8.17.0 | | `@hapi/hapi` | 20.1.2 | 21.4.3 | 9.0.0 | | `@koa/router` | 12.0.1 | 14.0.0 | 3.2.0 | -| `@langchain/core` | 0.1.17 | 1.0.1 | 11.13.0 | -| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.1 | 13.2.0 | +| `@langchain/core` | 0.1.17 | 1.0.2 | 11.13.0 | +| `@modelcontextprotocol/sdk` | 1.13.0 | 1.20.2 | 13.2.0 | | `@nestjs/cli` | 9.0.0 | 11.0.10 | 10.1.0 | | `@opensearch-project/opensearch` | 2.1.0 | 3.5.1 | 12.10.0 | | `@prisma/client` | 5.0.0 | 6.18.0 | 11.0.0 | @@ -298,7 +298,7 @@ Após a instalação, o agente automaticamente instrumento com nosso catálogo d | `generic-pool` | 3.0.0 | 3.9.0 | 0.9.0 | | `ioredis` | 4.0.0 | 5.8.2 | 1.26.2 | | `kafkajs` | 2.0.0 | 2.2.4 | 11.19.0 | -| `koa` | 2.0.0 | 3.0.3 | 3.2.0 | +| `koa` | 2.0.0 | 3.1.1 | 3.2.0 | | `koa-route` | 3.0.0 | 4.0.1 | 3.2.0 | | `koa-router` | 12.0.1 | 14.0.0 | 3.2.0 | | `memcached` | 2.2.0 | 2.2.2 | 1.26.2 | @@ -306,7 +306,7 @@ Após a instalação, o agente automaticamente instrumento com nosso catálogo d | `mysql` | 2.16.0 | 2.18.1 | 1.32.0 | | `mysql2` | 2.0.0 | 3.15.3 | 1.32.0 | | `next` | 13.4.19 | 16.0.0 | 12.0.0 | -| `openai` | 4.0.0 | 6.6.0 | 11.13.0 | +| `openai` | 4.0.0 | 6.7.0 | 11.13.0 | | `pg` | 8.2.0 | 8.16.3 | 9.0.0 | | `pg-native` | 3.0.0 | 3.5.2 | 9.0.0 | | `pino` | 8.0.0 | 10.1.0 | 8.11.0 | diff --git a/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx b/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx index e682aa83dfd..31325bd0c8b 100644 --- a/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx +++ b/src/i18n/content/pt/docs/apm/agents/ruby-agent/getting-started/ruby-agent-requirements-supported-frameworks.mdx @@ -998,6 +998,68 @@ New Relic está expandindo seu suporte para bibliotecas de IA/ML. +## Biblioteca de registros + +O agente pode encaminhar logs das seguintes bibliotecas para [logs APM no contexto](/docs/logs/logs-context/get-started-logs-context/). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Biblioteca** + + **Nome da gema** + + **Suportado** + + **Notas** +
+ **Logger** + + `logger` + + + + Suporte para encaminhamento de logs APM usando a biblioteca do Logger de Rubby e qualquer biblioteca de logging que herde do Logger de Rubby, como ActiveSupport::BroadcastLogger. +
+ **Logstasher** + + `logstasher` + + 1.xx e superior + + Suporte para encaminhamento de logs APM. +
+ ## Outras bibliotecas e tecnologias [#other\_libraries][#other_libraries] @@ -1134,40 +1196,6 @@ New Relic está expandindo seu suporte para bibliotecas de IA/ML. - - - - - - - - - - - - - - - - - - @@ -82,4 +82,4 @@ Se você não vir os dados depois de esperar pelo menos 10 minutos, tente estas
- **Logger** - - `logger` - - - - Suporte para encaminhamento de logs APM usando a biblioteca de Logger do Ruby. -
- **Logstasher** - - `logstasher` - - 1.xx e superior - - Suporte para encaminhamento de logs APM. -
**Stripe** diff --git a/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/introdution.mdx b/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/introdution.mdx index 92210dfb439..00ebeefbd3c 100644 --- a/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/introdution.mdx +++ b/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/introdution.mdx @@ -20,6 +20,8 @@ Os principais recursos da Transação 360 incluem: * **Descoberta automática**: mapeamento dinâmico de relacionamento de serviço e visualização do fluxo de transações em tempo real. * **Visibilidade abrangente**: monitoramento full-stack, rastreamento de transações entre serviços e infraestrutura para visibilidade do browser. +* **Monitoramento do banco de dados**: insights profundos sobre o desempenho do banco de dados, análise de consultas e integridade da conexão em toda a sua workload de transação. +* **Tracking da função serverless**: Visibilidade completa do desempenho da função serverless, inicializações a frio e utilização de recursos. * **Análise histórica**: acesso a semanas de dados históricos, permitindo análise de tendências e reconhecimento de padrões. @@ -33,5 +35,7 @@ Para começar a usar o Transação 360, você precisa habilitar distributed trac ## Qual é o próximo - Aprenda a usar o Transaction 360 para problemas de desempenho de aplicativos + + Aprenda como usar a Transação 360 para problemas de desempenho do aplicativo, incluindo banco de dados e monitoramento Serverless + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx b/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx index a1424c7657d..66ccb839282 100644 --- a/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx +++ b/src/i18n/content/pt/docs/apm/transactions/workload-performance-monitoring/transaction-workloads.mdx @@ -3,88 +3,173 @@ title: Resolução rápida de problemas com o Transaction 360 tags: - transaction workloads - dynamic workload monitoring -metaDescription: Learn about the detailed page breakdown in New Relic's Transaction 360 feature. +metaDescription: Learn how Transaction 360 provides comprehensive workload visibility for faster troubleshooting and performance optimization. freshnessValidatedDate: never translationType: machine --- -Quando surgem problemas de desempenho do aplicativo, é crucial ter uma abordagem sistemática para identificar e resolver a causa raiz. Este guia orienta você a visualizar problemas de desempenho do aplicativo usando o Transaction 360. +O Transação 360 captura e correlaciona automaticamente todas as entidades e dados relacionados a uma transação específica, fornecendo uma visão abrangente da sua workload distribuída. Essa abordagem holística inclui fluxos de transações, relações de serviço e métricas de desempenho em toda a sua stack, permitindo que você identifique e resolva problemas rapidamente. -Como o Transaction 360 captura e correlaciona automaticamente todas as entidades e dados relacionados a um problema ou questão específica, ele fornece uma visão abrangente da workload. Essa visão inclui o fluxo de transações, relacionamentos de serviço e desempenho métrico, permitindo que você identifique e resolva problemas rapidamente. +## O que a Transação 360 mostra para você -## Navegue até a visualização Transaction 360 +O Transação 360 oferece três visualizações principais para ajudar você a entender sua workload: -Para acessar a visualização da carga de trabalho da transação, siga estas etapas: +* **Dashboard visão geral**: Resumo de alto nível com contagens de entidades, problemas e Monitoramento de Alterações +* **Mapa de fluxo dinâmico**: Representação visual dos caminhos de transação e dependência de serviço +* **detalhamento por entidade**: métrica de desempenho detalhada para todos os componentes participantes -1. Acesse **[one.newrelic.com](https://one.newrelic.com)> APM and Services**. -2. Na página de resumo APM , clique em **Transactions > Transaction Details > View transaction 360 workload**. +## Acesso à Transação 360 -A visualização Transaction 360 fornece uma análise detalhada da workload da transação, incluindo os seguintes componentes: +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > APM and Services** +2. Selecione seu serviço na página de resumo do APM. +3. Acesse **Transactions > Transaction Details > View transaction 360 workload** -* **Visão Geral da Transação 360**: Exibe o resumo workload da transação, incluindo o número de entidades envolvidas, alertas e Monitoramento de Alterações. + + As seções de banco de dados e monitoramento Serverless estão atualmente disponíveis em ambientes de preparação. Certifique-se de ter as permissões de conta apropriadas e a instrumentação adequada para acessar esses recursos. + -* **Mapa de fluxo dinâmico**: visualiza o fluxo de transações, mostrando os serviços envolvidos e o tempo gasto por cada serviço. +## Mapa de fluxo dinâmico -* **Entidade participante**: lista os serviços envolvidos na workload da transação, juntamente com seu desempenho métrico. + -## Visão geral da transação 360 +O mapa de fluxo visualiza a jornada da sua transação através dos seus sistemas distribuídos: -transaction-360-overview.webp +* **Conexões de serviço**: Veja como os serviços se comunicam e existem conexões entre eles. +* **Desempenho gargalo**: Identificar componentes lentos que afetam o ritmo geral de transação +* **Rastrear relações**: Clique nos pares de serviços para visualizar as métricas detalhadas de rastreamento entre eles. -A seção Visão geral da transação 360 fornece o seguinte resumo de alto nível da workload da transação associada: +### Recurso de colaboração -* **Entidade dependente:** O número total de entidades envolvidas na workload da transação, fornecendo insights como o número de entidades instrumentadas e não instrumentadas e o número de entidades com alertas. Além disso, você pode clicar na entidade instrumentada para visualizar suas métricas de desempenho detalhadas e serviços relacionados. Você também pode clicar na entidade não instrumentada para visualizar a lista de entidades que não estão instrumentadas, permitindo identificar a entidade que necessita de instrumentação. Da mesma forma, você pode clicar na entidade com alertas para visualizar a lista de entidades com alertas, permitindo que você priorize sua investigação com base na gravidade dos alertas. +* **Atribuição de equipe**: Atribuir equipes para tratar a carga de trabalho para resposta mais rápida a incidentes +* **Tagging**: entidade relacionada ao grupo para agilizar investigação e organização -* **Problemas:** O número de problemas detectados na workload da transação, incluindo alertas e marcadores de Monitoramento de Alterações. Clique em **View details** para visualizar a lista de problemas e identificar as entidades que são diretamente impactadas pelos problemas de desempenho. +## Análise do desempenho da entidade -* **Monitoramento de Alterações:** Quantidade de marcadores de Monitoramento de Alterações detectados na workload da transação, indicando alterações no desempenho da workload. Clique em **View details** para visualizar os marcadores de Monitoramento de Alterações e identificar a entidade que é diretamente impactada pelas mudanças de desempenho. +Esta seção fornece métricas detalhadas para cada tipo de componente em sua workload de transações: -## Mapa de fluxo dinâmico +### Serviços APM -O mapa de fluxo dinâmico visualiza o fluxo de transações, mostrando os serviços envolvidos e o tempo gasto por cada serviço. O mapa fornece uma visão geral de alto nível da workload da transação, permitindo que você identifique problemas de gargalo e desempenho. + -dynamic-map.webp +Monitore os serviços do seu aplicativo com: -Você pode selecionar serviços relacionados para visualizar a métrica de rastreamento entre eles. Além disso, você também pode atribuir uma equipe à workload da transação para facilitar a colaboração e a resolução de problemas, ou agrupar entidades relacionadas usando tags para agilizar o processo de investigação. +**Tabela de serviço Métrica:** -O mapa de fluxo dinâmico ajuda você a identificar os serviços que são diretamente afetados por problemas de desempenho, permitindo que você concentre sua investigação na causa raiz. +* **Taxas de transferência**: Solicitações por minuto para cada serviço +* **Taxa de erros**: Percentage of failed requests +* **Tempo de resposta**: Latência média por serviço +* **Gravidade do problema**: alertas críticos, de aviso e informativos para priorizar as correções. -## Entidade participante e apoiadora +**Análise da transação:** -### Entidade APM +* **Alterações de desempenho**: Transações com as maiores alterações no tempo de resposta +* **Detalhes do rastreamento**: Clique em qualquer transação para visualizar seu fluxo trace completo. -A seção de entidade participante fornece uma análise detalhada dos serviços envolvidos na workload da transação, como serviços APM , aplicativos de browser, aplicativo móvel, função serverless ou infraestrutura de entidade. +### infraestrutura entidade -partcipating-services.webp + -* **Métricas de desempenho:** A tabela de serviços APM exibe a métrica de desempenho de cada serviço, incluindo taxas de transferência, taxas de erros, latência e problemas com níveis de gravidade, como crítico, aviso e informação, para priorizar sua investigação. +Veja o desempenho da infraestrutura para hosts, contêineres e cluster do Kubernetes: -* **Tabela de transações:** você também pode usar a tabela Transações para identificar transações com a maior porcentagem de alteração no tempo de resposta, permitindo que você concentre sua investigação nas transações mais impactadas. Além disso, você pode selecionar uma transação específica para visualizar seu fluxo trace e desempenho métrico. +**Métrica de recursos:** -### infraestrutura entidade +* **Utilização da CPU**: Utilização do processador em toda a infraestrutura +* **Consumo de memória**: utilização de RAM e possíveis limitações. +* **I/O de disco**: desempenho de armazenamento e gargalo +* **Atividade de rede**: taxas de transferência de dados e problemas de rede + +**Análise do hospedeiro:** + +* **Classificação de recursos**: Identifique os hosts com maior consumo de recursos. +* **Serviços relacionados**: Veja quais aplicativos são executados em cada host. + +### Aplicativo Browser + + + +Monitore o desempenho do frontend e a experiência do usuário: + +**Desempenho métrico:** + +* **Tempo de carregamento da página**: Renderização de frontend e desempenho de carregamento +* **Erros de JavaScript**: erros do lado do cliente que afetam a experiência do usuário +* **Visualizações de página**: padrões Traffic e engajamento do usuário + +**Ferramentas de experiência do usuário:** + +* **Repetição da sessão**: assista às sessões do usuário para entender o impacto do desempenho no usuário real +* Clique em sessões para visualizar dados detalhados de interação do usuário. +* Para obter mais detalhes, consulte [a documentação Session Replay.](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/) + +### Monitoramento de banco de dados + +Acompanhe o desempenho do banco de dados com métricas abrangentes: + +**Visualização de desempenho:** + +* **Gráfico de taxas de transferência**: operações do banco de dados por minuto ao longo do tempo +* **Gráfico de tempo de consulta**: tendências de tempo de resposta e padrões de desempenho + +**tabela de análise consulta:** + +* **Operações do banco de dados**: contagens de chamadas, duração e métricas de tempo por consulta +* **Classificação de desempenho**: tempos de execução máximo, médio e total +* **Otimização de consultas**: Identifique as consultas mais lentas e mais frequentes. + +**Tabela de impacto da transação:** + +* **Dependência do banco de dados**: mostra quais transações dependem mais das operações do banco de dados +* **Alocação de tempo**: Porcentagem do tempo de transação gasto em chamadas de banco de dados +* **Otimização destino**: Transações com maior sobrecarga de banco de dados + +**Análise interativa detalhada:** + +* Clique em contagens de consulta para ver todas as consultas utilizadas por uma transação específica +* Clique nos nomes da transação para filtrar a consulta por aquela transação +* Acesse o rastreamento stack por meio de detalhes de consulta individuais. + +### função sem servidor + +Monitore o AWS Lambda e outros componentes sem servidor: + +**Gráficos de desempenho personalizáveis:** + +* **Padrões de invocação**: Frequência de execução da função ao longo do tempo +* **Métrica de duração**: Tempos de execução e tendências de desempenho +* **Utilização da memória**: padrões de consumo de recursos +* **Rastreamento de custos**: despesas associadas à invocação de funções. -Se você instrumentou sua entidade de infraestrutura, poderá visualizar a métrica de desempenho para sua entidade de infraestrutura na visualização Transaction 360. A seção infraestrutura entidade fornece um detalhamento da infraestrutura entidade envolvida na workload da transação, como hosts, contêiner e cluster do Kubernetes. +**Análise funcional:** -infrastructure-entities.webp +* **Relacionamentos de transação**: Veja quais transações acionam função serverless +* **impacto no desempenho**: como o desempenho da função afeta a velocidade geral da transação +* **Eficiência de recursos**: alocação de memória versus uso real -* **métrica de desempenho:** A tabela de infraestrutura entidade exibe a métrica de desempenho para cada entidade, incluindo uso de CPU, uso de memória, I/O de disco e I/O de rede, para identificar gargalos de desempenho e restrições de recursos. +### Aplicativo móvel -* **Tabela de hosts:** você também pode usar a tabela de hosts para encontrar a lista de infraestrutura da entidade e identificar hosts com maior uso de CPU, uso de memória, I/O de disco e I/O de rede, permitindo que você concentre sua investigação nos hosts mais afetados. Além disso, você pode selecionar um host específico para visualizar seu desempenho métrico e serviços relacionados. +Acompanhe o desempenho do aplicativo móvel dentro do seu fluxo de transações: -### Entidade Browser +* **Desempenho do aplicativo**: tempo de resposta e experiência do usuário métrica +* **Taxa de crash**: monitoramento de erros específicos para dispositivos móveis +* **Métrica do dispositivo**: desempenho em diferentes dispositivos móveis -Se você tiver instrumentado seu aplicativo de browser, poderá visualizar o desempenho métrico da entidade do seu browser na visualização Transaction 360. A seção entidade do browser fornece uma análise detalhada do aplicativo do browser envolvido na workload da transação. +### IA/LLM -browser-entities.webp +Monitore o desempenho e os custos do grande modelo de linguagem: -* **métrica de desempenho:** A tabela da entidade Browser exibe a métrica de desempenho de cada entidade, incluindo tempo de carregamento da página, visualizações de página e erros de JavaScript, para identificar problemas de desempenho gargalo e de experiência do usuário. +* **Desempenho do modelo**: tempo de resposta e métrica de precisão para serviços de IA +* **Rastreamento de custos**: uso de tokens e custos associados. +* **Taxa de erros**: Falhas em requests de IA e problemas de tempo limite -* **Session Replay:** Você também pode utilizar o recurso Session Replay para reproduzir sessões de usuário e identificar interações de usuário que levam a problemas de desempenho. Além disso, você pode selecionar uma sessão específica para visualizar seu desempenho métrico e serviços relacionados. Para mais informações, consulte [Session Replay](/docs/browser/browser-monitoring/browser-pro-features/session-replay/get-started/). +Para obter informações detalhadas sobre a configuração do Monitoramento de IA, consulte [a documentação do Monitoramento de IA](/docs/ai-monitoring/intro-to-ai-monitoring/). -### Entidade móvel +## Próximos passos -Se você tiver instrumentado seu aplicativo móvel, poderá visualizar a métrica de desempenho da sua entidade móvel na visualização Transaction 360. A seção de entidade móvel fornece uma análise detalhada do aplicativo móvel envolvido na workload da transação. +Após identificar problemas na Transação 360: -### AI Monitoring +1. **Priorize soluções**: comece com alerta crítico e problemas de desempenho de maior impacto +2. **Lacunas de instrumentos**: Adicionar monitoramento a entidades não instrumentadas para visibilidade completa +3. **Estabelecer monitoramento proativo**: Criar alertas para o principal desempenho limite +4. **Colabore**: Use atribuições de equipe e etiquetas para coordenar os esforços de resolução. -Se seu aplicativo estiver fazendo chamadas para um grande modelo de linguagem (LLM) e estiver instrumentado com o agente APM, você poderá visualizar a métrica de desempenho para sua entidade AI na visualização Transaction 360. A seção da entidade AI fornece uma análise detalhada do modelo de IA envolvido na workload da transação. Para obter mais informações, consulte [Monitoramento de IA](/docs/ai-monitoring/intro-to-ai-monitoring/). \ No newline at end of file +O Transação 360 oferece a visão abrangente que você precisa para entender, diagnosticar e resolver problemas rapidamente em toda a sua workload distribuída. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx b/src/i18n/content/pt/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx new file mode 100644 index 00000000000..72229e95225 --- /dev/null +++ b/src/i18n/content/pt/docs/browser/browser-monitoring/browser-pro-features/session-replay/advanced-session-replay.mdx @@ -0,0 +1,162 @@ +--- +title: Recurso de reprodução de sessão avançada +metaDescription: Manage session replay & modify capabilities depending on the role +freshnessValidatedDate: '2024-12-19T00:00:00.000Z' +redirect: + - /docs/browser/browser-monitoring/browser-pro-features/session-replay/sequence-filtering +translationType: machine +--- + +Este documento fornece informações sobre como você pode usar a reprodução de sessão para análises detalhadas, a fim de investigar e compreender o comportamento do usuário de forma eficiente. Agora você pode aproveitar New Relic AI para resumir automaticamente a trilha de eventos do Session Replay, usar a filtragem de sequência para identificar replays com padrões específicos de interação do usuário e cortar gravações para focar e compartilhar a parte mais relevante de uma sessão com a equipe ou pessoa responsável. + +## Resumo New Relic AI [#new-relic-ai] + +Você pode usar New Relic AI (NRAI) para ajudar a resumir e mapear os dados da trilha de eventos do Session Replay para que você possa entender melhor os erros e acertos da jornada do browser do seu usuário. + +Para usar o NRAI para resumir os dados da trilha de evento do Session Replay, você deve ter [o NRAI habilitado](/docs/agentic-ai/new-relic-ai/#enable) para sua conta. Depois que o NRAI estiver habilitado em sua conta, execute o seguinte para exibir seu resumo: + +1. Vá para **[one.newrelic.com > All Capabilities](https://one.newrelic.com/all-capabilities) > Browser**. + +2. Selecione seu aplicativo de browser. + +3. No menu à esquerda, role para baixo e clique em **Session replay**. + +4. Clique no replay para ver os detalhes da sessão que você gostaria de resumir. + + screenshot of the session replay page in browser + +5. Clique em **Summarize**. Um resumo da sessão é gerado no painel de foco. + + screenshot of the session replay page in browser + +## Filtragem de sequência [#sequence-filtering] + +O recurso **Sequence Filtering** ajuda a filtrar o Session Replay com base em uma sequência específica de eventos registrados durante a interação do usuário. Esta funcionalidade foi projetada para ajudar você a navegar com eficiência por diversas gravações de sessões na página **Session Listing** , facilitando a busca por replays relevantes. + +### Chave de recurso + +* **filtragem de sequência de eventos**: você pode filtrar replays especificando uma sequência de eventos em uma ordem específica, como um usuário realizando uma pesquisa e depois adicionando um item ao carrinho. +* **Filtros personalizáveis**: você pode selecionar atributos, operadores e valores para definir seus filtros de sequência. +* **Suporte para múltiplas ações**: você pode especificar até cinco ações em uma sequência. +* **Filtragem flexível**: os filtros podem ser aplicados em qualquer ordem, permitindo combinar filtros de sequência com outros tipos de filtros, como duração. + +### Personalize a visualização + +Por padrão, a **Sequence** é definida como **All**. Você pode personalizar a visualização selecionando o filtro **Sequence = All** e clicando na caixa de diálogo **Set up a filtering sequence** para definir seus filtros de sequência. + +1. Vá para **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**. +2. Selecione o filtro **Sequence = All** , a opção **Set up a filtering sequence** será exibida. +3. A opção **Set up a filtering sequence** permite que você crie um filtro de sequência especificando até 5 ações em uma ordem específica. Você pode definir a sequência selecionando o seguinte atributo: + + + Você deve adicionar pelo menos duas etapas ao formulário de filtro. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Ação + + Descrição +
+ Atributo + + Selecione um atributo: + + * **URL visualizada**: filtre os dados dependendo da URL da página visualizada pelo usuário. + + * **Ação da página**: filtre os dados com base na interação do usuário com a página. + + * **Entrada do teclado**: filtre os dados com base na entrada do teclado do usuário. Você pode ampliar ainda mais a pesquisa selecionando as opções abaixo: + + * **Destino**: Selecione o elemento alvo onde a entrada do teclado foi feita. + * **Destino ID**: Selecione o destino ID onde a entrada do teclado foi feita. + * **Classe destino**: Selecione a classe destino onde a entrada do teclado foi feita. + + * **Cliques do usuário**: Filtre os dados com base nos cliques do usuário. +
+ Operador + + Selecione uma operadora entre as opções abaixo: + + * **=**: Onde o valor fornecido é igual ao valor do atributo do incidente. + * **Como**: Quando o valor fornecido for semelhante ao valor do atributo do incidente. +
+ Valor + + Pesquise ou insira um valor. +
+ +4. Clique em **Apply**. + + Screenshot of session replay details + +## Reprise da sessão cortada [#trimmed-session-replay] + +O recurso de **Trimmed session replay** \[Reprodução de Sessão Aparada] permite extrair e compartilhar segmentos específicos de gravações de sessão, concentrando-se em eventos relevantes para análise de destino e resolução mais rápida de problemas. Em vez de compartilhar gravações longas na íntegra, você pode criar clipes focados que destaquem os momentos exatos em que os problemas ocorrem. + +### Criar uma reprodução de sessão reduzida + +1. Vá para **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Session replay**. + +2. Selecione a reprodução da sessão que deseja cortar. + +3. Clique em **Share a clip** nos controles de Reprodução da Sessão. + +4. Selecione os limites do seu clipe usando os controles da linha do tempo: + + * Arraste a seta para a esquerda para definir o horário de início do seu clipe. + * Arraste a seta para a direita para definir o tempo final do seu clipe. + +5. Preencha o formulário com os detalhes do vídeo: + + * Escolha por quanto tempo o link do clipe deve permanecer ativo usando o dropdown **Availability**. + * Adicione uma mensagem (opcional) - forneça contexto sobre o que o vídeo mostra. + * Adicione endereços de e-mail para compartilhar o vídeo diretamente com membros específicos da equipe. + +6. Revise sua seleção. A seção destacada mostra o que será incluído no seu vídeo. + +7. Clique em **Share this clip** para gerar seu segmento recortado. + +### Acessando clipes compartilhados + +Quando você recebe uma gravação de sessão editada de um membro da equipe: + +1. **Por meio de notificação por e-mail**: Se você foi adicionado como destinatário, receberá um e-mail com o link do clipe e qualquer mensagem fornecida pelo remetente. +2. **Por meio de URL compartilhada**: Clique no link compartilhado no painel de discussão para abrir a gravação da sessão editada no seu navegador. + + + No Safari, o URL compartilhado não pode ser copiado automaticamente. Você precisará copiar manualmente o link gerado e compartilhá-lo com os destinatários. + + +3. **Veja o vídeo**: O vídeo é reproduzido automaticamente e mostra apenas o segmento selecionado, juntamente com qualquer mensagem de contexto do remetente. + +4. **Disponibilidade dos vídeos**: Os vídeos têm datas de expiração definidas pelo remetente. Verifique a janela **Availability** caso não consiga acessar um clipe compartilhado anteriormente. + + screenshot of the session replay page in browser \ No newline at end of file diff --git a/src/i18n/content/pt/docs/cci/configure-cci/general-setting.mdx b/src/i18n/content/pt/docs/cci/configure-cci/general-setting.mdx index 51b145e5e15..b532be6ba3f 100644 --- a/src/i18n/content/pt/docs/cci/configure-cci/general-setting.mdx +++ b/src/i18n/content/pt/docs/cci/configure-cci/general-setting.mdx @@ -43,10 +43,10 @@ A Inteligência de Custos na Nuvem suporta tag personalizada junto com tag padr 1. Para solicitar informações sobre as contas das quais você deseja extrair dados de telemetria para análise de custos, selecione a aba **Telemetry Data** . 2. Para visualizar e gerenciar dados de telemetria para sua análise de custos, na lista **Select accounts for telemetry data** , escolha uma ou mais contas. - - * A estimativa de custos em tempo real é suportada por dados de telemetria. - * A alocação de K8s é suportada por dados de telemetria. - * Reutilizamos o pipeline de telemetria existente para obter a métrica de utilização, e nenhum dado novo é ingerido, exceto a ingestão do arquivo CUR. - + + * A estimativa de custos em tempo real é suportada por dados de telemetria. + * A alocação de K8s é suportada por dados de telemetria. + * Reutilizamos o pipeline de telemetria existente para obter a métrica de utilização, e nenhum dado novo é ingerido, exceto a ingestão do arquivo CUR. + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx b/src/i18n/content/pt/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx index 3513db9d86e..13e50462e05 100644 --- a/src/i18n/content/pt/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx +++ b/src/i18n/content/pt/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx @@ -60,7 +60,7 @@ Um usuário diferente de `root` pode ser usado na política gerenciada. Statement: - Effect: Allow Principal: - AWS: !Sub 'arn:aws:iam::754728514883:root' + AWS: !Sub 'arn:aws:iam::253490767857:root' Action: 'sts:AssumeRole' Condition: StringEquals: diff --git a/src/i18n/content/pt/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx b/src/i18n/content/pt/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx index 121cceea9c8..ef76ef5db6e 100644 --- a/src/i18n/content/pt/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx +++ b/src/i18n/content/pt/docs/infrastructure/amazon-integrations/troubleshooting/no-data-appears-aws-integrations.mdx @@ -21,10 +21,10 @@ Se você não vir os dados depois de esperar pelo menos 10 minutos, tente estas 1. Certifique-se de que o agente de infraestrutura esteja [instalado e funcionando corretamente](/docs/infrastructure/new-relic-infrastructure/troubleshooting/no-data-appears-infrastructure). Você precisa instalar o agente de infraestrutura **first** e, em seguida, conectar-se à sua conta da AWS. - Se você vir nomes de atributos, mas nenhum dado, em **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events** ou **Infrastructure > Settings > Agents**, talvez você não tenha instalado o agente de infraestrutura. + Se você vir nomes de atributos, mas nenhum dado, em **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > Events** ou **Infrastructure > Settings > Agents**, talvez você não tenha instalado o agente de infraestrutura. -2. Corrija todos os erros que você vê no painel de status da conta. Vá para **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS** e selecione **Account status dashboard** para cada uma de suas contas. +2. Corrija todos os erros que você vê no painel de status da conta. Vá para **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS** e selecione **Account status dashboard** para cada uma de suas contas. Se você vir relatórios **Role errors** ou **Permission errors**, consulte nossas [políticas de integração e gerenciamento](/docs/integrations/amazon-integrations/getting-started/integrations-managed-policies) e verifique se concedeu New Relic as permissões necessárias para ler os dados relevantes de sua conta. @@ -52,7 +52,7 @@ Se você não vir os dados depois de esperar pelo menos 10 minutos, tente estas 		- `754728514883` + `253490767857`
-3. Certifique-se de estar [procurando seus dados no lugar certo](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric) . Você pode encontrar todos os dados de integração em [métrica e evento](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer). +3. Certifique-se de estar [procurando seus dados no lugar certo](/docs/infrastructure/integrations-getting-started/getting-started/understand-integration-data-data-types#metric) . Você pode encontrar todos os dados de integração em [métrica e evento](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer). \ No newline at end of file diff --git a/src/i18n/content/pt/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx b/src/i18n/content/pt/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx index 55dedfe93b7..44daae5d88d 100644 --- a/src/i18n/content/pt/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx +++ b/src/i18n/content/pt/docs/logs/ui-data/find-unusual-logs-log-patterns.mdx @@ -13,14 +13,10 @@ Padrões de log são a maneira mais rápida de descobrir valor nos dados log sem Os dados de log são telemetria de alto volume com um valor baixo por registro individual. A pesquisa pode levar rapidamente a registros que fornecem uma explicação da causa raiz, mas a maioria dos dados é repetitiva e difícil de contextualizar durante a navegação. Os padrões podem tornar os dados de log detectáveis sem gastar muito tempo lendo dados de baixo valor. -Screenshot of Log patterns UI +Screenshot of Log patterns UI
- **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: Padrões de log ajudam você a detectar picos ou quedas suspeitas na mensagem do log sem ter que gastar mais tempo pesquisando. + **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs > Patterns**: Padrões de log ajudam você a detectar picos ou quedas suspeitas na mensagem do log sem ter que gastar mais tempo pesquisando.
## Visão geral técnica [#overview] @@ -67,11 +63,11 @@ Se você vir **Patterns are turned off** em sua interface de registro - Contas HITRUST + Contas HIPAA - O recurso Padrões de log não é compatível com FedRAMP. FedRAMP ou outras contas HITRUST não são elegíveis para usar padrões. + O recurso Padrões de log não é compatível com FedRAMP. Contas FedRAMP ou outras contas HIPAA não são elegíveis para usar padrões. @@ -81,7 +77,7 @@ Se você vir **Patterns are turned off** em sua interface de registro - Temos um sistema de limites de segurança de memória e recursos de CPU ao combinar log com padrões. Estes limites de correspondência podem ter um impacto na percentagem de toras que podem ser agrupadas em Padrões de toras. No entanto, a correspondência de Padrões de log é um processo de "melhor esforço": não é um erro se nem todos os seus logs tiverem a oportunidade de serem agrupados por padrões. Você ainda obterá valor do agrupamento que pode ser feito dentro dos limites de recursos. + Temos um sistema de limites de segurança de memória e recursos de CPU ao combinar log com padrões. Estes limites de correspondência podem ter um impacto na percentagem de toras que podem ser agrupadas em Padrões de toras. No entanto, a correspondência de Padrões de log é um processo de "melhor esforço": não é um erro se nem todos os seus logs tiverem a oportunidade de serem agrupados por padrões. Você ainda obterá valor do agrupamento que pode ser feito dentro dos limites de recursos. @@ -91,21 +87,8 @@ Se você vir **Patterns are turned off** em sua interface de registro Para começar a examinar padrões: -1. Vá para - - - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs** - - - e use o dropdown do seletor de contas para selecionar a conta de destino onde deseja explorar padrões. - -2. Na navegação esquerda da interface de registro, clique em - - - **Patterns** - - - . +1. Vá para **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Logs** e use o dropdown do seletor de contas para selecionar a conta de destino onde deseja explorar padrões. +2. Na navegação esquerda da interface de registro, clique em **Patterns**. A interface principal log muda para mostrar padrões que correspondem à consulta na barra de consulta. Para visualizar o registro de um período de tempo específico, clique nesse ponto (ou clique e arraste uma área) no gráfico ou use o seletor de hora. @@ -223,11 +206,5 @@ Aqui estão alguns motivos pelos quais você tem padrões ativados, mas não vê Padrões são um valor que é enriquecido na mensagem do log existente como um novo atributo chamado `newrelic.logPattern`. Tudo o que você pode fazer com toras geralmente pode ser feito com Padrões de toras, como: * Crie seu próprio [painel](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards) com padrões para monitor um padrão específico ou grupo de padrões de seu interesse. - -* Crie - - - - para padrões adicionando [alertas NRQL](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions). - -* Utilize [anomalia condição do alerta](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions) para detectar anomalia em Padrões de log conhecidos. +* Crie para padrões adicionando [alertas NRQL](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions). +* Utilize [anomalia condição do alerta](/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/other-condition-types/create-anomaly-alert-conditions) para detectar anomalia em Padrões de log conhecidos. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx b/src/i18n/content/pt/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx index 71502c64e96..60c8ec2fe65 100644 --- a/src/i18n/content/pt/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx +++ b/src/i18n/content/pt/docs/opentelemetry/get-started/apm-monitoring/opentelemetry-apm-ui.mdx @@ -204,7 +204,13 @@ A página de tempo de execução do Go fornece ferramentas para identificar prob A página do tempo de execução do Go mostra sinais clássicos junto com a métrica do tempo de execução do Go para correlacionar problemas de tempo de execução com o uso do serviço. -Os dados assumidos pela consulta são produzidos pela [biblioteca de instrumentação de tempo de execuçãoOpenTelemetry Go](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/). Observe que atualmente não há convenções semânticas para métricas de tempo de execução do Go. +Os dados assumidos pela consulta são produzidos pela [biblioteca de instrumentação de tempo de execuçãoOpenTelemetry Go](https://opentelemetry.io/docs/specs/semconv/runtime/go-metrics/). + + + As [convenções semânticas](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/runtime/go-metrics.md) para o ambiente de execução Go Métrica ainda estão em desenvolvimento. A página de tempo de execução do Go, destino, é uma versão mais antiga das convenções. Você deve habilitar as convenções antigas ativando a variável de ambiente `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS`. Para obter mais informações, consulte a [documentação](https://github.com/open-telemetry/opentelemetry-go-contrib/blob/9a6e0bf68e1da495be52faf152b5b4e6fb09d475/instrumentation/runtime/internal/x/README.md) da instrumentação. + + A New Relic eventualmente dará suporte às novas convenções assim que elas se tornarem estáveis. + ### Registro [#logs-page] diff --git a/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx new file mode 100644 index 00000000000..1e084c9768b --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-10-25-2025.mdx @@ -0,0 +1,71 @@ +--- +subject: Docs +releaseDate: '2025-10-25' +version: 'October 19 - October 24, 2025' +translationType: machine +--- + +### Novos documentos + +* Adicionada Inteligência de Custos na Nuvem [Azure](/docs/cci/azure-cci) e [Google Cloud Platform (GCP)](/docs/cci/gcp-cci) para fornecer orientação abrangente para conectar a integração de faturamento Azure e GCP com New Relic para monitoramento e otimização de custos. + +### Grandes mudanças + +* [Relatório de compatibilidade do agente Node.js](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent) atualizado. +* [Introdução atualizada ao NRQL](/docs/nrql/get-started/introduction-nrql-new-relics-query-language) com conteúdo simplificado para melhor experiência do usuário. +* Adicionado suporte ao ConfigMap para o agente Java no [operador do agente Kubernetes](/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-agent-operator). + +### Pequenas mudanças + +* Corrigidos links quebrados para [Definir limite condição do alerta](/docs/alerts/create-alert/set-thresholds/set-thresholds-alert-condition). +* Documentação [de introdução do criador de consulta](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) aprimorada com visuais aprimorados. +* Adicionado suporte para renderização de equações matemáticas na documentação. +* [Funcionalidade aprimorada de pausa de](/docs/browser/new-relic-browser/browser-apis/pauseReplay) Session Replay e documentação [de funcionalidade de gravação](/docs/browser/new-relic-browser/browser-apis/recordReplay) com orientação aprimorada. +* Os requisitos distributed tracing do navegador do agente foram atualizados em várias páginas de documentação para maior clareza. +* [Configuração do gerenciador de tarefas Sintéticos](/docs/synthetics/synthetic-monitoring/private-locations/job-manager-configuration/#kubernetes-sizing) atualizada com equação matemática aprimorada para considerações de dimensionamento para Docker, Podman, Kubernetes e OpenShift. +* Problemas de MDX corrigidos que afetavam a renderização de documentos. + +### Notas de versão + +* Fique por dentro dos nossos últimos lançamentos: + + * [Agente Browser v1.300.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.300.0): + + * Removido o uso de marcas e medidas do sinalizador de recurso para todos os usuários. + * HasReplay atributo falso positivo rate reduzido. + * Tipificações de API de interação atualizadas para refletir o parâmetro waitForEnd. + * Corrigidos problemas dinâmicos requeridos com agregar.js. + + * [Agente Browser v1.301.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.301.0): + + * Mudou para usar a versão bifurcada do rrweb da New Relic para o Session Replay. + * Atributo de agente preservado para carga de log com tratamento de precedência adequado. + + * [Integração Kubernetes v3.47.0](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-47-0): + + * Recursos de monitoramento aprimorados para ambientes Kubernetes. + * Melhor coleta de recursos e otimizações de desempenho. + + * [AgenteNode.js v13.5.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-5-0): + + * Atualizada a instrumentação do fastify para subscrever o evento emitido. + * Instrumentação pg e pg-native atualizada para melhor monitoramento do banco de dados. + * Timers.setTimeout e timers.setInterval desabilitados por padrão para melhor desempenho. + * Adicionada nova classe base de diagnóstico para melhor resolução de problemas. + + * [Agente iOS v7.5.11](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-7511): + + * Corrigidos problemas de desempenho com o Tracing de interação. + * Corrigido mensagens do log de rastreamento distribuído incorretos. + + * [AgenteAndroid v7.6.10](/docs/release-notes/mobile-release-notes/android-release-notes/android-7610): + + * Adicionado suporte ao Gradle 9 para melhor compatibilidade de compilação. + + * [agente de infraestrutura v1.69.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1690): + + * Recursos aprimorados de monitoramento do sistema e correções de bugs. + + * [agente de infraestrutura v1.70.0](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1700): + + * Melhorias adicionais de desempenho e aprimoramentos de monitoramento. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx new file mode 100644 index 00000000000..465d315090e --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-01-2025.mdx @@ -0,0 +1,99 @@ +--- +subject: Docs +releaseDate: '2025-08-01' +version: 'July 25 - August 01, 2025' +translationType: machine +--- + +### Novos documentos + +* Adicionadas [documentações de orçamentos de computador](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) para fornecer um mecanismo para monitorar e alertar sobre o uso da unidade de consumo (CCU) do seu computador. + +### Grandes mudanças + +* [Compatibilidade e requisitos](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent) atualizados para o agente Node.js. + +* [Compatibilidade e requisitos atualizados para o Alpine Linux](/docs/apm/agents/php-agent/getting-started/php-agent-compatibility-requirements) para o agente PHP. + +* Atualizados os requisitos específicos do agente para [Controle de Pipeline](/docs/new-relic-control/pipeline-control/modify-agent-configuration). + +* Atualizou o JFR relacionado aos requisitos de configuração para [o agente Java](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file#jfr-harvest-interval). + +* Atualizadas as informações de preços e cobrança do New Relic em: + + * [Dados: Faturamento e regras](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/data-ingest-billing) + * [Consultas e alertas relacionados a uso](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/usage-queries-alerts) + * [Plano de uso do New Relic](/docs/licenses/license-information/usage-plans/new-relic-usage-plan) + +### Pequenas mudanças + +* Esclareceu a linguagem no .NET agente para capturar o parâmetro SQL no [.NET compatível com o agente e o documento de requisitos](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements). +* Aprimorou a linguagem no [Oracle banco de dados monitoramento integração](/docs/infrastructure/host-integrations/host-integrations-list/oracle-database-monitoring-integration). + +### Notas de versão + +* Confira nossas postagens de Novidades: + + * [Orçamentos de computadores agora disponíveis para o público em geral](/whats-new/2025/07/whats-new-7-30-compute-budgets). + * [Aumentando a experiência do usuário: aproveitando Session Replay para otimização vital da Web](/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser). + +* Fique por dentro dos nossos últimos lançamentos: + + * [AgenteAndroid v7.6.8](/docs/release-notes/mobile-release-notes/android-release-notes/android-768): + + * Corrigido um problema em que o rastreamento stack para erros do Unity não era exibido corretamente. + * Corrigido um problema que impedia que o resumo métrico fosse gravado quando o aplicativo retornava ao primeiro plano após seu lançamento inicial. + * Corrigido um problema em que JSON inválido em entradas de log poderia causar erros. + + * [CLI de diagnóstico (nrdiag) v3.4.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-341): + * Adicionado `K8s/AgentControl/agent-control-install-job-logs` para coletar logs gerados pela instalação do controle do agente. + + * [Gerenciador de tarefas v451](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-451): + + * Vulnerabilidades corrigidas relacionadas ao `common-lang3` Java e Ubuntu para resolver problemas de segurança no SJM. + * Implementou alterações na migração da fila do processador relacionadas à migração da nossa arquitetura de serviço interna. + * Corrigido um problema para incluir detalhes completos da exceção para fornecer melhor contexto para resolução de problemas em logs do SJM. + + * [Aplicativo móvel para Android v5.30.1](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5301): + * Melhorou a experiência de login. + + * [Aplicativo móvel para iOS v7.5.8](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-758): + + * Criei o agente usando o Xcode 16.4. + * Corrigido um problema que poderia fazer com que distributed tracing não tivesse todas as informações de conta necessárias no início de uma sessão. + * Corrigido um problema que poderia causar uma falha na inicialização do agente. + + * [Tempo de execução da API do Node](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.122): + * Corrigidas as vulnerabilidades de dados de formulário e as vulnerabilidades subjacentes do Ubuntu para lidar com vulnerabilidades de segurança em tempos de execução API do Node. + + * [Node browser runtime](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.39): + * Corrigidas as vulnerabilidades de dados de formulário e as vulnerabilidades subjacentes do Ubuntu para lidar com vulnerabilidades de segurança em tempos de execução do Node Browser. + + * [Tempo de execução do ping](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.0): + * Vulnerabilidades corrigidas relacionadas ao `common-lang3` Java e Ubuntu para resolver problemas de segurança no tempo de execução do Ping. + + * [Agente Python v10.15.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101500): + + * Adicionado suporte para [`oracledb`](https://pypi.org/project/oracledb/) + * Corrigido um bug na instrumentação `MessageBroker` onde os métodos de serialização estavam procurando o atributo `destination_name` no `MessageTransaction` e ele não existia. + * Corrigiu o problema de metadados de utilização da AWS ao executar AWS e K8s juntos. + + * [AgenteRuby v9.20.0](/docs/release-notes/agent-release-notes/ruby-release-notes/ruby-agent-9-20-0): + + * Adicionado suporte para registrar o ID do Docker ao executar no ambiente AWS ECS Fargate. + * Adicionado um novo método auxiliar para simplificar a comparação de versões. + * Adicionado o atributo `code.stacktrace` aos intervalos de armazenamento de dados quando a duração excede o limite configurado. + * Links de origem corrigidos `Brewfile`. + * Corrigido um erro que ocorre ao usar `HTTPX 1.5.0` para armazenar resposta. + * Melhorou as informações registradas no nível de depuração pelo agente quando o agente lê uma fonte de configuração. + + * [Agente Unity v1.4.8](/docs/release-notes/mobile-release-notes/unity-release-notes/unity-agent-148): + + * O agente Android nativo foi atualizado para a versão 7.6.7. + * O agente nativo do iOS foi atualizado para a versão 7.5.6. + + * [Agente Unity v1.4.9](/docs/release-notes/mobile-release-notes/unity-release-notes/unity-agent-149): + + * O agente Android nativo foi atualizado para a versão 7.6.8. + * O agente nativo do iOS foi atualizado para a versão 7.5.8. + * Problema de rastreamento stack de exceção do Unity corrigido quando namespace é usado. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx new file mode 100644 index 00000000000..56fc49bcdf6 --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-08-2025.mdx @@ -0,0 +1,60 @@ +--- +subject: Docs +releaseDate: '2025-08-08' +version: 'August 01 - August 07, 2025' +translationType: machine +--- + +### Novos documentos + +* Adicionado [tutorial do NerdGraph: Criar função personalizada para equipes](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview) para orientar você no uso da API NerdGraph do New Relic para criar e gerenciar funções personalizadas para equipes. + +### Pequenas mudanças + +* Alterado o [limite de eventos de alerta por condição](/docs/alerts/admin/rules-limits-alerts) para 1k por minuto. +* Atualizadas as últimas [versões e requisitos compatíveis do agente .Net](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements) verificados. +* Atualizadas as informações de versão e suporte de versão sobre o service broker para [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-service-broker-integration). +* Atualizadas as informações de suporte de versão sobre o pacote de integração New Relic NGINX para [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-nginx-buildpack-integration). +* Atualizadas as informações de versão e suporte de versão sobre o New Relic Nozzle para [VMware Tanzu](/docs/infrastructure/other-infrastructure-integrations/cloudfoundry-integrations/vmware-tanzu-firehose-nozzle-integration/#product-snapshot). + +### Notas de versão + +* Confira nossas postagens de Novidades: + + * [Errors Inbox agora está integrada à carga de trabalho](/whats-new/2025/08/whats-new-08-06-workloads-errors-inbox). + +* Fique por dentro dos nossos últimos lançamentos: + + * [Gerenciador de tarefas v452](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-452): + * Melhorias internas adicionadas para tratamento de exceções no processamento de mensagens da fila. + + * [IntegraçãoKubernetes v3.43.3](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-43-3): + * Adicionou um gráfico Helm para implantar a solução de monitoramento Kubernetes da New Relic. + + * [Controle de Pipeline Gateway v1.1.0](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-08-05): + + * Implementou uma nova funcionalidade para descartar seletivamente dados e atributos dos eventos `SqlTrace` e `TransactionTrace` usando regras de descarte. + + * Foram corrigidas vulnerabilidades no pacote `golang.org/x/net`, incluindo um problema de script entre sites e um desvio de proxy HTTP relacionado a IDs de zona IPv6. + + * Atualizado para Go `1.24` e as seguintes dependências foram atualizadas para aumentar a segurança e incorporar correções recentes: + + * `golang.org/x/net to v0.38.0` + * `golang.org/x/sys to v0.31.0` + * `golang.org/x/text to v0.23.0` + + * [Aplicativo móvel para iOS v6.9.11](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6101): + * Reduziu o fluxo de login em duas etapas, armazenando o domínio de autenticação do usuário e redirecionando-o diretamente para sua página de login. + + * [AgenteFlutter v1.1.13](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1113): + + * Agente Android nativo aprimorado e atualizado para a versão 7.6.8 + * Agente iOS nativo aprimorado atualizado para a versão 7.5.8 + + * [Agente .NET MAUI v1.1.11](/docs/release-notes/mobile-release-notes/net-maui-release-notes/net-maui-agent-1111) + + * Agente Android nativo aprimorado e atualizado para a versão 7.6.8 + * Agente iOS nativo aprimorado atualizado para a versão 7.5.8 + + * [agente de infraestrutura v1.65.5](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1655): + * Alterado o suporte para montagens AWS efs em amostras de armazenamento \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx new file mode 100644 index 00000000000..1ca88ca0ec1 --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-14-2025.mdx @@ -0,0 +1,112 @@ +--- +subject: Docs +releaseDate: '2025-08-15' +version: 'August 08 - August 14, 2025' +translationType: machine +--- + +### Novos documentos + +* Adicionado [suporte para funções NRQL em regras de gateway](/docs/new-relic-control/pipeline-control/nrql-functions) para delinear as funções NRQL suportadas nas regras de gateway do Controle de Pipeline . +* Adicionadas etapas de resolução de problemas para resolver [eventos de reinicialização frequente de Fluent Bit](/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/frequent-fluent-bit-restart-events) ajustando as configurações de resolução de nome do host na configuração do agente do New Relic Infrastructure. + +### Grandes mudanças + +* [Plano de uso](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/#list-price) atualizado com as informações de preços mais recentes. +* **Errors Inbox** adicionada à [interface de carga de trabalho](/docs/new-relic-solutions/new-relic-one/workloads/use-workloads/#errors). +* Adicionada desativação seletiva do agente com base na classe principal de inicialização ou no jar executável por meio de variáveis de ambiente, juntamente com configurações de segurança aprimoradas para [configuração do agente Java](/docs/apm/agents/java-agent/configuration/java-agent-configuration-config-file/#skip-applications). +* Adicionado suporte para [configuração de repositório privado](/docs/new-relic-control/agent-control/configuration/#private-repository-configuration) no Controle de Agente, possibilitando a implantação de agente gerenciado com autenticação via métodos de certificado básico ou TLS. +* Adicionado suporte para [Gerenciamento de Segredos](/docs/new-relic-control/agent-control/configuration/#secrets-management) no Agente de Controle, para gerenciar dados confidenciais, como senhas e chaves de API, recuperando-os de um provedor de segredos dedicado. + +### Pequenas mudanças + +* Adicionadas restrições de tag de entidade para a cláusula `WHERE` em [Drop data usando regras cloud do Controle de Pipeline ](/docs/new-relic-control/pipeline-control/cloud-rules-api/#restrictions). +* Adicionadas [práticas recomendadas para otimizar o conteúdo da sua fonte de conhecimento](/docs/agentic-ai/knowledge-integration/overview/#configure) para o conector New Relic AI Knowledge. + +### Notas de versão + +* Confira nossas postagens de Novidades: + + * [O modo de alta precisão UniqueCount e o suporte de argumentos aumentado agora estão disponíveis para o público em geral](/whats-new/2025/08/whats-new-8-13-high-precision-uniquecount). + +* Fique por dentro dos nossos últimos lançamentos: + + * [Cordova agente v7.0.8](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-708/): + + * Atualizar o agente Android nativo para a versão 7.6.8 + * Atualizar o agente iOS nativo para a versão 7.5.8 + + * [Cordova agente v7.0.9](/docs/release-notes/mobile-release-notes/cordova-release-notes/cordova-agent-709/): + + * Atualizar o agente Android nativo para a versão 7.6.6 + * Atualizar o agente iOS nativo para a versão 7.5.5 + + * [Capacitor agente v1.5.8](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-158/): + + * Atualizar o agente Android nativo para a versão 7.6.6 + * Atualizar o agente iOS nativo para a versão 7.5.5 + + * [Capacitor agente v1.5.9](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-159/): + * Corrigida a falha do sinal de aborto + + * [Capacitor agente v1.5.10](/docs/release-notes/mobile-release-notes/capacitor-release-notes/capacitor-agent-1510/): + + * Atualizar o agente Android nativo para a versão 7.6.8 + * Atualizar o agente iOS nativo para a versão 7.5.8 + + * [CLI de diagnóstico (nrdiag) v3.5.0](/docs/release-notes/diagnostics-release-notes/diagnostics-cli-release-notes/diagnostics-cli-350/): + * atualizou a verificação de compatibilidade da versão `Java/Appserver/JbossEapCheck` + + * [.NET agente v10.44.0](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-0/): + + * Amostradores de métricas de desempenho habilitados no modo Serverless + * Processo de host da Web do Azure Function (Linux) excluído da instrumentação. + + * [NRDOT v1.3.0](/docs/release-notes/nrdot-release-notes/nrdot-2025-08-13/): + + * Versões do componente hotel aumentadas de v0.128.0 para v0.131.0 + * Introdução da distribuição do núcleo nrdot + + * [Agente Node.js v13.1.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-1-0/): + + * Adicionado suporte para API de logs OTEL + * Adicionada a capacidade de suporte métrico quando a instrumentação foi desabilitada para um pacote + * Instrumentação de temporizadores desabilitados por padrão no exemplo de configuração + * Ofuscação `transaction.url` fixa + + * [Gerenciador de tarefas v454](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-454/): + * Corrigidas as vulnerabilidades subjacentes do Ubuntu para abordar vulnerabilidades de segurança no SJM. + + * [Tempo de execução da API do Node v1.2.124](/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.124/): + * Corrigidas as vulnerabilidades subjacentes do Ubuntu para lidar com vulnerabilidades de segurança nos tempos de execução da API do Node. + + * [Runtime do navegador Node v3.0.41](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.41/): + * Corrigidas as vulnerabilidades do tmp `CVE-2025-54798` e as vulnerabilidades subjacentes do Ubuntu para abordar vulnerabilidades de segurança nos tempos de execução do Node Browser . + + * [Tempo de execução do Ping v1.54.0](/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.0/): + * Vulnerabilidades corrigidas relacionadas ao Ubuntu para resolver problemas de segurança no tempo de execução do Ping. + + * [Agente Java v8.23.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8230/): + + * Atualizado para oferecer suporte à v24 do graphql. + * Adicionada instrumentação lettuce 6.5. + * Versão commons-lang elevada para 3.18.0 + + * [AWS Lambda direcionador de logs v1.1.1](/docs/release-notes/aws-lambda-log-forwarder-release-notes/lambda-25-07-25/): + * Postura de segurança aprimorada com a atualização da versão Go para 1.24.4 nos sistemas. + + * [Agente PHP v12.0.0.25](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-0-0-25/): + + * Melhoria no logging de erros do mapa de hooks do Drupal. + * Problemas corrigidos de detecção de pacotes legados para Security RX. + + * [agente de infraestrutura v1.66.1](/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1661/): + * Suporte revertido para montagens do AWS EFS em amostras de armazenamento. + + * [Aplicativo móvel para Android v5.30.6](docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5306/): + * Suporte aprimorado de senha para logins SAML e sociais. + + * [Agente Browser v1.295.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.0/): + + * Adicionada detecção de causa de erro. + * Adicionados avisos de monkey-patching. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx new file mode 100644 index 00000000000..bb5951d3f88 --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-8-21-2025.mdx @@ -0,0 +1,56 @@ +--- +subject: Docs +releaseDate: '2025-08-22' +version: 'August 15 - August 21, 2025' +translationType: machine +--- + +### Grandes mudanças + +* Relatório de compatibilidade [do agente Node.js](/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent/) atualizado. +* [Agente .NET](/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements/) atualizado com as últimas versões de bibliotecas compatíveis verificadas. + +### Pequenas mudanças + +* Atualizou o sistema operacional [Debian](/docs/infrastructure/infrastructure-agent/linux-installation/package-manager-install/) para a versão 12 ("bookworm") para oferecer suporte ao [agente de infraestrutura](/docs/infrastructure/infrastructure-agent/requirements-infrastructure-agent/#os) para Linux. +* Função [`accountId()`](/docs/data-apis/manage-data/query-limits/) atualizada para consultar os limites de dados. +* [Instalador MSIWindows ](/docs/infrastructure/infrastructure-agent/windows-installation/windows-msi-installer/#install-windows)atualizado para oferecer suporte Windows de 64 bits (Intel/AMD). + +### Notas de versão + +* Anunciado 7 de janeiro de 2026 como a data de fim da vida útil das regras de descarte por meio da [interface de AI Monitoring](/docs/ai-monitoring/drop-sensitive-data/). + +* [Agente iOS v7.5.9](/docs/release-notes/mobile-release-notes/ios-release-notes/ios-agent-759/) + + * Corrigido um problema que poderia fazer com que distributed tracing não tivesse todas as informações de conta necessárias no início de uma sessão. + * Corrigido um problema que poderia causar uma falha na inicialização do agente. + +* [Agente Python v10.16.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101600/) + + * Adicionado suporte para novas funções [do Redis](https://pypi.org/project/redis/). + * Converteu todos os caminhos internos de `os.path` para `pathlib.Path`. + * Problema corrigido com codificação JSON PosixPath. + +* [Integração Kubernetes v3.44.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-44-1/) + + * Essa integração está incluída nas seguintes versões de gráfico: + + * [newrelic-infraestrutura-3.49.1](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.49.1) + * [nri-bundle-6.0.10](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.10) + +* [.NET agente v10.44.1](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-44-1/) + + * Tratamento de exceções corrigido no wrapper de instrumentação do Service Bus. + * Processo de host da Web do Azure Function (Linux) excluído da instrumentação. + +* [Agente Node.js v13.2.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-2-0/) + + * Adicionada capacidade de registrar `Supportability/Features/Instrumentation/OnRequire/` métricas para instrumentação baseada em assinantes. + * Adicionado gancho do carregador esm e patch commonjs para funcionar com orchestran-js. + * Adicionada instrumentação para `@modelcontextprotocol/sdk` chamadas de cliente `client.callTool`, `client.readResource` e `client.getPrompt`. + * Lógica corrigida em torno da detecção de pacotes OTEL. + * Atualizado `shimmer.setupSubscribers` para configurar corretamente e ignorar assinantes desabilitados. + +* [Agente Node.js v13.2.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-2-1/) + + * Agente atualizado para usar `@apm-js-collab/tracing-hooks` para o registro CJS/ESM para rastreamento de instrumentação baseada em canal. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx new file mode 100644 index 00000000000..9d88cfd440c --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/docs-release-notes/docs-9-12-2025.mdx @@ -0,0 +1,94 @@ +--- +subject: Docs +releaseDate: '2025-09-14' +version: 'September 08 - September 12, 2025' +translationType: machine +--- + +### Novos documentos + +* Adicionada documentação abrangente [do Modelo de Maturidade de Observabilidade](/docs/new-relic-solutions/observability-maturity/) para fornecer orientação para medir e melhorar práticas de observabilidade em quatro áreas principais: Tempo de operação de negócios, Experiência Digital, Excelência em Engenharia e Observabilidade Inteligente. + +### Grandes mudanças + +* [Configuração de agente PHP](/docs/apm/agents/php-agent/configuration/php-agent-configuration/) atualizada com novas opções de configuração extensivas para controles de amostragem e instrumentação de manipulador de exceções framework. + +### Pequenas mudanças + +* [Introdução o dashboard](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) atualizada com orientação aprimorada para uso dashboard. +* Documentação aprimorada [de dashboard](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/) com conteúdo simplificado para gerenciamento de JSON. +* Links quebrados corrigidos na documentação [do plano de uso do New Relic](/docs/licenses/license-information/usage-plans/new-relic-usage-plan/). +* Corrigida configuração de depuração na documentação [do agente de resolução de problemas do .NET](/docs/apm/agents/net-agent/troubleshooting/debugging-net-windows/). + +### Notas de versão + +* Fique por dentro dos nossos últimos lançamentos: + + * [Agente Browser v1.297.0](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.0/): + + * Evitar colheitas precoces durante o período de repetição para melhor manejo de limitação de taxa. + * O meta atributo newrelic foi removido da carga de replay de saída para reduzir bytes faturáveis. + * Exceções corrigidas para corpos nulos decorrentes de colheitas vazias. + + * [Agente PHP v12.1.0.26](/docs/release-notes/agent-release-notes/php-release-notes/php-agent-12-1-0-26/): + + * Controles de amostragem adicionados com base na decisão de amostragem de trace w3c upstream. + * Adicionada opção de configuração para pular a instrumentação de manipuladores de exceção do framework. + * Corrigido possível vazamento de memória ao chamar `newrelic_end_transaction(true)`. + * A versão do golang foi aumentada para 1.25.1 para melhorias de segurança. + + * [Agente Python v10.17.0](/docs/release-notes/agent-release-notes/python-release-notes/python-agent-101700/): + + * Adicionado suporte para tarefas personalizadas no Celery. + * Adicionado suporte para monitoramento Graphene-Django. + * Adicionado suporte para filtragem de middleware no Django. + * Adicionado suporte para a API AWS Bedrock Converse. + * Adicionado suporte para o sinalizador amostrado do cabeçalho W3CTraceParent. + + * [Agente Java v8.24.0](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-8240/): + + * Adicionado suporte para MongoDB Reactive Streams 5.2.0 e superiores. + * Adicionado suporte para Jedis 6. + * Corrigido o problema de instrumentação dupla do CouchBase. + * Corrigido o problema de encapsulamento de cabeçalho do Spring WebClient 5.x. + + * [Agente Node.js v13.3.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-0/): + + * Adicionado suporte a MCP `StreamableHTTPClientTransport`. + + * [Agente Node.js v13.3.1](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-1/): + + * Corrigida a falha ao definir `requestParameters` como padrão para um objeto em `transaction.addRequestParameters`. + + * [Agente Node.js v13.3.2](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-13-3-2/): + + * Adicionado código defensivo para obter `protocol` em chamadas http de saída. + + * [Integração Kubernetes v3.45.1](/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-45-1/): + + * Atualizado com as últimas melhorias e correções de bugs. + + * [Gerenciador de tarefas v464](/docs/release-notes/synthetics-release-notes/job-manager-release-notes/job-manager-release-464/): + + * Problema corrigido em que os clientes não conseguiam extrair imagens de um registro personalizado usando o podman. + + * [Tempo de execução do navegador Node v3.0.43](/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.43/): + + * Vulnerabilidades subjacentes do Ubuntu corrigidas para lidar com vulnerabilidades de segurança. + + * [Aplicativo móvel para iOS v6.9.12](/docs/release-notes/mobile-apps-release-notes/new-relic-ios-release-notes/new-relic-ios-6102/): + + * Problemas de link profundo corrigidos para painel e alertas. + * Problema corrigido no ID do painel do CCU. + + * [Aplicativo móvel para Android v5.30.7](/docs/release-notes/mobile-apps-release-notes/new-relic-android-release-notes/new-relic-android-5307/): + + * Adicionadas correções de bugs e melhorias. + + * [Agente Flutter v1.1.14](/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1114/): + + * Adicionou melhorias adicionais de estabilidade e correções de bugs. + + * [Controle de Pipeline Gateway v25.09.01](/docs/release-notes/pipeline-control-gateway-release-notes/pipeline-control-gateway-25-09-01/): + + * Adicionada nova versão com recursos aprimorados de controle de pipeline. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx b/src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx new file mode 100644 index 00000000000..93ce5adea1a --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1710.mdx @@ -0,0 +1,15 @@ +--- +subject: Infrastructure agent +releaseDate: '2025-10-27' +version: 1.71.0 +translationType: machine +--- + +Uma nova versão do agente foi lançada. Siga os procedimentos padrão para [atualizar o agente de infraestrutura](https://docs.newrelic.com/docs/infrastructure/install-configure-manage-infrastructure/update-or-uninstall/update-infrastructure-agent). A New Relic recomenda que você atualize o agente regularmente e, no mínimo, a cada 3 meses. Até o momento desta versão, a versão mais antiga suportada é [o agente de infraestrutura 1.55.2](https://docs.newrelic.com/docs/release-notes/infrastructure-release-notes/infrastructure-agent-release-notes/new-relic-infrastructure-agent-1552/). + +## Mudado + +* Adicionar suporte para Suse 15.7 [#2139](https://github.com/newrelic/infrastructure-agent/pull/2139) +* Adicionar suporte para Debian 13 (Trixie) [#2140](https://github.com/newrelic/infrastructure-agent/pull/2140) +* Dependência newrelic/nri-winservices atualizada para v1.4.0 [#2143](https://github.com/newrelic/infrastructure-agent/pull/2143) +* dependência newrelic/nri-prometheus atualizada para v2.27.2 [#2130](https://github.com/newrelic/infrastructure-agent/pull/2130) \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx b/src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx new file mode 100644 index 00000000000..81f1b31a0b6 --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/infrastructure-release-notes/kubernetes-integration-release-notes/kubernetes-integration-3-48-0.mdx @@ -0,0 +1,13 @@ +--- +subject: Kubernetes integration +releaseDate: '2025-10-28' +version: 3.48.0 +translationType: machine +--- + +Para uma descrição detalhada das alterações, consulte as [notas de lançamento](https://github.com/newrelic/nri-kubernetes/releases/tag/v3.48.0). + +Essa integração está incluída nas seguintes versões de gráfico: + +* [newrelic-infraestrutura-3.53.0](https://github.com/newrelic/nri-kubernetes/releases/tag/newrelic-infrastructure-3.53.0) +* [nri-bundle-6.0.19](https://github.com/newrelic/helm-charts/releases/tag/nri-bundle-6.0.19) \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx b/src/i18n/content/pt/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx new file mode 100644 index 00000000000..9509a27539c --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/mobile-release-notes/flutter-release-notes/flutter-agent-1116.mdx @@ -0,0 +1,18 @@ +--- +subject: Flutter agent +releaseDate: '2025-10-24' +version: 1.1.16 +downloadLink: 'https://pub.dev/packages/newrelic_mobile/versions/1.1.16' +translationType: machine +--- + +## Correções de bugs + +* Corrigido um problema em que o `NewRelicNavigationObserver` travava ao manipular rotas sem um parâmetro-chave, como planilhas inferiores e caixas de diálogo modais. +* Falhas de rastreamento de navegação resolvidas para rotas que não se estendem `PageRoute`. + +## Melhorias + +* Segurança de tipo aprimorada em `NewRelicNavigationObserver` removendo todos os tipos dinâmicos. +* Adicionado suporte para tipos de rotas adicionais, incluindo `CupertinoPage` e `NoTransitionPage` de `go_router`. +* Código do observador de navegação refatorado para melhor manutenção e legibilidade. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx b/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx new file mode 100644 index 00000000000..3cf842161b5 --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.295.mdx @@ -0,0 +1,39 @@ +--- +subject: Browser agent +releaseDate: '2025-08-04' +version: 1.295.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Add error cause detection +bugs: + - Add monkey-patching warnings + - Calculate first and last timestamps from raw data +security: [] +translationType: machine +--- + +## v1.295.0 + +### Recurso + +#### Adicionar detecção de causa de erro + +Detecte e relate o atributo de causa no evento JavaScriptError capturado. Se a causa for uma instância de um erro, o stack trace será capturado; caso contrário, o conteúdo em string da causa será relatado. Isso poderá ser consultado no evento JavaScriptError sob o atributo `cause`. + +### Correções de bugs + +#### Adicionar avisos de monkey-patching + +Detecção e avisos adicionados para quando os globais esperados foram corrigidos antes do agente ser executado na página. Isso pode causar comportamentos inesperados e a intenção é informar os clientes sobre esse comportamento. + +#### Calcular o primeiro e o último registro de data e hora a partir de dados brutos + +Certifique-se de que o agente calcule manualmente o primeiro e o último registro de data e hora de uma carga do SessionReplay antes da coleta para ajudar a melhorar a consistência no replayer da interface. + +## Declaração de apoio + +New Relic recomenda que você atualize o agente regularmente para garantir que esteja obtendo os benefícios mais recentes de recursos e desempenho. Versões mais antigas não terão mais suporte quando chegarem [ao fim de sua vida útil](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/). As datas de lançamento refletem a data de publicação original da versão do agente. + +Novos lançamentos de agente do browser são disponibilizados aos clientes em pequenas etapas ao longo de um período de tempo. Por esse motivo, a data em que o lançamento fica acessível à sua conta pode não corresponder à data de publicação original. Consulte este [dashboard de status](https://newrelic.github.io/newrelic-browser-agent-release/) para obter mais informações. + +De acordo com nossa [política de suporte a navegadores](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), a versão v1.295.0 do Agente do browser foi criada e testada nesses navegadores e intervalos de versão: Chrome 128-138, Edge 128-138, Safari 17-19 e Firefox 130-140. Para dispositivos móveis, a versão v1.295.0 foi criada e testada para Android OS 16 e iOS Safari 17-26. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx b/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx new file mode 100644 index 00000000000..2f08aaa8206 --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.296.mdx @@ -0,0 +1,34 @@ +--- +subject: Browser agent +releaseDate: '2025-08-19' +version: 1.296.0 +downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' +features: + - Harvest traces early +bugs: + - Remove event buffer inspection event +security: [] +translationType: machine +--- + +## v1.296.0 + +### Recurso + +#### Colheita de rastros precoce + +Atualize o agente para tratar o trace da sessão da mesma forma que outros recursos tratam os dados a partir de [1.294.0](https://docs.newrelic.com/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.294.0/), permitindo colheitas com tamanho de 16kb. + +### Correções de bugs + +#### Remover evento de inspeção de buffer de evento + +Remove a inspeção do buffer de eventos para evitar um vazamento de memória ao usar console.log com o ouvinte de eventos da janela `newrelic`. + +## Declaração de apoio + +New Relic recomenda que você atualize o agente regularmente para garantir que esteja obtendo os benefícios mais recentes de recursos e desempenho. Versões mais antigas não terão mais suporte quando chegarem [ao fim de sua vida útil](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/browser-agent-eol-policy/). As datas de lançamento refletem a data de publicação original da versão do agente. + +Novos lançamentos de agente do browser são disponibilizados aos clientes em pequenas etapas ao longo de um período de tempo. Por esse motivo, a data em que o lançamento fica acessível à sua conta pode não corresponder à data de publicação original. Consulte este [dashboard de status](https://newrelic.github.io/newrelic-browser-agent-release/) para obter mais informações. + +De acordo com nossa [política de suporte a navegadores](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), a versão v1.296.0 do agente Browser foi criada e testada nesses navegadores e intervalos de versão: Chrome 129-139, Edge 129-139, Safari 17-19 e Firefox 131-141. Para dispositivos móveis, a versão v1.296.0 foi criada e testada para Android OS 16 e iOS Safari 17-18.1. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx b/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx index 002dfdb8f1e..c5167cc6355 100644 --- a/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx +++ b/src/i18n/content/pt/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1.297.mdx @@ -1,34 +1,22 @@ --- subject: Browser agent -releaseDate: '2025-09-10' -version: 1.297.0 +releaseDate: '2025-09-17' +version: 1.297.1 downloadLink: 'https://www.npmjs.com/package/@newrelic/browser-agent' -features: - - Prevent early harvests when in retry period - - remove newrelic meta attribute +features: [] bugs: - - Fix exceptions for null bodies arising from empty harvests + - Prevent double import of Session Replay aggregate class security: [] translationType: machine --- -## v1.297.0 - -### Recurso - -#### Evite colheitas precoces no período de repetição - -Evite que o agente faça a colheita mais cedo quando a taxa estiver limitada. Se o serviço de ingestão retornar 429, o agente substituirá seus dados e tentará a coleta novamente mais tarde. Enquanto isso acontece, ele não poderá mais coletar dados antecipadamente, conforme novos dados chegam, até que a coleta seja bem-sucedida. - -#### remover meta atributo newrelic - -Remover o relatório do meta atributo \_\_newrelic da carga de replay de saída. Isso está sendo realizado como uma medida para ajudar a economizar bytes faturáveis para os clientes e reduzir o custo de uso das funcionalidades do Session Replay. +## v1.297.1 ### Correções de bugs -#### Corrigir exceções para corpos nulos decorrentes de colheitas vazias +#### Impedir importação dupla da classe agregada Session Replay -Foi feita uma alteração para garantir que toda carga limpa garanta uma saída válida. Antes, uma string vazia passando pelo processo de limpeza do corpo poderia gerar um erro, pois o mecanismo retornaria o corpo como nulo. Agora, strings vazias passarão intactas, permitindo que o processamento posterior seja aplicado com sucesso. +Corrige um problema encontrado em que a classe agregada Session Replay poderia ser importada duas vezes ao usar o método API newrelic.recordReplay durante o pré-carregamento foi habilitado. ## Declaração de apoio @@ -36,4 +24,4 @@ New Relic recomenda que você atualize o agente regularmente para garantir que e Novos lançamentos de agente do browser são disponibilizados aos clientes em pequenas etapas ao longo de um período de tempo. Por esse motivo, a data em que o lançamento fica acessível à sua conta pode não corresponder à data de publicação original. Consulte este [dashboard de status](https://newrelic.github.io/newrelic-browser-agent-release/) para obter mais informações. -De acordo com nossa [política de suporte a navegadores](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), a versão v1.297.0 do agente do Browser foi criada e testada nesses navegadores e intervalos de versão: Chrome 129-139, Edge 129-139, Safari 17-19 e Firefox 131-141. Para dispositivos móveis, a versão v1.297.0 foi criada e testada para Android OS 16 e iOS Safari 17-18.1. \ No newline at end of file +De acordo com nossa [política de suporte a navegadores](https://docs.newrelic.com/docs/browser/new-relic-browser/getting-started/compatibility-requirements-browser-monitoring/#browser-types), a versão v1.297.1 do agente do Browser foi criada e testada nesses navegadores e intervalos de versão: Chrome 130-140, Edge 130-140, Safari 17-19 e Firefox 132-142. Para dispositivos móveis, a versão v1.297.1 foi criada e testada para Android OS 16 e iOS Safari 17-18.5. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx index 0b48b7bcf61..a893b8d607c 100644 --- a/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx +++ b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-api-runtime-release-notes/node-api-runtime-1.2.mdx @@ -1,10 +1,10 @@ --- subject: Node API runtime -releaseDate: '2025-08-13' -version: 1.2.124 +releaseDate: '2025-07-29' +version: 1.2.122 translationType: machine --- ### Correções -* Corrigidas as vulnerabilidades subjacentes do Ubuntu para lidar com vulnerabilidades de segurança nos tempos de execução da API do Node. +* Corrigidas as vulnerabilidades de dados de formulário e as vulnerabilidades subjacentes do Ubuntu para lidar com vulnerabilidades de segurança em tempos de execução API do Node. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx index df6b19fcc6d..36ec24357e4 100644 --- a/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx +++ b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/node-browser-runtime-release-notes/node-browser-runtime-3.0.mdx @@ -1,10 +1,10 @@ --- subject: Node browser runtime -releaseDate: '2025-08-13' -version: 3.0.41 +releaseDate: '2025-07-29' +version: 3.0.39 translationType: machine --- ### Melhorias -* Corrigidas as vulnerabilidades tmp CVE-2025-54798 e as vulnerabilidades subjacentes do Ubuntu para resolver vulnerabilidades de segurança nos tempos de execução do Node Browser. +* Corrigidas as vulnerabilidades de dados de formulário e as vulnerabilidades subjacentes do Ubuntu para lidar com vulnerabilidades de segurança em tempos de execução do Node Browser. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx new file mode 100644 index 00000000000..4bb67078ec7 --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.53.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-07-29' +version: 1.53.0 +translationType: machine +--- + +### Melhorias + +* Vulnerabilidades corrigidas relacionadas ao `common-lang3` Java e Ubuntu para resolver problemas de segurança no tempo de execução do Ping. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx new file mode 100644 index 00000000000..b7b8a18c47c --- /dev/null +++ b/src/i18n/content/pt/docs/release-notes/synthetics-release-notes/ping-runtime-release-notes/ping-runtime-1.54.mdx @@ -0,0 +1,10 @@ +--- +subject: Ping Runtime +releaseDate: '2025-08-13' +version: 1.54.0 +translationType: machine +--- + +### Melhorias + +* Vulnerabilidades corrigidas relacionadas ao Ubuntu para resolver problemas de segurança no tempo de execução do Ping. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/vulnerability-management/overview.mdx b/src/i18n/content/pt/docs/vulnerability-management/overview.mdx index 8276163ade1..5291e473ab1 100644 --- a/src/i18n/content/pt/docs/vulnerability-management/overview.mdx +++ b/src/i18n/content/pt/docs/vulnerability-management/overview.mdx @@ -17,7 +17,7 @@ O software moderno é composto por milhares de componentes, e as ofertas de segu Com o Security RX, você obtém: -* Uma visão panorâmica de todas as vulnerabilidades, incluindo aquelas detectadas pela plataforma New Relic e nossos parceiros de integração, como [FOSSA](docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](docs/vulnerability-management/integrations/snyk/), [Dependabot](install/vm/) e muito mais. +* Uma visão geral de todas as vulnerabilidades, incluindo aquelas detectadas pela plataforma New Relic e por nossos parceiros de integração, como [FOSSA](/docs/vulnerability-management/integrations/fossa/), [AWS Security Hub](/docs/vulnerability-management/integrations/aws/), [Trivy](/docs/vulnerability-management/integrations/trivy), [Snyk](/docs/vulnerability-management/integrations/snyk/), [Dependabot](/install/vm/) e outros. * Visibilidade contínua em tempo de execução de vulnerabilidades em seu aplicativo e infraestrutura diff --git a/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx new file mode 100644 index 00000000000..961ec749a33 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/create-your-own.mdx @@ -0,0 +1,707 @@ +--- +title: Crie seu próprio fluxo de trabalho +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic +metaDescription: Build custom workflows from scratch using drag-and-drop actions. Learn by example with a real-world EC2 automation scenario. +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Quando os modelos não atendem às suas necessidades, [a opção "Criar o seu próprio"](https://onenr.io/0OQM47KgxjG) permite que você construa um fluxo de trabalho personalizado. Utilize a interface de arrastar e soltar para encadear ações do [catálogo de ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) em automações que correspondam ao seu processo. + +## Como usar este guia + +Este guia mostra como construir um fluxo de trabalho usando conceitos e um exemplo completo. Escolha seu caminho de aprendizado: + +* **Aprenda primeiro os conceitos básicos** → Leia [Conceitos básicos](#core-concepts) e [Padrões de fluxo de trabalho](#workflow-patterns) para entender os fundamentos e, em seguida, aplique-os. + +* **Siga o exemplo** → Acesse o [passo a passo do exemplo](#example-walkthrough) para criar um fluxo de trabalho de redimensionamento automático do EC2 passo a passo. + +* **Padrões de referência** → Use a seção [padrões de fluxo de trabalho](#workflow-patterns) como uma referência rápida ao construir seu próprio fluxo de trabalho + + + **Novo no fluxo de trabalho?** Comece pelos conceitos básicos e depois siga o exemplo. O fluxo de trabalho do EC2 demonstra todos os padrões principais em um cenário do mundo real. + + +## Por que construir um fluxo de trabalho personalizado? + +Crie seu próprio fluxo de trabalho para: + +* **Implemente uma lógica de negócios exclusiva** que os modelos não suportam. +* **Integre vários sistemas** além dos modelos padrão. +* **Lide com decisões complexas** com ramificação condicional. +* **Combine o processo de sua equipe** para aprovações e notificações + +## Conceitos centrais [#core-concepts] + +Entenda esses fundamentos antes de construir: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Conceito** + + **O que ele faz** + + **Exemplo** +
+ Entradas e segredos + + parâmetro para credenciais e configuração + + `${{ :secrets:awsKeyId }}` para credenciais, `${{ .inputs.region }}` para configuração. +
+ Catálogo de ações + + Integração pré-construída (AWS, Slack, banco de dados, APIs) + + Arraste `aws.ec2.stopInstances` para a tela do fluxo de trabalho. +
+ Fluxo de dados + + Transmita as saídas entre as etapas. + + `${{ .steps.getAlert.outputs.entityGuid }}` +
+ Interruptores + + Criar caminhos diferentes com base nas condições + + `Route by CPU > 90% vs. 70-90% vs. < 70%` +
+ Laços + + Listas de processos ou pesquisas para verificar a conclusão + + Use `type: loop` com `for` e `in` para iterar sobre coleções. +
+ Portões de aprovação + + Pausa para decisões humanas + + Reações lentas antes de operações destrutivas +
+ Tratamento de erros + + Detectar falhas e executar a limpeza + + Padrões try-catch com procedimentos de rollback +
+ + + **Aprenda fazendo:** Cada conceito é demonstrado no [exemplo passo a passo](#example-walkthrough) abaixo. Você verá entradas, interruptores, loops e portões de aprovação funcionando juntos em um fluxo de trabalho real. + + +Para padrões detalhados de tratamento de erros, consulte [práticas recomendadas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices#error-handling). + +## Começo rápido [#quick-start] + +Crie seu primeiro fluxo de trabalho em cinco etapas: + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** e selecione **[Create Your Own](https://onenr.io/0OQM47KgxjG)**. +2. Defina parâmetros para credenciais (do secrets manager: `${{ :secrets:keyName }}`), configuração (regiões, tipo de instância) e dados de tempo de execução (IDs de conta, IDs de alerta) +3. Arraste ações do [catálogo](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) e conecte-as com a sintaxe `${{ .steps.stepName.outputs.field }}` para passar dados. +4. Insira interruptores para ramificação condicional, loops para processamento de listas ou polling, e portões de aprovação para decisões humanas. +5. Execute o comando após cada seção para detectar erros precocemente e, em seguida, [inicie ou agende](/docs/workflow-automation/create-a-workflow-automation/start-schedule) seu fluxo de trabalho. + + + Comece com 3 etapas, teste minuciosamente e depois expanda. Um fluxo de trabalho funcional de 5 etapas é melhor do que um fluxo de trabalho falho de 20 etapas. + + +## Padrões de fluxo de trabalho principais [#workflow-patterns] + +Quatro padrões essenciais abrangem a maioria dos cenários de automação. Cada padrão é demonstrado no [exemplo passo a passo](#example-walkthrough) abaixo. + +### Ramificação condicional com interruptores + +**Utilize os interruptores quando:** Os resultados variam de acordo com os dados (verificações de limite, respostas da API, decisões do usuário) + +**Sintaxe da tecla:** + +```yaml +- name: hasCompleted + type: switch + switch: + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}" + next: displayError + - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}" + next: displaySuccess + next: displayUnexpected # Default path when no condition matches +``` + +**Veja em ação:** [Gerencie a resposta da equipe](#handle-team-response) e [verifique e limpe](#verify-and-clean-up) as seções que mostram o roteamento de switches com base nas reações do Slack e no status do AWS SSM. + +### Loops para processar listas + +**Utilize loops quando:** estiver processando vários itens ou repetindo ações. + +**Sintaxe da tecla:** + +```yaml +# Send progress updates using range loop +- name: progressLoop + type: loop + for: + in: "${{ [range(1; 5)] }}" # Loop 5 times + steps: + - name: wait + type: wait + seconds: 10 + - name: progressMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "${{ .workflowInputs.channel }}" + text: "Resizing in progress..." +``` + +**Veja em ação:** [Execute a seção de redimensionamento](#execute-the-resize) que usa `progressLoop` para atualizações de status. + +### Portarias de aprovação e espera + +**Utilize portões de aprovação quando:** for necessário julgamento humano antes de operações destrutivas ou quando for exigida a aprovação de conformidade. + +**Sintaxe da tecla:** + +```yaml +- name: requestApproval + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: "#approvals" + text: "Approve? React with :thumbsup: or :thumbsdown:" + +- name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: "${{ .workflowInputs.slackToken }}" + channelID: "${{ .steps.requestApproval.outputs.channelID }}" + threadTs: "${{ .steps.requestApproval.outputs.threadTs }}" + timeout: 300 # Wait 5 minutes for reaction + +- name: checkApproval + type: switch + switch: + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}' + next: handleApproval + - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}' + next: handleRejection +``` + +**Para atrasos simples:** + +```yaml +- name: waitBeforeRetry + type: wait + seconds: 60 # Wait 60 seconds before continuing +``` + +**Veja na prática:** a seção ["Solicitar aprovação da equipe"](#request-team-approval) implementa o fluxo de trabalho completo de aprovação do Slack. + +### Passando dados entre etapas + +**Utilize a passagem de dados quando:** a saída de uma etapa se torna a entrada de outra (o fundamento de todo fluxo de trabalho). + +**Sintaxe da tecla:** + +```yaml +# Reference previous step outputs +awsRegion: "${{ .inputs.region }}" +instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}" +``` + +**Veja na prática:** Todas as seções demonstram a transferência de dados — cada etapa se baseia nos resultados anteriores. + + + **Deseja exemplos completos dos padrões?** Veja [exemplos de fluxo de trabalho](/docs/workflow-automation/workflow-examples) para padrões adicionais, incluindo tratamento de erros, novas tentativas e integração complexa. + + +## Exemplo passo a passo: Redimensionamento automático de instâncias EC2 com aprovação [#example-walkthrough] + +Este exemplo completo demonstra como construir um fluxo de trabalho que redimensiona automaticamente instâncias do EC2 quando há picos de uso da CPU — após obter a aprovação da equipe via Slack. Este vídeo demonstra a coleta de dados, a lógica condicional, a integração externa e o tratamento de erros em um cenário do mundo real. + + + **Novo no fluxo de trabalho?** Este exemplo utiliza AWS, Slack e lógica de aprovação. Se você está começando agora, tente [enviar o relatório para o Slack](/docs/workflow-automation/create-a-workflow-automation/use-a-template#send-report-to-slack) primeiro. + + +### Pré-requisitos [#prerequisites] + +Antes de criar este fluxo de trabalho, certifique-se de ter: + +* **AWS**: Credenciais com permissões do EC2 e do Systems Manager +* **Slack**: token de bot e canal para notificação +* **New Relic**: condição de alerta de monitoramento EC2 CPU +* **Gerenciador de segredos**: Configurado (consulte [gerenciamento de segredos](/docs/infrastructure/host-integrations/installation/secrets-management/)) + +### Visão geral do fluxo de trabalho [#workflow-overview] + +**Fluxo de alto nível:** + +1. **Coletar dados**: Obter detalhes de alertas e instâncias do New Relic +2. **Solicitar aprovação**: Envie uma mensagem no Slack e aguarde a resposta da equipe. +3. **Executar redimensionamento**: Use AWS Systems Manager para redimensionar instâncias do EC2. +4. **Verificar e limpar**: Verificar resultados, notificar a equipe, remover recursos temporários. + +Este exemplo demonstra padrões importantes que você usará em fluxos de trabalho personalizados: consultas a APIs, ramificação condicional, integração externa, loops de polling e tratamento de erros. + +### Entradas do fluxo de trabalho [#workflow-inputs] + + + **Se você está lendo para entender os conceitos, pode pular esta parte.** Esta tabela detalha os 12 parâmetros que esse fluxo de trabalho utiliza. Você pode usá-lo como referência durante a construção, mas não é essencial para entender o fluxo. + + +Este fluxo de trabalho requer credenciais, configuração e contexto de tempo de execução como entradas. Os valores sensíveis vêm do gerenciador de segredos usando a sintaxe `${{ :secrets:keyName }}`. + +**Categorias de entrada:** + +* **Autenticação**: credenciais da AWS e do Slack obtidas no gerenciador de segredos. +* **Contexto do alerta**: ID da conta e ID do problema do New Relic +* **Configuração**: região, tipo de instância, fuso horário, canal Slack + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ **Nome do parâmetro** + + **Tipo** + + **Valor padrão** + + **Descrição** +
+ `awsAccessKeyId` + + Corda + + `${{ :secrets:awsAccessKeyId }}` + + ID da chave de acesso da AWS obtida do gerenciador de segredos para autenticação com os serviços da AWS. +
+ `awsSecretAccessKey` + + Corda + + `${{ :secrets:awsSecretAccessKey }}` + + Chave de acesso secreta da AWS recuperada do gerenciador de segredos. Emparelha com o ID da chave de acesso. +
+ `awsSessionToken` + + Corda + + `${{ :secrets:awsSessionToken }}` + + token de sessão para credenciais temporárias AWS (opcional, usado com funções do IAM). +
+ `slackToken` + + Corda + + `${{ :secrets:slackToken }}` + + token de bot para postar mensagens e ler reações no Slack. +
+ `accountId` + + Interno + + Obrigatório + + Seu ID de conta New Relic. Utilizado para consulta de detalhes de alertas e dados de entidade. +
+ `issueId` + + Corda + + Obrigatório + + O ID da ocorrência do alerta do New Relic que acionou este fluxo de trabalho. Fornecido automaticamente quando o fluxo de trabalho é executado a partir de um alerta. +
+ `awsRegion` + + Corda + + `us-east-2` + + Região AWS onde suas instâncias do EC2 são executadas (por exemplo, `us-east-1`, `us-west-2`, `eu-west-1`). +
+ `InstanceType` + + Corda + + `t4g.nano` + + destino EC2 tipo de instância para redimensionamento. Escolha com base nas suas necessidades de desempenho e orçamento. +
+ `timestampUnit` + + Corda + + `MILLISECONDS` + + Unidade de tempo para o timestamp do alerta. Normalmente `MILLISECONDS` ou `SECONDS`. +
+ `timezoneId` + + Corda + + `America/Los_Angeles` + + Fuso horário para exibir o horário de ativação do alerta nas mensagens do Slack (por exemplo, `America/New_York`, `Europe/London`, `Asia/Tokyo`). +
+ `pattern` + + Corda + + `MM-dd-yyyy HH:mm` + + Padrão de formato de data/hora para exibição do registro de data e hora. Utiliza padrões SimpleDateFormat do Java. +
+ `channel` + + Corda + + Obrigatório + + ID do canal do Slack (não o nome) onde as notificações são postadas. Encontre isso nos detalhes do canal do Slack. +
+ + + +## Construa o fluxo de trabalho passo a passo. [#step-by-step-workflow] + +Agora vamos construir cada parte do fluxo de trabalho. Cada etapa inclui as ações específicas a serem adicionadas e os padrões de fluxo de trabalho que elas demonstram. + + + + ### Reunir o contexto do alerta [#gather-alert-context] + + consulte APIs e banco de dados antes de agir. Isso garante que você tenha o contexto completo. + + O fluxo de trabalho coleta informações de alertas e instâncias do EC2 por meio de três ações: + + * **`getAlertDetails`**: chama API NerdGraph ( API GraphQL da New Relic) para buscar metadados de alerta — horário de ativação, nome da condição e entidade afetada. + + * **`activatedDateTime`**: Converte o timestamp para um formato legível, como "01-24-2025 14:30", para mensagens do Slack. + + * **`impactedEC2Instance`**: consulta NRDB (New Relic banco de dados) para encontrar o ID das instâncias do EC2 e o tipo atual. + + Workflow diagram showing three steps: getAlertDetails queries NerdGraph API, activatedDateTime converts timestamp, and impactedEC2Instance retrieves instance details from NRDB + + **Por que isso é importante:** Sem esses detalhes, você não consegue construir mensagens significativas no Slack ou definir as instâncias corretas do EC2. + + + + ### Solicitar aprovação da equipe [#request-team-approval] + + Conecte-se a ferramentas de colaboração como Slack, PagerDuty ou ServiceNow para obter pontos de decisão humanos. + + O fluxo de trabalho envia detalhes para o Slack e aguarda uma resposta: + + * **`IssueDetected`**: Envia detalhes do alerta, tipo de instância atual e redimensionamento proposto para o Slack. Solicita à equipe que reaja com `:+1:` (aprovar) ou `:-1:` (cancelar). + + * **`GetUserReaction`**: Pausa por 5 minutos (300 segundos) aguardando uma reação. + + * **`checkQuery` (Interruptor)**: Rotas baseadas em reação: + + * **`:+1:`** → Iniciar redimensionamento + * **`:-1:`** → Interromper fluxo de trabalho + * **Outro** → solicitar reação válida, retornar ao início + + Workflow diagram showing user approval process: IssueDetected posts Slack message, GetUserReaction waits for response, checkQuery evaluates reactions with three conditions for approval, cancellation, or unexpected responses + + + **Problema comum:** Use **o ID** do canal do Slack (`C01234ABCD`), não o nome do canal. Encontre essa informação nos detalhes do canal do Slack. Consulte [resolução de problemas](#common-issues) para obter mais informações. + + + + + ### Gerenciar a resposta da equipe [#handle-team-response] + + Utilize parâmetros (ou interruptores) para criar caminhos diferentes com base em valores de dados ou entrada do usuário. + + O fluxo de trabalho se ramifica com base na reação: + + * **`unexpectedReaction`**: Explica as reações válidas e retorna ao loop para esperar novamente. + * **`gotCancelReaction`**: Confirma o cancelamento, pula para a conclusão. Sem alterações na infraestrutura. + * **`gotYesReaction`**: Confirma a aprovação e prossegue com o redimensionamento. + + + **Padrão de portões de aprovação:** Use interruptores como este quando precisar de avaliação humana antes de alterações arriscadas. O padrão funciona com reações do Slack, confirmações do PagerDuty, respostas por e-mail ou webhooks personalizados. + + + + + ### Execute o redimensionamento. [#execute-the-resize] + + Utilize um token único para evitar operações duplicadas. Utilize loops para verificar o status de operações de longa duração. + + O fluxo de trabalho redimensiona a instância por meio do AWS Systems Manager (SSM): + + * **`createSsmDocument`**: Cria um documento de Automação SSM que interrompe a instância, modifica o tipo e a reinicia. + * **`generateIdempotencyToken`**: Cria um UUID único. Impede redimensionamentos duplicados caso o fluxo de trabalho seja executado duas vezes. + * **`startResizing`**: Executa o documento SSM com ID da instância e novo tipo. + * **`progressLoop` (Loop)**: Publica atualizações do Slack a cada 10 segundos (5 vezes no total). + * **`waitForCompletion`**: Consulta o status do SSM com um tempo limite de 2 minutos. + + + **Por que o SSM?** O Systems Manager oferece tratamento de erros, verificação de estado e registros de auditoria do CloudTrail. Melhor que chamada de API direta do EC2. + + + + **Problema comum:** Certifique-se de que as credenciais da AWS tenham permissões `ec2:StopInstances`, `ec2:ModifyInstanceAttribute`, `ec2:StartInstances` e `ssm:*`. A falta de permissões resulta em falhas silenciosas. + + + + + ### Verificar e limpar [#verify-and-clean-up] + + Planeje para falhas e utilize recursos temporários, independentemente do resultado. + + O fluxo de trabalho verifica os resultados e remove os recursos temporários: + + * **`hasCompleted` (Alternar)**: Alterna com base no status do SSM (sucesso/falha/tempo limite excedido). + * **`displaySuccess`**: Registra o sucesso no New Relic. + * **`sendSuccessMessage`**: Confirma a conclusão no Slack. + * **`displayError`**: registra detalhes de erros para resolução de problemas. + * **`displayUnexpected`**: Registra estados incomuns (cancelamento manual, etc.). + * **`cleanupSsmDocument`**: Exclui o documento SSM temporário. + * **`sendSSMCleanMessage`**: Confirma a limpeza no Slack. + * **`workflowCompleted`**: Mensagem final de conclusão (executa com sucesso ou cancela). + + + * **Sempre limpe.** Estrutura do fluxo de trabalho para que a limpeza seja executada mesmo quando as etapas anteriores falharem. Isso evita vazamentos de recursos e cobranças inesperadas da AWS. + * **Problema comum:** Se o SSM expirar, as instâncias do EC2 podem continuar em transição entre estados. Verifique AWS Console para confirmar o status atual da instância antes de executá-la novamente. + + + + +## Próximos passos + +### Executar e gerenciar + +* **[Iniciar e agendar fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: Acionar manualmente ou agendar automaticamente. +* **[Gerenciando o fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: edite, versione, clone ou desative o fluxo de trabalho. + +### Melhorar + +* **[práticas recomendadas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Tratamento de erros, gerenciamento de segredos, desempenho, testes. +* **[Catálogo de ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: AWS, Azure, GCP, HTTP, transformações de dados. +* **[Exemplos de fluxo de trabalho](/docs/workflow-automation/workflow-examples)**: Mais cenários de automação do mundo real. + +### Escala + +* **[fluxo de trabalho APIs de automação](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: implantar via API para infraestrutura como código. +* **[Limitações do fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: tempos limite, limites de ações, restrições de carga útil. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx new file mode 100644 index 00000000000..68c0d1d530f --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/managing-workflow.mdx @@ -0,0 +1,164 @@ +--- +title: Gerencie a automação do fluxo de trabalho. +tags: + - Workflow Automation + - workflow + - build a workflow using New Relic +metaDescription: 'Navigate the workflow dashboard to view, edit, duplicate, delete, and monitor workflows in New Relic.' +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +O [dashboardde automação do fluxo de trabalho](https://onenr.io/0gR7XE8LXjo) fornece um local central para visualizar, gerenciar e monitorar todo o fluxo de trabalho em sua conta. Utilize o dashboard para editar a configuração, acompanhar o histórico de versões, gerenciar agendamentos de execução e solucionar problemas. + +## Tarefas comuns + +Acesso rápido às operações de gerenciamento de fluxo de trabalho: + +* **[Ver fluxo de trabalho](#view-workflows)** - Acesse dashboard e filtre o fluxo de trabalho +* **[Editar um fluxo de trabalho](#edit-a-workflow)** - Atualizar configuração ou definições +* **[Gerenciar versões](#manage-versions)** - Entenda o versionamento automático e fixe versões para agendamento. +* **[Duplicar um fluxo de trabalho](#duplicate-a-workflow)** - Copiar fluxo de trabalho ao adaptar templates +* **[Excluir um fluxo de trabalho](#delete-a-workflow)** - Remover fluxo de trabalho permanentemente + +## Antes de você começar + +Antes de gerenciar o fluxo de trabalho, certifique-se de ter: + +* Uma conta ativa New Relic com acesso ao fluxo de trabalho Automation. +* Pelo menos um fluxo de trabalho em sua conta (de um modelo ou personalizado). +* Edite e exclua permissões para fluxo de trabalho. + +**Novo no fluxo de trabalho?** Comece [usando um modelo](/docs/workflow-automation/create-a-workflow-automation/use-a-template) ou [criando seu próprio fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/create-your-own) para construir seu primeiro fluxo de trabalho. + +## Ver fluxo de trabalho [#view-workflows] + +O dashboard fluxo de trabalho exibe todo o fluxo de trabalho em sua conta, com informações importantes para ajudá-lo a gerenciá-lo. + +### Acesse o dashboard + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + +2. O dashboard exibe todo o fluxo de trabalho com as seguintes informações: + + * **Nome**: identificador de fluxo de trabalho que você atribuiu durante a criação + * **Descrição**: Objetivo ou função do fluxo de trabalho + * **Status**: Estado atual (Ativo, Inativo, Falha) + * **Versão**: Número da versão atual para controle de alterações. + * **Última execução**: registro de data e hora da execução mais recente. + * **Criado por**: usuário que criou o fluxo de trabalho + +### Filtrar e pesquisar fluxo de trabalho + +Utilize as opções de pesquisa e filtro para localizar fluxo de trabalho específico: + +* **Barra de pesquisa**: Insira o nome ou a descrição do fluxo de trabalho. +* **Filtro de status**: Mostrar apenas fluxos de trabalho Ativos, Inativos ou com Falha +* **Opções de ordenação**: Ordenar por nome, último tempo de execução ou data de criação. + +## Editar um fluxo de trabalho [#edit-a-workflow] + +Atualize o nome, a descrição ou a configuração do fluxo de trabalho. Acesse as opções de gerenciamento de fluxo de trabalho através do menu "Mais opções" (três pontos verticais) ao lado de cada nome de fluxo de trabalho. + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + +2. Selecione seu fluxo de trabalho na lista. + +3. Atualize os detalhes do fluxo de trabalho: + + * **Nome**: Alterar o identificador do fluxo de trabalho + * **Descrição**: Modifique a descrição da finalidade do fluxo de trabalho. + * **Configuração**: Ajustar parâmetro de entrada, ações ou lógica + +4. Clique em **Save** + +## Gerenciar versões [#manage-versions] + +A automação de fluxo de trabalho cria automaticamente uma nova versão sempre que você atualiza uma definição de fluxo de trabalho. Todas as versões anteriores continuam disponíveis para consulta. + +### Fixação de versões para agendamento + +Ao agendar um fluxo de trabalho, você deve vinculá-lo a uma versão específica. Esse requisito garante que as execuções agendadas continuem a executar a mesma versão testada, mesmo quando você atualiza a definição do fluxo de trabalho. + +**Iniciar e agendar fixação de versão de suporte ao fluxo de trabalho:** + +* Ao agendar um fluxo de trabalho, especifique qual versão executar. +* Ao iniciar manualmente a execução de um fluxo de trabalho, selecione qual versão executar. +* Os horários existentes continuarão usando a versão fixada até que você os atualize. + +Isso permite que você: + +* Atualize o fluxo de trabalho sem afetar os cronogramas de execução +* Teste manualmente as novas versões antes de atualizar os cronogramas. +* Mantenha a estabilidade do fluxo de trabalho da produção + +## Duplicar um fluxo de trabalho [#duplicate-a-workflow] + +Duplique o fluxo de trabalho quando precisar adaptar um modelo ou fluxo de trabalho existente para uma finalidade diferente, mantendo o original intacto. + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Localize o fluxo de trabalho que deseja duplicar. +3. Clique nas reticências (três pontos verticais) +4. Selecionar **Duplicate** +5. O sistema cria uma cópia com "(Cópia)" anexado ao nome. +6. Renomeie e personalize o fluxo de trabalho duplicado de acordo com suas necessidades. + +**Cenários comuns de duplicação:** + +* Adaptar um modelo de fluxo de trabalho para o seu caso de uso específico. +* Criar um fluxo de trabalho para uma equipe diferente com requisitos semelhantes. +* Experimentar com mudanças significativas, preservando o original. + + + **Evite duplicação desnecessária:** Não duplique o fluxo de trabalho para fins de controle de versão ou reversão - o sistema cria versões automaticamente quando você atualiza o fluxo de trabalho. A duplicação excessiva pode levar ao esgotamento dos limites do fluxo de trabalho. Consulte [Gerenciar versões](#manage-versions) para obter informações sobre o versionamento automático. + + +## Excluir um fluxo de trabalho [#delete-a-workflow] + +Remova o fluxo de trabalho que você não precisa mais. + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Localize o fluxo de trabalho que deseja excluir. +3. Clique no menu de mais opções (três pontos verticais). +4. Selecione **Delete** +5. Confirme a exclusão na caixa de diálogo. + + + Excluir um fluxo de trabalho remove todas as versões e o histórico de execução. Esta ação não pode ser desfeita. Se você precisar desse fluxo de trabalho posteriormente, considere desativá-lo em vez de excluí-lo. + + +**O que é apagado:** + +* Todas as versões do fluxo de trabalho +* Todo o histórico de execução e logs. +* Todas as execuções agendadas associadas ao fluxo de trabalho. + +**Antes de excluir, verifique:** + +* Nenhuma automação crítica depende desse fluxo de trabalho. +* Você tem uma cópia de segurança caso precise dela mais tarde. +* Todas as execuções programadas são identificadas e contabilizadas. + +## Próximos passos + +Após se familiarizar com o dashboard do fluxo de trabalho, explore estes recursos: + +**Execute e monitore o fluxo de trabalho:** + +* **[Iniciar e agendar fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: acione o fluxo de trabalho manualmente ou configure agendamentos automatizados + +**Melhore seu fluxo de trabalho:** + +* **[Práticas recomendadas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Padrões para tratamento de erros, desempenho e confiabilidade +* **[Limitações do fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Compreenda as restrições de tempo limite, ação e carga útil. + +**Crie mais fluxo de trabalho:** + +* **[Use um modelo](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: implante fluxo de trabalho pré-construído para cenários comuns +* **[Crie seu próprio fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: Desenvolva automações personalizadas do zero. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx new file mode 100644 index 00000000000..36147583df0 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/start-schedule.mdx @@ -0,0 +1,237 @@ +--- +title: Iniciar e agendar fluxo de trabalho +tags: + - workflow automation + - workflow + - start a workflow automation + - start workflow automation on demand + - schedule workflows +metaDescription: Trigger workflows manually or schedule them to run automatically at specified times using NerdGraph APIs. +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Depois de criar um fluxo de trabalho, você pode executá-lo manualmente sob demanda ou agendá-lo para ser executado automaticamente em horários específicos. Ambos os métodos utilizam a [API do NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) para acionar a execução do fluxo de trabalho. + +## Escolha seu método de ativação + +Selecione a abordagem adequada para o seu caso de uso: + +| **Uso sob demanda** | **Use o agendamento** | +| ------------------------------------- | ------------------------------------------- | +| Testando novo fluxo de trabalho | Verificações regulares de saúde | +| Fluxo de trabalho de aprovação manual | Processamento periódico de dados | +| respostas desencadeadas por alertas | Relatórios diários/semanais | +| Tarefas de manutenção pontuais | Janelas de manutenção programada | +| operações únicas | Cópias de segurança ou limpezas recorrentes | + +## Antes de você começar + +Antes de acionar o fluxo de trabalho, certifique-se de ter: + +* **Fluxo de trabalho criado**: Uma definição de fluxo de trabalho já implantada em sua conta (a partir de [template](/docs/workflow-automation/create-a-workflow-automation/use-a-template) ou [customizada](/docs/workflow-automation/create-a-workflow-automation/create-your-own)). +* **ID da conta**: Seu ID de conta New Relic (encontrado em [Configurações da conta](/docs/accounts/accounts-billing/account-structure/account-id)). +* **Nome do fluxo de trabalho**: O nome exato da sua definição de fluxo de trabalho. +* **Entradas obrigatórias**: Valores para qualquer parâmetro que seu fluxo de trabalho espera. +* **Segredos configurados**: credenciais AWS, token do Slack ou outros segredos armazenados no [gerenciador de segredos](/docs/infrastructure/host-integrations/installation/secrets-management/). + + + **Novo no fluxo de trabalho?** Crie seu primeiro fluxo de trabalho antes de tentar acioná-lo. Comece com [Use um modelo](/docs/workflow-automation/create-a-workflow-automation/use-a-template) para fluxo de trabalho pré-construído. + + +## Execute o fluxo de trabalho sob demanda [#on-demand] + +Acione o fluxo de trabalho manualmente usando a [APIStartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run). Isso executa o fluxo de trabalho imediatamente com as entradas que você fornecer. + +### Exemplo: invocar uma função AWS do Lambda + +A definição de fluxo de trabalho a seguir invoca uma função do Lambda da AWS e registra a saída. Substitua `12345678` pelo seu ID de conta New Relic. + +```yaml + name: lambda1 + + workflowInputs: + username: + type: String + defaultValue: "User" + key: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_ACCESS_KEY_ID }}" + access: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SECRET_ACCESS_KEY }}" + token: + type: String + defaultValue: "${{ :secrets:12345678:USERNAME_AWS_SESSION_TOKEN }}" + region: + type: String + defaultValue: us-east-1 + + steps: + - name: invoke1 + type: action + action: aws.lambda.invoke + version: 1 + inputs: + awsAccessKeyId: ${{ .workflowInputs.key }} + awsSecretAccessKey: ${{ .workflowInputs.access }} + awsSessionToken: ${{ .workflowInputs.token }} + region: ${{ .workflowInputs.region }} + functionName: hello-you + payload: + user: ${{ .workflowInputs.username }} + + - name: logOutput + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'The lambda function message output is:${{ .steps.invoke1.outputs.payload.body }}' +``` + +Para iniciar esse fluxo de trabalho, use a seguinte mutação do NerdGraph. Antes de executar esta mutação, certifique-se de ter armazenado suas credenciais da AWS usando a mutação `secretsManagementCreateSecret`. Para obter mais informações, consulte [Introdução à gestão de segredos](/docs/apis/nerdgraph/examples/nerdgraph-secrets-management). + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "Julien"} + ] + ) { + runId + } +} +``` + +**parâmetro explicado:** + +* `scope`O ID da conta onde a definição do seu fluxo de trabalho está armazenada. +* `definition`: O nome do fluxo de trabalho a ser executado (deve corresponder ao campo `name` na definição do seu fluxo de trabalho) +* `workflowInputs`: pares de valores principais que substituem os valores padrão na seção `workflowInputs` da sua definição de fluxo de trabalho + +A mutação retorna um `runId` (por exemplo, `7bd25287-2af8-42e1-b783-80f4e760a40b`). Utilize este ID para consultar os logs e visualizar a saída: + +Workflow automation logs showing the Lambda function output + +## Cronograma de fluxo de trabalho [#scheduled] + +Agende o fluxo de trabalho para ser executado automaticamente em horários específicos usando a [APICreateSchedule](/docs/workflow-automation/workflow-automation-apis). Fluxo de trabalho agendado executa tarefas recorrentes sem intervenção manual. + +**Quando agendar fluxo de trabalho:** + +* Verificações regulares de saúde +* Processamento periódico de dados +* Relatórios diários/semanais +* Janelas de manutenção programada +* Cópias de segurança ou limpezas recorrentes + +### Referência de expressão Cron + +Os agendamentos usam expressões cron para definir quando o fluxo de trabalho será executado. Formatar: `minute hour day month weekday` + +| **Padrão** | **Descrição** | **Exemplo de caso de uso** | +| -------------- | -------------------------------- | ---------------------------------------- | +| `0 9 * * *` | Todos os dias às 9h da manhã. | Verificações diárias de saúde pela manhã | +| `0 9 * * 1-5` | Todos os dias da semana às 9h00. | Operações do dia útil | +| `0 */6 * * *` | A cada 6 horas | Operações de sincronização regulares | +| `0 0 1 * *` | Primeiro dia do mês à meia-noite | Relatórios mensais | +| `*/15 * * * *` | A cada 15 minutos | Votação frequente | +| `0 0 * * 0` | Todo domingo à meia-noite | Tarefas de limpeza semanais | + + + **Sintaxe do Cron:** `*` significa "a cada", `/` significa "a cada n-ésima", `-` significa "intervalo". Exemplo: `0 9 * * 1-5` = No minuto 0, hora 9, todos os dias, todos os meses, de segunda a sexta-feira. + + +### Exemplo: Agende uma verificação diária de saúde. + +O exemplo a seguir agenda o fluxo de trabalho `lambda1` para ser executado todos os dias às 9h, horário do leste dos EUA: + +```graphql +mutation { + workflowAutomationCreateSchedule( + # Specify the account where the workflow is defined + scope: { type: ACCOUNT id: "12345678" } + + # Reference the workflow definition by name + definition: { name: "lambda1" } + + # Configure the schedule + schedule: { + # Cron expression: minute hour day month weekday + # "0 9 * * *" = every day at 9:00 AM + cronExpression: "0 9 * * *" + + # Timezone for the schedule + timezone: "America/New_York" + + # Optional: Schedule name for identification + name: "daily-lambda-health-check" + + # Optional: Add a description + description: "Runs Lambda health check every morning at 9 AM" + } + + # Provide input values for the workflow + workflowInputs: [ + {key: "key" value: "${{ :secrets:testUser123_AWS_ACCESS_KEY_ID }}"} + {key: "access" value: "${{ :secrets:testUser123_AWS_SECRET_ACCESS_KEY }}"} + {key: "token" value: "${{ :secrets:testUser123_AWS_SESSION_TOKEN }}"} + {key: "region" value:"us-east-2"} + {key: "username" value: "HealthCheckBot"} + ] + ) { + scheduleId + } +} +``` + +**O que você recebe em troca:** + +* `scheduleId`Identificador único para o agendamento (use-o para atualizar ou excluir o agendamento posteriormente) + +### Gerenciar agendas + +Após criar um cronograma: + +* **Veja os horários ativos**: Consulte todas as execuções agendadas no [dashboarddo fluxo de trabalho.](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs) +* **Atualizar programação**: Use a API UpdateSchedule para alterar a frequência ou as entradas. +* **Excluir agendamento**: Use a API DeleteSchedule para interromper execuções recorrentes. + +Para documentação completa API, consulte [APIs de automação de fluxo de trabalho](/docs/workflow-automation/workflow-automation-apis). + +## Próximos passos + +Seu fluxo de trabalho está funcionando! Eis o que fazer a seguir: + +**Monitorar e gerenciar:** + +* **[Gerenciar fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: visualizar histórico de execuções, verificar logs e solucionar problemas. +* **[Solucionar problemas de fluxo de trabalho](/docs/workflow-automation/troubleshooting)**: Resolva problemas comuns de execução + +**Otimizar para produção:** + +* **[práticas recomendadas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Tratamento de erros, desempenho e padrões de confiabilidade +* **[Limites de fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Entenda os limites de tempo limite e de restrição. + +**Expanda seu fluxo de trabalho:** + +* **[Catálogo de ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: Explore todas as integrações disponíveis. +* **[APIs de automação de fluxo de trabalho](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: gerenciamento programático de fluxo de trabalho \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx new file mode 100644 index 00000000000..f68e425d787 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/create-a-workflow-automation/use-a-template.mdx @@ -0,0 +1,284 @@ +--- +title: Use um modelo para criar uma automação de fluxo de trabalho. +tags: + - workflow automation + - create your own workflow + - build a workflow using New Relic + - workflow template +metaDescription: 'Jump-start your automation with pre-built workflow templates. Deploy in minutes, customize to your needs, and automate common tasks.' +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Os modelos fornecem fluxo de trabalho pré-configurado para cenários comuns: envio de relatórios para o Slack, reversão de implantação, redimensionamento de instâncias do EC2 e muito mais. Implantável em minutos, depois personalizável para se adequar ao processo da sua equipe. + +## Por que usar modelos? + +* **Comece mais rápido**: implante automações em funcionamento em minutos. +* **Siga as práticas recomendadas**: Use padrões comprovados e tratamento de erros +* **Aprenda com exemplos**: veja como as ações se conectam e os fluxos de dados se desenvolvem. +* **Reduza erros**: comece com configuração testada + +## Antes de você começar + +A maioria dos modelos precisa de credenciais e integração: + +* **Modelos da AWS**: [credenciais da AWS](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials) com permissões (EC2, API Gateway, Systems Manager ou SQS). +* **Notificação do Slack**: Aplicativo Slack com token de bot e acesso ao canal. +* **Todos os modelos**: GUIDs da conta New Relic e da entidade (identificador único para recursos monitorados). + + + **Ainda não tem credenciais?** Primeiro, navegue pelos modelos. Configure as credenciais antes de implantar. + + +## implantar um modelo + + + + ### Encontre o modelo certo + + Navegue pela [biblioteca de modelos](#workflow-automation-templates) abaixo. Cada um mostra o que faz, quando usá-lo, os requisitos e como funciona. + + + + ### implantar e configurar + + 1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + 2. Selecione **Use a Template** + 3. Escolha seu modelo + 4. Preencha os inputs (credenciais, GUIDs de entidade, consulta, canais) + 5. Selecione **Deploy** + + Seu fluxo de trabalho agora está ativo. + + + + ### Teste e verifique + + Testar antes do uso em produção: + + 1. Acionar manualmente (ver [Iniciar fluxo de trabalho sob demanda](/docs/workflow-automation/create-a-workflow-automation/start-schedule#on-demand)) + 2. Monitore a execução no histórico de execuções + 3. Verificar saídas (mensagens do Slack, alterações da AWS, logs) + 4. Revisar erros, ajustar configuração + + + **Primeiro, testar em ambiente não produtivo.** Alguns modelos alteram a infraestrutura. Validar antes de usar na produção. + + + + +## Personalize seu modelo + +Modificar fluxo de trabalho após implantação: + +* **Adicionar lógica condicional**: Ignorar etapas com base em condições +* **modelos de cadeia**: Use saídas como entradas para outros fluxos de trabalho +* **Ajustar notificação**: Alterar formatos, destinatários, canais +* **Adicionar ações personalizadas**: Incluir requests HTTP ou transformações de dados. + +Consulte a seção [Criar seu próprio fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/create-your-own) para obter detalhes. + +## Modelos de resolução de problemas + +Se o seu fluxo de trabalho falhar ou não se comportar como esperado: + +1. **Verifique o histórico de execução**: Vá para **Workflow Automation > \[Seu fluxo de trabalho] > Run History** para ver logs de execução e mensagem de erro + +2. **Revise problemas comuns**: Consulte [resolução de problemas de fluxo de trabalho Automação](/docs/workflow-automation/troubleshooting) para soluções para: + + * Erros de credenciais e permissões da AWS + * Problemas de integração com o Slack + * Problemas com o GUID da entidade + * falhas de consultoria NRQL + * Tempo limite do fluxo de trabalho + * Resolução de problemas específica do modelo + + + **Teste templates com segurança**: Sempre teste primeiro em ambiente não produção. Modelos que alteram a infraestrutura (EC2, API Gateway) podem afetar a disponibilidade se estiverem configurados incorretamente. + + +## Modelos de automação de fluxo de trabalho + + + + **O que ele faz:** + + Consulta dados New Relic com NRQL (New Relic Query Language), formata os resultados em CSV e publica no Slack. + + **Quando usar:** + + Automatize relatórios regulares: resumos diários de desempenho, taxas de erros semanais, volumes de transação por hora ou métricas personalizadas. + + **O que você vai precisar:** + + * **Slack**: token de bot com permissões de publicação no canal + * **New Relic**: Acesso à conta e consulta NRQL válida + + **Como funciona:** + + 1. Executa sua consulta NRQL + 2. Converte os resultados para CSV. + 3. Postagens no Slack + 4. Status dos logs + + + + **O que ele faz:** + + Detecta problemas de implantação e reverte o AWS API Gateway para a configuração anterior — após obter a aprovação da equipe. + + **Quando usar:** + + Reverter más implantações que geram erros, quebram integração ou causam incidentes. Rede de segurança para alterações de alto risco. + + **O que você vai precisar:** + + * **AWS**: Permissões do API Gateway e do Systems Manager + * **Slack**: App para notificação e aprovação + * **New Relic**: GUID da entidade do API Gateway + + **Como funciona:** + + 1. Recupera o histórico de implantação + 2. Relaciona-se com a questão atual. + 3. Solicita aprovação do Slack + 4. Executa o rollback se aprovado. + 5. Notifica a equipe e limpa tudo. + + + **Aprovação manual necessária.** Não será possível reverter a alteração sem a aprovação da equipe por meio de reações no Slack. + + + + + **O que ele faz:** + + Redimensiona automaticamente as instâncias do EC2 quando há picos de CPU ou recursos. + + **Quando usar:** + + Lidar com picos de uso da CPU durante picos de tráfego, escalar instantaneamente ao atingir limites, gerenciar padrões de carga imprevisíveis. + + **O que você vai precisar:** + + * **AWS**: Permissões do EC2 e do Systems Manager + * **Slack**: App para notificação e aprovação + * **New Relic**: condição do alerta monitoramento EC2, [AWS CloudWatch Metric Streams](https://docs.newrelic.com/install/aws-cloudwatch/), [EC2 monitoramento integração](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) + + + **Utilize o CloudWatch Metric Streams.** Oferece cobertura completa AWS Métrica, incluindo namespaces personalizados. + + + **Como funciona:** + + 1. Recebe um alerta e identifica a instância. + 2. Solicita aprovação do Slack + 3. Cria documento de automação + 4. Interrompe, modifica e inicia instância + 5. Atualiza o progresso e realiza a limpeza. + + + + **O que ele faz:** + + Busca dados JSON em páginas de status externas, analisa o estado de saúde dos componentes e registra as informações no New Relic. + + **Quando usar:** + + Monitore a dependência de terceiros (processadores de pagamento, provedores de autenticação, serviços de dados), correlacione interrupções com seus problemas e crie um dashboard unificado. + + **O que você vai precisar:** + + * **AcessoAPI **: endpoint público de status retornando JSON + * **New Relic**: Conta para logging de atividades + + **Como funciona:** + + 1. Obtém o JSON do endpoint. + 2. Analisa a integridade do componente. + 3. Classifica o estado operacional + 4. Logs para o New Relic com filtros + + + **Agende medições a cada 5-15 minutos** para construir uma visão histórica da confiabilidade de terceiros. + + + + + **O que ele faz:** + + Monitora a saúde do aplicativo após a implantação, envia notificação quando surgem problemas. + + **Quando usar:** + + Acompanhe novos lançamentos pós-implantação, detecte problemas somente de produção, acione reversão do fluxo de trabalho em caso de degradação da saúde. + + **O que você vai precisar:** + + * **New Relic**: GUID da entidade para monitoramento + * **Notificação** (escolha uma ou ambas): Permissões AWS SQS ou endpointde webhook HTTP + + **Como funciona:** + + 1. Monitora a saúde a cada 1-5 minutos. + 2. Avalia a gravidade do alerta. + 3. Envia notificação (SQS/webhook) quando degradado + 4. Registra todas as verificações de saúde. + 5. Continua até ser interrompido ou recuperado. + + + **Use com [Monitoramento de Alterações](/docs/change-tracking/change-tracking-introduction)** para correlacionar questões com implantação. + + + + + **O que ele faz:** + + Executa consultas SQL no catálogo de dados da New Relic usando o NRLens (ferramenta avançada de consulta). + + **Quando usar:** + + Análises complexas além NRQL: junções de múltiplas tabelas, análises estatísticas, relatórios personalizados combinando métricas/evento/logs. + + **O que você vai precisar:** + + * **NRLens**: Credenciais para o SQL Consulta Gateway + * **New Relic**: IDs de organização e de conta + + **Como funciona:** + + 1. Conecta-se ao NRLens + 2. Executa SQL + 3. Recupera resultados + 4. Registra para o New Relic + 5. Suporta agendamento + + + **NRLens estende NRQL.** Use NRQL para consultas rápidas e NRLens SQL para cargas de trabalho analíticas complexas. + + + + +## Próximos passos + +### Executar e gerenciar + +* **[Iniciar e agendar fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: Acionar manualmente ou agendar automaticamente +* **[Gerenciando o fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: edite, duplique ou remova o fluxo de trabalho + +### Crie algo personalizado + +* **[Crie seu próprio fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: construa do zero com lógica personalizada. +* **[práticas recomendadas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Padrões para automações confiáveis e prontas para produção + +### Escala + +* **[APIs de automação de fluxo de trabalho](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: Integração com CI/CD ou infraestrutura como código +* **[Limites do fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: tempos limite, limites de taxa, restrições. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/introduction-to-workflow.mdx b/src/i18n/content/pt/docs/workflow-automation/introduction-to-workflow.mdx new file mode 100644 index 00000000000..50473caa397 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/introduction-to-workflow.mdx @@ -0,0 +1,148 @@ +--- +title: Introdução à automação de fluxo de trabalho +tags: + - workflow automation + - workflow + - automation +metaDescription: Automate routine tasks and incident responses with Workflow Automation in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +O fluxo de trabalho Automation conecta New Relic às suas ferramentas existentes para automatizar a resposta a incidentes, o gerenciamento de infraestrutura e as tarefas operacionais — sem escrever código. Crie fluxos de trabalho que respondam a alertas, integrem-se com AWS e Slack, gerenciem aprovações e executem lógica de automação complexa. + +Screenshot showing the workflow automation interface + +## Principais benefícios + +* **Resposta mais rápida a incidentes**: redimensione automaticamente instâncias do EC2, reverta implantação ou reinicie serviços quando alertas dispararem – sem necessidade de intervenção manual +* **Conecte suas ferramentas**: Integre o New Relic com AWS, Slack, Jira, ServiceNow e qualquer API HTTP para enviar dados de alerta enriquecidos para onde sua equipe trabalha. +* **Adicionar pontos de aprovação**: Incluir supervisão humana no fluxo de trabalho crítico — solicitar a confirmação da equipe antes de expandir a infraestrutura de produção ou executar reversões. +* **Gerencie a complexidade**: Utilize lógica condicional, loops e transformações de dados para automatizar seus processos operacionais exclusivos. + +## Casos de uso comuns + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Categoria + + Exemplos +
+ **resposta a incidentes** + + Corrija problemas automaticamente, reverta implantação com falha, redimensione a infraestrutura com base em alertas. +
+ **Gestão de infraestrutura** + + Dimensionar serviços de acordo com cronogramas, gerenciar recursos da AWS e executar runbooks automaticamente. +
+ **Notificação** + + Envie alertas mais detalhados para o Slack, gere relatórios agendados e formate dados em CSV. +
+ **Integração** + + Conecte-se a qualquer API, sincronize dados entre sistemas e atualize a plataforma de tickets. +
+ +Consulte a página [de exemplos de fluxo de trabalho](/docs/workflow-automation/workflow-examples) para obter cenários detalhados e modelos prontos para uso. + +## Iniciar + +Escolha o seu caminho com base no que você deseja construir: + + + + Use um modelo Crie fluxo de trabalho personalizado Configure integração + + + + + implantar fluxo de trabalho pré-configurado para cenários comuns – envio de relatórios para o Slack, reversão de implantação, redimensionamento de instâncias do EC2 e muito mais. + + 1. Navegue [pelos modelos disponíveis](/docs/workflow-automation/create-a-workflow-automation/use-a-template) + 2. Selecione um modelo que corresponda ao seu caso de uso. + 3. Configurar entradas (credenciais, GUIDs de entidade, consulta) + 4. implante e teste + + + + Construa o fluxo de trabalho do zero usando a interface de arrastar e soltar. Encadeie ações, adicione lógica condicional e integre com suas ferramentas. + + 1. Analise o [exemplo de redimensionamento automático do EC2.](/docs/workflow-automation/create-a-workflow-automation/create-your-own) + 2. Compreender padrões de fluxo de trabalho (alternâncias, loops, aprovações) + 3. Veja [as ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)disponíveis + 4. Construa incrementalmente e teste cada etapa. + + + + Configure credenciais e canal de notificação para que o fluxo de trabalho possa interagir com serviços externos. + + **Fluxo de trabalho AWS **: [configurar credenciais AWS ](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)(funções IAM, usuário ou token de sessão) + + **Notificação**: [Criar destinos](/docs/workflow-automation/setup-and-configuration/create-destinations) (Slack, email, webhooks) + + + + +## Próximos passos + +Após criar seu primeiro fluxo de trabalho, aprenda a gerenciá-lo e otimizá-lo: + + + + * **[Iniciar e agendar fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/start-schedule)**: Acione manualmente ou configure execuções recorrentes com expressões cron. + * **[Gerenciar fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)**: Editar configuração, duplicar para diferentes ambientes, monitorar histórico de execução + + + + * **[resolução de problemas](/docs/workflow-automation/troubleshooting)**: corrija erros de credenciais, problemas de integração e falhas de fluxo de trabalho + * **[Práticas recomendadas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: tratamento de erros, otimização de desempenho, estratégias de teste + * **[Limites do fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Entenda os tempos limite, os limites de taxa e as restrições. + + + + * **[Catálogo de ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: Navegue por todas as ações disponíveis da AWS, New Relic e HTTP. + * **[Exemplos de fluxo de trabalho](/docs/workflow-automation/workflow-examples)**: Aprenda com cenários de automação do mundo real. + * **[APIs de fluxo de trabalho](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api)**: Gerencie o fluxo de trabalho programaticamente para integração CI/CD + + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx b/src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx new file mode 100644 index 00000000000..938484e3e34 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-best-practices.mdx @@ -0,0 +1,326 @@ +--- +title: fluxo de trabalho Automação práticas recomendadas +tags: + - Workflow Automation + - workflow + - best practices + - workflow automation best practices +metaDescription: 'Build reliable, maintainable workflows that handle errors gracefully and scale with your operations.' +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Crie um fluxo de trabalho confiável que lide com erros de forma elegante, proteja dados confidenciais e seja escalável conforme suas operações. Siga esses padrões para criar automações de fácil manutenção. + +## Fluxo de trabalho focado em design + +Mantenha o fluxo de trabalho focado em uma única responsabilidade. Agrupe ações relacionadas, mas evite combinar tarefas não relacionadas. + +### Um fluxo de trabalho, um propósito + +**O que fazer**: Criar fluxo de trabalho separado para resposta a incidentes e manutenções programadas. **O que não fazer**: combine redimensionamento do EC2, backups de banco de dados e notificação do Slack em um fluxo de trabalho. + +### Reutilizar fluxo de trabalho com parâmetro + +Use o parâmetro input para tornar o fluxo de trabalho reutilizável entre ambientes em vez de duplicar o fluxo de trabalho. + +**Exemplo**: Um fluxo de trabalho de redimensionamento do EC2 com parâmetro de região e tipo de instância: + +```yaml +inputs: + awsRegion: us-east-1 + instanceType: t3.medium + instanceId: i-1234567890abcdef0 +``` + +Isso substitui a criação de fluxo de trabalho separado para cada região ou tipo de instância. + +### Combine ações relacionadas + +Agrupe ações relacionadas que devem ser executadas em conjunto: + +* **Faça**: consultar detalhes do alerta, formatar mensagem, enviar para o Slack em um fluxo de trabalho +* **O que não fazer**: crie um fluxo de trabalho separado para "consulta alerta", "formatar mensagem", "enviar para o Slack" + +## Lidar com erros + +Inclua sempre tratamento de erros para chamadas externas de API e operações críticas. + +### Adicionar ações de fallback + +Quando etapas críticas podem falhar, adicione ações de contingência que notifiquem sua equipe. + +**Exemplo**: Enviar notificação do Slack mesmo se uma etapa falhar usando `ignoreErrors`: + +```yaml +- name: sendNotification + type: action + action: aws.execute.api + version: 1 + ignoreErrors: true + inputs: + service: sqs + api: send_message + parameters: + MessageBody: "Rollback notification" + QueueUrl: "${{ .workflowInputs.queueUrl }}" + +- name: logResult + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Notification sent: ${{ .steps.sendNotification.outputs.success }}" +``` + +Use `ignoreErrors: true` para continuar a execução do fluxo de trabalho mesmo se uma etapa falhar. + +### Defina os tempos limite apropriados. + +Defina tempos limite para chamadas externas de API para evitar que o fluxo de trabalho seja interrompido: + +* Chamada de API AWS : 30-60 segundos +* consulta ao banco de dados: 10-30 segundos +* requests HTTP: 15 a 30 segundos +* Mensagens do Slack: 10 segundos + +### Registra erros para resolução de problemas + +Inclua esses detalhes nos logs de erros: + +* Ação que falhou +* Parâmetro de entrada +* mensagem de erro do serviço +* Timestamp + +## Credenciais seguras + +Armazene todos os valores sensíveis no gerenciador de segredos do New Relic. Nunca insira credenciais diretamente no código-fonte das definições de fluxo de trabalho. + +### Use o gerenciador de segredos + +Armazene credenciais AWS, token API e senhas: + +```graphql +mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } +} +``` + +Segredos de referência: `${{ :secrets:awsAccessKeyId }}` + +### Troque as credenciais regularmente. + +Se estiver usando chaves de acesso de usuário do IAM: + +* Faça o rodízio no mínimo a cada 90 dias. +* Defina lembretes no calendário +* Teste as novas credenciais antes de excluir as antigas. + +**Recomendação**: Use funções do IAM em vez disso — elas são rotacionadas automaticamente. + +### Use permissões de privilégio mínimo + +Conceda apenas as permissões necessárias. Comece com permissões somente leitura e adicione permissões de gravação apenas quando necessário. + +**Exemplo de política do AWS IAM** para SQS: + +```json +{ + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-queue" +} +``` + +Isso restringe o acesso a uma fila específica. + +## Testar antes da produção + +Testar fluxo de trabalho em ambiente não produção antes de implantar em produção. + +### Duplicado para fins de teste. + +Crie versões de teste do fluxo de trabalho de produção: + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Localize o fluxo de trabalho e clique no menu de mais opções. +3. Selecionar **Duplicate** +4. Atualize as credenciais para usar contas de teste. +5. Teste com recursos que não sejam de produção. + +### cenários de falha de teste + +Verifique as falhas do identificador de fluxo de trabalho: + +* E se a API da AWS estiver indisponível? +* E se o Slack estiver fora do ar? +* E se as credenciais expirarem? +* E se um recurso necessário não existir? + +### Verificar integração + +Antes de agendar, acione manualmente o fluxo de trabalho e verifique: + +* As ações da AWS são executadas com sucesso. +* As mensagens do Slack aparecem nos canais corretos. +* Os portões de aprovação aguardam respostas. +* O tratamento de erros funciona conforme o esperado. + +## Otimizar o desempenho + +Crie um fluxo de trabalho eficiente que seja executado rapidamente. + +### Consulte uma vez, reutilize os resultados + +Armazene os resultados da consulta e faça referência a eles várias vezes: + +```yaml +- name: getAlertDetails + action: newrelic.nerdgraph.execute + +- name: sendToSlack + inputs: + text: "${{ .steps.getAlertDetails.outputs.data }}" + +- name: updateJira + inputs: + body: "${{ .steps.getAlertDetails.outputs.data }}" +``` + +**Não faça isso**: consulte os detalhes dos alertas separadamente para Slack e Jira. + +## Monitorar e manter + +Monitore regularmente a execução do fluxo de trabalho e mantenha-o atualizado. + +### Verifique o histórico de execução semanalmente + +Execuções do fluxo de trabalho de revisão: + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Selecione o fluxo de trabalho +3. Clique em **Run history** +4. Procure por execuções com falha ou tempos de execução crescentes. + +### Configure alertas de falha + +Configure alertas para falhas no fluxo de trabalho: + +1. Criar condição de alerta para falhas de execução de fluxo de trabalho +2. Enviar notificação para o canal principal da equipe +3. Inclua o nome do fluxo de trabalho e os detalhes do erro. + +### Revise o fluxo de trabalho trimestralmente + +Defina lembretes recorrentes no calendário para: + +* Remover fluxo de trabalho não utilizado +* Atualizar credenciais expiradas +* Verifique se os serviços integrados não sofreram alterações nas APIs. +* cenários de falha de teste +* Atualizar documentação + +## Fluxograma de trabalho + +Torne o fluxo de trabalho fácil de entender. + +### Use nomes descritivos + +* **Faça**: "Redimensionamento automático do EC2 para alertas de alto uso da CPU" +* **Não faça**: "fluxo de trabalho 1" ou "EC2 Automation" + +### Escreva descrições claras + +Explique o quê, quando e quem: + +``` +Automatically resizes EC2 instances when CPU exceeds 90% for 10 minutes. +Requires approval via Slack before executing changes. +Owner: DevOps Team (devops@example.com) +Last updated: 2025-01-26 +``` + +### Adicione comentários para lógica complexa. + +Ao usar lógica condicional ou laços de repetição, explique a lógica: + +```yaml +- name: checkCPU + # Query CPU for last 10 minutes to avoid false positives + type: action + action: newrelic.nerdgraph.execute + version: 1 + +- name: decideAction + # If CPU > 90%: resize, 70-90%: warn, < 70%: no action + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.result > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.result > 70 }}" + next: sendWarning + next: noAction +``` + +## Segurança + +Proteja o fluxo de trabalho e os recursos que eles acessam. + +### Utilize portões de aprovação para operações destrutivas. + +Exigir aprovação humana antes de: + +* Excluindo recursos +* Reduzir a escala dos serviços de produção +* Revertendo a implantação +* Modificando permissões do IAM + +### Alterações no fluxo de trabalho de auditoria + +Utilize o histórico de versões para acompanhar as alterações: + +1. Acesse os detalhes do fluxo de trabalho. +2. Clique em **Version history** +3. Analise as alterações e quem as fez. + +### Restringir o acesso ao fluxo de trabalho + +Certifique-se de que apenas membros autorizados da equipe possam editar o fluxo de trabalho: + +1. Revise o perfil do usuário nas configurações da conta +2. Limitar as permissões de edição à equipe de DevOps +3. Utilize contas separadas para produção e teste. + +## Próximos passos + +**Compreenda os limites:** + +* **[Limitações do fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits)** - Restrições de tempo limite, ação e carga útil + +**Solucionar problemas:** + +* **[Resolução de problemas](/docs/workflow-automation/troubleshooting)** - Soluções para problemas comuns + +**Veja exemplos:** + +* **[Exemplos de fluxo de trabalho](/docs/workflow-automation/workflow-examples)** - Cenários de automação do mundo real + +**Gerenciar fluxo de trabalho:** + +* **[Gerenciando o fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow)** - Edite, duplique e monitore o fluxo de trabalho \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx b/src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx new file mode 100644 index 00000000000..0c3f6a741f3 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/limitations-and-faq/workflow-limits.mdx @@ -0,0 +1,201 @@ +--- +title: Limitações da automação do fluxo de trabalho +metaDescription: 'For New Relic Workflow automation, explanations of the Workflow automation limits.' +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ O que + + Mínimo + + Máx. +
+ Tamanho da saída da ação + + + + 100 KB +
+ Tentativas de repetição de ação + + + + 3 +
+ Definição do fluxo de trabalho - número total de etapas + + 1 + + 100 +
+ Tamanho da definição do fluxo de trabalho + + + + 50 KB +
+ Número de definições de fluxo de trabalho + + + + 1000 +
+ Duração do fluxo de trabalho + + + + 7 dias +
+ Etapas totais da execução do fluxo de trabalho + + + + 5.000 +
+ Número de horários + + + + 10 +
+ Comprimento de um valor de entrada do fluxo de trabalho + + + + 1000 caracteres +
+ Execuções simultâneas do fluxo de trabalho (por conta) + + + + 30 +
+ tamanho do sinal de entrada + + + + 10 KB +
+ Número de condições na Etapa de Comutação + + + + 10 +
+ Número de sinais na etapa de espera + + + + 10 +
+ +## Qual é o próximo? + +Você compreende as limitações técnicas. Agora explore maneiras programáticas de gerenciar seu fluxo de trabalho em escala. + +**A seguir em sua jornada**: [APIs de automação de fluxo de trabalho](/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api) - Aprenda como criar, gerenciar e executar fluxo de trabalho programaticamente. + +**Recursos adicionais**: + +* [Catálogo de ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) - Referência completa de todas as ações +* [práticas medidas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices) - Revise técnicas de otimização \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx new file mode 100644 index 00000000000..eb25fe05901 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog.mdx @@ -0,0 +1,41 @@ +--- +title: Visão geral do catálogo de ações +tags: + - workflow automation + - workflow + - workflow automation actions + - actions catalog +metaDescription: List of available actions catalog for workflow definition +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +O catálogo de ações New Relic fornece ações que podem ser executadas em sua infraestrutura e integração. Você pode orquestrar e automatizar seus processos de ponta a ponta, conectando ações que executam tarefas em seus provedores cloud e contas New Relic. + +## Catálogos de ações disponíveis [#available-catalogs] + +Os seguintes catálogos de ações estão disponíveis para automação de fluxo de trabalho: + +* [Ações da AWS](/docs/workflow-automation/setup-and-configuration/actions-catalog/aws) - Integre-se com os serviços da AWS, incluindo Lambda, EC2 e Systems Manager. +* [Ações de comunicação](/docs/workflow-automation/setup-and-configuration/actions-catalog/communication) - Enviar notificações e mensagens por meio de diversos canais de comunicação. +* [Ações HTTP](/docs/workflow-automation/setup-and-configuration/actions-catalog/http) - Faça requests HTTP para APIs e serviços externos. +* [AçõesNew Relic ](/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic)- Interaja com os recursos e dados da plataforma New Relic +* [AçõesPagerDuty ](/docs/workflow-automation/setup-and-configuration/actions-catalog/pagerduty)- Gerencie incidentes e integrações PagerDuty +* [Ações de utilitário](/docs/workflow-automation/setup-and-configuration/actions-catalog/others) - Executar transformações de dados comuns e operações de utilitário + +## Qual é o próximo? + +Você já viu todas as ações disponíveis. Agora é hora de juntá-los e construir seu primeiro fluxo de trabalho. + +**Próximo passo na sua jornada**: [Gerenciando o fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) - Aprenda como criar, gerenciar e executar fluxos de trabalho no New Relic. + +**Comece a construir**: + +* [Use um modelo de fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/use-a-template) – Início rápido com fluxo de trabalho pré-construído +* [Crie seu próprio fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/create-your-own) - Crie um fluxo de trabalho personalizado do zero \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx new file mode 100644 index 00000000000..0800ef1aae9 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/communication.mdx @@ -0,0 +1,704 @@ +--- +title: Ações de comunicação +tags: + - workflow automation + - workflow + - workflow automation actions + - communication actions + - slack actions + - ms teams actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página fornece uma referência completa para as ações de comunicação disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem que você integre a plataforma de comunicação às suas definições de fluxo de trabalho, incluindo o envio de mensagens para canais do Slack, a recuperação de reações e muito mais. + +## Pré-requisitos + +Antes de usar ações de comunicação na automação de fluxo de trabalho, certifique-se de ter: + +* Um espaço de trabalho do Slack com as permissões apropriadas. +* Um token de bot do Slack configurado como um segredo na automação de fluxo de trabalho. +* Acesso aos canais do Slack onde você deseja enviar mensagens. + +Consulte a seção [Adicionar configuração do Slack](/docs/autoflow/overview#add-the-slack-integration) para obter informações sobre como configurar a integração com o Slack. + +## Ações de comunicação disponíveis + +Guia rápido de todas as ações de comunicação por plataforma: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Plataforma + + Ação + + Propósito +
+ **Slack** + + [Postar mensagem](#slackchatpostmessage) + + Envie mensagens para canais do Slack com anexos de arquivo opcionais. +
+ **Slack** + + [Obtenha reações](#slackchatgetreactions) + + Recuperar reações com emojis de mensagens do Slack. +
+ +## Ações do Slack + + + + Envia uma mensagem para um canal do Slack, com a opção de anexar um arquivo. + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Exemplo +
+ **token** + + Obrigatório + + segredo + + `${{ :secrets:slackToken }}` +
+ **canal** + + Obrigatório + + corda + + `my-slack-channel` +
+ **texto** + + Obrigatório + + corda + + `Hello World!` +
+ **threadTs** + + Opcional + + corda + + `.` +
+ **anexo** + + Opcional + + map + +
+ **anexo.nome do arquivo** + + Obrigatório + + corda + + `file.txt` +
+ **anexo.conteúdo** + + Obrigatório + + corda + + `Hello\nWorld!` +
+ + + * **token**: O token do bot do Slack a ser usado. Isso deve ser passado como uma sintaxe secreta. Consulte a seção [Adicionar configuração do Slack](/docs/autoflow/overview#add-the-slack-integration) para obter instruções sobre como configurar um token. + * **channel**: O nome do canal, ou um ID de canal, para enviar a mensagem. Consulte [a API do Slack](https://api.slack.com/methods/chat.postMessage#arg_channel/) para obter mais informações. + * **text**: A mensagem a ser postada no Slack no `channel` especificado. + * **threadTs**: carimbo de data/hora pertencente à mensagem principal, usado para criar uma resposta em uma thread. + * **attachment**: Permite anexar um arquivo com uma mensagem no `channel` especificado. + * **attachment.filename**: Especifique o nome do arquivo que será carregado no Slack. + * **attachment.content**: O conteúdo do arquivo a ser carregado está em UTF-8. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Exemplo +
+ **threadTs** + + corda + + `.` +
+ **ID do canal** + + corda + + `` +
+ + + * **threadTs**: carimbo de data/hora da mensagem. Pode ser usado em futuras chamadas postMessage para postar uma resposta em um tópico. + * **channelID**: ID do canal onde a mensagem foi postada. + + + + + **Exemplo 1: Publicar uma mensagem em um canal do Slack** + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: SendMessage + + steps: + - name: send_slack_message + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: ${{ .workflowInputs.channel }} + text: ${{ .workflowInputs.text }} + ``` + + **Entradas esperadas:** + + ```json + { + "inputs": [ + { + "key" : "channel", + "value" : "my-channel" + }, + { + "key" : "text", + "value" : "This is my message *with bold text* and `code backticks`" + } + ] + } + ``` + + **Resultado esperado:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + **Exemplo 2: Anexar um arquivo** + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: SendFileMessage + + steps: + - name: postCsv + type: action + action: slack.chat.postMessage + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channel: my-channel + text: "Please find the attached file:" + attachment: + filename: 'file.txt' + content: "Hello\nWorld!" + ``` + + **Resultado esperado:** + + ```json + [ + { + "threadTs": "1718897637.400609", + "channelID": "C063JK1RHN1" + } + ] + ``` +
+ + + + + + + + + Receba uma reação a uma mensagem de um canal do Slack. + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Exemplo +
+ **token** + + Obrigatório + + segredo + + `${{ :secrets:slackToken }}` +
+ **ID do canal** + + Obrigatório + + corda + + `C063JK1RHN1` +
+ **Tempo esgotado** + + Opcional + + int + + 60 +
+ **threadTs** + + Obrigatório + + corda + + `.` +
+ **seletores** + + Opcional + + list + + `[{\"name\": \"reactions\", \"expression\": \".reactions \"}]` +
+ + + * **token**: O token do bot do Slack a ser usado. Isso deve ser passado como uma sintaxe secreta. Consulte a seção [Adicionar configuração do Slack](/docs/autoflow/overview#add-the-slack-integration) para obter instruções sobre como configurar um token. + * **channelID**: O ID do canal para receber as reações às mensagens. + * **timeout**: O tempo em segundos que se deve esperar por qualquer reação. O valor padrão é 60 segundos, o máximo permitido é 600 segundos (10 minutos). + * **threadTs**: carimbo de data/hora pertencente à mensagem, usado para obter a reação a essa mensagem. + * **selectors**: Os seletores para obter apenas o parâmetro especificado como saída. + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Exemplo +
+ **reações** + + list + + `` +
+ + + * **reactions**: Lista de elementos com todas as reações registradas ou uma lista vazia caso tenha ocorrido um tempo limite. + + + + + **Exemplo 1: Slack recebe reações** + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: GetReactions + + steps: + - name: getReactions + type: action + action: slack.chat.getReactions + version: 1 + inputs: + token: ${{ :secrets:slackToken }} + channelID: ${{ .steps.promptUser.outputs.channelID }} + threadTs: ${{ .steps.promptUser.outputs.threadTs }} + timeout: ${{ .workflowInputs.timeout }} + selectors: ${{ .workflowInputs.selectors }} + ``` + + **Entradas esperadas:** + + ```json + { + "inputs": [ + { + "key" : "channelID", + "value" : "C063JK1RHN1" + }, + { + "key" : "threadTs", + "value" : "1718897637.400609" + }, + { + "key" : "selectors", + "value" : "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" + } + ] + } + ``` + + **Resultado esperado:** + + ```json + [ + { + "name": "grinning", + "users": [ + "W222222" + ], + "count": 1 + }, + { + "name": "question", + "users": [ + "W333333" + ], + "count": 1 + } + ] + ``` + + Ou, se o tempo limite tiver expirado: + + ```json + [] + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx new file mode 100644 index 00000000000..b816fe6de22 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/http.mdx @@ -0,0 +1,1103 @@ +--- +title: Ações HTTP +tags: + - workflow automation + - workflow + - workflow automation actions + - HTTP actions +metaDescription: A list of available HTTP actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página fornece uma referência completa para as ações HTTP disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem que você faça requests HTTP (GET, POST, PUT, DELETE) para APIs e serviços externos como parte das suas definições de fluxo de trabalho. + +## Pré-requisitos + +Antes de usar ações HTTP na automação de fluxo de trabalho, certifique-se de ter: + +* endpointde destino de URLs API. +* Quaisquer credenciais de autenticação necessárias (chave de API, token, etc.). +* Compreensão dos formatos de requisição/resposta da API. + + + As ações HTTP suportam sintaxe secreta para qualquer valor de cabeçalho, permitindo que você passe dados sensíveis com segurança, como a chave de API. Consulte [a seção de gerenciamento de segredos](/docs/infrastructure/host-integrations/installation/secrets-management/) para obter mais informações. + + +## Ações HTTP disponíveis + +Referência rápida de todas as ações HTTP: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Ação + + Propósito +
+ [solicitação GET](#httpget) + + Recuperar dados de um endpointda API. +
+ [Solicitação POST](#httppost) + + Enviar dados para um endpointda API. +
+ [Solicitação PUT](#httpput) + + Atualizar dados em um endpointda API. +
+ [solicitação de exclusão](#httpdelete) + + Excluir dados em um endpointda API. +
+ +## Ações HTTP + + + + Realize uma chamada HTTP GET para recuperar dados de um endpointda API. + + + Isso permite o uso de sintaxe secreta para qualquer valor de cabeçalho. + + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Descrição +
+ **url** + + Obrigatório + + Corda + + A URL de destino da solicitação. O esquema deve ser incluído: + + `https://example.com` +
+ **parâmetros da URL** + + Opcional + + Mapa + + O parâmetro de consulta deve ser adicionado à URL. Recebe um objeto JSON em formato de string. +
+ **cabeçalhos** + + Opcional + + Mapa + + Os cabeçalhos a serem adicionados à solicitação. Recebe um objeto JSON em formato de string. +
+ **seletores** + + Opcional + + Lista + + Os seletores permitem obter apenas o parâmetro especificado como saída. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Descrição +
+ **respostaCorpo** + + Corda + + O corpo da resposta. +
+ **código de status** + + Inteiro + + O código de status HTTP da resposta. +
+ + + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: httpGetTest + description: 'Performs an HTTP GET request to retrieve data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + steps: + - name: query + type: action + action: http.get + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + next: end + ``` + + **Exemplos de entradas:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}" + } + ``` + + **Exemplos de saída:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + + + Executa uma chamada HTTP POST para enviar dados para um endpointda API. + + + Isso permite o uso de sintaxe secreta para qualquer valor de cabeçalho. + + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Descrição +
+ **url** + + Obrigatório + + Corda + + A URL de destino da solicitação. O esquema deve ser incluído: + + `https://example.com` +
+ **parâmetros da URL** + + Opcional + + Mapa + + O parâmetro de consulta deve ser adicionado à URL. Recebe um objeto JSON em formato de string. +
+ **cabeçalhos** + + Opcional + + Mapa + + Os cabeçalhos a serem adicionados à solicitação. Recebe um objeto JSON em formato de string. +
+ **corpo** + + Opcional + + Corda + + O corpo da requisição. +
+ **seletores** + + Opcional + + Lista + + Os seletores permitem obter apenas o parâmetro especificado como saída. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Descrição +
+ **respostaCorpo** + + Corda + + O corpo da resposta. +
+ **código de status** + + Inteiro + + O código de status HTTP da resposta. +
+ + + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: httpPostTest + description: 'Performs an HTTP POST request to send data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + steps: + - name: query + type: action + action: http.post + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + next: end + ``` + + **Exemplos de entradas:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}" + } + ``` + + **Exemplos de saída:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + Executa uma solicitação HTTP PUT para atualizar dados em um endpointda API. + + + Se você precisar passar dados sensíveis para uma entrada, por exemplo um cabeçalho `Api-Key`, você pode usar valores armazenados por meio da mutação [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) do NerdGraph. + + Exemplo: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Descrição +
+ **url** + + Obrigatório + + Corda + + A URL de destino da solicitação. O URL deve incluir o esquema (por exemplo, https:// ou http://). Exemplo: + + `https://example.com` +
+ **parâmetros da URL** + + Opcional + + Mapa + + O parâmetro de consulta deve ser adicionado à URL. Recebe um objeto JSON em formato de string. +
+ **cabeçalhos** + + Opcional + + Mapa + + Os cabeçalhos a serem adicionados à solicitação. Recebe um objeto JSON em formato de string. +
+ **corpo** + + Opcional + + Corda + + O corpo da requisição. +
+ **seletores** + + Opcional + + Lista + + Os seletores permitem obter apenas o parâmetro especificado como saída. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Descrição +
+ **respostaCorpo** + + Corda + + O corpo da resposta. +
+ **código de status** + + Inteiro + + O código de status HTTP da resposta. +
+ + + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: httpPutTest + description: 'Performs an HTTP PUT request to update data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + body: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.put + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + body: ${{ .workflowInputs.body }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **Exemplos de entradas:** + + ```json + { + "url": "https://example.com", + "headers": "{\"Content-Type\":\"application/json\"}", + "urlParams": "{\"foo\": \"bar\"}", + "body": "{\"foo\": \"bar\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **Exemplos de saída:** + + ```json + { + "responseBody": "", + "statusCode": 200 + } + ``` +
+ + + + + + + Executa uma solicitação HTTP DELETE para remover dados em um endpointda API. + + + Se você precisar passar dados sensíveis para uma entrada, por exemplo um cabeçalho `Api-Key`, você pode usar valores armazenados por meio da mutação [secretsManagementCreateSecret](https://one.newrelic.com/nerdgraph-graphiql) do NerdGraph. + + Exemplo: + + ```json + { + "headers": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}" + } + ``` + + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Descrição +
+ **url** + + Obrigatório + + Corda + + A URL de destino da solicitação. O URL deve incluir o esquema (por exemplo, https:// ou http://). Exemplo: + + `https://example.com` +
+ **parâmetros da URL** + + Opcional + + Mapa + + O parâmetro de consulta deve ser adicionado à URL. Recebe um objeto JSON em formato de string. +
+ **cabeçalhos** + + Opcional + + Mapa + + Os cabeçalhos a serem adicionados à solicitação. Recebe um objeto JSON em formato de string. +
+ **seletores** + + Opcional + + Lista + + Os seletores permitem obter apenas o parâmetro especificado como saída. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Descrição +
+ **respostaCorpo** + + Corda + + O corpo da resposta. +
+ **código de status** + + Inteiro + + O código de status HTTP da resposta. +
+ + + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: httpDeleteTest + description: 'Performs an HTTP DELETE request to remove data' + workflowInputs: + url: + type: String + urlParams: + type: String + headers: + type: String + selectors: + type: String + steps: + - name: query + type: action + action: http.delete + version: '1' + inputs: + url: ${{ .workflowInputs.url }} + urlParams: ${{ .workflowInputs.urlParams }} + headers: ${{ .workflowInputs.headers }} + selectors: ${{ .workflowInputs.selectors }} + next: end + ``` + + **Exemplos de entradas:** + + ```json + { + "url": "https://example.com", + "urlParams": "{\"foo\": \"bar\"}", + "headers": "{\"baz\": \"bat\"}", + "selectors": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" + } + ``` + + **Exemplos de saída:** + + ```json + { + "responseBody": "\n...\n", + "statusCode": 200 + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx new file mode 100644 index 00000000000..262939abcd9 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/new-relic.mdx @@ -0,0 +1,1212 @@ +--- +title: Ações da New Relic +tags: + - workflow automation + - workflow + - workflow automation actions + - New relic actions +metaDescription: A list of available actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página fornece uma referência completa das ações do New Relic disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem integrar recursos da plataforma New Relic em suas definições de fluxo de trabalho, incluindo envio de eventos personalizados e logs, execução de consulta NerdGraph, execução de consulta NRQL e envio de notificação. + +## Pré-requisitos + +Antes de usar as ações New Relic na automação do fluxo de trabalho, certifique-se de ter: + +* Uma conta New Relic com as permissões apropriadas. +* Uma chave de licença do New Relic (caso esteja enviando dados para uma conta diferente). +* As permissões necessárias para os serviços específicos do New Relic que você planeja usar. + +Consulte [chave de licença](/docs/apis/intro-apis/new-relic-api-keys/#license-key) para obter informações sobre como criar e gerenciar sua conta New Relic chave de licença. + +## Ações disponíveis em New Relic + +Guia rápido de todas as ações da New Relic por categoria: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Categoria + + Ação + + Propósito +
+ **Ingestão de dados** + + [Enviar evento personalizado](#newrelicingestsendevents) + + Enviar evento personalizado para New Relic. +
+ **Ingestão de dados** + + [Enviar logs](#newrelicingestsendlogs) + + Enviar dados de logs para o New Relic. +
+ **NerdGraph** + + [Executar consulta ou mutação GraphQL](#newrelicnerdgraphexecute) + + Execute comandos GraphQL na API NerdGraph. +
+ **Consulta** + + [Executar consulta NRDB](#newrelicnrdbquery) + + Executar consultoria NRQL entre contas. +
+ **Notificação** + + [Enviar notificação](#newrelicnotificationsend) + + Envie notificação para destinos New Relic. +
+ +## Ações de ingestão de dados + + + + Envia um evento personalizado para New Relic + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Exemplo +
+ **atributo** + + Opcional + + map + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **eventos** + + Obrigatório + + list + + `"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]` +
+ **chave de licença** + + Opcional + + corda + + `"{{ .secrets.secretName }}"` +
+ **seletores** + + Opcional + + list + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: Atributo comum que faz parte de todos os eventos quando fornecido. A fusão de cada item de evento, quando necessário, substitui a definição comum. + * **events**: A lista de dados do evento. Observe que o evento requer o uso de um campo `eventType` que representa o tipo personalizado do evento e o número máximo de eventos permitidos por solicitação é 100. + * **licenseKey**: A chave de licença da conta New Relic que especifica a conta de destino para onde os eventos são enviados. Caso esse valor não seja fornecido, será assumida uma chave de licença padrão com base na conta que executa o fluxo de trabalho. + * **selectors**: Os seletores para obter apenas o parâmetro especificado como saída. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Exemplo +
+ **sucesso** + + Boleano + + `true` +
+ **mensagem de erro** + + corda + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: heartbeat_newrelicIngestSendEvents + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendEvents + version: 1 + inputs: + attributes: + colour: red + id: 1234 + events: + - eventType: HeartBeat + test: "OK" + attributes: + foo: bar + - eventType: HeartBeat1234 + test: "OK1234" + attributes: + foo: bar + - eventType: HeartBeat12345 + test: "OK12345" + attributes: + foo: bar + colour: yellow + - eventType: HeartBeat12345678 + test: "OK12345678" + selectors: + - name: success + expression: ".success" + ``` + + **Resultado esperado:** + + ```yaml + { + "success": true + } + ``` + + **Recuperar evento:** + + Após executar um fluxo de trabalho com sucesso, você pode recuperar o evento associado executando uma consulta na conta que executou o fluxo de trabalho: + + ```sql + SELECT * FROM HeartBeat + ``` +
+ + + + + + + + + Enviar registro para New Relic + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de entrada + + Opcionalidade + + Tipo + + Exemplo +
+ **atributo** + + Opcional + + map + + `"{\"page\": \"1\", \"limit\": \"10\"}"` +
+ **logs** + + Obrigatório + + list + + `"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"` +
+ **chave de licença** + + Opcional + + corda + + `"{{ .secrets.secretName }}"` +
+ **seletores** + + Opcional + + list + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + * **attributes**: Atributo comum incluído em todos os logs quando fornecido. Se um item de log especificar o mesmo atributo, ele substituirá a definição comum. + * **logs**: A lista de dados de logs. Observe que o número máximo de logs permitidos por solicitação é 100. + * **licenseKey**: A chave de licença da conta New Relic que especifica a conta de destino para onde os logs são enviados. Caso não seja fornecida, será assumida uma chave de licença padrão com base na conta que executa o fluxo de trabalho. Consulte [a chave de licença](/docs/apis/intro-apis/new-relic-api-keys/#license-key) para obter mais informações. + * **selectors**: Os seletores para obter apenas o parâmetro especificado como saída. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo de saída + + Tipo + + Exemplo +
+ **sucesso** + + Boleano + + `true` +
+ **mensagem de erro** + + corda + + `"Error message if operation failed"` +
+ + + + + + + + + + + + + + + +
+ Exemplo de fluxo de trabalho +
+ ```yaml + name: heartbeat_newrelicIngestSendLogs + + workflowInputs: + cellName: + type: String + + steps: + - name: runAction + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + attributes: + colour: red + id: 1234 + logs: + - message: 'Heartbeat sendLogs Action Test Message' + attributes: + foo: bar + - message: 'HeartBeat1234' + attributes: + foo: bar + - message: 'HeartBeat12345' + attributes: + foo: bar + colour: yellow + - message: 'HeartBeat12345678' + selectors: + - name: success + expression: ".success" + ``` + + **Resultado esperado:** + + ```yaml + { + "success": true + } + ``` + + **Recuperar logs:** + + Após executar um fluxo de trabalho com sucesso, você pode recuperar o log associado executando uma consulta na conta que executou o fluxo de trabalho: + + ```sql + SELECT * FROM Log + ``` +
+ + + + + + +## Ações do NerdGraph + + + + Executa um comando GraphQL na API NerdGraph do New Relic. O comando pode ser uma consulta ou uma mutação. + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Entrada + + Opcionalidade + + Tipo + + Descrição + + Exemplo +
+ **graphql** + + Obrigatório + + corda + + Uma sintaxe GraphQL. Você deve usar o GraphiQL para construir e testar seu comando. + +
+ **variáveis** + + Obrigatório + + map[string]any + + Quaisquer variáveis de par principal-valor para usar com a instrução GraphQL. + +
+ **seletores** + + Opcional + + list + + Os seletores permitem obter como saída apenas o parâmetro especificado. + + ```yaml + { + "data": { + "actor": { + "user": { + "name": "" + } + } + } + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Saída + + Tipo + + Exemplo +
+ **dados** + + map[string]any: Conteúdo da propriedade + + `data` + + de uma resposta NerdGraph. + + ```yaml + steps: + - name: currentUserId + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + graphql: | + query userId { + currentUser { + id + } + } + - name: sayHello + type: action + action: example.messaging.sayHello + version: 1 + inputs: + name: ${{ .steps.currentUserId.outputs.data.currentUser.id }} + ``` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Exemplo + + Saída + + Recuperar evento +
+ ```json + name: testLog + + steps: + - name: logStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: 'Hello World' + ``` + + ```yaml + { + "success": true + } + ``` + + Você pode recuperar o evento associado executando uma consulta na conta que executou o fluxo de trabalho. + + ```yaml + SELECT message FROM Log WHERE allColumnSearch('Hello World', insensitive: true) SINCE 30 minutes ago + ``` +
+ + + + + + +## Ações de consulta + + + + Executa uma consulta NRQL entre contas através da API do NerdGraph. + + + + + Entradas + + + + Saídas + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Entrada + + Opcionalidade + + Tipo + + Descrição + + Exemplo +
+ **consulta** + + Obrigatório + + corda + + A instrução de consulta NRQL. + +
+ **IDs da conta** + + Opcional + + lista de inteiros + + O campo + + **New Relic Account ID** + + é uma lista de IDs de destino que permite especificar as contas de destino nas quais a consulta será executada. Caso esse valor não seja fornecido como entrada, a consulta será executada automaticamente na conta associada à conta de execução do fluxo de trabalho. + +
+ **seletores** + + Opcional + + list + + Os seletores permitem obter como saída apenas o parâmetro especificado. + + ```json + steps: + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + accountIds: [12345] + query: FROM Log SELECT * WHERE message LIKE 'DEMO%' + selectors: + - name: resultsAsString + expression: '.results | tostring' + ``` +
+ + + + + + + + + + + + + + + + + + + + + +
+ Saída + + Tipo + + Exemplo +
+ **results** + + : Uma matriz de objetos contendo os resultados da consulta. + + + + ```yaml + { + results=[ + { message=[INFO] - Workflow: test has ended, messageId=39af98 }, + { message=[INFO] - Workflow: test - Step query has started, messageId=649c612 }, + ... + ] + } + ``` +
+ + + + + + +## ações de notificação + + + + Envia uma mensagem para um canal, integrado com destinos, por exemplo, o Slack. + + + + + Entradas + + + + Saídas + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Entrada + + Opcionalidade + + Tipo + + Descrição + + Exemplo +
+ **tipo** + + Obrigatório + + corda + + Tipo de destino do New Relic + + `slack` +
+ **id de destino** + + Obrigatório + + Corda + + DestinationId associado ao destino New Relic. + + `123e4567-e89b-12d3-a456-426614174000` +
+ **parâmetro** + + Obrigatório + + map + + Campos obrigatórios para enviar notificação ao tipo de destino escolhido. + + `{\"channel\": \"${{ YOUR_CHANNEL }}\", \"text\": \"Enter your text here\"}` +
+ **seletores** + + Opcional + + list + + Os seletores permitem obter como saída apenas o parâmetro especificado. + + `[{\"name\": \"success\", \"expression\": \".success\"}]` +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Saída + + Tipo + + Exemplo +
+ sucesso + + boleano + + `true/false` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx new file mode 100644 index 00000000000..51e2fcd1c9f --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/actions-catalog/others.mdx @@ -0,0 +1,684 @@ +--- +title: Ações de utilidade +tags: + - workflow automation + - workflow + - workflow automation actions + - utility actions +metaDescription: A list of available utility actions in the actions catalog for workflow definitions +freshnessValidatedDate: never +translationType: machine +--- + +Esta página fornece uma referência para as ações de utilitário disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem que você execute operações comuns de transformação de dados e utilitários em suas definições de fluxo de trabalho. + +## Ações de utilidade disponíveis + +Guia rápido de todas as ações do utilitário: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Ação + + Propósito +
+ [Atualiza a data e hora a partir da época.](#utils.datetime.fromEpoch) + + Converter timestamp /hora Unix para o formato de data/hora. +
+ [Converter para CSV](#utils.transform.toCSV) + + Converter dados para o formato CSV. +
+ [Gerar UUID](#utils.uuid.generate) + + Gere um UUID V4 compatível com a RFC. +
+ +## Ações de utilidade + + + + Esta ação é usada para transformar um timestamp Unix (ou timestamp da época) em data/hora. Possíveis referências: + + * [https://en.wikipedia.org/wiki/List\_of\_tz\_database\_time\_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) + * [https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT\_IDS](https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT_IDS) + + Consulte [a Epoch](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html) para obter mais informações. + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Entrada + + Opcionalidade + + Tipo + + Descrição +
+ **Timestamp** + + Obrigatório + + int + + Um número inteiro que representa o timestamp da época. Note que as épocas UNIX são o número de segundos após 1º de janeiro de 1970, meia-noite UTC (00:00). +
+ **timestampUnit** + + Opcional + + corda + + Uma string representando a unidade do timestamp fornecido. Valores aceitáveis: SEGUNDOS, MILISSEGUNDOS (PADRÃO) +
+ **ID do fuso horário** + + Opcional + + corda + + Uma string que representa o fuso horário para a data/hora desejada, padrão: UTC +
+ **padrão** + + Opcional + + corda + + Uma string que representa o padrão para a data e hora desejadas, padrão: ISO-8601 +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo + + Opcionalidade + + Tipo de dados + + Descrição +
+ **data** + + Obrigatório + + corda + + Uma representação em formato de string de uma data. +
+ **tempo** + + Obrigatório + + corda + + Uma representação em forma de string do tempo. +
+ **data e hora** + + Obrigatório + + corda + + Uma representação em formato de string de data e hora. +
+ **fuso horário** + + Obrigatório + + map + + Representação em mapa do ID do fuso horário e sua abreviação. +
+ + + + + + + + + + + + + + + + + + + + + + + +
+ Exemplo + + Entrada de fluxo de trabalho + + Saídas +
+ ```yaml + name: from_epoch + + workflowInputs: + timestamp: + type: Int + timestampUnit: + type: String + timezoneId: + type: String + pattern: + type: String + + steps: + - name: epochTime + type: action + action: utils.datetime.fromEpoch + version: 1 + inputs: + timestamp: ${{ .workflowInputs.timestamp }} + timezoneId: ${{ .workflowInputs.timezoneId }} + pattern: ${{ .workflowInputs.pattern }} + timestampUnit: ${{ .workflowInputs.timestampUnit }} + ``` + + ```json + mutation { + workflowAutomationStartWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { name: "from_epoch" } + workflowInputs: [ + {key: "timestamp", value: "1738236424003"} + {key: "timestampUnit", value: "MILLISECONDS"} + {key: "pattern", value: "yyyy-mm-dd HH:SS"} + {key: "timezoneId", value: "Asia/Kolkata"} + ] + ) { + runId + } + } + ``` + + ```json + { + "date": "2025-01-30", + "time": "16:57:04.003" + "datetime": "2025-01-30 16:00", + "timezone": { + "abbreviation": "IST", + "id": "Asia/Kolkata" + } + } + ``` +
+ + + + + + + + + Esta ação é usada para transformar vários tipos de entrada (JSON, mapa) em um formato CSV. + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Entrada + + Opcionalidade + + Tipo + + Descrição +
+ **dados** + + Obrigatório + + qualquer + + Uma sequência de caracteres que representa dados a serem transformados em CSV, normalmente uma string JSON ou um mapa. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Campo + + Opcionalidade + + Tipo de dados + + Descrição +
+ **arquivo CSV** + + Obrigatório + + corda + + Representação em formato CSV dos dados recebidos. +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Exemplo + + Entrada de fluxo de trabalho + + Saídas +
+ ```json + name: nrqltocsv + + steps: + - name: queryForLog + type: action + action: newrelic.nrql.query + version: 1 + inputs: + accountIds: ['${{ .workflowInputs.accountId }}'] + query: ${{ .workflowInputs.nrql }} + + - name: csv1 + type: action + action: utils.transform.toCSV + version: 1 + inputs: + data: ${{ .steps.queryForLog.outputs.results | tostring }} + ``` + + ```json + mutation { + startWorkflowRun( + scope: { type: ACCOUNT id: "12345678" } + definition: { + name: "nrqltocsv", + } + workflowInputs: [ + {key: "accountId" value: "12345678"} + {key: "nrql" value: "FROM TransactionError SELECT error.message, error.class, transactionName, request.uri, query WHERE appName like 'my-app-1%' AND error.expected IS FALSE SINCE 1 hour ago LIMIT 50"} + ] + ) + { runId } + } + ``` + +
+ + + + + + + + + Gere um UUID V4 compatível com a RFC. + + + + + Entradas + + + + Saídas + + + + Exemplo + + + + + + + + + + + + + + + + + + + + + + +
+ Entrada + + Opcionalidade + + Tipo de dados + + Descrição +
+ + + + +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Campo + + Tipo de dados + + Descrição +
+ **uuid** + + corda + +
+ + + + + + + + + + + + + + + + + + + + + +
+ Exemplo + + Entrada de fluxo de trabalho + + Saídas +
+ + + nome: gerarUUID
passos: + + * nome: gerarUUID tipo: ação ação: utils.uuid.generate versão: 1 + 		+ ```json + { + "uuid": "c76bd606-5eaa-42bb-a847-4221fb49f83c", + } + ``` +
+ + + + + \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/create-destinations.mdx b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/create-destinations.mdx new file mode 100644 index 00000000000..ed7bacb7e47 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/create-destinations.mdx @@ -0,0 +1,91 @@ +--- +title: Enviar notificação do fluxo de trabalho +tags: + - workflow automation + - workflow + - notifications + - slack + - pagerduty +metaDescription: 'Configure workflows to send notifications via Slack, PagerDuty, email, or webhooks when automation tasks complete or fail.' +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +O fluxo de trabalho pode enviar notificações para sua equipe via Slack, PagerDuty, e-mail ou webhooks personalizados. Use a notificação para alertar as equipes quando o fluxo de trabalho for concluído, falhar ou exigir aprovação. + +## Escolha seu canal de notificação + +Selecione o canal adequado para o seu caso de uso: + +| **Canal** | **Melhor para** | **Complexidade de configuração** | **Recurso** | +| ------------- | --------------------------------- | -------------------------------- | ------------------------------------------------------ | +| **Slack** | Colaboração em equipe, aprovações | Fácil - requer token de bot | Mensagens ricas, reações, tópicos | +| **PagerDuty** | Gestão de incidentes, plantão | Fácil - requer chave de API | Políticas de escalonamento, rastreamento de incidentes | +| **E-mail** | Notificação formal, relatórios | Fácil - Configuração SMTP | Anexos, formatação HTML | +| **Webhooks** | Integração personalizada | Médio - requer endpoint | Carga flexível, qualquer sistema | + +## Antes de você começar + +Antes de configurar a notificação, certifique-se de ter: + +* Um fluxo de trabalho criado em sua conta (a partir de [um modelo](/docs/workflow-automation/create-a-workflow-automation/use-a-template) ou [personalizado](/docs/workflow-automation/create-a-workflow-automation/create-your-own)). +* Credenciais para seu canal de notificação (Slack bot token, PagerDuty chave de API, etc.). +* Credenciais armazenadas no [gerenciador de segredos](/docs/infrastructure/host-integrations/installation/secrets-management/). + +## Configure um destino [#set-the-destination] + +1. Navegue até **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Destinations** e selecione **Workflow Automation**. + +2. Para configurar o fluxo de trabalho Automation, insira as informações necessárias, como o **nome de destino do fluxo de trabalho Automation** (um nome exclusivo para o fluxo de trabalho Automation) e a **API Key**. + +3. Clique em **Save destination**. + + Image of the Workflow Automation destination page. + +## Crie um fluxo de trabalho de notificação [#create-the-notification-workflow] + +1. Acesse **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Notification Workflows** e selecione **+ Add a workflow**. + +2. Para configurar seu fluxo de trabalho de notificações, na página Configure seu fluxo de trabalho de notificações, forneça as informações necessárias: + + * Digite um nome único que você reconheça. + * Selecione a **Tag**, **Policy** e o atributo **Priority** em seus respectivos menus suspensos na opção de filtro **Basic** para receber notificações sobre um incidente ou opte pela opção de filtro **Advanced** para escolher **Attributes**, **Operators** e **Values** para obter notificações de incidentes mais detalhadas. + * Clique em **Additional settings** para enriquecer seus dados criando [uma consultaNRQL ](/docs/alerts/get-notified/incident-workflows/#enrichments)e reunindo dados relevantes de toda a sua plataforma New Relic. Para exemplos de enriquecimento, consulte [Enriquecimento de dados do fluxo de trabalho](/docs/alerts/get-notified/custom-variables-incident-workflows/#enrichment-examples). + +3. Para especificar os destinos das notificações, na seção **Notify**, escolha um ou mais [**destinos**](/docs/alerts/get-notified/destinations). + +4. Eis um exemplo: para enviar uma notificação para um grupo [do Slack](/docs/alerts/get-notified/notification-integrations/#slack), selecione **Slack** como o tipo de destino. + + 1. Selecione **Slack destination** na lista suspensa. + 2. Selecione o **Channel** na lista suspensa e marque a caixa de seleção **Receive notification updates on the channel**. + 3. Opcionalmente, adicione uma mensagem personalizada na seção **Custom Details**. + + + Recomendamos o envio de uma notificação de teste usando a opção **Send test notification**. + + + 4. Selecione **Save message**. + +5. Para testar a automação do fluxo de trabalho, selecione **Test workflow**. Este procedimento utiliza dados existentes da sua conta para verificar a configuração e envia uma notificação de exemplo para garantir que ela chegue ao grupo do Slack. + +6. Selecione **Activate workflow**. + + Image of how to configure a workflow + +## Qual é o próximo? + +Você configurou seus destinos de notificação. Explore agora todas as ações disponíveis para construir um fluxo de trabalho poderoso. + +**Próximo passo na sua jornada**: [Catálogo de ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) - Navegue por todas as ações disponíveis para AWS, New Relic e integração. + +**Pronto para construir?** + +* [Use um modelo de fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/use-a-template) - Comece com um fluxo de trabalho pré-construído +* [Crie seu próprio fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/create-your-own) - Construa do zero +* [Gerenciando fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow) - Conheça o dashboardfluxo de trabalho \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx new file mode 100644 index 00000000000..b9e604a4430 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials.mdx @@ -0,0 +1,465 @@ +--- +title: Configure as credenciais da AWS. +metaDescription: 'Configure AWS credentials for workflow automation using IAM roles, IAM users, or temporary session tokens.' +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Autorize a automação de fluxo de trabalho do New Relic a executar ações em sua conta da AWS. Você configurará um método de autenticação que permitirá que o fluxo de trabalho interaja com segurança com serviços da AWS como EC2, SQS, DynamoDB e outros, sem precisar codificar credenciais ou comprometer a segurança. + +## Pré-requisitos + +Antes de configurar as credenciais da AWS, certifique-se de ter: + +* Uma conta AWS com permissão para criar funções ou usuários do IAM. +* Seu [ID de conta New Relic](/docs/accounts/accounts-billing/account-structure/account-id). +* Acesso administrativo ao [Console do AWS IAM](https://console.aws.amazon.com/iam/). + +## Compreenda as permissões necessárias [#required-permissions] + +Antes de criar credenciais, entenda quais permissões seu fluxo de trabalho precisa. Conceda apenas as permissões que seu fluxo de trabalho realmente utiliza — isso segue o princípio do menor privilégio e minimiza o risco de segurança. + +### Permissões comuns de fluxo de trabalho + +| **Tipo de fluxo de trabalho** | **Permissões AWS necessárias** | **Descrição** | +| ----------------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | +| **Gestão do EC2** | `ec2:DescribeInstances`
`ec2:StopInstances`
`ec2:StartInstances`
`ec2:ModifyInstanceAttribute` | Pare, inicie ou modifique instâncias do EC2 em resposta a alertas | +| **Mensagens SQS** | `sqs:SendMessage`
`sqs:GetQueueAttributes` | Enviar mensagens para filas SQS para processamento posterior. | +| **Gateway de API** | `apigateway:GET`
`apigateway:PUT` | Reverter implantação ou configuração API Gateway | +| **Gerente de Sistemas** | `ssm:CreateDocument`
`ssm:DeleteDocument`
`ssm:StartAutomationExecution`
`ssm:GetAutomationExecution` | Executar manuais de automação | +| **DynamoDB** | `dynamodb:Query`
`dynamodb:GetItem`
`dynamodb:PutItem` | Ler ou escrever em tabelas do DynamoDB | + + + Comece com permissões somente de leitura (`Describe*`, `Get*`, `List*`), depois adicione permissões de gravação (`Put*`, `Create*`, `Delete*`) somente conforme necessário. Isso evita ações destrutivas acidentais durante os testes. + + +Consulte [os exemplos de políticas](#policy-examples) abaixo para obter modelos completos de políticas IAM. + +## Configurar autenticação + +Escolha o método que melhor se adequa ao seu caso de uso na tabela acima: + + + + Função IAM (recomendada) Usuário IAM com chaves de acesso Token de sessão + + + + + Uma função do IAM permite que o New Relic assuma credenciais temporárias em sua conta da AWS sem exigir chaves de acesso permanentes. + + **Características da função IAM:** + + * As credenciais são rotacionadas automaticamente. + * O acesso é limitado no tempo, conforme projetado. + * Todas as ações são registradas no AWS CloudTrail. + * Alinha-se com as práticas de segurança recomendadas AWS + + ### Crie a função na AWS. + + 1. Faça login no [Console do AWS IAM.](https://console.aws.amazon.com/iam/) + 2. Acesse **Roles > Create role > Trusted entity type** e selecione **AWS account > another AWS account** + 3. No campo **Account ID**, insira: `253490767857` + 4. Em **Options**, marque a **Require external ID**. + 5. No campo **External ID**, insira o ID da sua conta New Relic e clique em **Next**. + + * Não tem? [Encontre seu ID de conta aqui.](/docs/accounts/accounts-billing/account-structure/account-id) + + 6. Na página **Add permissions**, anexe políticas com base no seu fluxo de trabalho: + + * Para fluxo de trabalho EC2: anexe `AmazonEC2ReadOnlyAccess` ou crie uma política personalizada + * Para fluxo de trabalho SQS: Anexe `AmazonSQSFullAccess` ou limite a filas específicas + * Para outros serviços: consulte [as permissões da AWS necessárias](#required-aws-permissions) abaixo. + + 7. Clique em **Next**. + 8. Digite um nome para a função: `NewRelicWorkflowAutomationRole` (ou o nome de sua preferência) + 9. Opcionalmente, adicione uma descrição: "Permite que a automação do fluxo de trabalho do New Relic execute ações na AWS" e clique em **Create role**. + + ### Verifique a política de confiança. + + Após criar a função, verifique a relação de confiança: + + 1. No console do IAM, selecione a função recém-criada. + 2. Clique na aba **Trust relationships**. + 3. Confirme se a política corresponde a esta estrutura (substitua `` pelo seu ID de conta real): + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sts:AssumeRole", + "Principal": { + "AWS": "arn:aws:iam::253490767857:root" + }, + "Condition": { + "StringEquals": { + "sts:ExternalId": "" + } + } + } + ] + } + ``` + + ### Copie o ARN da sua função. + + Você precisará do role ARN para configurar o fluxo de trabalho: + + 1. No console do IAM, selecione sua função. + 2. Na seção **Summary**, localize o campo **ARN.** + 3. Copie o ARN completo — ele tem a seguinte aparência: `arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole` + 4. Salve este ARN com segurança – você irá colá-lo diretamente na configuração do fluxo de trabalho + + + **Importante:** os ARNs de função devem ser inseridos diretamente nas entradas do fluxo de trabalho — não os armazene no gerenciador de segredos. Não são credenciais confidenciais; são identificadores de recursos. + + + A função já está configurada. Use o ARN na configuração do fluxo de trabalho que requer acesso AWS. + + + + Utilize este método para ambientes de teste ou quando as funções do IAM não forem suportadas. As chaves de acesso são credenciais de longa duração que exigem rotação manual. + + **Casos de uso:** + + * Ambientes de teste e desenvolvimento + * Configurações AWS que não suportam a assunção de funções entre contas. + * Fluxo de trabalho de autenticação simplificado + + + As chaves de acesso são credenciais de longa duração. Faça o rodízio regularmente (a cada 90 dias) e limite as permissões apenas ao que seu fluxo de trabalho necessita. + + + ### Criar o usuário do IAM + + 1. Faça login no [Console do AWS IAM.](https://console.aws.amazon.com/iam/) + 2. Acesse **Users > Create user** e insira um nome de usuário: `workflow-automation-user` (ou o nome de sua preferência) + 3. Clique em **Next** + 4. Na página **Set permissions**, selecione **Attach policies directly**. + 5. Pesquise e selecione políticas com base no seu fluxo de trabalho: + + * Para SQS: Selecione `AmazonSQSFullAccess` + * Para EC2: Selecione `AmazonEC2ReadOnlyAccess` + * Ou crie uma política personalizada com permissões limitadas (recomendado). + + 6. Clique em **Next** e, em seguida, em **Create user**. + + ### Gerar chaves de acesso + + 1. Na lista de usuários, selecione o usuário que você acabou de criar. + 2. Clique na guia **Security credentials** + 3. Na seção **Access keys**, selecione **Create access key**. + 4. Selecione **Application running outside AWS** e clique em **Next**. + 5. (Opcional) Adicione uma tag de descrição: "Automação de fluxo de trabalho do New Relic" + 6. Selecione **Create access key** + 7. Copie ambas as credenciais imediatamente: + + * **ID da chave de acesso** (começa com `AKIA...`) + * **Chave de acesso secreta** (mostrada apenas uma vez) + + + A AWS exibe a chave de acesso secreta apenas uma vez durante a criação. Se você não salvar, precisará gerar um novo par de chaves. + + + ### Armazene suas credenciais com segurança. + + Nunca codifique credenciais AWS no fluxo de trabalho. Em vez disso, armazene-os no [gerenciador de segredos](/docs/infrastructure/host-integrations/installation/secrets-management/) do New Relic. + + 1. Abra o [explorador GraphiQL do NerdGraph](https://one.newrelic.com/nerdgraph-graphiql) + 2. Execute esta mutação para armazenar seu ID de chave de acesso (substitua os valores de espaço reservado): + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsAccessKeyId" + description: "AWS Access Key ID for workflow automation" + value: "YOUR_AWS_ACCESS_KEY_ID" + ) { + key + } + } + ``` + + 3. Execute outra mutação para sua Chave de Acesso Secreta: + + ```graphql + mutation { + secretsManagementCreateSecret( + scope: {type: ACCOUNT id: "YOUR_NR_ACCOUNT_ID"} + namespace: "aws" + key: "awsSecretAccessKey" + description: "AWS Secret Access Key for workflow automation" + value: "YOUR_AWS_SECRET_ACCESS_KEY" + ) { + key + } + } + ``` + + **Faça referência a esses segredos no fluxo de trabalho** usando a sintaxe: `${{ :secrets:awsAccessKeyId }}` + + + Use o campo `namespace` para organizar segredos por ambiente (`aws-prod`, `aws-staging`) ou nome da equipe. + + + + + O token de sessão fornece credenciais temporárias com expiração automática. + + **Casos de uso:** + + * Desenvolvimento e testes locais + * pipeline de CI/CD que requer rotação de credenciais + * Ambientes com requisitos de conformidade para acesso com tempo limitado (normalmente de 1 a 12 horas) + + **Pré-requisitos:** + + * [AWS CLI instalada e configurada](https://aws.amazon.com/cli/) + * Uma função IAM existente que você pode assumir. + + ### Gerar credenciais temporárias + + 1. Abra o terminal e execute este comando (substitua \`\` pelo ARN da sua função): + + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` + + Se esta for a sua primeira vez usando a AWS CLI, talvez seja necessário configurá-la com `aws configure` e inserir suas credenciais de acesso: + + Image of the Static Access credentials + + 2. A AWS retorna três valores — você precisa dos três: + + ```json + { + "Credentials": { + "AccessKeyId": "ASIAIOSFODNN7EXAMPLE", + "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", + "SessionToken": "FQoGZXIvYXdzEBk...", + "Expiration": "2025-01-25T12:00:00Z" + } + } + ``` + + 3. Armazene todas as três credenciais no gerenciador de segredos: + + * `AccessKeyId` armazenar como `awsAccessKeyId` + * `SecretAccessKey` armazenar como `awsSecretAccessKey` + * `SessionToken` armazenar como `awsSessionToken` + + + O token de sessão expira (normalmente após 1 hora). Defina um lembrete para atualizá-los antes do timestamp `Expiration`, ou seu fluxo de trabalho falhará com erros de autenticação. + + + + + +## Use credenciais no fluxo de trabalho [#use-credentials] + +Após configurar a autenticação, referencie suas credenciais na configuração do fluxo de trabalho: + +### Função IAM (recomendada) + +Cole o ARN da função diretamente nas entradas do fluxo de trabalho — sem necessidade de gerenciador de segredos: + +```yaml +awsRoleArn: arn:aws:iam::123456789012:role/NewRelicWorkflowAutomationRole +``` + + + Os ARNs de função são identificadores de recursos, não credenciais confidenciais. Não os armazene no gerenciador de segredos – cole-os diretamente na configuração do fluxo de trabalho. + + +### Token de usuário ou sessão IAM + +Gerenciador de segredos de referência para chaves de acesso: + +```yaml +awsAccessKeyId: ${{ :secrets:awsAccessKeyId }} +awsSecretAccessKey: ${{ :secrets:awsSecretAccessKey }} +awsSessionToken: ${{ :secrets:awsSessionToken }} # Only for session tokens +``` + +O New Relic recupera segredos em tempo de execução, autentica-se com a AWS e, em seguida, os descarta. Suas credenciais nunca aparecem nos logs ou no histórico do fluxo de trabalho. + +## Exemplos de políticas [#policy-examples] + +Utilize esses modelos completos de política IAM para tipos de fluxo de trabalho comuns. Cada um segue o princípio do menor privilégio, restringindo o acesso a recursos específicos. + + + + Restringir o acesso a uma fila específica: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "sqs:SendMessage", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + }, + { + "Effect": "Allow", + "Action": "sqs:GetQueueAttributes", + "Resource": "arn:aws:sqs:us-west-2:123456789012:my-workflow-queue" + } + ] + } + ``` + + Substitua `us-west-2` pela sua região, `123456789012` pelo seu ID de conta AWS e `my-workflow-queue` pelo nome da sua fila. + + + + Restringir o acesso a categorias específicas por meio de tag: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ec2:DescribeInstances", + "ec2:DescribeTags" + ], + "Resource": "*" + }, + { + "Effect": "Allow", + "Action": [ + "ec2:StopInstances", + "ec2:StartInstances", + "ec2:ModifyInstanceAttribute" + ], + "Resource": "arn:aws:ec2:us-east-1:123456789012:instance/*", + "Condition": { + "StringEquals": { + "aws:ResourceTag/Environment": "production" + } + } + } + ] + } + ``` + + Esta política permite que o fluxo de trabalho pare/inicie/modifique apenas instâncias da tag EC2 com `Environment=production`. + + + + Restringir o acesso a uma tabela específica: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "dynamodb:Query", + "dynamodb:GetItem", + "dynamodb:PutItem" + ], + "Resource": "arn:aws:dynamodb:us-east-1:123456789012:table/WorkflowData" + } + ] + } + ``` + + Substitua `WorkflowData` pelo nome da sua tabela. + + + + Restringir o acesso a documentos de automação específicos: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument" + ], + "Resource": "arn:aws:ssm:us-east-1:123456789012:document/WorkflowAutomation-*" + }, + { + "Effect": "Allow", + "Action": [ + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": [ + "arn:aws:ssm:us-east-1:123456789012:automation-definition/WorkflowAutomation-*:*", + "arn:aws:ssm:us-east-1:123456789012:automation-execution/*" + ] + } + ] + } + ``` + + Isso restringe os documentos de automação àqueles prefixados com `WorkflowAutomation-`. + + + + Restringir o acesso a uma API específica: + + ```json + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "apigateway:GET", + "apigateway:PUT" + ], + "Resource": "arn:aws:apigateway:us-west-2::/restapis/abc123xyz/*" + } + ] + } + ``` + + Substitua `abc123xyz` pelo seu ID do API Gateway. + + + +### Recursos adicionais + +Para obter informações completas sobre permissões da AWS: + +* **[Políticas gerenciadas de integração comAWS ](/docs/infrastructure/amazon-integrations/get-started/integrations-managed-policies/)**: Lista completa de permissões AWS por serviço, além de modelos do CloudFormation que você pode adaptar. +* **[Configurar AWS API polling](/docs/infrastructure/amazon-integrations/connect/set-up-aws-api-polling/)**: Padrões de configuração adicionais + + + Esses recursos usam o ID da conta `754728514883` para integração na nuvem (monitoramento). Para automação de fluxo de trabalho, use sempre `253490767857`. + + +## Próximos passos + +Após configurar as credenciais AWS, você pode criar o fluxo de trabalho: + +**Criar fluxo de trabalho:** + +1. **[Navegue pelas ações da AWS](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)**: Veja as operações da AWS disponíveis (EC2, SQS, DynamoDB, etc.) +2. **[Use um modelo](/docs/workflow-automation/create-a-workflow-automation/use-a-template)**: implantar fluxo de trabalho pré-configurado para tarefas comuns de automação AWS +3. **[Crie um fluxo de trabalho personalizado](/docs/workflow-automation/create-a-workflow-automation/create-your-own)**: Crie um fluxo de trabalho para seus requisitos específicos + +**Configurar notificação:** + +* **[Configurar destinos](/docs/workflow-automation/setup-and-configuration/create-destinations)**: configurar Slack, PagerDuty, e-mail ou notificação de webhook para evento de fluxo de trabalho \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/troubleshooting.mdx b/src/i18n/content/pt/docs/workflow-automation/troubleshooting.mdx new file mode 100644 index 00000000000..d45b6f4bc14 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/troubleshooting.mdx @@ -0,0 +1,386 @@ +--- +title: Solução de problemas de automação de fluxo de trabalho +tags: + - workflow automation + - troubleshooting + - workflow errors +metaDescription: 'Common issues and solutions for Workflow Automation including AWS credentials, workflow execution, and dashboard problems.' +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +Esta página fornece soluções para problemas comuns que você pode encontrar ao usar o fluxo de trabalho Automation. Para obter suporte adicional, consulte o [Fórum de Suporte da New Relic](https://discuss.newrelic.com/) ou entre em contato com [o Suporte da New Relic](https://support.newrelic.com/). + +## Credenciais e autenticação da AWS + + + + **Problema:** Seu fluxo de trabalho falha com um erro de autorização da AWS. + + **Soluções:** + + 1. **Verifique o ID da sua conta:** Verifique se você usou `253490767857` (e não `754728514883`) na política de confiança. O ID da conta de integração na nuvem (`754728514883`) é diferente do ID da conta de automação de fluxo de trabalho. + 2. **Verificar ID externo:** Confirme se o ID externo em sua política de confiança corresponde exatamente ao ID da sua conta New Relic (encontrado em [Configurações da conta](/docs/accounts/accounts-billing/account-structure/account-id)). + 3. **Revisar permissões:** Certifique-se de que sua função ou usuário do IAM tenha as permissões específicas da AWS que seu fluxo de trabalho exige. Verifique a tabela de [permissões AWS necessárias](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials#required-aws-permissions). + 4. **Teste com a AWS CLI:** Execute `aws sts assume-role` localmente para verificar se a função pode ser assumida: + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/NewRelicWorkflowAutomationRole" \ + --role-session-name "TestSession" \ + --external-id "YOUR_NR_ACCOUNT_ID" + ``` + + + +### tokeninválido ou credenciais expiradas + +**Problema:** fluxo de trabalho falha com erros de expiração token. + +**Soluções:** + +1. **Para o token de sessão:** verifique o timestampde expiração — os tokens de sessão geralmente duram de 1 a 12 horas. Gere novas antes que expirem usando: + ```bash + aws sts assume-role \ + --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \ + --role-session-name "WorkflowAutomationSession" + ``` +2. **Para chaves de acesso:** Verifique se o ID da chave de acesso e a chave de acesso secreta estão armazenados corretamente no gerenciador de segredos. Verifique novamente os valores no [explorador GraphiQL do NerdGraph](https://one.newrelic.com/nerdgraph-graphiql). +3. **Verifique a sintaxe dos segredos:** Certifique-se de estar usando o formato `${{ :secrets:keyName }}`, e não `${{ secrets.keyName }}`. O prefixo de dois pontos (`:secrets:`) é obrigatório. + +### Não consigo encontrar o ARN da minha função. + +**Problema:** Você precisa do ARN, mas não consegue encontrá-lo na AWS. + +**Solução:** + +1. Faça login no [Console do AWS IAM.](https://console.aws.amazon.com/iam/) +2. Selecione **Roles** na barra de navegação. +3. Procure pelo nome da sua função (ex: `NewRelicWorkflowAutomationRole`) +4. Selecione a função — o ARN aparece na seção Resumo. +5. O formato ARN é: `arn:aws:iam:::role/` + +### fluxo de trabalho não pode acessar recursos específicos AWS + +**Problema:** Sua função possui permissões, mas o fluxo de trabalho ainda não consegue acessar determinados recursos. + +**Soluções:** + +1. **Permissões em nível de recurso:** verifique se sua política do IAM restringe o acesso a ARNs de recursos específicos. Você pode precisar adicionar um curinga (`*`) para testes e, em seguida, restringir a recursos específicos. + ```json + { + "Effect": "Allow", + "Action": "ec2:DescribeInstances", + "Resource": "*" // Change from specific ARN to * for testing + } + ``` +2. **Políticas de controle de serviço (SCPs):** Se você estiver em uma organização da AWS, as SCPs podem bloquear determinadas ações. Entre em contato com o administrador da AWS para revisar as políticas da organização. +3. **Incompatibilidade de região:** verifique se suas permissões do IAM especificam a região correta da AWS onde seus recursos estão localizados. Atualize o parâmetro `awsRegion` do fluxo de trabalho para corresponder à localização do seu recurso. + +## Problemas na execução do fluxo de trabalho + +### Guia rápido de resolução de problemas + +Utilize esta tabela para um diagnóstico rápido de problemas comuns no fluxo de trabalho: + +| **Sintoma** | **Verificar** | **Solução** | +| ------------------------------------------------------------------ | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------- | +| O fluxo de trabalho falha em uma etapa específica. | Ver logs de execução para mensagem de erro | Corrija a configuração, as credenciais ou os dados de entrada para essa ação. | +| O fluxo de trabalho é executado, mas produz resultados incorretos. | Verifique os dados que passam entre as etapas. | Verificar sintaxe do modelo `${{ .steps.name.outputs.field }}` | +| O fluxo de trabalho agendado não está sendo executado. | Verifique o histórico de execuções para identificar execuções ignoradas. | Verificar configuração de agendamento e status do fluxo de trabalho (Ativo) | +| O fluxo de trabalho expira | Verificar duração da execução | Reduza a frequência de polling ou divida em fluxos de trabalho menores | +| As alterações não surtem efeito. | Verificar histórico de versões | Atualize as execuções agendadas para usar a nova versão. | + +Para obter instruções detalhadas sobre como visualizar logs e histórico de execução, consulte [Monitorar execuções de fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/managing-workflow#monitor-runs). + +### O fluxo de trabalho aparece com o status "Falha". + +**Problema:** Um fluxo de trabalho aparece com o status "Falha" no dashboard. + +**Soluções:** + +1. **Verifique o histórico de execução**: + + * Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + * Clique no nome do fluxo de trabalho. + * Veja **Run history** para verificar qual execução falhou. + +2. **Analisar os logs de execução**: + + * Clique em **View logs** na execução com falha para identificar a ação específica que falhou. + * Procure por mensagens de erro que indiquem a causa raiz. + +3. **Causas comuns**: + + * **Credenciais inválidas**: Token expirado, sintaxe de segredos incorreta ou chaves secretas erradas. + * **Permissões ausentes**: Permissões insuficientes do AWS IAM, escopos de token do bot do Slack ou acesso à API. + * **Mudanças nos recursos de destino**: instâncias do EC2 excluídas, canais do Slack removidos ou banco de dados renomeado + * **Limites de taxaAPI excedidos**: Muitas requests para serviços externos (AWS, Slack, etc.) + * **Tempo limite de rede**: APIs externas demorando muito para responder. + +4. **Corrigir e executar novamente**: Após resolver o problema, acione manualmente o fluxo de trabalho usando a [API StartWorkflowRun](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) para verificar se ele funciona. + +### A execução do fluxo de trabalho está demorando muito. + +**Problema:** As execuções do fluxo de trabalho excedem a duração esperada ou o tempo limite. + +**Soluções:** + +1. **Revisar a sequência de ações**: verificar os logs para identificar ações lentas. Procure por ações com tempos de execução superiores a 30 segundos. + +2. **Otimizar consulta**: Se estiver usando consultas NRQL, otimize-as para melhor desempenho: + + * Adicione intervalos de tempo específicos em vez de consultar todos os dados. + * Use `LIMIT` para reduzir o tamanho do conjunto de resultados. + * Filtrar antecipadamente com cláusulas `WHERE` + +3. **Verifique as APIs externas**: Respostas lentas de serviços integrados (AWS, Slack) podem atrasar a execução. Teste API tempo de resposta separadamente. + +4. **Considere os limites do fluxo de trabalho**: revise [os limites do fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits) para restrições de tempo limite (normalmente 15 minutos por fluxo de trabalho). + +5. **Divida o fluxo de trabalho menor**: divida o fluxo de trabalho complexo em automações menores e focadas que podem ser executadas em paralelo. + +### As alterações no fluxo de trabalho não surtem efeito. + +**Problema:** Você editou um fluxo de trabalho, mas as alterações não são aplicadas quando ele é executado. + +**Soluções:** + +1. **Verifique se você salvou**: Confira se você clicou em **Save** após editar a configuração do fluxo de trabalho. + +2. **Verifique a versão**: + + * Acesse os detalhes do fluxo de trabalho. + * Clique na guia **Version history** + * Certifique-se de que suas alterações mais recentes apareçam como uma nova versão. + * Verifique se esta versão está marcada como ativa. + +3. **Atualizar execuções agendadas**: Se o fluxo de trabalho for executado de acordo com um agendamento, atualize o agendamento para usar a nova versão: + + * Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** + * Encontre corridas programadas + * Atualize o cronograma para fazer referência à nova versão do fluxo de trabalho. + +4. **Limpar cache**: O cache Browser pode exibir configurações antigas — atualize a página completamente (Ctrl+Shift+R ou Cmd+Shift+R). + +## problemas dashboard fluxo de trabalho + +### Não consigo encontrar um fluxo de trabalho no dashboard + +**Problema:** Um fluxo de trabalho que você criou não aparece na lista dashboard. + +**Soluções:** + +1. **Verifique os filtros**: + + * Clique no dropdowndo filtro. + * Selecione "Todos" para os filtros de status. + * Limpar a barra de pesquisa + +2. **Verificar conta**: Confirme se você está conectado à conta correta do New Relic onde o fluxo de trabalho foi criado. Verifique o seletor de contas no canto superior direito. + +3. **Verifique as permissões**: Certifique-se de que seu perfil do usuário tenha acesso para visualizar o fluxo de trabalho. Entre em contato com o administrador do New Relic se precisar de permissões de acesso ao fluxo de trabalho. + +4. **Atualize a página**: o cache Browser às vezes pode ocultar alterações recentes. Tente uma atualização completa da página (Ctrl+Shift+R ou Cmd+Shift+R). + +### Não é possível excluir um fluxo de trabalho. + +**Problema:** A opção de excluir está desativada ou a exclusão falha. + +**Soluções:** + +1. **Verifique permissões**: Verifique se seu perfil do usuário possui permissões de exclusão para fluxo de trabalho. Se necessário, entre em contato com o administrador da sua conta. + +2. **Interromper execuções agendadas**: Cancele todas as execuções agendadas ativas antes de excluí-las. + + * Acesse os detalhes do fluxo de trabalho. + * Acesse a aba **Scheduled runs** + * Cancelar todos os agendamentos ativos + +3. **Verifique dependência**: Alguns fluxos de trabalho não podem ser excluídos se outras automações dependerem deles. Verifique se o fluxo de trabalho é referenciado por: + + * Outros fluxos de trabalho que o chamam + * política de alertas que o acionam + * Sistemas externos que o iniciam via API + +4. **Contate o suporte**: Se o problema persistir após tentar as soluções acima, entre em contato com [o Suporte da New Relic](https://support.newrelic.com/) para obter assistência. + +## Questões específicas de integração + +### A notificação do Slack não aparece + +**Problema:** O fluxo de trabalho é concluído com sucesso, mas as mensagens do Slack não aparecem. + +**Soluções:** + +1. **Verifique o ID do canal**: Certifique-se de usar o **ID** do canal do Slack (por exemplo, `C01234ABCD`), e não o nome do canal. Encontre o ID no Slack: + + * Clique com o botão direito do mouse no nome do canal. + * Selecione **View channel details**. + * Copie o ID do canal que está na parte inferior. + +2. **Verifique as permissões do bot**: verifique se o seu bot do Slack possui os seguintes escopos: + + * `chat:write` - Publicar mensagens + * `channels:read` - Ver canais públicos + * `groups:read` - Visualizar canais privados (se aplicável) + +3. **Verifique se o bot está no canal**: Adicione o bot ao canal Destino: + + * Digite `/invite @YourBotName` no canal + * Confirme se o bot aparece na lista de membros. + +4. **Verificar token em segredos**: Verifique se o token do Slack armazenado no gerenciador de segredos está correto e não expirou. + +### As operações do AWS Systems Manager falham. + +**Problema:** Os documentos ou comandos de automação do SSM não são executados. + +**Soluções:** + +1. **Verificar permissões do SSM**: Certifique-se de que a função do IAM tenha estas permissões: + ```json + { + "Effect": "Allow", + "Action": [ + "ssm:CreateDocument", + "ssm:DeleteDocument", + "ssm:StartAutomationExecution", + "ssm:GetAutomationExecution" + ], + "Resource": "*" + } + ``` +2. **Verifique o agente SSM**: verifique se as instâncias de destino do EC2 têm o agente SSM instalado e em execução: + ```bash + aws ssm describe-instance-information --region us-east-1 + ``` +3. **Verifique o perfil da instância**: as instâncias do EC2 precisam de um perfil de instância IAM com permissões SSM para executar comandos. +4. **Verificar se o documento existe**: Se estiver usando um documento SSM existente, verifique se ele existe em sua conta e região da AWS. + +## Problemas específicos do modelo + +### GUID da entidade não encontrado + +**Problema:** Os modelos falham com erros `Entity not found`. + +**Soluções:** + +1. **Encontre o GUID da entidade correta**: + + * Acesse a página de recursos monitorados no New Relic. + * Verifique o URL ou os metadados da entidade para obter o GUID. + * Use [a pesquisa de entidade](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic#find) para localizar entidade + +2. **Verificar se a entidade existe na conta correta**: Confirme se você está usando a entidade da mesma conta onde o fluxo de trabalho está implantado. + +3. **Confirme os dados de reporte da entidade**: verifique se a entidade mostra **Last seen** — entidades desatualizadas podem ter sido removidas. + +4. **Para entidade AWS **: Certifique-se de que [a integração](/docs/infrastructure/amazon-integrations/get-started/introduction-aws-integrations) esteja ativa + + + **Os GUIDs de entidade são específicos da conta.** Mover o fluxo de trabalho entre contas requer a atualização de todos os GUIDs da entidade. + + +### A consulta NRQL não retornou resultados. + +**Problema:** Os modelos que utilizam NRQL consultam o conteúdo, mas retornam conjuntos de dados vazios. + +**Soluções:** + +1. **Teste a consulta primeiro**: Use [o criador de consulta](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) para validar a consulta antes de adicionar aos modelos + +2. **Verificar tipo de dados e nomes de eventos**: + + * Use `FROM Transaction`, não `FROM Transactions` + * Verifique se os nomes dos atributos correspondem exatamente (diferenciando maiúsculas de minúsculas). + +3. **Ajustar intervalos de tempo**: Para dados esparsos, expanda a janela de tempo: + + * Adicione `SINCE 1 hour ago` para dados recentes. + * Use `SINCE 1 day ago` para tendências + +4. **Simplifique e teste incrementalmente**: Comece com uma consulta básica e adicione filtros um de cada vez. + +5. **Verificar [sintaxe NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language)**: Verificar se a estrutura da consulta corresponde aos requisitos NRQL. + +### A implantação do modelo falha + +**Problema:** Template não implanta ou apresenta erros durante a implantação. + +**Soluções:** + +1. **Verifique todas as informações necessárias**: Certifique-se de ter preenchido todos os campos obrigatórios (credenciais, GUIDs, consulta). +2. **Verifique o formato das credenciais**: os segredos devem usar o formato `${{ :secrets:keyName }}` com o prefixo de dois pontos. +3. **Teste as credenciais de forma independente**: Antes da implantação, teste as credenciais AWS com AWS CLI e o token do Slack na APIdo Slack. +4. **Verifique os requisitos do modelo**: Cada modelo lista pré-requisitos específicos — verifique se todos foram atendidos. +5. **Verifique a presença de caracteres especiais**: Alguns campos (nomes de canais, consulta) podem não conter caracteres especiais — utilize caracteres alfanuméricos sempre que possível. + +### Aprovação fluxo de trabalho não responde + +**Problema:** Os modelos que exigem aprovação do Slack (reversão do API Gateway, redimensionamento do EC2) não detectam reações. + +**Soluções:** + +1. **Verificar escopos de token do bot**: + + * `reactions:read` - Necessário para detectar reações com emojis + * `chat:write` - É necessário publicar mensagens de aprovação. + +2. **Verifique o formato da reação**: Use o emoji exato especificado no fluxo de trabalho (normalmente 👍 para aprovar, 👎 para rejeitar). + +3. **Verifique as configurações de tempo limite**: requests de aprovação expiram após o tempo limite configurado (geralmente de 5 a 10 minutos). + +4. **Garantir que o bot possa ler as mensagens**: O bot deve estar no canal e ter permissão para ler o histórico de mensagens. + +5. **Teste com aprovação simples**: Crie um fluxo de trabalho de teste com apenas lógica de aprovação para isolar o problema. + +### problemas de gerenciamento de instâncias do EC2 + +**Problema:** o modelo EC2 não consegue redimensionar ou gerenciar a estrutura. + +**Soluções:** + +1. **Verifique se [CloudWatch Metric Streams](/install/aws-cloudwatch/) estão configurados**: Necessário para métricas EC2 em tempo real. +2. **Verificar se [a integração de monitoramento do EC2](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ec2-monitoring-integration/#activate) está ativa**: Garante que os dados da instância sejam enviados para o New Relic. +3. **Confirme o estado do participante**: o participante deve estar no estado `running` ou `stopped` — estados de transição (pendente, parando) causam falhas. +4. **Verifique a compatibilidade do tipo de instância**: nem todos os tipos de instância suportam todas as operações de redimensionamento - verifique [a documentação do tipo de instânciaAWS](https://aws.amazon.com/ec2/instance-types/) +5. **Verificar permissões de parada/início**: a função IAM precisa de `ec2:StopInstances` e `ec2:StartInstances` além de `ec2:ModifyInstanceAttribute` + +### O modelo de análise JSON não está registrando dados. + +**Problema:** O modelo de análise JSON é executado com sucesso, mas nenhum dado aparece nos logs New Relic. + +**Soluções:** + +1. **Verifique os endpointda API**: Teste a URL da página de status em um navegador — certifique-se de que ela retorne um JSON válido. +2. **Verifique a estrutura JSON**: o modelo espera um formato específico — verifique se os campos de integridade do componente correspondem à estrutura esperada. +3. **Revisar filtros de log**: Garantir que a ação de registro utilize o tipo de evento e o atributo corretos. +4. **Teste com um endpoint simples**: Use um endpoint JSON básico (como `https://httpbin.org/json`) para verificar se a mecânica do modelo funciona. +5. **Verificar permissões da conta**: Verifique se o fluxo de trabalho tem permissão para gravar logs no New Relic. + +### A autenticação da consulta SQL do NRLens falha + +**Problema:** O modelo NRLens falha devido a erros de autenticação ou conexão. + +**Soluções:** + +1. **Verificar credenciais do NRLens**: Confirme se as credenciais do SQL Consulta Gateway estão atualizadas e armazenadas corretamente nos segredos. +2. **Verifique os IDs da organização e da conta**: Certifique-se de que ambos os IDs correspondam exatamente à sua organização do New Relic. +3. **Teste a consulta SQL separadamente**: Use a interface NRLens para testar a consulta antes de adicioná-la ao fluxo de trabalho. +4. **Verifique a sintaxe SQL**: o SQL do NRLens difere do NRQL — consulte [a documentação do NRLens](https://docs.newrelic.com/docs/nrlens-overview) para obter informações sobre a sintaxe suportada. +5. **Verifique a complexidade da consulta**: junções muito complexas ou conjuntos de dados grandes podem atingir o tempo limite — simplifique a consulta ou adicione limites de tempo. + +## Próximos passos + +Se você ainda estiver enfrentando problemas após tentar essas soluções: + +* **[fluxo de trabalho Fórum da comunidade de automação](https://discuss.newrelic.com/)**: tire dúvidas e obtenha ajuda de outros usuários +* **[Suporte da New Relic](https://support.newrelic.com/)**: Entre em contato com o suporte para problemas específicos da sua conta. +* **[fluxo de trabalho práticas recomendadas](/docs/workflow-automation/limitations-and-faq/workflow-best-practices)**: Aprenda padrões para um fluxo de trabalho confiável +* **[Limitações do fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits)**: Compreenda as restrições e quotas do sistema. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx new file mode 100644 index 00000000000..29a82003558 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-schedule.mdx @@ -0,0 +1,33 @@ +--- +title: CriarAgenda +tags: + - workflow automation + - workflow + - CreateSchedule + - workflow automation API +metaDescription: Create a schedule for a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Cria um cronograma para uma definição de fluxo de trabalho. + +O número de horários e a duração mínima para um determinado horário são definidos em [Limites do Sistema de Fluxo de Trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits). + +## Exemplo + +Utilize o [criador de consulta](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) para criar e editar um fluxo de trabalho. Consulte [o explorador de API do NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +mutation { + workflowAutomationCreateSchedule( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "healthyHeartbeat", version: 1} + cronExpression: "0 0 * * *" + timezone: "Asia/Kolkata" + options: {logLevel: DEBUG} + ) { + scheduleId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx new file mode 100644 index 00000000000..2f2bddc7289 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/create-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: CriarDefiniçãoDeFluxoDeTrabalho +tags: + - workflow automation + - workflow + - CreateWorkflowDefinition + - workflow automation API +metaDescription: Create a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API é usada para criar uma definição de fluxo de trabalho. Retorna um erro se a definição do fluxo de trabalho já existir. + +## Exemplo + +Utilize o [criador de consulta](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) para criar e editar um fluxo de trabalho. Consulte [o explorador de API do NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphiql + mutation { + workflowAutomationCreateWorkflowDefinition( + scope: { + id: "11933347" + } + definition: { + yaml: "bmFtZTogbXV0YXRpb25fZXhlY3V0ZQoKc3RlcHM6CiAgLSBuYW1lOiBleGVjMQogICAgdHlwZTogYWN0aW9uCiAgICBhY3Rpb246IG5ld3JlbGljLm5lcmRncmFwaC5leGVjdXRlCiAgICB2ZXJzaW9uOiAnMS4wLjAnCiAgICBpbnB1dHM6CiAgICAgIGdyYXBocWw6IHwKICAgICAgICBtdXRhdGlvbiBLZWVwQWxpdmUoJGd1aWQ6IEVudGl0eUd1aWQhKXsKICAgICAgICAgIGVudGl0eUtlZXBBbGl2ZShndWlkczogWyRndWlkXSkgewogICAgICAgICAgICByZWZyZXNoZWRFbnRpdGllcwogICAgICAgICAgfQogICAgICAgIH0KICAgICAgdmFyaWFibGVzOgogICAgICAgIGd1aWQ6ICJ7eyAud29ya2Zsb3dJbnB1dHMuZW50aXR5R3VpZCB9fSIKCiAgLSBuYW1lOiBsb2cxCiAgICB0eXBlOiBhY3Rpb24KICAgIGFjdGlvbjogbmV3cmVsaWMuaW5zdHJ1bWVudGF0aW9uLmxvZwogICAgdmVyc2lvbjogJzEuMC4wJwogICAgaW5wdXRzOgogICAgICBNZXNzYWdlOiAiZW50aXR5R3VpZCByZWZyZXNoZWQge3sgLnN0ZXBzLmV4ZWMxLm91dHB1dHMuZGF0YS5lbnRpdHlLZWVwQWxpdmUucmVmcmVzaGVkRW50aXRpZXMgfX0iCg==" + } + ) { + definition { + name + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx new file mode 100644 index 00000000000..c79d56a7c0a --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/definition-schema.mdx @@ -0,0 +1,697 @@ +--- +title: Esquema de definição de fluxo de trabalho +tags: + - workflow automation + - workflow schems + - workflow automation API +metaDescription: Workflow definitions are written in YAML. Keys use a camelCase naming convention. +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +## Esquema + +As definições de fluxo de trabalho são escritas em YAML. As chaves usam a convenção de nomenclatura `camelCase`. + +### **nome** (obrigatório) + +* **Tipo**: String +* **Formato**: Deve estar em conformidade com a expressão regular `^[A-Za-z_][A-Za-z0-9_-]*$`. +* **Comprimento máximo**: 100 +* **Descrição**: Os valores `name` não diferenciam maiúsculas de minúsculas. Por exemplo, `ExampleWorkflow`, `exampleworkflow` e `EXAMPLEWORKFLOW` são todos considerados como representando a mesma definição de fluxo de trabalho. + +### **Descrição** (Opcional) + +* **Tipo**: String +* **Formato**: Deve estar em conformidade com a expressão regular `^[A-Za-z0-9 _-]*$`. +* **Comprimento máximo**: 200 +* **Descrição**: Um `description` do fluxo de trabalho que explica seu propósito. + +### **workflowInputs** (Opcional) + +* **Tipo**: Mapa de mapas +* **Tamanho máximo**: 100 +* **Descrição**: Um mapa das entradas de fluxo de trabalho que o fluxo de trabalho aceita. +* **Exemplo**: + +```java + workflowInputs: + myInput1: + type: String + myInput2: + type: Number + defaultValue: 42 +``` + +* **`workflowInputs.`** (Obrigatório) + + * **Tipo**: String (em conformidade com [o padrão de segurança de expressão]()) + * **Comprimento mínimo**: 1 + * **Comprimento máximo**: 50 + * **Descrição**: O nome da entrada do fluxo de trabalho. + +* **`workflowInputs..type`** (Obrigatório) + + * **Tipo**: Enum (Booleano, Lista, Mapa, String, Inteiro, ponto flutuante) + * **Descrição**: O tipo de dados da entrada do fluxo de trabalho. + +* **`workflowInputs..defaultValue`** (Opcional) + + * **Tipo**: Qualquer; deve estar em conformidade com `type`. + * **Descrição**: O valor padrão para a entrada do fluxo de trabalho. + +* **Etapas** (Obrigatórias) + + * **Tipo**: matriz de mapas + * **Descrição**: Os passos a serem executados quando a definição do fluxo de trabalho for acionada. Deve haver pelo menos um passo. + + + Os passos serão executados na ordem em que são definidos na matriz `steps`. + + Se uma ordem diferente for desejada, um "salto" pode ser realizado definindo a propriedade `steps[*].next` com o nome da etapa desejada para a qual se deseja pular. + + + * **`steps[*].name`** (Obrigatório) + + * **Tipo**: String (em conformidade com [o padrão seguro para expressões](); não pode ser `end`) + * **Comprimento máximo**: 100 + * **Descrição**: O nome da etapa a ser referenciada por `steps[*].next`. Não podem ser as palavras-chave especiais `end`, `continue` ou `break`, pois estas são usadas para indicar uma etapa de término, uma continuação de um loop ou para sair de um loop. + + * **`steps[*].type`** (Obrigatório) + + * **Tipo**: String + * **Descrição**: O tipo da etapa, indicando o que a etapa faz quando executada. Consulte a [seção Tipos de Etapas]() para ver as opções disponíveis. + + * [**`steps[*].next`**](#steps-next) (Opcional) + + * **Tipo**: String (em conformidade com [o padrão de segurança de expressão]()) + + * **Descrição**: + + * O nome da próxima etapa a ser executada quando esta etapa for concluída com sucesso. A palavra-chave especial `end` pode ser usada para indicar que esta etapa deve ser a última a ser executada. + * Se `next` for omitido, a entrada seguinte na matriz `steps` da definição será usada como o próximo passo implícito. Caso não haja nenhuma entrada subsequente, o fluxo de trabalho será concluído. + +## Tipos de etapas + +### **Ação** + +Uma etapa que executa uma ação específica. Consulte o [Catálogo de Ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog) para ver as opções disponíveis. + +* **`steps[*].action`** (Obrigatório) + + * **Tipo**: String + + * **Descrição**: O nome completo da função de ação a ser executada. Deve seguir a seguinte convenção: + + `..` + + * **Exemplo**: + + * Ação utilizando os serviços do New Relic (por exemplo, através do NerdGraph): `newrelic.dashboards.getDashboard` + * Ação usando o Slack: `slack.chat.postMessage` + +* **`steps[*].version`** (Obrigatório) + + * **Tipo**: String + * **Descrição**: A versão da função de ação a ser executada. + +* **`steps[*].inputs`** (Opcional) + + * **Tipo**: Mapa de valores (inclui [expressões]()) + + * **Descrição**: + + * Os parâmetros a serem passados para a função de ação. As entradas específicas aceitas são definidas por cada ação. + * As entradas podem usar expressões. Consulte a seção [Cadeias de Expressões]() para obter detalhes. + + + Não devem ser passados dados sensíveis (nenhuma chave de API ou segredos, nenhum dado PII, PHI ou qualquer dado de identificação pessoal) como argumentos. + + +* **`steps[*].inputs.selectors`** (Opcional) + + * **Tipo**: lista de mapas no formato `name` com `expression`. + + * **Descrição**: + + * A entrada `selectors` permite redefinir a saída para retornar apenas os elementos especificados. + * A expressão pode ser usada. Consulte a seção [Cadeias de Expressões]() para obter detalhes. + + * **Exemplo** + + * No exemplo dado, estamos recebendo `pageUrl` e `statusDescription` como resposta da ação http.get. + + ```yaml + name: status + description: A workflow for checking the status of New Relic components + + steps: + - name: query1 + type: action + action: http.get + version: 1 + inputs: + url: "https://status.newrelic.com/api/v2/status.json" + selectors: + - name: statusCode + expression: '.statusCode' + - name: pageUrl + expression: '.responseBody | fromjson | .page.url' + - name: statusDescription + expression: '.responseBody | fromjson | .status.description' + + - name: logOutput1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "status is '${{ .steps.query1.outputs.statusDescription }}' details at ${{ .steps.query1.outputs.pageUrl }}" + ``` + +### **laço** + +Um laço irá iterar sobre uma coleção dada definida por `in` e criar variáveis de laço `index` e `element` para cada uma de suas iterações. Essas variáveis de loop são acessíveis dentro do loop apenas com a expressão `${{ .steps..loop.element }}` ou `${{ .steps..loop.index }` + +Para mais detalhes, veja abaixo: + + + + Você pode usar o loop para iterar por uma lista, mapa ou coleção. + + * `for` (Obrigatório) + + * **Tipo**: Constante + * **Descrição**: Sinal de início de um loop. + + * `in` (Obrigatório) + + * **Tipo**: string (expressão) + * **Descrição**: Uma expressão que precisa ser avaliada em relação a uma coleção de elementos. + + * `steps` (Obrigatório) + + * **Descrição**: Etapas a serem executadas em cada iteração do loop. Um passo pode ser qualquer tipo de passo, incluindo outro loop. + + * **Exemplos**: O exemplo a seguir mostra como executar o fluxo de trabalho de loop workflowInputs. Note que o resultado deve ser um tipo de coleção. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # not exist outside of this loop + index: '${{ .steps.loopStep.loop.index }}' # not exist outside of this loop + ``` + + + * `element` e `index` são atribuídos automaticamente como parte do loop. + * `Index` é de base zero. + * O `element` pode ser um tipo complexo se você tiver uma coleção de elementos complexos. + * Todas as variáveis de loop e as saídas das etapas dentro do loop têm escopo de nível de loop. Essas variáveis são zeradas após o término do loop e acessá-las fora do loop resultará em um valor nulo. Um loop pode acessar variáveis que estão fora do loop se elas tiverem sido definidas previamente. + + + **Laço for simples em números inteiros** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: ${{ [range(1; 6)] }} + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [1, 2, 3, 4, 5] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1, 2, 3, 4] + ``` + + **Loop simples para mapa** + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [ { "key1": "val1" }, { "key2": "val2"} ] }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' # [{ "key1": "val1" }, { "key2": "val2"}] + index: '${{ .steps.loopStep.loop.index }}' # [0, 1] + ``` + + **Saltar dentro de um loop** + + Só é permitido saltar entre etapas nomeadas pertencentes ao mesmo laço \`for\`. Não é permitido entrar ou sair de um laço \`for\`, de um laço interno/externo ou entre dois laços \`for\` diferentes. + + ```yaml + name: myWorkflow + steps: + - name: firstStep + type: action + action: example.messaging.sayHello + version: '1.0.0' + - name: loopStep + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: step1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: step3 # Okay within the loop + - name: step2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.step1.outputs.greeting }}' + - name: step3 + type: action + action: example.messaging.sayHello + version: '1.0.0' + next: firstStep # Not okay, first step is not in the loop context + ``` + + **Use break/continue em um loop.** + + Para alterar o fluxo de um loop for, você pode usar `next: break` ou `next: continue`. Observe que `break` e `continue` são destinos de salto reservados definidos implicitamente dentro de um loop. Usar `next: break` ou `next: continue` fora de um loop fará com que você pule para o final das etapas do fluxo de trabalho. + + * O `end` tem a mesma função que `break` se usado dentro de um loop. + * O comando "next" pode ser usado tanto em etapas de comutação quanto em qualquer tipo de etapa. + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: '${{ [range(1; 6)] }}' + steps: + - name: insideLoopStep1 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + next: continue + - name: insideLoopStep2 + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStep.loop.element }}' + - name: loopStepAgain + type: loop + for: + in: '${{ .workflowInputs.count }}' + steps: + - name: switchStep + type: switch + switch: + - condition: '${{ .steps.loopStepAgain.loop.index >= 0 }}' + next: break + - name: insideLoopStepAgain + type: action + action: example.messaging.sayHello + version: '1.0.0' + inputs: + name: '${{ .steps.loopStepAgain.loop.element }}' + ``` + + + +* **`steps[*].for`** (Obrigatório) + + * **Tipo**: constante + * **Descrição**: Sinal de início de um loop + +* **`steps[*].in`** (Obrigatório) + + * **Tipo**: string (expressão) + + * **Descrição**: Uma expressão que precisa ser avaliada como uma coleção de elementos. + + * **`steps[*].steps`** (Opcional) + + * **Descrição**: Etapas a serem executadas em cada iteração do loop. Veja a definição das etapas acima. + + * **Exemplo**: + + ```yaml + name: myWorkflow + steps: + - name: loopStep + type: loop + for: + in: "${{ [range(1; 5)] }}"" + steps: + - name: step1 + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "Loop: ${{ .steps.loopStep.loop.element }}" + ``` + +### **trocar** + +* Uma etapa que verifica várias condições e executa o primeiro ramo que resulta em verdadeiro. + +* Um switch pode conter qualquer número de elementos de condição em uma lista. O sistema verificará as condições em ordem e processará a primeira que for avaliada como verdadeira. Se nenhuma avaliação for verdadeira, o próximo passo será executado conforme definido em steps\[\*].next. + +* **`steps[*].switch`** (Obrigatório) + + * **Tipo**: matriz + * **Descrição**: Uma matriz de casos de alternância, especificando a lista ordenada de condições a serem avaliadas. + +* **`steps[*].switch[*].condition`** (Obrigatório) + + * **Tipo**: string (expressão) + * **Descrição**: O estado da caixa do interruptor. Se avaliada como verdadeira, a próxima etapa do caso será executada. + +* **`steps[*].switch[*].next`** (Obrigatório) + + * **Tipo**: string (em conformidade com [o padrão de segurança de expressão]()) + * **Descrição**: O nome da etapa a ser executada se a condição do caso for avaliada como verdadeira. A palavra-chave especial "end" pode ser usada para indicar que esta etapa deve ser a última a ser executada. + + ```yaml + - name: hasCompleted + type: switch + switch: + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Failed" }} + next: displayError + - condition: ${{ .steps.waitForCompletion.outputs.automationExecutionStatus == "Success" }} + next: displaySuccess + next: displayUnexpected + ``` + +### espere + +Uma etapa que faz com que o fluxo de trabalho aguarde um determinado número de segundos antes de continuar. Ele também pode captar um ou mais sinais. Se nenhum sinal for recebido durante a espera, o processo prosseguirá normalmente. Os sinais são definidos em uma lista. Cada sinal deve ter uma próxima etapa correspondente definida. O primeiro sinal a ser recebido será o processado. O valor recebido para o sinal será armazenado na saída da etapa de espera e poderá ser usado para processamento lógico em etapas posteriores. + +* Exemplo: + + ```yaml + name: waitSignalExample + workflowInputs: + steps: + - name: waitStep + type: wait + seconds: 300 + signals: [{name: 'mySignalName', next: 'firstStep'}] + - name: endStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "didn't get signal" + next: end + - name: firstStep + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.waitStep.outputs.signalInputs.myString }} + ``` + +* **`steps[*].seconds`** (Obrigatório) + + * **Tipo**: número + * **Descrição**: O número de segundos a aguardar antes de continuar a execução do fluxo de trabalho. + +* **`steps[*].signals`** + + * **Tipo**: matriz + * **Descrição**: Os sinais que, quando recebidos, irão desviar o fluxo do programa. + +* **`steps[*].signals[*].name`** + + * **Tipo**: string + * **Descrição**: O nome do sinal a ser monitorado. + +* **`steps[*].signals[*].next`** + + * **Tipo**: string + * **Descrição**: O passo a ser executado se o sinal especificado for recebido. + +## Tipos Compartilhados + +### Cadeias de expressões + +Diversas propriedades aceitam valores de string com expressões incorporadas que são avaliadas durante a execução do fluxo de trabalho, permitindo que valores dinâmicos sejam usados dentro das definições do fluxo de trabalho. As cadeias de expressões podem conter uma ou várias expressões, cada uma delas delimitada por chaves duplas. O conteúdo entre chaves é avaliado usando jq. + +O jq oferece a capacidade de acessar e manipular valores de diversas maneiras. Por exemplo, o comprimento de uma string de entrada de fluxo de trabalho pode ser obtido da seguinte forma: `${{ .workflowInputs.myString | length }}` + +Para construir e [testar expressões JQ,](https://play.jqlang.org/) esta ferramenta pode ser utilizada. + +### Propriedades de expressão + +Diversas propriedades podem ser acessadas por meio de expressões. Essas propriedades residem em um objeto de "escopo", portanto, as expressões devem começar com um ponto (.) para acessar essas propriedades do objeto de escopo. + +Os imóveis disponíveis são: + +* `workflowInputs` - Objeto contendo as entradas passadas para o fluxo de trabalho no início. + * Exemplo: `${{ .workflowInputs.myInput }}` +* `steps` - objeto contendo uma propriedade para cada etapa do fluxo de trabalho + * `steps.` - objeto contendo propriedades para uma etapa específica + * `steps..outputs` - Objeto contendo propriedades de resultado, específicas para a etapa/ação. + * Exemplo: `${{ .steps.myStep.outputs.myResult }}` + +### Resultados da avaliação da expressão + +Uma única expressão jq pode resultar em qualquer tipo JSON, mas é importante notar que o resultado final de uma string de expressão completa dependerá do conteúdo da string (se houver) que a envolve. + +Se toda uma string de expressão consistir em uma única expressão, ela será avaliada de acordo com o resultado da expressão jq, mantendo o tipo JSON do resultado. Por exemplo, se um fluxo de trabalho receber uma matriz como entrada, a string `${{ .workflowInputs.myArray }}` será avaliada como uma matriz. Isso pode ser útil para transmitir dados complexos dentro de um fluxo de trabalho. + +Se a expressão contiver conteúdo além de uma única expressão, ela será avaliada como uma string resultante. Por exemplo, isso ocorre quando uma expressão tem conteúdo antes/depois dela ou se a string contém várias expressões. Cada expressão dentro da string é avaliada e convertida em uma representação em string. + +Exemplo: + +Para os exemplos a seguir, suponha que myArray tenha o valor \[1, 2, 3]. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ string de expressão + + Dados de resultados + + Tipo de resultado +
+ `${{ .workflowInputs.myArray }}` + + \[1, 2, 3] + + matriz de números +
+ `${{ .workflowInputs.myArray | length }}` + + 3 + + número +
+ `${{ .workflowInputs.myArray | length > 0 }}` + + verdadeiro + + boleano +
+ `Input is not empty: ${{ .workflowInputs.myArray | length > 0 }}` + + "A entrada não está vazia: verdadeiro" + + corda +
+ `${{ .workflowInputs.myArray }} has length ${{ .workflowInputs.myArray | length }}` + + "tem comprimento 3" + + corda +
+ +### Padrão seguro para expressões [#expression-safe-pattern] + +As propriedades que podem ser usadas em expressões devem estar em conformidade com a seguinte expressão regular: `^[A-Za-z_][A-Za-z0-9_]*$` + +### Referências secretas + +Os valores secretos podem ser usados em ações por meio de strings de referência que especificam o nome de um segredo a ser pesquisado no Serviço de Segredos. Para referenciar um segredo em uma definição de fluxo de trabalho, use a seguinte sintaxe: + +* `${{ :secrets: }}` para um segredo que não está em um `namespace` +* `${{ :secrets:: }}` para um segredo em um `namespace` + +Uma string de expressão pode conter uma combinação de referências secretas e expressões JQ e/ou múltiplas referências secretas. + +Exemplos: + +```yaml + steps: + - name: bearer_auth + type: action + action: http.post + inputs: + headers: + Authorization: Bearer ${{ :secrets: }} +``` + +## Exemplos + +* Olá Mundo + +```yaml +name: helloWorld +description: 'A hello world workflow' + +workflowInputs: + name: + type: String + defaultValue: World + required: false + validations: + - type: maxLength + errorMessage: "name must be at most 100 characters" + length: 100 + slackTokenSecret: + type: String + defaultValue: "${{ :secrets:SLACK_TOKEN }}" + slackChannel: + type: String + defaultValue: my-channel + validations: + - type: regex + errorMessage: "A slack channel name must be lowercase and can only contain letters, numbers, and hyphens" + pattern: "^[a-z0-9\\-]+$" + required: true + +steps: + - name: init1 + type: assign + inputs: + greeting: Hello ${{ .workflowInputs.name }} + + - name: logName + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: ${{ .steps.init1.outputs.greeting }} + + - name: waiting1 + type: wait + seconds: 1 + + - name: queryForLog + type: action + action: newrelic.nrdb.query + version: 1 + inputs: + query: >- + FROM Log SELECT * WHERE message LIKE '${{ .steps.init1.outputs.greeting + }}' + + - name: checkResult + type: switch + switch: + - condition: ${{ .steps.queryForLog.outputs.results | length > 0 }} + next: FoundMessage + + - name: waitingMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Waiting for log message... + token: ${{ .workflowInputs.slackTokenSecret }} + next: waiting1 + + - name: FoundMessage + type: action + action: slack.chat.postMessage + version: 1 + inputs: + channel: ${{ .workflowInputs.slackChannel }} + text: Found message! ${{ .steps.queryForLog.outputs.results[0].message }} + token: ${{ .workflowInputs.slackTokenSecret }} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx new file mode 100644 index 00000000000..b0ea939e407 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-schedule.mdx @@ -0,0 +1,44 @@ +--- +title: ExcluirAgendamento +tags: + - workflow automation + - workflow + - Delete Schedule + - workflow automation API +metaDescription: 'Deletes the schedule of a workflow definition. Note, this doesn’t stop already running workflow instance.' +freshnessValidatedDate: never +translationType: machine +--- + +Exclui o agendamento de uma definição de fluxo de trabalho. Observe que isso não interrompe nenhuma execução de fluxo de trabalho em andamento (use a mutação StopWorkflowRun). + +## Exemplo [#example] + +Utilize o [criador de consulta](https://one.newrelic.com/nerdgraph-graphiql?state=fc314f67-101e-a54a-169a-191d1fd41fd) para criar e editar um fluxo de trabalho. Consulte [o explorador de API do NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql + mutation { + workflowAutomationDeleteSchedule( + accountId: 11933347 + schedule: {id: "1a71d299-82c2-4b4d-9803-b14523e3a9e7"} + ) { + scheduleId + } + } +``` + +### Exemplo de erro + +Caso o `schedule.id` não seja encontrado, a seguinte estrutura será retornada. + +```graphql +{ + "data": { + "workflowAutomationDeleteSchedule": null + }, + "errors": [{ + "message": "Could not find schedule with ID MTE2NDk5MDB8TkdFUHxXT1JLRkxPV19TQ0hFRFVMRXwwMTk5MGUzYi04NzAyLTc2M2QtOWUzMy01ZTU1ZThmZTYzYjkl", + "path": ["workflowAutomationDeleteSchedule"] + }] +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx new file mode 100644 index 00000000000..dd0d8c3d6bd --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition.mdx @@ -0,0 +1,32 @@ +--- +title: ExcluirDefiniçãoDeFluxoDeTrabalho +tags: + - workflow automation + - workflow + - Delete Workflow Definition + - workflow automation API +metaDescription: Used to delete all the workflow definition versions with the specified name. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API exclui todas as versões de definição de fluxo de trabalho com o nome especificado. + +Para excluir uma definição, não deve haver nenhuma programação que utilize essa definição. Se a definição estiver sendo usada por um agendamento, a exclusão da definição falhará e retornará um erro. + +Todas as execuções de fluxo de trabalho em andamento continuarão até a conclusão, mesmo que a definição seja excluída. + +## Exemplo + +```graphql +mutation { + workflowAutomationDeleteWorkflowDefinition( + definition: {name: "my-workflow"} + scope: {id: "12345678", type: ACCOUNT} + ) { + definition { + name + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx new file mode 100644 index 00000000000..fe59d4f9bf1 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-action-definitions.mdx @@ -0,0 +1,158 @@ +--- +title: GetActionDefinitions +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: 'Returns all action definitions stored. This operation is behind NerdGraph, under account stitch point.' +freshnessValidatedDate: never +translationType: machine +--- + +\#Retorna todas as definições de ação que podem ser usadas para compor uma definição de fluxo de trabalho. + +## Exemplo + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + actionDefinitions { + results { + description + inputs { + name + required + secretAllowed + } + name + outputs { + name + } + timeout { + action + } + version + } + } + } + } + } +} +``` + +retorna o seguinte + +```graphql +{ + "data": { + "actor": { + "account": { + "workflowAutomation": { + "actionDefinitions": { + "results": [ + { + "description": "Reboot one or more EC2 instances in an AWS account.", + "inputs": [ + { + "name": "awsRoleArn", + "required": false, + "secretAllowed": false + }, + { + "name": "awsAccessKeyId", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSecretAccessKey", + "required": false, + "secretAllowed": true + }, + { + "name": "awsSessionToken", + "required": false, + "secretAllowed": true + }, + { + "name": "region", + "required": true, + "secretAllowed": false + }, + { + "name": "instanceIds", + "required": true, + "secretAllowed": false + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "aws.ec2.rebootInstances", + "outputs": [ + { + "name": "success" + }, + { + "name": "response" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 25 + }, + "version": 1 + }, + { + "description": "Send logs to New Relic.", + "inputs": [ + { + "name": "attributes", + "required": false, + "secretAllowed": false + }, + { + "name": "logs", + "required": true, + "secretAllowed": false + }, + { + "name": "licenseKey", + "required": false, + "secretAllowed": true + }, + { + "name": "selectors", + "required": false, + "secretAllowed": false + } + ], + "name": "newrelic.ingest.sendLogs", + "outputs": [ + { + "name": "success" + }, + { + "name": "errorMessage" + } + ], + "timeout": { + "action": 20 + }, + "version": 1 + } + # more ... + ] + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx new file mode 100644 index 00000000000..e6be002ca2c --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedule.mdx @@ -0,0 +1,29 @@ +--- +title: Obter agendamento +tags: + - workflow automation + - workflow + - Get Schedule + - workflow automation API +metaDescription: API gets and returns a schedule. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtém e retorna um cronograma. + +## Exemplo [#example] + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedule(id: "schedule-id") { + id + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx new file mode 100644 index 00000000000..a0bbe18e07b --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-schedules.mdx @@ -0,0 +1,41 @@ +--- +title: ObterAgendas +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Returns information about schedules. +freshnessValidatedDate: never +translationType: machine +--- + +Retorna informações sobre horários. + +## Exemplo + +```graphql + { + actor { + account(id: 11933347) { + workflowAutomation { + schedules { + results { + definition { + name + scope { + id + type + } + version + } + schedule { + id + } + } + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx new file mode 100644 index 00000000000..1b171b5bfb6 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definition.mdx @@ -0,0 +1,35 @@ +--- +title: ObterDefiniçãoDeFluxoDeTrabalho +tags: + - workflow automation + - workflow + - Get Workflow Definition + - workflow automation API +metaDescription: Used to get and return a workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtém e retorna uma definição de fluxo de trabalho. + +## Exemplo + +Utilize o [criador de consulta](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) para criar e editar um fluxo de trabalho. Consulte [o explorador de API do NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflow(name: "my-workflow", version: 1) { + definition { + name + version + yaml + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx new file mode 100644 index 00000000000..77c290a3efe --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions.mdx @@ -0,0 +1,38 @@ +--- +title: ObterDefiniçõesDeFluxoDeTrabalho +tags: + - workflow automation + - workflow + - Get Workflow Definitions + - workflow automation API +metaDescription: Used to get and return a list of workflow definitions under the user account’s scope. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtém e retorna uma lista de todos os esboços de definição de fluxo de trabalho dentro do escopo fornecido. Observe que o arquivo YAML de definição do fluxo de trabalho interno não está disponível com esta consulta. Um arquivo YAML de definição de fluxo de trabalho só é retornado usando uma consulta GetWorkflowDefinition. `/{actor/account(:id)/workflowAutomation/workflow(:name, :version)` + +## Exemplo + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflows(cursor: "xyz123") { + results { + definition { + name + scope { + id + type + } + version + } + } + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx new file mode 100644 index 00000000000..4d5e353ecbd --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/signal-workflow-run.mdx @@ -0,0 +1,75 @@ +--- +title: Executar fluxo de trabalho de sinalização +tags: + - workflow automation + - workflow + - Signal Workflow Run + - workflow automation API +metaDescription: Actions trigger a signal to an existing running workflow. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API envia um sinal para um fluxo de trabalho em execução. Isso pode ser usado para enviar um retorno de chamada e ser avaliado pelo fluxo de trabalho para prosseguir para as próximas etapas. + +O parâmetro pode ser passado junto com o sinal. + +## Exemplo [#example] + + + + ```yaml + name: signalDemo + + steps: + - name: waitStep + type: wait + seconds: 300 + signals: + - name: approve + next: signalHandler + - name: cancel + next: signalHandler + + - name: NoSignalReceived + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "no signals received" + next: end + + - name: signalHandler + type: action + action: newrelic.ingest.sendLogs + version: 1 + inputs: + logs: + - message: "signal '${{ .steps.waitStep.outputs.signalName }}' was received with: '${{ .steps.waitStep.outputs.signalInputs | tostring }}'" + ``` + + + +Após iniciar este fluxo de trabalho, este runId é retornado ao iniciar. `107e6df2-aa17-41bc-8065-bfa46bde810b` + +O fluxo de trabalho pode então ser sinalizado com essa mutação. + +```graphql +mutation { + workflowAutomationSignalWorkflowRun( + accountId: 11933347 + runId: "107e6df2-aa17-41bc-8065-bfa46bde810b" + signalName: "approve" + signalInputs: [ + {key: "foo", value: "bar"} + ] + ) { + runId + } +} +``` + +O seguinte pode ser observado nos logs se o fluxo de trabalho foi iniciado com o `options: {logLevel: DEBUG}` + +Screenshot displaying Logs if the workflow was started with the options: {logLevel: DEBUG} \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx new file mode 100644 index 00000000000..f208776befd --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/start-workflow-run.mdx @@ -0,0 +1,35 @@ +--- +title: IniciarExecutarFluxoDeTrabalho +tags: + - workflow automation + - workflow + - Get Schedules + - workflow automation API +metaDescription: Start a workflow run for a specified workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API inicia a execução de um fluxo de trabalho para uma definição de fluxo de trabalho específica. + +O número de execuções simultâneas do fluxo de trabalho e o número de etapas executadas em uma determinada execução são definidos em [Limites do sistema de fluxo de trabalho](/docs/workflow-automation/limitations-and-faq/workflow-limits). + +## Exemplo + +Utilize o [criador de consulta](https://one.newrelic.com/nerdgraph-graphiql?state=b8f3b3a9-8d3e-c03e-5da4-34b98a57ff8f) para criar e editar um fluxo de trabalho. Consulte [o explorador de API do NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +mutation { + workflowAutomationStartWorkflowRun( + scope: {id: "12345678", type: ACCOUNT} + definition: {name: "my-workflow"} + workflowInputs: [ + {key: "foo", value: "bar"}, + {key: "fruit", value: "apple"} + ] + options: {logLevel: DEBUG} + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx new file mode 100644 index 00000000000..4233151575d --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/stop-workflow-run.mdx @@ -0,0 +1,26 @@ +--- +title: InterromperExecuçãoDoFluxoDeTrabalho +tags: + - workflow automation + - workflow + - Stop Workflow Run + - workflow automation API +metaDescription: Stops a running workflow instance. +freshnessValidatedDate: never +translationType: machine +--- + +Isso interrompe um fluxo de trabalho em execução. Retorna um valor vazio `runId` se o fluxo de trabalho não for encontrado. + +## Exemplo + +```graphql +mutation { + workflowAutomationStopWorkflowRun( + accountId: 11933347 + runId: "7ffbe082-8efa-4d3d-901a-a08bcf22bcd3" + ) { + runId + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx new file mode 100644 index 00000000000..7d293a5ecd9 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/update-workflow-definition.mdx @@ -0,0 +1,30 @@ +--- +title: Atualizar definição de fluxo de trabalho +tags: + - workflow automation + - workflow + - Update Workflow Definition + - workflow automation API +metaDescription: Used to update an existing workflow definition. +freshnessValidatedDate: never +translationType: machine +--- + +Utilizado para atualizar uma definição de fluxo de trabalho existente. Retorna um erro se a definição do fluxo de trabalho ainda não existir. + +## Exemplo + +```graphql + mutation { + workflowAutomationUpdateWorkflowDefinition( + definition: {yaml: ""} + scope: {id: "11608789", type: ACCOUNT} + ) { + definition { + name + version + yaml + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx new file mode 100644 index 00000000000..252e46644bb --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/using-workflow-automation-api.mdx @@ -0,0 +1,81 @@ +--- +title: Referência API automação de fluxo de trabalho +tags: + - workflow automation + - workflow + - nerdgraph + - nerdgraph api + - workflow automation api +metaDescription: Complete reference guide for Workflow Automation APIs in New Relic. +freshnessValidatedDate: never +translationType: machine +--- + + + Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse! + + Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas [políticas de pré-lançamento](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy). + + +A API de automação de fluxo de trabalho permite criar, gerenciar e executar programaticamente fluxo de trabalho no New Relic. Utilize essas APIs para automatizar tarefas repetitivas, orquestrar operações complexas e integrar o fluxo de trabalho aos seus processos de desenvolvimento e operações. + +## Antes de você começar + +Para usar as APIs de Automação de Fluxo de Trabalho, você precisará de: + +* Uma conta New Relic com as permissões apropriadas. +* Acesso ao [explorador API do NerdGraph](https://one.newrelic.com/nerdgraph-graphiql?state=c8579e50-f154-fec6-22b8-f9fdcfc1990a) para criar e testar sua chamada de API +* Compreensão do [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) (API GraphQL da New Relic) + +Para obter ajuda adicional: + +* Aprenda a usar o IDE GraphiQL no [tutorial do explorador API da NerdGraph.](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) +* Consulte [a Introdução às APIs](/docs/apis/intro-apis/introduction-new-relic-apis) para obter uma visão geral de todas as APIs do New Relic. + +### Autenticação e segredos + +fluxo de trabalho A automação utiliza o Secret Storage dos clientes para gerenciar informações confidenciais como chave de API e credenciais. Os segredos são gerenciados por meio [de nossa API GraphQL](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph). Para obter detalhes de autenticação relacionados ao gerenciamento de segredos, consulte a [documentação do NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph). + +## Operações de API por categoria + +### Criar e gerenciar fluxo de trabalho + +Utilize estas APIs para criar, atualizar, validar e excluir definições de fluxo de trabalho: + +* [CriarDefiniçãoDeFluxoDeTrabalho](/docs/workflow-automation/workflow-automation-apis/create-workflow-definition) - Criar uma nova definição de fluxo de trabalho +* [AtualizarDefiniçãoDeFluxoDeTrabalho](/docs/workflow-automation/workflow-automation-apis/update-workflow-definition) - Atualizar uma definição de fluxo de trabalho existente +* [ValidarDefiniçãoDeFluxoDeTrabalho](/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition) - Valida o YAML da definição do fluxo de trabalho antes de criar ou atualizar. +* [DeleteWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/delete-workflow-definition) - Exclui todas as versões de uma definição de fluxo de trabalho com o nome especificado. + +### consulta fluxo de trabalho e ações + +Utilize estas APIs para obter informações sobre fluxo de trabalho e ações disponíveis: + +* [GetWorkflowDefinition](/docs/workflow-automation/workflow-automation-apis/get-workflow-definition) - Obtém e retorna uma definição de fluxo de trabalho específica. +* [GetWorkflowDefinitions](/docs/workflow-automation/workflow-automation-apis/get-workflow-definitions) - Obtém e retorna uma lista de definições de fluxo de trabalho no escopo da sua conta. +* [GetActionDefinitions](/docs/workflow-automation/workflow-automation-apis/get-action-definitions) - Retorna todas as definições de ação disponíveis. + +### Executar fluxo de trabalho + +Utilize estas APIs para controlar a execução do fluxo de trabalho: + +* [IniciarExecuçãoDoFluxoDeTrabalho](/docs/workflow-automation/workflow-automation-apis/start-workflow-run) - Inicia a execução de um fluxo de trabalho para uma definição de fluxo de trabalho específica. +* [SignalWorkflowRun](/docs/workflow-automation/workflow-automation-apis/signal-workflow-run) - Aciona um sinal para um fluxo de trabalho em execução. +* [StopWorkflowRun](/docs/workflow-automation/workflow-automation-apis/stop-workflow-run) - Interrompe uma instância de fluxo de trabalho em execução. + +### Cronograma de fluxo de trabalho + +Utilize estas APIs para criar e gerenciar agendamentos de fluxo de trabalho: + +* [CriarAgenda](/docs/workflow-automation/workflow-automation-apis/create-schedule) - Criar um agendamento para uma definição de fluxo de trabalho +* [GetSchedule](/docs/workflow-automation/workflow-automation-apis/get-schedule) - Obtenha e retorne detalhes da programação +* [GetSchedules](/docs/workflow-automation/workflow-automation-apis/get-schedules) - Retorna informações sobre todos os horários +* [DeleteSchedule](/docs/workflow-automation/workflow-automation-apis/delete-schedule) - Exclui o agendamento de uma definição de fluxo de trabalho. + + + Excluir um agendamento não interrompe a execução do fluxo de trabalho da instância. + + +### Documentação de referência + +* [Esquema de Definição](/docs/workflow-automation/workflow-automation-apis/definition-schema) - Estrutura de definição de fluxo de trabalho e referência de sintaxe \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx new file mode 100644 index 00000000000..ee942aa0269 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/validate-workflow-definition.mdx @@ -0,0 +1,34 @@ +--- +title: ValidarDefiniçãoDeFluxoDeTrabalho +tags: + - workflow automation + - workflow + - Validate Workflow Definition + - workflow automation API +metaDescription: Used to validate workflow definition YAML. +freshnessValidatedDate: never +translationType: machine +--- + +Validar o arquivo YAML da definição do fluxo de trabalho. + +## Exemplo + +```graphql + query workflowDefinitionValidation { + actor { + account(id: 11933347) { + workflowAutomation { + workflowDefinitionValidation( + definition: {yaml: "ICAgICAgICAgICAgICAgIG5hbWU6IG15V29ya2Zsb3cKCiAgICAgICAgICAgICAgICBzdGVwczoKICAgICAgICAgICAgICAgICAgLSBuYW1lOiBvbmx5U3RlcAogICAgICAgICAgICAgICAgICAgIHR5cGU6IHdhaXQKICAgICAgICAgICAgICAgICAgICBzZWNvbmRzOiAtNDIKCiAgICAgICAgICAgICAgICAgIC0gbmFtZTogJycKICAgICAgICAgICAgICAgICAgICB0eXBlOiB3YWl0CiAgICAgICAgICAgICAgICAgICAgc2Vjb25kczogLTQyCgogICAgICAgICAgICAgICAgICAtIG5hbWU6IG9ubHlTdGVwCiAgICAgICAgICAgICAgICAgICAgdHlwZTogYWN0aW9uCiAgICAgICAgICAgICAgICAgICAgYWN0aW9uOiBDb25zb2xlTG9nCiAgICAgICAgICAgICAgICAgICAgdmVyc2lvbjogIiIKICAgICAgICAgICAgICAgICAgICBpbnB1dHM6CiAgICAgICAgICAgICAgICAgICAgICAgZm9vOiAiIg=="} + ) { + errors { + message + } + valid + } + } + } + } + } +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx new file mode 100644 index 00000000000..0f133bee758 --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-automation-apis/workflow-run-info.mdx @@ -0,0 +1,32 @@ +--- +title: WorkflowRunInfo +tags: + - workflow automation + - workflow + - Workflow Run Info + - workflow automation API +metaDescription: Used to retrieve information about a specific workflow run. +freshnessValidatedDate: never +translationType: machine +--- + +Esta API obtém e retorna o status de um fluxo de trabalho para um runId de fluxo de trabalho específico. + +## Exemplo + +Utilize o [criador de consulta](https://one.newrelic.com/nerdgraph-graphiql?state=03119d23-7b51-7b7a-1c99-d2cd026300e5) para criar e editar um fluxo de trabalho. Consulte [o explorador de API do NerdGraph](/docs/apis/nerdgraph/get-started/nerdgraph-explorer). + +```graphql +{ + actor { + account(id: 11933347) { + workflowAutomation { + workflowRunInfo(runId: "8911c7e4-5a1f-4316-90c8-67adde72dd1c") { + logUrl + status + } + } + } + } +} +``` \ No newline at end of file diff --git a/src/i18n/content/pt/docs/workflow-automation/workflow-examples.mdx b/src/i18n/content/pt/docs/workflow-automation/workflow-examples.mdx new file mode 100644 index 00000000000..bf33824033b --- /dev/null +++ b/src/i18n/content/pt/docs/workflow-automation/workflow-examples.mdx @@ -0,0 +1,244 @@ +--- +title: Exemplos de fluxo de trabalho +tags: + - workflow automation + - workflow + - automation + - examples +metaDescription: 'Common workflow automation scenarios and examples for incident response, infrastructure management, and integrations.' +freshnessValidatedDate: never +translationType: machine +--- + +Esta página mostra cenários comuns de automação que você pode criar com o fluxo de trabalho Automation. Utilize esses exemplos como ponto de partida para seu próprio fluxo de trabalho ou explore a [biblioteca de modelos](/docs/workflow-automation/create-a-workflow-automation/use-a-template) para soluções prontas para implantação. + +## resposta a incidentes e remediação + +### Reversão do gateway de API + +Reverter as configurações do gateway de API para um estado anterior permite corrigir erros e configurações incorretas. + +**O que este fluxo de trabalho faz:** + +* Detecta implantação recente relacionada a um problema usando o Monitoramento de Alterações New Relic +* Envia notificação do Slack com botões de aprovação (:+1: ou :-1:) +* Após a aprovação, cria um documento do AWS Systems Manager para automatizar o rollback. +* Reverte a integração do API Gateway para a versão anterior do Lambda. +* Cria uma nova implantação para aplicar o rollback. +* Envia notificação de sucesso ou falha para o Slack +* Limpa o documento SSM após a conclusão. + +**Requisitos:** + +* Credenciais da AWS com permissões para API Gateway e Systems Manager. +* Um aplicativo Slack configurado para receber notificações e aprovações +* New Relic entidade monitoramento com Monitoramento de Alterações + +**Ações principais**: `newrelic.nerdgraph.execute`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument` + +### Óbvias de gestão EC2 + +Automatize o provisionamento, o dimensionamento e o encerramento de instâncias do EC2 para obter desempenho e custo ideais. + +**O que este fluxo de trabalho faz:** + +* Recebe alertas de alta utilização da CPU do New Relic. +* Recupera detalhes de alerta e identifica as instâncias impactadas do EC2 +* Envia notificação ao Slack com detalhes da instância e requests aprovação para redimensionamento +* Após a aprovação, cria um documento SSM para automatizar o redimensionamento da instância. +* Interrompe a instância, modifica o tipo de instância e a reinicia +* Envia atualizações de progresso para o Slack durante o processo de redimensionamento. +* Aguarda a conclusão e envia o status de sucesso ou falha. +* Revisa o documento SSM e envia a confirmação final. + +**Requisitos:** + +* Credenciais da AWS com permissões para EC2 e Systems Manager +* Uma condição de alerta ativa New Relic para a métrica EC2 +* Um aplicativo Slack configurado para receber notificações e aprovações + +**Ações principais**: `newrelic.nerdgraph.execute`, `newrelic.nrdb.query`, `slack.chat.postMessage`, `slack.chat.getReactions`, `aws.systemsManager.writeDocument`, `aws.systemsManager.startAutomation`, `aws.systemsManager.waitForAutomationStatus`, `aws.systemsManager.deleteDocument`, `utils.datetime.fromEpoch`, `utils.uuid.generate` + +### Reversão da implantação + +Reverter a implantação caso a entidade apresente problemas e notificar o usuário por meio do AWS SQS ou HTTP. + +**O que este fluxo de trabalho faz:** + +* Monitora a gravidade dos alertas de uma entidade durante um período específico (30 minutos por padrão). +* Verifica a integridade da entidade a cada minuto. +* Se a entidade entrar em estado CRÍTICO ou de AVISO, o status de não integridade será registrado. +* Envia notificação de rollback via AWS SQS (se configurado) com detalhes da entidade +* Envia notificação de rollback via webhook HTTP (se configurado) +* Se a entidade permanecer íntegra durante todo o período, registra o sucesso. +* Interrompe o monitoramento se a entidade não for encontrada. + +**Requisitos:** + +* Organização New Relic com alerta de monitoramento de severidade +* (Opcional) Fila e função AWS SQS para receber notificação de reversão +* (Opcional) endpoint HTTP para receber notificação de reversão + +**Ações principais**: `newrelic.nerdgraph.execute`, `newrelic.ingest.sendLogs`, `aws.execute.api` (sqs.send\_message), `http.post` + +## processamento de dados e relatórios + +### Enviar um relatório para o Slack + +Envie o resultado de uma consulta NRQL como um arquivo CSV no Slack. + +**O que este fluxo de trabalho faz:** + +* Executa uma consulta NRQL na(s) conta(s) New Relic especificada(s). +* Gera um arquivo CSV a partir dos resultados da consulta. +* Publica o arquivo CSV em um canal específico do Slack com uma mensagem. + +**Requisitos:** + +* Uma credencial do New Relic e uma consulta NRQL funcional. +* Um aplicativo Slack configurado com um token e um canal de destino. + +**Ações principais**: `newrelic.nrdb.query`, `utils.transform.toCSV`, `slack.chat.postMessage` + +### Análise de JSON + +Analisa o JSON (HTTP) da API de status público do New Relic e, opcionalmente, registra componentes operacionais e não operacionais. + +**O que este fluxo de trabalho faz:** + +* Obtém dados JSON da API de status do New Relic. +* Extrai e categoriza os componentes de acordo com seu status operacional. +* Registra condicionalmente os componentes operacionais (se ativado). +* Registra condicionalmente componentes não operacionais (se ativado) +* Lida com erros HTTP e registra mensagem de erro + +**Requisitos:** + +* Acesso à API de status do New Relic (summary.json) +* Permissões para enviar logs via newrelic.ingest.sendLogs + +**Ações principais**: `http.get`, `newrelic.ingest.sendLogs` + +## Modelo disponível de fluxo de trabalho + +Os modelos listados acima estão disponíveis diretamente na interface de Automação de Fluxo de Trabalho New Relic. Para acessá-los: + +1. Acesse **[one.newrelic.com](https://one.newrelic.com) > All Capabilities > Workflow Automation** +2. Clique em **Create workflow** +3. Selecione **Use a template** +4. Navegue pela biblioteca de modelos e escolha um fluxo de trabalho que corresponda ao seu caso de uso. + +Cada modelo inclui: + +* Etapas e lógica de fluxo de trabalho pré-configuradas +* Exemplo de entrada (parâmetro) +* Credenciais e integração necessárias +* Documentação dos resultados esperados + +Você pode usar os modelos tal como estão ou personalizá-los para atender às suas necessidades específicas. + +## Passando dados entre etapas + +Todo fluxo de trabalho pode referenciar resultados de etapas anteriores usando a sintaxe de modelo. Isso permite encadear ações e construir uma lógica de automação complexa. + +### Passagem básica de dados + +```yaml +steps: + - name: getAlert + action: newrelic.nerdgraph.execute + inputs: + query: | + { + actor { + account(id: 123456) { + alerts { + violation(id: 789) { + condition + entity { + name + guid + } + } + } + } + } + } + + - name: sendToSlack + action: slack.chat.postMessage + inputs: + channel: "#incidents" + text: "Alert: ${{ .steps.getAlert.outputs.data.actor.account.alerts.violation.condition }}" +``` + +### Utilizando dados em loops + +```yaml +steps: + - name: listInstances + type: action + action: aws.ec2.describeInstances + version: 1 + inputs: + filters: + - name: "tag:Environment" + values: ["production"] + + - name: checkEachInstance + type: loop + for: + in: "${{ .steps.listInstances.outputs.reservations }}" + steps: + - name: getInstanceMetrics + type: action + action: newrelic.nerdgraph.execute + version: 1 + inputs: + query: "SELECT average(cpuPercent) FROM SystemSample WHERE instanceId = '${{ .steps.checkEachInstance.loop.element.instanceId }}'" +``` + +### Lógica condicional com dados + +```yaml +steps: + - name: checkCPU + type: action + action: newrelic.nerdgraph.execute + version: 1 + # ... query configuration + + - name: decideAction + type: switch + switch: + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 90 }}" + next: resizeInstance + - condition: "${{ .steps.checkCPU.outputs.data.actor.account.nrql.results[0].average > 70 }}" + next: sendWarning + next: normalOperation + + - name: resizeInstance + type: action + action: aws.ec2.modifyInstanceAttribute + version: 1 + # ... resize configuration + + - name: sendWarning + type: action + action: slack.chat.postMessage + version: 1 + # ... warning message + + - name: normalOperation + type: action + action: newrelic.ingest.sendLogs + version: 1 + # ... log normal status +``` + +## Próximos passos + +* **[Crie seu próprio fluxo de trabalho](/docs/workflow-automation/create-a-workflow-automation/create-your-own)** – Guia passo a passo para construir fluxo de trabalho +* **[Catálogo de ações](/docs/workflow-automation/setup-and-configuration/actions-catalog/actions-catalog)** - Navegue por todas as ações disponíveis +* **[Use um modelo](/docs/workflow-automation/create-a-workflow-automation/use-a-template)** - implantar fluxo de trabalho pré-construído +* **[Configurar credenciais da AWS](/docs/workflow-automation/setup-and-configuration/set-up-aws-credentials)** - Configurar autenticação da AWS \ No newline at end of file From a2c874ab82d0b03fcb4a6a5beb88f450c7157cb6 Mon Sep 17 00:00:00 2001 From: ankit-k2io <68365825+ankit-k2io@users.noreply.github.com> Date: Mon, 3 Nov 2025 11:14:16 +0530 Subject: [PATCH 02/22] configurable vizier port change --- src/content/docs/ebpf/k8s-installation.mdx | 8 +++++++- src/content/docs/ebpf/linux-installation.mdx | 6 ++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/src/content/docs/ebpf/k8s-installation.mdx b/src/content/docs/ebpf/k8s-installation.mdx index c3990800a11..05a72a2aa73 100644 --- a/src/content/docs/ebpf/k8s-installation.mdx +++ b/src/content/docs/ebpf/k8s-installation.mdx @@ -93,7 +93,7 @@ To configure the eBPF network dashboard: The eBPF agent automatically generates entity names differently depending on the environment: - * In hosts or Docker, names are a combination of the process name, its directory or container ID, and the listening port. For example, `ruby:/home/ubuntu/app:[5678]` or `java:f4aead533895:[8080]`. + * In hosts or Docker, these names are a combination of the process name, its directory or container name, and the listening port. For example, `ruby:/home/ubuntu/app:[5678]` or `java:my-container-name:[8080]`. * In Kubernetes, names are derived from the service name for example, `mysql-database-service`. @@ -201,6 +201,12 @@ These parameters control the core identity and data destination for the eBPF age `String` `"/host/usr/src/linux-headers-6.8.0-pl"` + + `vizierPort` + Vizier server port on which agent receives pxl scripts from the client. Default to 12345 + `String` + `"12345"` + diff --git a/src/content/docs/ebpf/linux-installation.mdx b/src/content/docs/ebpf/linux-installation.mdx index bd30fef2e1d..85ca3318257 100644 --- a/src/content/docs/ebpf/linux-installation.mdx +++ b/src/content/docs/ebpf/linux-installation.mdx @@ -181,6 +181,12 @@ The `newrelic-ebpf-agent.conf` file contains the following configuration paramet `String (Path)` `""` + + `VIZIER_PORT` + Vizier server port on which agent receives pxl scripts from the client. Default to 12345. + `String` + `"12345"` + `DROP_DATA_FOR_ENTITY` Regular expression pattern to match the specific name(s) of the entity set that you wish to exclude. From 9b883518314eb5867fe662ec0ed73941b7f83ce9 Mon Sep 17 00:00:00 2001 From: akashreddy Date: Mon, 3 Nov 2025 10:27:04 +0530 Subject: [PATCH 03/22] fix: build errors --- .../whats-new/2025/06/whats-new-06-31-dash-nested-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md b/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md index f1740a9aff5..e48c12e63cc 100644 --- a/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md +++ b/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md @@ -1,7 +1,7 @@ --- title: 'Nested Variables for Dashboards' summary: 'Enhance your dashboard filtering with our new Nested Variables, creating a more dynamic and interactive experience!' -releaseDate: '2025-06-31' +releaseDate: '2025-06-30' learnMoreLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/nested-variables/' getStartedLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/dashboard-template-variables/' --- From 3fbdccbae5d0f3a5cd83560b442cd281fe330c06 Mon Sep 17 00:00:00 2001 From: akashreddy Date: Mon, 3 Nov 2025 10:55:49 +0530 Subject: [PATCH 04/22] fix: build errors --- package.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/package.json b/package.json index 37280ffbb48..f16f0e4f50a 100644 --- a/package.json +++ b/package.json @@ -242,6 +242,5 @@ }, "bugs": { "url": "https://github.com/newrelic/docs-website/issues" - }, - "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e" + } } From 0d8145dcf3e0a0cc17cf7f7d38f09bb008d10b29 Mon Sep 17 00:00:00 2001 From: akashreddy Date: Mon, 3 Nov 2025 11:02:37 +0530 Subject: [PATCH 05/22] fix: build errors --- .../whats-new/2025/06/whats-new-06-31-dash-nested-variables.md | 2 +- .../2025/07/whats-new-07-30-public-dash-pass-protection.md | 2 +- .../07/whats-new-7-31-augmenting-user-experiences-browser.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md b/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md index e48c12e63cc..ba1c5aa38b6 100644 --- a/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md +++ b/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md @@ -1,7 +1,7 @@ --- title: 'Nested Variables for Dashboards' summary: 'Enhance your dashboard filtering with our new Nested Variables, creating a more dynamic and interactive experience!' -releaseDate: '2025-06-30' +releaseDate: '2025–06–30' learnMoreLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/nested-variables/' getStartedLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/dashboard-template-variables/' --- diff --git a/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md b/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md index 198670c27e7..afd91aee500 100644 --- a/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md +++ b/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md @@ -1,7 +1,7 @@ --- title: 'Password Protection (Public Dashboards)' summary: 'Enhance the security of your publicly shared content by leveraging our new password protection feature so that only users with the URL and the password can access the shared content!' -releaseDate: '2025-07-30' +releaseDate: '2025–07–30' learnMoreLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#create-dashboard-url' getStartedLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/' --- diff --git a/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md b/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md index e4af6876ca2..f9e462677b2 100644 --- a/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md +++ b/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md @@ -1,7 +1,7 @@ --- title: 'Augmenting User Experiences: Leveraging Session Replay for Core Web Vital Optimization' summary: 'Connect Core Web Vitals data with Session Replays for faster, visual root cause analysis, and performance optimization in Browser monitoring.' -releaseDate: '2025-07-31' +releaseDate: '2025–07–31' learnMoreLink: 'https://docs.newrelic.com/docs/tutorial-improve-site-performance/guide-to-monitoring-core-web-vitals/' --- From 176dc4b14b7fd8030f55706617cc36b2887d83f7 Mon Sep 17 00:00:00 2001 From: akashreddy Date: Mon, 3 Nov 2025 12:30:49 +0530 Subject: [PATCH 06/22] fix: build errors --- .../whats-new/2025/06/whats-new-06-31-dash-nested-variables.md | 2 +- .../2025/07/whats-new-07-30-public-dash-pass-protection.md | 2 +- .../07/whats-new-7-31-augmenting-user-experiences-browser.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md b/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md index ba1c5aa38b6..e48c12e63cc 100644 --- a/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md +++ b/src/content/whats-new/2025/06/whats-new-06-31-dash-nested-variables.md @@ -1,7 +1,7 @@ --- title: 'Nested Variables for Dashboards' summary: 'Enhance your dashboard filtering with our new Nested Variables, creating a more dynamic and interactive experience!' -releaseDate: '2025–06–30' +releaseDate: '2025-06-30' learnMoreLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/nested-variables/' getStartedLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/dashboard-template-variables/' --- diff --git a/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md b/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md index afd91aee500..198670c27e7 100644 --- a/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md +++ b/src/content/whats-new/2025/07/whats-new-07-30-public-dash-pass-protection.md @@ -1,7 +1,7 @@ --- title: 'Password Protection (Public Dashboards)' summary: 'Enhance the security of your publicly shared content by leveraging our new password protection feature so that only users with the URL and the password can access the shared content!' -releaseDate: '2025–07–30' +releaseDate: '2025-07-30' learnMoreLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#create-dashboard-url' getStartedLink: 'https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/' --- diff --git a/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md b/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md index f9e462677b2..e4af6876ca2 100644 --- a/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md +++ b/src/content/whats-new/2025/07/whats-new-7-31-augmenting-user-experiences-browser.md @@ -1,7 +1,7 @@ --- title: 'Augmenting User Experiences: Leveraging Session Replay for Core Web Vital Optimization' summary: 'Connect Core Web Vitals data with Session Replays for faster, visual root cause analysis, and performance optimization in Browser monitoring.' -releaseDate: '2025–07–31' +releaseDate: '2025-07-31' learnMoreLink: 'https://docs.newrelic.com/docs/tutorial-improve-site-performance/guide-to-monitoring-core-web-vitals/' --- From a665b305dc861c67a92cb93925942acad0871643 Mon Sep 17 00:00:00 2001 From: CherylFrankenfield <32469854+CherylFrankenfield@users.noreply.github.com> Date: Fri, 31 Oct 2025 10:12:28 -0700 Subject: [PATCH 07/22] Update browser-spa-v2.mdx Updates to remove any versioning and call out released agent versions. Remove steps to manual enable as this is rolling out to prod. --- .../get-started/browser-spa-v2.mdx | 55 ++----------------- 1 file changed, 5 insertions(+), 50 deletions(-) diff --git a/src/content/docs/browser/single-page-app-monitoring/get-started/browser-spa-v2.mdx b/src/content/docs/browser/single-page-app-monitoring/get-started/browser-spa-v2.mdx index 8b03f637842..b2a8729486f 100644 --- a/src/content/docs/browser/single-page-app-monitoring/get-started/browser-spa-v2.mdx +++ b/src/content/docs/browser/single-page-app-monitoring/get-started/browser-spa-v2.mdx @@ -1,5 +1,5 @@ --- -title: Browser SPA monitoring 2.1 +title: New Browser SPA monitoring metaDescription: "The new browser SPA monitoring capability is a streamlined way to monitor your users' experience and app performance." freshnessValidatedDate: 2024-09-04 --- @@ -9,15 +9,15 @@ freshnessValidatedDate: 2024-09-04 -## SPA 2.1 +## SPA (released in agent v1.298.0) Long task consideration has been introduced to replace the extensive callback tracking used in older Single Page Applications (SPA). It also serves to backfill `jsDuration`, `timeToSettle` and `timeToLastCallbackEnd` attributes of AjaxRequest event(s) associated with a BrowserInteraction. -For _select_ native browser objects wrapped by the agent's `nrWrapper`, their callbacks will be timed. Those over 50ms in duration (long task) can extend a BrowserInteraction. In 2.0, the feature followed a soft navigation heuristic to determine when an interaction occurred naturally. Now, the interaction will additionally wait and extend its duration until a period of no long task for 5 seconds, and its end time will be re-adjusted accordingly. +For _select_ native browser objects wrapped by the agent's `nrWrapper`, their callbacks will be timed. Those over 50ms in duration (long task) can extend a BrowserInteraction. This followed a soft navigation heuristic to determine when an interaction occurred naturally. Now, the interaction will additionally wait and extend its duration until a period of no long task for 5 seconds, and its end time will be re-adjusted accordingly. -Previously, in version 2.0, AjaxRequest associated with interactions did not report or track callback timing, resulting in nullified values for the three attributes mentioned above. With the current update, `XMLHttpRequest` (but not `fetch`) that is part of an interaction and includes event listeners causing long tasks will have `jsDuration`, `timeToSettle`, and `timeToLastCallbackEnd` attributes updated to reflect the timing of long callbacks. +Previously, an AjaxRequest associated with interactions did not report or track callback timing, resulting in nullified values for the three attributes mentioned above. With the current update, `XMLHttpRequest` (but not `fetch`) that is part of an interaction and includes event listeners causing long tasks will have `jsDuration`, `timeToSettle`, and `timeToLastCallbackEnd` attributes updated to reflect the timing of long callbacks. -## SPA 2.0 +## SPA (released in agent v1.253.0) For customers monitoring browser single page applications (SPA), we're excited to announce an overhaul of our SPA monitoring functionality, meant to address numerous pain points: @@ -38,51 +38,6 @@ The updated SPA monitoring experience is designed to eliminate these problems an * New optional argument `.interaction({waitForEnd: true})` added to the [`.interaction()`](/docs/browser/new-relic-browser/browser-apis/interaction/) function: This allows customization of user interaction end time. The existing `.interaction()` functionality remains unchanged. * Deprecated API: The function [`createTracer`](/docs/browser/new-relic-browser/browser-apis/createtracer/): While still functional, the `createTracer` function is deprecated as it no longer keeps interactions open or times callbacks. Note: If you continue to use `createTracer` with the new SPA experience,`BrowserTiming` events will not be created. -## Try out the new browser SPA monitoring experience [#enable-feature] - - - - - ### Review the requirements [#review-requirements] - - This feature is tested and supported in line with our standard [browser support statement](https://docs.newrelic.com/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/#support-statement). - - - - - - ### Add the feature flag [#add-feature-flag] - - If your agent was installed with the APM method, contact our support team and we'll enable the feature flag on your account. - - If your agent was installed with NPM or the UI-based, copy/paste method, add the following feature flag your browser agent code: - - 1. Find the New Relic browser agent code in your webpage HTML. - - 2. In the `init` configuration object, add the `soft_nav` feature flag. Here's an example: - - ```js -