breack change: cpu and memory fortigate

This commit is contained in:
garnier-quentin 2020-02-21 13:57:20 +01:00
parent 26f31d95f0
commit 242335a143
2 changed files with 193 additions and 209 deletions

View File

@ -20,153 +20,138 @@
package centreon::common::fortinet::fortigate::snmp::mode::cpu; package centreon::common::fortinet::fortigate::snmp::mode::cpu;
use base qw(centreon::plugins::mode); use base qw(centreon::plugins::templates::counter);
use strict; use strict;
use warnings; use warnings;
my $oid_fgProcessorUsage = '.1.3.6.1.4.1.12356.101.4.4.2.1.2'; # some not have sub set_counters {
my $oid_fgSysCpuUsage = '.1.3.6.1.4.1.12356.101.4.1.3'; my ($self, %options) = @_;
my $oid_fgHaSystemMode = '.1.3.6.1.4.1.12356.101.13.1.1'; # '.0' to have the mode
my $oid_fgHaStatsCpuUsage = '.1.3.6.1.4.1.12356.101.13.2.1.1.3';
my $oid_fgHaStatsMasterSerial = '.1.3.6.1.4.1.12356.101.13.2.1.1.16';
my %maps_ha_mode = ( $self->{maps_counters_type} = [
1 => 'standalone', { name => 'cpu_avg', type => 0 },
2 => 'activeActive', { name => 'cpu_core', type => 1, cb_prefix_output => 'prefix_cpu_core_output' },
3 => 'activePassive', { name => 'cluster', type => 1, cb_prefix_output => 'prefix_cluster_output' }
); ];
$self->{maps_counters}->{cpu_avg} = [
{ label => 'average', nlabel => 'cpu.utilization.percentage', set => {
key_values => [ { name => 'average' } ],
output_template => 'CPU(s) average usage is: %.2f %%',
perfdatas => [
{ label => 'total_cpu_avg', value => 'average_absolute', template => '%.2f',
min => 0, max => 100, unit => '%' },
]
}
}
];
$self->{maps_counters}->{cpu_core} = [
{ label => 'core', nlabel => 'core.cpu.utilization.percentage', set => {
key_values => [ { name => 'cpu' } ],
output_template => 'usage: %.2f %%',
perfdatas => [
{ value => 'cpu_absolute', template => '%.2f',
min => 0, max => 100, unit => '%', label_extra_instance => 1 },
]
}
}
];
$self->{maps_counters}->{cluster} = [
{ label => 'cluster-average', nlabel => 'cluster.cpu.utilization.percentage', display_ok => 0, set => {
key_values => [ { name => 'cpu' } ],
output_template => 'CPU usage: %.2f %%',
perfdatas => [
{ value => 'cpu_absolute', template => '%.2f',
min => 0, max => 100, unit => '%', label_extra_instance => 1 },
]
}
}
];
}
sub prefix_cluster_output {
my ($self, %options) = @_;
return "Cluster '" . $options{instance_value}->{display} . "' ";
}
sub prefix_cpu_core_output {
my ($self, %options) = @_;
return "CPU '" . $options{instance_value}->{display} . "' ";
}
sub new { sub new {
my ($class, %options) = @_; my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options); my $self = $class->SUPER::new(package => __PACKAGE__, %options, force_new_perfdata => 1);
bless $self, $class; bless $self, $class;
$options{options}->add_options(arguments => { $options{options}->add_options(arguments => {
'warning:s' => { name => 'warning' },
'critical:s' => { name => 'critical' },
'cluster' => { name => 'cluster' } 'cluster' => { name => 'cluster' }
}); });
return $self; return $self;
} }
sub check_options { my $oid_fgSysCpuUsage = '.1.3.6.1.4.1.12356.101.4.1.3';
my ($self, %options) = @_; my $oid_fgProcessorUsage = '.1.3.6.1.4.1.12356.101.4.4.2.1.2'; # some not have
$self->SUPER::init(%options); my $oid_fgHaSystemMode = '.1.3.6.1.4.1.12356.101.13.1.1'; # '.0' to have the mode
my $oid_fgHaStatsCpuUsage = '.1.3.6.1.4.1.12356.101.13.2.1.1.3';
my $oid_fgHaStatsHostname = '.1.3.6.1.4.1.12356.101.13.2.1.1.11';
if (($self->{perfdata}->threshold_validate(label => 'warning', value => $self->{option_results}->{warning})) == 0) { my $maps_ha_mode = { 1 => 'standalone', 2 => 'activeActive', 3 => 'activePassive' };
$self->{output}->add_option_msg(short_msg => "Wrong warning threshold '" . $self->{option_results}->{warning} . "'.");
$self->{output}->option_exit();
}
if (($self->{perfdata}->threshold_validate(label => 'critical', value => $self->{option_results}->{critical})) == 0) {
$self->{output}->add_option_msg(short_msg => "Wrong critical threshold '" . $self->{option_results}->{critical} . "'.");
$self->{output}->option_exit();
}
}
sub cpu_ha { sub cpu_ha {
my ($self, %options) = @_; my ($self, %options) = @_;
if ($options{ha_mode} == 2) { $self->{cluster} = {};
# We don't care. we use index foreach ($options{snmp}->oid_lex_sort(keys %{$options{snmp_result}->{$oid_fgHaStatsCpuUsage}})) {
foreach my $key ($options{snmp}->oid_lex_sort(keys %{$self->{result}->{$oid_fgHaStatsCpuUsage}})) { /\.(\d+)$/;
next if ($key !~ /^$oid_fgHaStatsCpuUsage\.([0-9]+)$/);
my $cpu_num = $1;
$self->{output}->output_add(long_msg => sprintf("CPU master $cpu_num Usage is %.2f%%", $self->{result}->{$oid_fgHaStatsCpuUsage}->{$key})); $self->{cluster}->{ $options{snmp_result}->{$oid_fgHaStatsHostname}->{$oid_fgHaStatsHostname . '.' . $1} } = {
$self->{output}->perfdata_add( display => $options{snmp_result}->{$oid_fgHaStatsHostname}->{$oid_fgHaStatsHostname . '.' . $1},
label => 'cpu_master' . $cpu_num, unit => '%', cpu => $options{snmp_result}->{$oid_fgHaStatsCpuUsage}->{$_}
value => sprintf("%.2f", $self->{result}->{$oid_fgHaStatsCpuUsage}->{$key}), };
min => 0, max => 100
);
}
} elsif ($options{ha_mode} == 3) {
if (scalar(keys %{$self->{result}->{$oid_fgHaStatsMasterSerial}}) == 0) {
$self->{output}->output_add(long_msg => 'Skip cpu cluster: Cannot find master node.');
}
foreach my $key ($options{snmp}->oid_lex_sort(keys %{$self->{result}->{$oid_fgHaStatsCpuUsage}})) {
next if ($key !~ /^$oid_fgHaStatsCpuUsage\.([0-9]+)$/);
my $label = $self->{result}->{$oid_fgHaStatsMasterSerial}->{$oid_fgHaStatsMasterSerial . '.' . $1} eq '' ?
'master' : 'slave';
$self->{output}->output_add(long_msg => sprintf("CPU %s Usage is %.2f%%", $label, $self->{result}->{$oid_fgHaStatsCpuUsage}->{$key}));
$self->{output}->perfdata_add(
label => 'cpu_' . $label, unit => '%',
value => sprintf("%.2f", $self->{result}->{$oid_fgHaStatsCpuUsage}->{$key}),
min => 0, max => 100
);
}
} }
} }
sub run { sub manage_selection {
my ($self, %options) = @_; my ($self, %options) = @_;
my $table_oids = [ { oid => $oid_fgProcessorUsage }, { oid => $oid_fgSysCpuUsage } ]; my $table_oids = [ { oid => $oid_fgProcessorUsage }, { oid => $oid_fgSysCpuUsage } ];
if (defined($self->{option_results}->{cluster})) { if (defined($self->{option_results}->{cluster})) {
push @$table_oids, { oid => $oid_fgHaSystemMode }, push @$table_oids, { oid => $oid_fgHaSystemMode },
{ oid => $oid_fgHaStatsCpuUsage }, { oid => $oid_fgHaStatsCpuUsage },
{ oid => $oid_fgHaStatsMasterSerial }; { oid => $oid_fgHaStatsHostname };
} }
$self->{result} = $options{snmp}->get_multiple_table( my $snmp_result = $options{snmp}->get_multiple_table(
oids => $table_oids, oids => $table_oids,
nothing_quit => 1 nothing_quit => 1
); );
my $oid_cpu = $oid_fgProcessorUsage;
if (scalar(keys %{$self->{result}->{$oid_fgProcessorUsage}}) == 0) {
$oid_cpu = $oid_fgSysCpuUsage;
}
my $cpu = 0; my ($cpu, $i) = (0, 0);
my $i = 0; $self->{cpu_core} = {};
foreach my $key ($options{snmp}->oid_lex_sort(keys %{$self->{result}->{$oid_cpu}})) { foreach ($options{snmp}->oid_lex_sort(keys %{$snmp_result->{$oid_fgProcessorUsage}})) {
next if ($key !~ /^$oid_cpu\.([0-9]+)$/); $self->{cpu_core}->{$i} = { display => $i, cpu => $snmp_result->{$oid_fgProcessorUsage}->{$_} };
my $cpu_num = $1; $cpu += $snmp_result->{$oid_fgProcessorUsage}->{$_};
$cpu += $self->{result}->{$oid_cpu}->{$key};
$i++; $i++;
$self->{output}->output_add(long_msg => sprintf("CPU $cpu_num Usage is %.2f%%", $self->{result}->{$oid_cpu}->{$key}));
$self->{output}->perfdata_add(
label => 'cpu' . $cpu_num, unit => '%',
value => sprintf("%.2f", $self->{result}->{$oid_cpu}->{$key}),
min => 0, max => 100
);
} }
my $avg_cpu = $cpu / $i; $self->{cpu_avg} = {
my $exit_code = $self->{perfdata}->threshold_check( average => ($i > 0) ? $cpu / $i : $snmp_result->{$oid_fgSysCpuUsage}->{$oid_fgSysCpuUsage . '.0'}
value => $avg_cpu, };
threshold => [ { label => 'critical', 'exit_litteral' => 'critical' }, { label => 'warning', exit_litteral => 'warning' } ]
);
$self->{output}->output_add(
severity => $exit_code,
short_msg => sprintf("CPU(s) average usage is: %.2f%%", $avg_cpu)
);
$self->{output}->perfdata_add(
label => 'total_cpu_avg', unit => '%',
value => sprintf("%.2f", $avg_cpu),
warning => $self->{perfdata}->get_perfdata_for_output(label => 'warning'),
critical => $self->{perfdata}->get_perfdata_for_output(label => 'critical'),
min => 0, max => 100
);
if (defined($self->{option_results}->{cluster})) { if (defined($self->{option_results}->{cluster})) {
# Check if mode cluster my $ha_mode = $snmp_result->{$oid_fgHaSystemMode}->{$oid_fgHaSystemMode . '.0'};
my $ha_mode = $self->{result}->{$oid_fgHaSystemMode}->{$oid_fgHaSystemMode . '.0'}; my $ha_mode_str = defined($maps_ha_mode->{$ha_mode}) ? $maps_ha_mode->{$ha_mode} : 'unknown';
my $ha_output = defined($maps_ha_mode{$ha_mode}) ? $maps_ha_mode{$ha_mode} : 'unknown'; $self->{output}->output_add(long_msg => 'high availabily mode is ' . $ha_mode_str);
$self->{output}->output_add(long_msg => 'High availabily mode is ' . $ha_output . '.'); if ($ha_mode_str =~ /active/) {
if (defined($ha_mode) && $ha_mode != 1) { $self->cpu_ha(snmp => $options{snmp}, snmp_result => $snmp_result);
$self->cpu_ha(snmp => $options{snmp}, ha_mode => $ha_mode);
} }
} }
$self->{output}->display();
$self->{output}->exit();
} }
1; 1;
@ -179,13 +164,10 @@ Check system cpu usage (FORTINET-FORTIGATE-MIB).
=over 8 =over 8
=item B<--warning> =item B<--warning-*> B<--critical-*>
Threshold warning in percent. Thresholds.
Can be: 'core', 'average', 'cluster-average'.
=item B<--critical>
Threshold critical in percent.
=item B<--cluster> =item B<--cluster>

View File

@ -20,141 +20,146 @@
package centreon::common::fortinet::fortigate::snmp::mode::memory; package centreon::common::fortinet::fortigate::snmp::mode::memory;
use base qw(centreon::plugins::mode); use base qw(centreon::plugins::templates::counter);
use strict; use strict;
use warnings; use warnings;
my $oid_fgHaSystemMode = '.1.3.6.1.4.1.12356.101.13.1.1'; # '.0' to have the mode sub custom_usage_output {
my $oid_fgHaStatsMemUsage = '.1.3.6.1.4.1.12356.101.13.2.1.1.4'; my ($self, %options) = @_;
my $oid_fgHaStatsMasterSerial = '.1.3.6.1.4.1.12356.101.13.2.1.1.16';
my %maps_ha_mode = ( return sprintf("memory total: %s %s used: %s %s (%.2f%%) free: %s %s (%.2f%%)",
1 => 'standalone', $self->{perfdata}->change_bytes(value => $self->{result_values}->{total_absolute}),
2 => 'activeActive', $self->{perfdata}->change_bytes(value => $self->{result_values}->{used_absolute}),
3 => 'activePassive', $self->{result_values}->{prct_used_absolute},
); $self->{perfdata}->change_bytes(value => $self->{result_values}->{free_absolute}),
$self->{result_values}->{prct_free_absolute}
);
}
sub prefix_cluster_output {
my ($self, %options) = @_;
return "Cluster '" . $options{instance_value}->{display} . "' ";
}
sub set_counters {
my ($self, %options) = @_;
$self->{maps_counters_type} = [
{ name => 'memory', type => 0 },
{ name => 'cluster', type => 1, cb_prefix_output => 'prefix_cluster_output' }
];
$self->{maps_counters}->{memory} = [
{ label => 'usage', nlabel => 'memory.usage.bytes', set => {
key_values => [ { name => 'used' }, { name => 'free' }, { name => 'prct_used' }, { name => 'prct_free' }, { name => 'total' } ],
closure_custom_output => $self->can('custom_usage_output'),
perfdatas => [
{ value => 'used_absolute', template => '%d', min => 0, max => 'total_absolute',
unit => 'B', cast_int => 1 },
]
}
},
{ label => 'usage-free', display_ok => 0, nlabel => 'memory.free.bytes', set => {
key_values => [ { name => 'free' }, { name => 'used' }, { name => 'prct_used' }, { name => 'prct_free' }, { name => 'total' } ],
closure_custom_output => $self->can('custom_usage_output'),
perfdatas => [
{ value => 'free_absolute', template => '%d', min => 0, max => 'total_absolute',
unit => 'B', cast_int => 1 },
]
}
},
{ label => 'usage-prct', display_ok => 0, nlabel => 'memory.usage.percentage', set => {
key_values => [ { name => 'prct_used' } ],
output_template => 'memory used : %.2f %%',
perfdatas => [
{ label => 'used_prct', value => 'prct_used_absolute', template => '%.2f', min => 0, max => 100,
unit => '%' }
]
}
}
];
$self->{maps_counters}->{cluster} = [
{ label => 'cluster-usage-prct', nlabel => 'cluster.memory.usage.percentage', display_ok => 0, set => {
key_values => [ { name => 'memory' } ],
output_template => 'memory used: %.2f %%',
perfdatas => [
{ value => 'memory_absolute', template => '%.2f',
min => 0, max => 100, unit => '%', label_extra_instance => 1 },
]
}
}
];
}
sub new { sub new {
my ($class, %options) = @_; my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options); my $self = $class->SUPER::new(package => __PACKAGE__, %options, force_new_perfdata => 1);
bless $self, $class; bless $self, $class;
$options{options}->add_options(arguments => { $options{options}->add_options(arguments => {
'warning:s' => { name => 'warning' },
'critical:s' => { name => 'critical' },
'cluster' => { name => 'cluster' } 'cluster' => { name => 'cluster' }
}); });
return $self; return $self;
} }
sub check_options { my $oid_fgSystemInfo = '.1.3.6.1.4.1.12356.101.4.1';
my ($self, %options) = @_; my $oid_fgSysMemUsage = '.1.3.6.1.4.1.12356.101.4.1.4';
$self->SUPER::init(%options); my $oid_fgSysMemCapacity = '.1.3.6.1.4.1.12356.101.4.1.5';
my $oid_fgHaSystemMode = '.1.3.6.1.4.1.12356.101.13.1.1'; # '.0' to have the mode
my $oid_fgHaStatsMemUsage = '.1.3.6.1.4.1.12356.101.13.2.1.1.4';
my $oid_fgHaStatsHostname = '.1.3.6.1.4.1.12356.101.13.2.1.1.11';
if (($self->{perfdata}->threshold_validate(label => 'warning', value => $self->{option_results}->{warning})) == 0) { my $maps_ha_mode = { 1 => 'standalone', 2 => 'activeActive', 3 => 'activePassive' };
$self->{output}->add_option_msg(short_msg => "Wrong warning threshold '" . $self->{option_results}->{warning} . "'.");
$self->{output}->option_exit();
}
if (($self->{perfdata}->threshold_validate(label => 'critical', value => $self->{option_results}->{critical})) == 0) {
$self->{output}->add_option_msg(short_msg => "Wrong critical threshold '" . $self->{option_results}->{critical} . "'.");
$self->{output}->option_exit();
}
}
sub memory_ha { sub memory_ha {
my ($self, %options) = @_; my ($self, %options) = @_;
if ($options{ha_mode} == 2) { $self->{cluster} = {};
# We don't care. we use index foreach ($options{snmp}->oid_lex_sort(keys %{$options{snmp_result}->{$oid_fgHaStatsMemUsage}})) {
foreach my $key ($options{snmp}->oid_lex_sort(keys %{$self->{result}->{$oid_fgHaStatsMemUsage}})) { /\.(\d+)$/;
next if ($key !~ /^$oid_fgHaStatsMemUsage\.([0-9]+)$/);
my $num = $1;
$self->{output}->output_add(long_msg => sprintf("Memory master $num Usage is %.2f%%", $self->{result}->{$oid_fgHaStatsMemUsage}->{$key})); $self->{cluster}->{ $options{snmp_result}->{$oid_fgHaStatsHostname}->{$oid_fgHaStatsHostname . '.' . $1} } = {
$self->{output}->perfdata_add( display => $options{snmp_result}->{$oid_fgHaStatsHostname}->{$oid_fgHaStatsHostname . '.' . $1},
label => 'used_master' . $num, unit => '%', memory => $options{snmp_result}->{$oid_fgHaStatsMemUsage}->{$_}
value => sprintf("%.2f", $self->{result}->{$oid_fgHaStatsMemUsage}->{$key}), };
min => 0, max => 100
);
}
} elsif ($options{ha_mode} == 3) {
if (scalar(keys %{$self->{result}->{$oid_fgHaStatsMasterSerial}}) == 0) {
$self->{output}->output_add(long_msg => 'Skip memory cluster: Cannot find master node.');
}
foreach my $key ($options{snmp}->oid_lex_sort(keys %{$self->{result}->{$oid_fgHaStatsMemUsage}})) {
next if ($key !~ /^$oid_fgHaStatsMemUsage\.([0-9]+)$/);
my $label = $self->{result}->{$oid_fgHaStatsMasterSerial}->{$oid_fgHaStatsMasterSerial . '.' . $1} eq '' ?
'master' : 'slave';
$self->{output}->output_add(long_msg => sprintf("Memory %s Usage is %.2f%%", $label, $self->{result}->{$oid_fgHaStatsMemUsage}->{$key}));
$self->{output}->perfdata_add(
label => 'used_' . $label, unit => '%',
value => sprintf("%.2f", $self->{result}->{$oid_fgHaStatsMemUsage}->{$key}),
min => 0, max => 100
);
}
} }
} }
sub run { sub manage_selection {
my ($self, %options) = @_; my ($self, %options) = @_;
my $oid_fgSystemInfo = '.1.3.6.1.4.1.12356.101.4.1';
my $oid_fgSysMemUsage = '.1.3.6.1.4.1.12356.101.4.1.4';
my $oid_fgSysMemCapacity = '.1.3.6.1.4.1.12356.101.4.1.5';
my $table_oids = [ { oid => $oid_fgSystemInfo, start => $oid_fgSysMemUsage, end => $oid_fgSysMemCapacity } ]; my $table_oids = [ { oid => $oid_fgSystemInfo, start => $oid_fgSysMemUsage, end => $oid_fgSysMemCapacity } ];
if (defined($self->{option_results}->{cluster})) { if (defined($self->{option_results}->{cluster})) {
push @$table_oids, { oid => $oid_fgHaSystemMode }, push @$table_oids, { oid => $oid_fgHaSystemMode },
{ oid => $oid_fgHaStatsMemUsage }, { oid => $oid_fgHaStatsMemUsage },
{ oid => $oid_fgHaStatsMasterSerial }; { oid => $oid_fgHaStatsHostname };
} }
$self->{result} = $options{snmp}->get_multiple_table( my $snmp_result = $options{snmp}->get_multiple_table(
oids => $table_oids, oids => $table_oids,
nothing_quit => 1 nothing_quit => 1
); );
my $fgSysMemUsage = $self->{result}->{$oid_fgSystemInfo}->{$oid_fgSysMemUsage . '.0'}; $self->{memory} = {
my $fgSysMemCapacity = $self->{result}->{$oid_fgSystemInfo}->{$oid_fgSysMemCapacity . '.0'}; prct_used => $snmp_result->{$oid_fgSystemInfo}->{$oid_fgSysMemUsage . '.0'},
total => $snmp_result->{$oid_fgSystemInfo}->{$oid_fgSysMemCapacity . '.0'} * 1024
my $exit = $self->{perfdata}->threshold_check( };
value => $fgSysMemUsage, $self->{memory}->{prct_free} = 100 - $self->{memory}->{prct_used};
threshold => [ { label => 'critical', exit_litteral => 'critical' }, { label => 'warning', exit_litteral => 'warning' } ] $self->{memory}->{used} = int(($self->{memory}->{total} * $self->{memory}->{prct_used}) / 100);
); $self->{memory}->{free} = $self->{memory}->{total} - $self->{memory}->{used};
my ($size_value, $size_unit) = $self->{perfdata}->change_bytes(value => $fgSysMemCapacity * 1024);
$self->{output}->output_add(
severity => $exit,
short_msg => sprintf(
"Memory Usage: %.2f%% used [Total: %s]",
$fgSysMemUsage,
$size_value . " " . $size_unit
)
);
$self->{output}->perfdata_add(
label => "used", unit => 'B',
value => int(($fgSysMemCapacity * 1024 * $fgSysMemUsage) / 100),
warning => $self->{perfdata}->get_perfdata_for_output(label => 'warning', total => $fgSysMemCapacity * 1024, cast_int => 1),
critical => $self->{perfdata}->get_perfdata_for_output(label => 'critical', total => $fgSysMemCapacity * 1024, cast_int => 1),
min => 0, max => $fgSysMemCapacity * 1024
);
if (defined($self->{option_results}->{cluster})) { if (defined($self->{option_results}->{cluster})) {
# Check if mode cluster my $ha_mode = $snmp_result->{$oid_fgHaSystemMode}->{$oid_fgHaSystemMode . '.0'};
my $ha_mode = $self->{result}->{$oid_fgHaSystemMode}->{$oid_fgHaSystemMode . '.0'}; my $ha_mode_str = defined($maps_ha_mode->{$ha_mode}) ? $maps_ha_mode->{$ha_mode} : 'unknown';
my $ha_output = defined($maps_ha_mode{$ha_mode}) ? $maps_ha_mode{$ha_mode} : 'unknown'; $self->{output}->output_add(long_msg => 'high availabily mode is ' . $ha_mode_str);
$self->{output}->output_add(long_msg => 'High availabily mode is ' . $ha_output . '.'); if ($ha_mode_str =~ /active/) {
if (defined($ha_mode) && $ha_mode != 1) { $self->memory_ha(snmp => $options{snmp}, snmp_result => $snmp_result);
$self->memory_ha(snmp => $options{snmp}, ha_mode => $ha_mode);
} }
} }
$self->{output}->display();
$self->{output}->exit();
} }
1; 1;
@ -167,13 +172,10 @@ Check system memory usage (FORTINET-FORTIGATE).
=over 8 =over 8
=item B<--warning> =item B<--warning-*> B<--critical-*>
Threshold warning in percent. Thresholds.
Can be: 'usage-free', 'usage-prct', 'cluster-usage-prct'.
=item B<--critical>
Threshold critical in percent.
=item B<--cluster> =item B<--cluster>