• EnglishEspañol日本語한국어Português
  • Log inStart now

NerdGraph tutorial: APM agent configuration examples

This doc is a place for examples of configuring agents using our NerdGraph API.

Configure server-side configuration

Note that for agents to use configuration values changed via NerdGraph, server side configuration must be enabled.

For requirements, see server-side config requirements.

Here's an example query returning the status of the server side configuration setting for a given entity.

query ExampleReadQuery {
actor {
entity(guid: "ZjY1ODgxfEFQTXxBUFBYSUNBVElPTnz0ODEwMTY3NzZ") {
... on ApmApplicationEntity {
apmSettings {
apmConfig {
useServerSideConfig
}
}
}
}
}
}

Here's an example of disabling server-side configuration. Note that guid uses an array, which may be helpful if you want to update multiple entities.

mutation ExampleUpdateQuery {
agentApplicationSettingsUpdate(
guid: "ZjY1ODgxfEFQTXxBUFBYSUNBVElPTnz0ODEwMTY3NzZ"
settings: { apmConfig: { useServerSideConfig: false } }
) {
apmSettings {
apmConfig {
useServerSideConfig
}
}
errors {
description
errorClass
field
}
}
}

For how to find an entity's GUID, see Find entity data.

Retrieve settings

Here's an example of returning an entity's transaction tracer settings:

query ExampleReadQuery {
actor {
entity(guid: "ZjY1ODgxfEFQTXxBUFBYSUNBVElPTnz0ODEwMTY3NzZ") {
... on ApmApplicationEntity {
guid
name
apmSettings {
transactionTracer {
enabled
explainEnabled
explainThresholdType
explainThresholdValue
}
}
}
}
}
}
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.