diff --git a/src/i18n/content/es/docs/browser/new-relic-browser/browser-apis/recordCustomEvent.mdx b/src/i18n/content/es/docs/browser/new-relic-browser/browser-apis/recordCustomEvent.mdx new file mode 100644 index 00000000000..f8c36826a6e --- /dev/null +++ b/src/i18n/content/es/docs/browser/new-relic-browser/browser-apis/recordCustomEvent.mdx @@ -0,0 +1,121 @@ +--- +title: recordCustomEvent +type: apiDoc +shortDescription: Informa sobre un evento browser personalizado bajo un eventType especificado con atributo personalizado. +tags: + - Browser + - Browser monitoring + - Browser agent and SPA API +metaDescription: Browser API call to report a custom browser event under a specified eventType with custom attributes. +freshnessValidatedDate: never +translationType: machine +--- + +## Sintaxis [#syntax] + +```js +newrelic.recordCustomEvent(string $eventType[, JSON object $attributes]) +``` + +Informa sobre un evento browser personalizado bajo un eventType especificado con atributo personalizado. + +## Requisitos + +* Agente de Broswer Pro o Pro+SPA (v1.277.0 o superior) + +* Si está utilizando npm para instalar el agente del navegador, debe habilitar la característica `generic_events` al crear una instancia de la clase `BrowserAgent` . En la matriz `features` , agregue lo siguiente: + + ```js + import { GenericEvents } from '@newrelic/browser-agent/features/generic_events'; + + const options = { + info: { ... }, + loader_config: { ... }, + init: { ... }, + features: [ + GenericEvents + ] + } + ``` + + Para obtener más información, consulte la [documentación de instalación del navegador npm](https://www.npmjs.com/package/@newrelic/browser-agent#new-relic-browser-agent). + +## Descripción [#description] + +Esta API de llamada envía un evento browser personalizado con su eventType definido por el usuario y un atributo opcional al [tablero](/docs/query-your-data/explore-query-data/dashboards/introduction-new-relic-one-dashboards), junto con cualquier atributo personalizado que pueda configurar para su aplicación. Esto es útil para rastrear cualquier evento que no sea rastreado automáticamente por el agente del browser mejorado por reglas y atribución que usted controla. + +* `custom` Los eventos se envían cada 30 segundos. +* Si se observan 1.000 eventos, el agente recolectará el evento almacenado inmediatamente, omitiendo el intervalo del ciclo de recolección. + +## Parámetros [#parameters] + +
+ Parámetro + | + ++ Descripción + | +
---|---|
+ `$eventType` + + *cadena* + | + ++ Requerido. El eventType para almacenar los datos del evento + + Evite emplear [palabras NRQL reservadas](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words) o eventTypes preexistentes al nombrar el atributo o valor. + | +
+ `$attributes` + + *Objeto JSON* + | + ++ Opcional. Objeto JSON con uno o más pares de valores principales. Por ejemplo: `{key:"value"}`. La clave se informa como su propio atributo `PageAction` con los valores especificados. + + Evite el uso [de palabras NRQL reservadas](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words) cuando nombre el atributo/valor. + | +
- Paquetes - | - -- Versión mínima - | -
---|---|
- Drupal - | - -- 8.0 - | -
- Guzzle - | - -- 6.0 - | -
- Laravel - | - -- 6.0 - | -
- PHPUnit - | - -- 9.0 - | -
- Predis - | - -- 2.0 - | -
- Slim - | - -- 2.0 - | -
- Wordpress - | - -- 5.9.0 - | -
+ パラメータ + | + ++ 説明 + | +
---|---|
+ `$eventType` + + *ストリング* + | + ++ 必須。 イベントデータを保存するイベントタイプ + + 属性または値に名前を付けるときに、 [予約済みの NRQL 単語](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words)や既存の eventTypes を使用しないでください。 + | +
+ `$attributes` + + *JSONオブジェクト* + | + ++ オプション。1 つ以上のキーと値のペアを持つ JSON オブジェクト。例: `{key:"value"}` .キーは、指定された値を持つ独自の`PageAction`属性として報告されます。 + + [予約済みのNRQLワード](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words) を属性/値の名前をつけるときに使わないようにしましょう。 + | +
+ |
+
+
+ |
+
---|---|
+ エージェントバージョン + | + ++ ブラウザ監視エージェントのバージョンは[1.277.0 以上で](/docs/browser/new-relic-browser/installation-configuration/upgrading-browser-agent#checking)ある必要があります。 + | +
+ クライアントのブラウザのバージョン + | + ++ `Custom`イベントを記録するには、ブラウザーが [クロスドメイン XHR をサポート](/docs/browser/new-relic-browser/getting-started/compatibility-requirements#browser-types)している必要があります。 + | +
+ サイクルあたりのイベント数 + | + ++ `Custom` イベントは他のブラウザ イベントとともにバッファされ、30 秒ごとに送信されます。 合計 1,000 件のイベントが観測された場合、エージェントは収集サイクル間隔をバイパスして、バッファリングされたイベントを直ちに収集します。 + | +
+ イベント/アトリビュートのネーミング、データタイプ、サイズ + | + ++ イベント/属性の命名構文、データタイプ、およびサイズに関する [の一般的な要件に確実に従ってください。](/docs/insights/insights-data-sources/custom-data/data-requirements#general) + + [](/docs/insights/insights-data-sources/custom-data/data-requirements#general) + | +
- `PageAction` イベントは30秒ごとに送信されます。 1,000 件のイベントが観測された場合、エージェントは収集サイクル間隔をバイパスして、バッファリングされたイベントを直ちに収集します。 + `PageAction` イベントは他のブラウザ イベントとともにバッファされ、30 秒ごとに送信されます。 1,000 件のイベントが観測された場合、エージェントは収集サイクル間隔をバイパスして、バッファリングされたイベントを直ちに収集します。 | @@ -83,6 +153,20 @@ New Relic のブラウザモニタリングを利用して、 [カスタムイ
+ 属性 + | + ++ 説明 + | +
---|---|
+ appId + | + ++ New Relic エンティティのアプリケーション ID。 + | +
+ アプリ名 + | + ++ New Relic エンティティのアプリケーション名。 + | +
+ ASN + | + ++ 自律システム番号。 + | +
+ asn緯度 + | + ++ ASNに関連付けられた緯度 + | +
+ asn経度 + | + ++ ASNに関連付けられた経度 + | +
+ asn組織 + | + ++ ASNに関連する組織 + | +
+ 市 + | + ++ イベントが発生した都市。 + | +
+ 国コード + | + ++ イベントが発生した国コード。 + | +
+ 現在のURL + | + ++ イベントが発生したURL(ソフトナビゲーションを含む) + | +
+ デバイスタイプ + | + ++ イベントが発生したデバイスの種類。 + | +
+ entityGuid + | + ++ New Relic エンティティの GUID。 + | +
+ name + | + ++ APM によって提供されるトランザクション名 + | +
+ ページURL + | + ++ イベントが発生した URL。 + | +
+ 地域コード + | + ++ イベントが発生した地域コード。 + | +
+ セッション + | + ++ イベントが発生したユーザー セッションに関連付けられたセッション識別子。 + | +
+ セッショントレースID + | + ++ イベントが発生したページの読み込みに関連付けられたセッショントレース ID。 + | +
+ タイムスタンプ + | + ++ イベントの UNIX タイムスタンプ。 + | +
+ ユーザーエージェント名 + | + ++ イベントが発生したユーザー エージェントの名前。 + | +
+ userAgentOS + | + ++ イベントが発生したユーザーエージェントのOS。 + | +
+ userAgentVersion + | + ++ イベントが発生したユーザー エージェントのバージョン。 + | +
- パッケージ - | - -- 最小バージョン - | -
---|---|
- Drupal - | - -- 8.0 - | -
- Guzzle - | - -- 6.0 - | -
- ララベル - | - -- 6.0 - | -
- PHPUnit - | - -- 9.0 - | -
- Predis - | - -- 2.0 - | -
- スリム - | - -- 2.0 - | -
- Wordpress - | - -- 5.9.0 - | -
+ 매개변수 + | + ++ 설명 + | +
---|---|
+ `$eventType` + + *끈* + | + ++ 필수의. 이벤트 데이터를 저장할 eventType + + 속성이나 값의 이름을 지정할 때 [예약된 NRQL 단어](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words) 나 기존의 eventTypes를 사용하지 마세요. + | +
+ `$attributes` + + *JSON 객체* + | + ++ 선택 과목. 하나 이상의 키/값 쌍이 있는 JSON 객체. 예: `{key:"value"}` . 키는 지정된 값과 함께 자체 `PageAction` 속성으로 보고됩니다. + + 속성/값의 이름을 지정할 때 [예약된 NRQL 단어](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words) 를 사용하지 마십시오. + | +
+ |
+
+
+ |
+
---|---|
+ 에이전트 버전 + | + ++ 브라우저 모니터링 에이전트 버전은 [1.277.0 이상](/docs/browser/new-relic-browser/installation-configuration/upgrading-browser-agent#checking) 이어야 합니다. + | +
+ 클라이언트 브라우저 버전 + | + ++ `Custom` 이벤트를 기록하려면 브라우저가 [도메인 간 XHR을 지원](/docs/browser/new-relic-browser/getting-started/compatibility-requirements#browser-types) 해야 합니다. + | +
+ 사이클당 이벤트 + | + ++ `Custom` 이벤트는 다른 브라우저 이벤트와 함께 버퍼링되며 30초마다 전송됩니다. 총 1,000개의 이벤트가 관찰되면 에이전트는 하베스트 처리 간격을 우회하여 버퍼링된 이벤트를 즉시 수집합니다. + | +
+ 이벤트/속성 이름 지정, 데이터 유형, 크기 + | + ++ 이벤트/속성 명명 구문, 데이터 유형 및 크기에 [대한 일반 요구 사항](/docs/insights/insights-data-sources/custom-data/data-requirements#general) 을 준수해야 합니다. + | +
- `PageAction` 이벤트는 30초마다 전송됩니다. 1,000개의 이벤트가 관찰되면 에이전트는 하베스트 처리 간격을 우회하여 버퍼링된 이벤트를 즉시 수집합니다. + `PageAction` 이벤트는 다른 브라우저 이벤트와 함께 버퍼링되며 30초마다 전송됩니다. 1,000개의 이벤트가 관찰되면 에이전트는 하베스트 처리 간격을 우회하여 버퍼링된 이벤트를 즉시 수집합니다. | @@ -81,6 +149,20 @@ New Relic에서 브라우저 모니터링을 사용하여 [사용자 정의 이
+ 기인하다 + | + ++ 설명 + | +
---|---|
+ appId + | + ++ 뉴렐릭의 합류 ID입니다. + | +
+ 앱 이름 + | + ++ 뉴렐릭의 합류 이름입니다. + | +
+ 아산 + | + ++ 자율 시스템 번호. + | +
+ 위도 + | + ++ ASN과 관련된 위도 + | +
+ 경도 + | + ++ ASN과 관련된 경도 + | +
+ asn조직 + | + ++ ASN과 관련된 조직 + | +
+ 도시 + | + ++ 사건이 발생한 도시. + | +
+ 국가코드 + | + ++ 이벤트가 발생한 국가 코드입니다. + | +
+ 현재 URL + | + ++ 소프트 탐색을 포함한 이벤트가 발생한 URL + | +
+ 장치 유형 + | + ++ 이벤트가 발생한 장치의 유형입니다. + | +
+ 엔티티 가이드 + | + ++ 뉴렐릭의 GUID입니다. + | +
+ 이름 + | + ++ APM에서 제공하는 경우 거래 이름 + | +
+ 페이지 URL + | + ++ 이벤트가 발생한 URL입니다. + | +
+ 지역코드 + | + ++ 이벤트가 발생한 지역 코드입니다. + | +
+ 세션 + | + ++ 이벤트가 발생한 사용자 세션에 연결된 세션 식별자입니다. + | +
+ 세션 추적 ID + | + ++ 이벤트가 발생한 페이지 로드와 연결된 세션 트레이스 ID입니다. + | +
+ 타임스탬프 + | + ++ 이벤트의 유닉스 타임스탬프. + | +
+ 사용자 에이전트 이름 + | + ++ 이벤트가 발생한 사용자 에이전트의 이름입니다. + | +
+ 사용자 에이전트 OS + | + ++ 이벤트가 발생한 사용자 에이전트의 운영 시스템입니다. + | +
+ 사용자 에이전트 버전 + | + ++ 이벤트가 발생한 사용자 에이전트의 버전입니다. + | +
- 패키지 - | - -- 최소 버전 - | -
---|---|
- 드루팔 - | - -- 8.0 - | -
- 목구멍 - | - -- 6.0 - | -
- 라라벨 - | - -- 6.0 - | -
- PHPUnit - | - -- 9.0 - | -
- 프레디스 - | - -- 2.0 - | -
- 날씬한 - | - -- 2.0 - | -
- 워드프레스 - | - -- 5.9.0 - | -
+ Parâmetro + | + ++ Descrição + | +
---|---|
+ `$eventType` + + *corda* + | + ++ Obrigatório. O eventType para armazenar os dados do evento em + + Evite usar [palavras NRQL reservadas](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words) ou eventTypes pré-existentes ao nomear o atributo ou valor. + | +
+ `$attributes` + + *Objeto JSON* + | + ++ Opcional. Objeto JSON com um ou mais pares de valores principais. Por exemplo: `{key:"value"}`. A chave é relatada como seu próprio atributo `PageAction` com os valores especificados. + + Evite usar [palavras NRQL reservadas](/docs/insights/event-data-sources/custom-events/data-requirements-limits-custom-event-data/#reserved-words) ao nomear o atributo/valor. + | +
+ |
+
+
+ |
+
---|---|
+ Versão do agente + | + ++ A versão do seu agente de monitoramento de browser deve ser [1.277.0 ou superior](/docs/browser/new-relic-browser/installation-configuration/upgrading-browser-agent#checking). + | +
+ Versão do browser do cliente + | + ++ Para gravar o evento `Custom` , o browser deve [suportar XHRs entre domínios](/docs/browser/new-relic-browser/getting-started/compatibility-requirements#browser-types). + | +
+ Eventos por ciclo + | + ++ `Custom` eventos são armazenados em buffer com outros eventos do browser e são enviados a cada 30 segundos. Se forem observados 1.000 eventos no total, o agente coletará o evento armazenado em buffer imediatamente, ignorando o intervalo do ciclo de coleta. + | +
+ Nomenclatura de evento/atributo, tipo de dados, tamanho + | + ++ Certifique-se de seguir [os requisitos gerais](/docs/insights/insights-data-sources/custom-data/data-requirements#general) sobre sintaxe de nomenclatura de evento/atributo, tipos de dados e tamanho. + | +
- `PageAction` Eventos são enviados a cada 30 segundos. Se 1.000 eventos forem observados, o agente coletará o evento armazenado em buffer imediatamente, ignorando o intervalo do ciclo de coleta. + `PageAction` eventos são armazenados em buffer com outros eventos do browser e são enviados a cada 30 segundos. Se 1.000 eventos forem observados, o agente coletará o evento armazenado em buffer imediatamente, ignorando o intervalo do ciclo de coleta. | @@ -81,6 +149,20 @@ Para relatar o evento `PageAction` , verifique estes pré-requisitos:
+ Atributo + | + ++ Descrição + | +
---|---|
+ ID do aplicativo + | + ++ ID do aplicativo da entidade New Relic. + | +
+ Nome do aplicativo + | + ++ Nome do aplicativo da entidade New Relic. + | +
+ asn + | + ++ Número do Sistema Autônomo. + | +
+ asnLatitude + | + ++ A latitude associada ao ASN + | +
+ asnLongitude + | + ++ A longitude associada ao ASN + | +
+ asnOrganização + | + ++ A organização associada à ASN + | +
+ cidade + | + ++ A cidade onde o evento ocorreu. + | +
+ Código do país + | + ++ O código do país onde o evento ocorreu. + | +
+ URL atual + | + ++ A URL onde o evento ocorreu, que inclui navegações suaves + | +
+ Tipo de dispositivo + | + ++ O tipo de dispositivo no qual o evento ocorreu. + | +
+ EntidadeGuia + | + ++ O GUID da entidade New Relic. + | +
+ nome + | + ++ O nome da transação se fornecido pelo APM + | +
+ URL da página + | + ++ A URL onde o evento ocorreu. + | +
+ regiãoCódigo + | + ++ O código da região onde o evento ocorreu. + | +
+ sessão + | + ++ O identificador de sessão vinculado à sessão do usuário onde o evento ocorreu. + | +
+ sessãoTraceId + | + ++ O ID do trace da sessão está vinculado ao carregamento da página onde o evento ocorreu. + | +
+ Timestamp + | + ++ O timestamp unix do evento. + | +
+ Nome do Agente do Usuário + | + ++ O nome do agente do usuário onde o evento ocorreu. + | +
+ usuárioAgentOS + | + ++ O sistema operacional do agente do usuário onde o evento ocorreu. + | +
+ Versão do agente do usuário + | + ++ A versão do agente do usuário onde o evento ocorreu. + | +
- Pacotes - | - -- Versão Mínima - | -
---|---|
- Drupal - | - -- 8,0 - | -
- Guzzle - | - -- 6,0 - | -
- Laravel - | - -- 6,0 - | -
- PHPUnit - | - -- 9,0 - | -
- Predis - | - -- 2,0 - | -
- Slim - | - -- 2,0 - | -
- WordPress - | - -- 5.9.0 - | -