diff --git a/src/content/docs/apm/agents/net-agent/net-agent-api/net-agent-api.mdx b/src/content/docs/apm/agents/net-agent/net-agent-api/net-agent-api.mdx index 5197ebb27a9..16c7db3900a 100644 --- a/src/content/docs/apm/agents/net-agent/net-agent-api/net-agent-api.mdx +++ b/src/content/docs/apm/agents/net-agent/net-agent-api/net-agent-api.mdx @@ -580,6 +580,16 @@ The following list contains the different calls you can make with the API, inclu Associates a user ID to the current transaction (see below for more details). + + + + `RecordDatastoreSegment` + + + + Allows an unsupported datastore to be instrumented (see below for more details). + + @@ -1104,6 +1114,132 @@ The following list contains the different calls you can make with the API, inclu transaction.SetUserId("BobSmith123"); ``` + + ### Syntax + + ```cs + SegmentWrapper? RecordDatastoreSegment(string vendor, string model, string operation, string? commandText = null, string? host = null, string? portPathOrID = null, string? databaseName = null) + ``` + + Allows an unsupported datastore to be instrumented in the same way as the .NET agent automatically instruments its supported datastores. + + This method requires .NET agent and .NET agent API [version 10.22.0](/docs/release-notes/agent-release-notes/net-release-notes/net-agent-10-22-0/) or higher. + + ### Parameters + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Parameter + + Description +
+ `vendor` + + _string_ + + Datastore vendor name, such as MySQL, MSSQL, or MongoDB. +
+ `model` + + _string_ + + Table name, or similar identifier in a non-relational datastore. +
+ `operation` + + _string_ + + Operation being performed, such as "SELECT" or "UPDATE" for SQL databases. +
+ `commandText` + + _string?_ + + Optional. Query, or similar descriptor in a non-relational datastore. +
+ `host` + + _string?_ + + Optional. Server hosting the datastore. +
+ `portPathOrID` + + _string?_ + + Optional. Port, path, or other identifier, paired with the host to aid in identifying the datastore. +
+ `databaseName` + + _string?_ + + Optional. Datastore name or similar identifier. +
+ + ### Returns + + IDisposable segment wrapper that both creates and ends the segment automatically. + + ### Example + + ```cs + var transaction = NewRelic.Api.Agent.NewRelic.GetAgent().CurrentTransaction; + using (transaction.RecordDatastoreSegment(vendor, model, operation, + commandText, host, portPathOrID, databaseName)) + { + DatastoreWorker(); + } + ``` + + diff --git a/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/no-data-appears-infrastructure.mdx b/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/no-data-appears-infrastructure.mdx index b1215bac3f9..34b1b1517e5 100644 --- a/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/no-data-appears-infrastructure.mdx +++ b/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/no-data-appears-infrastructure.mdx @@ -46,7 +46,7 @@ If no data appears in the UI, try the following steps to diagnose the problem: > 1. Use `dpkg` to verify that the agent is installed: - ``` + ```sh dpkg -l | grep newrelic-infra ``` 2. If `dpkg` returns no output, see [Install with apt](/docs/infrastructure/new-relic-infrastructure/installation/install-infrastructure-linux#apt-based). @@ -58,7 +58,7 @@ If no data appears in the UI, try the following steps to diagnose the problem: > 1. Use `rpm` to verify that agent is installed: - ``` + ```sh rpm -qa | grep newrelic-infra ``` 2. If `rpm` returns no output, see [Install with yum](/docs/infrastructure/new-relic-infrastructure/installation/install-infrastructure-linux#yum-based). @@ -70,7 +70,7 @@ If no data appears in the UI, try the following steps to diagnose the problem: > 1. Use the Windows command prompt or Powershell to verify that the [agent directory](/docs/agents/manage-apm-agents/troubleshooting/find-agent-root-directory#infra-agent) exists: - ``` + ```sh dir "C:\Program Files\New Relic\newrelic-infra" ``` 2. If you receive a `File not found` error, see [Install for Windows Server](/docs/infrastructure/new-relic-infrastructure/installation/install-infrastructure-windows-server). @@ -87,12 +87,12 @@ If no data appears in the UI, try the following steps to diagnose the problem: 1. Check that the agent is running: - ``` + ```sh sudo systemctl status newrelic-infra ``` 2. If the agent isn't running, start the agent manually: - ``` + ```sh sudo systemctl start newrelic-infra ``` @@ -105,12 +105,12 @@ If no data appears in the UI, try the following steps to diagnose the problem: 1. Check that the agent is running: - ``` + ```sh sudo /etc/init.d/newrelic-infra status ``` 2. If the agent isn't running, start the agent manually: - ``` + ```sh sudo /etc/init.d/newrelic-infra start ``` @@ -123,12 +123,12 @@ If no data appears in the UI, try the following steps to diagnose the problem: 1. Check that the agent is running: - ``` + ```sh sudo initctl status newrelic-infra ``` 2. If the agent isn't running, start the agent manually: - ``` + ```sh sudo initctl start newrelic-infra ``` @@ -141,13 +141,13 @@ If no data appears in the UI, try the following steps to diagnose the problem: 1. Check that the agent is running: - ``` + ```sh sc query "newrelic-infra" | find "RUNNING" ``` 2. If the agent isn't running, start the agent manually with the Windows command prompt: - ``` + ```sh net start newrelic-infra ``` @@ -166,7 +166,7 @@ If no data appears in the UI, try the following steps to diagnose the problem: 6. Verify that no firewalls or proxies are blocking outbound connections from the agent process to the [Infrastructure domains and ports](/docs/apm/new-relic-apm/getting-started/networks#infrastructure). 7. Confirm the host is reporting correctly even though it is not appearing in the infrastructure monitoring UI by creating a basic query in Query builder, like: - ``` + ```sql SELECT * FROM SystemSample SINCE 60 minutes ago LIMIT 100 ``` diff --git a/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/generate-logs-troubleshooting-infrastructure.mdx b/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/generate-logs-troubleshooting-infrastructure.mdx index 4f00d2aa2ce..92adaaa860a 100644 --- a/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/generate-logs-troubleshooting-infrastructure.mdx +++ b/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/generate-logs-troubleshooting-infrastructure.mdx @@ -52,7 +52,7 @@ Generating `debug` log files requires editing your configuration file. For a sam Edit your `newrelic-infra.yml` file with logging settings: - ``` + ```yml log: level: debug file: /path/to/logfile.log @@ -138,7 +138,7 @@ These are some additional notes and requirements for specific systems, used to s * Recommended: Set the environment variable `NRIA_LOG_LEVEL` to `debug`. Running this on the command line would look like: - ``` + ```sh -e NRIA_LOG_LEVEL=debug ``` @@ -146,7 +146,7 @@ These are some additional notes and requirements for specific systems, used to s * Edit the config file to set `level: debug` in the `log` section. (Editing the config file in a container is not recommended, because it requires rebuilding the image twice: once to add verbose logging and once to remove it.) 2. Use `journalctl` to collect the logs: - ``` + ```sh journalctl -u newrelic-infra > newrelic-infra.log ``` 3. Set the logging level back to `info` or `warn` after collecting logs for a few minutes. diff --git a/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/infrastructure-agent-logging-behavior.mdx b/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/infrastructure-agent-logging-behavior.mdx index a77527fda07..469a7d1f60f 100644 --- a/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/infrastructure-agent-logging-behavior.mdx +++ b/src/content/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-logs/infrastructure-agent-logging-behavior.mdx @@ -16,7 +16,7 @@ New Relic's infrastructure agent gathers its own data as well as integrations's The following example shows a typical configuration for the agent log in Linux systems (change file path when running Windows or other platforms): -``` +```yml log: level: info file: '/var/log/newrelic-infra/newrelic-infra.log' @@ -60,7 +60,7 @@ By default, Infrastructure logs are formatted as text: Alternatively, logs can be formatted as a JSON file: -``` +```json {"context":{},"level":"info","msg":"upstart_interval_sec: 0","timestamp":"2019-07-11T18:24:03+02:00"} {"context":{},"level":"info","msg":"plugin_dir: ","timestamp":"2019-07-11T18:24:03+02:00"} ``` @@ -81,18 +81,18 @@ For more information on how to enable smart verbose mode and the debug message l ## Integration log management -Integrations write JSON payloads into STDOUT and plain-text (JSON structured in the future) logs into STDERR. +Integrations write JSON payloads into `STDOUT` and plain-text (JSON structured in the future) logs into `STDERR`. -The infrastructure agent handles integration STDERR lines and forward this output into the agent log. +The infrastructure agent handles integration `STDERR` lines and forward this output into the agent log. -Agent handles each STDERR line as follows: +Agent handles each `STDERR` line as follows: -* **when agent runs in verbose mode**: it just forwards the full STDERR line as a DEBUG agent log entry placing integration line contexts within the \`msg\` field. -* **otherwise**: it parses the line against the expected format (see below) and only logs as agent ERROR level, entries produced by integrations with \`fatal\` or \`error\` severity levels. In this case fields are extracted and forwarded in structured manner (therefore if JSON output is enabled for the agent fields become queryable. +* **When agent runs in verbose mode**: it just forwards the full `STDERR` line as a DEBUG agent log entry placing integration line contexts within the `msg` field. +* **Otherwise**: it parses the line against the expected format (see below) and only logs as agent ERROR level, entries produced by integrations with `fatal` or `error` severity levels. In this case fields are extracted and forwarded in structured manner (therefore if JSON output is enabled for the agent fields become queryable. By default, the infrastructure agent filters out any errors from integrations that don't prevent the integration from running. You'll only see all errors from an integration if the log level is set to DEBUG, or if the integration is specifically listed in the log configuration. For example, in this configuration, all errors coming from `nri-mssql` will be shown, even if the log level is INFO: -```YAML +```yml log: include_filters: integration_name: @@ -109,7 +109,7 @@ A line is expected to be a list of key-value pairs separated by an equal charact Internally agent used this regex to extract the fields: -``` +```regex ([^\s]*?)=(".*?[^\\]"|&{.*?}|[^\s]*) ``` diff --git a/src/content/docs/infrastructure/install-infrastructure-agent/configuration/infrastructure-agent-configuration-settings.mdx b/src/content/docs/infrastructure/install-infrastructure-agent/configuration/infrastructure-agent-configuration-settings.mdx index 1adfa883942..645331f7d00 100644 --- a/src/content/docs/infrastructure/install-infrastructure-agent/configuration/infrastructure-agent-configuration-settings.mdx +++ b/src/content/docs/infrastructure/install-infrastructure-agent/configuration/infrastructure-agent-configuration-settings.mdx @@ -3500,26 +3500,26 @@ Metrics can also be enriched with extended cloud metadata (including custom reso In this example, we exclude process metrics using executable files and names: - ``` - exclude_matching_metrics: # You can combine attributes from different metrics - process.name: - - regex "^java" # Exclude all processes starting with "java" - process.executable: - - "/usr/bin/python2" # Exclude the Python 2.x executable - - regex "\\System32\\svchost" # Exclude all svchost executables + ```yml + exclude_matching_metrics: # You can combine attributes from different metrics + process.name: + - regex "^java" # Exclude all processes starting with "java" + process.executable: + - "/usr/bin/python2" # Exclude the Python 2.x executable + - regex "\\System32\\svchost" # Exclude all svchost executables ``` To configure `exclude_matching_metrics` as an environment variable for the [Kubernetes integration](/docs/kubernetes-pixie/kubernetes-integration/get-started/introduction-kubernetes-integration/), add it in the manifest inside the `env:` object: ```yml env: - - name: NRIA_EXCLUDE_MATCHING_METRICS - value: | - process.name: - - regex "^java" - process.executable: - - "/usr/bin/python2" - - regex "\\System32\\svchost" + - name: NRIA_EXCLUDE_MATCHING_METRICS + value: | + process.name: + - regex "^java" + process.executable: + - "/usr/bin/python2" + - regex "\\System32\\svchost" ``` Default @@ -5940,83 +5940,83 @@ If you are having problems with proxy configuration, see [Proxy troubleshooting] ```bash curl http://localhost:8003/v1/status - { - "checks": { - "endpoints": [ - { - "url": "https://infrastructure-command-api.newrelic.com/agent_commands/v1/commands", - "reachable": true - }, - { - "url": "https://infra-api.newrelic.com/infra/v2/metrics", - "reachable": true - }, - { - "url": "https://identity-api.newrelic.com/identity/v1", - "reachable": true - }, - { - "url": "https://infra-api.newrelic.com/inventory", - "reachable": true - } - ] - }, - "config": { - "reachability_timeout": "10s" - } - } + [output] { + [output] "checks": { + [output] "endpoints": [ + [output] { + [output] "url": "https://infrastructure-command-api.newrelic.com/agent_commands/v1/commands", + [output] "reachable": true + [output] }, + [output] { + [output] "url": "https://infra-api.newrelic.com/infra/v2/metrics", + [output] "reachable": true + [output] }, + [output] { + [output] "url": "https://identity-api.newrelic.com/identity/v1", + [output] "reachable": true + [output] }, + [output] { + [output] "url": "https://infra-api.newrelic.com/inventory", + [output] "reachable": true + [output] } + [output] ] + [output] }, + [output] "config": { + [output] "reachability_timeout": "10s" + [output] } + [output] } ``` Main status endpoint (with errors): ```bash curl http://localhost:8003/v1/status - { - "checks": { - "endpoints": [ - { - "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics", - "reachable": false, - "error": "endpoint check timeout exceeded" - }, - { - "url": "https://infra-api.newrelic.com/infra/v2/metrics", - "reachable": true - }, - { - "url": "https://identity-api.newrelic.com/identity/v1", - "reachable": true - }, - { - "url": "https://infra-api.newrelic.com/inventory", - "reachable": true - } - ] - }, - "config": { - "reachability_timeout": "10s" - } - } + [output] { + [output] "checks": { + [output] "endpoints": [ + [output] { + [output] "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics", + [output] "reachable": false, + [output] "error": "endpoint check timeout exceeded" + [output] }, + [output] { + [output] "url": "https://infra-api.newrelic.com/infra/v2/metrics", + [output] "reachable": true + [output] }, + [output] { + [output] "url": "https://identity-api.newrelic.com/identity/v1", + [output] "reachable": true + [output] }, + [output] { + [output] "url": "https://infra-api.newrelic.com/inventory", + [output] "reachable": true + [output] } + [output] ] + [output] }, + [output] "config": { + [output] "reachability_timeout": "10s" + [output] } + [output] } ``` Errors endpoint example: ```bash curl http://localhost:18003/v1/status/errors - { - "checks": { - "endpoints": [ - { - "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics", - "reachable": false, - "error": "endpoint check timeout exceeded" - } - ] - }, - "config": { - "reachability_timeout": "10s" - } - } + [output] { + [output] "checks": { + [output] "endpoints": [ + [output] { + [output] "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics", + [output] "reachable": false, + [output] "error": "endpoint check timeout exceeded" + [output] } + [output] ] + [output] }, + [output] "config": { + [output] "reachability_timeout": "10s" + [output] } + [output] } ``` This is similar to the main status endpoint but filtering those with errors only. @@ -6025,10 +6025,10 @@ If you are having problems with proxy configuration, see [Proxy troubleshooting] ```bash curl http://localhost:8003/v1/status/entity - { - "guid":"MMMMNjI0NjR8SU5GUkF8TkF8ODIwMDg3MDc0ODE0MTUwNTMy", - "key":"your-host-name" - } + [output] { + [output] "guid":"MMMMNjI0NjR8SU5GUkF8TkF8ODIwMDg3MDc0ODE0MTUwNTMy", + [output] "key":"your-host-name" + [output] } ``` Returns information about the agent/host entity. A response status code _204_ ("No Content") will be returned when the agent still has no information diff --git a/src/content/docs/infrastructure/install-infrastructure-agent/macos-installation/install-infrastructure-monitoring-agent-macos.mdx b/src/content/docs/infrastructure/install-infrastructure-agent/macos-installation/install-infrastructure-monitoring-agent-macos.mdx index 9ad2144c555..9ea808f3a8e 100644 --- a/src/content/docs/infrastructure/install-infrastructure-agent/macos-installation/install-infrastructure-monitoring-agent-macos.mdx +++ b/src/content/docs/infrastructure/install-infrastructure-agent/macos-installation/install-infrastructure-monitoring-agent-macos.mdx @@ -34,25 +34,25 @@ To install the infrastructure agent, follow the step-by-step instructions: You can check your Homebrew installation with: ```bash - which brew + which brew ``` If it's not installed, you can install it with this command (or check [Homebrew](https://brew.sh/) up-to-date instructions): ```bash - /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ``` 3. Then, open the terminal and run the following command:: ```bash - brew install newrelic-infra-agent -q + brew install newrelic-infra-agent -q ``` 4. Start the infrastructure agent service: ```bash - brew services start newrelic-infra-agent + brew services start newrelic-infra-agent ``` 5. Create the configuration file and add your : @@ -60,15 +60,15 @@ To install the infrastructure agent, follow the step-by-step instructions: Intel x86: ```bash - sudo mkdir -p /usr/local/etc/newrelic-infra/ - echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /usr/local/etc/newrelic-infra/newrelic-infra.yml + sudo mkdir -p /usr/local/etc/newrelic-infra/ + echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /usr/local/etc/newrelic-infra/newrelic-infra.yml ``` Apple Silicon: ```bash - sudo mkdir -p /opt/homebrew/etc/newrelic-infra/ - echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /opt/homebrew/etc/newrelic-infra/newrelic-infra.yml + sudo mkdir -p /opt/homebrew/etc/newrelic-infra/ + echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /opt/homebrew/etc/newrelic-infra/newrelic-infra.yml ``` Wait a few minutes, then [view your server in the infrastructure UI](/docs/infrastructure/infrastructure-ui-pages/infra-ui-overview). If no data appears after waiting a few minutes, follow the [troubleshooting steps](/docs/infrastructure/new-relic-infrastructure/troubleshooting/no-data-appears-infrastructure). diff --git a/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-agent.mdx b/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-agent.mdx index bf16736141f..58d052687a1 100644 --- a/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-agent.mdx +++ b/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-agent.mdx @@ -34,7 +34,7 @@ If you used the default install procedure for your infrastructure agent for Linu > Execute the following command as root: - ``` + ```sh sudo apt-get remove newrelic-infra ``` @@ -45,7 +45,7 @@ If you used the default install procedure for your infrastructure agent for Linu > Execute the following command as root: - ``` + ```sh sudo yum remove newrelic-infra ``` @@ -56,7 +56,7 @@ If you used the default install procedure for your infrastructure agent for Linu > Execute the following command as root: - ``` + ```sh sudo zypper -n remove newrelic-infra ``` @@ -84,13 +84,13 @@ If you followed an [assisted](/docs/infrastructure/install-configure-infrastruct If you used the default install procedure for the infrastructure agent for macOS environments, to uninstall: 1. [Stop the infrastructure agent](/docs/infrastructure/new-relic-infrastructure/configuration/start-stop-restart-check-infrastructure-agent-status#macOS): - ``` - brew services stop newrelic-infra-agent + ```sh + brew services stop newrelic-infra-agent ``` 2. From the terminal, run the uninstall command: - ``` - brew uninstall newrelic-infra-agent + ```sh + brew uninstall newrelic-infra-agent ``` ## Uninstall using config management tools [#uninstall-other] diff --git a/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-integrations.mdx b/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-integrations.mdx index 4dda18222e7..9979f337565 100644 --- a/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-integrations.mdx +++ b/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/uninstall-infrastructure-integrations.mdx @@ -140,25 +140,25 @@ Here are some examples: You can check the available contexts with: - ``` + ```sh kubectl config get-contexts ``` And switch to the desired context using: - ``` + ```sh kubectl config use-context CONTEXT_NAME ``` If you used Helm to install the Kubernetes integration, just uninstall it using Helm: - ``` + ```sh helm uninstall --namespace NAMESPACE_USED_DURING_INSTALLATION RELEASE_NAME ``` If you installed Kubernetes integration using a manifest, use the same manifest to uninstall it: - ``` + ```sh kubectl delete -f newrelic-infrastructure.yaml ``` @@ -406,7 +406,7 @@ If you remove the integrations package and want to continue using the related on - ``` + ```sh sudo zypper -n remove newrelic-infra-integrations --clean-deps ``` diff --git a/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/update-infrastructure-agent.mdx b/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/update-infrastructure-agent.mdx index 1f262ac0cd0..cd29b4ae0fa 100644 --- a/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/update-infrastructure-agent.mdx +++ b/src/content/docs/infrastructure/install-infrastructure-agent/update-or-uninstall/update-infrastructure-agent.mdx @@ -32,7 +32,7 @@ To view the current infrastructure agent version for a host in the New Relic UI, * Single hosts: See the `agentVersion` tag on any [host entity](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic/#find), or look for its `Agent version` in the **Infrastructure** UI. * Multiple hosts: Go to **Infrastructure > Navigator** and group reporting entities by `agentVersion` to see a list of active hosts per version. * Query: Use the `agentVersion` attribute on any standard agent metric to generate a report. For example, the following NRQL query shows number of unique active hosts group by agent version: - ``` + ```sql FROM SystemSample SELECT uniqueCount(hostname) FACET agentVersion LIMIT MAX diff --git a/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-assisted-install-infrastructure-agent-windows.mdx b/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-assisted-install-infrastructure-agent-windows.mdx index 489a8f0188b..904f06fe77a 100644 --- a/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-assisted-install-infrastructure-agent-windows.mdx +++ b/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-assisted-install-infrastructure-agent-windows.mdx @@ -19,7 +19,7 @@ To install the agent: 1. Download the [packaged agent file](https://download.newrelic.com/infrastructure_agent/binaries/windows/) or use the following command that automatically fetches a specific version of the agent, its checksum and verifies it after download. Replace `$arch=amd64` with desired architecture (amd64, 386) and `$v=1.27.4` with [latest or specific version](https://github.com/newrelic/infrastructure-agent/releases/latest). - ``` + ```sh $v="1.27.4"; $arch="amd64"; $url="https://download.newrelic.com/infrastructure_agent/binaries/windows/$arch/newrelic-infra-$arch.$v.zip";@("$url", "$url.sum") | ForEach-Object { Invoke-WebRequest -Uri $_ -OutFile $_.Split('/')[-1] }; write-host 'Checksum:' $(If (Select-String -Path "$url.sum".Split('/')[-1] -Pattern (Get-FileHash $url.Split('/')[-1]).Hash -Quiet) {"Ok"} Else {"Fail"}) ``` 2. Unpack the file. diff --git a/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-manual-install-infrastructure-agent-windows.mdx b/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-manual-install-infrastructure-agent-windows.mdx index b6ee0948ae8..0f738bdc247 100644 --- a/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-manual-install-infrastructure-agent-windows.mdx +++ b/src/content/docs/infrastructure/install-infrastructure-agent/windows-installation/zip-manual-install-infrastructure-agent-windows.mdx @@ -23,7 +23,7 @@ To install the agent: 1. Download the [packaged agent file](https://download.newrelic.com/infrastructure_agent/binaries/windows/) or use the following command that automatically fetches a specific version of the agent, its checksum and verifies it after download. Replace `$arch=amd64` with desired architecture (amd64, 386) and `$v=1.27.4` with [latest or specific version](https://github.com/newrelic/infrastructure-agent/releases/latest). - ``` + ```sh $v="1.27.4"; $arch="amd64"; $url="https://download.newrelic.com/infrastructure_agent/binaries/windows/$arch/newrelic-infra-$arch.$v.zip";@("$url", "$url.sum") | ForEach-Object { Invoke-WebRequest -Uri $_ -OutFile $_.Split('/')[-1] }; write-host 'Checksum:' $(If (Select-String -Path "$url.sum".Split('/')[-1] -Pattern (Get-FileHash $url.Split('/')[-1]).Hash -Quiet) {"Ok"} Else {"Fail"}) ``` 2. Unpack the file. diff --git a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/agent-not-starting-there-are-no-logs.mdx b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/agent-not-starting-there-are-no-logs.mdx index 130f87af055..90d2a9b0a0e 100644 --- a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/agent-not-starting-there-are-no-logs.mdx +++ b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/agent-not-starting-there-are-no-logs.mdx @@ -39,6 +39,6 @@ To solve this, try one of these options: * Change the owner of the log file. * Change the `log_file` entry in the `/etc/newrelic-infra.yml` configuration file. Our installation scripts create the `/var/log/newrelic-infra/` folder for that purpose, so we recommend the following value: - ``` + ```yml log_file: /var/log/newrelic-infra/newrelic-infra.log ``` diff --git a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/incorrect-data-reported.mdx b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/incorrect-data-reported.mdx index c4265f4f329..ca0efddbb23 100644 --- a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/incorrect-data-reported.mdx +++ b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/incorrect-data-reported.mdx @@ -22,20 +22,20 @@ This setting generates a lot of data very quickly, we recommend only enabling it 1. Edit the [newrelic-infra.yml](/docs/infrastructure/install-infrastructure-agent/configuration/infrastructure-agent-configuration-settings/#logging-variables) configuration file and add required flags to enable logs. For example, to enable all trace logs on the default log file path: - ``` - log: - level: trace + ```yml + log: + level: trace ``` Infrastructure agent version 1.26.0 or older require a different logging configuration: -``` - verbose: 1 - trace: - # v3.submission enables detailed logging for events, examples: SystemSample, NetworkSample, etc. - - v3.submission - # dm.submission enables detailed logging for integrations using Dimensional Metric format. - - dm.submission +```yml +verbose: 1 +trace: + # v3.submission enables detailed logging for events, examples: SystemSample, NetworkSample, etc. + - v3.submission + # dm.submission enables detailed logging for integrations using Dimensional Metric format. + - dm.submission ``` 2. Use [your init system](/docs/infrastructure/new-relic-infrastructure/configuration/start-stop-restart-check-infrastructure-agent-status#init-system) to restart the agent service: @@ -47,7 +47,7 @@ Infrastructure agent version 1.26.0 or older require a different logging configu > Use SystemD commands with CentOS 7, Debian 8, RHEL 7, and Ubuntu 15.04 or higher: - ``` + ```sh sudo systemctl restart newrelic-infra ``` @@ -58,7 +58,7 @@ Infrastructure agent version 1.26.0 or older require a different logging configu > Use System V commands with Debian 7: - ``` + ```sh sudo /etc/init.d/newrelic-infra restart ``` @@ -69,7 +69,7 @@ Infrastructure agent version 1.26.0 or older require a different logging configu > Use Upstart commands with Amazon Linux, CentOS 6, RHEL 6, and Ubuntu 14.10, or lower: - ``` + ```sh sudo initctl restart newrelic-infra ``` @@ -78,7 +78,7 @@ Infrastructure agent version 1.26.0 or older require a different logging configu id="windows-verify-status" title="Restart the agent in Windows" > - ``` + ```sh net stop newrelic-infra net start newrelic-infra ``` @@ -89,7 +89,7 @@ Infrastructure agent version 1.26.0 or older require a different logging configu Log example when v3.submission is enabled: -``` +```log time="2021-12-28T09:27:28Z" level=debug msg="Sending events to metrics-ingest." component=MetricsIngestSender key=... numEvents=3 postCount=1 timestamps="[2021-01-01 09:27:28 +0000 UTC]" time="2021-12-28T09:27:28Z" level=debug msg="Preparing metrics post." component=MetricsIngestSender postCount=1 time="2021-12-28T09:27:28Z" level=trace msg="[{\"EntityID\":111,\"IsAgent\":true,\"Events\":[{\"eventType\":\"SystemSample\",\"timestamp\":1640683648,\"entityKey\":\"...\",\"cpuPercent\":0.2004008016032026, ...}]" feature=v3.submission diff --git a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/reduce-infrastructure-agents-cpu-footprint.mdx b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/reduce-infrastructure-agents-cpu-footprint.mdx index c911e98e2b1..9944ded9282 100644 --- a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/reduce-infrastructure-agents-cpu-footprint.mdx +++ b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/reduce-infrastructure-agents-cpu-footprint.mdx @@ -125,7 +125,7 @@ The infrastructure agent has built-in plugins that collect inventory data (speci * **Disable all plugins:** `disable_all_plugins: true` * **Enable selected plugins:** To enable certain plugins, insert an exception in `disable_all_plugins`. For example, the following configuration disables all plugins, and reenables the Network Interfaces and SELinus plugins to report every 120 seconds: - ``` + ```yml disable_all_plugins: true network_interface_interval_sec: 120 selinux_interval_sec: 120 @@ -153,13 +153,13 @@ The infrastructure agent has built-in plugins that collect inventory data (speci For example, to execute the plugin once every 10 minutes: - ``` + ```yml sysctl_interval_sec: 600 ``` To disable the Sysctl plugin: - ``` + ```yml sysctl_interval_sec: -1 ``` diff --git a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/time-gaps-missing-data.mdx b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/time-gaps-missing-data.mdx index b757a9795dd..56d75aec2c2 100644 --- a/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/time-gaps-missing-data.mdx +++ b/src/content/docs/infrastructure/new-relic-infrastructure/troubleshooting/time-gaps-missing-data.mdx @@ -26,10 +26,10 @@ The following steps mitigate the data gaps problem: id="apt-install-verify" title="Edit the newrelic-infra.yml configuration file (Windows)" > - 1. Open the following file in your favorite plain text editor: C:\\Program Files\\New Relic\\newrelic-infra\\newrelic-infra.yml + 1. Open the following file in your favorite plain text editor: `C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml` 2. Add the following configuration option: - ``` + ```yml max_procs: -1 ``` @@ -38,10 +38,10 @@ The following steps mitigate the data gaps problem: id="apt-install-verify" title="Edit the newrelic-infra.yml configuration file (Linux)" > - 1. Open the following file in your favorite plain text editor: /etc/newrelic-infra.yml + 1. Open the following file in your favorite plain text editor: `/etc/newrelic-infra.yml` 2. Add the following configuration option: - ``` + ```yml max_procs: -1 ``` @@ -55,7 +55,7 @@ The following steps mitigate the data gaps problem: > Use SystemD commands with CentOS 7, Debian 8, RHEL 7, and Ubuntu 15.04 or higher: - ``` + ```sh sudo systemctl restart newrelic-infra ``` @@ -66,7 +66,7 @@ The following steps mitigate the data gaps problem: > Use System V commands with Debian 7: - ``` + ```sh sudo /etc/init.d/newrelic-infra restart ``` @@ -77,7 +77,7 @@ The following steps mitigate the data gaps problem: > Use Upstart commands with Amazon Linux, CentOS 6, RHEL 6, and Ubuntu 14.10 or lower: - ``` + ```sh sudo initctl restart newrelic-infra ``` @@ -86,7 +86,7 @@ The following steps mitigate the data gaps problem: id="windows-verify-status" title="Restart the agent in Windows" > - ``` + ```sh net stop newrelic-infra net start newrelic-infra ``` diff --git a/src/content/docs/logs/forward-logs/enable-log-management-new-relic.mdx b/src/content/docs/logs/forward-logs/enable-log-management-new-relic.mdx index 32c474a00ea..84f25e60f0e 100644 --- a/src/content/docs/logs/forward-logs/enable-log-management-new-relic.mdx +++ b/src/content/docs/logs/forward-logs/enable-log-management-new-relic.mdx @@ -86,8 +86,8 @@ Here are some details on how to accomplish specific use cases: * Use our infrastructure agent to collect host-level logs. In the `logging.yml` config file be sure to tail the `/var/log/containers/*.log` directory. For example: ```yml logs: - - name: Docker-logs - file: /var/log/containers/*.log # Path to Docker log files + - name: Docker-logs + file: /var/log/containers/*.log # Path to Docker log files ``` * Use our [Standalone Docker image](https://hub.docker.com/r/newrelic/newrelic-fluentbit-output) diff --git a/src/content/docs/logs/forward-logs/kubernetes-plugin-log-forwarding.mdx b/src/content/docs/logs/forward-logs/kubernetes-plugin-log-forwarding.mdx index b4ed4c36d9e..99a90ef0134 100644 --- a/src/content/docs/logs/forward-logs/kubernetes-plugin-log-forwarding.mdx +++ b/src/content/docs/logs/forward-logs/kubernetes-plugin-log-forwarding.mdx @@ -41,9 +41,9 @@ To forward your Kubernetes logs to New Relic with our plugin: If you're [using a Kubernetes secret](https://github.com/newrelic/helm-charts/blob/master/charts/newrelic-logging/values.yaml#L8-L25) to store the New Relic , the `newrelic-logging` chart defaults to sending logs to the US API endpoint. If the license key belongs to an EU or FedRAMP account, and a secret is used for key storage, you must update the endpoint setting with the appropriate value from the [API reference docs](/docs/logs/log-api/introduction-log-api/#endpoint). Here's an example of how to set this for EU accounts: ```yml - newrelic-logging: - enabled: true - endpoint: https://log-api.eu.newrelic.com/log/v1 + newrelic-logging: + enabled: true + endpoint: https://log-api.eu.newrelic.com/log/v1 ``` @@ -80,8 +80,8 @@ To configure your Kubernetes cluster to send the log forwarder internal metrics ```yml newrelic-logging: - fluentBit: - sendMetrics: true + fluentBit: + sendMetrics: true ``` You only need to enable the `newrelic-logging.fluentBit.sendMetrics` setting when troubleshooting a Kubernetes cluster. We recommend enabling it for a single Kubernetes cluster at a time to ease troubleshooting. diff --git a/src/content/docs/logs/get-started/live-archives.mdx b/src/content/docs/logs/get-started/live-archives.mdx index e8b783ab10d..1f50fcd7800 100644 --- a/src/content/docs/logs/get-started/live-archives.mdx +++ b/src/content/docs/logs/get-started/live-archives.mdx @@ -145,13 +145,13 @@ The live archives feature offers long-term log data storage that you intend to q Here is an example query: - ``` + ```graphql query { actor { account(id: 1234567) { nrql( query: "SELECT count(*) FROM Log SINCE '2024-02-01 12:00:00' UNTIL '2024-02-01 13:00:00'" - options: {eventNamespaces: "Logging:Archive"} + options: { eventNamespaces: "Logging:Archive" } async: true ) { results diff --git a/src/content/docs/release-notes/lambda-extension-release-notes/lambda-extension-2.3.14.mdx b/src/content/docs/release-notes/lambda-extension-release-notes/lambda-extension-2.3.14.mdx new file mode 100644 index 00000000000..e836e7fe730 --- /dev/null +++ b/src/content/docs/release-notes/lambda-extension-release-notes/lambda-extension-2.3.14.mdx @@ -0,0 +1,18 @@ +--- +subject: "Lambda-Extension" +releaseDate: '2024-10-17' +version: 2.3.14 +--- + + +## Notes + +* Adds a feature to ignore extension startup checks using the Lambda environment variable `NEW_RELIC_IGNORE_EXTENSION_CHECKS`. You can ignore selected extension checks by using a comma-separated value. For example, `agent,handler` will ignore agent and handler extension checks. Use `all` to ignore all extension checks. We recommended you ignore `all` extension checks after you've successfully instrumented the Lambda function. + +* Updates information about environment variable `NR_TAGS` in the Readme. You can use `NR_TAGS` to add tags to all the Lambda log events. + +* Introduces support for the `NEW_RELIC_ENABLED` environment variable which you can use to disable Agent. The `NEW_RELIC_ENABLED` has the `env bool` type. + +## Fixed issue + +* Fixed docker handler warning issue for containerized lambda. diff --git a/src/content/docs/release-notes/mobile-release-notes/android-release-notes/android-761.mdx b/src/content/docs/release-notes/mobile-release-notes/android-release-notes/android-761.mdx new file mode 100644 index 00000000000..d400d42ba9a --- /dev/null +++ b/src/content/docs/release-notes/mobile-release-notes/android-release-notes/android-761.mdx @@ -0,0 +1,20 @@ +--- +subject: Android agent +releaseDate: '2024-10-17' +version: 7.6.1 +downloadLink: 'https://download.newrelic.com/android_agent/ant/NewRelic_Android_Agent_7.6.1.zip' +--- + +## New + +* Adds support for the Android Gradle Plugin 8.7. + +## Fixed issues +* Resolved an issue where ProGuard/DexGuard mapping files weren't being properly uploaded to New Relic, improving crash reporting accuracy. +* Fixed a crash that occurred when Kotlin mutable maps were passed to breadcrumbs and custom events. +* Corrected behavior where default interactions were being recorded even when the feature flag was disabled. + +## Support statement + +We recommend updating the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the [Mobile monitoring agents EOL policy](/docs/mobile-monitoring/new-relic-mobile/get-started/mobile-agents-eol-policy/#android-eol). + diff --git a/src/i18n/content/es/docs/alerts/admin/rules-limits-alerts.mdx b/src/i18n/content/es/docs/alerts/admin/rules-limits-alerts.mdx index 86ca28bfc31..df97c846130 100644 --- a/src/i18n/content/es/docs/alerts/admin/rules-limits-alerts.mdx +++ b/src/i18n/content/es/docs/alerts/admin/rules-limits-alerts.mdx @@ -7,7 +7,7 @@ freshnessValidatedDate: never translationType: machine --- -Límites y reglas relativas a New Relic : +Límites y reglas relativas a New Relic : n/a @@ -42,14 +42,14 @@ n/a - + - + - [Nombre de la política de alertas](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/name-or-rename-alert-policy) + [Nombre de la política de alertas](/docs/alerts/organize-alerts/create-edit-or-find-alert-policy/) @@ -82,9 +82,9 @@ n/a - + - + @@ -196,9 +196,9 @@ n/a - + - + @@ -206,7 +206,7 @@ n/a [Descripciones de incidentes personalizadas](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/alert-custom-incident-descriptions) - + 4000 caracteres @@ -268,9 +268,9 @@ n/a - + - + @@ -308,9 +308,9 @@ n/a - + - + @@ -353,4 +353,4 @@ Algunos consejos para optimizar sus puntos de datos coincidentes: Para solicitar un aumento de límite, hable con su representante de cuenta de New Relic. -Tenga en cuenta que el uso [de ventanas deslizantes](/docs/query-your-data/nrql-new-relic-query-language/nrql-query-tutorials/create-smoother-charts-sliding-windows) puede aumentar significativamente la cantidad de puntos de datos. Considere utilizar una duración más larga de agregación de ventana deslizante para reducir la cantidad de puntos de datos producidos. +Tenga en cuenta que el uso [de ventanas deslizantes](/docs/query-your-data/nrql-new-relic-query-language/nrql-query-tutorials/create-smoother-charts-sliding-windows) puede aumentar significativamente la cantidad de puntos de datos. Considere utilizar una duración más larga de agregación de ventana deslizante para reducir la cantidad de puntos de datos producidos. \ No newline at end of file diff --git a/src/i18n/content/es/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx b/src/i18n/content/es/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx index 53f359d3fd5..336453e957b 100644 --- a/src/i18n/content/es/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx +++ b/src/i18n/content/es/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx @@ -8,23 +8,10 @@ freshnessValidatedDate: never translationType: machine --- -Con puedes saber fácilmente si una entidad (el objetivo de la notificación) tiene una o más condiciones asociadas: +Con puedes saber fácilmente si una entidad (el objetivo de la notificación) tiene una o más condiciones asociadas: -* Si es - - - **yes** - - - , su indicador de estado de salud en el índice seleccionado (APM, browser, etc.) estará codificado por colores según el estado actual. Para ver un resumen del incidente de alerta actual, pase el mouse sobre su indicador de estado de salud. - -* Si es - - - **no** - - - , su indicador de estado de salud en el índice seleccionado aparecerá en gris. +* Si es **yes**, su indicador de estado de salud en el índice seleccionado (APM, browser, etc.) estará codificado por colores según el estado actual. Para ver un resumen del incidente de alerta actual, pase el mouse sobre su indicador de estado de salud. +* Si es **no**, su indicador de estado de salud en el índice seleccionado aparecerá en gris. Para obtener más información sobre cómo funcionan juntas las condiciones y las políticas, consulte [conceptos y términos de alerta](/docs/alerts-applied-intelligence/overview/#concepts-terms). @@ -39,7 +26,7 @@ El indicador de estado de salud no aplica para: ## Estado de salud codificado por colores [#colors] -Entidad en New Relic están codificados por colores automáticamente con su estado de salud. Por ejemplo, para ver el estado de sus aplicaciones, vaya a **[one.newrelic.com](https://one.newrelic.com/all-capabilities)** y luego haga clic en **APM**. El índice **Applications** enumera todas entidades de productos y su estado de salud actual. +Entidad en New Relic están codificados por colores automáticamente con su estado de salud. Por ejemplo, para ver el estado de sus aplicaciones, vaya a **[one.newrelic.com](https://one.newrelic.com/all-capabilities)** y luego haga clic en **APM**. El índice **Applications** enumera todas entidades de productos y su estado de salud actual. @@ -61,11 +48,7 @@ Entidad en New Relic están codificados por colores automáticamente con su esta @@ -77,11 +60,7 @@ Entidad en New Relic están codificados por colores automáticamente con su esta @@ -93,11 +72,7 @@ Entidad en New Relic están codificados por colores automáticamente con su esta @@ -105,25 +80,14 @@ Entidad en New Relic están codificados por colores automáticamente con su esta @@ -165,21 +129,13 @@ La siguiente tabla describe las diferentes transiciones de estado de salud que u @@ -191,29 +147,17 @@ La siguiente tabla describe las diferentes transiciones de estado de salud que u @@ -232,29 +176,17 @@ La siguiente tabla describe las diferentes transiciones de estado de salud que u @@ -266,29 +198,17 @@ La siguiente tabla describe las diferentes transiciones de estado de salud que u @@ -302,13 +222,9 @@ La siguiente tabla describe las diferentes transiciones de estado de salud que u ## Ejemplo: aplicación sin condiciones [#example-v3-no-policies] -A continuación se muestra un ejemplo de una aplicación incluida en el índice que **is not** se asoció con alguna condición. Su estado de salud codificado por colores es gris claro, lo que indica que actualmente no hay condiciones dirigidas a la entidad o que las condiciones de la entidad no están generando una señal consistente. +A continuación se muestra un ejemplo de una aplicación incluida en el índice que **is not** se asoció con alguna condición. Su estado de salud codificado por colores es gris claro, lo que indica que actualmente no hay condiciones dirigidas a la entidad o que las condiciones de la entidad no están generando una señal consistente. -032715crop-events-no-v3.png +032715crop-events-no-v3.png
Vaya a **[one.newrelic.com](https://one.newrelic.com/all-capabilities)** y luego haga clic en **Explorer**: este ejemplo muestra una aplicación que actualmente no está asociada con ninguna condición de alerta. @@ -318,13 +234,9 @@ Siga [los procedimientos estándar](/docs/alerts-applied-intelligence/new-relic- ## Ejemplo: aplicación con condiciones [#example-v3-yes-policies] -A continuación se muestra un ejemplo de una aplicación incluida en el índice que **is** se asoció con una o más condiciones. Su estado de salud codificado por colores es verde, porque estamos recopilando datos para él y actualmente no hay ningún incidente de Advertencia (amarillo) o Crítico (rojo). +A continuación se muestra un ejemplo de una aplicación incluida en el índice que **is** se asoció con una o más condiciones. Su estado de salud codificado por colores es verde, porque estamos recopilando datos para él y actualmente no hay ningún incidente de Advertencia (amarillo) o Crítico (rojo). -032715crop-events-green.png +032715crop-events-green.png
Vaya a **[one.newrelic.com](https://one.newrelic.com/all-capabilities)** y luego haga clic en **Explorer**: este ejemplo muestra una aplicación que tiene una o más condiciones. Su estado de salud codificado por colores (verde) muestra que la aplicación no ha superado ningún umbral. @@ -332,4 +244,4 @@ A continuación se muestra un ejemplo de una aplicación incluida en el índice Para ver la lista de índice [de incidentes abiertos](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history) actualmente en todos los productos, no solo en esta entidad, seleccione **View all incidents**. - + \ No newline at end of file diff --git a/src/i18n/content/es/docs/alerts/incident-management/view-event-details-incidents.mdx b/src/i18n/content/es/docs/alerts/incident-management/view-event-details-incidents.mdx index 48480e7f406..962e020a37c 100644 --- a/src/i18n/content/es/docs/alerts/incident-management/view-event-details-incidents.mdx +++ b/src/i18n/content/es/docs/alerts/incident-management/view-event-details-incidents.mdx @@ -22,7 +22,7 @@ Cuando se supera el [umbral](/docs/alerts/create-alert/set-thresholds/set-thresh ## Ver el índice de incidentes y los detalles de los incidentes. [#view-incidents] -Incidente se agrupan en incidente. Si desea cambiar la forma en que se agrupan los incidentes, abra la política asociada y cambie la configuración [**Incident preference**](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/specify-when-new-relic-creates-incidents) . +incidente se agrupan en incidente. Si desea cambiar cómo se agrupan los incidentes, abra la política asociada y cambie la configuración [**Incident preference**](/docs/alerts/organize-alerts/specify-when-alerts-create-incidents/) . Para ver los detalles del incidente: diff --git a/src/i18n/content/es/docs/alerts/organize-alerts/create-edit-or-find-alert-policy.mdx b/src/i18n/content/es/docs/alerts/organize-alerts/create-edit-or-find-alert-policy.mdx index c0e76989b30..3bbc41042d5 100644 --- a/src/i18n/content/es/docs/alerts/organize-alerts/create-edit-or-find-alert-policy.mdx +++ b/src/i18n/content/es/docs/alerts/organize-alerts/create-edit-or-find-alert-policy.mdx @@ -14,7 +14,7 @@ Para obtener una explicación de cómo las políticas interactúan y se relacion ## Mejores prácticas para nombrar y organizar políticas [#best-practices-policies] -Las políticas New Relic ayudan a organizar la condición de alerta en unidades coherentes y manejables. Más allá de la simple categorización, brindan cierto control sobre la correlación de incidentes y la difusión de notificaciones sobre problemas potenciales. +Las políticas New Relic ayudan a organizar la condición de alerta en unidades coherentes y manejables. Más allá de la simple categorización, brindan cierto control sobre la correlación de incidentes y la difusión de notificaciones sobre problemas potenciales. Recomendamos tres patrones organizacionales comunes para estructurar la política de alertas y condiciones: @@ -82,35 +82,11 @@ Recomendamos tres patrones organizacionales comunes para estructurar la polític La política de alertas solo aplica a una cuenta. Si su organización New Relic tiene varias cuentas, debe crear una política de alertas para cada cuenta. -1. Vaya a [one.newrelic.com > Alerts > Alert Policies](https://one.newrelic.com/alerts-ai/condition-builder/policy-list). - -2. En la página de lista de políticas, haga clic en - - - - - **New alert policy** - - - . - +1. Vaya a [one.newrelic.com > Alerts > Alert Policies](https://one.newrelic.com/alerts-ai/condition-builder/policy-list). +2. En la página de lista de políticas, haga clic en **New alert policy**. 3. Escriba un [nombre significativo](#best-practices-policies) para la política (máximo 64 caracteres). - 4. Seleccione la [preferencia de emisión](/docs/alerts/new-relic-alerts/configuring-alert-policies/specify-when-new-relic-creates-incidents). - -5. Seleccione - - - **Create & close** - - - para crear su política o - - - **Set up notifications** - - - para conectar su política a un [flujo de trabajo](/docs/alerts-applied-intelligence/applied-intelligence/incident-workflows/incident-workflows). Cuando haya un problema nuevo o una actualización de un problema, recibirás una notificación en servicios como _PagerDuty_ o _Slack_. +5. Seleccione **Create & close** para crear su política o **Set up notifications** para conectar su política a un [flujo de trabajo](/docs/alerts-applied-intelligence/applied-intelligence/incident-workflows/incident-workflows). Cuando haya un problema nuevo o una actualización de un problema, recibirás una notificación en servicios como *PagerDuty* o *Slack*. Puede continuar desde aquí para [definir las condiciones](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/define-alert-conditions) y [configurar la notificación utilizando flujo de trabajo](/docs/alerts-applied-intelligence/applied-intelligence/incident-workflows/incident-workflows). Si decide continuar más tarde, seleccione el nombre de la política del índice **Alert policies** . @@ -120,21 +96,8 @@ Para su comodidad, le permitimos utilizar el mismo nombre para diferentes polít Para cambiar el nombre de una política existente: -1. Vaya a [one.newrelic.com > Alerts > Alert Policies](https://one.newrelic.com/alerts-ai/condition-builder/policy-list) y luego haga clic en una política de la lista. - -2. Haga clic en la pestaña de la política - - - **settings** - - - para editarla, escriba un [nombre significativo](#best-practices-policies) para la política (máximo 64 caracteres) y haga clic en - - - **Save** - - - . +1. Vaya a [one.newrelic.com > Alerts > Alert Policies](https://one.newrelic.com/alerts-ai/condition-builder/policy-list) y luego haga clic en una política de la lista. +2. Haga clic en la pestaña de la política **settings** para editarla, escriba un [nombre significativo](#best-practices-policies) para la política (máximo 64 caracteres) y haga clic en **Save**. Alerta actualiza automáticamente cualquiera de las condiciones de la póliza. @@ -142,12 +105,12 @@ Alerta actualiza automáticamente cualquiera de las condiciones de la póliza. El índice de políticas enumera las políticas en orden alfabético. Para ver o buscar políticas existentes: -1. Vaya a [one.newrelic.com > Alerts > Alert Policies](https://one.newrelic.com/alerts-ai/condition-builder/policy-list). +1. Vaya a [one.newrelic.com > Alerts > Alert Policies](https://one.newrelic.com/alerts-ai/condition-builder/policy-list). 2. Utilice el cuadro de búsqueda, ordene cualquier columna o desplácese por la lista. 3. Para ver información detallada, haga clic en el nombre de una política. - Para ver [información sobre políticas y condiciones para una entidad específica](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/view-policy-conditions-new-relic-products), seleccione la página **Settings > Alert conditions** en la UI del producto de la entidad. + Para ver [información sobre políticas y condiciones para una entidad específica](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/view-policy-conditions-new-relic-products), seleccione la página **Settings > Alert conditions** en la UI del producto de la entidad. ## Referencia rápida de mantenimiento de políticas [#quick-reference-policies] @@ -163,156 +126,70 @@ Después de crear una política, puede: Aquí encontrará una referencia rápida que también incluye enlaces a información y procedimientos más detallados para mantener sus pólizas. - - Para [cambiar el nombre](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/name-or-rename-alert-policy#rename-policy) de una política: - - 1. Vaya a - - - **[one.newrelic.com](https://one.newrelic.com) > Alerts > Alert Policies** - - - y luego seleccione una política. - - 2. Haga clic en la pestaña de la política - - - **settings** - + + Para [cambiar el nombre](/docs/alerts/organize-alerts/create-edit-or-find-alert-policy/#rename-policy) de una política: - para editarla, escriba un [nombre significativo](#best-practices-policies) para la política (máximo 64 caracteres) y presione - - - **Save** - - - . + 1. Vaya a **[one.newrelic.com](https://one.newrelic.com) > Alerts > Alert Policies** y luego seleccione una política. + 2. Haga clic en la pestaña de la política **settings** para editarla, escriba un [nombre significativo](#best-practices-policies) para la política (máximo 64 caracteres) y presione **Save**. - - Para crear una [nueva política de alertas](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/name-or-rename-alert-policy): - - 1. Vaya a - - - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert Policies** - - - . - - 2. Haga clic en - - - **New alert policy** - - - . - - 3. Haga clic en la política recién creada y haga clic en - - - **New Alert Condition** - + + Para crear una [nueva política de alertas](/docs/alerts/organize-alerts/create-edit-or-find-alert-policy/): - para configurar su alerta. + 1. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert Policies**. + 2. Haga clic en **New alert policy**. + 3. Haga clic en la política recién creada y haga clic en **New Alert Condition** para configurar su alerta. - + No puede deshabilitar una política directamente. Sin embargo, puede [desactivar todas las condiciones de la póliza](#). Cuando deshabilita todas las condiciones, la política sigue siendo el índice **Alert policies** . La política en sí no está deshabilitada y usted puede volver a habilitar cualquiera o todas sus condiciones en cualquier momento. - + Si elimina una política, continuaremos aplicando cualquier otra política asignada a la entidad del producto (objetivo). Si elimina **all** políticas para la entidad, su indicador [de estado de salud codificado por colores](/docs/alerts/new-relic-alerts/configuring-alert-policies/identify-entities-without-alert-policies) aparecerá en verde claro con un icono. Si elimina alguna de las políticas de su cuenta, no podrá restaurarlas. En lugar de ello, deberá volver a crearlos si es necesario. Para eliminar una política por completo: - 1. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert Policies**. + 1. Vaya a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert Policies**. 2. En la fila de la política, haga clic en el menú desplegable de puntos suspensivos (...) y seleccione **Delete**. En una política eliminada, [los problemas](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history) y [los incidentes](/docs/alerts/new-relic-alerts-beta/reviewing-events/review-events-across-products) se proporcionan como un recurso de solo lectura. - + Para comprobar si [una entidad (objetivo) tiene alguna política asignada](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/identify-entities-without-alert-policies): 1. Vaya al producto (APM, browser, etc.). - 2. Desde el índice del producto seleccionado, verifique si el estado de salud codificado por colores de la entidad es verde claro con un ícono.icon-alerts-q-green.png + 2. Desde el índice del producto seleccionado, verifique si el estado de salud codificado por colores de la entidad es verde claro con un ícono.icon-alerts-q-green.png **Exception:** La infraestructura no utiliza esta característica. - - Para seleccionar cómo se agrupan [los incidentes](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/specify-when-new-relic-creates-incidents) en problemas (por política, por condición o por objetivo y condición): - - 1. Vaya a - - - **[one.newrelic.com](https://one.newrelic.com/all-capabilities) > Alerts > Alert Policies** - - - y luego seleccione una política. - - 2. Haga clic en la pestaña - - - **Settings** - - - . - - 3. Modifique su - - - **Issue Creation Preference** - - - y haga clic en - - - **Save** - + + Para seleccionar cómo se agrupan [los incidentes](/docs/alerts/organize-alerts/specify-when-alerts-create-incidents/) en asuntos (por política, por condición o por objetivo y condición): - . + 1. Vaya a **[one.newrelic.com](https://one.newrelic.com/all-capabilities) > Alerts > Alert Policies** y luego seleccione una política. + 2. Haga clic en la pestaña **Settings** . + 3. Modifique su **Issue Creation Preference** y haga clic en **Save**. - + Si emplea alertas New Relic , puede conectar sus condiciones a [la inteligencia de incidentes](/docs/alerts-applied-intelligence/applied-intelligence/incident-intelligence/get-started-incident-intelligence/#configure-source-nr-alerts). - 1. Desde **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts**. + 1. Desde **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts**. - 2. A la izquierda, debajo de **Correlate > Sources**, luego haga clic en **Alerts**. + 2. A la izquierda, debajo de **Correlate > Sources**, luego haga clic en **Alerts**. 3. Seleccione las políticas que desea conectar a las alertas y haga clic en **Connect**. - Puedes agregar política de alertas adicionales o eliminar políticas que ya hayas conectado en **Sources > Alerts**. + Puedes agregar política de alertas adicionales o eliminar políticas que ya hayas conectado en **Sources > Alerts**. - + \ No newline at end of file diff --git a/src/i18n/content/es/docs/apm/agents/manage-apm-agents/azure/monitoring-azure-app-service.mdx b/src/i18n/content/es/docs/apm/agents/manage-apm-agents/azure/monitoring-azure-app-service.mdx new file mode 100644 index 00000000000..68501db8e7e --- /dev/null +++ b/src/i18n/content/es/docs/apm/agents/manage-apm-agents/azure/monitoring-azure-app-service.mdx @@ -0,0 +1,94 @@ +--- +title: Monitoreo de Azure App Service +tags: + - Azure + - Agents + - Manage APM agents +metaDescription: Information on how to monitor Azure app services with New Relic agents. +freshnessValidatedDate: never +translationType: machine +--- + +Azure App Service es una oferta de plataforma como servicio (PaaS) completamente gestionada de Microsoft Azure que permite a los desarrolladores crear, desplegar y escalar aplicaciones sitio web, backend móvil y API de manera rápida y eficiente a través de varios lenguajes de programación y marcos. + +Al integrar New Relic el monitoreo del rendimiento de aplicaciones (APM) (agente de APM con Azure App Service, puede lograr un monitoreo y optimización integral de su aplicación. New Relic APM proporciona tiempo real información valiosa y datos accionables para ayudarlo a garantizar que su aplicación funcione al máximo. La siguiente tabla proporciona detalles de todo el monitoreo de Azure App Service con New Relic + +## New Relic APM para el servicio de aplicaciones de Azure [#app-services] + +New Relic admite el monitoreo de Azure App Service para algunos de nuestros agentes de Monitoreo del rendimiento de aplicaciones (APM). Puede encontrar los procedimientos de instalación para configurar la supervisión de Azure App Service en la siguiente tabla. + +
- icon-alerts-green.png + icon-alerts-green.png Verde
- icon-alerts-yellow.png + icon-alerts-yellow.png Amarillo
- icon-alerts-red.png + icon-alerts-red.png Rojo Se ha superado un [umbral crítico](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/define-thresholds-trigger-alert) : - * [La notificación](/docs/alerts/new-relic-alerts-beta/managing-notification-channels/notification-channels-controlling-where-send-alerts) se ha enviado según la [preferencia de acumulación de incidentes](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/specify-when-new-relic-creates-incidents) seleccionada. - - * El incidente aparece en el [índice](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history) - - - [**Incidents**](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history) - - - [](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history). + * [La notificación](/docs/alerts/new-relic-alerts-beta/managing-notification-channels/notification-channels-controlling-where-send-alerts) se envió según la [preferencia de acumulación de incidentes](/docs/alerts/organize-alerts/specify-when-alerts-create-incidents/) seleccionada. + * El incidente aparece en el [índice**Incidents** ](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history).
- icon-alerts-gray.png + icon-alerts-gray.png Gris
- icon-alerts-gray.png + icon-alerts-gray.png Gris - icon-alerts-green.png + icon-alerts-green.png Verde
- icon-alerts-green.png + icon-alerts-green.png Verde / - icon-alerts-red.png + icon-alerts-red.png Rojo - icon-alerts-gray.png + icon-alerts-gray.png Gris
- icon-alerts-green.png + icon-alerts-green.png Verde - icon-alerts-yellow.png + icon-alerts-yellow.png Amarillo / - icon-alerts-red.png + icon-alerts-red.png Rojo
- icon-alerts-yellow.png + icon-alerts-yellow.png Amarillo / - icon-alerts-red.png + icon-alerts-red.png Rojo - icon-alerts-green.png + icon-alerts-green.png Verde
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Tiempo de ejecución + + Sistema operativo + + Tipo de aplicación +
+ Java + + Windows y Linux + + [Aplicación Web](/install/java/) +
+ .NET + + Windows y Linux + + [Aplicación Web](/install/dotnet/?deployment=azure&azure=azuresiteextension) +
+ Node.js + + Windows y Linux + + [Instalación estándar](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-azure-site-extension) de aplicación sitio web o con [docker](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-docker) +
+ Python + + Linux + + [Aplicaciones sitio web y aplicaciones contenedoras](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice) o con [integración Touchless](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration) +
\ No newline at end of file diff --git a/src/i18n/content/es/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-azure-site-extension.mdx b/src/i18n/content/es/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-azure-site-extension.mdx new file mode 100644 index 00000000000..df97e6dcc36 --- /dev/null +++ b/src/i18n/content/es/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-azure-site-extension.mdx @@ -0,0 +1,46 @@ +--- +title: Instalar el agente Node.js con nuestra extensión de sitio de Azure +tags: + - Agents + - Nodejs agent + - Installation and configuration + - Azure Site Extension +metaDescription: Procedures and resources to install New Relic's Node.js agent for Azure web apps using the New Relic Azure Site Extension for Node. +freshnessValidatedDate: never +translationType: machine +--- + +Puede instalar el agente Node.js en sus aplicaciones sitio web gestionadas por Azure con la extensión de sitio de Azure de New Relic para Node. Este documento lo guía a través de la compatibilidad, instalación y configuración para incorporar los datos de su aplicación sitio web de Azure en New Relic. + +## Compatibilidad y requisitos [#compatibility-requirements] + +Las extensiones de sitio de Azure solo están disponibles para aplicaciones de App Service basadas en Windows que se implementan como código. Para aplicaciones que se ejecutan en Windows 32, la compatibilidad completa con un nivel de código métrico (ruta de archivo, línea, columna) no está disponible. La creación de perfiles se limita únicamente al nombre de la función. + +## Instalar el agente Node.js con la extensión del sitio de Azure [#install-azure-site-extension] + +Para instalar la extensión de sitio de Azure de New Relic, agregue la extensión de sitio `NewRelic.Azure.WebSites.Extension.NodeAgent` desde la página de inicio de Azure. Siga estos pasos: + +1. Desde la página de inicio de Azure, haga clic en el mosaico App Services y, a continuación, seleccione la aplicación objetivo en la lista que se muestra. +2. Desplazar hacia abajo hasta **Extensions** en las opciones que aparecen a la izquierda, bajo la categoría **Development Tools** . +3. Haga clic en **+ Add** en la parte superior de la página para alternar el menú desplegable de extensiones, luego seleccione **New Relic Node Agent**. Marque la casilla para aceptar los términos legales +4. Haga clic en **Add** en la parte inferior de la página para comenzar a instalar la extensión. + +Una vez instalada, la extensión crea los siguientes artefactos: + +* Carpeta: `C:\home\SiteExtensions\NewRelic.Azure.Websites.Extension.NodeAgent` +* Transformación de documento XML (XDT): `applicationHost.xdt` que agregará la variable de entorno `NODE_OPTIONS` necesaria al iniciar la aplicación +* El agente y la dependencia del nodo New Relic se instalarán en `C:\home\site\wwwroot\node_modules` + +Luego de una instalación exitosa del agente con el logging habilitado, el agente agregará su registro a un archivo en `C:\home\site\wwwroot\newrelic_agent.log`. Si la extensión no se puede instalar, se crea un archivo de log en `C:\home\SiteExtensions\NewRelic.Azure.Websites.Extension.NodeAgent\install.log`. + +## Configurar el agente Node.js [#configure-agent] + +El agente Node.js se configura con el archivo `newrelic.js` o mediante variables de entorno. [Consulte nuestra documentación para una configuración más detallada](https://docs.newrelic.com/docs/apm/agents/nodejs-agent/installation-configuration/nodejs-agent-configuration/). + +Una vez instalada la extensión del sitio, deberá ingresar manualmente un elemento de configuración antes de resetear su aplicación. En las opciones que aparecen a la izquierda, busque **Settings** y desplazar hacia abajo hasta **Environment variables**. Agregue la variable `NEW_RELIC_LICENSE_KEY` con el valor de su clave de licencia. + +Nuestra extensión de sitio agrega automáticamente la variable de entorno `NODE_OPTIONS` con un valor de `-r newrelic`. Esto inyecta el agente cuando se inicia Node. Cualquier `NODE_OPTIONS` definido previamente se eliminará y se restablecerá con `-r newrelic`. + + + Recomendamos instalar o eliminar esta extensión del sitio de Azure mientras su aplicación sitio web esté detenida. + \ No newline at end of file diff --git a/src/i18n/content/es/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx b/src/i18n/content/es/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx index 8e034f8663e..0e4965b4da0 100644 --- a/src/i18n/content/es/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx +++ b/src/i18n/content/es/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx @@ -5035,7 +5035,7 @@ Aquí hay una variedad de otras configuraciones disponibles a través del archiv - + @@ -5064,7 +5064,7 @@ Aquí hay una variedad de otras configuraciones disponibles a través del archiv @@ -5086,6 +5086,58 @@ Aquí hay una variedad de otras configuraciones disponibles a través del archiv Esta configuración **no** habilita ni deshabilita esta función del agente. + + +
- Archivo de configuración, variable de entorno + Variable ambiental
+ + + + + + + + + + + + + + + + + + + + + + + + + +
+ Tipo + + Booleano +
+ Por defecto + + false +
+ [Establecer en](#options) + + Variable ambiental +
+ [Variable ambiental](#environment-variables) + + `NEW_RELIC_AZURE_OPERATOR_ENABLED` +
+ + Esta es una configuración informativa que se emplea para informar cuándo se inyecta el agente en una aplicación de contenedor de Microsoft Azure. + + + Esta configuración **no** habilita ni deshabilita esta función del agente. + + ## Heroku diff --git a/src/i18n/content/es/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice.mdx b/src/i18n/content/es/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice.mdx new file mode 100644 index 00000000000..3732ecfa867 --- /dev/null +++ b/src/i18n/content/es/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice.mdx @@ -0,0 +1,154 @@ +--- +title: Instalar el agente de Python en las aplicaciones de contenedor y App Service Microsoft Azure +metaDescription: How to install APM for Python on Microsoft Azure App Services and Container Apps. +freshnessValidatedDate: never +translationType: machine +--- + +Microsoft Azure ofrece dos servicios de plataforma que gestionan sus aplicaciones sitio web o en contenedores. Puede instalar el agente de Python tanto en [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview) como en [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), lo que le permitirá realizar un seguimiento de sus aplicaciones de Python gestionadas por Azure en New Relic. + + + Si está buscando una manera de integrar New Relic en su aplicación hospedada en Azure sin modificar el código de su aplicación, [este tutorial](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration) le proporciona esa solución. + + +## Compatibilidad y requisitos [#compatibility-requirements] + +Antes de instalar el agente de Python, recomendamos: + +* Revisión de la [documentación de compatibilidad y requisitos](/docs/agents/python-agent/getting-started/compatibility-requirements-python-agent)del agente Python +* Configuración de una aplicación Python en una (o ambas) de las plataformas gestionadas de Azure +* Instalación de la [CLI de Azure](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-macos) en su entorno + + + Tenga en cuenta que el agente de Python no captura telemetría para Azure Functions sin nuestra integración. Recomendamos instalar la [integración de monitoreoAzure Functions ](/docs/infrastructure/microsoft-azure-integrations/azure-integrations-list/azure-functions-monitoring-integration/)si desea recopilar datos sobre Azure Functions. + + +## Instalar el agente de Python en Azure App Service o contenedor Apps [#install-python] + + + + ## Agregue el agente de Python a su aplicación de Azure [#add-python-agent] + + Para agregar el agente Python de New Relic a su aplicación de Azure, agregue `newrelic` a su archivo `requirements.txt` : + + ```bash + foo@bar:~$ cat requirements.txt + newrelic + flask + ``` + + + + ## Inicializar el agente [#initialize-agent] + + El agente se puede inicializar inicializando manualmente la aplicación o agregando un punto de entrada New Relic en el Dockerfile: + + + + Actualice el código de su aplicación para importar `newrelic.agent`, luego agregue la función `newrelic.agent.initialize()` para inicializar el agente. + + A continuación se muestra un ejemplo de aplicación Flask con el agente inicializado: + + ```python + # app.py + # Run with command "flask run" + + import newrelic.agent # ADDED + from flask import Flask + + newrelic.agent.initialize() # ADDED + + app = Flask(__name__) + + @app.route('/') + def hello_world(): + return "Hello, fellow humans!" + + if __name__ == '__main__': + app.run() + ``` + + + + Si está empleando un Dockerfile, agregue `newrelic-admin run-program` como punto de entrada a su script de inicio. + + ```go + COPY requirements.txt . + COPY app.py . + + RUN pip install -r requirements.txt + + EXPOSE 5000 + + ENTRYPOINT ["newrelic-admin", "run-program"] + CMD ["flask", "run"] + ``` + + + + + + ## Configurar los ajustes de Azure [#azure-settings] + + Una vez que instaló el agente de Python, le recomendamos configurar su aplicación en el portal de Azure App Service o de Contenedor Apps, según el servicio que esté empleando. Puede actualizar la configuración de su aplicación a través de la UI de Azure o usando la CLI de Python. + + + + 1. Inicia sesión en **[portal.azure.com](https://portal.azure.com)**. + 2. Seleccione **App Services > (select a Python app) > Settings > Environment variables**. + 3. Agregue lo siguiente al **App settings**: + + * `NEW_RELIC_APP_NAME`:El nombre de su sitio web de Linux Azure + * `NEW_RELIC_LICENSE_KEY`: Tu New Relic + + 4. Guarde su configuración. + 5. Resetear su aplicación Python. + + + + 1. Inicia sesión en **[portal.azure.com](https://portal.azure.com)**. + 2. Seleccione **Container Apps > (select a Python app) > Containers > Environment variables**. + 3. Agregue lo siguiente al **Container settings**: + + * `NEW_RELIC_APP_NAME`:El nombre de su sitio web de Linux Azure + * `NEW_RELIC_LICENSE_KEY`: Tu New Relic + + 4. Guarde su configuración. + 5. Resetear su aplicación Python. + + Genere algo de tráfico hacia su aplicación y espere unos minutos. Puedes ver tus datos yendo a **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM & services > (select your app)**. + + + + Ejecute lo siguiente en la línea de comando: + + ```bash + az webapp config appsettings set --name ${WEB_APP_NAME} --settings NEW_RELIC_LICENSE_KEY=${NEW_RELIC_LICENSE_KEY} NEW_RELIC_APP_NAME=${NEW_RELIC_APP_NAME} + ``` + + + + Ejecute lo siguiente en la línea de comando: + + ```bash + az containerapp update --name ${CONTAINER_APP_NAME} --set-env-vars "NEW_RELIC_APP_NAME=${NEW_RELIC_APP_NAME}" "NEW_RELIC_LICENSE_KEY=${NEW_RELIC_LICENSE_KEY}" + ``` + + Si se permiten varias réplicas, el comando anterior creará una nueva. De lo contrario, será necesario resetear la réplica del contenedor. Para ello, busque el nombre de la réplica y úselo para resetear: + + ```bash + az containerapp revision list --name ${CONTAINER_APP_NAME} -o table + az containerapp revision restart --revision [Revision name from list generated above] + ``` + + + + + +## ¿Que sigue? [#whats-next] + +Ahora que está recopilando datos de sus aplicaciones Python gestionadas por Azure, puede: + +* Consulta nuestra documentación para aprender [cómo consultar tus datos New Relic ](/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data). +* Aprenda cómo [crear su primera alerta](/docs/alerts/create-alert/create-alert-condition/alert-conditions). +* Puede [comenzar a emplear el panel de control](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards) para aprender a crear visualizaciones personalizadas sobre su entorno. \ No newline at end of file diff --git a/src/i18n/content/es/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx b/src/i18n/content/es/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx new file mode 100644 index 00000000000..4235987ccf3 --- /dev/null +++ b/src/i18n/content/es/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx @@ -0,0 +1,303 @@ +--- +title: Integrar el agente de Python en las aplicaciones contenedoras Microsoft Azure y App Service +metaDescription: How to integrate APM for Python on Microsoft Azure App Services and Container Apps +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). + + +Este documento proporciona soluciones para la integración de New Relic en la aplicación Python alojada en Azure sin tener que modificar el código de la aplicación. Hay dos instancias admitidas de esta capacidad: + +* [Aplicaciones de Azure Container](https://learn.microsoft.com/en-us/azure/container-apps/overview) +* [Servicio de aplicaciones Microsoft Azure](https://learn.microsoft.com/en-us/azure/app-service/overview), mediante código + +El soporte para la integración de New Relic para App Services mediante imágenes en contenedores no está disponible. + +## Compatibilidad y requisitos [#compatibility-requirements] + +Antes de comenzar, te recomendamos lo siguiente: + +* Comenzando con una App contenedora o App Service que se implementó +* Instalación de la [CLI de Azure](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-macos) en su entorno si no emplea el Portal de Azure + + + Tenga en cuenta que el agente de Python no captura telemetría para Azure Functions sin nuestra integración. Recomendamos instalar la [integración de monitoreoAzure Functions ](/docs/infrastructure/microsoft-azure-integrations/azure-integrations-list/azure-functions-monitoring-integration/)si desea recopilar datos sobre Azure Functions. + + +## Integrar el agente Python en las aplicaciones de contenedor [#integrate-agent-container-app] + +En ciertos casos, una aplicación gestionada a través de [Azure Contenedor Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview) ya tiene una imagen que el usuario no puede modificar (o el usuario simplemente puede no querer modificar la aplicación). Esto proporciona una manera de integrar New Relic en el entorno sin tener que realizar ninguna modificación en el código que crea la imagen en contenedor. + +Esto se puede hacer a través del Portal de Azure o la CLI de Azure. + + + + + + ### Agregar [New Relic clave de licencia](docs/apis/intro-apis/new-relic-api-keys/#license-key) [#add-license-key-portal] + + Este paso es opcional pero muy recomendable. + + Si no se creó [Azure Key Vault](https://azure.microsoft.com/en-us/products/key-vault) , siga [esta guía de inicio rápido](https://learn.microsoft.com/en-us/azure/key-vault/general/quick-create-portal). + + 1. Seleccione **Container Apps > (select a Python app) > Settings > Secrets**. + 2. Agrega un secreto. Dale un nombre al secreto, selecciona "Referencia de Key Vault" y agrega tu clave de licencia. + 3. Guarde sus cambios. + + + + ### Vincular un recurso compartido de archivos de Azure a una aplicación de contenedor [#add-volume-portal] + + Cree un [recurso compartido de archivos de Azure](https://learn.microsoft.com/en-us/azure/storage/files/storage-files-introduction) siguiendo [este tutorial de inicio rápido](https://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-portal?tabs=azure-portal). + + 1. Seleccione **Container Apps > (select a Python app) > Application > Containers**. + 2. Seleccione “Editar y desplegar” + 3. Vaya a la pestaña "Volúmenes" y haga clic en "(+) Agregar" + 4. Seleccione "Volumen de archivo de Azure", complete el nombre del volumen deseado y seleccione el recurso compartido de archivos creado anteriormente. + 5. Guarde sus cambios. + + + + ### Agregar y configurar el contenedor init [#init-container-setup-portal] + + 1. Seleccione **Container Apps > (select a Python app) > Application > Containers**. + + 2. En la sección “imagen del contenedor”, haga clic en “Agregar” y seleccione “Iniciar contenedor” + + 3. Introduzca lo siguiente: + + * Nombre del contenedor de inicio deseado + * Docker Hub u otros registros" para "Fuente de la imagen" + * `newrelic/newrelic-python-init` en "Imagen y etiqueta" + * `/bin/sh` para "Anular comando" + * `-c, cp -r /instrumentation /mnt/` para "Los argumentos prevalecen" + * Núcleos de CPU y memoria deseados. Este no debe exceder el del contenedor primario. + + 4. Vaya a la pestaña "Montajes de volumen" y seleccione el montaje de volumen creado en los pasos anteriores. La ruta de montaje debe ser `/mnt/instrumentation`. + + 5. Guarde sus cambios. + + + + ### Vincular New Relic a la aplicación principal [#link-nr-to-app-portal] + + 1. Seleccione **Container Apps > (select a Python app) > Application > Containers**. + + 2. En la sección "Imagen del contenedor", seleccione la aplicación principal y haga clic en "Editar" + + 3. Vaya a la pestaña "Variables de entorno" e ingrese lo siguiente: + + * `NEW_RELIC_APP_NAME`: \[nombre de la aplicación deseada] + * `PYTHONPATH`: `/mnt/instrumentation` + * `NEW_RELIC_AZURE_OPERATOR_ENABLED`: `True` + * `NEW_RELIC_LICENSE_KEY` > Hacer referencia a un secreto > seleccione el nombre del secreto del Paso 1 (o ingrese manualmente la clave de licencia) + + 4. Vaya a la pestaña "Montajes de volumen" y seleccione el montaje de volumen creado en el Paso 2. La ruta de montaje debe ser `/mnt/instrumentation`. + + 5. Guarde sus cambios. + + + Esto debería volver a desplegar la aplicación contenedor. Espere unos minutos hasta que el contenedor de inicio termine de ejecutar. + + + + + + + ### Agregar clave de licencia de New Relic a Azure Key Vault [#add-license-key-cli] + + Este paso es opcional pero muy recomendable. + + Si no se creó [Azure Key Vault](https://azure.microsoft.com/en-us/products/key-vault) , siga [este tutorial de inicio rápido](https://learn.microsoft.com/en-us/azure/key-vault/general/quick-create-cli). + + `az containerapp secret set --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --secrets license-key=$NEW_RELIC_LICENSE_KEY` + + + + ### Cree un recurso compartido de archivos de Azure y vincúlelo a una aplicación de contenedor [#add-volume-cli] + + 1. `az storage account create --resource-group $RESOURCE_GROUP --name $STORAGE_ACCOUNT_NAME --location $LOCATION --kind StorageV2 --sku Standard_LRS --enable-large-file-share` + 2. `az storage share-rm create --resource-group $RESOURCE_GROUP --storage-account $STORAGE_ACCOUNT_NAME --name $STORAGE_SHARE_NAME --quota 4096 --enabled-protocols SMB` + 3. `` STORAGE_ACCOUNT_KEY=`az storage account keys list -n $STORAGE_ACCOUNT_NAME --query "[0].value" -o tsv --resource-group $RESOURCE_GROUP` `` + 4. `az containerapp env storage set --access-mode ReadWrite --azure-file-account-name $STORAGE_ACCOUNT_NAME --azure-file-account-key $STORAGE_ACCOUNT_KEY --azure-file-share-name $STORAGE_SHARE_NAME --storage-name $STORAGE_MOUNT_NAME --name $ENVIRONMENT_NAME --resource-group $RESOURCE_GROUP` + + + + ### Agregar variables de entorno [#add-env-vars-cli] + + `az containerapp update --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --set-env-vars "NEW_RELIC_APP_NAME=$NEW_RELIC_APP_NAME" "NEW_RELIC_AZURE_OPERATOR_ENABLED=True" "NEW_RELIC_LICENSE_KEY=secretref:license-key" "PYTHONPATH="/mnt/instrumentation` + + + + ### Vincular New Relic a la aplicación principal [#link-nr-to-app-portal] + + #### Exportar la configuración de la aplicación contenedor + + `az containerapp show --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --output yaml > demoapp.yaml` + + Este archivo producirá un archivo de plantilla parcial que contiene información sobre la aplicación contenedor. Será necesario agregar información adicional para vincular New Relic a la aplicación. + + #### Montar volumen en la aplicación contenedor + + En propiedades > plantilla, habrá una sección llamada `volumes`. En este momento, esto dice `volumes: null`. Reemplazaremos esa línea con estas líneas: + + ```bash + volumes: + - name: $VOLUME_NAME + storageName: $STORAGE_MOUNT_NAME + storageType: AzureFile + ``` + + Donde `$STORAGE_MOUNT_NAME` es lo que se empleó en el Paso 2 y `$VOLUME_NAME` es un nombre de su elección + + #### Agregar contenedor de inicialización + + En propiedades > plantilla, habrá una sección llamada `initContainers`. En este momento, esto dice `initContainers: null`. Reemplazaremos esa línea con estas líneas: + + ```bash + initContainers: + - args: + - -c + - cp -r /instrumentation /mnt/ + command: + - /bin/sh + image: docker.io/newrelic/newrelic-python-init + name: nr-init-container + ``` + + #### Vincular volumen a contenedor + + En propiedades > plantilla, ahora tenemos secciones `containers` y `initContainers` . Dentro de cada una de estas secciones, agregue las siguientes líneas: + + ```bash + volumeMounts: + - mountPath: /mnt/instrumentation + volumeName: $VOLUME_NAME + ``` + + Donde `$VOLUME_NAME` es el nombre elegido anteriormente + + #### Actualizar la aplicación contenedor con nueva configuración + + `az containerapp update --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --yaml demoapp.yaml` + + Esto debería volver a desplegar la aplicación contenedor. Espere unos minutos hasta que el contenedor de inicio termine de ejecutar. + + + + + +## Integrar el agente de Python en Azure App Service [#integrate-agent-app-service] + +Actualmente, App Services solo admite sidecars pero no contenedores de inicio. Hasta que ese soporte esté disponible, se puede emplear este script preconstruido. Nota: Esto solo funciona para App Services que usan código y no para imágenes en contenedores. + +Esto se puede hacer a través del Portal de Azure o la CLI de Azure: + +```bash prebuild.sh +#!/bin/sh +# prebuild.sh + +# Retrieve files to use in startup script: +curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/newrelic_k8s_operator.py > newrelic_k8s_operator.py +curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/requirements-vendor.txt > requirements-vendor.txt +curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/requirements-builder.txt > requirements-builder.txt + +cd /home/ + +pip install -r requirements-builder.txt + +export NEW_RELIC_EXTENSIONS=false +export WRAPT_DISABLE_EXTENSIONS=true + +pip install newrelic --target=./workspace/newrelic + +mkdir -p ./workspace/vendor +pip install --target=./workspace/vendor -r requirements-vendor.txt + +cp ./workspace/* /home/ +cp /home/workspace/newrelic/newrelic/bootstrap/sitecustomize.py /home/sitecustomize.py + +cd /home/site/wwwroot + +# This is the where the application's original startup script goes: +gunicorn app:app +``` + + + + + + ### Subir script de inicio + + Vaya a https://\[NOMBRE\_DE\_SU\_SITIO\_WEBSITE\_LINUX\_AZURE].scm.azurewebsites.net/newui/fileManager y cargue el script `prebuild.sh` en el directorio `/home` + + + + ### Agregar las variables de entorno necesarias + + 1. Seleccione **App Services > (select a Python app) > Settings > Environment variables**. + + 2. Agregue lo siguiente al **App settings**: + + * `NEW_RELIC_APP_NAME`:El nombre de su sitio web de Linux Azure + * `NEW_RELIC_LICENSE_KEY`: Tu New Relic + * `PYTHONPATH`: `/home:/home/workspace/newrelic` + * `NEW_RELIC_AZURE_OPERATOR_ENABLED`: `True` + + 3. Guarde su configuración. + + Si se desea una versión específica del agente, agregue la variable de entorno `AGENT_VERSION` con el número de versión, precedido por `v` (por ejemplo, `v10.0.0`). + + + + ### Agregar `prebuild.sh` como configuración de archivo de inicio + + 1. Seleccione **App Services > (select a Python app) > Settings > Configuration**. + 2. Agrega lo siguiente a **Startup Command**: `/home/prebuild.sh` + 3. Almacene su configuración. Esto debería volver a implementar la aplicación. + + Esto tomará unos minutos. + + + + + + + + ### Subir script de inicio + + `az webapp deploy --resource-group ${RESOURCE_GROUP} --name ${WEB_APP_NAME} --src-path prebuild.sh --target-path /home/prebuild.sh --type=static` + + + + ### Agregar las variables de entorno necesarias + + `az webapp config appsettings set --name ${WEB_APP_NAME} --resource-group ${RESOURCE_GROUP} --settings NEW_RELIC_LICENSE_KEY=$NEW_RELIC_LICENSE_KEY NEW_RELIC_AZURE_OPERATOR_ENABLED=true NEW_RELIC_APP_NAME="Azure Service App" PYTHONPATH="/home:/home/workspace/newrelic"` + + Si se desea una versión específica del agente, agregue la variable de entorno `AGENT_VERSION` con el número de versión, precedido por `v` (por ejemplo, `v10.0.0`) como se muestra en el siguiente ejemplo: + + `az webapp config appsettings set --name ${WEB_APP_NAME} --resource-group ${RESOURCE_GROUP} --settings AGENT_VERSION=v10.0.0` + + + + ### Agregar `prebuild.sh` como configuración de archivo de inicio + + `az webapp config set --resource-group ${RESOURCE_GROUP} --name ${WEB_APP_NAME} --startup-file "/home/prebuild.sh"` + + Esto tomará unos minutos. + + + + + +### Resolución de problemas [#troubleshooting] + +En algunos casos, la telemetría puede no estar disponible, o que el script `prebuild.sh` pueda provocar que la aplicación existente no pueda volver a desplegar. Para solucionar esto, habilite estas variables de entorno: + +* `SCM_DO_BUILD_DURING_DEVELOPMENT`: `True` +* `ENABLE_ORYX_BUILD`: `True` \ No newline at end of file diff --git a/src/i18n/content/es/docs/new-relic-solutions/get-started/glossary.mdx b/src/i18n/content/es/docs/new-relic-solutions/get-started/glossary.mdx index d27c305cbe8..30db0dbd8de 100644 --- a/src/i18n/content/es/docs/new-relic-solutions/get-started/glossary.mdx +++ b/src/i18n/content/es/docs/new-relic-solutions/get-started/glossary.mdx @@ -187,7 +187,7 @@ Ya sea que esté considerando New Relic o ya esté utilizando nuestras capacidad Para obtener información sobre qué navegador admite New Relic, consulte [Navegador compatible](/docs/site/supported-browsers). - + Mide la velocidad y el rendimiento de su usuario final mientras navega a su sitio desde diferentes navegadores web, dispositivos, sistemas operativos y redes. Para obtener más información, consulte [Introducción al monitoreo del navegador](/docs/browser/browser-monitoring/getting-started/introduction-browser-monitoring/). @@ -374,7 +374,7 @@ Ya sea que esté considerando New Relic o ya esté utilizando nuestras capacidad En el contexto de alertas, se genera un **incident** cuando se exceden las condiciones definidas en una política de alertas. Un registro de incidentes incluye todas las marcas de tiempo de apertura y cierre de cada incidente, así como instantáneas de los gráficos de los datos que se evalúan en torno al momento de cada incidente. - Puede ver información detallada en las [páginas**Incidents** ](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history)de la interfaz de usuario. También puede [seleccionar su preferencia](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/specify-when-new-relic-creates-incidents) sobre cómo acumulamos el incidente. + Puede ver información detallada de las [páginas**Incidents** ](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history)en la interfaz de usuario. También puede [seleccionar su preferencia](/docs/alerts/organize-alerts/specify-when-alerts-create-incidents/) sobre cómo gestionamos los incidentes. Para obtener una explicación de cómo se relaciona un incidente con otros conceptos básicos de alerta, consulte [Conceptos y flujo de trabajo](/docs/alerts-applied-intelligence/overview/#concepts-terms). diff --git a/src/i18n/content/es/docs/new-relic-solutions/get-started/networks.mdx b/src/i18n/content/es/docs/new-relic-solutions/get-started/networks.mdx index d12fbf8ac14..a565f19cc06 100644 --- a/src/i18n/content/es/docs/new-relic-solutions/get-started/networks.mdx +++ b/src/i18n/content/es/docs/new-relic-solutions/get-started/networks.mdx @@ -145,7 +145,7 @@ Para obtener más detalles sobre agentes e integración específicos, y sobre pu - `bam.nr-data.net` + `bam.nr-data.net`
`bam-cell.nr-data.net` @@ -425,6 +425,7 @@ Los extremos de telemetría en la tabla anterior se incluyen a continuación en * `aws-api.newrelic.com` * `cloud-collector.newrelic.com` * `bam.nr-data.net` + * `bam-cell.nr-data.net` * `csec.nr-data.net` * `insights-collector.newrelic.com` * `log-api.newrelic.com` diff --git a/src/i18n/content/es/docs/nrql/nrql-syntax-clauses-functions.mdx b/src/i18n/content/es/docs/nrql/nrql-syntax-clauses-functions.mdx index 84a9b2358f7..3ecfd7d9ba5 100644 --- a/src/i18n/content/es/docs/nrql/nrql-syntax-clauses-functions.mdx +++ b/src/i18n/content/es/docs/nrql/nrql-syntax-clauses-functions.mdx @@ -1825,10 +1825,6 @@ SELECT histogram(duration, 10, 20) FROM PageView SINCE 1 week ago > Emplee la función `median()` para devolver la mediana de un atributo o el percentil 50. Para obtener más información sobre percentil consulta, consulte [`percentile()`](#func-percentile). - - La consulta `median()` solo está disponible cuando se utiliza el [generador de consultas](/docs/chart-builder/use-chart-builder/get-started/introduction-chart-builder). - - Esta consulta generará un gráfico de líneas para el valor mediano. diff --git a/src/i18n/content/jp/docs/alerts/admin/rules-limits-alerts.mdx b/src/i18n/content/jp/docs/alerts/admin/rules-limits-alerts.mdx index 730e2ebac47..4a18214c15d 100644 --- a/src/i18n/content/jp/docs/alerts/admin/rules-limits-alerts.mdx +++ b/src/i18n/content/jp/docs/alerts/admin/rules-limits-alerts.mdx @@ -7,7 +7,7 @@ freshnessValidatedDate: never translationType: machine --- -New Relic に関する制限とルール: +New Relic に関する制限とルール: 該当なし @@ -42,14 +42,14 @@ New Relic に関する制限とルール: - + - + - [アラートポリシー名](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/name-or-rename-alert-policy) + [アラートポリシー名](/docs/alerts/organize-alerts/create-edit-or-find-alert-policy/) @@ -82,9 +82,9 @@ New Relic に関する制限とルール: - + - + @@ -196,9 +196,9 @@ New Relic に関する制限とルール: - + - + @@ -206,7 +206,7 @@ New Relic に関する制限とルール: [カスタム インシデントの説明](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/alert-custom-incident-descriptions) - + 4000文字 @@ -268,9 +268,9 @@ New Relic に関する制限とルール: - + - + @@ -308,9 +308,9 @@ New Relic に関する制限とルール: - + - + @@ -353,4 +353,4 @@ FACET conditionId 制限の引き上げをリクエストするには、New Relic アカウント担当者にお問い合わせください。 -[スライディング ウィンドウ](/docs/query-your-data/nrql-new-relic-query-language/nrql-query-tutorials/create-smoother-charts-sliding-windows) を使用すると、データ ポイントの数が大幅に増加する可能性があることに注意してください。生成されるデータ ポイントの数を減らすために、スライディング ウィンドウ集計の期間を長くすることを検討してください。 +[スライディング ウィンドウ](/docs/query-your-data/nrql-new-relic-query-language/nrql-query-tutorials/create-smoother-charts-sliding-windows) を使用すると、データ ポイントの数が大幅に増加する可能性があることに注意してください。生成されるデータ ポイントの数を減らすために、スライディング ウィンドウ集計の期間を長くすることを検討してください。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx b/src/i18n/content/jp/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx index 15879f34cfe..42e84cb7b0e 100644 --- a/src/i18n/content/jp/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx +++ b/src/i18n/content/jp/docs/alerts/create-alert/examples/view-entity-health-status-find-entities-without-alert-conditions.mdx @@ -8,19 +8,10 @@ freshnessValidatedDate: never translationType: machine --- -を使用すると、エンティティ (通知のターゲット) に 1 つ以上の条件が関連付けられているかどうかを簡単に判断できます。 +を使用すると、エンティティ (通知のターゲット) に 1 つ以上の条件が関連付けられているかどうかを簡単に判断できます。 -* - **yes** - - - の場合、選択したインデックス ( APM 、 browserなど) の稼働ステータス インジケーターが現在の状態に応じて色分けされます。 現在のアラートインシデントの概要を表示するには、稼働ステータス インジケーターの上にマウスを置きます。 - -* - **no** - - - の場合、選択したインデックスの稼働ステータス インジケーターが灰色で表示されます。 +* **yes** の場合、選択したインデックス ( APM 、 browserなど) の稼働ステータス インジケーターが現在の状態に応じて色分けされます。 現在のアラートインシデントの概要を表示するには、稼働ステータス インジケーターの上にマウスを置きます。 +* **no**の場合、選択したインデックスの稼働ステータス インジケーターが灰色で表示されます。 条件とポリシーがどのように連携するかについて詳しくは、 [「アラートの概念と用語」](/docs/alerts-applied-intelligence/overview/#concepts-terms)を参照してください。 @@ -35,7 +26,7 @@ translationType: machine ## 色分けされた健康状態 [#colors] -New Relicのインスタンスは、稼働ステータスによって自動的に色分けされます。 たとえば、 アプリの健全性を表示するには、 **[one.newrelic.com](https://one.newrelic.com/all-capabilities)**に移動して**APM**をクリックします。 **Applications**インデックスには、すべての製品エンタープライズと現在の稼働ステータスがリストされます。 +New Relicのインスタンスは、稼働ステータスによって自動的に色分けされます。 たとえば、 アプリの健全性を表示するには、 **[one.newrelic.com](https://one.newrelic.com/all-capabilities)**に移動して**APM**をクリックします。 **Applications**インデックスには、すべての製品エンタープライズと現在の稼働ステータスがリストされます。 @@ -57,11 +48,7 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -73,11 +60,7 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -89,11 +72,7 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -101,25 +80,14 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -161,21 +129,13 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -187,29 +147,17 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -228,29 +176,17 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -262,29 +198,17 @@ New Relicのインスタンスは、稼働ステータスによって自動的 @@ -298,13 +222,9 @@ New Relicのインスタンスは、稼働ステータスによって自動的 ## 例：条件のないアプリ [#example-v3-no-policies] -以下は、 **is not**が任意の条件に関連付けられている、 インデックスにリストされているアプリの例です。 稼働ステータスの色分けは薄い灰色で、これは現在 エンタープライズ を対象とする条件がないか、エンタープライズ の条件が現在一貫した信号を生成していないことを示します。 +以下は、 **is not**が任意の条件に関連付けられている、 インデックスにリストされているアプリの例です。 稼働ステータスの色分けは薄い灰色で、これは現在 エンタープライズ を対象とする条件がないか、エンタープライズ の条件が現在一貫した信号を生成していないことを示します。 -032715crop-events-no-v3.png +032715crop-events-no-v3.png
**[one.newrelic.com](https://one.newrelic.com/all-capabilities)**に移動し、 **Explorer**をクリックします。この例では、現在どのアラート条件にも関連付けられていないアプリが表示されています。 @@ -314,13 +234,9 @@ New Relicのインスタンスは、稼働ステータスによって自動的 ## 例：条件付きのアプリ [#example-v3-yes-policies] -以下は、1 つ以上の条件に関連付けられた**is**のインデックスにリストされているアプリの例です。 稼働ステータスの色分けは緑色です。これは、稼働ステータスに関するデータが収集されており、現在、警告 (黄色) またはクリティカル (赤色) の稼働ステータスがないためです。 +以下は、1 つ以上の条件に関連付けられた**is**のインデックスにリストされているアプリの例です。 稼働ステータスの色分けは緑色です。これは、稼働ステータスに関するデータが収集されており、現在、警告 (黄色) またはクリティカル (赤色) の稼働ステータスがないためです。 -032715crop-events-green.png +032715crop-events-green.png
**[one.newrelic.com](https://one.newrelic.com/all-capabilities)**に移動し、 **Explorer**をクリックします。この例では、1 つ以上の条件を持つアプリを示しています。 色分けされた稼働ステータス (緑) は、アプリが閾値を超えていないことを示します。 @@ -328,4 +244,4 @@ New Relicのインスタンスは、稼働ステータスによって自動的 このエンティティだけでなく、すべての製品にわたって現在[オープンなインシデント](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history)をリストするインデックスを表示するには、 **View all incidents**を選択します。 - + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/alerts/incident-management/view-event-details-incidents.mdx b/src/i18n/content/jp/docs/alerts/incident-management/view-event-details-incidents.mdx index adc58c16db0..46cd8f7faee 100644 --- a/src/i18n/content/jp/docs/alerts/incident-management/view-event-details-incidents.mdx +++ b/src/i18n/content/jp/docs/alerts/incident-management/view-event-details-incidents.mdx @@ -22,7 +22,7 @@ translationType: machine ## インシデントのインデックスとインシデントの詳細を表示する [#view-incidents] -インシデントはインシデントにグループ化されます。 インシデントのグループ化方法を変更する場合は、関連するポリシーを開いて[**Incident preference**](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/specify-when-new-relic-creates-incidents)設定を変更します。 +インシデントはインシデントにグループ化されます。 インシデントのグループ化方法を変更する場合は、関連するポリシーを開いて[**Incident preference**](/docs/alerts/organize-alerts/specify-when-alerts-create-incidents/)設定を変更します。 インシデントの詳細を表示するには: diff --git a/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-manage-users.mdx b/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-manage-users.mdx index 2804b0cf556..082a5128cc5 100644 --- a/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-manage-users.mdx +++ b/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-manage-users.mdx @@ -19,20 +19,7 @@ NerdGraph を介してユーザーを管理するためのいくつかの要件: * これは[、新しいユーザー モデル](/docs/accounts/original-accounts-billing/original-users-roles/overview-user-models#determine-user-model)でユーザーを管理するためのものです。その他の権限関連の要件: * 必要な[ユーザー タイプ](/docs/accounts/accounts-billing/new-relic-one-user-management/user-type): コア ユーザーまたはフル プラットフォーム ユーザー。 - - * 必要な[管理設定](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts#admin-settings): ユーザーを表示および変更するには - - - **Authentication domain settings** - - - 必要です。 組織レベルで表示および変更するには、 - - - **Organization settings** - - - 必要です。 + * 必要な[管理設定](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts#admin-settings): ユーザーを表示および変更するには**Authentication domain settings**必要です。 組織レベルで表示および変更するには、 **Organization settings**必要です。 ## 始める前に [#concepts] @@ -56,7 +43,7 @@ NerdGraph を使用してユーザーを管理する前に、いくつかの重 組織内のすべての[ユーザー タイプ](/docs/accounts/accounts-billing/new-relic-one-user-management/user-type)を表示するクエリの例を次に示します。 -``` +```graphql { actor { organization { @@ -106,11 +93,14 @@ NerdGraph を使用してユーザーを管理する前に、いくつかの重 ```graphql mutation { - userManagementCreateUser(createUserOptions: { - authenticationDomainId: "YOUR_AUTH_DOMAIN_ID", - email: "EMAIL_OF_YOUR_USER", - name: "NAME_OF_YOUR_USER", - userType: BASIC_USER_TIER}) { + userManagementCreateUser( + createUserOptions: { + authenticationDomainId: "YOUR_AUTH_DOMAIN_ID" + email: "EMAIL_OF_YOUR_USER" + name: "NAME_OF_YOUR_USER" + userType: BASIC_USER_TIER + } + ) { createdUser { authenticationDomainId email @@ -127,7 +117,7 @@ mutation { 手動でプロビジョニングされたユーザー用に設定されていない認証ドメイン内でユーザーを作成しようとした場合のエラー応答の例を次に示します。 -``` +```json { "data": { "userManagementCreateUser": null @@ -142,7 +132,7 @@ mutation { 認証ドメインに既に存在するユーザーを作成しようとしたときのエラー応答の例を次に示します。 -``` +```json { "data": { "userManagementCreateUser": null @@ -161,7 +151,9 @@ mutation { ```graphql mutation { - userManagementUpdateUser(updateUserOptions: {id: "ID_OF_YOUR_USER", userType: FULL_USER_TIER}) { + userManagementUpdateUser( + updateUserOptions: { id: "ID_OF_YOUR_USER", userType: FULL_USER_TIER } + ) { user { id type { @@ -177,7 +169,9 @@ mutation { ```graphql mutation { - userManagementUpdateUser(updateUserOptions: {id: "ID_OF_YOUR_USER", email: "EMAIL_OF_YOUR_USER"}) { + userManagementUpdateUser( + updateUserOptions: { id: "ID_OF_YOUR_USER", email: "EMAIL_OF_YOUR_USER" } + ) { user { id email @@ -194,9 +188,11 @@ mutation { ユーザーを削除する例を次に示します。 -``` +```graphql mutation { - userManagementDeleteUser(deleteUserOptions: {id: "ID_OF_YOUR_USER"}) { + userManagementDeleteUser( + deleteUserOptions: { id: "ID_OF_YOUR_USER" } + ) { deletedUser { id } @@ -206,7 +202,7 @@ mutation { SCIM でプロビジョニングされた認証ドメインでユーザーを削除しようとしたときのエラー応答の例を次に示します。 -``` +```json { "data": { "userManagementDeleteuser": null @@ -254,7 +250,7 @@ SCIM でプロビジョニングされた認証ドメインでユーザーを削 組織のすべての認証ドメインのページ分割されたリターンを開始する例を次に示します。 -``` +```graphql { actor { organization { @@ -275,4 +271,4 @@ SCIM でプロビジョニングされた認証ドメインでユーザーを削 ## グループを管理する [#manage-groups] -グループを管理する方法、およびグループからユーザーを追加および削除する方法については、 グループの[管理](/docs/apis/nerdgraph/examples/nerdgraph-user-mgmt)を参照してください。 +グループを管理する方法、およびグループからユーザーを追加および削除する方法については、 グループの[管理](/docs/apis/nerdgraph/examples/nerdgraph-user-mgmt)を参照してください。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-tagging-api-tutorial.mdx b/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-tagging-api-tutorial.mdx index 273a05083c3..21fa1dab767 100644 --- a/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-tagging-api-tutorial.mdx +++ b/src/i18n/content/jp/docs/apis/nerdgraph/examples/nerdgraph-tagging-api-tutorial.mdx @@ -25,7 +25,7 @@ translationType: machine この例では、エンティティは`Cookie Checkout`というブラウザアプリです。 -``` +```graphql { actor { entitySearch(query: "name like 'Cookie Checkout'") { @@ -49,28 +49,22 @@ translationType: machine エンティティに新しいタグを追加するには 1. [api.newrelic.com/graphiql](https://api.newrelic.com/graphiql) の NerdGraph GraphiQL エクスプローラーにアクセスします。 - 2. [`entitySearch()`](/docs/apis/graphql-api/tutorials/use-new-relic-graphql-api-query-entities#search-entity)を使用して、タグ付けするエンティティのGUIDを見つけます。 - 3. `taggingAddTagsToEntity`ミューテーションを使用して、値を持つタグをエンティティに追加します。 - -4. ために - - - - 新しいタグを追加した後に再起動が必要です。 +4. エージェントの場合、新しいタグを追加した後は再起動が必要です。 この例では、UIチームが所有する`Cookie Checkout`というブラウザアプリケーションがあります。このインスタンスに`ui`値の`team`タグを追加します。タグが追加されると、タグ`team:ui`でフィルタリングし、NewRelicUIで`Cookie Checkout`アプリを見つけることができます。 -``` +```graphql mutation { - taggingAddTagsToEntity( - guid: "ENTITY_GUID", - tags: { key: "team", values: ["ui"]}) { - errors { - message - } - } + taggingAddTagsToEntity( + guid: "ENTITY_GUID" + tags: { key: "team", values: ["ui"] } + ) { + errors { + message + } + } } ``` @@ -79,28 +73,22 @@ mutation { エンティティからタグとそれに関連するすべての値を削除するには 1. [api.newrelic.com/graphiql](https://api.newrelic.com/graphiql) の NerdGraph GraphiQL エクスプローラーにアクセスします。 - 2. [`entitySearch()`](/docs/apis/graphql-api/tutorials/use-new-relic-graphql-api-query-entities#search-entity)を使用して、削除するタグを持つエンティティのGUIDを見つけます。 - 3. `taggingDeleteTagFromEntity`ミューテーションを使用します。 - -4. ために - - - - タグの変更後に再起動が必要です。 +4. エージェントの場合、タグを変更した後に再起動が必要です。 次のミューテーションの例では、エンティティから`team`タグを削除します。 -``` +```graphql mutation { - taggingDeleteTagFromEntity( - guid: "ENTITY_GUID", - tagKeys: ["team"]) { - errors { - message - } - } + taggingDeleteTagFromEntity( + guid: "ENTITY_GUID", + tagKeys: ["team"] + ) { + errors { + message + } + } } ``` @@ -114,15 +102,16 @@ mutation { 次の例のミューテーションは、 `tag`キーから`ui`値を削除します。 -``` +```graphql mutation { - taggingDeleteTagValuesFromEntity( - guid: "ENTITY_GUID", - tagValues: [{key: "team" value: "ui"}]) { - errors { - message - } - } + taggingDeleteTagValuesFromEntity( + guid: "ENTITY_GUID" + tagValues: [{ key: "team", value: "ui" }] + ) { + errors { + message + } + } } ``` @@ -138,14 +127,15 @@ mutation { この例では、 `Cookie Checkout`ブラウザアプリケーションが`ui`チームから`cookie-dev`チームに転送されました。 `team`のタグ値を次のミューテーションに置き換えることができます。 -``` +```graphql mutation { - taggingReplaceTagsOnEntity( - guid: "ENTITY_GUID", - tags: {key: "team" values: ["cookie-dev"]}) { - errors { - message - } - } + taggingReplaceTagsOnEntity( + guid: "ENTITY_GUID" + tags: { key: "team", values: ["cookie-dev"] } + ) { + errors { + message + } + } } -``` +``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/manage-apm-agents/azure/monitoring-azure-app-service.mdx b/src/i18n/content/jp/docs/apm/agents/manage-apm-agents/azure/monitoring-azure-app-service.mdx new file mode 100644 index 00000000000..949c33bdc91 --- /dev/null +++ b/src/i18n/content/jp/docs/apm/agents/manage-apm-agents/azure/monitoring-azure-app-service.mdx @@ -0,0 +1,94 @@ +--- +title: Azure App Service の監視 +tags: + - Azure + - Agents + - Manage APM agents +metaDescription: Information on how to monitor Azure app services with New Relic agents. +freshnessValidatedDate: never +translationType: machine +--- + +Azure App Service は、 Microsoft Azureが提供するフルマネージドのサービスとしてのプラットフォーム (PaaS) であり、開発者がさまざまなプログラミング言語やフレームワークにわたって Web アプリケーション、モバイル バックエンド、 API迅速かつ効率的に構築、デプロイ、拡張できるようにします。 + +New Relicのアプリケーションパフォーマンス監視 ( APMエージェント) を Azure App Service と統合することで、アプリケーションの包括的な監視と最適化を実現できます。 New Relic APMアプリケーションが最高のパフォーマンスを発揮することを保証するために役立つインサイトと実用的なデータを提供します。 次の表は、New RelicによるAzure App Serviceの監視の詳細を示しています。 + +## Azure アプリ サービス向けの New Relic APM 監視機能 [#app-services] + +New Relicアプリケーションモニタリング（ APM ）の一部について Azure App Service 監視をサポートしています。 Azure App Service 監視をセットアップするための手順は、以下の表に記載されています。 + +
- icon-alerts-green.png + icon-alerts-green.png 緑
- icon-alerts-yellow.png + icon-alerts-yellow.png 黄色
- icon-alerts-red.png + icon-alerts-red.png 赤 [重大なしきい値](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/define-thresholds-trigger-alert) を突破しました: - * 選択した[インシデントロールアップ設定](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/specify-when-new-relic-creates-incidents)に基づいて[通知](/docs/alerts/new-relic-alerts-beta/managing-notification-channels/notification-channels-controlling-where-send-alerts)が送信されました。 - - * インシデントは - - - [**Incidents**](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history) - - - [インデックス](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history)に表示されます。 + * 選択された[ インシデント ロールアップ設定](/docs/alerts/organize-alerts/specify-when-alerts-create-incidents/)[ に基づいて 通知](/docs/alerts/new-relic-alerts-beta/managing-notification-channels/notification-channels-controlling-where-send-alerts) が送信されました。 + * インシデントは[**Incidents**インデックス](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history)に表示されます。
- icon-alerts-gray.png + icon-alerts-gray.png グレー
- icon-alerts-gray.png + icon-alerts-gray.png グレー - icon-alerts-green.png + icon-alerts-green.png 緑
- icon-alerts-green.png + icon-alerts-green.png 緑/ - icon-alerts-red.png + icon-alerts-red.png 赤 - icon-alerts-gray.png + icon-alerts-gray.png グレー
- icon-alerts-green.png + icon-alerts-green.png 緑 - icon-alerts-yellow.png + icon-alerts-yellow.png イエロー/ - icon-alerts-red.png + icon-alerts-red.png 赤
- icon-alerts-yellow.png + icon-alerts-yellow.png イエロー/ - icon-alerts-red.png + icon-alerts-red.png 赤 - icon-alerts-green.png + icon-alerts-green.png 緑
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ ランタイム + + OS + + アプリの種類 +
+ Java + + Windows と Linux + + [ウェブアプリ](/install/java/) +
+ .NET + + Windows と Linux + + [ウェブアプリ](/install/dotnet/?deployment=azure&azure=azuresiteextension) +
+ Node.js + + Windows と Linux + + [Docker](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-docker) [を使用した](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-azure-site-extension) Web アプリ 標準インストレーション +
+ Python + + Linux + + [Web アプリとコンテナ アプリ](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice)、または[タッチレス統合](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration)を使用 +
\ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/nodejs-agent/getting-started/monitor-your-nodejs-app.mdx b/src/i18n/content/jp/docs/apm/agents/nodejs-agent/getting-started/monitor-your-nodejs-app.mdx index cf71f5988f5..7b508e43f7b 100644 --- a/src/i18n/content/jp/docs/apm/agents/nodejs-agent/getting-started/monitor-your-nodejs-app.mdx +++ b/src/i18n/content/jp/docs/apm/agents/nodejs-agent/getting-started/monitor-your-nodejs-app.mdx @@ -22,19 +22,13 @@ New RelicでNode.jsアプリケーションの監視をすぐに開始したい 監視対象に応じて、Node.jsエージェントをインストールするためのパスがいくつかあります。 - + Dockerコンテナにエージェントをインストールするには、コマンドラインを使用して次[のセルフガイドの手順](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-docker)に従います。 このプロセスでは、エージェントを`package.json`に追加してから、アプリレベルでNewRelicを要求する手順を説明します。最後に、ライセンスキーとアプリ名を`docker run`に追加して、エージェントがDockerアプリで実行されるようにします。 - + サーバーでホストされているアプリには、いくつかの異なるオプションがあります。 * [ガイド付きインストール](https://one.newrelic.com/marketplace/install-data-source?state=f535d53b-5b84-cd48-80cf-61704ad02e29)では、インストールをいくつかのステップに分けています。コマンドラインとの対話が必要です。 @@ -46,14 +40,15 @@ New RelicでNode.jsアプリケーションの監視をすぐに開始したい アプリを監視する準備ができたら、アプリの起動コマンドに `-r newrelic` を追加して、他のモジュール (例: `node -r newrelic your-program.js`の前にエージェントを要求します。これは、アプリへの root アクセス権がない場合に特に重要です。 - + AWS Lambda 関数のエージェントをインストールするために、 [セルフガイドの手順](https://one.newrelic.com/marketplace/install-data-source?state=9aa3d004-6f13-1477-604e-b6a2d6bb992d)で、AWS を自動的に構成するセットアップ スクリプトが提供されます。 コマンドラインによる手動インストールをご希望の場合は、現在、 [Lambda モニタリング用のレガシー インストルメンテーション](/docs/serverless-function-monitoring/aws-lambda-monitoring/enable-lambda-monitoring/enable-serverless-monitoring-aws-lambda-legacy/#node)のオプションがあります。 + + + Windows 環境でアプリ デプロイの Azure Web アプリをコードとして計装したい場合は、New Relic[ Azure](/docs/agents/nodejs-agent/hosting-services/nodejs-agent-microsoft-azure) Node エージェント サイト拡張機能 を使用して ノードエージェントを簡単にインストールして構成できます。 + ## 次は何ですか？ [#next] @@ -61,19 +56,8 @@ New RelicでNode.jsアプリケーションの監視をすぐに開始したい これで、アプリをインストルメント化し、次のステップが必要になりました。あなたは考えるかもしれません： * [Node.jsエージェントの構成](/docs/apm/agents/nodejs-agent/installation-configuration/nodejs-agent-configuration) - * [カスタムメトリックの作成](/docs/apm/agents/nodejs-agent/extend-your-instrumentation/nodejs-custom-metrics) - * [Node.js仮想マシン（V8）からのデータの取得](/docs/apm/agents/nodejs-agent/extend-your-instrumentation/nodejs-vm-measurements) - * [カスタムインストルメンテーションAPI](/docs/apm/agents/nodejs-agent/extend-your-instrumentation/nodejs-custom-instrumentation)を使用してインストルメンテーションを拡張する - * [カスタムトランザクションパラメータ、エラー、およびメトリックを使用](/docs/apm/agents/nodejs-agent/api-guides/guide-using-nodejs-agent-api)した機能の拡張 - -* Node.jsエージェントで - - - [](/docs/apm/agents/nodejs-agent/extend-your-instrumentation/browser-monitoring-nodejs-agent) - - - 追加しています +* Node.jsエージェントで[](/docs/apm/agents/nodejs-agent/extend-your-instrumentation/browser-monitoring-nodejs-agent)追加しています \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-docker.mdx b/src/i18n/content/jp/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-docker.mdx index 9f2f93995a8..19ea0c240b3 100644 --- a/src/i18n/content/jp/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-docker.mdx +++ b/src/i18n/content/jp/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent-docker.mdx @@ -9,15 +9,17 @@ freshnessValidatedDate: never translationType: machine --- -当社の Node.js エージェントを使用して、Docker コンテナにデプロイされた Node.js アプリケーションをインストルメントすることができます。このドキュメントでは、New Relic でインストルメントされた Docker 化された Node.js アプリケーションを構築、設定、デプロイする方法を説明します。 +Node.js エージェントを使用して、Docker コンテナーで Node.js アプリケーションのデプロイを計装できます。 このドキュメントでは、 New Relicでインストレーションした Dockerized Node.js アプリケーションを構築、構成、デプロイする方法について説明します。 - - Node.js エージェント インストレーションに関する一般的なヘルプが必要な場合は、[メイン インストレーション手順を](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent)参照してください。 - +Node.js エージェント インストレーションに関する一般的なヘルプが必要な場合は、[メイン インストレーション手順を](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-agent)参照してください。 ## コンテナの計測 [#instrument] -既存のDockerfileを少し追加するだけで、弊社のNode.jsエージェントで使用することができます。環境変数を設定した新しいDockerイメージを実行して、エージェントを設定します。 + + Dockerfile または Docker イメージにライセンス キーを含めないでください。詳細については[、ライセンス キーのセキュリティに関するドキュメントを](/docs/accounts/install-new-relic/account-setup/license-key#license-key-security)参照してください。 + + +設定をいくつか変更し、 New Relic環境変数を既存の Dockerfile に追加することで、Node.js エージェントを使用して Docker 化されたアプリを計装できます。 1. `newrelic`を`package.json`に追加します。 @@ -25,49 +27,51 @@ translationType: machine "newrelic": "latest", ``` - 特定のバージョンをインストールするか、 [`package.json`形式](https://docs.npmjs.com/files/package.json#dependencies)で提供されるその他のオプションを使用してください。過去のエージェント バージョンについて[は、Node.js エージェントのリリース ノート](/docs/release-notes/agent-release-notes/nodejs-release-notes)を確認してください。 - -2. コンテナの設定方法に応じて、 `node -r newrelic YOUR_PROGRAM.js`を実行して、最初に Node.js `-r`/`--require` フラグを使用して `newrelic` モジュールを含めるように `ENTRYPOINT` を編集できます。プログラムの実行方法を制御できない場合は、 `require('newrelic')`を追加することで、プログラム内の他のモジュールよりも前に `newrelic` モジュールをロードできます。 + 値`latest`更新して特定のバージョンをインストールするか、 [`package.json`形式](https://docs.npmjs.com/files/package.json#dependencies)で提供される他のオプションのいずれかを使用できます。 過去のエージェント バージョンに関する情報については、 [Node.js エージェントのリリース ノート](/docs/release-notes/agent-release-notes/nodejs-release-notes)を確認してください。 - - `npm start`などのプログラムを実行するための npm スクリプトがある場合は、 `npm pkg set scripts.start="node -r newrelic your-program.js"`を実行することでこのスクリプトをプログラムで変更できます。 - +2. `node`開始コマンドにエージェントを挿入して、アプリケーションを計装します。 コンテナの設定によっては、node コマンドが呼び出されたときに、Node.js `-r` / `--require`フラグを使用して`newrelic`モジュールを最初に含めるように`ENTRYPOINT`編集できる場合があります。 Dockerfile にこれらの開始コマンドのいずれかが含まれている場合は、次のように変更できます。 - - Node.js エージェントが[v7.2.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-7-2-0)より古い場合は、環境変数`NEW_RELIC_NO_CONFIG_FILE=true`を Dockerfile に追加して、構成ファイルなしでエージェントを実行できるようにする必要があります。構成設定と優先順位の詳細については、[ここを](/docs/apm/agents/nodejs-agent/installation-configuration/nodejs-agent-configuration/)参照してください。 - + * `node YOUR_PROGRAM.js`をに変更します `node -r newrelic YOUR_PROGRAM.js` + * `ENTRYPOINT ['node', 'YOUR_PROGRAM.js']`をに変更します `ENTRYPOINT ['node', '-r', 'newrelic', 'YOUR_PROGRAM.js']` + * `CMD ['node', 'YOUR_PROGRAM.js']`をに変更します `CMD ['node', '-r', 'newrelic', 'YOUR_PROGRAM.js']` + * `npm start`などのプログラムを実行するための npm スクリプトがある場合は、 `npm pkg set scripts.start="node -r newrelic your-program.js"`を実行することでこのスクリプトをプログラムで変更できます。 + * プログラムの実行方法を制御できない場合は、エントリ ファイルの先頭に`require('newrelic')`を追加することで、プログラム内の他のモジュールの前に`newrelic`モジュールをロードできます。 3. 通常の方法でDockerイメージを構築します。 -4. エージェントを有効にしてdockerアプリを実行するには、 と[アプリ名を](/docs/agents/manage-apm-agents/app-naming/name-your-application)環境変数として `docker run` コマンドに追加します。 +4. エージェントを有効にしてdockerアプリを実行するには、 と[アプリ名を](/docs/agents/manage-apm-agents/app-naming/name-your-application)環境変数として `docker run` コマンドに追加します。 ```bash docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \ - -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \ - YOUR_IMAGE_NAME:latest + -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \ + YOUR_IMAGE_NAME:latest ``` - + ## その他の設定オプション [#configure] - - Dockerfile または Docker イメージにライセンス キーを含めないでください。詳細については[、ライセンス キーのセキュリティに関するドキュメントを](/docs/accounts/install-new-relic/account-setup/license-key#license-key-security)参照してください。 + + Node.js エージェントが[v7.2.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-7-2-0)より古い場合は、環境変数`NEW_RELIC_NO_CONFIG_FILE=true`を Dockerfile に追加して、構成ファイルなしでエージェントを実行できるようにする必要があります。構成設定と優先順位の詳細については、[ここを](/docs/apm/agents/nodejs-agent/installation-configuration/nodejs-agent-configuration/)参照してください。 + + Node.js エージェントが[v8.3.0](/docs/release-notes/agent-release-notes/nodejs-release-notes/node-agent-8-3-0)よりも古く、 [ディストリビューティッド（分散）トレーシングを](/docs/understand-dependencies/distributed-tracing/get-started/introduction-distributed-tracing)使用したい場合は、環境変数`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`を`true`に設定して有効にする必要があります。 -アプリケーション名またはライセンス キーの設定に加えて、 `-e`オプションを使用してコンテナを開始することにより、[他の構成オプション](/docs/agents/nodejs-agent/installation-configuration/nodejs-agent-configuration)を設定できます。たとえば、 [分散トレース](/docs/understand-dependencies/distributed-tracing/get-started/introduction-distributed-tracing)を有効にするには、次を使用します。 +アプリケーション名やライセンスキーの設定に加えて、コンテナを`-e`オプションで起動することで[他の設定オプションを](/docs/agents/nodejs-agent/installation-configuration/nodejs-agent-configuration)設定できます。 以下のこともできます: -```bash - docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \ - -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \ - -e NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \ - YOUR_IMAGE_NAME:latest -``` +* 以下のスニペットのように、環境変数 ( `NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED` ) を使用して機能フラグを有効にします。 `NAME_OF_FEATURE_FLAG`機能フラグの大文字の名前に置き換えます。 + + ```bash + docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \ + -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \ + -e NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED=true \ + YOUR_IMAGE_NAME:latest + ``` -`ENV`ディレクティブを使用して、Dockerfile で構成オプションを設定することもできます。 +* `ENV`ディレクティブを使用して Dockerfile で構成オプションを設定します。 -```dockerfile -ENV NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \ - NEW_RELIC_LOG=stdout - # etc. -``` + ```dockerfile + ENV NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED=true \ + NEW_RELIC_LOG=stdout + # etc. + ``` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx b/src/i18n/content/jp/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx index eac330cbb34..fa721c0b4f0 100644 --- a/src/i18n/content/jp/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx +++ b/src/i18n/content/jp/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx @@ -5035,7 +5035,7 @@ Python エージェントのログを構成するためのヒントについて[ - + @@ -5064,7 +5064,7 @@ Python エージェントのログを構成するためのヒントについて[ @@ -5083,7 +5083,59 @@ Python エージェントのログを構成するためのヒントについて[ これは、エージェントがKubernetesクラスタに挿入されたときにレポートするために使用される情報設定です。 - この設定では、エージェントのこの機能は有効/無効になり**ません**。 + この設定では、エージェントのこの機能が有効または無効になるわけ**ではありません**。 + + + + +
- 構成ファイル、環境変数 + 環境変数
+ + + + + + + + + + + + + + + + + + + + + + + + + +
+ タイプ + + ブール値 +
+ デフォルト + + false +
+ [始まる](#options) + + 環境変数 +
+ [環境変数](#environment-variables) + + `NEW_RELIC_AZURE_OPERATOR_ENABLED` +
+ + これは、エージェントが Microsoft Azure コンテナー アプリに挿入されたときにレポートするために使用される情報設定です。 + + + この設定では、エージェントのこの機能が有効または無効になるわけ**ではありません**。 diff --git a/src/i18n/content/jp/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice.mdx b/src/i18n/content/jp/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice.mdx new file mode 100644 index 00000000000..bf1942caada --- /dev/null +++ b/src/i18n/content/jp/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice.mdx @@ -0,0 +1,154 @@ +--- +title: Microsoft Azureコンテナ アプリと App Service に Python エージェントをインストールする +metaDescription: How to install APM for Python on Microsoft Azure App Services and Container Apps. +freshnessValidatedDate: never +translationType: machine +--- + +Microsoft Azure は、Web アプリまたはコンテナー化されたアプリを管理する 2 つのプラットフォーム サービスを提供します。 Python エージェントを[Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview)と[Azure Container Apps の](https://learn.microsoft.com/en-us/azure/container-apps/overview)両方にインストールすると、 New Relicで Azure 管理の Python アプリを追跡できるようになります。 + + + アプリケーション コードを変更せずに、Azure でホストされているアプリケーションに New Relic を統合する方法を探している場合は、[このチュートリアルが](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration)その解決策を提供します。 + + +## 互換性と要件 [#compatibility-requirements] + +Python エージェントをインストールする前に、次のことをお勧めします。 + +* Python エージェントの[互換性と要件に関するドキュメント](/docs/agents/python-agent/getting-started/compatibility-requirements-python-agent)を確認する +* Azure マネージド プラットフォームの 1 つ (または両方) に Python アプリをセットアップする +* 環境に[Azure CLI を](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-macos)インストールする + + + Python エージェントは、統合がなければAzure Functionsのテレメトリーをキャプチャしないことに注意してください。 に関するデータを収集したい場合は 、[Azure Functions 監視統合](/docs/infrastructure/microsoft-azure-integrations/azure-integrations-list/azure-functions-monitoring-integration/)Azure Functions をインストールすることをお勧めします。 + + +## Python エージェントを Azure App Service またはコンテナー アプリにインストールする [#install-python] + + + + ## Python エージェントを Azure アプリケーションに追加する [#add-python-agent] + + New Relic Python エージェントを Azure アプリケーションに追加するには、 `requirements.txt`ファイルに`newrelic`を追加します。 + + ```bash + foo@bar:~$ cat requirements.txt + newrelic + flask + ``` + + + + ## エージェントの初期化 [#initialize-agent] + + エージェントは、アプリ自体を手動で初期化するか、Dockerfile に New Relic エントリポイントを追加することで初期化できます。 + + + + アプリ コードを更新して`newrelic.agent`をインポートし、 `newrelic.agent.initialize()`関数を追加してエージェントを初期化します。 + + エージェントが初期化された Flask アプリの例を次に示します。 + + ```python + # app.py + # Run with command "flask run" + + import newrelic.agent # ADDED + from flask import Flask + + newrelic.agent.initialize() # ADDED + + app = Flask(__name__) + + @app.route('/') + def hello_world(): + return "Hello, fellow humans!" + + if __name__ == '__main__': + app.run() + ``` + + + + Dockerfile を使用している場合は、起動スクリプトのエントリポイントとして`newrelic-admin run-program`を追加します。 + + ```go + COPY requirements.txt . + COPY app.py . + + RUN pip install -r requirements.txt + + EXPOSE 5000 + + ENTRYPOINT ["newrelic-admin", "run-program"] + CMD ["flask", "run"] + ``` + + + + + + ## Azure設定を構成する [#azure-settings] + + Python エージェントをインストールしたら、使用しているサービスに応じて、Azure App Service またはコンテナー アプリ ポータルでアプリを構成することをお勧めします。 アプリの設定は、Azure UI または Python CLI を使用して更新できます。 + + + + 1. **[portal.azure.com](https://portal.azure.com)**にサインインします。 + 2. **App Services > (select a Python app) > Settings > Environment variables**を選択します。 + 3. **App settings**に以下を追加します: + + * `NEW_RELIC_APP_NAME`: Linux Azure Web サイト名 + * `NEW_RELIC_LICENSE_KEY`: あなたのNew Relic + + 4. 設定を保存します。 + 5. Python アプリを再起動します。 + + + + 1. **[portal.azure.com](https://portal.azure.com)**にサインインします。 + 2. **Container Apps > (select a Python app) > Containers > Environment variables**を選択します。 + 3. **Container settings**に以下を追加します: + + * `NEW_RELIC_APP_NAME`: Linux Azure Web サイト名 + * `NEW_RELIC_LICENSE_KEY`: あなたのNew Relic + + 4. 設定を保存します。 + 5. Python アプリを再起動します。 + + アプリにトラフィックを生成し、数分間待ちます。 **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM & services > (select your app)**にアクセスするとデータを確認できます。 + + + + コマンドラインで次のコマンドを実行します。 + + ```bash + az webapp config appsettings set --name ${WEB_APP_NAME} --settings NEW_RELIC_LICENSE_KEY=${NEW_RELIC_LICENSE_KEY} NEW_RELIC_APP_NAME=${NEW_RELIC_APP_NAME} + ``` + + + + コマンドラインで次のコマンドを実行します。 + + ```bash + az containerapp update --name ${CONTAINER_APP_NAME} --set-env-vars "NEW_RELIC_APP_NAME=${NEW_RELIC_APP_NAME}" "NEW_RELIC_LICENSE_KEY=${NEW_RELIC_LICENSE_KEY}" + ``` + + 複数のレプリカが許可されている場合、上記のコマンドは新しいレプリカを作成します。 それ以外の場合は、コンテナのレプリカを再起動する必要があります。 これを行うには、レプリカの名前を見つけて、それを使用して再起動します。 + + ```bash + az containerapp revision list --name ${CONTAINER_APP_NAME} -o table + az containerapp revision restart --revision [Revision name from list generated above] + ``` + + + + + +## 次は何ですか？ [#whats-next] + +Azure 管理の Python アプリからデータを収集できるようになったので、次のことが可能になります。 + +* [New Relic データのクエリ方法](/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data)については、ドキュメントをご覧ください。 +* [最初の集計を作成する](/docs/alerts/create-alert/create-alert-condition/alert-conditions)方法を学びます。 +* [ダッシュボードを使い始めると、](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards)環境に合わせてカスタマイズされた視覚化を構築する方法を学ぶことができます。 \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx b/src/i18n/content/jp/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx new file mode 100644 index 00000000000..ae2254f7376 --- /dev/null +++ b/src/i18n/content/jp/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx @@ -0,0 +1,303 @@ +--- +title: Microsoft Azure コンテナー アプリと App Service に Python エージェントを統合する +metaDescription: How to integrate APM for Python on Microsoft Azure App Services and Container Apps +freshnessValidatedDate: never +translationType: machine +--- + + + この機能はまだ開発中ですが、ぜひお試しください。 + + この機能は現在、弊社の[プレリリース ポリシー](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy)に従ってプレビュー プログラムの一部として提供されています。 + + +このドキュメントでは、アプリケーション コードを変更することなく、Azure でホストされる Python アプリケーションへのNew Relicインテグレーションに関するソリューションを提供します。 この機能には 2 つのインスタンスがサポートされています。 + +* [Azure コンテナー アプリ](https://learn.microsoft.com/en-us/azure/container-apps/overview) +* [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview) 、コードの使用 + +コンテナ化されたイメージを使用した App Services のNew Relicインテグレーションのサポートは利用できません。 + +## 互換性と要件 [#compatibility-requirements] + +始める前に、次のことをお勧めします。 + +* デプロイ済みのコンテナアプリまたはApp Serviceから開始する +* Azure ポータルを使用しない場合は、環境に[Azure CLI を](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-macos)インストールします。 + + + Python エージェントは、統合がなければAzure Functionsのテレメトリーをキャプチャしないことに注意してください。 に関するデータを収集したい場合は 、[Azure Functions 監視統合](/docs/infrastructure/microsoft-azure-integrations/azure-integrations-list/azure-functions-monitoring-integration/)Azure Functions をインストールすることをお勧めします。 + + +## Pythonエージェントをコンテナアプリに統合する [#integrate-agent-container-app] + +場合によっては、 [Azure コンテナー アプリ](https://learn.microsoft.com/en-us/azure/container-apps/overview)を通じて管理されるアプリには、ユーザーが変更できないイメージが既に含まれていることがあります (または、ユーザーが単にアプリの変更を望まない場合もあります)。 これにより、コンテナ化されたイメージを構築するコードを変更することなく、New Relic を環境に統合できるようになります。 + +これは、Azure Portal または Azure CLI を通じて実行できます。 + + + + + + ### [New Relic ライセンスキー](docs/apis/intro-apis/new-relic-api-keys/#license-key)を追加する [#add-license-key-portal] + + この手順はオプションですが、強くお勧めします。 + + [Azure Key Vault が](https://azure.microsoft.com/en-us/products/key-vault)まだ作成されていない場合は、[このクイックスタート ガイド](https://learn.microsoft.com/en-us/azure/key-vault/general/quick-create-portal)に従ってください。 + + 1. **Container Apps > (select a Python app) > Settings > Secrets**を選択します。 + 2. 秘密を追加します。 シークレットに名前を付け、「Key Vault参照」を選択し、ライセンスキーを追加します + 3. 変更を保存します。 + + + + ### Azure ファイル共有をコンテナー アプリにリンクする [#add-volume-portal] + + [このクイックスタート](https://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-portal?tabs=azure-portal) [チュートリアル](https://learn.microsoft.com/en-us/azure/storage/files/storage-files-introduction) に従って、 Azure ファイル共有 を作成します。 + + 1. **Container Apps > (select a Python app) > Application > Containers**を選択します。 + 2. 「編集とデプロイ」を選択します + 3. 「ボリューム」タブに移動して「（+）追加」をクリックします + 4. 「Azure ファイル ボリューム」を選択し、希望のボリューム名を入力して、先ほど作成したファイル共有を選択します。 + 5. 変更を保存します。 + + + + ### 初期化コンテナの追加と設定 [#init-container-setup-portal] + + 1. **Container Apps > (select a Python app) > Application > Containers**を選択します。 + + 2. 「コンテナイメージ」セクションで「追加」をクリックし、「コンテナの初期化」を選択します。 + + 3. 以下を入力してください: + + * 希望の初期化コンテナ名 + * 「イメージソース」の「docker Hub またはその他のレジストリ」 + * `newrelic/newrelic-python-init` 「画像とタグ」の下 + * `/bin/sh` 「コマンドオーバーライド」 + * `-c, cp -r /instrumentation /mnt/` 「引数のオーバーライド」 + * 必要な CPU コアとメモリ。 これはプライマリコンテナの容量を超えてはなりません。 + + 4. 「ボリュームマウント」タブに移動し、前の手順で作成したボリュームマウントを選択します。 マウント パスは`/mnt/instrumentation`である必要があります。 + + 5. 変更を保存します。 + + + + ### New Relicをプライマリアプリケーションにリンクする [#link-nr-to-app-portal] + + 1. **Container Apps > (select a Python app) > Application > Containers**を選択します。 + + 2. 「コンテナイメージ」セクションで、プライマリアプリケーションを選択し、「編集」をクリックします。 + + 3. 「環境変数」タブに移動して、以下を入力します。 + + * `NEW_RELIC_APP_NAME`: \[希望するアプリ名] + * `PYTHONPATH`： `/mnt/instrumentation` + * `NEW_RELIC_AZURE_OPERATOR_ENABLED`： `True` + * `NEW_RELIC_LICENSE_KEY` > シークレットを参照 > ステップ 1 でシークレット名を選択します (または手動でライセンスキーを入力します) + + 4. 「ボリュームマウント」タブに移動し、手順 2 で作成したボリュームマウントを選択します。マウント パスは`/mnt/instrumentation`になります。 + + 5. 変更を保存します。 + + + これにより、コンテナ アプリが再デプロイされます。 初期化コンテナの実行が完了するまで数分間待ちます。 + + + + + + + ### New Relicライセンスキーを Azure Key Vault に追加する [#add-license-key-cli] + + この手順はオプションですが、強くお勧めします。 + + [Azure Key Vault](https://azure.microsoft.com/en-us/products/key-vault)がまだ作成されていない場合は、[このクイックスタート チュートリアル](https://learn.microsoft.com/en-us/azure/key-vault/general/quick-create-cli)に従ってください。 + + `az containerapp secret set --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --secrets license-key=$NEW_RELIC_LICENSE_KEY` + + + + ### Azure ファイル共有を作成し、コンテナー アプリにリンクする [#add-volume-cli] + + 1. `az storage account create --resource-group $RESOURCE_GROUP --name $STORAGE_ACCOUNT_NAME --location $LOCATION --kind StorageV2 --sku Standard_LRS --enable-large-file-share` + 2. `az storage share-rm create --resource-group $RESOURCE_GROUP --storage-account $STORAGE_ACCOUNT_NAME --name $STORAGE_SHARE_NAME --quota 4096 --enabled-protocols SMB` + 3. `` STORAGE_ACCOUNT_KEY=`az storage account keys list -n $STORAGE_ACCOUNT_NAME --query "[0].value" -o tsv --resource-group $RESOURCE_GROUP` `` + 4. `az containerapp env storage set --access-mode ReadWrite --azure-file-account-name $STORAGE_ACCOUNT_NAME --azure-file-account-key $STORAGE_ACCOUNT_KEY --azure-file-share-name $STORAGE_SHARE_NAME --storage-name $STORAGE_MOUNT_NAME --name $ENVIRONMENT_NAME --resource-group $RESOURCE_GROUP` + + + + ### 環境変数を追加する [#add-env-vars-cli] + + `az containerapp update --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --set-env-vars "NEW_RELIC_APP_NAME=$NEW_RELIC_APP_NAME" "NEW_RELIC_AZURE_OPERATOR_ENABLED=True" "NEW_RELIC_LICENSE_KEY=secretref:license-key" "PYTHONPATH="/mnt/instrumentation` + + + + ### New Relicをプライマリアプリケーションにリンクする [#link-nr-to-app-portal] + + #### コンテナアプリの設定をエクスポート + + `az containerapp show --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --output yaml > demoapp.yaml` + + このファイルは、コンテナ アプリに関する情報を含む部分的なテンプレート ファイルを生成します。 New Relic をアプリにリンクするには、追加情報を追加する必要があります。 + + #### コンテナアプリにボリュームをマウントする + + プロパティ > テンプレートには、 `volumes`というセクションがあります。 現時点では、 `volumes: null`と表示されています。 その行を次の行に置き換えます。 + + ```bash + volumes: + - name: $VOLUME_NAME + storageName: $STORAGE_MOUNT_NAME + storageType: AzureFile + ``` + + `$STORAGE_MOUNT_NAME`ステップ2で使用されたもので、 `$VOLUME_NAME`選択した名前です。 + + #### 初期化コンテナを追加する + + プロパティ > テンプレートには、 `initContainers`というセクションがあります。 現時点では、 `initContainers: null`と表示されています。 その行を次の行に置き換えます。 + + ```bash + initContainers: + - args: + - -c + - cp -r /instrumentation /mnt/ + command: + - /bin/sh + image: docker.io/newrelic/newrelic-python-init + name: nr-init-container + ``` + + #### ボリュームをコンテナにリンクする + + プロパティ > テンプレートに、 `containers`と`initContainers`セクションが追加されました。 これらの各セクション内に、次の行を追加します。 + + ```bash + volumeMounts: + - mountPath: /mnt/instrumentation + volumeName: $VOLUME_NAME + ``` + + `$VOLUME_NAME`は先ほど選択した名前です + + #### コンテナアプリを新しい設定で更新する + + `az containerapp update --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --yaml demoapp.yaml` + + これにより、コンテナ アプリが再デプロイされます。 初期化コンテナの実行が完了するまで数分間待ちます。 + + + + + +## Python エージェントを Azure App Service に統合する [#integrate-agent-app-service] + +現在、App Services はサイドカーのみをサポートしており、init コンテナーはサポートしていません。 そのサポートが利用可能になるまで、このプレビルド スクリプトを使用できます。 注: これはコードを使用する App Services でのみ機能し、コンテナー化されたイメージでは機能しません。 + +これは、Azure Portal または Azure CLI を通じて実行できます。 + +```bash prebuild.sh +#!/bin/sh +# prebuild.sh + +# Retrieve files to use in startup script: +curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/newrelic_k8s_operator.py > newrelic_k8s_operator.py +curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/requirements-vendor.txt > requirements-vendor.txt +curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/requirements-builder.txt > requirements-builder.txt + +cd /home/ + +pip install -r requirements-builder.txt + +export NEW_RELIC_EXTENSIONS=false +export WRAPT_DISABLE_EXTENSIONS=true + +pip install newrelic --target=./workspace/newrelic + +mkdir -p ./workspace/vendor +pip install --target=./workspace/vendor -r requirements-vendor.txt + +cp ./workspace/* /home/ +cp /home/workspace/newrelic/newrelic/bootstrap/sitecustomize.py /home/sitecustomize.py + +cd /home/site/wwwroot + +# This is the where the application's original startup script goes: +gunicorn app:app +``` + + + + + + ### 起動スクリプトをアップロード + + https://\[YOUR\_LINUX\_AZURE\_WEBSITE\_NAME].scm.azurewebsites.net/newui/fileManager にアクセスします。 `prebuild.sh`スクリプトを`/home`ディレクトリにアップロードします + + + + ### 必要な環境変数を追加する + + 1. **App Services > (select a Python app) > Settings > Environment variables**を選択します。 + + 2. **App settings**に以下を追加します: + + * `NEW_RELIC_APP_NAME`: Linux Azure Web サイト名 + * `NEW_RELIC_LICENSE_KEY`: あなたのNew Relic + * `PYTHONPATH`： `/home:/home/workspace/newrelic` + * `NEW_RELIC_AZURE_OPERATOR_ENABLED`： `True` + + 3. 設定を保存します。 + + 特定のエージェントバージョンが必要な場合は、 `AGENT_VERSION`環境変数にバージョン番号を追加し、先頭に`v`を付けます（例： `v10.0.0` ）。 + + + + ### スタートアップファイル設定として`prebuild.sh`を追加します + + 1. **App Services > (select a Python app) > Settings > Configuration**を選択します。 + 2. **Startup Command**に以下を追加します: `/home/prebuild.sh` + 3. 設定を保存します。 これにより、アプリが再デプロイされます。 + + これには数分かかります。 + + + + + + + + ### 起動スクリプトをアップロード + + `az webapp deploy --resource-group ${RESOURCE_GROUP} --name ${WEB_APP_NAME} --src-path prebuild.sh --target-path /home/prebuild.sh --type=static` + + + + ### 必要な環境変数を追加する + + `az webapp config appsettings set --name ${WEB_APP_NAME} --resource-group ${RESOURCE_GROUP} --settings NEW_RELIC_LICENSE_KEY=$NEW_RELIC_LICENSE_KEY NEW_RELIC_AZURE_OPERATOR_ENABLED=true NEW_RELIC_APP_NAME="Azure Service App" PYTHONPATH="/home:/home/workspace/newrelic"` + + 特定のエージェントバージョンが必要な場合は、 `AGENT_VERSION`環境変数にバージョン番号を追加し、先頭に`v`を付けます（例： `v10.0.0` ) を次の例のように使用します。 + + `az webapp config appsettings set --name ${WEB_APP_NAME} --resource-group ${RESOURCE_GROUP} --settings AGENT_VERSION=v10.0.0` + + + + ### スタートアップファイル設定として`prebuild.sh`を追加します + + `az webapp config set --resource-group ${RESOURCE_GROUP} --name ${WEB_APP_NAME} --startup-file "/home/prebuild.sh"` + + これには数分かかります。 + + + + + +### トラブルシューティング [#troubleshooting] + +場合によっては、テレメトリーが利用できない場合や、 `prebuild.sh`スクリプトが原因で既存のアプリケーションの再デプロイメントが失敗する場合があります。 これを解決するには、次の環境変数を有効にします。 + +* `SCM_DO_BUILD_DURING_DEVELOPMENT`： `True` +* `ENABLE_ORYX_BUILD`： `True` \ No newline at end of file diff --git a/src/i18n/content/jp/docs/apm/new-relic-apm/getting-started/view-app-alert-information-apm.mdx b/src/i18n/content/jp/docs/apm/new-relic-apm/getting-started/view-app-alert-information-apm.mdx index 35f326a75fe..355180b713a 100644 --- a/src/i18n/content/jp/docs/apm/new-relic-apm/getting-started/view-app-alert-information-apm.mdx +++ b/src/i18n/content/jp/docs/apm/new-relic-apm/getting-started/view-app-alert-information-apm.mdx @@ -8,9 +8,9 @@ freshnessValidatedDate: never translationType: machine --- -優れた 、システムの変更について個人またはチームに通知するのに役立ちます。 [Alerts は、](/docs/alerts/new-relic-alerts-beta/getting-started/new-relic-alerts) New Relic 製品全体にわたって単一の調整されたアラート ツールを提供します。 これにより[ 、最も重視するテンプレート](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#alert-policy) [](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#alert-condition)のメトリック[ ](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#alert-entity)( のアプリやキーAPM ラインなど) に重点を置いた アラートポリシー と 条件を 管理できます。 +優れた 、システムの変更について個人またはチームに通知するのに役立ちます。 [Alerts は、](/docs/alerts/new-relic-alerts-beta/getting-started/new-relic-alerts) New Relic 製品全体にわたって単一の調整されたアラート ツールを提供します。 これにより[ 、最も重視するテンプレート](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#alert-policy) [](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#alert-condition)のメトリック[ ](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#alert-entity)( のアプリやキーAPM ラインなど) に重点を置いた アラートポリシー と 条件を 管理できます。 -[1つ以上のアラートポリシー](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/name-or-rename-alert-policy) を設定し、 [自分の New Relic ](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/define-alert-conditions)[製品のエンティティ (ターゲット)](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/select-product-targets-alert-condition) に対するアラート条件 を定義した後、その情報をアラート UI で確認することができます。アラートポリシーの情報は、個々の New Relic 製品の UI でも見ることができます。 +[1 つ以上のアラート ポリシーを設定し](/docs/alerts/organize-alerts/create-edit-or-find-alert-policy/) [](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/define-alert-conditions)、 製品New Relic[ エンティティ (ターゲット)](/docs/alerts/new-relic-alerts-beta/configuring-alert-policies/select-product-targets-alert-condition) の アラート条件を定義すると 、その情報を アラートUI で表示できます。個々のUI New Relic製品の でアラート ポリシー情報を表示することもできます。 ## APMのポリシーと条件を見る [#policy] @@ -18,27 +18,10 @@ translationType: machine 1. 次のうち1つを行います。 - * アプリ: + * アプリ: **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > (select an app) > Settings > Alert conditions**に移動します。 + * キートランザクション: **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > More > Key transactions > (select a key transaction) > Settings > Alert conditions**に移動します。 - - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > (select an app) > Settings > Alert conditions** - - - に移動します。 - - * キートランザクション: - - - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > More > Key transactions > (select a key transaction) > Settings > Alert conditions** - - - に移動します。 - -2. - **Alert conditions** - - - ページから、利用可能なツールを使用して、アラート条件とそれに関連付けられたポリシーを検索、並べ替え、表示、または更新します。 +2. **Alert conditions**ページから、利用可能なツールを使用して、アラート条件とそれに関連付けられたポリシーを検索、並べ替え、表示、または更新します。 ## APMのイベントや活動を見る [#activity] @@ -50,49 +33,16 @@ translationType: machine 1. 次のうち1つを行います。 - * アプリ: - - - **[one.newrelic.com](https://one.newrelic.com/all-capabilities)** - - - に移動します。 + * アプリ: **[one.newrelic.com](https://one.newrelic.com/all-capabilities)**に移動します。 + * キートランザクション: **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > More > Key transactions**に移動します。 - * キートランザクション: - - - **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > More > Key transactions** - - - に移動します。 - -2. インデックスから、 エンタープライズの[色分けされた稼働ステータス](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#health-status)の上にマウスを置き、 - - - **Application activity** - - - リストからリンクを選択するか、特定のbrowserアプリまたはキートランザクションを選択して、追加の詳細を表示します。 +2. インデックスから、 エンタープライズの[色分けされた稼働ステータス](/docs/alerts/new-relic-alerts-beta/getting-started/alerts-glossary#health-status)の上にマウスを置き、**Application activity** リストからリンクを選択するか、特定のbrowserアプリまたはキートランザクションを選択して、追加の詳細を表示します。 たとえば、重大なアラート インシデントが発生した場合: * APMインデックスと選択したアプリで、健康状態の表示が赤になります。 - * 各種チャートの背景色がピンクに変わります。 - -* APM インデックスと選択したアプリの - - - **Summary** - - - ページの - - - **Application activity** - - - リストには、該当する場合、警告 (黄色) および重大 (赤) のインシデントが表示されます。 +* APM インデックスと選択したアプリの**Summary**ページの**Application activity**リストには、該当する場合、警告 (黄色) および重大 (赤) のインシデントが表示されます。 アラート内のインシデントの詳細を確認するには、グラフ上のピンクの領域にマウスを置くか選択します。詳細と例については、 [「製品からのイベントの表示」](/docs/alerts/new-relic-alerts-beta/reviewing-events/view-events-their-products)を参照してください。 @@ -102,33 +52,8 @@ translationType: machine 1. 次のうち1つを行います。 - * アプリ: - - - **[one.newrelic.com](https://one.newrelic.com/all-capabilities) > Alerts > (select an app) > Issues & Activity** - - - に移動し、 - - - **Incidents** - - - タブをクリックします。 - - * キートランザクション: - - - **[one.newrelic.com](https://one.newrelic.com/all-capabilities) > Key Transactions > (select a key transaction) > Issues & Activity** - - - に移動し、 - - - **Incidents** - - - タブをクリックします。 + * アプリ: **[one.newrelic.com](https://one.newrelic.com/all-capabilities) > Alerts > (select an app) > Issues & Activity**に移動し、 **Incidents**タブをクリックします。 + * キートランザクション: **[one.newrelic.com](https://one.newrelic.com/all-capabilities) > Key Transactions > (select a key transaction) > Issues & Activity**に移動し、 **Incidents**タブをクリックします。 2. **Incidents**インデックスから、利用可能なツールを使用して、選択したアプリまたはキートランザクションを検索、並べ替え、または表示します。 @@ -136,4 +61,4 @@ translationType: machine アラート UI から、 [特定のインシデント](/docs/alerts/new-relic-alerts-beta/reviewing-alert-incidents/explore-incident-history) または [すべての製品にわたるインシデントとイベントの](/docs/alerts/new-relic-alerts-beta/reviewing-events/review-events-across-products)警告および重大なインシデントを表示することもできます。アラートは、重大 (赤) インシデントに対してのみ [アラート通知を](/docs/alerts/new-relic-alerts-beta/managing-notification-channels/notification-channels-controlling-where-send-alerts) 送信します。 - + \ No newline at end of file diff --git a/src/i18n/content/jp/docs/browser/browser-monitoring/troubleshooting/troubleshoot-your-browser-monitoring-installation.mdx b/src/i18n/content/jp/docs/browser/browser-monitoring/troubleshooting/troubleshoot-your-browser-monitoring-installation.mdx index 9febccfdd68..9fd4fc66ad3 100644 --- a/src/i18n/content/jp/docs/browser/browser-monitoring/troubleshooting/troubleshoot-your-browser-monitoring-installation.mdx +++ b/src/i18n/content/jp/docs/browser/browser-monitoring/troubleshooting/troubleshoot-your-browser-monitoring-installation.mdx @@ -12,13 +12,13 @@ translationType: machine ## 問題 -を使用してアプリケーションを構成したばかりの場合は、データが表示されるまで数分お待ちください。 すでに数分間待ってもデータが表示されない場合は、次のトラブルシューティングのヒントを試してください。 [](/docs/browser/new-relic-browser/getting-started/adding-apps-new-relic-browser)これらのヒントの一部は、ブラウザ監視が JavaScript スニペットをAPM - モニター アプリに自動的に挿入できるようにして アプリ をデプロイするか、JavaScript スニペットを自分で挿入するかによって異なります。 +を使用してアプリケーションを構成したばかりの場合は、データが表示されるまで数分お待ちください。 すでに数分間待ってもデータが表示されない場合は、次のトラブルシューティングのヒントを試してください。 [](/docs/browser/new-relic-browser/getting-started/adding-apps-new-relic-browser)これらのヒントの一部は、ブラウザ監視で JavaScript スニペットをAPM モニター アプリに自動的に挿入できるようにして アプリをプロイメントするか、直接配置 または NPM パッケージを通じて JavaScript スニペットを挿入するかによって異なります。 ## 解決 -推奨事項: 特定のトラブルシューティング手順に従う前に、[診断browserチェック](/docs/agents/manage-apm-agents/troubleshooting/new-relic-diagnostics)を実行してください。 Diagnostics CLI がダウンロードされると、 browserコマンドライン オプション `/nrdiag -browser-url YOUR-WEBSITE-URL -suites browser` を実行してチェックします。 Diagnostics CLI から返された情報は、New Relic サポートとの通信時に使用できます。 +推奨事項: Diagnostics CLI がダウンロードされたら、 browserはコマンドライン オプション: `/nrdiag -browser-url YOUR-WEBSITE-URL -suites browser` を実行してチェックします。 Diagnostics CLI から返された情報は、New Relic サポートとの通信時に使用できます。 -ブラウザ監視エージェントが エージェントを持つアカウント モニターにデプロイされていた場合は、 [APM紹介」](#apm-tips)を参照してください。 ブラウザ監視エージェントが JavaScript のコピー/貼り付け方式を使用してデプロイされた場合は、 [「コピー/貼り付けのデプロイメント」](#manual-tips)を参照してください。 どちらを持っているかわからない場合は、診断ツールは エンタープライズ メソッドを返します。 +ブラウザ監視エージェントがエージェント付きのアカウント モニターのデプロイだった場合は、 [APMデプロイメントを](#apm-tips)ご覧ください。 ブラウザ監視エージェントが JavaScript のコピー/ペースト方法を使用してデプロイされた場合は、 [「コピー/ペーストのデプロイメント」を](#manual-tips)参照してください。 NPM 経由のインストールには、プロジェクトのビルドとバンドラーに応じて異なるため、自己トラブルシューティングが必要です。 どちらを使用しているかわからない場合、診断ツールはデプロイメント メソッドを返します。 [AJAX](/docs/browser/new-relic-browser/troubleshooting/troubleshooting-ajax-data-collection)または [セッショントレース](/docs/browser/new-relic-browser/troubleshooting/troubleshooting-session-trace-collection)データのみが欠落している状況をトラブルシューティングすることもできます。 @@ -27,79 +27,46 @@ translationType: machine これらのトラブルシューティング手順は、ブラウザ監視エージェントが[APMエージェントによってすでに監視され](/docs/browser/new-relic-browser/installation-configuration/adding-apps-new-relic-browser#select-apm-app)ているアプリにインストールされている場合の問題に適用されます。 - + アプリケーションの**Browser settings**でブラウザ監視が有効になっていることを確認します。 - 1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Settings**に移動します。 + 1. **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Settings**に移動します。 2. 標準の手順に従って、各アプリの[ブラウザ設定を有効に](/docs/browser/new-relic-browser/installation-configuration/browser-settings-ui-options-browser-monitoring#enabling)します。 3. [Webサーバーのキャッシュ](#restart_app)をフラッシュします。 4. データが到着するまでさらに数分待ちます。 5. それでもデータが表示されない場合は、次の手順を試してください。 - - 最近のエージェントは、ページ読み込みタイミング スクリプトをより正確に配置します。 これらのトラブルシューティングのヒントを続行する前に、[ ](/docs/apm/new-relic-apm/maintenance/keeping-new-relic-date)APMエージェントが 最新リリース であることを確認してください。 + + 最近のエージェントは、ページ読み込みタイミング スクリプトをより正確に配置します。 これらのトラブルシューティングのヒントを続行する前に、[ ](/docs/apm/new-relic-apm/maintenance/keeping-new-relic-date)APMエージェントが 最新リリース であることを確認してください。 ページの読み込みタイミングに関するエージェントのバージョン要件については、[互換性と要件](/docs/browser/new-relic-browser/getting-started/compatibility-requirements)を参照してください。 - + ページのソースで、メトリックをキャプチャしてNewRelicに送信するために必要な2つのスクリプト要素を確認してください。ブラウザで、ページのソースを表示し、次のように先頭近くのスクリプト要素を探します。 ```html