Raccogliere i contatori delle prestazioni per applicazioni Linux in Log AnalyticsCollect performance counters for Linux applications in Log Analytics

Questo articolo fornisce informazioni dettagliate per configurare l'agente OMS per Linux in modo che raccolga i contatori delle prestazioni per applicazioni specifiche.This article provides details for configuring the OMS Agent for Linux to collect performance counters for specific applications. Le applicazioni incluse in questo articolo sono:The applications included in this article are:

MySQLMySQL

Se viene rilevato un server MySQL o MariaDB nel computer in cui è installato l'agente OMS, viene automaticamente installato un provider di monitoraggio delle prestazioni per il server MySQL.If MySQL Server or MariaDB Server is detected on the computer when the OMS agent is installed, a performance monitoring provider for MySQL Server will be automatically installed. Questo provider si connette al server MySQL/MariaDB locale per esporre le statistiche relative alle prestazioni.This provider connects to the local MySQL/MariaDB server to expose performance statistics. Le credenziali utente di MySQL devono essere configurate in modo che il provider possa accedere al server MySQL.MySQL user credentials must be configured so that the provider can access the MySQL Server.

Configurare le credenziali di MySQLConfigure MySQL credentials

Il provider OMI MySQL richiede un utente di MySQL preconfigurato e librerie client MySQL installate, in modo da poter eseguire query sulle prestazioni o sulle informazioni di integrità dall'istanza di MySQL.The MySQL OMI provider requires a preconfigured MySQL user and installed MySQL client libraries in order to query the performance and health information from the MySQL instance. Queste credenziali vengono salvate in un file di autenticazione archiviato nell'agente Linux.These credentials are stored in an authentication file that's stored on the Linux agent. Il file di autenticazione specifica il valore bind-address e la porta su cui è in ascolto l'istanza di MySQL e le credenziali da usare per raccogliere metriche.The authentication file specifies what bind-address and port the MySQL instance is listening on and what credentials to use to gather metrics.

Durante l'installazione dell'agente OMS per Linux, il provider OMI MySQL analizzerà i file di configurazione my.cnf di MySQL (percorsi predefiniti) per cercare il valore bind-address e la porta e imposterà in modo parziale il file di configurazione di OMI MySQL.During installation of the OMS Agent for Linux the MySQL OMI provider will scan MySQL my.cnf configuration files (default locations) for bind-address and port and partially set the MySQL OMI authentication file.

Il file di autenticazione di MySQL viene archiviato in /var/opt/microsoft/mysql-cimprov/auth/omsagent/mysql-auth.The MySQL authentication file is stored at /var/opt/microsoft/mysql-cimprov/auth/omsagent/mysql-auth.

Formato del file di autenticazioneAuthentication file format

Di seguito è riportato il formato per il file di autenticazione di OMI MySQLFollowing is the format for the MySQL OMI authentication file

[Port]=[Bind-Address], [username], [Base64 encoded Password]
(Port)=(Bind-Address), (username), (Base64 encoded Password)
(Port)=(Bind-Address), (username), (Base64 encoded Password)
AutoUpdate=[true|false]

Nella tabella seguente sono descritte le voci presenti nel file di autenticazione.The entries in the authentication file are described in the following table.

ProprietàProperty DescrizioneDescription
PortaPort Rappresenta la porta corrente su cui è in ascolto l'istanza di MySQL.Represents the current port the MySQL instance is listening on. La porta 0 indica che per l'istanza predefinita vengono usate le proprietà seguenti.Port 0 specifies that the properties following are used for default instance.
Bind-addressBind-Address Valore bind-address corrente di MySQL.Current MySQL bind-address.
usernameusername Utente di MySQL usato per monitorare l'istanza del server MySQL.MySQL user used to use to monitor the MySQL server instance.
Password con codifica Base64Base64 encoded Password Password dell'utente di monitoraggio di MySQL con codifica Base64.Password of the MySQL monitoring user encoded in Base64.
AutoUpdateAutoUpdate Specifica se ripetere la ricerca di modifiche nel file my.cnf e se sovrascrivere il file di autenticazione di OMI MySQL quando viene aggiornato il provider OMI MySQL.Specifies whether to rescan for changes in the my.cnf file and overwrite the MySQL OMI Authentication file when the MySQL OMI Provider is upgraded.

Istanza predefinitaDefault instance

Il file di autenticazione di OMI MySQL può definire un numero di porta e un'istanza predefinita per semplificare la gestione di più istanze di MySQL in un unico host Linux.The MySQL OMI authentication file can define a default instance and port number to make managing multiple MySQL instances on one Linux host easier. L'istanza predefinita è costituita dall'istanza con la porta 0.The default instance is denoted by an instance with port 0. Tutte le istanze aggiuntive ereditano le proprietà impostate dall'istanza predefinita, a meno che non vengano specificati valori diversi.All additional instances will inherit properties set from the default instance unless they specify different values. Se, ad esempio, viene aggiunta l'istanza di MySQL in ascolto sulla porta "3308", il valore bind-address, il nome utente e la password con codifica Base64 dell'istanza predefinita verranno usati per provare a monitorare l'istanza in ascolto sulla porta 3308.For example, if MySQL instance listening on port ‘3308’ is added, the default instance’s bind-address, username, and Base64 encoded password will be used to try and monitor the instance listening on 3308. Se l'istanza sulla porta 3308 è associata a un altro indirizzo e usa la stessa coppia nome utente e password di MySQL, sarà necessario specificare solo il valore bind-address e le altre proprietà verranno ereditate.If the instance on 3308 is bound to another address and uses the same MySQL username and password pair only the bind-address is needed, and the other properties will be inherited.

Nella tabella seguente sono riportate impostazioni di un'istanza di esempioThe following table has example instance settings

DescrizioneDescription FileFile
Istanza predefinita e istanza con porta 3308.Default instance and instance with port 3308. 0=127.0.0.1, myuser, cnBwdA==
3308=, ,
AutoUpdate=true
Istanza predefinita e istanza con porta 3308 e nome e password diversi.Default instance and instance with port 3308 and different user name and password. 0=127.0.0.1, myuser, cnBwdA==
3308=127.0.1.1, myuser2,cGluaGVhZA==
AutoUpdate=true

Programma del file di autenticazione OMI MySQLMySQL OMI Authentication File Program

Con l'installazione del provider OMI MySQL viene fornito un programma per il file di autenticazione di OMI MySQL che consente di modificare il file di autenticazione di OMI MySQL.Included with the installation of the MySQL OMI provider is a MySQL OMI authentication file program which can be used to edit the MySQL OMI Authentication file. Il programma del file di autenticazione si trova nel percorso seguente.The authentication file program can be found at the following location.

/opt/microsoft/mysql-cimprov/bin/mycimprovauth

Nota

Il file delle credenziali deve essere leggibile dall'account omsagent.The credentials file must be readable by the omsagent account. È consigliabile eseguire il comando mycimprovauth come omsgent.Running the mycimprovauth command as omsgent is recommended.

La tabella seguente fornisce informazioni dettagliate sulla sintassi per l'utilizzo di mycimprovauth.The following table provides details on the syntax for using mycimprovauth.

OperazioneOperation EsempioExample DescrizioneDescription
autoupdate *false\autoupdate *false\ truetrue mycimprovauth autoupdate falsemycimprovauth autoupdate false
default bind-address nome utente passworddefault bind-address username password mycimprovauth default 127.0.0.1 root pwdmycimprovauth default 127.0.0.1 root pwd Imposta l'istanza predefinita nel file di autenticazione di OMI MySQL.Sets the default instance in the MySQL OMI authentication file.
Nel campo della password deve essere immesso un valore in testo normale: la password nel file di autenticazione di OMI MySQL verrà codificata in Base 64.The password field should be entered in plain text - the password in the MySQL OMI authentication file will be Base 64 encoded.
delete *predefinita\delete *default\ num_portport_num mycimprovauth 3308mycimprovauth 3308
helphelp mycimprov helpmycimprov help Stampa un elenco di comandi da usare.Prints out a list of commands to use.
printprint mycimprov printmycimprov print Stampa un file di autenticazione di OMI MySQL di facile lettura.Prints out an easy to read MySQL OMI authentication file.
update port_num bind-address nome utente passwordupdate port_num bind-address username password mycimprov update 3307 127.0.0.1 root pwdmycimprov update 3307 127.0.0.1 root pwd Aggiorna l'istanza specificata o aggiunge l'istanza, se non esiste.Updates the specified instance or adds the instance if it does not exist.

I comandi di esempio seguenti definiscono un account utente predefinito per il server MySQL su localhost.The following example commands define a default user account for the MySQL server on localhost. Nel campo della password deve essere immesso un valore in testo normale: la password nel file di autenticazione OMI MySQL verrà codificata in Base 64.The password field should be entered in plain text - the password in the MySQL OMI authentication file will be Base 64 encoded

sudo su omsagent -c '/opt/microsoft/mysql-cimprov/bin/mycimprovauth default 127.0.0.1 <username> <password>'
sudo /opt/omi/bin/service_control restart

Autorizzazioni del database necessarie per i contatori delle prestazioni di MySQLDatabase Permissions Required for MySQL Performance Counters

L'utente di MySQL deve poter accedere alle query seguenti per raccogliere dati sulle prestazioni del server MySQL.The MySQL User requires access to the following queries to collect MySQL Server performance data.

SHOW GLOBAL STATUS;
SHOW GLOBAL VARIABLES:

L'utente di MySQL deve anche avere l'accesso di tipo SELECT alle tabelle predefinite seguenti.The MySQL user also requires SELECT access to the following default tables.

  • information_schemainformation_schema
  • mysql.mysql.

Questi privilegi possono essere concessi mediante l'esecuzione dei comandi grant seguenti.These privileges can be granted by running the following grant commands.

GRANT SELECT ON information_schema.* TO ‘monuser’@’localhost’;
GRANT SELECT ON mysql.* TO ‘monuser’@’localhost’;

Nota

Per concedere autorizzazioni a un utente di monitoraggio di MySQL, l'utente che le concede deve avere il privilegio 'GRANT option', oltre al privilegio da concedere.To grant permissions to a MySQL monitoring user the granting user must have the ‘GRANT option’ privilege as well as the privilege being granted.

Definire i contatori delle prestazioniDefine performance counters

Dopo aver configurato l'agente OMS per Linux per inviare dati a Log Analytics, è necessario configurare i contatori delle prestazioni da raccogliere.Once you configure the OMS Agent for Linux to send data to Log Analytics, you must configure the performance counters to collect. Usare la procedura descritta in Origini dati per le prestazioni di Windows e Linux in Log Analytics con i contatori presenti nella tabella seguente.Use the procedure in Windows and Linux performance data sources in Log Analytics with the counters in the following table.

Nome oggettoObject Name Nome contatoreCounter Name
MySQL DatabaseMySQL Database Disk Space in BytesDisk Space in Bytes
MySQL DatabaseMySQL Database TabelleTables
Server MySQLMySQL Server Aborted Connection PctAborted Connection Pct
Server MySQLMySQL Server Connection Use PctConnection Use Pct
Server MySQLMySQL Server Disk Space Use in BytesDisk Space Use in Bytes
Server MySQLMySQL Server Full Table Scan PctFull Table Scan Pct
Server MySQLMySQL Server InnoDB Buffer Pool Hit PctInnoDB Buffer Pool Hit Pct
Server MySQLMySQL Server InnoDB Buffer Pool Use PctInnoDB Buffer Pool Use Pct
Server MySQLMySQL Server InnoDB Buffer Pool Use PctInnoDB Buffer Pool Use Pct
Server MySQLMySQL Server Key Cache Hit PctKey Cache Hit Pct
Server MySQLMySQL Server Key Cache Use PctKey Cache Use Pct
Server MySQLMySQL Server Key Cache Write PctKey Cache Write Pct
Server MySQLMySQL Server Query Cache Hit PctQuery Cache Hit Pct
Server MySQLMySQL Server Query Cache Prunes PctQuery Cache Prunes Pct
Server MySQLMySQL Server Query Cache Use PctQuery Cache Use Pct
Server MySQLMySQL Server Table Cache Hit PctTable Cache Hit Pct
Server MySQLMySQL Server Table Cache Use PctTable Cache Use Pct
Server MySQLMySQL Server Table Lock Contention PctTable Lock Contention Pct

Server HTTP ApacheApache HTTP Server

Se viene rilevato un server HTTP Apache nel computer in cui è installata l'aggregazione omsagent, viene automaticamente installato un provider di monitoraggio delle prestazioni per il server HTTP Apache.If Apache HTTP Server is detected on the computer when the omsagent bundle is installed, a performance monitoring provider for Apache HTTP Server will be automatically installed. Questo provider si basa su un modulo Apache che deve essere caricato nel server HTTP Apache per poter accedere ai dati sulle prestazioni.This provider relies on an Apache module that must be loaded into the Apache HTTP Server in order to access performance data. È possibile caricare il modulo con il comando seguente:The module can be loaded with the following command:

sudo /opt/microsoft/apache-cimprov/bin/apache_config.sh -c

Per scaricare il modulo di monitoraggio Apache, eseguire il comando seguente:To unload the Apache monitoring module, run the following command:

sudo /opt/microsoft/apache-cimprov/bin/apache_config.sh -u

Definire i contatori delle prestazioniDefine performance counters

Dopo aver configurato l'agente OMS per Linux per inviare dati a Log Analytics, è necessario configurare i contatori delle prestazioni da raccogliere.Once you configure the OMS Agent for Linux to send data to Log Analytics, you must configure the performance counters to collect. Usare la procedura descritta in Origini dati per le prestazioni di Windows e Linux in Log Analytics con i contatori presenti nella tabella seguente.Use the procedure in Windows and Linux performance data sources in Log Analytics with the counters in the following table.

Nome oggettoObject Name Nome contatoreCounter Name
Apache HTTP ServerApache HTTP Server Busy WorkersBusy Workers
Apache HTTP ServerApache HTTP Server Idle WorkersIdle Workers
Apache HTTP ServerApache HTTP Server Pct Busy WorkersPct Busy Workers
Apache HTTP ServerApache HTTP Server Total Pct CPUTotal Pct CPU
Apache Virtual HostApache Virtual Host Errors per Minute - ClientErrors per Minute - Client
Apache Virtual HostApache Virtual Host Errors per Minute - ServerErrors per Minute - Server
Apache Virtual HostApache Virtual Host KB per RequestKB per Request
Apache Virtual HostApache Virtual Host Requests KB per SecondRequests KB per Second
Apache Virtual HostApache Virtual Host Requests per SecondRequests per Second

Passaggi successiviNext steps