diff --git a/src/content/docs/apm/agents/net-agent/net-agent-api/disablebrowsermonitoring-net-agent-api.mdx b/src/content/docs/apm/agents/net-agent/net-agent-api/disablebrowsermonitoring-net-agent-api.mdx
deleted file mode 100644
index 3dd94e867b3..00000000000
--- a/src/content/docs/apm/agents/net-agent/net-agent-api/disablebrowsermonitoring-net-agent-api.mdx
+++ /dev/null
@@ -1,85 +0,0 @@
----
-title: DisableBrowserMonitoring (.NET agent API)
-type: apiDoc
-shortDescription: Disable automatic injection of browser monitoring snippet on specific pages.
-tags:
- - Agents
- - NET agent
- - NET agent API
-metaDescription: New Relic .NET agent API call to disable browser monitoring on specific pages or views.
-redirects:
- - /docs/agents/net-agent/net-agent-api/disablebrowsermonitoring-net-agent-api
- - /docs/agents/net-agent/net-agent-api/disablebrowsermonitoring-net-agent
- - /docs/agents/net-agent/net-agent-api/disable-browser-monitoring
-freshnessValidatedDate: never
----
-
-## Syntax
-
-```cs
-NewRelic.Api.Agent.NewRelic.DisableBrowserMonitoring([boolean $override])
-```
-
-Disable automatic injection of browser monitoring snippet on specific pages.
-
-## Requirements
-
-Compatible with all agent versions.
-
-Must be called inside a [transaction](/docs/glossary/glossary/#transaction).
-
-## Description
-
-Add this call to disable the
- Parameter - | - -- Description - | -
---|---|
- `$override` - - _boolean_ - | - -- Optional. When `true`, disables all injection of browser scripts. This flag affects both manual and automatic injection. This also overrides the [`GetBrowserTimingHeader()`](/docs/agents/net-agent/net-agent-api/getbrowsertimingheader-net-agent) call. - | -
- Parameter - | - -- Description - | -
---|---|
- `nonce` - - _string_ - | - -- The per-request, cryptographic nonce used by Content-Security-Policy policies. - | -
- If you want to... - | - -- Do this... - | -
---|---|
- Prevent a transaction from reporting to New Relic - | - -- Use [`IgnoreTransaction()`](/docs/agents/net-agent/net-agent-api/ignore-transaction) or [an XML file](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#blocking-instrumentation) to ignore the transaction. - | -
- Create a transaction where none exists - | - -- Use [attributes](/docs/agents/net-agent/api-guides/custom-instrumentation-attributes-net) or [an XML file](/docs/agents/net-agent/instrumentation/net-custom-transactions) to create a new transaction. - | -
- If you want to... - | - -- Do this... - | -
---|---|
- Change the name of a transaction - | - -- Use [`SetTransactionName()`](/docs/agents/net-agent/net-agent-api/set-transaction-name) or [an XML file](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#name-transactions). - | -
- Prevent a transaction from affecting your [Apdex](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#apdex) score - | - -- Use [`IgnoreApdex()`](/docs/agents/net-agent/net-agent-api/ignore-apdex). - | -
- Add metadata (such as your customer's account name or subscription level) to your transactions - | - -- Use [custom attributes](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes). See [`AddCustomAttribute()`](/docs/agents/net-agent/net-agent-api/itransaction#addcustomattribute). - | -
- If you want to... - | - -- Do this... - | -
---|---|
- Trace an async method that New Relic is already instrumenting - | - -- Use [an XML file](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) to instrument async methods in IIS apps. For troubleshooting tips, see [missing async metrics](/docs/agents/net-agent/troubleshooting/missing-async-metrics). - | -
- Trace an async method that New Relic is not instrumenting - | - -- Use [an XML file](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) to instrument async methods in IIS apps. For troubleshooting tips, see [missing async metrics](/docs/agents/net-agent/troubleshooting/missing-async-metrics). - | -
- If you want to... - | - -- Do this... - | -
---|---|
- Instrument an outgoing request to an external application or database - | - -- Add a distributed trace payload to an outgoing request using [`InsertDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#insertdistributedtraceheaders). - | -
- Connect incoming requests with the originator of the request to complete a [span](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#span) of the trace - | - -- Receive a payload on an incoming request using [`AcceptDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#acceptdistributedtraceheaders). - | -
- If you want to... - | - -- Do this... - | -
---|---|
- Report an error the .NET agent does not report automatically - | - -- Use [`NoticeError()`](/docs/agents/net-agent/net-agent-api/notice-error). - | -
- Capture errors or prevent the .NET agent from reporting an error at all - | - -- Use your [.NET agent configuration file](/docs/agents/net-agent/configuration/net-agent-configuration#error_collector). - | -
- If you want to... - | - -- Do this... - | -
---|---|
- Send data about an event so you can analyze it in dashboards - | - -- Create a [custom event](/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents#net-att). See [`RecordCustomEvent()`](/docs/agents/net-agent/net-agent-api/record-custom-event). - | -
- Tag your events with metadata to filter and facet them in dashboards or error analytics - | - -- Add [custom attributes](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes). See .NET agent attributes and [Enable and disable attributes](/docs/agents/net-agent/attributes/enable-disable-attributes-net). - | -
- Report custom performance data - | - -- Use [`RecordMetric()`](/docs/agents/net-agent/net-agent-api/record-metric) to create a [custom metric](/docs/agents/manage-apm-agents/agent-data/collect-custom-metrics). To view the data, use the [query builder](/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data). - | -
- Name - | - -- Description - | -
---|---|
- CurrentTransaction - | - -- Property providing access to the currently executing transaction via the [ITransaction](/docs/agents/net-agent/net-agent-api/itransaction) interface. Must be called inside a [transaction](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#transaction). - | -
- CurrentSpan - | - -- Property providing access to the currently executing span via the [ISpan](/docs/agents/net-agent/net-agent-api/iSpan) interface. - | -
- Parameter - | - -- Description - | -
---|---|
- `$metric_name` - - _string_ - | - -- Required. The name of the metric to increment. - | -
- Name - | - -- Description - | -
---|---|
- [`AddCustomAttribute`](#addcustomattribute) - | - -- Add contextual information from your application to the current span in form of attributes. - | -
- [`SetName`](#setname) - | - -- Changes the name of the current span/segment/metrics that will be reported to New Relic. - | -
- Parameter - | - -- Description - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _string_ - | - -- Identifies the information being reported. Also known as the name. - - * Empty keys are not supported. - * Keys are limited to 255-bytes. Attributes with keys larger than 255-bytes will be ignored. - | -||||||||||||||||
- `value` - - _object_ - | - -
- The value being reported.
-
-
|
-
- Parameter - | - -- Description - | -
---|---|
- `name` - - _string_ - | - -- The new name for the span/segment. - | -
- Name - | - -- Description - | -
---|---|
- [`AcceptDistributedTraceHeaders`](#acceptdistributedtraceheaders) - | - -- Accepts incoming trace context headers from another service. - | -
- [`InsertDistributedTraceHeaders`](#insertdistributedtraceheaders) - | - -- Adds trace context headers to an outgoing request. - | -
- [`AcceptDistributedTracePayload` (obsolete)](#acceptdistributedtracepayload) - | - -- Accepts an incoming distributed trace payload from another service. - | -
- [`CreateDistributedTracePayload` (obsolete)](#createdistributedtracepayload) - | - -- Creates a distributed trace payload for inclusion in an outgoing request. - | -
- [`AddCustomAttribute`](#addcustomattribute) - | - -- Add contextual information from your application to the current transaction in form of attributes. - | -
- [`CurrentSpan`](#currentspan) - | - -- Provides access to the currently executing [span](/docs/agents/net-agent/net-agent-api/ispan), which provides access to span-specific methods in the New Relic API. - | -
- [`SetUserId`](#setuserid) - | - -- Associates a User Id to the current transaction. - | -
- Name - | - -- Description - | -
---|---|
- `carrier` - - _<T>_ - | - -- Required. Source of incoming Trace Context headers. - | -
- `getter` - - _Func<T, string, IEnumerable<string>>_ - | - -- Required. Caller-defined function to extract header data from the carrier. - | -
- `transportType` - - _TransportType enum_ - | - -- Required. Describes the transport of the incoming payload (for example `TransportType.HTTP`). - | -
- Name - | - -- Description - | -
---|---|
- `carrier` - - _<T>_ - | - -- Required. Container where Trace Context headers are inserted.. - | -
- `setter` - - _Action<T, string, string>_ - | - -- Required. Caller-defined Action to insert header data into the carrier. - | -
- Name - | - -- Description - | -
---|---|
- `payload` - - _string_ - | - -- Required. A string representation of the incoming distributed trace payload. - | -
- `transportType` - - _TransportType_ - _enum_ - | - -- Recommended. Describes the transport of the incoming payload (for example, `http`). - - Default `TransportType.Unknown`. - | -
- Parameter - | - -- Description - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _string_ - | - -- Identifies the information being reported. Also known as the name. - - * Empty keys are not supported. - * Keys are limited to 255-bytes. Attributes with keys larger than 255-bytes will be ignored. - | -||||||||||||||||
- `value` - - _object_ - | - -
- The value being reported.
-
-
|
-
- Parameter - | - -- Description - | -
---|---|
- `userId` - - _string_ - | - -- The User Id to be associated with this transaction. - - * `null`, empty and whitespace values will be ignored. - | -
+ Parameter + | + ++ Description + | +
---|---|
+ `$override` + + _boolean_ + | + ++ Optional. When `true`, disables all injection of browser scripts. This flag affects both manual and automatic injection. This also overrides the [`GetBrowserTimingHeader()`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#GetBrowserTimingHeader) call. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `nonce` + + _string_ + | + ++ The per-request, cryptographic nonce used by Content Security Policy policies. + | +
+ Name + | + ++ Description + | +
---|---|
+ CurrentTransaction + | + ++ Property providing access to the currently executing transaction via the [ITransaction](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#ITransaction) interface. Must be called inside a [transaction](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#transaction). + | +
+ CurrentSpan + | + ++ Property providing access to the currently executing span via the [ISpan](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#ISpan) interface. + | +
+ Name + | + ++ Description + | +
---|---|
+ [`AcceptDistributedTraceHeaders`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#AcceptDistributedTraceHeaders) + | + ++ Accepts incoming trace context headers from another service. + | +
+ [`InsertDistributedTraceHeaders`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#InsertDistributedTraceHeaders) + | + ++ Adds trace context headers to an outgoing request. + | +
+ [`AcceptDistributedTracePayload` (obsolete)](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#AcceptDistributedTraceHeaders) + | + ++ Accepts an incoming distributed trace payload from another service. + | +
+ [`CreateDistributedTracePayload` (obsolete)](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#CreateDistributedTracePayload) + | + ++ Creates a distributed trace payload for inclusion in an outgoing request. + | +
+ [`AddCustomAttribute`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#AddCustomAttribute) + | + ++ Add contextual information from your application to the current transaction in form of attributes. + | +
+ [`CurrentSpan`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#CurrentSpan) + | + ++ Provides access to the currently executing [span](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#ISpan), which provides access to span-specific methods in the New Relic API. + | +
+ [`SetUserId`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#SetUserId) + | + ++ Associates a user ID to the current transaction. + | +
+ Name + | + ++ Description + | +
---|---|
+ `carrier` + + _<T>_ + | + ++ Required. Source of incoming Trace Context headers. + | +
+ `getter` + + _Func<T, string, IEnumerable<string>>_ + | + ++ Required. Caller-defined function to extract header data from the carrier. + | +
+ `transportType` + + _TransportType enum_ + | + ++ Required. Describes the transport of the incoming payload (for example `TransportType.HTTP`). + | +
+ Name + | + ++ Description + | +
---|---|
+ `carrier` + + _<T>_ + | + ++ Required. Container where trace context headers are inserted.. + | +
+ `setter` + + _Action<T, string, string>_ + | + ++ Required. Caller-defined action to insert header data into the carrier. + | +
+ Name + | + ++ Description + | +
---|---|
+ `payload` + + _string_ + | + ++ Required. A string representation of the incoming distributed trace payload. + | +
+ `transportType` + + _TransportType_ + _enum_ + | + ++ Recommended. Describes the transport of the incoming payload (for example, `http`). + + Default `TransportType.Unknown`. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `key` + + _string_ + | + ++ Identifies the information being reported. Also known as the name. + + * Empty keys are not supported. + * Keys are limited to 255-bytes. Attributes with keys larger than 255-bytes will be ignored. + | +
+ `value` + + _object_ + | + ++ The value being reported. + + **Note**: `null` values will not be recorded. + | +
+ .NET type + | + ++ How the value will be represented + | +
---|---|
+ `byte`, `Int16`, `Int32`, `Int64` + + `sbyte`, `UInt16`, `UInt32`, `UInt64` + | + ++ As an integral value. + | +
+ `float`, `double`, `decimal` + | + ++ A decimal-based number. + | +
+ `string` + | + ++ A string truncated after 255-bytes. + + Empty strings are supported. + | +
+ `bool` + | + ++ True or false. + | +
+ `DateTime` + | + ++ A string representation following the ISO-8601 format, including time zone information: + + Example: `2020-02-13T11:31:19.5767650-08:00` + | +
+ `TimeSpan` + | + ++ A decimal-based number representing number of seconds. + | +
+ everything else + | + ++ The `ToString()` method will be applied. Custom types must have an implementation of `Object.ToString()` or they will throw an exception. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `userId` + + _string_ + | + ++ The User Id to be associated with this transaction. + + * `null`, empty and whitespace values will be ignored. + | +
+ Name + | + ++ Description + | +
---|---|
+ [`AddCustomAttribute`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#AddCustomAttribute) + | + ++ Add contextual information from your application to the current span in form of attributes. + | +
+ [`SetName`](/docs/apm/agents/net-agent/net-agent-api/net-agent-api/#setname) + | + ++ Changes the name of the current span/segment/metrics that will be reported to New Relic. + | +
+ Parameter + | + ++ Description + | +||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+ `key` + + _string_ + | + ++ Identifies the information being reported. Also known as the name. + + * Empty keys are not supported. + * Keys are limited to 255-bytes. Attributes with keys larger than 255-bytes will be ignored. + | +||||||||||||||||
+ `value` + + _object_ + | + +
+ The value being reported.
+
+ **Note**: `null` values will not be recorded.
+
+
|
+
+ Parameter + | + ++ Description + | +
---|---|
+ `name` + + _string_ + | + ++ The new name for the span/segment. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$metric_name` + + _string_ + | + ++ Required. The name of the metric to increment. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$exception` + + _Exception_ + | + ++ Required. The `Exception` you want to instrument. Only the first 10,000 characters from the stack trace are retained. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$exception` + + _Exception_ + | + ++ Required. The `Exception` you want to instrument. Only the first 10,000 characters from the stack trace are retained. + | +
+ `$attributes` + + _IDictionary<TKey, TValue>_ + | + ++ Specify key/value pairs of attributes to annotate the error message. The `TKey` must be a string, the `TValue` can be a string or object. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$error_message` + + _string_ + | + ++ Required. Specify a string to report to New Relic as though it's an exception. This method creates both [error events and error traces](/docs/errors-inbox/apm-tab/#events). Only the first 1023 characters are retained in error events, while error traces retain the full message. + | +
+ `$attributes` + + _IDictionary<TKey, TValue>_ + | + ++ Required (can be null). Specify key/value pairs of attributes to annotate the error message. The `TKey` must be a string, the `TValue` can be a string or object, to send no attributes, pass `null`. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$error_message` + + _string_ + | + ++ Required. Specify a string to report to New Relic as though it's an exception. This method creates both [error events and error traces](/docs/tutorial-error-tracking/respond-outages/). Only the first 1023 characters are retained in error events, while error traces retain the full message. + | +
+ `$attributes` + + _IDictionary<TKey, TValue>_ + | + ++ Required (can be null). Specify key/value pairs of attributes to annotate the error message. The `TKey` must be a string, the `TValue` can be a string or object, to send no attributes, pass `null`. + | +
+ `$is_expected` + + _bool_ + | + ++ Mark error as expected so that it won't affect Apdex score and error rate. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `eventType` + + _string_ + | + ++ Required. The name of the event type to record. Strings over 255 characters will result in the API call not being sent to New Relic. The name can only contain alphanumeric characters, underscores `_`, and colons `:`. For additional restrictions on event type names, see [Reserved words](/docs/data-apis/custom-data/custom-events/data-requirements-limits-custom-event-data/#reserved-words). + | +
+ `attributeValues` + + _IEnumerable<string, object>_ + | + ++ Required. Specify key/value pairs of attributes to annotate the event. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$metric_name` + + _string_ + | + ++ Required. The name of the metric to record. Only the first 255 characters are retained. + | +
+ `$metric_value` + + _single_ + | + ++ Required. The quantity to record for the metric. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$metric_name` + + _string_ + | + ++ Required. The name of the response time metric to record. Only the first 255 characters are retained. + | +
+ `$metric_value` + + _Int64_ + | + ++ Required. The response time to record in milliseconds. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$name` + + _string_ + | + ++ Required. The primary application name. + | +
+ `$name_2` + + `$name_3` + + _string_ + | + ++ Optional. Second and third names for app rollup. For more information, see [Use multiple names for an app](/docs/agents/manage-apm-agents/app-naming/use-multiple-names-app). + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$callback`
+
+ _{'Func |
+
+ + The callback to determine the error group name based on attribute data. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$category` + + _string_ + | + +
+ Required. The category of this transaction, which you can use to distinguish different types of transactions. Defaults to |
+
+ `$name` + + _string_ + | + ++ Required. The name of the transaction. Only the first 255 characters are retained. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$uri` + + _Uri_ + | + ++ The URI of this transaction. + | +
+ Parameter + | + ++ Description + | +
---|---|
+ `$user_value` + + _string_ + | + ++ Required (can be null). Specify a name or username to associate with this page view. This value is assigned to the `user` key. + | +
+ `$account_value` + + _string_ + | + ++ Required (can be null). Specify the name of a user account to associate with this page view. This value is assigned to the `account` key. + | +
+ `$product_value` + + _string_ + | + ++ Required (can be null). Specify the name of a product to associate with this page view. This value is assigned to the `product` key. + | +
+ Name + | + ++ Description + | +
---|---|
+ `TraceId` + | + ++ Returns a string representing the currently executing trace. If the trace ID is not available, or distributed tracing is disabled, the value will be `string.Empty`. + | +
+ `SpanId` + | + ++ Returns a string representing the currently executing span. If the span ID is not available, or distributed tracing is disabled, the value will be `string.Empty`. + | +
+ `IsSampled` + | + ++ Returns `true` if the current trace is sampled for inclusion, `false` if it is sampled out. + | +
- Parameter - | - -- Description - | -
---|---|
- `$exception` - - _Exception_ - | - -- Required. The `Exception` you want to instrument. Only the first 10,000 characters from the stack trace are retained. - | -
- Parameter - | - -- Description - | -
---|---|
- `$exception` - - _Exception_ - | - -- Required. The `Exception` you want to instrument. Only the first 10,000 characters from the stack trace are retained. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Specify key/value pairs of attributes to annotate the error message. The `TKey` must be a string, the `TValue` can be a string or object. - | -
- Parameter - | - -- Description - | -
---|---|
- `$error_message` - - _string_ - | - -- Required. Specify a string to report to New Relic as though it's an exception. This method creates both [error events](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) and [error traces](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details). Only the first 1023 characters are retained in error events, while error traces retain the full message. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Required (can be null). Specify key/value pairs of attributes to annotate the error message. The `TKey` must be a string, the `TValue` can be a string or object, to send no attributes, pass `null`. - | -
- Parameter - | - -- Description - | -
---|---|
- `$error_message` - - _string_ - | - -- Required. Specify a string to report to New Relic as though it's an exception. This method creates both [error events](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) and [error traces](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details). Only the first 1023 characters are retained in error events, while error traces retain the full message. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Required (can be null). Specify key/value pairs of attributes to annotate the error message. The `TKey` must be a string, the `TValue` can be a string or object, to send no attributes, pass `null`. - | -
- `$is_expected` - - _bool_ - | - -- Mark error as expected so that it won't affect Apdex score and error rate. - | -
- Parameter - | - -- Description - | -
---|---|
- `eventType` - - _string_ - | - -- Required. The name of the event type to record. Strings over 255 characters will result in the API call not being sent to New Relic. The name can only contain alphanumeric characters, underscores `_`, and colons `:`. For additional restrictions on event type names, see [Reserved words](/docs/data-apis/custom-data/custom-events/data-requirements-limits-custom-event-data/#reserved-words). - | -
- `attributeValues` - - _IEnumerable<string, object>_ - | - -- Required. Specify key/value pairs of attributes to annotate the event. - | -
- Parameter - | - -- Description - | -
---|---|
- `$metric_name` - - _string_ - | - -- Required. The name of the metric to record. Only the first 255 characters are retained. - | -
- `$metric_value` - - _single_ - | - -- Required. The quantity to record for the metric. - | -
- Parameter - | - -- Description - | -
---|---|
- `$metric_name` - - _string_ - | - -- Required. The name of the response time metric to record. Only the first 255 characters are retained. - | -
- `$metric_value` - - _Int64_ - | - -- Required. The response time to record in milliseconds. - | -
- Parameter - | - -- Description - | -
---|---|
- `$name` - - _string_ - | - -- Required. The primary application name. - | -
- `$name_2` - - `$name_3` - - _string_ - | - -- Optional. Second and third names for app rollup. For more information, see [Use multiple names for an app](/docs/agents/manage-apm-agents/app-naming/use-multiple-names-app). - | -
- Parameter - | - -- Description - | -
---|---|
- `$uri` - - _Uri_ - | - -- The URI of this transaction. - | -
- Parameter - | - -- Description - | -
---|---|
- `$user_value` - - _string_ - | - -- Required (can be null). Specify a name or username to associate with this page view. This value is assigned to the `user` key. - | -
- `$account_value` - - _string_ - | - -- Required (can be null). Specify the name of a user account to associate with this page view. This value is assigned to the `account` key. - | -
- `$product_value` - - _string_ - | - -- Required (can be null). Specify the name of a product to associate with this page view. This value is assigned to the `product` key. - | -
- Parameter - | - -- Description - | -
---|---|
- `$callback`
-
- _{'Func |
-
- - The callback to determine the error group name based on attribute data. - | -
- Parameter - | - -- Description - | -
---|---|
- `$callback`
-
- {'_Func |
-
- - The callback to determine the token count. - | -
- Parameter - | - -- Description - | -
---|---|
- `$category` - - _string_ - | - -
- Required. The category of this transaction, which you can use to distinguish different types of transactions. Defaults to |
-
- `$name` - - _string_ - | - -- Required. The name of the transaction. Only the first 255 characters are retained. - | -
- Name - | - -- Description - | -
---|---|
- `TraceId` - | - -- Returns a string representing the currently executing trace. If the trace ID is not available, or distributed tracing is disabled, the value will be `string.Empty`. - | -
- `SpanId` - | - -- Returns a string representing the currently executing span. If the span ID is not available, or distributed tracing is disabled, the value will be `string.Empty`. - | -
- `IsSampled` - | - -- Returns `true` if the current trace is sampled for inclusion, `false` if it is sampled out. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$override` - - _booleano_ - | - -- Opcional. Cuando `true`, desactiva toda inyección de script browser . Este indicador afecta tanto a la inyección manual como a la automática. Esto también anula la llamada [`GetBrowserTimingHeader()`](/docs/agents/net-agent/net-agent-api/getbrowsertimingheader-net-agent) . - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `nonce` - - _cadena_ - | - -- El nonce criptográfico por solicitud utilizado por las políticas de política de seguridad de contenido. - | -
- Si quieres... - | - -- Hacer esto... - | -
---|---|
- Evitar que una transacción se informe a New Relic - | - -- Utilice [`IgnoreTransaction()`](/docs/agents/net-agent/net-agent-api/ignore-transaction) o [un archivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#blocking-instrumentation) para ignorar la transacción. - | -
- Crear una transacción donde no existe ninguna - | - -- Utilice un [atributo](/docs/agents/net-agent/api-guides/custom-instrumentation-attributes-net) o [un archivo XML](/docs/agents/net-agent/instrumentation/net-custom-transactions) para crear una nueva transacción. - | -
- Si quieres... - | - -- Hacer esto... - | -
---|---|
- Cambiar el nombre de una transacción - | - -- Utilice [`SetTransactionName()`](/docs/agents/net-agent/net-agent-api/set-transaction-name) o [un archivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#name-transactions). - | -
- Evite que una transacción afecte su puntuación [Apdex](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#apdex) - | - -- Utilice [`IgnoreApdex()`](/docs/agents/net-agent/net-agent-api/ignore-apdex). - | -
- Agregue metadatos (como el nombre de la cuenta de sus clientes o el nivel de suscripción) a su transacción - | - -- Utilice [un atributo personalizado](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes). Ver [`AddCustomAttribute()`](/docs/agents/net-agent/net-agent-api/itransaction#addcustomattribute). - | -
- Si quieres... - | - -- Hacer esto... - | -
---|---|
- Traza un método asíncrono que New Relic ya está instrumentado - | - -- Utilice [un archivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) para implementar métodos asíncronos en aplicaciones IIS. Para obtener consejos sobre resolución de problemas, consulte [falta async métrica](/docs/agents/net-agent/troubleshooting/missing-async-metrics). - | -
- Traza un método asíncrono que New Relic no está instrumentado - | - -- Utilice [un archivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) para implementar métodos asíncronos en aplicaciones IIS. Para obtener consejos sobre resolución de problemas, consulte [falta async métrica](/docs/agents/net-agent/troubleshooting/missing-async-metrics). - | -
- Si quieres... - | - -- Hacer esto... - | -
---|---|
- Instrumento una solicitud saliente a una aplicación o base de datos externa. - | - -- Agregue una carga útil de rastreo distribuido a una solicitud saliente usando [`InsertDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#insertdistributedtraceheaders). - | -
- Conecte las solicitudes entrantes con el originador de la solicitud para completar un [tramo](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#span) de la traza. - | - -- Reciba una carga útil en una solicitud entrante usando [`AcceptDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#acceptdistributedtraceheaders). - | -
- Si quieres... - | - -- Hacer esto... - | -
---|---|
- Informar un error que el agente .NET no informa automáticamente - | - -- Utilice [`NoticeError()`](/docs/agents/net-agent/net-agent-api/notice-error). - | -
- Capture errores o evite que el agente .NET informe un error - | - -- Utilice su [archivo de configuración del agente .NET](/docs/agents/net-agent/configuration/net-agent-configuration#error_collector). - | -
- Si quieres... - | - -- Hacer esto... - | -
---|---|
- Envía datos sobre un evento para que puedas analizarlo en el panel - | - -- Crea un [evento personalizado](/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents#net-att). Ver [`RecordCustomEvent()`](/docs/agents/net-agent/net-agent-api/record-custom-event). - | -
- etiquete su evento con metadatos para filtrarlos y facetarlos en el panel o análisis de errores - | - -- Agregue [un atributo personalizado](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes). Consulte Atributo del agente .NET y [Habilitar y deshabilitar atributo](/docs/agents/net-agent/attributes/enable-disable-attributes-net). - | -
- Informar datos de rendimiento personalizados - | - -- Utilice [`RecordMetric()`](/docs/agents/net-agent/net-agent-api/record-metric) para crear una [métrica personalizada](/docs/agents/manage-apm-agents/agent-data/collect-custom-metrics). Para ver los datos, utilice el [generador de consultas](/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data). - | -
- Nombre - | - -- Descripción - | -
---|---|
- Transacción actual - | - -- Propiedad que proporciona acceso a la transacción que se está ejecutando actualmente a través de la interfaz [ITransaction](/docs/agents/net-agent/net-agent-api/itransaction) . Debe llamarse dentro de una [transacción](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#transaction). - | -
- Intervalo actual - | - -- Propiedad que proporciona acceso al tramo que se está ejecutando actualmente a través de la interfaz [ISpan](/docs/agents/net-agent/net-agent-api/iSpan) . - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$metric_name` - - _cadena_ - | - -- Requerido. El nombre de la métrica que se va a incrementar. - | -
- Nombre - | - -- Descripción - | -
---|---|
- [`AddCustomAttribute`](#addcustomattribute) - | - -- Agregue información contextual de su aplicación al intervalo actual en forma de atributo. - | -
- [`SetName`](#setname) - | - -- Cambia el nombre del tramo/segmento/métrica actual que se informará a New Relic. - | -
- Parámetro - | - -- Descripción - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _cadena_ - | - -- Identifica la información que se reporta. También conocido como el nombre. - - * No se admiten claves vacías. - * Las claves están limitadas a 255 bytes. Se ignorarán los atributos con claves mayores a 255 bytes. - | -||||||||||||||||
- `value` - - _objeto_ - | - -
- El valor que se informa.
-
-
|
-
- Parámetro - | - -- Descripción - | -
---|---|
- `name` - - _cadena_ - | - -- El nuevo nombre del tramo/segmento. - | -
- Nombre - | - -- Descripción - | -
---|---|
- [`AcceptDistributedTraceHeaders`](#acceptdistributedtraceheaders) - | - -- Acepta encabezados de contexto de traza entrantes de otro servicio. - | -
- [`InsertDistributedTraceHeaders`](#insertdistributedtraceheaders) - | - -- Agrega encabezados de contexto de traza a una solicitud saliente. - | -
- [`AcceptDistributedTracePayload` (obsoleto)](#acceptdistributedtracepayload) - | - -- Acepta una carga útil entrante de rastreo distribuido de otro servicio. - | -
- [`CreateDistributedTracePayload` (obsoleto)](#createdistributedtracepayload) - | - -- Crea una carga útil de rastreo distribuido para incluirla en una solicitud saliente. - | -
- [`AddCustomAttribute`](#addcustomattribute) - | - -- Agregue información contextual de su aplicación a la transacción actual en forma de atributo. - | -
- [`CurrentSpan`](#currentspan) - | - -- Proporciona acceso al [intervalo](/docs/agents/net-agent/net-agent-api/ispan) que se está ejecutando actualmente, que proporciona acceso a métodos específicos del intervalo en la API New Relic. - | -
- [`SetUserId`](#setuserid) - | - -- Asocia una identificación de usuario a la transacción actual. - | -
- Nombre - | - -- Descripción - | -
---|---|
- `carrier` - - _<T>_ - | - -- Requerido. Fuente de encabezados entrantes de contexto de traza. - | -
- `getter` - - _Func<T, string, IEnumerable<string>>_ - | - -- Requerido. Función definida por la persona que llama para extraer datos del encabezado del operador. - | -
- `transportType` - - _Enumeración tipo de transporte_ - | - -- Requerido. Describe el transporte de la carga útil entrante (por ejemplo `TransportType.HTTP`). - | -
- Nombre - | - -- Descripción - | -
---|---|
- `carrier` - - _<T>_ - | - -- Requerido. contenedor donde se insertan los encabezados de contexto de traza. - | -
- `setter` - - _Action<T, string, string>_ - | - -- Requerido. Acción definida por la persona que llama para insertar datos de encabezado en el operador. - | -
- Nombre - | - -- Descripción - | -
---|---|
- `payload` - - _cadena_ - | - -- Requerido. Una representación de cadena de la carga útil distribuida del rastreo entrante. - | -
- `transportType` - - _Tipo de transporte_ - _enumeración_ - | - -- Recomendado. Describe el transporte de la carga útil entrante (por ejemplo, `http`). - - Predeterminado `TransportType.Unknown`. - | -
- Parámetro - | - -- Descripción - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _cadena_ - | - -- Identifica la información que se reporta. También conocido como el nombre. - - * No se admiten claves vacías. - * Las claves están limitadas a 255 bytes. Se ignorarán los atributos con claves mayores a 255 bytes. - | -||||||||||||||||
- `value` - - _objeto_ - | - -
- El valor que se informa.
-
-
|
-
- Parámetro - | - -- Descripción - | -
---|---|
- `userId` - - _cadena_ - | - -- El ID de usuario que se asociará con esta transacción. - - * `null`, los valores vacíos y de espacios en blanco se ignorarán. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$exception` - - _Excepción_ - | - -- Requerido. El `Exception` que quieres instrumento. Sólo se conservan los primeros 10.000 caracteres del rastreo del stack. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$exception` - - _Excepción_ - | - -- Requerido. El `Exception` que quieres instrumento. Sólo se conservan los primeros 10.000 caracteres del rastreo del stack. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Especifique los pares principales de valor del atributo para anotar el mensaje de error. El `TKey` debe ser una cadena, el `TValue` puede ser una cadena u un objeto. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$error_message` - - _cadena_ - | - -- Requerido. Especifique una cadena para informar a New Relic como si fuera una excepción. Este método crea tanto [error evento](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) como [error traza](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details). En error evento solo se retienen los primeros 1023 caracteres, mientras que error traza retiene el mensaje completo. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Requerido (puede ser nulo). Especifique los pares principales de valor del atributo para anotar el mensaje de error. El `TKey` debe ser una cadena, el `TValue` puede ser una cadena u objeto, para enviar ningún atributo pasa `null`. - - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$error_message` - - _cadena_ - | - -- Requerido. Especifique una cadena para informar a New Relic como si fuera una excepción. Este método crea tanto [error evento](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) como [error traza](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details). En error evento solo se retienen los primeros 1023 caracteres, mientras que error traza retiene el mensaje completo. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Requerido (puede ser nulo). Especifique los pares principales de valor del atributo para anotar el mensaje de error. El `TKey` debe ser una cadena, el `TValue` puede ser una cadena u objeto, para enviar ningún atributo pasa `null`. - | -
- `$is_expected` - - _bool_ - | - -- Marque el error como se esperaba para que no afecte la puntuación Apdex ni la tasa de errores. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `eventType` - - _cadena_ - | - -- Requerido. El nombre del tipo de evento a registrar. Las cadenas de más de 255 caracteres darán como resultado que la llamada API no se envíe a New Relic. El nombre solo puede contener caracteres alfanuméricos, guiones bajos `_` y dos puntos `:`. Para conocer restricciones adicionales sobre nombres de tipos de eventos, consulte [Palabras reservadas](/docs/insights/nrql-new-relic-query-language/nrql-resources/reserved-words). - | -
- `attributeValues` - - _IEnumerable<string, object>_ - | - -- Requerido. Especifique el valor principal de los pares de atributos para anotar el evento. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$metric_name` - - _cadena_ - | - -- Requerido. El nombre de la métrica a registrar. Sólo se conservan los primeros 255 caracteres. - | -
- `$metric_value` - - _soltero_ - | - -- Requerido. La cantidad que se registrará para la métrica. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$metric_name` - - _cadena_ - | - -- Requerido. El nombre de la métrica de tiempo de respuesta que se va a registrar. Sólo se conservan los primeros 255 caracteres. - | -
- `$metric_value` - - _Int64_ - | - -- Requerido. El tiempo de respuesta para grabar en milisegundos. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$name` - - _cadena_ - | - -- Requerido. El nombre de la aplicación principal. - | -
- `$name_2` - - `$name_3` - - _cadena_ - | - -- Opcional. Segundo y tercer nombre para la acumulación de aplicaciones. Para obtener más información, consulte [Usar varios nombres para una aplicación](/docs/agents/manage-apm-agents/app-naming/use-multiple-names-app). - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$uri` - - _Uri_ - | - -- El URI de esta transacción. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$user_value` - - _cadena_ - | - -- Requerido (puede ser nulo). Especifique un nombre o nombre de usuario para asociarlo con esta vista de página. Este valor se asigna a la clave `user` . - | -
- `$account_value` - - _cadena_ - | - -- Requerido (puede ser nulo). Especifique el nombre de una cuenta de usuario para asociarla con esta vista de página. Este valor se asigna a la clave `account` . - | -
- `$product_value` - - _cadena_ - | - -- Requerido (puede ser nulo). Especifique el nombre de un producto para asociarlo con esta vista de página. Este valor se asigna a la clave `product` . - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$callback` - - _'Func<IReadOnlyDictionary<string,object>,string>'_ - | - -- La devolución de llamada para determinar el nombre del grupo de errores en función de los datos del atributo. - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$callback` - - '\_Func<string, string, int>\_' - | - -- La devolución de llamada para determinar el recuento token . - | -
- Parámetro - | - -- Descripción - | -
---|---|
- `$category` - - _cadena_ - | - -
- Requerido. La categoría de esta transacción, que puede utilizar para distinguir diferentes tipos de transacciones. El valor predeterminado es |
-
- `$name` - - _cadena_ - | - -- Requerido. El nombre de la transacción. Sólo se conservan los primeros 255 caracteres. - | -
- Nombre - | - -- Descripción - | -
---|---|
- `TraceId` - | - -- Devuelve una cadena que representa la traza que se está ejecutando actualmente. Si la traza ID no está disponible, o el rastreo distribuido está deshabilitado, el valor será `string.Empty`. - | -
- `SpanId` - | - -- Devuelve una cadena que representa el intervalo de ejecución actual. Si el span ID no está disponible o el rastreo distribuido está deshabilitado, el valor será `string.Empty`. - | -
- `IsSampled` - | - -- Devuelve `true` si se toma una muestra de la traza actual para su inclusión, `false` si se toma una muestra. - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$override` - - _ブール値_ - | - -- オプション。`true`の場合、ブラウザ スクリプトのすべての挿入が無効になります。このフラグは、手動注入と自動注入の両方に影響します。これにより、 [`GetBrowserTimingHeader()`](/docs/agents/net-agent/net-agent-api/getbrowsertimingheader-net-agent)呼び出しもオーバーライドされます。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `nonce` - - _ストリング_ - | - -- Content-Security-Policyポリシーで使用される、リクエストごとの暗号化されたノンスです。 - | -
- あなたがしたい場合は... - | - -- これを行う... - | -
---|---|
- トランザクションがNewRelicに報告されないようにする - | - -- [`IgnoreTransaction()`](/docs/agents/net-agent/net-agent-api/ignore-transaction) または [XMLファイル](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#blocking-instrumentation)を使用して、トランザクションを無視します。 - | -
- トランザクションが存在しない場所にトランザクションを作成する - | - -- [属性](/docs/agents/net-agent/api-guides/custom-instrumentation-attributes-net)または [XMLファイル](/docs/agents/net-agent/instrumentation/net-custom-transactions)を使用して新しいトランザクションを作成します。 - | -
- あなたがしたい場合は... - | - -- これを行う... - | -
---|---|
- トランザクションの名前を変更する - | - -- [`SetTransactionName()`](/docs/agents/net-agent/net-agent-api/set-transaction-name)または[XMLファイル](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#name-transactions)を使用します。 - | -
- トランザクションが[Apdex](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#apdex)スコアに影響しないようにする - | - -- [`IgnoreApdex()`](/docs/agents/net-agent/net-agent-api/ignore-apdex)を使用します。 - | -
- トランザクションにメタデータ(顧客のアカウント名またはサブスクリプションレベルなど)を追加する - | - -- [カスタムアトリビュート](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes)を使用します。[`AddCustomAttribute()`](/docs/agents/net-agent/net-agent-api/itransaction#addcustomattribute)をご覧ください。 - | -
- あなたがしたい場合は... - | - -- これを行う... - | -
---|---|
- New Relicがすでにインストゥルメントしている非同期メソッドをトレースする - | - -- [XMLファイル](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async)を使用して、IISアプリの非同期メソッドをインストゥルメントします。トラブルシューティングのヒントについては、[欠落している非同期メトリクス](/docs/agents/net-agent/troubleshooting/missing-async-metrics)を参照してください。 - | -
- New Relicがインストゥルメントしていない非同期メソッドをトレースする - | - -- [XMLファイル](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async)を使用して、IISアプリの非同期メソッドをインストゥルメントします。トラブルシューティングのヒントについては、[欠落している非同期メトリクス](/docs/agents/net-agent/troubleshooting/missing-async-metrics)を参照してください。 - | -
- あなたがしたい場合は... - | - -- これを行う... - | -
---|---|
- 外部アプリケーションまたはデータベースに対する発信リクエストを計測する - | - -- [`InsertDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#insertdistributedtraceheaders)を使用して、発信リクエストにディストリビューティッド(分散)トレースペイロードを追加します。 - | -
- 着信リクエストをリクエストの発信者に結び付けてトレースの[スパン](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#span)を完了する - | - -- [`AcceptDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#acceptdistributedtraceheaders)を使用して受信リクエストでペイロードを受信します。 - | -
- あなたがしたい場合は... - | - -- これを行う... - | -
---|---|
- .NETエージェントが自動的に報告しないエラーを報告する - | - -- [`NoticeError()`](/docs/agents/net-agent/net-agent-api/notice-error)を使用します。 - | -
- エラーをキャプチャするか、.NETエージェントがエラーをレポートしないようにする - | - -- [.NETエージェントの設定ファイル](/docs/agents/net-agent/configuration/net-agent-configuration#error_collector)を使用します。 - | -
- あなたがしたい場合は... - | - -- これを行う... - | -
---|---|
- ダッシュボードで分析できるように、イベントに関するデータを送信する - | - -- [カスタムイベント](/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents#net-att)を作成します。[`RecordCustomEvent()`](/docs/agents/net-agent/net-agent-api/record-custom-event)をご覧ください。 - | -
- メタデータを使用してイベントにタグ付けし、ダッシュボードまたはエラー分析でフィルターしてファセットする - | - -- [カスタムアトリビュート](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes)を追加します。.NETエージェントの属性と[属性の有効化/無効化](/docs/agents/net-agent/attributes/enable-disable-attributes-net)を参照してください。 - | -
- カスタムパフォーマンスデータを報告する - | - -- [`RecordMetric()`](/docs/agents/net-agent/net-agent-api/record-metric)を使用して、[カスタムメトリック](/docs/agents/manage-apm-agents/agent-data/collect-custom-metrics)を作成します。データを表示するには、[クエリビルダー](/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data)を使用します。 - | -
- 名前 - | - -- 説明 - | -
---|---|
- CurrentTransaction - | - -- [ITransaction](/docs/agents/net-agent/net-agent-api/itransaction) インターフェースを介して、現在実行中のトランザクションへのアクセスを提供するプロパティです。 [トランザクションの中で呼び出されなければなりません](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#transaction) 。 - | -
- カレントスパン - | - -- [ISpan](/docs/agents/net-agent/net-agent-api/iSpan) インターフェースを介して、現在実行中のスパンへのアクセスを提供するプロパティ。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$metric_name` - - _ストリング_ - | - -- 必要です。インクリメントするメトリックの名前です。 - | -
- 名前 - | - -- 説明 - | -
---|---|
- [`AddCustomAttribute`](#addcustomattribute) - | - -- アプリケーションからのコンテキスト情報を、属性の形で現在のスパンに追加します。 - | -
- [`SetName`](#setname) - | - -- New Relic に報告される現在のスパン/セグメント/メトリクスの名前を変更します。 - | -
- パラメータ - | - -- 説明 - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _ストリング_ - | - -- 報告される情報を特定するもの。名称としても知られている。 - - * 空のキーには対応していません。 - * キーは255バイトに制限されています。255バイト以上のキーを持つアトリビュートは無視されます。 - | -||||||||||||||||
- `value` - - _物体_ - | - -
- 報告される値です。
-
- **注**: `null` 値は記録されません。
-
-
|
-
- パラメータ - | - -- 説明 - | -
---|---|
- `name` - - _ストリング_ - | - -- スパン/セグメントの新しい名前。 - | -
- 名前 - | - -- 説明 - | -
---|---|
- [`AcceptDistributedTraceHeaders`](#acceptdistributedtraceheaders) - | - -- 他のサービスから送られてくるトレースコンテキストヘッダを受信します。 - | -
- [`InsertDistributedTraceHeaders`](#insertdistributedtraceheaders) - | - -- 発信するリクエストにトレースコンテキストヘッダを追加します。 - | -
- [`AcceptDistributedTracePayload` (廃止)](#acceptdistributedtracepayload) - | - -- 他のサービスからの分散型トレースペイロードを受信します。 - | -
- [`CreateDistributedTracePayload` (廃止)](#createdistributedtracepayload) - | - -- 発信するリクエストに含める分散型トレースペイロードを作成します。 - | -
- [`AddCustomAttribute`](#addcustomattribute) - | - -- アプリケーションのコンテキスト情報を属性の形で現在のトランザクションに追加します。 - | -
- [`CurrentSpan`](#currentspan) - | - -- 現在実行中の [span](/docs/agents/net-agent/net-agent-api/ispan) へのアクセスを提供し、New Relic API の span 固有のメソッドへのアクセスを提供します。 - | -
- [`SetUserId`](#setuserid) - | - -- ユーザー ID を現在のトランザクションに関連付けます。 - | -
- 名前 - | - -- 説明 - | -
---|---|
- `carrier` - - _<T>_ - | - -- 必要です。受信するTrace Contextヘッダーのソース。 - | -
- `getter` - - _Func<T, string, IEnumerable<string>>_ - | - -- 必要です。キャリアからヘッダーデータを抽出するための呼び出し側定義の関数。 - | -
- `transportType` - - _トランスポートタイプ enum_ - | - -- 必要。着信ペイロードのトランスポートを記述します (例: `TransportType.HTTP` )。 - | -
- 名前 - | - -- 説明 - | -
---|---|
- `carrier` - - _<T>_ - | - -- 必要です。Trace Context ヘッダが挿入されるコンテナです。 - | -
- `setter` - - _アクション<T, string, string>_ - | - -- 必要です。呼び出し側が定義した、キャリアにヘッダーデータを挿入するためのアクション。 - | -
- 名前 - | - -- 説明 - | -
---|---|
- `payload` - - _ストリング_ - | - -- 必要です。受信した分散型トレースのペイロードの文字列表現。 - | -
- `transportType` - - _TransportType_ - _enum_ - | - -- おすすめされた。着信ペイロードのトランスポートを記述します (例: `http` )。 - - デフォルト`TransportType.Unknown` 。 - | -
- パラメータ - | - -- 説明 - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _ストリング_ - | - -- 報告される情報を特定するもの。名称としても知られている。 - - * 空のキーには対応していません。 - * キーは255バイトに制限されています。255バイト以上のキーを持つアトリビュートは無視されます。 - | -||||||||||||||||
- `value` - - _物体_ - | - -
- 報告される値です。
-
- **注**: `null` 値は記録されません。
-
-
|
-
- パラメータ - | - -- 説明 - | -
---|---|
- `userId` - - _ストリング_ - | - -- このトランザクションに関連付けられるユーザー ID。 - - * `null`、空および空白の値は無視されます。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$exception` - - _例外_ - | - -- 必須。インストルメントする`Exception` 。スタックトレースの最初の10,000文字のみが保持されます。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$exception` - - _例外_ - | - -- 必須。インストルメントする`Exception` 。スタックトレースの最初の10,000文字のみが保持されます。 - | -
- `$attributes` - - _IDictionary <TKey、TValue>_ - | - -- エラーメッセージに注釈を付けるには、属性のキーと値のペアを指定します。`TKey`は文字列である必要があり、 `TValue`は文字列またはオブジェクトである可能性があります。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$error_message` - - _ストリング_ - | - -- 必須。例外であるかのようにNewRelicに報告する文字列を指定します。このメソッドは、[エラーイベント](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events)と[エラートレース](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details)の両方を作成します。エラーイベントでは最初の1023文字のみが保持され、エラートレースではメッセージ全体が保持されます。 - | -
- `$attributes` - - _IDictionary <TKey、TValue>_ - | - -- 必須(nullの場合もあります)。エラーメッセージに注釈を付けるには、属性のキーと値のペアを指定します。`TKey`は文字列である必要があり、 `TValue`は文字列またはオブジェクトである可能性があります。属性を送信しない場合は、 `null`を渡します。 - - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$error_message` - - _ストリング_ - | - -- 必須。例外であるかのようにNewRelicに報告する文字列を指定します。このメソッドは、[エラーイベント](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events)と[エラートレース](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details)の両方を作成します。エラーイベントでは最初の1023文字のみが保持され、エラートレースではメッセージ全体が保持されます。 - | -
- `$attributes` - - _IDictionary <TKey、TValue>_ - | - -- 必須(nullの場合もあります)。エラーメッセージに注釈を付けるには、属性のキーと値のペアを指定します。`TKey`は文字列である必要があり、 `TValue`は文字列またはオブジェクトである可能性があります。属性を送信しない場合は、 `null`を渡します。 - | -
- `$is_expected` - - _bool_ - | - -- Apdexのスコアやエラーレートに影響を与えないように、エラーを予想通りにマークします。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `eventType` - - _ストリング_ - | - -- 必須。 記録するイベント タイプの名前。 文字列が 255 文字を超えると、API 呼び出しがNew Relicに送信されません。 名前には英数字、アンダースコア`_` 、コロン`:`のみを含めることができます。 イベント タイプ名に関する追加の制限については、 [「予約語」](/docs/data-apis/custom-data/custom-events/data-requirements-limits-custom-event-data/#reserved-words)を参照してください。 - | -
- `attributeValues` - - _IEnumerable<string, object>_ - | - -- 必須項目です。イベントをアノテーションするための属性のキー/バリューペアを指定します。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$metric_name` - - _ストリング_ - | - -- 必須項目です。記録するメトリックの名前です。最初の255文字のみが保持されます。 - | -
- `$metric_value` - - _シングル_ - | - -- 必須です。メトリクスに記録する数量です。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$metric_name` - - _ストリング_ - | - -- 必須です。記録する応答時間メトリックの名前です。最初の255文字のみが保持されます。 - | -
- `$metric_value` - - _Int64_ - | - -- 必須です。記録する応答時間をミリ秒単位で指定します。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$name` - - _ストリング_ - | - -- 必須項目です。プライマリアプリケーション名です。 - | -
- `$name_2` - - `$name_3` - - _ストリング_ - | - -- 任意です。アプリのロールアップの2つ目と3つ目の名前。詳しくは、 [Use multiple names for an app](/docs/agents/manage-apm-agents/app-naming/use-multiple-names-app) をご覧ください。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$uri` - - _Uri_ - | - -- このトランザクションのURIです。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$user_value` - - _ストリング_ - | - -- 必須 (null の場合もあります)。このページ ビューに関連付ける名前またはユーザー名を指定します。この値は`user`キーに割り当てられます。 - | -
- `$account_value` - - _ストリング_ - | - -- 必須 (null の場合もあります)。このページ ビューに関連付けるユーザー アカウントの名前を指定します。この値は`account`キーに割り当てられます。 - | -
- `$product_value` - - _ストリング_ - | - -- 必須 (null の場合もあります)。このページ ビューに関連付ける製品の名前を指定します。この値は`product`キーに割り当てられます。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$callback` - - _'Func<IReadOnlyDictionary<string,object>,string>'_ - | - -- 属性データに基づいてエラー グループ名を決定するためのコールバック。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$callback` - - '\_Func\_' - | - -- トークン数を決定するコールバック。 - | -
- パラメータ - | - -- 説明 - | -
---|---|
- `$category` - - _ストリング_ - | - -- 必須。さまざまなタイプのトランザクションを区別するために使用できる、このトランザクションのカテゴリ。デフォルトは**`Custom`**です。最初の 255 文字のみが保持されます。 - | -
- `$name` - - _ストリング_ - | - -- 必須項目です。トランザクションの名前です。最初の255文字のみが保持されます。 - | -
- 名前 - | - -- 説明 - | -
---|---|
- `TraceId` - | - -- 現在実行中のトレースを表す文字列を返します。トレース ID が利用できない場合、または分散トレースが無効になっている場合、値は`string.Empty`になります。 - | -
- `SpanId` - | - -- 現在実行中のスパンを表す文字列を返します。スパン ID を使用できない場合、または分散トレースが無効になっている場合、値は`string.Empty`になります。 - | -
- `IsSampled` - | - -- 現在のトレースが含めるためにサンプリングされている場合は`true`を返し、サンプリングされている場合は`false`を返します。 - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$override` - - _부울_ - | - -- 선택 과목. `true` 인 경우 브라우저 스크립트의 모든 삽입을 비활성화합니다. 이 플래그는 수동 및 자동 주입 모두에 영향을 줍니다. 이것은 또한 [`GetBrowserTimingHeader()`](/docs/agents/net-agent/net-agent-api/getbrowsertimingheader-net-agent) 호출을 재정의합니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `nonce` - - _끈_ - | - -- Content-Security-Policy 정책에서 사용하는 요청별 암호화 논스입니다. - | -
- 원하는 경우... - | - -- 이게 ... - | -
---|---|
- 트랜잭션이 New Relic에 보고되는 것을 방지 - | - -- 트랜잭션을 무시하려면 [`IgnoreTransaction()`](/docs/agents/net-agent/net-agent-api/ignore-transaction) 또는 [XML 파일](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#blocking-instrumentation) 을 사용하세요. - | -
- 존재하지 않는 트랜잭션 생성 - | - -- [속성](/docs/agents/net-agent/api-guides/custom-instrumentation-attributes-net) 또는 [XML 파일](/docs/agents/net-agent/instrumentation/net-custom-transactions) 을 사용하여 새 트랜잭션을 만듭니다. - | -
- 원하는 경우... - | - -- 이게 ... - | -
---|---|
- 트랜잭션 이름 변경 - | - -- [`SetTransactionName()`](/docs/agents/net-agent/net-agent-api/set-transaction-name) 또는 [XML 파일을](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#name-transactions) 사용합니다. - | -
- 거래가 [Apdex](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#apdex) 점수에 영향을 미치지 않도록 방지 - | - -- [`IgnoreApdex()`](/docs/agents/net-agent/net-agent-api/ignore-apdex) 을(를) 사용합니다. - | -
- 거래에 메타데이터(예: 고객의 계정 이름 또는 구독 수준)를 추가합니다. - | - -- [사용자 정의 속성](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes) 을 사용하십시오.[`AddCustomAttribute()`](/docs/agents/net-agent/net-agent-api/itransaction#addcustomattribute) 을(를) 참조하세요. - | -
- 원하는 경우... - | - -- 이게 ... - | -
---|---|
- New Relic이 이미 계측하고 있는 비동기 메서드 추적 - | - -- [XML 파일을 사용하여](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) IIS 앱에서 비동기 메서드를 계측합니다. 문제 해결 팁은 [비동기 측정항목 누락](/docs/agents/net-agent/troubleshooting/missing-async-metrics) 을 참조하세요. - | -
- New Relic이 계측하지 않는 비동기 메서드 추적 - | - -- [XML 파일을 사용하여](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) IIS 앱에서 비동기 메서드를 계측합니다. 문제 해결 팁은 [비동기 측정항목 누락](/docs/agents/net-agent/troubleshooting/missing-async-metrics) 을 참조하세요. - | -
- 원하는 경우... - | - -- 이게 ... - | -
---|---|
- 외부 애플리케이션 또는 데이터베이스에 대한 발신 요청 계측 - | - -- [`InsertDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#insertdistributedtraceheaders) 사용하여 발신 요청에 분산 추적 페이로드를 추가합니다. - | -
- 들어오는 요청을 요청의 발신자와 연결하여 추적 [범위](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#span) 를 완료합니다. - | - -- [`AcceptDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#acceptdistributedtraceheaders) 사용하여 들어오는 요청에서 페이로드를 받습니다. - | -
- 원하는 경우... - | - -- 이게 ... - | -
---|---|
- .NET 에이전트가 자동으로 보고하지 않는 오류 보고 - | - -- [`NoticeError()`](/docs/agents/net-agent/net-agent-api/notice-error) 을(를) 사용합니다. - | -
- 오류를 캡처하거나 .NET 에이전트가 오류를 보고하지 못하도록 방지 - | - -- [.NET 에이전트 구성 파일](/docs/agents/net-agent/configuration/net-agent-configuration#error_collector) 을 사용합니다. - | -
- 원하는 경우... - | - -- 이게 ... - | -
---|---|
- 대시보드에서 분석할 수 있도록 이벤트에 대한 데이터 보내기 - | - -- [맞춤 이벤트](/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents#net-att) 를 만듭니다. [`RecordCustomEvent()`](/docs/agents/net-agent/net-agent-api/record-custom-event) 을(를) 참조하세요. - | -
- 대시보드 또는 오류 분석에서 이벤트를 필터링하고 패싯하기 위해 메타데이터로 이벤트에 태그 지정 - | - -- [사용자 정의 속성](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes) 을 추가합니다. .NET 에이전트 속성 및 속성 [활성화 및 비활성화](/docs/agents/net-agent/attributes/enable-disable-attributes-net) 를 참조하십시오. - | -
- 맞춤 실적 데이터 보고 - | - -- [`RecordMetric()`](/docs/agents/net-agent/net-agent-api/record-metric) 을 사용하여 [맞춤 측정항목](/docs/agents/manage-apm-agents/agent-data/collect-custom-metrics) 을 만듭니다. 데이터를 보려면 [쿼리 작성기](/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data) 를 사용하세요. - | -
- 이름 - | - -- 설명 - | -
---|---|
- 현재 트랜잭션 - | - -- [ITransaction](/docs/agents/net-agent/net-agent-api/itransaction) 인터페이스를 통해 현재 실행 중인 트랜잭션에 대한 액세스를 제공하는 속성입니다. [트랜잭션](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#transaction) 내에서 호출되어야 합니다. - | -
- 현재 범위 - | - -- [ISpan](/docs/agents/net-agent/net-agent-api/iSpan) 인터페이스를 통해 현재 실행 중인 범위에 대한 액세스를 제공하는 속성입니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$metric_name` - - _끈_ - | - -- 필수의. 증가시킬 메트릭의 이름입니다. - | -
- 이름 - | - -- 설명 - | -
---|---|
- [`AddCustomAttribute`](#addcustomattribute) - | - -- 애플리케이션의 컨텍스트 정보를 속성 형식으로 현재 범위에 추가합니다. - | -
- [`SetName`](#setname) - | - -- New Relic에 보고될 현재 스팬/세그먼트/메트릭의 이름을 변경합니다. - | -
- 매개변수 - | - -- 설명 - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _끈_ - | - -- 보고되는 정보를 식별합니다. 이름으로도 알려져 있습니다. - - * 빈 키는 지원되지 않습니다. - * 키는 255바이트로 제한됩니다. 255바이트보다 큰 키가 있는 속성은 무시됩니다. - | -||||||||||||||||
- `value` - - _물체_ - | - -
- 보고되는 값입니다.
-
- **참고**: `null` 값은 기록되지 않습니다.
-
-
|
-
- 매개변수 - | - -- 설명 - | -
---|---|
- `name` - - _끈_ - | - -- 범위/세그먼트의 새 이름입니다. - | -
- 이름 - | - -- 설명 - | -
---|---|
- [`AcceptDistributedTraceHeaders`](#acceptdistributedtraceheaders) - | - -- 다른 서비스에서 들어오는 추적 컨텍스트 헤더를 수락합니다. - | -
- [`InsertDistributedTraceHeaders`](#insertdistributedtraceheaders) - | - -- 나가는 요청에 추적 컨텍스트 헤더를 추가합니다. - | -
- [`AcceptDistributedTracePayload` (구식)](#acceptdistributedtracepayload) - | - -- 다른 서비스에서 들어오는 분산 추적 페이로드를 수락합니다. - | -
- [`CreateDistributedTracePayload` (구식)](#createdistributedtracepayload) - | - -- 나가는 요청에 포함할 분산 추적 페이로드를 만듭니다. - | -
- [`AddCustomAttribute`](#addcustomattribute) - | - -- 애플리케이션의 컨텍스트 정보를 속성 형식으로 현재 트랜잭션에 추가합니다. - | -
- [`CurrentSpan`](#currentspan) - | - -- 현재 실행 중인 [범위](/docs/agents/net-agent/net-agent-api/ispan) 에 대한 액세스를 제공합니다. 이는 New Relic API의 범위별 메서드에 대한 액세스를 제공합니다. - | -
- [`SetUserId`](#setuserid) - | - -- 사용자 ID를 현재 트랜잭션에 연결합니다. - | -
- 이름 - | - -- 설명 - | -
---|---|
- `carrier` - - _<티>_ - | - -- 필수의. 들어오는 추적 컨텍스트 헤더의 소스입니다. - | -
- `getter` - - _Func<T, 문자열, IEnumerable<문자열>>_ - | - -- 필수의. 캐리어에서 헤더 데이터를 추출하는 호출자 정의 함수. - | -
- `transportType` - - _TransportType 열거형_ - | - -- 필수의. 수신 페이로드의 전송을 설명합니다(예: `TransportType.HTTP` ). - | -
- 이름 - | - -- 설명 - | -
---|---|
- `carrier` - - _<티>_ - | - -- 필수의. Trace Context 헤더가 삽입되는 컨테이너.. - | -
- `setter` - - _액션<T, 문자열, 문자열>_ - | - -- 필수의. 헤더 데이터를 캐리어에 삽입하기 위한 호출자 정의 작업입니다. - | -
- 이름 - | - -- 설명 - | -
---|---|
- `payload` - - _끈_ - | - -- 필수의. 들어오는 분산 추적 페이로드의 문자열 표현입니다. - | -
- `transportType` - - _전송 유형_ - _열거_ - | - -- 추천. 수신 페이로드의 전송을 설명합니다(예: `http` ). - - 기본값 `TransportType.Unknown` . - | -
- 매개변수 - | - -- 설명 - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _끈_ - | - -- 보고되는 정보를 식별합니다. 이름으로도 알려져 있습니다. - - * 빈 키는 지원되지 않습니다. - * 키는 255바이트로 제한됩니다. 255바이트보다 큰 키가 있는 속성은 무시됩니다. - | -||||||||||||||||
- `value` - - _물체_ - | - -
- 보고되는 값입니다.
-
- **참고**: `null` 값은 기록되지 않습니다.
-
-
|
-
- 매개변수 - | - -- 설명 - | -
---|---|
- `userId` - - _끈_ - | - -- 이 거래와 관련된 사용자 ID입니다. - - * `null`, 공백 및 공백 값은 무시됩니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$exception` - - _예외_ - | - -- 필수의. 계측하려는 `Exception` . 스택 추적의 처음 10,000자만 유지됩니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$exception` - - _예외_ - | - -- 필수의. 계측하려는 `Exception` . 스택 추적의 처음 10,000자만 유지됩니다. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- 오류 메시지에 주석을 달기 위해 속성의 키/값 쌍을 지정하십시오. `TKey` 은 문자열이어야 하며 `TValue` 은 문자열 또는 객체일 수 있습니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$error_message` - - _끈_ - | - -- 필수의. 예외인 것처럼 New Relic에 보고할 문자열을 지정합니다. 이 메서드는 [오류 이벤트](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) 와 [오류 추적](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details) 을 모두 만듭니다. 처음 1023자만 오류 이벤트에 유지되는 반면 오류 추적은 전체 메시지를 유지합니다. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- 필수(null일 수 있음). 오류 메시지에 주석을 달기 위해 속성의 키/값 쌍을 지정하십시오. `TKey` 은 문자열이어야 하고, `TValue` 은 문자열 또는 객체일 수 있으며, 속성을 전송하지 않으려면 `null` 를 전달합니다. - - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$error_message` - - _끈_ - | - -- 필수의. 예외인 것처럼 New Relic에 보고할 문자열을 지정합니다. 이 메서드는 [오류 이벤트](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) 와 [오류 추적](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details) 을 모두 만듭니다. 처음 1023자만 오류 이벤트에 유지되는 반면 오류 추적은 전체 메시지를 유지합니다. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- 필수(null일 수 있음). 오류 메시지에 주석을 달기 위해 속성의 키/값 쌍을 지정하십시오. `TKey` 은 문자열이어야 하고, `TValue` 은 문자열 또는 객체일 수 있으며, 속성을 전송하지 않으려면 `null` 를 전달합니다. - | -
- `$is_expected` - - _부울_ - | - -- Apdex 점수 및 오류율에 영향을 미치지 않도록 오류를 예상대로 표시합니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `eventType` - - _끈_ - | - -- 필수의. 기록할 이벤트 유형의 이름입니다. 255자를 초과하는 문자열을 사용하면 API 호출이 뉴렐릭으로 전송되지 않습니다. 이름에는 영숫자 문자, 밑줄 `_` 및 콜론 `:` 만 포함할 수 있습니다. 이벤트 유형 이름에 대한 추가 제한 사항은 [예약어를](/docs/data-apis/custom-data/custom-events/data-requirements-limits-custom-event-data/#reserved-words) 참조하세요. - | -
- `attributeValues` - - _IEnumerable<string, object>_ - | - -- 필수의. 이벤트에 주석을 추가할 속성의 키/값 쌍을 지정하십시오. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$metric_name` - - _끈_ - | - -- 필수의. 기록할 측정항목의 이름입니다. 처음 255자만 유지됩니다. - | -
- `$metric_value` - - _하나의_ - | - -- 필수의. 메트릭에 대해 기록할 수량입니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$metric_name` - - _끈_ - | - -- 필수의. 기록할 응답 시간 메트릭의 이름입니다. 처음 255자만 유지됩니다. - | -
- `$metric_value` - - _Int64_ - | - -- 필수의. 기록할 응답 시간(밀리초)입니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$name` - - _끈_ - | - -- 필수의. 기본 애플리케이션 이름입니다. - | -
- `$name_2` - - `$name_3` - - _끈_ - | - -- 선택 과목. 앱 롤업의 두 번째 및 세 번째 이름입니다. 자세한 내용 [은 앱에 여러 이름 사용](/docs/agents/manage-apm-agents/app-naming/use-multiple-names-app) 을 참조하십시오. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$uri` - - _우리_ - | - -- 이 트랜잭션의 URI입니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$user_value` - - _끈_ - | - -- 필수(null일 수 있음). 이 페이지 보기와 연결할 이름 또는 사용자 이름을 지정하십시오. 이 값은 `user` 키에 할당됩니다. - | -
- `$account_value` - - _끈_ - | - -- 필수(null일 수 있음). 이 페이지 보기와 연결할 사용자 계정의 이름을 지정하십시오. 이 값은 `account` 키에 할당됩니다. - | -
- `$product_value` - - _끈_ - | - -- 필수(null일 수 있음). 이 페이지 보기와 연결할 제품의 이름을 지정하십시오. 이 값은 `product` 키에 할당됩니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$callback` - - _'Func<IReadOnlyDictionary<string,object>,string>'_ - | - -- 속성 데이터를 기반으로 오류 그룹 이름을 결정하는 콜백입니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$callback` - - '\_Func<string, string, int>\_' - | - -- 토큰 수를 결정하는 콜백입니다. - | -
- 매개변수 - | - -- 설명 - | -
---|---|
- `$category` - - _끈_ - | - -- 필수의. 다양한 유형의 거래를 구별하는 데 사용할 수 있는 이 거래의 범주입니다. 기본값은 **`Custom`** 입니다. 처음 255자만 유지됩니다. - | -
- `$name` - - _끈_ - | - -- 필수의. 트랜잭션의 이름입니다. 처음 255자만 유지됩니다. - | -
- 이름 - | - -- 설명 - | -
---|---|
- `TraceId` - | - -- 현재 실행 중인 추적을 나타내는 문자열을 반환합니다. 추적 ID를 사용할 수 없거나 분산 추적이 비활성화된 경우 값은 `string.Empty` 입니다. - | -
- `SpanId` - | - -- 현재 실행 중인 범위를 나타내는 문자열을 반환합니다. 스팬 ID를 사용할 수 없거나 분산 추적이 비활성화된 경우 값은 `string.Empty` 입니다. - | -
- `IsSampled` - | - -- 현재 추적이 포함을 위해 샘플링된 경우 `true` 을 반환하고 샘플링된 경우 `false` 을 반환합니다. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$override` - - _boleano_ - | - -- Opcional. Quando `true`, desativa toda injeção de script do browser. Este sinalizador afeta a injeção manual e automática. Isso também substitui a chamada [`GetBrowserTimingHeader()`](/docs/agents/net-agent/net-agent-api/getbrowsertimingheader-net-agent) . - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `nonce` - - _corda_ - | - -- O nonce criptográfico por solicitação usado pelas políticas de Política de Segurança de Conteúdo. - | -
- Se você quiser... - | - -- Fazem isto... - | -
---|---|
- Impedir que uma transação seja reportada à New Relic - | - -- Use [`IgnoreTransaction()`](/docs/agents/net-agent/net-agent-api/ignore-transaction) ou [um arquivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#blocking-instrumentation) para ignorar a transação. - | -
- Crie uma transação onde não existe nenhuma - | - -- Use [atributo](/docs/agents/net-agent/api-guides/custom-instrumentation-attributes-net) ou [um arquivo XML](/docs/agents/net-agent/instrumentation/net-custom-transactions) para criar uma nova transação. - | -
- Se você quiser... - | - -- Fazem isto... - | -
---|---|
- Alterar o nome de uma transação - | - -- Use [`SetTransactionName()`](/docs/agents/net-agent/net-agent-api/set-transaction-name) ou [um arquivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#name-transactions). - | -
- Evite que uma transação afete sua pontuação [Apdex](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#apdex) - | - -- Usar [`IgnoreApdex()`](/docs/agents/net-agent/net-agent-api/ignore-apdex). - | -
- Adicione metadados (como o nome da conta do seu cliente ou nível de assinatura) à sua transação - | - -- Use [atributo personalizado](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes). Consulte [`AddCustomAttribute()`](/docs/agents/net-agent/net-agent-api/itransaction#addcustomattribute). - | -
- Se você quiser... - | - -- Fazem isto... - | -
---|---|
- Trace um método assíncrono que o New Relic já está instrumentado - | - -- Use [um arquivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) para instrumentar métodos assíncronos em aplicativos IIS. Para dicas de resolução de problemas, veja [faltando métrica assíncrona](/docs/agents/net-agent/troubleshooting/missing-async-metrics). - | -
- Trace um método assíncrono que New Relic não é instrumentado - | - -- Use [um arquivo XML](/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#example-custom-txn-async) para instrumentar métodos assíncronos em aplicativos IIS. Para dicas de resolução de problemas, veja [faltando métrica assíncrona](/docs/agents/net-agent/troubleshooting/missing-async-metrics). - | -
- Se você quiser... - | - -- Fazem isto... - | -
---|---|
- Instrumento uma solicitação de saída para um aplicativo ou banco de dados externo - | - -- Adicione uma carga de distributed trace a uma solicitação de saída usando [`InsertDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#insertdistributedtraceheaders). - | -
- Conecte as solicitações recebidas ao originador da solicitação para concluir uma [extensão](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#span) do trace - | - -- Receba uma carga útil em uma solicitação recebida usando [`AcceptDistributedTraceHeaders()`](/docs/apm/agents/net-agent/net-agent-api/itransaction/#acceptdistributedtraceheaders). - | -
- Se você quiser... - | - -- Fazem isto... - | -
---|---|
- Relatar um erro que o agente .NET não relata automaticamente - | - -- Usar [`NoticeError()`](/docs/agents/net-agent/net-agent-api/notice-error). - | -
- Capture erros ou evite que o agente .NET relate um erro - | - -- Use [o arquivo de configuração do agente .NET](/docs/agents/net-agent/configuration/net-agent-configuration#error_collector). - | -
- Se você quiser... - | - -- Fazem isto... - | -
---|---|
- Envie dados sobre um evento para que você possa analisá-lo no painel - | - -- Crie um [evento personalizado](/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents#net-att). Consulte [`RecordCustomEvent()`](/docs/agents/net-agent/net-agent-api/record-custom-event). - | -
- Tag seu evento com metadados para filtrá-los e facetá-los no painel ou na análise de erros - | - -- Adicionar [atributo personalizado](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes). Consulte Atributo do agente .NET e [Habilitar e desabilitar atributo](/docs/agents/net-agent/attributes/enable-disable-attributes-net). - | -
- Relatar dados de desempenho personalizados - | - -- Use [`RecordMetric()`](/docs/agents/net-agent/net-agent-api/record-metric) para criar uma [métrica personalizada](/docs/agents/manage-apm-agents/agent-data/collect-custom-metrics). Para visualizar os dados, utilize o [criador de consulta](/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data). - | -
- Nome - | - -- Descrição - | -
---|---|
- Transação Atual - | - -- Propriedade que fornece acesso à transação atualmente em execução por meio da interface [ITransaction](/docs/agents/net-agent/net-agent-api/itransaction) . Deve ser chamado dentro de uma [transação](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#transaction). - | -
- Período Atual - | - -- Propriedade que fornece acesso ao intervalo atualmente em execução por meio da interface [ISpan](/docs/agents/net-agent/net-agent-api/iSpan) . - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$metric_name` - - _corda_ - | - -- Obrigatório. O nome da métrica a ser incrementada. - | -
- Nome - | - -- Descrição - | -
---|---|
- [`AddCustomAttribute`](#addcustomattribute) - | - -- Adicione informações contextuais da sua aplicação ao período atual em forma de atributo. - | -
- [`SetName`](#setname) - | - -- Altera o nome do intervalo/segmento/métrica atual que será relatado ao New Relic. - | -
- Parâmetro - | - -- Descrição - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _corda_ - | - -- Identifica as informações que estão sendo relatadas. Também conhecido como nome. - - * Chaves vazias não são suportadas. - * As chaves são limitadas a 255 bytes. atributo com chaves maiores que 255 bytes será ignorado. - | -||||||||||||||||
- `value` - - _objeto_ - | - -
- O valor que está sendo informado.
-
-
|
-
- Parâmetro - | - -- Descrição - | -
---|---|
- `name` - - _corda_ - | - -- O novo nome do intervalo/segmento. - | -
- Nome - | - -- Descrição - | -
---|---|
- [`AcceptDistributedTraceHeaders`](#acceptdistributedtraceheaders) - | - -- Aceita cabeçalhos de contexto do trace recebidos de outro serviço. - | -
- [`InsertDistributedTraceHeaders`](#insertdistributedtraceheaders) - | - -- Adiciona cabeçalhos de contexto do trace a uma solicitação de saída. - | -
- [`AcceptDistributedTracePayload` (obsoleto)](#acceptdistributedtracepayload) - | - -- Aceita uma carga útil distributed trace de entrada de outro serviço. - | -
- [`CreateDistributedTracePayload` (obsoleto)](#createdistributedtracepayload) - | - -- Cria uma carga de distributed trace para inclusão em uma solicitação de saída. - | -
- [`AddCustomAttribute`](#addcustomattribute) - | - -- Adicione informações contextuais da sua aplicação à transação atual em forma de atributo. - | -
- [`CurrentSpan`](#currentspan) - | - -- Fornece acesso ao [span](/docs/agents/net-agent/net-agent-api/ispan) em execução atualmente, que fornece acesso a métodos específicos de span na API New Relic. - | -
- [`SetUserId`](#setuserid) - | - -- Associa um ID de usuário à transação atual. - | -
- Nome - | - -- Descrição - | -
---|---|
- `carrier` - - _<T>_ - | - -- Obrigatório. Fonte do contexto de entrada dos cabeçalhos de rastreamento. - | -
- `getter` - - _Func<T, string, IEnumerable<string>>_ - | - -- Obrigatório. Função definida pelo chamador para extrair dados de cabeçalho da operadora. - | -
- `transportType` - - _Enumeração TransportType_ - | - -- Obrigatório. Descreve o transporte da carga de entrada (por exemplo `TransportType.HTTP`). - | -
- Nome - | - -- Descrição - | -
---|---|
- `carrier` - - _<T>_ - | - -- Obrigatório. contêiner onde são inseridos os cabeçalhos do contexto do trace. - | -
- `setter` - - _Action<T, string, string>_ - | - -- Obrigatório. Ação definida pelo chamador para inserir dados de cabeçalho na operadora. - | -
- Nome - | - -- Descrição - | -
---|---|
- `payload` - - _corda_ - | - -- Obrigatório. Uma representação de cadeia de caracteres da carga útil distributed trace de entrada. - | -
- `transportType` - - _Tipo de transporte_ - _enumeração_ - | - -- Recomendado. Descreve o transporte da carga de entrada (por exemplo, `http`). - - Padrão `TransportType.Unknown`. - | -
- Parâmetro - | - -- Descrição - | -||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- `key` - - _corda_ - | - -- Identifica as informações que estão sendo relatadas. Também conhecido como nome. - - * Chaves vazias não são suportadas. - * As chaves são limitadas a 255 bytes. atributo com chaves maiores que 255 bytes será ignorado. - | -||||||||||||||||
- `value` - - _objeto_ - | - -
- O valor que está sendo informado.
-
-
|
-
- Parâmetro - | - -- Descrição - | -
---|---|
- `userId` - - _corda_ - | - -- O ID do usuário a ser associado a esta transação. - - * `null`, os valores vazios e de espaço em branco serão ignorados. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$exception` - - _Exceção_ - | - -- Obrigatório. O `Exception` que você deseja instrumento. Somente os primeiros 10.000 caracteres do stack trace são retidos. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$exception` - - _Exceção_ - | - -- Obrigatório. O `Exception` que você deseja instrumento. Somente os primeiros 10.000 caracteres do stack trace são retidos. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Especifique pares de valor principal de atributo para anotar a mensagem de erro. O `TKey` deve ser uma string, o `TValue` pode ser uma string ou um objeto. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$error_message` - - _corda_ - | - -- Obrigatório. Especifique uma string para reportar ao New Relic como se fosse uma exceção. Este método cria [eventos de erro](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) e [rastreamentos de erro](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details). Somente os primeiros 1.023 caracteres são retidos no evento de erro, enquanto o rastreamento de erro retém a mensagem completa. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Obrigatório (pode ser nulo). Especifique pares de valor principal de atributo para anotar a mensagem de erro. O `TKey` deve ser uma string, o `TValue` pode ser uma string ou objeto, para não enviar atributo passe `null`. - - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$error_message` - - _corda_ - | - -- Obrigatório. Especifique uma string para reportar ao New Relic como se fosse uma exceção. Este método cria [eventos de erro](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#events) e [rastreamentos de erro](/docs/apm/apm-ui-pages/error-analytics/manage-error-data#trace-details). Somente os primeiros 1.023 caracteres são retidos no evento de erro, enquanto o rastreamento de erro retém a mensagem completa. - | -
- `$attributes` - - _IDictionary<TKey, TValue>_ - | - -- Obrigatório (pode ser nulo). Especifique pares de valor principal de atributo para anotar a mensagem de erro. O `TKey` deve ser uma string, o `TValue` pode ser uma string ou objeto, para não enviar nenhum atributo passe `null`. - | -
- `$is_expected` - - _bool_ - | - -- Marque o erro como esperado para que não afete a pontuação do Apdex e a taxa de erros. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `eventType` - - _corda_ - | - -- Obrigatório. O nome do tipo de evento a ser registrado. Strings com mais de 255 caracteres farão com que a chamada de API não seja enviada para o New Relic. O nome só pode conter caracteres alfanuméricos, sublinhados `_` e dois pontos `:`. Para restrições adicionais sobre nomes de tipos de eventos, consulte [Palavras reservadas](/docs/data-apis/custom-data/custom-events/data-requirements-limits-custom-event-data/#reserved-words). - | -
- `attributeValues` - - _IEnumerable<string, object>_ - | - -- Obrigatório. Especifique pares de valores principais de atributo para anotar o evento. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$metric_name` - - _corda_ - | - -- Obrigatório. O nome da métrica a ser registrada. Apenas os primeiros 255 caracteres são mantidos. - | -
- `$metric_value` - - _solteiro_ - | - -- Obrigatório. A quantidade a ser registrada para a métrica. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$metric_name` - - _corda_ - | - -- Obrigatório. O nome da métrica de tempo de resposta a ser registrada. Apenas os primeiros 255 caracteres são mantidos. - | -
- `$metric_value` - - _Int64_ - | - -- Obrigatório. O tempo de resposta para gravar em milissegundos. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$name` - - _corda_ - | - -- Obrigatório. O nome do aplicativo principal. - | -
- `$name_2` - - `$name_3` - - _corda_ - | - -- Opcional. Segundo e terceiro nomes para app agregar. Para obter mais informações, consulte [Usar vários nomes para um aplicativo](/docs/agents/manage-apm-agents/app-naming/use-multiple-names-app). - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$uri` - - _Uri_ - | - -- O URI desta transação. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$user_value` - - _corda_ - | - -- Obrigatório (pode ser nulo). Especifique um nome ou nome de usuário para associar a esta visualização de página. Este valor é atribuído à chave `user` . - | -
- `$account_value` - - _corda_ - | - -- Obrigatório (pode ser nulo). Especifique o nome de uma conta de usuário a ser associada a esta visualização de página. Este valor é atribuído à chave `account` . - | -
- `$product_value` - - _corda_ - | - -- Obrigatório (pode ser nulo). Especifique o nome de um produto a ser associado a esta visualização de página. Este valor é atribuído à chave `product` . - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$callback` - - _'Func<IReadOnlyDictionary<string,object>,string>'_ - | - -- O retorno de chamada para determinar o nome do grupo de erros com base nos dados do atributo. - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$callback` - - '\_Func<string, string, int>\_' - | - -- O retorno de chamada para determinar a contagem token . - | -
- Parâmetro - | - -- Descrição - | -
---|---|
- `$category` - - _corda_ - | - -
- Obrigatório. A categoria desta transação, que você pode usar para distinguir diferentes tipos de transações. O padrão é |
-
- `$name` - - _corda_ - | - -- Obrigatório. O nome da transação. Apenas os primeiros 255 caracteres são mantidos. - | -
- Nome - | - -- Descrição - | -
---|---|
- `TraceId` - | - -- Retorna uma string representando o trace atualmente em execução. Se o ID trace não estiver disponível ou distributed tracing estiver desativado, o valor será `string.Empty`. - | -
- `SpanId` - | - -- Retorna uma string que representa o intervalo em execução no momento. Se o ID do período não estiver disponível ou distributed tracing estiver desativado, o valor será `string.Empty`. - | -
- `IsSampled` - | - -- Retornará `true` se o trace atual for amostrado para inclusão, `false` se for amostrado. - | -