gitlab-org--gitlab-foss/.gitlab/issue_templates/Service Ping reporting and monitoring.md

The Product Intelligence group runs manual reporting of ServicePing for GitLab.com on a weekly basis. This issue:

• Captures the work required to complete the reporting process,.
• Captures the follow-up tasks that are focused on metrics performance verification.
• Identifies any potential issues.

New metrics to be verified

Failed metrics

Broken metrics issues are marked with the ~"broken metric" label.

Use a detached screen session to generate Service Ping for GitLab.com

Prerequisites

1. Add your SSH key to the local SSH agent: ssh-add. Your SSH key is required to connect to a Rails console from the bastion host.

Triggering

1. Add the SSH key to the local SSH agent: ssh-add.
2. Connect to the bastion with SSH agent forwarding: ssh -A lb-bastion.gprd.gitlab.com.
3. Note which bastion host machine was assigned. For example: <username>@bastion-01-inf-gprd.c.gitlab-production.internal:~$ shows that you are connected to bastion-01-inf-gprd.c.gitlab-production.internal.
4. Create a named screen: screen -S $USER-service-ping-$(date +%F).
5. Connect to the console host: ssh $USER-rails@console-01-sv-gprd.c.gitlab-production.internal.
6. Run: ServicePing::SubmitService.new.execute.
7. Press Control+a followed by Control+d to detach from the screen session.
8. Exit from the bastion: exit.

Verification (After approximately 30 hours)

1. Reconnect to the bastion: ssh -A lb-bastion.gprd.gitlab.com. Make sure that you are connected to the same host machine that ServicePing was started on. For example, to connect directly to the host machine, use ssh bastion-01-inf-gprd.c.gitlab-production.internal.
2. Find your screen session: screen -ls.
3. Attach to your screen session: screen -x 14226.mwawrzyniak_service_ping_2021_01_22.
4. Check the last payload in the raw_usage_data table: RawUsageData.last.payload.
5. Check the when the payload was sent: RawUsageData.last.sent_at.

Stop the Service Ping process

Use either of these processes:

1. Reconnect to the bastion host machine. For example, use: ssh bastion-01-inf-gprd.c.gitlab-production.internal.
2. Find your screen session: $ screen -ls.
3. Attach to your screen session: $ sudo -u <username> screen -r.
4. Press Control+c to stop the Service Ping process.

OR

1. Reconnect to the bastion host machine. For example, type: ssh bastion-01-inf-gprd.c.gitlab-production.internal.
2. List all process started by your username: ps faux | grep <username>.
3. Locate the username that owns ServicePing reporting.
4. Send the kill signal for the ServicePing PID: kill -9 <service_ping_pid>.

Service Ping process triggering (through a long-running SSH session)

1. Connect to the gprd Rails console.
2. Run SubmitUsagePingService.new.execute. This process requires more than 30 hours to complete.
3. Find the last payload in the raw_usage_data table: RawUsageData.last.payload.
4. Check the when the payload was sent: RawUsageData.last.sent_at.

ServicePing::SubmitService.new.execute

# Get the payload
RawUsageData.last.payload

# Time when payload was sent to VersionsAppp
RawUsageData.last.sent_at

Verify Service Ping in VersionsApp

To verify that the ServicePing was received in the VersionsApp do the following steps:

1. Go to the VersionsApp console and locate: RawUsageData.find(uuid: '').
2. Check the object. Either:
   • Go to the Rails console and check the related RawUsageData object.
   • Go to the VersionsApp UI https://version.gitlab.com/usage_data/usage_data_id.

/bin/herokuish procfile exec rails console

puts UsageData.select(:recorded_at, :app_server_type).where(hostname: 'gitlab.com', uuid: 'ea8bf810-1d6f-4a6a-b4fd-93e8cbd8b57f').order('id desc').limit(5).to_json

puts UsageData.find(21635202).raw_usage_data.payload.to_json

Monitoring events tracked using Redis HLL

Trigger some events from the User Interface.

Gitlab::UsageDataCounters::HLLRedisCounter.unique_events(event_names: 'event_name', start_date: 28.days.ago, end_date: Date.current)

Troubleshooting

Connecting to a Rails console host fails with Permission denied (publickey)..

Make sure you add the SSH key to the local SSH agent with: ssh-add. If you don't add your SSH key, your key won't be forwarded when you run ssh -A, and you will not be able to connect to a Rails console host.

What to do if you get mentioned

In this issue, we keep the track of new metrics added to the Service Ping, and the metrics that are timing out.

If you get mentioned, check the failing metric and open an optimization issue.

Service Ping manual generation for GitLab.com schedule

Generation start date	GitLab developer handle	Link to comment with payload
2022-04-18
2022-04-25
2022-05-02
2022-05-09
2022-05-16

/confidential /label ~"group::product intelligence" ~"devops::analytics" ~backend ~"section::analytics" ~"Category:Service Ping" /epic https://gitlab.com/groups/gitlab-org/-/epics/6000 /weight 5 /title Monitor and Generate GitLab.com Service Ping