cs_show_cluster_patterns(8)

๐Ÿ“ฆ version 3.1.3, in opensuse-leap 16.0

๐Ÿ’… cs_show_cluster_patterns(8) โ€” the ClusterTools2 one, section 8 bestie ๐ŸŽ€

okay so picture this: it's like 3am, your cluster is being A Whole Thing, and you need to know what actually happened in the logs. That's this script. It's a section 8 system admin tool from ClusterTools2, and it's literally just out here searching your log files for cluster patterns so you don't have to grep blindly like a lost little butterfly ๐Ÿฆ‹


โœจ NAME โœจ

cs_show_cluster_patterns โ€” search log files for cluster patterns ๐Ÿ”


โœจ SYNOPSIS โœจ

cs_show_cluster_patterns OPTION

โœจ DESCRIPTION โœจ

cs_show_cluster_patterns searches log files for cluster patterns. That's the whole vibe, that's the job ๐Ÿซถ

โš ๏ธ important heads-up bestie: most cluster components do logging to their local node only. So no cap, don't be shocked when Node B's drama isn't showing up in Node A's logs โ€” that's just how it is ๐Ÿ’€

โœจ OPTIONS โœจ

  • --help โ€” show help. your classic "what even is this" button ๐Ÿ™ˆ
  • --version โ€” show version. so you can prove which one you're on ๐Ÿ‘‘
  • --writecfg โ€” show some internal variables. behind-the-scenes peek ๐ŸŽ€
  • --show โ€” show all patterns. everything, the full menu โœจ
  • --fencing โ€” show fencing patterns. the "somebody got kicked out" section ๐Ÿ”ฅ
  • --migration โ€” show migration patterns. resources moving around, main character energy ๐Ÿ’…
  • --count โ€” count total for each pattern. numbers girlies rise ๐Ÿงฎ
  • --zip โ€” count from compressed logs, too. This could take some time. โณ lowkey a patience test

๐ŸŒธ EXAMPLES ๐ŸŒธ

show migrations โ€” like, which resources went where?

# cs_show_cluster_patterns -m

count occurance of patterns, show non-null only:

# cs_show_cluster_patterns -c | grep -v "=.0$"

show whole lines, but only for January. Useful if logs contain December as well:

# cs_show_cluster_patterns -s | grep "^Jan"

iykyk โ€” that December/January thing is foreshadowing, keep reading ๐Ÿ“


โœจ EXIT STATUS โœจ

  • 0 โ€” Successful program execution. slay, it worked โœจ
  • >0 โ€” Usage, syntax or execution errors. it's giving "you typed something cursed" ๐Ÿ˜ญ

๐Ÿฆ‹ FILES ๐Ÿฆ‹

  • /usr/sbin/cs_show_cluster_patterns โ€” the program itself. the moment ๐Ÿ’–
  • /etc/ClusterTools2/cs_show_cluster_patterns โ€” the configuration. its little settings corner ๐ŸŽ€
  • /etc/corosync/corosync.conf โ€” the corosync configuration, maybe defining log file. "maybe" doing a lot of work there, ngl ๐Ÿ‘€
  • /var/log/messages โ€” the default log file. old reliable โญ

๐Ÿ’€ BUGS ๐Ÿ’€

okay listen, real talk:

This script depends on LC_MESSAGES respective RC_LANG set to en_US or C. So if your locale is doing its own thing, this script is gonna be confused, and that's on the locale fr fr ๐Ÿ™ˆ

Furthermore the scripts sort output by month. This results in wrong order of lines, if a logfile f.e. contains December and January. Like, December before January? in this economy? yeah, the sort doesn't know about calendar years ๐Ÿ—“๏ธ๐Ÿ’€ (this is the December thing from the examples, told you)

Feedback is welcome, please mail to feedback@suse.com ๐Ÿ“ฌ they genuinely want to hear from you!


๐Ÿงš SEE ALSO ๐Ÿงš

cs_show_error_patterns(8), cs_show_cluster_transition(8), grep(1), syslog(8), logrotate(8), corosync.conf(5), ClusterTools2(7) โ€” the whole friend group, go say hi ๐Ÿซถ


(c) 2011-2019 L.Pinne, Germany. cs_show_cluster_patterns comes with ABSOLUTELY NO WARRANTY. For details see the GNU General Public License at http://www.gnu.org/licenses/gpl.html


and that's the whole page bestie!! ๐ŸŽ€ this iconic little manual is dated 01 Nov 2019, it ships with ClusterTools2, and it was written and maintained by L.Pinne, Germany โ€” go off, legend ๐Ÿ‘‘๐Ÿ’œ

๐Ÿ“ฆ where this page comes from