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

Datos de diagnóstico

De forma predeterminada, el SDK Microsoft Information Protection envía datos de diagnóstico a Microsoft. Estos datos son útiles para solucionar problemas de rendimiento, calidad y errores en toda la base de instalación del SDK que es posible que no capturemos en nuestras pruebas internas. Al implementar la aplicación con el SDK, es importante que los usuarios y administradores puedan optar por 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, a continuación, establezca isMinimalTelemetryEnabled en true. Proporcione el objeto de clase DiagnosticConfiguration a la función usada 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 desvía de esta información. Estos datos incluyen información sobre los latidos del corazón para comprender que se usa el SDK y los metadatos del sistema. No se establece ningún contenido de usuario ni información de identificación de usuario final en el servicio.

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

Evento: Heartbeat

Nombre Descripción Scrubbed
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 La versión de la aplicación proporcionada a través de mip::ApplicationInfo. No
NombreDeUsuario El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
CreationTime Se generó un evento de hora. No
DefaultLabel.Id Identificador de etiqueta predeterminado del inquilino. No
Engine.TenantId GUID del inquilino principal del usuario autenticado. No
Engine.UserObjectId Id. de objeto de usuario en Azure Active Directory. No
Event.CorrelationId Id. único generado asociado al objeto que desencadenó el evento. No
Event.CorrelationIdDescription C++ nombre de clase del objeto que desencadenó el evento. No
Event.ParentCorrelationId Id. de correlación de eventos primarios. No
Event.ParentCorrelationIdDescription Id. único generado asociado con el elemento primario del objeto que desencadenó el evento. No
Event.UniqueId Id. único generado asignado al evento. No
MachineName Nombre del sistema que generó el evento.
MIP. Versión Versión del SDK de MIP. No
Operación Heartbeat No
OrganizationId GUID del inquilino principal del usuario autenticado. No
Plataforma Versión del sistema operativo. No
ProcessName Nombre del proceso con el SDK. No
ProductVersion Igual que "App.ApplicationVersion". No
SDKVersion Igual que MIP. Versión. No
UserId Dirección de correo electrónico del usuario.
UserObjectId Azure AD de objeto del usuario. No
Versión Esquema de versión de auditoría ("1.1"). No

Evento: Detección

Nombre Descripción Scrubbed
ActionId Id. de acción único para este evento, que se usa para la correlación de eventos. 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 La versión de la aplicación proporcionada a través de mip::ApplicationInfo. No
NombreDeUsuario El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
CreationTime Se generó un evento de hora. No
DataState El estado de los datos mientras la aplicación actúa sobre ellos "REST", "MOTION", "USE". No
DefaultLabel.Id Identificador de etiqueta predeterminado del inquilino. No
Engine.TenantId GUID del inquilino principal del usuario autenticado. No
Engine.UserObjectId Identificador de objeto de usuario en Azure Active Directory. No
Event.CorrelationId Id. único generado asociado al objeto que desencadenó el evento. No
Event.CorrelationIdDescription C++ nombre de clase del objeto que desencadenó el evento. No
Event.ParentCorrelationId Id. de correlación de eventos primarios. No
Event.ParentCorrelationIdDescription Id. único generado asociado con el elemento primario del objeto que desencadenó el evento. No
Event.UniqueId Id. único generado asignado al evento. No
LabelId Identificador de etiqueta de contenido en el archivo o datos abiertos. No
MachineName Nombre del sistema que generó el evento.
MIP. Versión Versión del SDK de MIP. No
ObjectId Ruta de acceso o descripción del archivo o los datos.
Operación "Detección". No
OrganizationId GUID del inquilino principal del usuario autenticado. No
Plataforma Versión del sistema operativo. No
ProcessName Nombre del proceso con el SDK. No
Protegido Bool que indica si el archivo está protegido o no. No
Protección El identificador de plantilla de protección.
ProtectionOwner Dirección de correo electrónico del propietario de la protección.
SDKVersion Igual que MIP. Versión. No
UserId Dirección de correo electrónico del usuario.
UserObjectId Azure AD de objeto del usuario. No
Versión Esquema de versión de auditoría ("1.1"). No

Evento: Cambio de etiqueta

Nombre Descripción Scrubbed
ActionId Id. 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 a un id. de acción nuevo. No
ActionSource Valor de MIP::ActionSource. No
App.ApplicationId El id. de la 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 id. de la aplicación proporcionado a través de mip::ApplicationInfo. No
NombreDeUsuario El nombre de la aplicación proporcionado a través de mip::ApplicationInfo. No
CreationTime Hora en que se generó el evento. No
DataState El estado de los datos mientras la aplicación actúa sobre ellos "REST", "MOTION", "USE". No
DefaultLabel.Id Identificador de etiqueta predeterminado del inquilino. No
Engine.TenantId GUID del inquilino principal del usuario autenticado. No
Engine.UserObjectId Identificador de objeto de usuario en Azure Active Directory. No
Event.CorrelationId Id. único generado asociado al objeto que desencadenó el evento. No
Event.CorrelationIdDescription C++ nombre de clase del objeto que desencadenó el evento. No
Event.ParentCorrelationId Id. de correlación de eventos primarios. No
Event.ParentCorrelationIdDescription Id. único generado asociado con el elemento primario del objeto que desencadenó el evento. No
Event.UniqueId Id. único generado asignado al evento. No
IsLabelChanged Bool que indica si la etiqueta ha cambiado. No
IsProtectionChanged Bool que indica si la protección ha cambiado. No
LabelId Id. de etiqueta que se va a aplicar al archivo o a los datos. No
LabelIdBefore Id. de etiqueta anterior que estaba en el archivo o los datos. No
MachineName Nombre del sistema que generó el evento.
MIP. Versión Versión del SDK de MIP. No
ObjectId Ruta de acceso o descripción del archivo o los datos.
Operación "Cambiar". No
OrganizationId GUID del inquilino principal del usuario autenticado. No
Plataforma Versión del sistema operativo. No
ProcessName Nombre del proceso con el SDK. No
Versión del producto No
Protegido Bool que indica si el archivo está protegido o no. No
Protegido antes Bool que indica si el archivo estaba protegido previamente o no. No
Protección El identificador de plantilla de protección. No
Protección antes El identificador de plantilla de protección anterior. No
ProtectionContentId El nuevo identificador de contenido (GUID). No
ProtectionContentIdBefore El 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.
SDKVersion Igual que MIP. Versión. No
UserId Dirección de correo electrónico del usuario.
UserObjectId Azure AD de objeto del usuario. No
Versión Esquema de versión de auditoría ("1.1"). No

Optar por no participar en C++

Para establecer el diagnóstico como mínimo, cree un puntero compartido de mip::D iagnosticConfiguration() y establezca isMinimalTelemetryEnabled en true. Pase el objeto MipConfiguration::SetDiagnosticConfiguration() para, a continuación, usar MipConfiguration el archivo 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);

Optar por no participar en .NET

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

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);