SDK de Microsoft Information Protection: configuración de diagnóstico

Datos de diagnóstico

De forma predeterminada, el SDK de Microsoft Information Protection envía datos de diagnóstico a Microsoft. Estos datos son útiles para solucionar errores, calidad y problemas de rendimiento en la base de instalación del SDK que es posible que no se capturen en nuestras pruebas internas. Al implementar la aplicación con el SDK, es importante proporcionar a los usuarios y administradores la posibilidad de no enviar datos de diagnóstico si es necesario.

Configuración de diagnóstico

Las opciones de diagnóstico del SDK de MIP se pueden controlar a través de DiagnosticConfiguration. Cree una instancia de esta clase y establezca isMinimalTelemetryEnabled en true. Proporcione el objeto de la clase DiagnosticConfiguration a la función utilizada para crear MipContext.

Eventos de diagnóstico mínimos

Cuando la configuración de diagnóstico se establece en mínima, se envía un conjunto mínimo de datos a Microsoft. Toda la información de identificación personal se borra de esta información. Estos datos incluyen información de latido para saber que el SDK se está usando y conocer los metadatos del sistema. No se establece ningún contenido de usuario ni información de identificación del usuario final en el servicio.

Revise las tablas siguientes para ver exactamente qué eventos y datos se envían con los diagnósticos mínimos habilitados.

Evento: Pulso

Nombre Descripción Limpieza
App.ApplicationId Identificador de aplicación proporcionado a través de mip::ApplicationInfo. No
App.ApplicationName El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
App.ApplicationVersion La versión de la aplicación proporcionada a través de mip::ApplicationInfo. No
ApplicationId La versión de la aplicación proporcionada a través de mip::ApplicationInfo. No
ApplicationName El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
HoraDeCreación Hora a la que se generó el evento No
DefaultLabel.Id Id. de etiqueta del inquilino predeterminado No
Engine.TenantId GUID del inquilino principal del usuario autenticado No
Engine.UserObjectId Id. de objeto de usuario en Microsoft Entra ID. No
Event.CorrelationId Identificador único generado asociado al objeto que desencadenó el evento. No
Event.CorrelationIdDescription Nombre de clase de C++ del objeto que desencadenó el evento. No
Event.ParentCorrelationId Id. de correlación de eventos principales No
Event.ParentCorrelationIdDescription Identificador único generado asociado al elemento primario del objeto que desencadenó el evento. No
Event.UniqueId Identificador único generado que se asigna al evento. No
NombreDeLaMáquina Nombre del sistema que generó el evento.
MIP. Versión Versión del SDK de MIP. No
Operación Latido No
IdDeOrganización GUID del inquilino principal del usuario autenticado No
Plataforma Versión del sistema operativo. No
ProcessName Nombre del proceso mediante el SDK. No
Versión del Producto Igual que "App.ApplicationVersion" No
Versión del SDK Igual que MIP.Version No
UserId Email dirección del usuario.
UserObjectId Id. de objeto de Microsoft Entra del usuario No
Versión Esquema de versión de auditoría ("1.1") No

Evento: Detección

Nombre Descripción Limpieza
ActionId Identificador de acción único para este evento, que se usa para la correlación de eventos. No
App.ApplicationId Identificador de aplicación proporcionado a través de mip::ApplicationInfo. No
App.ApplicationName El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
App.ApplicationVersion La versión de la aplicación proporcionada a través de mip::ApplicationInfo. No
ApplicationId La versión de la aplicación proporcionada a través de mip::ApplicationInfo. No
ApplicationName El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
HoraDeCreación Hora a la que se generó el evento No
DataState El estado de los datos según la aplicación actúe sobre ellos: “REPOSO”, “MOVIMIENTO”, “USO”. No
DefaultLabel.Id Identificador de etiqueta del inquilino predeterminado No
Engine.TenantId GUID del inquilino principal del usuario autenticado No
Engine.UserObjectId Identificador de objeto de usuario en Microsoft Entra ID. No
Event.CorrelationId Identificador único generado asociado al objeto que desencadenó el evento. No
Event.CorrelationIdDescription Nombre de clase de C++ del objeto que desencadenó el evento. No
Event.ParentCorrelationId Id. de correlación de eventos principales No
Event.ParentCorrelationIdDescription Identificador único generado asociado al elemento primario del objeto que desencadenó el evento. No
Event.UniqueId Identificador único generado que se asigna al evento. No
LabelId Identificador de etiqueta de contenido en el archivo o datos abiertos. No
NombreDeLaMáquina Nombre del sistema que generó el evento.
MIP. Versión Versión del SDK de MIP. No
ObjectId (identificador de objeto) Ruta de acceso o descripción del archivo o los datos.
Operación "Descubrimiento" No
IdDeOrganización GUID del inquilino principal del usuario autenticado No
Plataforma Versión del sistema operativo. No
ProcessName Nombre del proceso mediante el SDK. No
Protegido Booleano que indica si el archivo está protegido o no No
Protección Identificador de plantilla de protección
ProtectionOwner Dirección de correo electrónico del propietario de la protección.
Versión del SDK Igual que MIP.Version No
UserId Email dirección del usuario.
UserObjectId Id. de objeto de Microsoft Entra del usuario No
Versión Esquema de versión de auditoría ("1.1") No

Evento: Cambio de etiqueta

Nombre Descripción Limpieza
ActionId Identificador de acción único para este evento, que se usa para la correlación de eventos. No
ActionIdBefore ID de acción anterior. Se usa para encadenar un nuevo identificador de acción. No
ActionSource Valor de MIP::ActionSource. No
App.ApplicationId El identificador de aplicación proporcionado a través de mip::ApplicationInfo. No
App.ApplicationName El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
App.ApplicationVersion La versión de la aplicación proporcionada a través de mip::ApplicationInfo. No
ApplicationId El identificador de aplicación proporcionado a través de mip::ApplicationInfo. No
ApplicationName El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
HoraDeCreación Hora en que se generó el evento. No
DataState El estado de los datos según la aplicación actúe sobre ellos: “REPOSO”, “MOVIMIENTO”, “USO”. No
DefaultLabel.Id Identificador de etiqueta del inquilino predeterminado No
Engine.TenantId GUID del inquilino principal del usuario autenticado No
Engine.UserObjectId Identificador de objeto de usuario en Microsoft Entra ID. No
Event.CorrelationId Identificador único generado asociado al objeto que desencadenó el evento. No
Event.CorrelationIdDescription Nombre de clase de C++ del objeto que desencadenó el evento. No
Event.ParentCorrelationId Id. de correlación de eventos principales No
Event.ParentCorrelationIdDescription Identificador único generado asociado al elemento primario del objeto que desencadenó el evento. No
Event.UniqueId Identificador único generado que se asigna al evento. No
IsLabelChanged Booleano que indica si la etiqueta ha cambiado No
IsProtectionChanged Booleano que indica si ha cambiado la protección No
LabelId Identificador de etiqueta que se va a aplicar al archivo o a los datos. No
LabelIdBefore Identificador de etiqueta anterior que estaba en el archivo o los datos No
NombreDeLaMáquina Nombre del sistema que generó el evento.
MIP. Versión Versión del SDK de MIP. No
ObjectId (identificador de objeto) Ruta de acceso o descripción del archivo o los datos.
Operación "Change" No
IdDeOrganización GUID del inquilino principal del usuario autenticado No
Plataforma Versión del sistema operativo. No
ProcessName Nombre del proceso mediante el SDK. No
Versión del producto No
Protegido Booleano que indica si el archivo está protegido o no No
Protegido antes Booleano que indica si el archivo estuvo protegido antes o no No
Protección Identificador de plantilla de protección No
Protección antes Identificador de la plantilla de protección anterior No
ProtectionContentId El nuevo identificador de contenido (GUID). No
ProtectionContentIdBefore Identificador de contenido anterior (GUID) No
ProtectionOwner Dirección de correo electrónico del propietario de la protección.
ProtectionOwnerBefore Dirección de correo electrónico anterior del propietario de la protección.
Versión del SDK Igual que MIP.Version No
UserId Email dirección del usuario.
UserObjectId Id. de objeto de Microsoft Entra del usuario No
Versión Esquema de versión de auditoría ("1.1") No

No participar en C++

Para establecer los diagnósticos al mínimo, cree un puntero compartido de mip::D iagnosticConfiguration() y establezca isMinimalTelemetryEnabled en true. Pase el objeto al MipConfiguration::SetDiagnosticConfiguration() luego use MipConfiguration para generar MipContext.

auto diagnosticConfig = std::make_shared<mip::DiagnosticConfiguration>();
diagnosticConfig->isMinimalTelemetryEnabled = true;
					   
// Create MipConfiguration. 
// Initialize MipConfiguration.
std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
                                                                                                 "file_sample",
				                                                                                 mip::LogLevel::Trace,
				                                                                                 false);

// Set DiagnosticConfig
mipConfiguration->SetDiagnosticConfiguration(diagnosticConfig);

mMipContext = mip::MipContext::Create(mipConfiguration);

No participar en .NET

Para establecer los datos de diagnóstico solo como mínimo, cree un objeto DiagnosticConfiguration() y establezca isMinimalTelemetryEnabled en true. Establezca la propiedad DiagnosticOverride en MipConfiguration y, a continuación, cree MipContext.

DiagnosticConfiguration diagnosticConfiguration = new DiagnosticConfiguration();
diagnosticConfiguration.IsMinimalTelemetryEnabled = true;

// Create MipConfiguration.
MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false);

// Set Diagnostic Override.
mipConfiguration.DiagnosticOverride = diagnosticConfiguration;

// Create MipContext.
MipContext mipContext = MIP.CreateMipContext(mipConfiguration);