From 69ad792c6d6f12a6efee3214d8eadfbd244d0ccd Mon Sep 17 00:00:00 2001 From: leonardolara Date: Fri, 20 Dec 2024 08:45:21 -0300 Subject: [PATCH] initial translation of oci8/dtrace --- reference/oci8/dtrace.xml | 406 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 406 insertions(+) create mode 100644 reference/oci8/dtrace.xml diff --git a/reference/oci8/dtrace.xml b/reference/oci8/dtrace.xml new file mode 100644 index 000000000..2cff7d5c8 --- /dev/null +++ b/reference/oci8/dtrace.xml @@ -0,0 +1,406 @@ + + + + OCI8 e Rastreamento dinâmico DTrace + + O OCI8 2.0 introduziu sondas DTrace estáticas que podem ser usadas ​​em + sistemas operacionais compatíveis com o DTrace. + Consulte Rastreamento Dinâmico DTrace + para obter uma visão geral do PHP e do DTrace. + + +
+ Instalando OCI8 com suporte a DTrace + + Para habilitar o suporte a DTrace no PHP OCI8, o OCI8 deve ser compilado como uma extensão + compartilhada após a definição de PHP_DTRACE. + + + + + + + + + + Edite o php.ini, + defina extension_dir para o + diretório que contém o oci8.so criado e também + habilite a extesão adicionando: + + + + + + + + + + Se o PHP OCI8 for instalado a partir do PECL usando phpize e + configure (ao invés + de pecl), ainda será necessário definir + PHP_DTRACE=yes. Isto acontece porque + a opção --enable-dtrace será ignorada pelo + script configure limitado de um pacote PECL. + + + + Consulte Instalação de extensões + PECL para intruções gerais de instalação via PECL. + +
+ +
+ Sondas Estáticas DTrace no PHP OCI8 + + As seguintes sondas estáticas estão disponíveis no PHP OCI8 + + + + Nome da Sonda + Descrição da Sonda + Argumentos da Sonda + + + + + oci8-connect-entry + Iniciada por oci_connect(), oci_pconnect() e oci_new_connect(). É ativada antes da conexão ao banco de dados ser estabelecida. + char *username, char *dbname, char *charset, long session_mode, int persistent, int exclusive + + + oci8-connect-return + É ativada no final da conexão. + void *connection + + + oci8-check-connection + É ativada se um erro Oracle possa ter tornado a conexão inválida. + void *connection, char *client_id, int is_open, long errcode, unsigned long server_status + + + oci8-sqltext + É ativada quando oci_parse() é executada. + void *connection, char *client_id, void *statement, char *sql + + + oci8-connection-close + É ativada quando a conexão ao banco de dados é completamente destruída. + void *connection + + + oci8-error + É ativada se um erro Oracle ocorrer. + int status, long errcode + + + oci8-execute-mode + É ativada na função oci_execute para mostrar o modo de execução. + void *connection, char *client_id, void *statement, unsigned int mode + + + +
+ + Estas sondas são úteis para rastrear scripts OCI8. + + + + As variáveis connection e statement + são ponteiros para estruturas internas usados para rastrear + conexões e instruções executadas do PHP. + + + + A variável client_id é o valor definido + por oci_set_client_identifier. + + + + + + + + + + + + + + O núcleo do PHP também tem sondas estáticas. + Consulte Sondas Estáticas + DTrace no Núcleo do PHP. + + + + Sondas DTrace Internas de Depuração no OCI8 + + + + Nome da Sonda + + + + + oci8-connect-expiry + + + oci8-connect-lookup + + + oci8-connect-p-dtor-close + + + oci8-connect-p-dtor-release + + + oci8-connect-type + + + oci8-sesspool-create + + + oci8-sesspool-stats + + + oci8-sesspool-type + + + +
+ + Estas sondas são úteis para mantenedores do OCI8. Consulte o código-fonte para argumentos e para ver quando elas serão ativadas. + +
+ +
+ Listando Sondas Estáticas DTrace no PHP OCI8 + + Para listar sondas disponíveis, inicie um processo PHP e depois execute: + + + + + + + + + O resultado será similar a: + + + + + + + + + Os valores da coluna PROVIDER consistem no prefixo phpoci e + o ID fo processo PHP atual. + + + + A coluna FUNCTION refere-se aos nomes de função da implementação C + interna do PHP onde cada provedor está localizado. + + + + Se um processo PHP não estiver em execução, nenhuma sonda PHP será exibida. + +
+ +
+ Exemplo de DTrace com PHP OCI8 + + Este exemplo mostra o básico da linguagem de script D do DTrace. + + <filename>user_oci8_probes.d</filename> para rastrear todas as Sondas Estáticas PHP OCI8 em nível de usuário com DTrace + + + + + + + + Este script usa a opção -Z para + dtrace, permitindo que ele seja executado quando não houver + processo PHP em execução. Se esta opção fosse omitida, o script + terminaria imediatamente quando nenhum executável do PHP estivesse em execução + porque ele sabe que nenhuma das sondas a serem monitoradas + existiriam. + + + + Em máquinas com múltiplas CPUs, a ordem das sondas pode não parecer + sequencial. Isto depende de qual CPU está processando as sondas, + e como os threads migram através dos CPUs. Exibir o horário de cada sonda + ajuda a reduzir a confusão. + + + + O script rastreia todos os pontos de sondas estáticas do PHP OCI8 em nível de usuário, + durante toda a execução do script PHP. Execute o script D: + + + + + + + + + Execute uma aplicação ou um script PHP. O script D de monitoramento + exeubirá os argumentos de cada sonda assim que ativada. Por exemplo, um simples + script PHP que consulta uma tabela pode produzir o seguinte resultado de + rastreamento: + + + + + + + + + Quando o monitoramento estiver concluído, o script D pode ser encerrado com um + CTRLC. + + +
+ +
+ &reftitle.seealso; + + Rastreamento Dinâmico DTrace + +
+ + + + +