Para criar uma sonda, crie primeiro um ficheiro de origem Probekit (ficheiros probe).
Em seguida, no ficheiro de origem Probekit, crie a sonda e adicione o
conteúdo que define o funcionamento da mesma.
Para criar um ficheiro de origem Probekit, é necessário
utilizar o assistente Ficheiro de Origem Probekit. Pode continuar a utilizar o
assistente para criar a sonda e para escrever a maioria das definições da
sonda ou seguir directamente para o editor do Probekit.
Em qualquer um dos casos, deve utilizar o editor do Probekit para escrever o fragmento de código Java para o código.
Para informações mais detalhadas sobre os componentes diferentes de uma sonda,
consulte Definições de sondas.
- Para criar o ficheiro de origem Probekit:
-
Na vista Navegador ou Explorador de Pacotes, faça clique com o botão direito do
rato no projecto Java que pretende que contenha o ficheiro de origem e depois faça
clique em .
- Na página Seleccionar assistente, expanda
Perfilar e Registar e seleccione
Ficheiro de Origem Probekit.
- Faça clique em Seguinte.
- No assistente Criar uma Nova Sonda, introduza um nome para o ficheiro de origem da nova sonda no campo Nome de ficheiro.
A extensão do nome de ficheiro para os ficheiros de origem Probekit deve ser
.probe.
- No campo Pasta Origem, introduza uma pasta origem de projecto para conter o novo ficheiro de origem Probekit.
Nota: Os ficheiros origem Probekit devem aparecer no nível superior de uma pasta origem de projecto; não podem estar numa subpasta.
- Se quiser sair do assistente agora e utilizar o editor do Probekit para criar a sua sonda e respectiva definição:
- Seleccione Sem Conteúdo.
- Faça clique em Terminar. O novo ficheiro de origem Probekit é adicionado à pasta origem do projecto e, por predefinição, abre-se automaticamente no editor do Probekit.
- Continue com o passo 4.
- Se quiser continuar a utilizar o assistente para o ajudar na criação da definição de sonda:
- Seleccione Sonda de Método ou Sonda de Callsite .
- Seleccione o valor de Tipo de Fragmento para o fragmento que pretende que o assistente crie.
- Faça clique em Seguinte.
- Utilize os botões Adicionar e
Editar para definir os artigos que desejar.
Ao adicionar ou seleccionar um artigo, o assistente apresenta a descrição do mesmo.
Nota: Se voltar atrás e alterar o tipo de sonda a criar ou o tipo de fragmento a inserir, o editor perguntará se é de descartar artigos que já não sejam aplicáveis.
- Faça clique em Terminar. O novo ficheiro de origem Probekit é adicionado à pasta origem do projecto e, por predefinição, abre-se automaticamente no editor do Probekit.
-
Opcional: Na página Geral do editor do Probekit,
introduza uma cadeia de ID única para a sonda no campo
ID e um número de versão no campo
Versão, assim como valores para uma etiqueta.
Estes dados destinam-se somente a conveniência do utilizador na identificação
da sonda na configuração de perfilamento.
- Faça clique no separador Sondas.
- Se não utilizou o assistente para criar a sonda,
faça clique com o botão direito do rato no lado esquerdo do editor do Probekit e
seleccione Adicionar Sonda. A nova sonda
deverá ser criada na área da janela em árvore no lado esquerdo da página.
- Faça clique com o botão direito do rato na sonda
na área de janela em árvore e faça clique em
. O novo fragmento
aparece na área de janela em árvore como descendente da sonda e os campos de
propriedades do fragmento são apresentados na área de janela de edição no lado direito da página.
- Na área de janela de edição, seleccione um valor de Tipo de Fragmento e introduza o código Java para o fragmento da sonda. Para informações mais específicas, consulte Tipos de fragmentos de sonda.
- Continue a definir a sua sonda fazendo clique com
o botão direito do rato na árvore, através da utilização do menu emergente para
adicionar/remover artigos descendentes e introduzindo valores para os novos
artigos na área de janela de edição.
O menu emergente enumera somente os artigos que forem válidos para a localização que estiver seleccionada na árvore. Se o artigo for válido mas já não puder ser adicionado na localização seleccionada, o artigo estará desactivado no menu.
Nota: Ao introduzir um valor no campo de propriedade Directiva de importação, introduza somente o nome do pacote ou da classe que pretende importar.
Não introduza a palavra-chave import nem o ponto e vírgula final (;).
- Quando terminar de definir a sua sonda, faça clique em .
Nota: Quando guardar o ficheiro de origem Probekit, o editor do Probekit verifica a sintaxe de todos os elementos Java no ficheiro e reporta eventuais problemas javac.
Se houver um erro ou aviso relativo a uma entrada, o ícone correspondente na árvore passa a ser um ícone de erro ou aviso.
Os problemas javac são apresentados numa tabela no fundo da página Sondas.
Faça clique duas vezes num artigo desta tabela para focar o artigo para fins de edição.