Protección de datos para desarrolladores
Preparar registros para depuración con IA
Antes de usar registros de máquina con un asistente de IA, conserve el error, la secuencia relevante y la estructura de correlación mientras elimina credenciales e identificadores de clientes innecesarios. Verifique la ruta de entrada real y la cuenta del proveedor. El paquete sintético muestra una transformación útil, no un redactor de propósito general ni prueba de que todos los campos del registro sean seguros.
Para SRE, desarrolladores e ingeniería de seguridad
Preserve la pila y la secuencia, luego revise el contexto restante.
Registros completamente sintéticos. La transformación fuera de línea se limita a este conjunto de datos y no es un sanitizador de producción.01
Defina primero la pregunta de depuración
Un registro de producción puede contener mucho más que la falla investigada. Plantee la pregunta antes de exportar datos: por ejemplo, ¿por qué una solicitud reportó un campo de cantidad faltante tras un reintento? Identifique la ventana temporal y los marcos de pila más pequeños que ayuden a responderla.
Mantenga el manejo de la fuente dentro de su entorno aprobado. Evite copiar un archivo completo de registros a un asistente y pedirle que decida qué fue sensible después. Un extracto reducido debe ser comprensible por sí mismo, con códigos de estado relevantes, nombres de error y la relación entre eventos repetidos.
02
Separe el contexto útil de los identificadores
Revise encabezados, cookies, cadenas de consulta, fragmentos de carga útil, nombres de archivo y valores de pila, así como nombres o direcciones de correo evidentes. Una sola solicitud puede llevar una credencial en un campo y un identificador de cliente en otro. Eliminar uno no garantiza que la entrada restante sea apropiada.
Use marcadores de posición consistentes cuando la correlación importe. Reemplazar el mismo identificador ficticio de solicitud con la misma etiqueta preserva la secuencia; reemplazar todo con texto no relacionado puede hacer imposible seguir un reintento o relación entre servicios. También considere si rutas internas, tiempos o detalles de arquitectura requieren aprobación del propietario.
| Elemento del registro | Generalmente útil para la pregunta | Acción de revisión |
|---|---|---|
| Excepción y marcos relevantes | Mecanismo de falla | Retenga la pila útil mínima |
| Identificador de solicitud repetido | Correlación de eventos | Use un marcador de posición consistente |
| Valores de autorización y cookies | Rara vez necesarios para la explicación | Eliminar valores |
| Campos de cliente o carga útil | Solo si es esencial | Minimice o reemplace con una reproducción sintética |
Contexto de la fuente: OAIC: Uso de productos de IA comercialmente disponibles
03
Compare los ejemplos sin procesar y minimizados incluidos
La muestra contiene una solicitud de pedido ficticia, valores falsos de autorización y cookies, una dirección de correo electrónico invalid-example, un reintento y dos marcos de pila. La versión minimizada conserva el error y el orden mientras reemplaza identificadores repetidos de forma consistente. Todos los registros son sintéticos.
El asistente opcional fuera de línea acepta solo el fixture incluido sin cambios, verificado por su hash, y escribe el ejemplo transformado en la salida estándar. No realiza llamadas de red y no está destinado para registros reales. Su lista fija de reemplazos demuestra solo este ejemplo; no detecta credenciales arbitrarias ni certifica que una salida sea segura.
04
Verifique utilidad y permiso antes de compartir
Compare el extracto propuesto con la pregunta de depuración. ¿Puede un revisor entender aún la falla? ¿Se omitieron eventos no relacionados? ¿Algún valor restante identifica a una persona, revela una credencial o divulga información empresarial que la tarea no necesita? Registre la decisión del propietario para la cuenta y servicio seleccionados.
La guía australiana OAIC trata la información personal ingresada en un sistema de IA como una decisión de privacidad y recomienda precaución con IA generativa disponible públicamente. Aplique los requisitos propios de la organización a los datos y servicios reales. Una transformación de texto exitosa no otorga permiso legal, consentimiento ni salvaguarda contractual.
Contexto de la fuente: OAIC: Uso de productos de IA comercialmente disponibles
05
Verifique la ruta de envío y la evidencia
Un extracto pegado, un archivo de registro subido y el resultado del terminal pueden seguir caminos diferentes. Confirme qué camino utilizará el desarrollador y si el control de punto final previsto lo evalúa. No infiera la cobertura de la salida del terminal a partir de una prueba en el navegador.
Mantenga el extracto preparado separado de un paquete de soporte o envío de comentarios. Esas cargas excepcionales pueden incluir historial adicional de conversación o archivos. Registre el resultado esperado de la política para una prueba sintética adecuada y luego distinga ese resultado de la revisión humana de un extracto real de depuración.
Contexto de la fuente: Claude Code: Uso de datos · Aona: Cobertura de seguridad IA
Ponlo en práctica
Paquete de preparación de registro de depuración sintético
Compare una traza ficticia sin procesar, una versión minimizada y los campos retenidos para el diagnóstico.
Registros completamente sintéticos. La transformación fuera de línea se limita a este conjunto de datos y no es un sanitizador de producción.
| Field | Ejemplo sin procesar | Ejemplo preparado |
|---|---|---|
| Correlación de solicitudes | SYNTHETIC_REQ_004 | [REQUEST_1] en ambas líneas |
| Authorization | Marcador falso de portador | [AUTH_REMOVED] |
| Correo electrónico del cliente | person@example.invalid | [EMAIL_1] |
| Contexto del fallo | Cantidad faltante y dos marcos | Preservado |
Trabaja en tu reseña
Usa las verificaciones para organizar las pruebas que necesitas. Guarda tus selecciones en Word, luego añade tus notas y pruebas. Tus selecciones permanecen en esta pestaña hasta que las descargues.
0 de 3 Revisado
Ejemplos y material de revisión
Lee los detalles aquí, o mantén juntos el documento PDFeditable Word y las hojas de cálculo.
Synthetic debugging-log preparationLee
All data is fictional. The example.invalid address cannot identify a real customer. Authorization y cookie strings are obvious fake markers, not credentials.
Compare synthetic-raw.log with expected-minimised.log and complete the “Debugging excerpt review” section. The optional prepare_example.py uses only the unchanged bundled raw file, refuses any other content by hash and prints a fixed demonstration transformation. It performs no network calls and is not a production redactor. Do not replace the fixture with real logs.
Debugging question: why did the fictional request return a missing-quantity error after a retry? Observe that the status, time sequence, error text y stack frames remain useful without the original marker values.
Guide y source references
Canonical guide: https://aona.ai/resources/guides/production-logs-ai-debugging/ Source review: 2026-09-21
- OAIC: Use of commercially available AI products: https://www.oaic.gov.au/privacy/privacy-guidance-for-organisations-and-government-agencies/guidance-on-privacy-and-the-use-of-commercially-available-ai-products
- Claude Code: Data usage: https://code.claude.com/docs/en/data-usage
- Aona: AI security coverage: https://aona.ai/resources/ai-security-coverage/
Debugging excerpt reviewLee
Question: ____________________ Minimum time window and events: ____________________ Error/status and frames retained: ____________________ Repeated values requiring consistent replacement: ____________________ Credentials, cookies and unnecessary identifiers removed: ____________________ Remaining architecture or business context to review: ____________________ Service/account and submission path: ____________________ Owner decision: NOT YET REVIEWED Control test, if applicable: UNTESTED Evidence: ____________________
This record does not certify a real excerpt as safe or authorize disclosure.
Código de trabajo y archivos de prueba
Utiliza los archivos originales para los ejercicios de código y datos. El código fuente ZIP incluye sus instrucciones y datos de entrada.
Descargar ejemplos de fuentes (ZIP)Synthetic rawLOG
2030-01-01T00:00:00.000Z SYNTHETIC request=SYNTHETIC_REQ_004 GET /orders/SYNTHETIC_ORDER_071 status=500 email=person@example.invalid Authorization="Bearer SYNTHETIC_AUTH_D08" Cookie="session=SYNTHETIC_COOKIE_D08"
2030-01-01T00:00:00.012Z SYNTHETIC request=SYNTHETIC_REQ_004 retry=1 error="ValueError: missing required field quantity"
at parse_order(payload) in parser.py:18
at handle_request() in app.py:42
Expected minimisedLOG
2030-01-01T00:00:00.000Z SYNTHETIC request=[REQUEST_1] GET /orders/[ORDER_1] status=500 email=[EMAIL_1] Authorization="Bearer [AUTH_REMOVED]" Cookie="session=[COOKIE_REMOVED]"
2030-01-01T00:00:00.012Z SYNTHETIC request=[REQUEST_1] retry=1 error="ValueError: missing required field quantity"
at parse_order(payload) in parser.py:18
at handle_request() in app.py:42
Prepare examplePY
# Offline transformation for the bundled synthetic fixture only.
import hashlib
from pathlib import Path
import sys
source = Path(__file__).with_name("synthetic-raw.log").read_text()
if hashlib.sha256(source.encode()).hexdigest() != "5fed748badd05d428a1e56db0a121ccb8cbf3f3c2212084ac3b34a25b04166cf":
raise SystemExit("Refusing input: use only the unchanged bundled synthetic fixture.")
replacements = {'SYNTHETIC_REQ_004': '[REQUEST_1]', 'SYNTHETIC_ORDER_071': '[ORDER_1]', 'person@example.invalid': '[EMAIL_1]', 'SYNTHETIC_AUTH_D08': '[AUTH_REMOVED]', 'SYNTHETIC_COOKIE_D08': '[COOKIE_REMOVED]'}
for old, new in replacements.items():
source = source.replace(old, new)
sys.stdout.write(source)
Antes de que continúes
Mantén claras estas distinciones
- Eliminando la evidencia necesaria para depurar
- Mantenga el error mínimo y la secuencia que aún expliquen el problema; documente cualquier valor cambiado.
- Tratando un ejemplo fijo como un escáner
- El asistente rechaza otras entradas y reemplaza solo marcadores falsos conocidos. No es un detector reutilizable de credenciales.
Aplícalo al uso de IA por parte de empleados
Lleva tu ruta real de datos.
Aona puede ayudar a evaluar envíos compatibles de indicaciones y archivos que contengan contexto de depuración.
Esto no implica inspección de cada salida de terminal, formato de registro, paquete de soporte o ruta de desarrollo remoto.
Use la traza sintética en una demostración limitada de la ruta de entrada prevista y el resultado de la política.
Revisa tu caso de usoPreguntas frecuentes
Preguntas sobre esta decisión
¿Puedo subir el registro completo de producción y pedir a la IA que lo redacte?
¿Debe reemplazarse cada identificador por un valor aleatorio diferente?
¿Puede prepare_example.py sanitizar mis registros reales?
¿Una prueba DLP en navegador cubre registros leídos por un agente de codificación?
Evidencia detrás de la guía
Fuentes y alcance
Preparado por Aona. Fuentes comprobadas 2026-09-21. El material citado respalda los puntos específicos a continuación; no certifica un producto ni su caso de uso.
- OAIC: Uso de productos de IA comercialmente disponibles
Explica consideraciones de privacidad para información personal introducida en productos comerciales de IA.
regulator · comprobado 2026-09-21 - Claude Code: Uso de datos
Distingue uso ordinario de rutas de retroalimentación iniciadas por el usuario y compartición de transcripciones.
vendor · comprobado 2026-09-21 - Aona: Cobertura de seguridad IA
Requiere verificación de la ruta de entrada soportada prevista.
vendor · comprobado 2026-09-21