1"use strict";(self.webpackChunkmetricshub_doc=self.webpackChunkmetricshub_doc||[]).push([["2874"],{28897(e,t,s){s.r(t),s.d(t,{metadata:()=>i,default:()=>y,frontMatter:()=>o,contentTitle:()=>a,toc:()=>l,assets:()=>m});var i=JSON.parse('{"id":"connectors/aix","title":"IBM AIX System","description":"Collects system metrics from Aix 6.1 TL9+ hosts and later. It relies on LibPerfStat C library for AIX and AIX commands. Implements the OpenTelemetry semantic conventions for system metrics.","source":"@site/docs/connectors/aix.md","sourceDirName":"connectors","slug":"/connectors/aix","permalink":"/docs/latest/connectors/aix","draft":false,"unlisted":false,"tags":[],"version":"current","frontMatter":{"title":"IBM AIX System","description":"Collects system metrics from Aix 6.1 TL9+ hosts and later. It relies on LibPerfStat C library for AIX and AIX commands. Implements the OpenTelemetry semantic conventions for system metrics.","keywords":["metricshub","connector","aix","ibm power"],"hide_table_of_contents":true,"displayed_sidebar":"docsSidebar","pagination_prev":null,"pagination_next":null},"sidebar":"docsSidebar"}'),n=s(74848),r=s(28453),c=s(6228);let o={title:"IBM AIX System",description:"Collects system metrics from Aix 6.1 TL9+ hosts and later. It relies on LibPerfStat C library for AIX and AIX commands. Implements the OpenTelemetry semantic conventions for system metrics.",keywords:["metricshub","connector","aix","ibm power"],hide_table_of_contents:!0,displayed_sidebar:"docsSidebar",pagination_prev:null,pagination_next:null},a="IBM AIX System",m={},l=[{value:"Description",id:"description",level:2},{value:"Target",id:"target",level:2},{value:"Prerequisites",id:"prerequisites",level:2},{value:"Examples",id:"examples",level:2},{value:"CLI",id:"cli",level:3},{value:"metricshub.yaml",id:"metricshubyaml",level:3},{value:"Connector Activation Criteria",id:"connector-activation-criteria",level:2},{value:"Metrics",id:"metrics",level:2}];function d(e){let t={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,r.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(t.header,{children:(0,n.jsx)(t.h1,{id:"ibm-aix-system",children:"IBM AIX System"})}),"\n",(0,n.jsx)(t.h2,{id:"description",children:"Description"}),"\n",(0,n.jsx)(t.p,{children:"Collects system metrics from Aix 6.1 TL9+ hosts and later. It relies on LibPerfStat C library for AIX and AIX commands. Implements the OpenTelemetry semantic conventions for system metrics."}),"\n",(0,n.jsxs)(t.p,{children:[(0,n.jsx)(t.a,{href:"/docs/latest/connectors/tags/aix",children:(0,n.jsx)(t.code,{children:"aix"})})," ",(0,n.jsx)(t.a,{href:"/docs/latest/connectors/tags/ibm",children:(0,n.jsx)(t.code,{children:"ibm"})})," ",(0,n.jsx)(t.a,{href:"/docs/latest/connectors/tags/power",children:(0,n.jsx)(t.code,{children:"power"})})," ",(0,n.jsx)(t.a,{href:"/docs/latest/connectors/tags/system",children:(0,n.jsx)(t.code,{children:"system"})})]}),"\n",(0,n.jsx)(t.admonition,{title:"Enterprise Connector",type:"info",children:(0,n.jsxs)(t.p,{children:["This connector requires the ",(0,n.jsx)(t.strong,{children:"Enterprise"})," edition of MetricsHub."]})}),"\n",(0,n.jsx)(t.h2,{id:"target",children:"Target"}),"\n",(0,n.jsxs)(t.p,{children:[(0,n.jsx)(t.strong,{children:"Typical platform:"})," ",(0,n.jsx)(t.a,{href:"/docs/latest/connectors/platforms/ibm-power",children:"IBM POWER"})]}),"\n",(0,n.jsxs)(t.p,{children:[(0,n.jsx)(t.strong,{children:"Operating system:"})," IBM AIX"]}),"\n",(0,n.jsx)(t.h2,{id:"prerequisites",children:"Prerequisites"}),"\n",(0,n.jsxs)(t.p,{children:[(0,n.jsx)(t.strong,{children:"Leverages:"})," IBM AIX LibPerfStat"]}),"\n",(0,n.jsxs)(t.p,{children:[(0,n.jsx)(t.strong,{children:"Technology and protocols:"})," Commands"]}),"\n",(0,n.jsx)(t.h2,{id:"examples",children:"Examples"}),"\n",(0,n.jsx)(t.h3,{id:"cli",children:"CLI"}),"\n",(0,n.jsx)(t.pre,{children:(0,n.jsx)(t.code,{className:"language-batch",children:"metricshub HOSTNAME -t aix -c +Aix --ssh -u USER\n"})}),"\n",(0,n.jsx)(t.h3,{id:"metricshubyaml",children:"metricshub.yaml"}),"\n",(0,n.jsx)(t.pre,{children:(0,n.jsx)(t.code,{className:"language-yaml",children:"resourceGroups:\n <RESOURCE_GROUP>:\n resources:\n <HOSTNAME-ID>:\n attributes:\n host.name: <HOSTNAME> # Change with actual host name\n host.type: aix\n connectors: [ +Aix ] # Optional, to load only this connector\n protocols:\n ssh:\n username: <USERNAME> # Change with actual credentials\n password: <PASSWORD> # Encrypted using metricshub-encrypt\n"})}),"\n",(0,n.jsx)(t.h2,{id:"connector-activation-criteria",children:"Connector Activation Criteria"}),"\n",(0,n.jsxs)(t.p,{children:["The ",(0,n.jsx)(t.strong,{children:"IBM AIX System"})," connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:"]}),"\n",(0,n.jsxs)(t.ul,{children:["\n",(0,n.jsxs)(t.li,{children:["The command below succeeds on the monitored host:","\n",(0,n.jsxs)(t.ul,{children:["\n",(0,n.jsxs)(t.li,{children:["Command: ",(0,n.jsx)(t.code,{children:"/u
1sr/bin/uname || /bin/uname"})]}),"\n",(0,n.jsxs)(t.li,{children:["Output contains: ",(0,n.jsx)(t.code,{children:"AIX"})," (regex)"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsx)(t.h2,{id:"metrics",children:"Metrics"}),"\n",(0,n.jsx)(c.A,{data:[{type:"cpu",metrics:['hw.status{hw.type="cpu", state="present"}',"system.cpu.frequency",'system.cpu.time{system.cpu.state="idle"}','system.cpu.time{system.cpu.state="iowait"}','system.cpu.time{system.cpu.state="system"}','system.cpu.time{system.cpu.state="user"}','system.cpu.utilization{system.cpu.state="idle"}','system.cpu.utilization{system.cpu.state="iowait"}','system.cpu.utilization{system.cpu.state="system"}','system.cpu.utilization{system.cpu.state="user"}'],attributes:["id","name","system.cpu.logical_number"]},{type:"file_system",metrics:["system.filesystem.limit",'system.filesystem.usage{system.filesystem.state="free"}','system.filesystem.usage{system.filesystem.state="reserved"}','system.filesystem.usage{system.filesystem.state="used"}','system.filesystem.utilization{system.filesystem.state="free"}','system.filesystem.utilization{system.filesystem.state="reserved"}','system.filesystem.utilization{system.filesystem.state="used"}'],attributes:["id","system.device","system.filesystem.mode","system.filesystem.mountpoint","system.filesystem.type"]},{type:"memory",metrics:['hw.status{hw.type="memory", state="present"}',"system.memory.limit",'system.memory.usage{system.memory.state="cached"}','system.memory.usage{system.memory.state="free"}','system.memory.usage{system.memory.state="used"}','system.memory.utilization{system.memory.state="cached"}','system.memory.utilization{system.memory.state="free"}','system.memory.utilization{system.memory.state="used"}'],attributes:["id"]},{type:"network",metrics:['hw.status{hw.type="network", state="present"}',"system.network.bandwidth.limit",'system.network.dropped{network.io.direction="receive"}','system.network.dropped{network.io.direction="transmit"}','system.network.errors{network.io.direction="receive"}','system.network.errors{network.io.direction="transmit"}','system.network.io{network.io.direction="receive"}','system.network.io{network.io.direction="transmit"}','system.network.packets{network.io.direction="receive"}','system.network.packets{network.io.direction="transmit"}'],attributes:["id","network.interface.name"]},{type:"paging",metrics:['system.paging.usage{system.paging.state="free"}','system.paging.usage{system.paging.state="used"}','system.paging.utilization{system.paging.state="free"}','system.paging.utilization{system.paging.state="used"}'],attributes:["id","system.device"]},{type:"paging_activity",metrics:['system.paging.faults{system.paging.type="major"}','system.paging.faults{system.paging.type="minor"}','system.paging.operations{system.paging.direction="in"}','system.paging.operations{system.paging.direction="out"}'],attributes:["id"]},{type:"physical_disk",metrics:['hw.status{hw.type="physical_disk", state="present"}','system.disk.io{disk.io.direction="read"}','system.disk.io{disk.io.direction="write"}',"system.disk.limit"],attributes:["id","system.device"]},{type:"system",metrics:["system.cpu.logical.count","system.cpu.physical.count","system.processes.count","system.processes.created","system.uptime"],attributes:["id","name","os_version","version"]}]})]})}function y(e={}){let{wrapper:t}={...(0,r.R)(),...e.components};return t?(0,n.jsx)(t,{...e,children:(0,n.jsx)(d,{...e})}):d(e)}},6228(e,t,s){s.d(t,{A:()=>r});var i=s(74848),n=s(96540);function r({data:e}){return e&&0!==e.length?(0,i.jsx)("div",{className:"tableWrapper_qs3z",children:(0,i.jsxs)("table",{className:"metricsTable_SMom",children:[(0,i.jsx)("thead",{children:(0,i.jsxs)("tr",{children:[(0,i.jsx)("th",{children:"Type"}),(0,i.jsx)("th",{children:"Collected Metrics"}),(0,i.jsx)("th",{children:"Specific Attributes"})]})}),(0,i.jsx)("tbody",{children:e.map((e,t)=>(0,i.jsxs)("tr",{children:[(0,i.jsx)("td",{className:"typeCell_BkqM",children:(0,i.jsx)("strong",{children:e.type})}),(0,i.jsx)("td",{className:"metricsCell_ll3D",children:e.metrics.length>0?e.metrics.map((t,s)=>(0,i.jsxs)(n.Fragment,{children:[(0,i.jsx)("code",{children:t}),s<e.metrics.length-1&&(0,i.jsx)("br",{})]},s)):"-"}),(0,i.jsx)("td",{className:"attributesCell_x8LT",children:e.attributes.length>0?e.attributes.map((t,s)=>(0,i.jsxs)(n.Fragment,{children:[(0,i.jsx)("code",{children:t}),s<e.attributes.length-1&&(0,i.jsx)("br",{})]},s)):"-"})]},t))})]})}):(0,i.jsx)("p",{children:"No specific metrics are collected by this connector."})}},28453(e,t,s){s.d(t,{R:()=>c,x:()=>o});var i=s(96540);let n={},r=i.createContext(n);function c(e){let t=i.useContext(r);return i.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function o(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:c(e.components),i.createElement(r.Provider,{value:t},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.