Loading
Mejora de Salesforce mediante código
Configurar la clase Apex y desencadenar indicadores de rastreo

Usted está aquí:

  1. Ayuda de Salesforce
  2. Documentos
  3. Mejora de Salesforce mediante código

Configurar la clase Apex y desencadenar indicadores de rastreo

Puede configurar una clase Apex o desencadenar un indicador de rastreo en Configuración de Salesforce, en Developer Console o creando objetos de API de herramientas con comandos Salesforce CLI. Estos indicadores de rastreo tienen el tipo de registro de depuración CLASS_TRACING y sustituyen los niveles de registro de depuración de los indicadores de rastreo USER_DEBUG y DEVELOPER_LOG.

Ediciones necesarias

Disponible en: Salesforce Classic (no disponible en todas las organizaciones) y Lightning Experience
Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition, Developer Edition y Database.com Edition
Permisos de usuario necesarios
Para utilizar Developer Console: API activada Y Ver todos los datos
Para visualizar, conservar o eliminar registros de depuración: Ver todos los datos
Para ejecutar Apex anónimas: Apex de autor
Para guardar cambios en las clases y desencadenadores de Apex: Apex de autor
Para utilizar Salesforce CLI y ejecutar consultas de API de herramientas: API activado
Sugerencia
Sugerencia Para obtener un ejemplo aplicado del uso de indicadores de rastreo de desencadenadores y clases Apex, consulte Debug Log Filtering for Apex Classes and Apex Triggers (Filtrado de registros de depuración para desencadenadores Apex y clases Apex).

Crear clase Apex y desencadenar indicadores de rastreo en Configuración

Nota
Nota Aunque puede configurar una clase Apex o desencadenar un indicador de rastreo en Configuración, estos indicadores de rastreo no aparecen en la lista de registros en la página Registros de depuración. La página solo muestra tipos de registro de USER_DEBUG y DEVELOPER_LOG, no tipos de registro de CLASS_TRACING. Todavía puede acceder a tipos de registro de CLASS_TRACING creados en Configuración desde la clase de Apex o la página Configuración del desencadenador, desde Developer Console o con la API de herramientas.
  1. En Configuración, introduzca Registros de depuración en el cuadro Búsqueda rápida y, a continuación, haga clic en Registros de depuración.
  2. Haga clic en Nuevo.
  3. Para Tipo de entidad rastreada, seleccione Clase Apex o Desencadenador Apex.
  4. Para Nombre de entidad rastreada, introduzca el nombre de la clase o desencadenador de Apex al que desea agregar un indicador de rastreo.
  5. Para definir un periodo de tiempo durante el cual el indicador de rastreo está activo, introduzca una Fecha de inicio y una Fecha de caducidad.
  6. Para establecer un perfil de nivel de depuración, introduzca el nombre de un perfil de nivel de depuración que ya definió o haga clic en Nuevo nivel de depuración.

    Si hace clic en Nuevo nivel de depuración, se abre una nueva ventana. Para definir un nuevo perfil de nivel de depuración, en la nueva ventana, introduzca un nombre para el perfil de nivel de depuración. A continuación, seleccione un nivel de registro de depuración para cada categoría de registro de depuración. Guarde sus cambios.

  7. Guarde el indicador de rastreo.

Ver, modificar o eliminar indicadores de clase Apex y desencadenar rastreo en Configuración

  1. Navegue a la clase de Apex apropiada o a la página Configuración del desencadenador.
    1. Para indicadores de rastreo de clases Apex, desde Configuración, introduzca Clases Apex en el cuadro Búsqueda rápida y, a continuación, haga clic en Clases Apex.
    2. Para indicadores de rastreo de desencadenadores Apex, desde Configuración, introduzca Desencadenadores Apex en el cuadro Búsqueda rápida y, a continuación, haga clic en Desencadenadores Apex.
  2. Haga clic en el nombre de la clase o desencadenador de Apex que desea examinar.
  3. Haga clic en la opción que desee.
    1. Para crear un indicador de rastreo, haga clic en Nuevo. A continuación, introduzca una fecha de inicio, una fecha de caducidad y un perfil de nivel de depuración para el indicador de rastreo.
    2. Para eliminar un indicador de rastreo, en la columna Acción del indicador de rastreo, haga clic en Eliminar.
    3. Para modificar la fecha de inicio, la fecha de caducidad o el perfil de nivel de depuración de un indicador de rastreo, haga clic en Modificar.
    4. Para modificar los niveles de depuración de un indicador de rastreo, haga clic en Filtros. A continuación, seleccione el nivel de depuración que desee para cada categoría.
    5. Para eliminar todos los indicadores de rastreo de la clase o desencadenador de Apex, haga clic en Eliminar todo.
  4. Guarde sus cambios.

Crear Apex Class y desencadenar indicadores de rastreo en Developer Console

  1. Desde Developer Console, haga clic en Depurar | Cambiar niveles de registro....
    La ventana Cambiar niveles de registro en Developer Console, donde puede establecer marcas de rastreo de depuración.
  2. En la sección Sustituciones de rastreo de clase y desencadenador, haga clic en Agregar.
  3. Seleccione la clase o desencadenador al que desea agregar un indicador de rastreo.
  4. Para definir un periodo de tiempo durante el cual el indicador de rastreo está activo, haga clic en la celda Fecha de inicio para la clase o desencadenador y luego introduzca o seleccione una hora de inicio válida. A continuación, haga clic en la celda Fecha de caducidad e introduzca o seleccione una hora de finalización válida.
  5. Para establecer un perfil de nivel de depuración, haga clic en Agregar/Cambiar en la celda Acción DebugLevel para la clase o desencadenador. A continuación, realice una de estas acciones.
    1. Para establecer el nivel de depuración en un perfil de nivel de depuración que ya definió, haga clic en el nombre del perfil de nivel de depuración de modo que se resalte su fila. A continuación haga clic en Listo.
    2. Para ajustar los niveles de depuración de un perfil de nivel de depuración que ya definió, haga clic en el nombre del perfil de nivel de depuración de modo que se resalte su fila. Seleccione un nuevo nivel de depuración desde los menús desplegables para cada categoría de registro de depuración que desee ajustar. A continuación haga clic en Listo.
    3. Para agregar un nuevo perfil de nivel de depuración, haga clic en Agregar. En la nueva ventana, introduzca un Nombre de DebugLevel. A continuación, seleccione un nivel de depuración desde los menús desplegables para cada categoría de registro de depuración. Haga clic en Agregar y luego haga clic en Listo.
    4. Para eliminar un perfil de nivel de depuración, haga clic en el nombre del perfil de nivel de depuración y luego haga clic en Eliminar. A continuación haga clic en Listo.
      Advertencia: Esta acción elimina el perfil de registro de depuración de todos sus indicadores de rastreo asignados.
    La ventana Cambiar nivel de depuración en Developer Console, donde puede crear y modificar perfiles a nivel de registro de depuración.

Crear indicadores de rastreo de clase Apex y desencadenar su uso mediante comandos Salesforce CLI

Nota
Nota Donde sea posible, cambiamos términos no inclusivos para estar en sintonía con el valor de Igualdad de nuestra empresa. Mantuvimos ciertos términos para evitar cualquier efecto sobre las implementaciones de clientes.
  1. Si no tiene un perfil de nivel de depuración existente que desee utilizar, cree primero un registro DebugLevel con la API de herramientas utilizando el comando sf data create record. Sustituya los valores de marcador por el nombre deseado del perfil de nivel de depuración y el nivel de depuración deseado para cada categoría de registro de depuración. 
    sf data create record --use-tooling-api --sobject DebugLevel --values "DeveloperName='DEBUG_LEVEL_PROFILE_NAME' MasterLabel='DEBUG_LEVEL_PROFILE_NAME' Workflow='FINER' ApexCode='FINE' System='DEBUG' Validation='INFO' Database='INFO' Callout='INFO' Visualforce='INFO' ApexProfiling='INFO'"
  2. Obtenga el Id. de registro de DebugLevel para el perfil de nivel de depuración utilizando el comando sf data query. Sustituya el valor del marcador por el DeveloperName del perfil de nivel de depuración. 
    sf data query --query "SELECT Id FROM DebugLevel WHERE DeveloperName='DEBUG_LEVEL_PROFILE_NAME'"
  3. Obtenga el Id. de la clase o desencadenador de Apex que desea rastrear utilizando el comando sf data query. Sustituya el valor del marcador por el nombre de la clase o desencadenador de Apex. 
    sf data query --query "SELECT Id FROM ApexClass WHERE Name='APEX_CLASS_NAME'"
  4. Cree un registro de TraceFlag con la API de herramientas. Sustituya los valores de marcador de posición. 
    sf data create record --use-tooling-api --sobject TraceFlag --values "TracedEntityId='APEX_CLASS_OR_TRIGGER_ID' DebugLevelId='DEBUG_LEVEL_ID' LogType='CLASS_TRACING' StartDate='START_TIME_UTC' ExpirationDate='END_TIME_UTC'"
  5. Si aún no lo hizo, cree otro registro de TraceFlag en el usuario cuyas acciones desea rastrear. Los indicadores de rastreo de desencadenadores o clases de Apex no generan registros de depuración por sí mismos. 
    sf data create record --use-tooling-api --sobject TraceFlag --values "TracedEntityId='USER_ID' DebugLevelId='DEBUG_LEVEL_ID' LogType='USER_DEBUG' StartDate='START_TIME_UTC' ExpirationDate='END_TIME_UTC'"

Para trabajar con registros de depuración, utilice estos comandos:

  • Para obtener el registro especificado o un número concreto de registros más recientes de la organización, utilice el comando apex get log.
  • Para mostrar una lista de Id. e información general sobre registros de depuración, utilice el comando apex list log.
  • Para activar un registro de depuración para el usuario actual y transmitir el registro de depuración a la consola, utilice el sf apex tail og command.

Consulte también:

 
Cargando
Salesforce Help | Article