Skip to content

Commit

Permalink
chore: pluralization fix
Browse files Browse the repository at this point in the history
  • Loading branch information
thezackm committed Oct 30, 2023
1 parent 7b37615 commit f64895a
Show file tree
Hide file tree
Showing 11 changed files with 11 additions and 11 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ metaDescription: How to run a specific version of the container.

The default Docker commands given by the guided installation will update you to the latest release every time you start. There's a variety of scenarios where you might want to run an older release, or pin your environment to a specific version.

## Solutions [#solutions]
## Solution [#solution]

You can find older releases of the container on [Docker Hub](https://hub.docker.com/r/kentik/ktranslate/tags).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ You've run `docker run`, but nothing seems to be happening and you see, in the d

This happens when the `snmp-base.yaml` file has an ownership permission that prevents the docker user from editing the file, most often because you created the file as the `root` user or a similar privileged account. The docker container runs with a non-privileged user that can't modify this file. Inside the container, `ktranslate` is always trying to use user ID 1000 and group ID 1000, so the ownership needs to allow for those IDs to own the file.

## Solutions [#solutions]
## Solution [#solution]

From your privileged account, change the ownership of the file before you can pass it into the docker container. For example, run:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ When a discovery job runs, each time it discovers an IP it tries to determine th

When `ktranslate` performs its polling it only uses the IP when it runs, so if your devices list contains multiple entries with the same IP address, it will collect and send metrics to New Relic as if they were separate entities, but in reality it is just the same data that came from whatever device responded to requests to IP at the current polling interval. The `device_name` is not collected or updated as part of the polling cycle.

## Solutions [#solutions]
## Solution [#solution]

If the `device_name` has changed due to a one-time change, like replacing a piece of hardware or updating your naming conventions, then you should edit the `snmb-base.yaml` and delete the entry with the old device name. The old entity will still show in the **Explorer** menu but will stop having new data associated with it and eventually it will age out of the system. In most cases that will happen 8 days after data stops coming in.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ You've ktranslate containers hitting 100% CPU utilization, or just generally it'
One detail to be careful about is that for ktranslate it's important to focus on the maximum CPU percent instead of the average. Ktranslate uses a high percentage of CPU near the beginning of a polling cycle and much less at the end of the cycle. When you look at the average usage you might see 60% and miss the fact that ktranslate is spending time close to 100%, which is a potential problem. You need to allocate enough resources so that the max CPU consumption doesn't hit 100%.
</Callout>

## Solutions [#solutions]
## Solution [#solution]

The causes of CPU usage vary depending on what type of ktranslate container you're working with.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ metaDescription: Meraki API polling is working, but expected metrics are missing

During Meraki API monitoring, you don't see all of the expected metrics for your controller.

## Solutions [#solutions]
## Solution [#solution]

Identify what metrics exist in New Relic by running the following NRQL query:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ You have a new type of device that has a profile but no entity has been added in

This happens when a device has an [SNMP profile](https://github.com/kentik/snmp-profiles) telling `ktranslate` what metrics to collect, but a new [entity definition](https://github.com/newrelic/entity-definitions) is still in progress for how to display that collection of metrics in New Relic.

## Solutions [#solutions]
## Solution [#solution]

When creating a new entity type, we must review the data that comes in from the profile. That data is used to create a definition that includes information such as the golden metrics for this entity type, and used to create a dashboard. This can take some time and sometimes requires talking to the users who submitted the profile request to ensure the entity definition suits their needs.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ This usually happens when a device can't reliably respond to the SNMP requests w

Another scenario might be that the device is overloaded and can't respond to the SNMP requests quickly. This usually happens when you try to collect OIDs from very large tables with a `poll_time_sec` that is too fast for the device to keep up with.

## Solutions [#solutions]
## Solution [#solution]

As a general rule, locate your polling container as close to the monitored devices as you can to reduce the chance of a the UDP SNMP payloads not making the trip.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ metaDescription: SNMP monitoring discovery results in 'Kentik Default' entities

After running a discovery, you are seeing `Kentik Default` entities in the New Relic UI.

## Solutions [#solutions]
## Solution [#solution]

During discovery, `ktranslate` collects the [System Object Identifier](http://oid-info.com/get/1.3.6.1.2.1.1.2), such as sysObjectID or sysOID, which provides an easy way to identify a device. Every device type that responds to SNMP has a sysObjectID, and the value of that ID should be unique enough so anyone can identify which type of device it is.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ metaDescription: SNMP monitoring discovery does not find any devices, or you did

You launched an SNMP discovery run but didn't find all of the expected devices.

## Solutions [#solutions]
## Solution [#solution]

The SNMP discovery process will run against every IP address in your list from the [`cidrs`](/docs/network-performance-monitoring/advanced/advanced-config/#discovery) section in the discovery configuration. During the scan, there's a TCP port check to ensure the target IP address is responsive. If successful, `ktranslate` will then attempt to communicate with the IP address via SNMP.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ There are two distinct scenarios that can exist after this process:
1. Device is matched to an expected profile and collects metrics without issue.
2. Device is unexpectedly matched to the wrong profile and is collecting the wrong metrics or is missing metrics.

## Solutions [#solutions]
## Solution [#solution]

### Kentik Default devices [#kentik-default]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ metaDescription: Gathering details on all supported OIDs for your device using t

You are having trouble collecting SNMP metrics from your device or you need to see what specific Object Identifiers (OIDs) your device supports.

## Solutions [#solutions]
## Solution [#solution]

The [snmpwalk](https://helpmanual.io/help/snmpwalk/) utility is a useful tool for troubleshooting various SNMP challenges you may encounter. Because `ktranslate` runs on the host network of the Linux host that Docker is running on top of, it is an accurate measurement of whether or not your devices are responding to SNMP requests and what specifically they are responding with.

Expand Down

0 comments on commit f64895a

Please sign in to comment.