Para crear una sonda, en primer lugar debe crear un archivo fuente de Probekit (archivo probe.) A continuación, en el archivo fuente de Probekit, cree la sonda y añada el contenido que define su funcionamiento.
Para crear un archivo fuente de Probekit, debe utilizar el asistente Archivo fuente de Probekit. Puede continuar utilizando el asistente para crear la sonda y para escribir la mayor parte de la definición de la sonda
o puede ir directamente al editor de Probekit. En
cualquier caso, debe utilizar el editor de Probekit para escribir el fragmento de código
Java correspondiente al código.
Para obtener información detallada acerca de los diferentes componentes de una sonda,
consulte la sección Definiciones de sonda.
- Para crear el archivo fuente de Probekit:
- En las vistas
Navegador o Explorador de paquetes, pulse con el botón derecho del ratón el proyecto Java que deberá contener el
archivo fuente y pulse .
- En la página Seleccionar un asistente, expanda Perfilado y
anotaciones y seleccione Archivo fuente de Probekit.
- Pulse Siguiente.
- En el asistente Crear un archivo de sonda, escriba un nombre para el archivo fuente
de sonda nuevo en el campo Nombre de archivo. La extensión del nombre de archivo para
los archivos fuente de Probekit debe ser .probe.
- En el campo Carpeta fuente, especifique una carpeta
fuente de proyecto para que contenga el nuevo archivo fuente de Probekit.
Nota: Los archivos fuente de sonda deben aparecer en
el
nivel superior de una carpeta fuente de proyecto; no pueden
estar en
una subcarpeta.
- Si desea salir del asistente ahora y utilizar el editor de
Probekit para crear la sonda y su definición:
- Seleccione
Sin contenido.
- Pulse Finalizar. El nuevo archivo fuente de Probekit
se añadirá a la carpeta fuente del proyecto y, por omisión, se abrirá automáticamente en
el editor de Probekit.
- Continúe en el paso 4.
- Si desea continuar utilizando el asistente para la creación
de la definición de sonda:
- Seleccione
Sonda de método o
Sonda de sitio de llamada.
- Seleccione el valor Tipo de fragmento para el
fragmento que debe crear el asistente.
- Pulse Siguiente.
- Utilice los botones Añadir y Editar para definir
tantos elementos de datos como desee.
Cuando añada o seleccione un elemento, el asistente visualizará una descripción del
mismo.
Nota: Si retrocede y cambia el
tipo de sonda creada o el tipo de fragmento que debe insertarse, el editor le solicitará
que descarte los elementos que ya no procedan.
- Pulse Finalizar. El nuevo archivo fuente de Probekit
se añadirá a la carpeta fuente del proyecto y, por omisión, se abrirá automáticamente en
el editor de Probekit.
- Opcional: en la página General del editor de Probekit, especifique un ID exclusivo para la
sonda en el campo ID y un número de versión en el campo
Versión, así como valores para una etiqueta. Estos datos únicamente facilitan la
identificación de la sonda en la configuración de perfilado.
- Pulse la pestaña Sondas.
- Si no ha utilizado el asistente para crear la sonda, pulse con el botón derecho en el lado
izquierdo del editor de Probekit y seleccione Añadir sonda. La sonda nueva debe
crearse en el panel de árbol del lado izquierdo de la página.
- Pulse la sonda con el botón derecho del ratón en el panel de árbol y pulse
.
El fragmento nuevo aparece en el panel de árbol como un hijo de la sonda y los campos de propiedad del
fragmento se visualizan en el panel de edición del lado derecho de la página.
- En el panel de edición, seleccione un valor de
Tipo de fragmento y, a continuación, escriba el código
Java para el fragmento de sonda. Para obtener información específica, consulte la
sección Tipos de fragmentos de sonda.
- Continúe definiendo la sonda pulsando con el botón derecho del ratón los elementos del
árbol, utilizando el menú emergente para añadir/eliminar elementos hijos y escribiendo valores para los elementos
nuevos en el panel de edición. El
menú emergente lista sólo los elementos que son válidos para la ubicación seleccionada en
el árbol. Si el elemento es válido pero ya no puede añadirse en la ubicación
seleccionada, queda inhabilitado en el menú.
Nota: Cuando escriba un valor en el
campo de la propiedad Directiva de importación, escriba
sólo el nombre del paquete o la clase que desee importar.
No escriba la palabra clave import ni un punto y coma (;) final.
- Cuando hay terminado de definir la sonda, pulse
.
Nota:
Al guardar el archivo fuente de Probekit, el editor de Probekit comprueba la
sintaxis de todos los elementos Java del archivo y notifica los problemas javac.
Si existe un error o aviso para una entrada, el icono correspondiente del árbol se cambia
por el icono de error o aviso. Los problemas Javac se visualizan en una tabla situada en el extremo inferior de la
página Sondas. Efectúe una doble pulsación
sobre un elemento de esta tabla para seleccionarlo a fin de editarlo.