pmlogger_check - En ligne dans le Cloud

PROGRAMME:

Nom

pmlogger_check, pmlogger_daily, pmlogger_merge - administration de Performance Co-Pilot
archiver les fichiers journaux

SYNOPSIS

$PCP_BINADM_DIR/pmlogger_check [-CNsTV] [-c des bactéries] [-l fichier journal]
$PCP_BINADM_DIR/pmlogger_daily [-NorV] [-c des bactéries] [-k Jeter] [-l fichier journal] [-m
adresses] [-s longueur du câble] [-t souhaitez] [-x compresser] [-X Programme] [-Y regex]
$PCP_BINADM_DIR/pmlogger_merge [-fNV] [nom-base d'entrée ... nom-sortie]

DESCRIPTION

Cette série de scripts shell et les fichiers de contrôle associés peuvent être utilisés pour créer un
régime personnalisé d'administration et de gestion pour Performance Co-Pilot (voir
PCPintro(1)) archiver les fichiers journaux.

pmlogger_daily est destiné à être exécuté une fois par jour, de préférence tôt le matin, car
peu après minuit dans la mesure du possible. Sa tâche est d'agréger et de faire tourner un ou plusieurs ensembles
des archives du PCP. Après un certain temps, les anciennes archives PCP sont supprimées. Cette période est de 14
jours par défaut, mais peut être modifié à l'aide du -k option. Deux valeurs particulières sont reconnues
pour la période (Jeter), à savoir 0 ne conserver aucune archive au-delà de l'actuelle, et toujours
pour éviter que des archives ne soient supprimées.

Les fichiers de données d'archive peuvent éventuellement être compressés après un certain temps pour économiser de l'espace disque.
Ceci est particulièrement utile pour un grand nombre de pmlogger processus sous le contrôle de
pmlogger_check. Par défaut, aucune compression n'est effectuée. Les -x option permet la compression et
spécifie le nombre de jours après lequel compresser les fichiers de données d'archive, et le -X option
spécifie le programme à utiliser pour la compression - par défaut c'est xz(1). Utilisation du -Y
L'option permet de spécifier une expression régulière provoquant des fichiers dans l'ensemble de fichiers
apparié pour que la compression soit omise - cela permet uniquement au fichier de données d'être compressé,
et empêche également le programme d'essayer de le compresser plus d'une fois. Le défaut
regex est ".(meta|index|Z|gz|bz2|zip|xz|lzma|lzo|lz4)$" - ces fichiers sont filtrés à l'aide du
-v Option de égrep (1).

Pour s'adapter à l'évolution des PMDA et aux changements dans les environnements de journalisation de la production,
pmlogger_daily est intégré à pmlogrewrite(1) pour permettre facultatif et automatique
réécriture d'archives avant fusion. S'il y a des règles de réécriture globales à appliquer
dans toutes les archives mentionnées dans le(s) fichier(s) de contrôle, puis créez le répertoire
$PCP_SYSCONF_DIR/pmlogrewrite et placez n'importe quel pmlogrewrite(1) réécrire les règles dans ce
annuaire. Pour les règles de réécriture spécifiques à une seule famille d'archives, utilisez le
nom du répertoire du ou des fichiers de contrôle - c'est-à-dire le Quatrième champ - et créez un fichier, ou un
répertoire, ou un lien symbolique nommé pmlogrewrite dans ce répertoire et placez le
règle(s) de réécriture requise(s) dans le pmlogrewrite fichier ou dans des fichiers dans le pmlogrewrite
sous-répertoire. pmlogger_daily choisira les règles de réécriture dans le répertoire d'archive si
elles existent, sinon la réécriture des règles de $PCP_SYSCONF_DIR/pmlogrewrite si ce répertoire
existe, sinon aucune réécriture n'est tentée.

Le manuel de formation -r L'option de ligne de commande agit comme un remplacement et empêche toute réécriture d'archive avec
pmlogrewrite(1) indépendamment de la présence de fichiers ou de répertoires de règles de réécriture.

Par défaut, toutes les archives possibles seront fusionnées. Les -o l'option rétablit l'ancien
comportement dans lequel seules les archives d'hier seront considérées comme candidats à la fusion.

Dans le cas particulier où une seule archive d'entrée doit être fusionnée, pmlogmv(1) est
utilisé pour renommer l'archive, plutôt que de copier l'archive d'entrée en utilisant pmlogger_merge.

Le manuel de formation -M L'option peut être utilisée pour désactiver la fusion (ou le renommage) et la réécriture des archives (-M
implique -r). Ceci est particulièrement utile dans les cas où les archives sont progressivement
copié dans un référentiel distant, par exemple en utilisant rsync(1). Fusionner, renommer et réécrire tout
risque d'augmenter la charge de synchronisation, surtout immédiatement après pmlogger_daily
a couru, donc -M peut être utile dans ces cas.

Pour aider au débogage ou au diagnostic des pannes intermittentes, le -t option peut être utilisée.
Cela activera le traçage très détaillé (-VV) et capturez la sortie de trace dans un fichier nommé
$PCP_LOG_DIR/pmlogger/daily.horodatage.tracer, où horodatage est le temps pmlogger_daily
a été exécuté au format AAAAMMJJ.HH.MM. De plus, le souhaitez argument garantira que
fichiers de trace créés avec -t sera conservé pendant souhaitez jours puis jetés.

De plus, si le fichier PCP ``notices'' ($PCP_LOG_DIR/AVIS) est supérieur à 20480
octets, pmlogger_daily renommera le fichier avec un suffixe ``.old'', et commencera un nouveau
fichier ``notices''. Le seuil de rotation peut être modifié de 20480 à longueur du câble octets en utilisant le
-s option.

Utilisation du -m l'option provoque pmlogger_daily pour construire un résumé du fichier ``notices''
entrées qui ont été générées au cours des dernières 24 heures, et envoyer ce résumé par e-mail à l'ensemble des
séparés par des espaces adresses. Ce résumé quotidien est stocké dans le fichier
$PCP_LOG_DIR/NOTICES.daily, qui sera vide lorsqu'aucune nouvelle entrée ``notices'' n'a été faite
au cours des 24 heures précédentes.

Le scénario $PCP_BINADM_DIR/pmlogger_daily pourrait être copié et modifié pour mettre en œuvre un
procédure propre au site de gestion en fin de semaine et/ou en fin de mois pour un ensemble de PCP
archives.

pmlogger_check peut être exécuté à tout moment, et est destiné à vérifier que l'ensemble souhaité de
pmlogger(1) les processus sont en cours d'exécution et, dans le cas contraire, relancez les enregistreurs ayant échoué. Utilisation du
-s L'option fournit la fonctionnalité inverse, permettant l'ensemble de pmlogger processus à être
arrêt proprement. Utilisation du -C l'option interroge les informations de niveau d'exécution du service système
pour pmlogger, et l'utilise pour déterminer s'il faut démarrer ou arrêter les processus.

Le manuel de formation -T L'option fournit une forme de sortie plus rapide pour pmlogger_check qui convient le mieux
| pmlogger « ferme » où de nombreux cas de pmlogger devraient être en cours d'exécution.

pmlogger_merge est un script wrapper pour pmlogextrait(1) qui fusionne tous les journaux d'archives
correspondant à la nom-base d'entrée arguments et crée une nouvelle archive en utilisant nom-sortie car
nom de base des fichiers physiques qui constituent un journal d'archivage. Les nom-base d'entrée
les arguments peuvent contenir des méta-caractères dans le style de sh(1). Si spécifié, le -f option
entraîne la suppression de tous les fichiers d'entrée une fois l'archive de sortie créée.

pmlogger_merge est utilisé par pmlogger_daily.

Le pmlogger_daily et pmlogger_check sont contrôlés par le(s) fichier(s) de contrôle de l'enregistreur PCP qui
précise le pmlogger instances à gérer. Le fichier de contrôle par défaut est
$PCP_PMLOGGERCONTROL_PATH, mais une alternative peut être spécifiée à l'aide de la -c option. Si la
annuaire $PCP_PMLOGGERCONTROL_PATH.d (ou des bactéries.d du -c option) existe, alors la
le contenu de tout fichier de contrôle supplémentaire sera ajouté au fichier de contrôle principal
(qui doit exister).

Avertissement: Les $PCP_PMLOGGERCONTROL_PATH et $PCP_PMLOGGERCONTROL_PATHLes fichiers .d ne doivent pas être
accessible en écriture par tout utilisateur autre que root.

Le(s) fichier(s) de contrôle doivent être personnalisés selon les règles suivantes qui définissent pour
la version actuelle (1.1) du format de fichier de contrôle.

1. Les lignes commençant par un ``#'' sont des commentaires.
2. Les lignes commençant par un ``$'' sont supposées être des affectations à des variables d'environnement dans
le style de sh(1), et tout le texte suivant le ``$'' sera eval'ed par le script
lecture du fichier de contrôle, et la variable correspondante exportée dans le
environnement. Ceci est particulièrement utile pour définir et exporter des variables dans le
environnement des scripts administratifs, par exemple
$PMCD_CONNECT_TIMEOUT=20
3. Là doit être une ligne de version dans le fichier de contrôle initial de la forme :
$ version=1.1
4. Il doit y avoir une ligne dans le(s) fichier(s) de contrôle pour chaque pmlogger instance de la
forme:

hôte y|n y|n annuaire args

5. Les champs à l'intérieur d'une ligne du ou des fichiers de contrôle sont généralement séparés par un ou plusieurs
espaces ou tabulations (bien que référez-vous à la description du annuaire terrain pour certains
exceptions importantes).
6. le premier le champ est le nom de l'hôte qui est la source des mesures de performances
pour ça pmlogger exemple.
7. le seconde champ indique s'il s'agit d'un primaire pmlogger exemple (y) ou pas (n).
Étant donné que le consignateur principal doit s'exécuter sur l'hôte local et qu'il peut y avoir au plus un
logger principal pour un hôte particulier, ce champ peut être y pour au plus un pmlogger
instance, auquel cas le nom d'hôte doit être le nom de l'hôte local.
8. le troisième champ indique si ce pmlogger l'instance doit être démarrée sous le
contrôle de chaussettes(1) pour se connecter à un pmcd via un pare-feu (y or n).
9. le Quatrième champ est un nom de répertoire. Tous les fichiers associés à ce pmlogger
instance sera créée dans ce répertoire, et ce sera le répertoire courant pour
l'exécution de tout programme nécessaire à la maintenance de ces archives. Une utile
la convention est que le consignateur principal archive pour l'hôte local avec le nom d'hôte mon hôte sommes-nous
maintenu dans l'annuaire $PCP_LOG_DIR/pmlogger/mon hôte (c'est là que la valeur par défaut
pmlogger script de démarrage dans $PCP_RC_DIR/pcp créera les archives), tandis que les archives
pour l'hôte distant marmonner sont maintenus dans $PCP_LOG_DIR/pmlogger/marmonner.
10. Le champ répertoire peut contenir une syntaxe shell intégrée qui sera évaluée par sh(1)
pour produire le vrai nom de répertoire à utiliser. Les constructions autorisées sont :
· Tout texte (y compris les espaces blancs) entouré de $( et ).
· Tout texte (y compris les espaces blancs) entouré de ` et ` (retour de citations).
· Tout texte (y compris les espaces blancs) entouré de " et " (double citation).
· Tout mot contenant un $ (supposé introduire un nom de variable d'environnement).
11. Tous les autres champs sont interprétés comme des arguments à transmettre à pmlogger(1) et/ou
pmnewlog(1). Le plus souvent, ce serait le -c option.

Les exemples de lignes de contrôle suivants spécifient un enregistreur principal sur l'hôte local (Dieu), Et
enregistreurs non principaux pour collecter et enregistrer les métriques de performances des hôtes bancal et
boing.

$version=1.1
bozo yn $PCP_LOG_DIR/pmlogger/bozo -c config.default
wobbly nn "/store/wobbly/$(date +%Y)" -c ./wobbly.config
boing nn $PCP_LOG_DIR/pmlogger/boing -c ./pmlogger.config

Typique crontab(5) les inscriptions pour l'exécution périodique de pmlogger_daily et pmlogger_check sommes-nous
donné dans $PCP_SYSCONF_DIR/pmlogger/crontab (sauf si installé par défaut dans /etc/cron.d
déjà) et illustré ci-dessous.

# traitement quotidien des journaux d'archivage
14 0 * * * $PCP_BINADM_DIR/pmlogger_daily
# toutes les 30 minutes, vérifiez que les instances pmlogger sont en cours d'exécution
25,55 * * * * $PCP_BINADM_DIR/pmlogger_check

Afin de s'assurer que le courrier n'est pas envoyé par inadvertance lorsque ces scripts sont exécutés à partir de
cron(8) les diagnostics sont toujours envoyés dans un fichier journal. Par défaut, ce fichier est
$PCP_LOG_DIR/pmlogger/pmlogger_daily.log or $PCP_LOG_DIR/pmlogger/pmlogger_check.log mais
cela peut être modifié en utilisant le -l option. Si ce fichier journal existe déjà lorsque le script
démarre, il sera renommé avec un .préc suffixe (écrasement de tout fichier journal enregistré précédemment)
avant que les diagnostics ne soient générés dans le fichier journal. Les -l et -t les options ne peuvent pas être utilisées
ensemble.

La sortie du cron l'exécution des scripts peut être étendue à l'aide de la -V Option de
les scripts qui permettront un traçage verbeux de leur activité. Par défaut les scripts
ne génère aucune sortie à moins qu'une erreur ou une condition d'avertissement ne soit rencontrée.

Utilisez pmlogger_check en ligne en utilisant les services onworks.net